From 811461f2357af36c54f8dfa62dae218211bd64ca Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E3=81=8B=E3=81=A3=E3=81=93=E3=81=8B=E3=82=8A?= <67428053+kakkokari-gtyih@users.noreply.github.com> Date: Tue, 23 Jan 2024 13:18:36 +0900 Subject: [PATCH] New Crowdin updates (#98) * New translations thread-mute.md (Chinese Simplified) * New translations webhook.md (Chinese Simplified) * New translations 1.troubleshooting.md (Chinese Simplified) * New translations donate.md (Chinese Simplified) * New translations misskey-hub.md (Chinese Simplified) * New translations announcement.md (Chinese Simplified) * New translations role.md (Chinese Simplified) * New translations 1.index.md (Chinese Simplified) * New translations bash.md (Chinese Simplified) * New translations docker.md (Chinese Simplified) * New translations kubernetes.md (Chinese Simplified) * New translations manual.md (Chinese Simplified) * New translations ubuntu-manual.md (Chinese Simplified) * New translations cdn.md (Chinese Simplified) * New translations disable-timelines.md (Chinese Simplified) * New translations 1.index.md (Chinese Simplified) * New translations permission.md (Chinese Simplified) * New translations 1.index.md (Chinese Simplified) * New translations 2.miauth.md (Chinese Simplified) * New translations 5.releases.md (Chinese Simplified) * New translations 1.index.md (Chinese Simplified) * New translations 3.oauth.md (Chinese Simplified) * New translations ja-jp.yml (Chinese Traditional) * New translations 1.about-misskey.md (Chinese Traditional) * New translations 2.get-started.md (Chinese Traditional) * New translations 3.join-server.md (Chinese Traditional) * New translations 4.things-to-know.md (Chinese Traditional) * New translations ads.md (Chinese Traditional) * New translations drive.md (Chinese Traditional) * New translations mfm.md (Chinese Traditional) * New translations mute-and-block.md (Chinese Traditional) * New translations pages.md (Chinese Traditional) * New translations poll.md (Chinese Traditional) * New translations share-form.md (Chinese Traditional) * New translations thread-mute.md (Chinese Traditional) * New translations webhook.md (Chinese Traditional) * New translations 1.troubleshooting.md (Chinese Traditional) * New translations donate.md (Chinese Traditional) * New translations misskey-hub.md (Chinese Traditional) * New translations announcement.md (Chinese Traditional) * New translations role.md (Chinese Traditional) * New translations 1.index.md (Chinese Traditional) * New translations bash.md (Chinese Traditional) * New translations docker.md (Chinese Traditional) * New translations kubernetes.md (Chinese Traditional) * New translations manual.md (Chinese Traditional) * New translations ubuntu-manual.md (Chinese Traditional) * New translations cdn.md (Chinese Traditional) * New translations disable-timelines.md (Chinese Traditional) * New translations 1.index.md (Chinese Traditional) * New translations permission.md (Chinese Traditional) * New translations 1.index.md (Chinese Traditional) * New translations 2.miauth.md (Chinese Traditional) * New translations publish-on-your-website.md (Chinese Traditional) * New translations 5.releases.md (Chinese Traditional) * New translations 1.index.md (Chinese Traditional) * New translations 3.oauth.md (Chinese Traditional) * New translations 1.about-misskey.md (English) * New translations 2.get-started.md (English) * New translations 3.join-server.md (English) * New translations 4.things-to-know.md (English) * New translations ads.md (English) * New translations drive.md (English) * New translations mfm.md (English) * New translations mute-and-block.md (English) * New translations pages.md (English) * New translations poll.md (English) * New translations share-form.md (English) * New translations thread-mute.md (English) * New translations webhook.md (English) * New translations 1.troubleshooting.md (English) * New translations donate.md (English) * New translations misskey-hub.md (English) * New translations announcement.md (English) * New translations role.md (English) * New translations 1.index.md (English) * New translations bash.md (English) * New translations docker.md (English) * New translations kubernetes.md (English) * New translations manual.md (English) * New translations ubuntu-manual.md (English) * New translations cdn.md (English) * New translations disable-timelines.md (English) * New translations 1.index.md (English) * New translations permission.md (English) * New translations 1.index.md (English) * New translations 2.miauth.md (English) * New translations 5.releases.md (English) * New translations 1.index.md (English) * New translations 3.oauth.md (English) * New translations 1.about-misskey.md (Indonesian) * New translations 2.get-started.md (Indonesian) * New translations 3.join-server.md (Indonesian) * New translations 4.things-to-know.md (Indonesian) * New translations ads.md (Indonesian) * New translations drive.md (Indonesian) * New translations mfm.md (Indonesian) * New translations mute-and-block.md (Indonesian) * New translations pages.md (Indonesian) * New translations poll.md (Indonesian) * New translations share-form.md (Indonesian) * New translations thread-mute.md (Indonesian) * New translations webhook.md (Indonesian) * New translations 1.troubleshooting.md (Indonesian) * New translations donate.md (Indonesian) * New translations misskey-hub.md (Indonesian) * New translations announcement.md (Indonesian) * New translations role.md (Indonesian) * New translations 1.index.md (Indonesian) * New translations bash.md (Indonesian) * New translations docker.md (Indonesian) * New translations kubernetes.md (Indonesian) * New translations manual.md (Indonesian) * New translations ubuntu-manual.md (Indonesian) * New translations cdn.md (Indonesian) * New translations disable-timelines.md (Indonesian) * New translations 1.index.md (Indonesian) * New translations permission.md (Indonesian) * New translations 1.index.md (Indonesian) * New translations 2.miauth.md (Indonesian) * New translations 5.releases.md (Indonesian) * New translations 1.index.md (Indonesian) * New translations 3.oauth.md (Indonesian) * New translations 5.releases.md (Korean) * New translations ja-jp.yml (English) * New translations docker.md (English) * New translations ja-jp.yml (Indonesian) * New translations 5.releases.md (Korean) * New translations ja-jp.yml (Indonesian) * New translations 1.about-misskey.md (Indonesian) * New translations 1.index.md (Indonesian) * New translations ads.md (Indonesian) * New translations antenna.md (Indonesian) * New translations charts.md (Indonesian) * New translations clip.md (Indonesian) * New translations custom-emoji.md (Indonesian) * New translations deck.md (Indonesian) * New translations drive.md (Indonesian) * New translations favorite.md (Indonesian) * New translations follow.md (Indonesian) * New translations hashtag.md (Indonesian) * New translations mention.md (Indonesian) * New translations mfm.md (Indonesian) * New translations 1.index.md (Indonesian) * New translations announcement.md (Indonesian) * New translations bash.md (Indonesian) * New translations ja-jp.yml (Indonesian) * New translations mute-and-block.md (Indonesian) * New translations pages.md (Indonesian) * New translations apps.md (Indonesian) * New translations donate.md (Indonesian) * New translations bash.md (Indonesian) * New translations docker.md (Indonesian) * New translations manual.md (Indonesian) * New translations 1.about-misskey.md (Chinese Traditional) * New translations 1.about-misskey.md (Chinese Traditional) * New translations create-plugin.md (French) * New translations create-plugin.md (Italian) * New translations create-plugin.md (Polish) * New translations create-plugin.md (Chinese Simplified) * New translations create-plugin.md (Chinese Traditional) * New translations create-plugin.md (Indonesian) * New translations aiscript.md (French) * New translations aiscript.md (Italian) * New translations aiscript.md (Korean) * New translations aiscript.md (Polish) * New translations aiscript.md (Chinese Simplified) * New translations aiscript.md (Chinese Traditional) * New translations aiscript.md (English) * New translations aiscript.md (Indonesian) * New translations ja-jp.yml (Chinese Traditional) * New translations ja-jp.yml (Chinese Traditional) * New translations troubleshooting.md (French) * New translations libraries.md (French) * New translations troubleshooting.md (Italian) * New translations libraries.md (Italian) * New translations troubleshooting.md (Korean) * New translations libraries.md (Korean) * New translations troubleshooting.md (Polish) * New translations libraries.md (Polish) * New translations troubleshooting.md (Chinese Simplified) * New translations libraries.md (Chinese Simplified) * New translations troubleshooting.md (Chinese Traditional) * New translations libraries.md (Chinese Traditional) * New translations troubleshooting.md (English) * New translations libraries.md (English) * New translations troubleshooting.md (Indonesian) * New translations libraries.md (Indonesian) * New translations ja-jp.yml (Chinese Traditional) * New translations ja-jp.yml (French) * New translations 2.miauth.md (French) * New translations ja-jp.yml (Italian) * New translations 2.miauth.md (Italian) * New translations ja-jp.yml (Korean) * New translations ja-jp.yml (Polish) * New translations 2.miauth.md (Polish) * New translations ja-jp.yml (Chinese Simplified) * New translations 2.miauth.md (Chinese Simplified) * New translations 2.miauth.md (Chinese Traditional) * New translations ja-jp.yml (English) * New translations 2.miauth.md (English) * New translations ja-jp.yml (Indonesian) * New translations 2.miauth.md (Indonesian) * Revert "New translations 1.about-misskey.md (English)" This reverts commit 2b9572c2cfadbc27252b1d6b1e2880e2bff712d3. * Revert "New translations 2.get-started.md (English)" This reverts commit 2fa05a5aee99ff15f9ab3ae808692b3e6f2596ef. * Revert "New translations 4.things-to-know.md (English)" This reverts commit 698c5e980d2b65942ee63128a2a1ad73442ab732. * Revert "New translations ads.md (English)" This reverts commit f0e1cd2965e2e904d4cba5eaf118b1f9adc1a1a0. * Revert "New translations mfm.md (English)" This reverts commit 51dcc0fc10f1cb32ea881e6267e12c1461110a89. * Revert "New translations webhook.md (English)" This reverts commit cfbebc57835eab30746ae9e16ac13c5e0929cc1b. * Revert "New translations 1.index.md (English)" This reverts commit 67d2bec45c2afd9a85cb3a4912f348313ece279a. * Revert "New translations disable-timelines.md (English)" This reverts commit 19ead90df6acffc95fdbd2a18809eb2a0a15249f. * Revert "New translations webhook.md (French)" This reverts commit 52e6a8429a1fb9488e2af7b08fd534028b82c16d. * Revert "New translations webhook.md (Chinese Traditional)" This reverts commit 395f0fbc4a0f99d9ebf20bc3beef812c0f271216. * Revert "New translations webhook.md (Polish)" This reverts commit ac4e2c534e623d49b53898f6ec5446762fa87591. * Revert "New translations webhook.md (Korean)" This reverts commit 14853e1eab1f5120a361cda0931fce82806a7044. * Revert "New translations pages.md (Korean)" This reverts commit f88e73d1ce3f316388f25f2368194fa1bfd632dc. * Revert "New translations bash.md (Korean)" This reverts commit 60c9fae6a87e911cef01b9afa90120100bf19e89. * Revert "New translations kubernetes.md (Korean)" This reverts commit 2239e8fd2380b1ce0faa5df219f0adc5d0a18626. * Revert "New translations ubuntu-manual.md (Korean)" This reverts commit 3aab9826258a5ab92952a898e9db124a46a1de46. * Revert "New translations 1.about-misskey.md (Chinese Traditional)" This reverts commit 5ac92102db971bbb07486b284cade6afdf1aaa90. * Revert "New translations 2.get-started.md (Chinese Traditional)" This reverts commit d090253e347f5e84a98f53292d92b3fabcc192a2. * Revert "New translations 3.join-server.md (Chinese Traditional)" This reverts commit 634db4d49b55315329b834251edcc064b37add55. * Revert "New translations 4.things-to-know.md (Chinese Traditional)" This reverts commit 383ee08013cd0eff1d71f633c04252c1197e1c81. * Revert "New translations ads.md (Chinese Traditional)" This reverts commit 6ed3b6885ff99f7cfacdbaaead8f20708ddbbc2a. * Revert "New translations drive.md (Chinese Traditional)" This reverts commit 988cacb17e1c975f4bc6d966fbe27941d8063a83. * Revert "New translations mfm.md (Chinese Traditional)" This reverts commit 6b53e36fc49bf9e0a564cf23839f14000ca584ae. * Revert "New translations mute-and-block.md (Chinese Traditional)" This reverts commit 44b1b3c723fbc0390a14e3e19078a631beddcf6f. * Revert "New translations pages.md (Chinese Traditional)" This reverts commit 4e60747a55989248765765fe4dc870878fbf2b27. * Revert "New translations poll.md (Chinese Traditional)" This reverts commit 00385dc6a120f5d3dbd79555c2b1f575f4fb74d7. * Revert "New translations share-form.md (Chinese Traditional)" This reverts commit 8858eaf2f765421e93dc794481ecbf44e485681e. * Revert "New translations thread-mute.md (Chinese Traditional)" This reverts commit d07bd700008d24aa127e39194bfa7446b861aafc. * Revert "New translations 1.troubleshooting.md (Chinese Traditional)" This reverts commit 7405a91ff95640a4d953b81737afa504c1b69cfe. * fix * New translations aiscript.md (Korean) * New translations ja-jp.yml (Chinese Traditional) * New translations troubleshooting.md (Korean) * New translations ja-jp.yml (French) * New translations ja-jp.yml (Italian) * New translations ja-jp.yml (Korean) * New translations ja-jp.yml (Polish) * New translations ja-jp.yml (Chinese Simplified) * New translations ja-jp.yml (English) * New translations ja-jp.yml (Indonesian) * New translations 5.releases.md (Korean) * fix * fix * fix * fix --- content/blog/2021-12-01-inside-misskey-hub.md | 24 + content/blog/2023-02-08-contribute-to-earn.md | 4 + content/blog/2023-12-01-2023recap.md | 4 + .../2023-12-03-inside-misskey-hub-next.md | 15 + content/blog/2023-12-19-mac202319.md | 8 + content/cn/docs/1.about-misskey.md | 7 + .../2.for-users/2.onboarding/2.get-started.md | 5 + .../2.for-users/2.onboarding/3.join-server.md | 2 + .../2.onboarding/4.things-to-know.md | 4 + content/cn/docs/2.for-users/3.features/ads.md | 2 + .../cn/docs/2.for-users/3.features/drive.md | 4 + content/cn/docs/2.for-users/3.features/mfm.md | 10 + .../2.for-users/3.features/mute-and-block.md | 10 + .../cn/docs/2.for-users/3.features/pages.md | 2 + .../cn/docs/2.for-users/3.features/poll.md | 4 + .../docs/2.for-users/3.features/share-form.md | 4 + .../2.for-users/3.features/thread-mute.md | 4 + .../cn/docs/2.for-users/3.features/webhook.md | 4 + .../4.resources/1.troubleshooting.md | 4 + .../cn/docs/2.for-users/4.resources/donate.md | 9 +- .../2.for-users/4.resources/misskey-hub.md | 2 + .../docs/3.for-admin/features/announcement.md | 4 +- content/cn/docs/3.for-admin/features/role.md | 12 +- .../3.for-admin/install/guides/1.index.md | 4 + .../docs/3.for-admin/install/guides/bash.md | 2 + .../docs/3.for-admin/install/guides/docker.md | 7 +- .../3.for-admin/install/guides/kubernetes.md | 2 + .../docs/3.for-admin/install/guides/manual.md | 12 +- .../install/guides/ubuntu-manual.md | 22 + .../docs/3.for-admin/install/resources/cdn.md | 2 + .../install/resources/troubleshooting.md | 4 + .../moderation-tips/disable-timelines.md | 2 + content/cn/docs/4.for-developers/aiscript.md | 67 ++ .../cn/docs/4.for-developers/api/1.index.md | 4 +- .../cn/docs/4.for-developers/api/libraries.md | 2 + .../docs/4.for-developers/api/permission.md | 2 + .../4.for-developers/api/streaming/1.index.md | 8 + content/cn/docs/4.for-developers/api/token.md | 9 + .../4.for-developers/api/token/1.index.md | 88 +++ .../4.for-developers/api/token/2.miauth.md | 76 +++ .../4.for-developers/api/token/3.oauth.md | 179 ++++++ .../4.for-developers/plugin/create-plugin.md | 2 +- content/cn/docs/5.releases.md | 51 ++ content/en/docs/1.about-misskey.md | 9 +- .../2.for-users/2.onboarding/2.get-started.md | 8 +- .../2.for-users/2.onboarding/3.join-server.md | 2 + .../2.onboarding/4.things-to-know.md | 4 + content/en/docs/2.for-users/3.features/ads.md | 2 + .../en/docs/2.for-users/3.features/drive.md | 4 + content/en/docs/2.for-users/3.features/mfm.md | 9 + .../2.for-users/3.features/mute-and-block.md | 10 + .../en/docs/2.for-users/3.features/pages.md | 2 + .../en/docs/2.for-users/3.features/poll.md | 4 + .../docs/2.for-users/3.features/share-form.md | 4 + .../2.for-users/3.features/thread-mute.md | 4 + .../en/docs/2.for-users/3.features/webhook.md | 4 + .../4.resources/1.troubleshooting.md | 4 + .../en/docs/2.for-users/4.resources/donate.md | 11 +- .../2.for-users/4.resources/misskey-hub.md | 2 + .../docs/3.for-admin/features/announcement.md | 4 +- content/en/docs/3.for-admin/features/role.md | 14 +- .../3.for-admin/install/guides/1.index.md | 4 + .../docs/3.for-admin/install/guides/bash.md | 17 +- .../docs/3.for-admin/install/guides/docker.md | 48 +- .../3.for-admin/install/guides/kubernetes.md | 4 +- .../docs/3.for-admin/install/guides/manual.md | 12 +- .../install/guides/ubuntu-manual.md | 24 +- .../docs/3.for-admin/install/resources/cdn.md | 4 +- .../install/resources/troubleshooting.md | 4 + .../moderation-tips/disable-timelines.md | 2 + content/en/docs/4.for-developers/aiscript.md | 67 ++ .../en/docs/4.for-developers/api/1.index.md | 4 +- .../en/docs/4.for-developers/api/libraries.md | 2 + .../docs/4.for-developers/api/permission.md | 2 + .../4.for-developers/api/streaming/1.index.md | 8 + content/en/docs/4.for-developers/api/token.md | 9 + .../4.for-developers/api/token/1.index.md | 88 +++ .../4.for-developers/api/token/2.miauth.md | 76 +++ .../4.for-developers/api/token/3.oauth.md | 179 ++++++ content/en/docs/5.releases.md | 50 ++ content/fr/docs/1.about-misskey.md | 7 + .../2.for-users/2.onboarding/2.get-started.md | 5 + .../2.for-users/2.onboarding/3.join-server.md | 2 + .../2.onboarding/4.things-to-know.md | 4 + content/fr/docs/2.for-users/3.features/ads.md | 2 + .../fr/docs/2.for-users/3.features/drive.md | 4 + content/fr/docs/2.for-users/3.features/mfm.md | 10 + .../2.for-users/3.features/mute-and-block.md | 10 + .../fr/docs/2.for-users/3.features/pages.md | 2 + .../fr/docs/2.for-users/3.features/poll.md | 4 + .../docs/2.for-users/3.features/share-form.md | 4 + .../2.for-users/3.features/thread-mute.md | 4 + .../fr/docs/2.for-users/3.features/webhook.md | 4 + .../4.resources/1.troubleshooting.md | 4 + .../fr/docs/2.for-users/4.resources/donate.md | 11 +- .../2.for-users/4.resources/misskey-hub.md | 2 + .../docs/3.for-admin/features/announcement.md | 4 +- content/fr/docs/3.for-admin/features/role.md | 14 +- .../3.for-admin/install/guides/1.index.md | 4 + .../docs/3.for-admin/install/guides/bash.md | 17 +- .../docs/3.for-admin/install/guides/docker.md | 10 +- .../3.for-admin/install/guides/kubernetes.md | 4 +- .../docs/3.for-admin/install/guides/manual.md | 12 +- .../install/guides/ubuntu-manual.md | 24 +- .../docs/3.for-admin/install/resources/cdn.md | 2 + .../install/resources/troubleshooting.md | 4 + .../moderation-tips/disable-timelines.md | 2 + content/fr/docs/4.for-developers/aiscript.md | 67 ++ .../fr/docs/4.for-developers/api/1.index.md | 4 +- .../fr/docs/4.for-developers/api/libraries.md | 2 + .../docs/4.for-developers/api/permission.md | 2 + .../4.for-developers/api/streaming/1.index.md | 8 + content/fr/docs/4.for-developers/api/token.md | 9 + .../4.for-developers/api/token/1.index.md | 88 +++ .../4.for-developers/api/token/2.miauth.md | 76 +++ .../4.for-developers/api/token/3.oauth.md | 179 ++++++ .../4.for-developers/plugin/create-plugin.md | 2 +- content/fr/docs/5.releases.md | 50 ++ content/id/docs/1.about-misskey.md | 152 ++--- .../2.for-users/2.onboarding/2.get-started.md | 5 + .../2.for-users/2.onboarding/3.join-server.md | 2 + .../2.onboarding/4.things-to-know.md | 4 + .../id/docs/2.for-users/3.features/1.index.md | 6 +- content/id/docs/2.for-users/3.features/ads.md | 14 +- .../id/docs/2.for-users/3.features/antenna.md | 6 +- .../id/docs/2.for-users/3.features/charts.md | 49 +- .../id/docs/2.for-users/3.features/clip.md | 9 +- .../2.for-users/3.features/custom-emoji.md | 9 +- .../id/docs/2.for-users/3.features/deck.md | 28 +- .../id/docs/2.for-users/3.features/drive.md | 26 +- .../docs/2.for-users/3.features/favorite.md | 9 +- .../id/docs/2.for-users/3.features/follow.md | 6 +- .../id/docs/2.for-users/3.features/hashtag.md | 2 +- .../id/docs/2.for-users/3.features/mention.md | 2 +- content/id/docs/2.for-users/3.features/mfm.md | 124 ++-- .../2.for-users/3.features/mute-and-block.md | 66 +- .../id/docs/2.for-users/3.features/pages.md | 30 +- .../id/docs/2.for-users/3.features/poll.md | 4 + .../docs/2.for-users/3.features/share-form.md | 4 + .../2.for-users/3.features/thread-mute.md | 4 + .../id/docs/2.for-users/3.features/webhook.md | 4 + .../4.resources/1.troubleshooting.md | 4 + .../id/docs/2.for-users/4.resources/apps.md | 2 +- .../id/docs/2.for-users/4.resources/donate.md | 22 +- .../2.for-users/4.resources/misskey-hub.md | 2 + .../id/docs/3.for-admin/features/1.index.md | 6 +- .../docs/3.for-admin/features/announcement.md | 24 +- content/id/docs/3.for-admin/features/role.md | 12 +- .../3.for-admin/install/guides/1.index.md | 4 + .../docs/3.for-admin/install/guides/bash.md | 213 +++---- .../docs/3.for-admin/install/guides/docker.md | 42 +- .../3.for-admin/install/guides/kubernetes.md | 2 + .../docs/3.for-admin/install/guides/manual.md | 78 +-- .../install/guides/ubuntu-manual.md | 22 + .../docs/3.for-admin/install/resources/cdn.md | 2 + .../install/resources/troubleshooting.md | 4 + .../moderation-tips/disable-timelines.md | 2 + content/id/docs/4.for-developers/aiscript.md | 67 ++ .../id/docs/4.for-developers/api/1.index.md | 4 +- .../id/docs/4.for-developers/api/libraries.md | 2 + .../docs/4.for-developers/api/permission.md | 2 + .../4.for-developers/api/streaming/1.index.md | 8 + content/id/docs/4.for-developers/api/token.md | 9 + .../4.for-developers/api/token/1.index.md | 88 +++ .../4.for-developers/api/token/2.miauth.md | 76 +++ .../4.for-developers/api/token/3.oauth.md | 179 ++++++ .../4.for-developers/plugin/create-plugin.md | 2 +- content/id/docs/5.releases.md | 50 ++ content/it/docs/1.about-misskey.md | 7 + .../2.for-users/2.onboarding/2.get-started.md | 5 + .../2.for-users/2.onboarding/3.join-server.md | 2 + .../2.onboarding/4.things-to-know.md | 4 + content/it/docs/2.for-users/3.features/ads.md | 2 + .../it/docs/2.for-users/3.features/drive.md | 4 + content/it/docs/2.for-users/3.features/mfm.md | 10 + .../2.for-users/3.features/mute-and-block.md | 10 + .../it/docs/2.for-users/3.features/pages.md | 2 + .../it/docs/2.for-users/3.features/poll.md | 4 + .../docs/2.for-users/3.features/share-form.md | 4 + .../2.for-users/3.features/thread-mute.md | 4 + .../it/docs/2.for-users/3.features/webhook.md | 158 +++-- .../4.resources/1.troubleshooting.md | 4 + .../it/docs/2.for-users/4.resources/donate.md | 11 +- .../2.for-users/4.resources/misskey-hub.md | 2 + .../docs/3.for-admin/features/announcement.md | 4 +- content/it/docs/3.for-admin/features/role.md | 14 +- .../3.for-admin/install/guides/1.index.md | 4 + .../docs/3.for-admin/install/guides/bash.md | 17 +- .../docs/3.for-admin/install/guides/docker.md | 10 +- .../3.for-admin/install/guides/kubernetes.md | 4 +- .../docs/3.for-admin/install/guides/manual.md | 12 +- .../install/guides/ubuntu-manual.md | 24 +- .../docs/3.for-admin/install/resources/cdn.md | 2 + .../install/resources/troubleshooting.md | 4 + .../moderation-tips/disable-timelines.md | 2 + content/it/docs/4.for-developers/aiscript.md | 67 ++ .../it/docs/4.for-developers/api/1.index.md | 4 +- .../it/docs/4.for-developers/api/libraries.md | 2 + .../docs/4.for-developers/api/permission.md | 2 + .../4.for-developers/api/streaming/1.index.md | 8 + content/it/docs/4.for-developers/api/token.md | 9 + .../4.for-developers/api/token/1.index.md | 88 +++ .../4.for-developers/api/token/2.miauth.md | 76 +++ .../4.for-developers/api/token/3.oauth.md | 179 ++++++ .../4.for-developers/plugin/create-plugin.md | 2 +- content/it/docs/5.releases.md | 50 ++ content/ja/.docs-legacy/api/index.md | 12 + content/ja/docs/1.about-misskey.md | 3 + .../2.for-users/2.onboarding/2.get-started.md | 1 + .../2.for-users/2.onboarding/3.join-server.md | 1 + content/ja/docs/2.for-users/3.features/mfm.md | 1 + .../ja/docs/2.for-users/4.resources/donate.md | 1 + .../docs/3.for-admin/features/announcement.md | 1 + content/ja/docs/3.for-admin/features/role.md | 1 + .../3.for-admin/install/guides/1.index.md | 1 + .../docs/3.for-admin/install/guides/docker.md | 2 + .../3.for-admin/install/guides/kubernetes.md | 1 + .../docs/3.for-admin/install/guides/manual.md | 3 + .../4.for-developers/api/token/2.miauth.md | 1 + .../4.for-developers/api/token/3.oauth.md | 1 + content/ja/docs/5.releases.md | 4 + content/ko/docs/1.about-misskey.md | 18 +- .../2.for-users/2.onboarding/1.warning.md | 2 +- .../2.for-users/2.onboarding/2.get-started.md | 7 +- .../2.for-users/2.onboarding/3.join-server.md | 5 +- .../2.onboarding/4.things-to-know.md | 14 +- content/ko/docs/2.for-users/3.features/ads.md | 9 +- .../2.for-users/3.features/custom-emoji.md | 2 +- .../ko/docs/2.for-users/3.features/drive.md | 20 +- content/ko/docs/2.for-users/3.features/mfm.md | 44 +- .../2.for-users/3.features/mute-and-block.md | 54 +- .../ko/docs/2.for-users/3.features/pages.md | 2 + .../ko/docs/2.for-users/3.features/poll.md | 10 +- .../docs/2.for-users/3.features/share-form.md | 38 +- .../2.for-users/3.features/thread-mute.md | 4 + .../ko/docs/2.for-users/3.features/webhook.md | 4 + .../4.resources/1.troubleshooting.md | 46 +- .../ko/docs/2.for-users/4.resources/donate.md | 13 +- .../2.for-users/4.resources/misskey-hub.md | 6 +- .../docs/3.for-admin/features/announcement.md | 6 +- content/ko/docs/3.for-admin/features/role.md | 19 +- .../3.for-admin/install/guides/1.index.md | 7 +- .../docs/3.for-admin/install/guides/bash.md | 2 + .../docs/3.for-admin/install/guides/docker.md | 9 +- .../3.for-admin/install/guides/kubernetes.md | 4 +- .../docs/3.for-admin/install/guides/manual.md | 40 +- .../install/guides/ubuntu-manual.md | 22 + .../docs/3.for-admin/install/resources/cdn.md | 2 + .../install/resources/troubleshooting.md | 4 + .../moderation-tips/disable-timelines.md | 2 + content/ko/docs/4.for-developers/aiscript.md | 67 ++ .../ko/docs/4.for-developers/api/1.index.md | 4 +- .../ko/docs/4.for-developers/api/libraries.md | 2 + .../docs/4.for-developers/api/permission.md | 4 +- .../4.for-developers/api/streaming/1.index.md | 24 +- content/ko/docs/4.for-developers/api/token.md | 9 + .../4.for-developers/api/token/1.index.md | 88 +++ .../4.for-developers/api/token/2.miauth.md | 76 +++ .../4.for-developers/api/token/3.oauth.md | 179 ++++++ content/ko/docs/5.releases.md | 430 +++++++------ content/ns.md | 4 + content/pl/docs/1.about-misskey.md | 7 + .../2.for-users/2.onboarding/2.get-started.md | 5 + .../2.for-users/2.onboarding/3.join-server.md | 2 + .../2.onboarding/4.things-to-know.md | 4 + content/pl/docs/2.for-users/3.features/ads.md | 2 + .../pl/docs/2.for-users/3.features/drive.md | 4 + content/pl/docs/2.for-users/3.features/mfm.md | 10 + .../2.for-users/3.features/mute-and-block.md | 10 + .../pl/docs/2.for-users/3.features/pages.md | 2 + .../pl/docs/2.for-users/3.features/poll.md | 4 + .../docs/2.for-users/3.features/share-form.md | 4 + .../2.for-users/3.features/thread-mute.md | 4 + .../pl/docs/2.for-users/3.features/webhook.md | 4 + .../4.resources/1.troubleshooting.md | 4 + .../pl/docs/2.for-users/4.resources/donate.md | 11 +- .../2.for-users/4.resources/misskey-hub.md | 2 + .../docs/3.for-admin/features/announcement.md | 4 +- content/pl/docs/3.for-admin/features/role.md | 12 +- .../3.for-admin/install/guides/1.index.md | 4 + .../docs/3.for-admin/install/guides/bash.md | 17 +- .../docs/3.for-admin/install/guides/docker.md | 10 +- .../3.for-admin/install/guides/kubernetes.md | 4 +- .../docs/3.for-admin/install/guides/manual.md | 12 +- .../install/guides/ubuntu-manual.md | 24 +- .../docs/3.for-admin/install/resources/cdn.md | 2 + .../install/resources/troubleshooting.md | 4 + .../moderation-tips/disable-timelines.md | 2 + content/pl/docs/4.for-developers/aiscript.md | 67 ++ .../pl/docs/4.for-developers/api/1.index.md | 4 +- .../pl/docs/4.for-developers/api/libraries.md | 2 + .../docs/4.for-developers/api/permission.md | 2 + .../4.for-developers/api/streaming/1.index.md | 8 + content/pl/docs/4.for-developers/api/token.md | 9 + .../4.for-developers/api/token/1.index.md | 88 +++ .../4.for-developers/api/token/2.miauth.md | 76 +++ .../4.for-developers/api/token/3.oauth.md | 179 ++++++ .../4.for-developers/plugin/create-plugin.md | 2 +- content/pl/docs/5.releases.md | 50 ++ content/tw/docs/1.about-misskey.md | 7 + .../2.for-users/2.onboarding/2.get-started.md | 5 + .../2.for-users/2.onboarding/3.join-server.md | 2 + .../2.onboarding/4.things-to-know.md | 4 + content/tw/docs/2.for-users/3.features/ads.md | 2 + .../tw/docs/2.for-users/3.features/drive.md | 4 + content/tw/docs/2.for-users/3.features/mfm.md | 9 + .../2.for-users/3.features/mute-and-block.md | 10 + .../tw/docs/2.for-users/3.features/pages.md | 2 + .../tw/docs/2.for-users/3.features/poll.md | 4 + .../docs/2.for-users/3.features/share-form.md | 4 + .../2.for-users/3.features/thread-mute.md | 4 + .../tw/docs/2.for-users/3.features/webhook.md | 4 + .../4.resources/1.troubleshooting.md | 4 + .../tw/docs/2.for-users/4.resources/donate.md | 9 +- .../2.for-users/4.resources/misskey-hub.md | 2 + .../docs/3.for-admin/features/announcement.md | 4 +- content/tw/docs/3.for-admin/features/role.md | 14 +- .../3.for-admin/install/guides/1.index.md | 6 +- .../docs/3.for-admin/install/guides/bash.md | 17 +- .../docs/3.for-admin/install/guides/docker.md | 39 +- .../3.for-admin/install/guides/kubernetes.md | 4 +- .../docs/3.for-admin/install/guides/manual.md | 86 +-- .../install/guides/ubuntu-manual.md | 24 +- .../docs/3.for-admin/install/resources/cdn.md | 4 +- .../install/resources/troubleshooting.md | 4 + .../moderation-tips/disable-timelines.md | 6 +- content/tw/docs/4.for-developers/aiscript.md | 67 ++ .../tw/docs/4.for-developers/api/1.index.md | 4 +- .../tw/docs/4.for-developers/api/libraries.md | 2 + .../docs/4.for-developers/api/permission.md | 4 +- .../4.for-developers/api/streaming/1.index.md | 8 + content/tw/docs/4.for-developers/api/token.md | 9 + .../4.for-developers/api/token/1.index.md | 88 +++ .../4.for-developers/api/token/2.miauth.md | 76 +++ .../4.for-developers/api/token/3.oauth.md | 179 ++++++ .../4.for-developers/plugin/create-plugin.md | 2 +- .../publish-on-your-website.md | 4 +- content/tw/docs/5.releases.md | 60 +- locales/en-US.yml | 66 +- locales/fr-FR.yml | 64 ++ locales/id-ID.yml | 574 ++++++++++-------- locales/it-IT.yml | 64 ++ locales/ko-KR.yml | 64 ++ locales/pl-PL.yml | 64 ++ locales/zh-CN.yml | 124 +++- locales/zh-TW.yml | 147 ++++- 346 files changed, 6921 insertions(+), 1401 deletions(-) create mode 100644 content/cn/docs/4.for-developers/aiscript.md create mode 100644 content/cn/docs/4.for-developers/api/token/1.index.md create mode 100644 content/cn/docs/4.for-developers/api/token/2.miauth.md create mode 100644 content/cn/docs/4.for-developers/api/token/3.oauth.md create mode 100644 content/en/docs/4.for-developers/aiscript.md create mode 100644 content/en/docs/4.for-developers/api/token/1.index.md create mode 100644 content/en/docs/4.for-developers/api/token/2.miauth.md create mode 100644 content/en/docs/4.for-developers/api/token/3.oauth.md create mode 100644 content/fr/docs/4.for-developers/aiscript.md create mode 100644 content/fr/docs/4.for-developers/api/token/1.index.md create mode 100644 content/fr/docs/4.for-developers/api/token/2.miauth.md create mode 100644 content/fr/docs/4.for-developers/api/token/3.oauth.md create mode 100644 content/id/docs/4.for-developers/aiscript.md create mode 100644 content/id/docs/4.for-developers/api/token/1.index.md create mode 100644 content/id/docs/4.for-developers/api/token/2.miauth.md create mode 100644 content/id/docs/4.for-developers/api/token/3.oauth.md create mode 100644 content/it/docs/4.for-developers/aiscript.md create mode 100644 content/it/docs/4.for-developers/api/token/1.index.md create mode 100644 content/it/docs/4.for-developers/api/token/2.miauth.md create mode 100644 content/it/docs/4.for-developers/api/token/3.oauth.md create mode 100644 content/ko/docs/4.for-developers/aiscript.md create mode 100644 content/ko/docs/4.for-developers/api/token/1.index.md create mode 100644 content/ko/docs/4.for-developers/api/token/2.miauth.md create mode 100644 content/ko/docs/4.for-developers/api/token/3.oauth.md create mode 100644 content/pl/docs/4.for-developers/aiscript.md create mode 100644 content/pl/docs/4.for-developers/api/token/1.index.md create mode 100644 content/pl/docs/4.for-developers/api/token/2.miauth.md create mode 100644 content/pl/docs/4.for-developers/api/token/3.oauth.md create mode 100644 content/tw/docs/4.for-developers/aiscript.md create mode 100644 content/tw/docs/4.for-developers/api/token/1.index.md create mode 100644 content/tw/docs/4.for-developers/api/token/2.miauth.md create mode 100644 content/tw/docs/4.for-developers/api/token/3.oauth.md diff --git a/content/blog/2021-12-01-inside-misskey-hub.md b/content/blog/2021-12-01-inside-misskey-hub.md index 7277daa0..ebbf2592 100644 --- a/content/blog/2021-12-01-inside-misskey-hub.md +++ b/content/blog/2021-12-01-inside-misskey-hub.md @@ -6,7 +6,9 @@ description: 'Misskey Advent Calendar 2021 1日目の記事です。Misskey Hub # インサイド Misskey Hub :::tip + この記事は、[Misskey Advent Calendar 2021](https://adventar.org/calendars/6273) 1日目の記事です。 + ::: こんにちはsyuiloです。いつもMisskeyを利用してくださってありがとうございます。開発の励みになります！ @@ -29,7 +31,9 @@ Misskey Hubの実装について理解するためには、いくつかの前提 ## 静的サイト is 何 :::warning + **性的サイト**と誤変換しやすいので注意 + ::: こういった記事がメインのWebサイトは、一般的にはWordpressなどのソフトウェアを使って管理することが多いですが、Misskey Hubはそうではありません。\ @@ -42,9 +46,11 @@ Misskey Hubは、Misskey Hub内のMisskey Hub説明ページにもあるよう 静的なサイトは逆に、そういったリッチなことは行わず、**予め用意したコンテンツをどのユーザーに対しても同じように表示するだけのサイト**です。Misskey Hubは(サイト更新を除けば)誰がいつ見ても同じ内容なので、静的サイトです。 :::tip + 技術的な話になりますが、静的と言っても、静的なのは「サーバーから」送られてくる内容だけであって、JavaScriptを使ってブラウザ上で動的にページの内容を変えることは可能です。 例えばMisskey Hubでは、サイドバーに表示されるMisskeyや藍ちゃんの広告はページを訪れるたびにランダムで変わるようになっています。\ さらに言うと、静的サイト内に別の動的サイトを埋め込んで表示することも可能です。これを利用して、将来的にはそのページに対するMisskeyのコメントタイムラインをページに表示する、といったことも実装されるかもしれません。 + ::: ### 静的サイトだと何が嬉しいのか @@ -64,6 +70,7 @@ Misskey Hubは、Misskey Hub内のMisskey Hub説明ページにもあるよう 動的サイトを運営する際に発生するそのような諸々の心配から解放されるというのは非常に大きなメリットです。つまり、金銭面においても精神面においても、**ゼロコスト**でMisskey Hubを運用できます。 :::g-details{summary="さらに技術的な話(危険)"} + ここまで言っておいてなんですが、先ほど言った > もちろんMisskeyは動的サイトということになります。 @@ -80,6 +87,7 @@ MisskeyのWebサーバーは、その不変なJavaScriptを送り返すだけで 実際、インスタンスサーバーがトラブルなどで落ちていても、クライアントにはアクセスすることができますし、テーマの設定などサーバーに依存しない操作は普通に行うことができます。 ちなみに、こういう構成のことをIT界では**サーバーレス**と呼んだりするっぽいです。知らんけど。 + ::: ## SSG is 何 @@ -122,7 +130,9 @@ Misskey Hubもプラグイン機能を使っていて、「関連するページ さらに、MFMを実際に書いて試せるプレイグラウンド機能や、APIリファレンスにおけるAPIコンソールなども今後実装予定です。 :::tip + 「関連するページ」「最近更新されたページ」は我ながら便利機能だと思っているので、Misskey Hub以外のvuepressを採用したサイトでも使えるようにnpmで一般公開しようかとも考えています。 + ::: ### 多言語対応(i18n) @@ -150,15 +160,21 @@ vuepress標準の機能で、右上にあるやつです。各ページの見出 各ページはMarkdown(MFMみたいなもの(いや本来はMFMが「Markdownのようなもの」という立ち位置だけれども))というマークアップ言語で書かれています。Markdownを使うことで、簡単に見出し、リンク、画像、表といった要素を表現できるほか、 :::tip + こんな + ::: :::warning + 感じの + ::: :::danger + メッセージ + ::: を表示したりできます。(厳密にはMarkdownの拡張構文) @@ -187,7 +203,9 @@ Misskey Hub内のMisskey Hub説明ページにもあるように、Misskey Hub 各インスタンス紹介は、インスタンス側で用意されたプロフィールレンダリングページをiframeというHTMLの機能で埋め込んで表示するようになっています。したがって、一度Misskey Hubにインスタンスを登録してしまえば、インスタンスの名前、説明、バナー画像といった情報を更新した場合でもリアルタイムでインスタンス一覧に反映されます。 :::tip + インスタンス一覧へ掲載するインスタンスを募集しています。お気軽にご連絡ください🤗 + ::: ## 管理 @@ -207,7 +225,9 @@ Misskey Hubにおいては、GitHub ActionsというGitHubの機能を利用し GitHub Pagesは前述した「静的サイトを提供してくれる機能」です。GitHubのインフラストラクチャ上で動くため、いちどデプロイしてしまえば、あとは何の心配もなくMisskey Hubが提供され続けます。 :::warning + 「何の心配もなく」はちょっと言い過ぎたかもしれません。というのも、(強いていうと)ひとつだけ心配があって、それはドメインです。Misskey Hubはmisskey-hub.netというドメインで提供されていますが、これは私が用意したものです。そのため、もし万が一私がドメインの更新を忘れるとMisskey Hubに繋がらなくなりますが、そこは𝑇𝑟𝑢𝑠𝑡 𝑚𝑒 + ::: 通常のWebサイトであれば、サーバーにFTPでファイルをアップロードしたり、サーバーにSSHで繋いでファイルをダウンロードしてきたりといった作業が必要になりますが、GitHub Pagesではそのような手間すら要りません。 @@ -230,7 +250,9 @@ SSGはMisskey Hubのようなドキュメントサイトだけでなく、ブロ 静的サイトはいいぞ。vuepressはいいぞ。Misskey Hubに幸あれ🙏 :::g-details{summary="Webで記事を公開する際に必ず記述しなければならないと法令で定められている言葉"} + > いかがでしたか？ + ::: --- @@ -248,5 +270,7 @@ SSGはMisskey Hubのようなドキュメントサイトだけでなく、ブロ 栄養があるし、加熱不要で調理も楽(ハサミで切って味噌に突っ込んでチンするだけで味噌汁できる) :::danger + ただし加熱しないと風味が強すぎ、ちょっとしたワサビ食べてるみたいになるので多少訓練が必要 + ::: diff --git a/content/blog/2023-02-08-contribute-to-earn.md b/content/blog/2023-02-08-contribute-to-earn.md index 0bebbf1e..28bc72b9 100644 --- a/content/blog/2023-02-08-contribute-to-earn.md +++ b/content/blog/2023-02-08-contribute-to-earn.md @@ -10,18 +10,22 @@ We offer campaigns you to recieve rewards for contributing to the development of :::tip + 条件や報奨金の額は、予告なく変更になる場合があります。 Conditions and reward amounts are subject to change without notice. これ以外にも貢献に応じて不定期に給付金を支給中 In addition to those, benefits are being paid at irregular intervals based on contributions. + ::: :::warning + 報奨金の原資はパトロンの皆様からの寄付で成り立っています。 Rewards come from donations from patrons. [**→ 寄付について / About Donations**](../docs/donate.html) + ::: ## カバレッジ上げ / Increase Coverage diff --git a/content/blog/2023-12-01-2023recap.md b/content/blog/2023-12-01-2023recap.md index 08bf9848..62ad9246 100644 --- a/content/blog/2023-12-01-2023recap.md +++ b/content/blog/2023-12-01-2023recap.md @@ -6,7 +6,9 @@ date: 2023-12-01 # Misskey 2023 recap :::tip + これは[Misskey Advent Calendar 2023](https://adventar.org/calendars/8742)一日目の記事です。 + ::: こんにちは、しゅいろです。2023年も残すところあと1ヶ月となりました。 @@ -329,7 +331,9 @@ https://xn--931a.moe/ そして来年もMisskeyを発展させていきますので何卒よろしくお願いいたします！！ :::tip + Misskeyの今のコードネーム(v13~)は「nasubi」です。今年の初め、コードネームは今後野菜で統一していこうと思い、一番手は「一富士二鷹三茄子」とも言われ縁起の良い🍆を選びました。そして言葉通り縁起の良い年になりました。 + ::: それでは(ちょっと早いですが)、Merry Christmas and Happy New Year! diff --git a/content/blog/2023-12-03-inside-misskey-hub-next.md b/content/blog/2023-12-03-inside-misskey-hub-next.md index e8ad3c09..b0aae485 100644 --- a/content/blog/2023-12-03-inside-misskey-hub-next.md +++ b/content/blog/2023-12-03-inside-misskey-hub-next.md @@ -6,7 +6,9 @@ date: 2023-12-03 # インサイド Misskey Hub Next :::tip + この記事は、[Misskey Alt Advent Calendar 2023](https://adventar.org/calendars/8658) 3日目の記事です。 + ::: ![](/img/og/misskey-hub-screenshot-d.png) @@ -22,7 +24,9 @@ date: 2023-12-03 しかし、もともとのMisskey Hubの計画上、ドキュメント以外のページもかなり必要になるということで、ドキュメント生成に特化したフレームワークではなく、より拡張性が高く、汎用的な[Nuxt](https://nuxt.com/)をフレームワークとして採用しました。 :::warning + VuePressよりは、今はどちらかというと[VitePress](https://vitepress.dev/)のほうがメジャーな感じがします。 + ::: :::g-details{summary="詳しい技術スタックはこちら"} @@ -60,7 +64,9 @@ VuePressよりは、今はどちらかというと[VitePress](https://vitepress. そして、今回のMisskey Hub Nextでは、ドキュメントページとブログページに**ISR**を、それ以外のページに**SSG**を適用しています。略称多くてこんがらがりそう。 :::tip + プロジェクト名に`Next`と入っているのでReactフレームワークの[Next.js](https://nextjs.org/)のほうを思い浮かべたかもしれませんが、**罠です。** Nuxtで作ってあります。 + ::: ## ISRとは？ @@ -127,6 +133,7 @@ Misskeyをより多くの人に広めるために、ぜひご協力お願いし ::: :::g-details{summary="【マニアック】フォントのはなし"} + Misskey Hub Nextでは、フォントの改善も行いました。 現行のMisskey Hubで使われているフォント（Kosugi Maru）は、英字が歪で、英単語や英文になると読みにくくなっていました。また、日本語の漢字部分が中国語とバッティングして不自然に見えてしまうという問題もありました。 @@ -168,7 +175,9 @@ Misskeyの[サーバー一覧](/servers/)を、[Misskeyをはじめよう(joinmi これにより、基本的には**サーバーを追加するのに特別な作業や申請は必要なくなり、新しく見つかったサーバーは自動的に追加されるようになりました！** :::tip + なので近日中にjoinmisskeyはMisskey Hubに統合されるかも…？ + ::: ### 【新機能】ツール集 @@ -185,7 +194,9 @@ Misskey関連のさまざまな便利ツールを提供するページ「[ツー をご利用いただけますが、今後も随時拡充していく予定です💪 :::tip + [MFMお試しコーナー](/tools/mfm-playground/)の再現精度は割と高いのでMFMアートづくりにもおすすめです + ::: ### 【新機能】AiScriptに対応 @@ -205,12 +216,14 @@ for (let i, 100) { :::fukidashi{chara="doya_ai" charaName="藍"} + Misskey Hub Nextでは、わたし・藍も色々なところにいます！ ほら、こんなところにも！ ![](https://media.misskeyusercontent.com/io/7f980e50-bbd8-4527-b9f7-f6f97564956a.png) ほかにも色々なところに隠れているので、ぜひ探してみてくださいね♪ + ::: さらに、古いにしえのミスキストや、現行Misskey Hubのヘビーユーザーしか知らないであろう、知る人ぞ知る機能・**藍モード**も移植しました！ @@ -231,7 +244,9 @@ Misskey Hub Nextでは、わたし・藍も色々なところにいます！ こちらは、現在[株式会社MisskeyHQ (村上さん)](https://misskey.io/notes/9l0i92bvr1)と連携しながら、ドキュメントの拡充に取り組んでいます。もう少しお待ち下さい🙏 :::tip + ドキュメントの拡充にご協力いただける方は、[こちら](https://misskey.io/notes/9l0i92bvr1)をご覧のうえ、ぜひご参加ください！ + ::: ### シェアボタン中継機能 diff --git a/content/blog/2023-12-19-mac202319.md b/content/blog/2023-12-19-mac202319.md index c978ea68..6d684488 100644 --- a/content/blog/2023-12-19-mac202319.md +++ b/content/blog/2023-12-19-mac202319.md @@ -5,7 +5,9 @@ date: 2023-12-19 # Deep dive on the linkage between Misskey and Vue.js :::tip + これは [Misskey Advent Calendar 2023](https://adventar.org/calendars/8742) 19 日目の記事です. + ::: こんにちは, コアチームメンバーの [acid-chicken](https://github.com/acid-chicken) です. Misskey の開発には nighthike v4 あたりから参加しており, 現在は本業の傍ら, 余暇にリファクタリングやコードレビューなどをやっていることが多いです. @@ -13,7 +15,9 @@ date: 2023-12-19 Misskey では [2018 年からフロントエンドの UI フレームワークに Vue.js を採用し](https://github.com/misskey-dev/misskey/pull/1116)ており, メジャーアップデートのマイグレーションなどを経て, 現在も継続して使用しています. 今回は, Misskey のフロントエンド構造について, Vue.js の機能との接点を中心に深掘りしていきます. :::tip + 大まかな解説は既に syuilo 連載[「Misskey & Webテクノロジー最前線」9月](/blog/2023-09-11-gihyo)などで触れられています. 一方で, 本記事では連載で触れないような, 細かい部分に焦点を絞った話題を扱うため, もしかすると読んでいてつまらない内容になっているかもしれません. 予めご了承ください. + ::: ## Misskey のフロントエンド構造 @@ -112,9 +116,11 @@ Misskey と Vue.js に話を戻すと, SFC に Misskey が CSS モジュールを使うようになった後のある日, syuilo は言いました. :::fukidashi{chara="syuilo" charaName="しゅいろ"} + えー、CSS Modulesってminifyしてくれにゃいんだ ![](https://s3.arkjp.net/misskey/1b008643-4932-40d8-980b-fe3da75db856.png) + ::: — https://misskey.io/notes/9fd9w06qah @@ -199,7 +205,9 @@ HelloWorld.__cssModules = { このようなことになってしまうのは, バインドの参照を常に静的に置換できるとは限らないためです. 例えば, $style.redColoredText のような参照は静的に置換できても, $style\[color + "ColoredText"\] のような参照はビルド時に color の値が定まるとは保証できないので, 静的に置換できません. また, Vue.js の Composition API では, useCssModule() を呼び出すことで, バインド用のマップ全体を取得することを許容しています. このような経緯で, 成果物にマップがそのまま含まれているのです. 逆に, それらの機能を一切使わないのであれば, 完全にそれらは無駄になっているといえます. 完全に無駄なものは安全に除去できるはずです. そこで, Misskey では, $style 配下を識別子のメンバーアクセスによる参照のみを認めるルールで運用することを前提に, 静的置換を行う Rollup プラグインを開発および使用することで, 成果物からマップを除去するようにしました. これにより, バンドルサイズの 3% 程度の削減につながりました. :::tip + 詳細は [#10923](https://github.com/misskey-dev/misskey/issues/10923) を参照してください. + ::: ## 今後の展望 diff --git a/content/cn/docs/1.about-misskey.md b/content/cn/docs/1.about-misskey.md index a67dba09..78d3b431 100644 --- a/content/cn/docs/1.about-misskey.md +++ b/content/cn/docs/1.about-misskey.md @@ -15,7 +15,9 @@ Misskeyはオープンソースの分散型マイクロブログプラットフ 当初は分散型ではありませんでしたが、2018年にActivityPubを実装し分散型になったことで、より多くの方に認知され利用されるサービスになり、現在に至ります。 :::tip + Misskeyという名前は、syuiloが当時聴いていたMay'nというアーティストの楽曲、Brain Diverの歌詞に由来します。 + ::: 誰でも開発に参加することができ、現在でも活発に開発が続いています。 @@ -35,7 +37,9 @@ Misskeyのすべてのソースコードは[AGPL](https://github.com/misskey-dev 再び引き合いに出しますが、TwitterやFacebookなどの利益を得ているほとんどのサービスはオープンソースではありません。 :::tip + 技術的に言うと、MisskeyのソースコードはGitで管理されていて、リポジトリは[GitHub上でホスティングされています。](https://github.com/misskey-dev) + ::: ## 開発に参加する、プロジェクトを支援する @@ -143,8 +147,11 @@ Misskeyは開発が進むにつれ使用する技術も大きく変わってき :::fukidashi{chara="doya_ai" charaName="藍"} わたしについては[このホームページ](https://xn--931a.moe/)をご覧ください！ + ::: :::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"} + Misskeyの守り神、藍ちゃんです。ｱｲﾁｬﾝｶﾜｲｲﾔｯﾀｰ! + ::: diff --git a/content/cn/docs/2.for-users/2.onboarding/2.get-started.md b/content/cn/docs/2.for-users/2.onboarding/2.get-started.md index aa4d1522..69e63d26 100644 --- a/content/cn/docs/2.for-users/2.onboarding/2.get-started.md +++ b/content/cn/docs/2.for-users/2.onboarding/2.get-started.md @@ -11,14 +11,17 @@ Misskeyを利用するには、どこかのサーバーにアカウントを作 [サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。 :::tip + どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 :::g-details{summary='詳細'} + Misskeyには連合機能が備わっています。 連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。 Misskeyが搭載している連合機能はActivityPubというオープンな共通規格に基づいていて、MastodonやPleromaといったほかのソフトウェアとも互換性があります。 + ::: ::: @@ -31,5 +34,7 @@ Misskeyが搭載している連合機能はActivityPubというオープンな 自分にあったテーマのサーバーを探すのもおすすめです。 :::tip + サーバーの一覧は[こちら](/servers/)からご覧いただけます。 + ::: diff --git a/content/cn/docs/2.for-users/2.onboarding/3.join-server.md b/content/cn/docs/2.for-users/2.onboarding/3.join-server.md index 6f42c0c1..7c26053a 100644 --- a/content/cn/docs/2.for-users/2.onboarding/3.join-server.md +++ b/content/cn/docs/2.for-users/2.onboarding/3.join-server.md @@ -3,9 +3,11 @@ 登録するサーバーが決まったら、さっそくアカウントを作成しましょう。 :::tip + ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 ただし、入力事項はサーバーによって異なることがあります。詳しくは、サーバー管理者にお問い合わせください。 + ::: ## 登録する diff --git a/content/cn/docs/2.for-users/2.onboarding/4.things-to-know.md b/content/cn/docs/2.for-users/2.onboarding/4.things-to-know.md index e77c9aa2..d5428ffb 100644 --- a/content/cn/docs/2.for-users/2.onboarding/4.things-to-know.md +++ b/content/cn/docs/2.for-users/2.onboarding/4.things-to-know.md @@ -7,7 +7,9 @@ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一般的なSNSに比べたくさんの機能がありますので、初めての投稿を行う前に必ず確認して、上手に投稿しましょう！ :::tip + 詳細は、「[ノート](/docs/for-users/features/note/)」をご覧ください。 + ::: ## タイムライン @@ -15,7 +17,9 @@ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一 Misskeyは、複数のタイムラインを持っています。名前だけでは少々わかりにくいかと思いますので、それぞれがどのような働きをするのかを知っておきましょう。 :::tip + 詳細は、「[タイムライン](/docs/for-users/features/timeline/)」をご覧ください。 + ::: ## その他 diff --git a/content/cn/docs/2.for-users/3.features/ads.md b/content/cn/docs/2.for-users/3.features/ads.md index 456c5790..72aa40ec 100644 --- a/content/cn/docs/2.for-users/3.features/ads.md +++ b/content/cn/docs/2.for-users/3.features/ads.md @@ -4,7 +4,9 @@ Misskeyではサーバーによる広告をタイムラインなどに表示で 広告の右上に表示されるアイコンをクリックすることで、当該の広告の表示頻度を下げることができます。 :::tip + 広告の総数が少ない場合は、表示頻度を下げた後も連続で表示される可能性があります。 + ::: ## 広告の設定(管理者) diff --git a/content/cn/docs/2.for-users/3.features/drive.md b/content/cn/docs/2.for-users/3.features/drive.md index 3fc879de..81f0417d 100644 --- a/content/cn/docs/2.for-users/3.features/drive.md +++ b/content/cn/docs/2.for-users/3.features/drive.md @@ -3,7 +3,9 @@ ドライブは、Misskey上でファイルを管理できる機能です。 :::tip + 技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。 + ::: Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。 @@ -13,7 +15,9 @@ Misskey Webのドライブページから任意のファイルをアップロー ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。 :::warning + 現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。 + ::: ## センシティブ (NSFW) diff --git a/content/cn/docs/2.for-users/3.features/mfm.md b/content/cn/docs/2.for-users/3.features/mfm.md index 5771232a..6ec1aa36 100644 --- a/content/cn/docs/2.for-users/3.features/mfm.md +++ b/content/cn/docs/2.for-users/3.features/mfm.md @@ -7,7 +7,9 @@ description: MFMは、Misskeyの様々な場所で使用できる専用のマー MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。 :::tip + 一部の構文はMarkdownやHTMLと互換性があります。 + ::: ## MFMが使用可能な場所の例 @@ -23,7 +25,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使 アットマーク + ユーザー名で、特定のユーザーを示すことができます。 :::tip + メンションについての詳細は[こちら](./mention.md)を参照してください。 + ::: ``` @@ -42,7 +46,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使 ナンバーサイン + タグで、ハッシュタグを示すことができます。 :::tip + ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。 + ::: ``` @@ -70,6 +76,7 @@ https://example.com ``` :::tip + リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。 ``` @@ -83,8 +90,11 @@ https://example.com ### カスタム絵文字 コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。 + :::tip + カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。 + ::: ``` diff --git a/content/cn/docs/2.for-users/3.features/mute-and-block.md b/content/cn/docs/2.for-users/3.features/mute-and-block.md index 9ff1ddf9..6fa407ce 100644 --- a/content/cn/docs/2.for-users/3.features/mute-and-block.md +++ b/content/cn/docs/2.for-users/3.features/mute-and-block.md @@ -5,11 +5,15 @@ ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。 :::tip + ミュートとブロックは併用できます。 + ::: :::warning + 利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。 + ::: Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。 @@ -26,7 +30,9 @@ Misskey Webでは、設定>ミュートとブロック から、自分がミュ Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。 :::tip + ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。 + ::: ## ブロック @@ -48,9 +54,13 @@ Misskey Webでユーザーをミュートするには、対象のユーザーの Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。 :::warning + ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。 + ::: :::warning + 相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。 + ::: diff --git a/content/cn/docs/2.for-users/3.features/pages.md b/content/cn/docs/2.for-users/3.features/pages.md index 21a59a21..0bb1232f 100644 --- a/content/cn/docs/2.for-users/3.features/pages.md +++ b/content/cn/docs/2.for-users/3.features/pages.md @@ -3,7 +3,9 @@ Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。 :::warning + v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。 + ::: ## ページ設定 diff --git a/content/cn/docs/2.for-users/3.features/poll.md b/content/cn/docs/2.for-users/3.features/poll.md index c96f89a1..32777ede 100644 --- a/content/cn/docs/2.for-users/3.features/poll.md +++ b/content/cn/docs/2.for-users/3.features/poll.md @@ -13,7 +13,9 @@ 追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。 :::warning + いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。 + ::: ## 複数回答を可能にする @@ -41,7 +43,9 @@ 未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。 :::tip + 未投票アンケートには、結果を表示した状態でも投票できます。 + ::: 投票をすると、自分の投票した選択肢に✔がつきます。 diff --git a/content/cn/docs/2.for-users/3.features/share-form.md b/content/cn/docs/2.for-users/3.features/share-form.md index 0bd8a69a..e65fd555 100644 --- a/content/cn/docs/2.for-users/3.features/share-form.md +++ b/content/cn/docs/2.for-users/3.features/share-form.md @@ -7,7 +7,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく ## クエリパラメータ :::tip + すべてのパラメータは**オプション**であり、必須ではありません。 + ::: | 名前 | 説明 | @@ -46,7 +48,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく | `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) | :::warning + `visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。 + ::: ### 添付ファイル diff --git a/content/cn/docs/2.for-users/3.features/thread-mute.md b/content/cn/docs/2.for-users/3.features/thread-mute.md index ab4bd823..2f4378ba 100644 --- a/content/cn/docs/2.for-users/3.features/thread-mute.md +++ b/content/cn/docs/2.for-users/3.features/thread-mute.md @@ -1,7 +1,9 @@ # スレッドミュート :::tip + バージョン 12.95.0 以降の機能です。 + ::: スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。 @@ -11,5 +13,7 @@ Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。 :::warning + スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。 + ::: diff --git a/content/cn/docs/2.for-users/3.features/webhook.md b/content/cn/docs/2.for-users/3.features/webhook.md index e6d291e6..f8f31f03 100644 --- a/content/cn/docs/2.for-users/3.features/webhook.md +++ b/content/cn/docs/2.for-users/3.features/webhook.md @@ -1,11 +1,15 @@ # Webhook :::tip + バージョン 12.109.0 以降の機能です。 + ::: :::warning + 実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。 + ::: MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。 diff --git a/content/cn/docs/2.for-users/4.resources/1.troubleshooting.md b/content/cn/docs/2.for-users/4.resources/1.troubleshooting.md index 03b877a9..2aef90d3 100644 --- a/content/cn/docs/2.for-users/4.resources/1.troubleshooting.md +++ b/content/cn/docs/2.for-users/4.resources/1.troubleshooting.md @@ -5,7 +5,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ # トラブルシューティング :::tip + [よくある質問](./faq.md)も合わせてお役立てください。 + ::: 問題が発生したときは、まずこちらをご確認ください。 @@ -59,7 +61,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ クライアントの設定の「キャッシュをクリア」すると直ります。 :::warning + 「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。 + ::: ## 通知やアンテナ等の点滅が消えない diff --git a/content/cn/docs/2.for-users/4.resources/donate.md b/content/cn/docs/2.for-users/4.resources/donate.md index a00e50ff..bbd32212 100644 --- a/content/cn/docs/2.for-users/4.resources/donate.md +++ b/content/cn/docs/2.for-users/4.resources/donate.md @@ -13,20 +13,27 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip + 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 + ::: :::tip + 額に応じて以下の返礼を用意しています。 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 - 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載 - 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載 - ::: + +::: :::warning + **バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。** + (メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります) + ::: また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。 diff --git a/content/cn/docs/2.for-users/4.resources/misskey-hub.md b/content/cn/docs/2.for-users/4.resources/misskey-hub.md index bbdce97a..87114f3d 100644 --- a/content/cn/docs/2.for-users/4.resources/misskey-hub.md +++ b/content/cn/docs/2.for-users/4.resources/misskey-hub.md @@ -6,7 +6,9 @@ Misskey Hubは、Misskeyに関するナレッジなどのドキュメント、 Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub) :::tip + Misskey HubはNuxtを使ってビルドされた静的サイトです。 + ::: ## Misskey Hubに貢献する diff --git a/content/cn/docs/3.for-admin/features/announcement.md b/content/cn/docs/3.for-admin/features/announcement.md index 54475e35..caaa6436 100644 --- a/content/cn/docs/3.for-admin/features/announcement.md +++ b/content/cn/docs/3.for-admin/features/announcement.md @@ -5,12 +5,14 @@ お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。 :::warning + アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。 - 「既存ユーザーのみ」オプションを有効にしてお知らせを作成する - 「非通知」オプションを有効にしてお知らせを作成する - 終了したお知らせはアーカイブする - ::: + +::: ## 表示形式 diff --git a/content/cn/docs/3.for-admin/features/role.md b/content/cn/docs/3.for-admin/features/role.md index d8209cf8..a5aeb766 100644 --- a/content/cn/docs/3.for-admin/features/role.md +++ b/content/cn/docs/3.for-admin/features/role.md @@ -21,11 +21,13 @@ - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) :::warning + コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 - 手動でのアサイン/アサイン解除は行えません。 - 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。 - ::: + +::: ## 権限 @@ -53,6 +55,7 @@ **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** :::tip + 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 @@ -62,7 +65,8 @@ - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ::: + +::: ### ベースロールの値を使用 @@ -85,11 +89,15 @@ アサインする際にアサインされる期間を設定することが可能です。 :::tip + ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。 + ::: :::warning + コンディショナル ロールには手動でのアサインはできません。 + ::: ## ユーザーのポリシーの確認 diff --git a/content/cn/docs/3.for-admin/install/guides/1.index.md b/content/cn/docs/3.for-admin/install/guides/1.index.md index 73c48d68..012ad01f 100644 --- a/content/cn/docs/3.for-admin/install/guides/1.index.md +++ b/content/cn/docs/3.for-admin/install/guides/1.index.md @@ -7,15 +7,19 @@ description: Misskeyサーバーの作成方法についての案内です。 Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::warning + 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。 詳しくは [misskey-dev/misskey #9791](https://github.com/misskey-dev/misskey/issues/9791) をご覧ください。 + ::: ## Xserver VPSでインストール diff --git a/content/cn/docs/3.for-admin/install/guides/bash.md b/content/cn/docs/3.for-admin/install/guides/bash.md index 8daef610..ad742294 100644 --- a/content/cn/docs/3.for-admin/install/guides/bash.md +++ b/content/cn/docs/3.for-admin/install/guides/bash.md @@ -20,7 +20,9 @@ Misskeyを簡単にインストールするためのシェルスクリプトが 3. Cloudflareアカウント（推奨） :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。 diff --git a/content/cn/docs/3.for-admin/install/guides/docker.md b/content/cn/docs/3.for-admin/install/guides/docker.md index d5d381e0..08c0a65f 100644 --- a/content/cn/docs/3.for-admin/install/guides/docker.md +++ b/content/cn/docs/3.for-admin/install/guides/docker.md @@ -7,13 +7,16 @@ description: このガイドはDockerを使ったMisskeyセットアップ方法 このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::tip{label='前提条件'} - DockerおよびDocker Composeがインストールされていること。 - ::: + +::: ## リポジトリの取得 @@ -59,7 +62,9 @@ GLHF✨ ## Misskeyのアップデート方法 :::warning + アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 + ::: ```sh diff --git a/content/cn/docs/3.for-admin/install/guides/kubernetes.md b/content/cn/docs/3.for-admin/install/guides/kubernetes.md index 8d0905fd..1799922c 100644 --- a/content/cn/docs/3.for-admin/install/guides/kubernetes.md +++ b/content/cn/docs/3.for-admin/install/guides/kubernetes.md @@ -3,7 +3,9 @@ このガイドでは、Kubernetes と HelmChartを使用したMisskeyセットアップ方法について説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: ## TrueCharts と TrueNAS Scale diff --git a/content/cn/docs/3.for-admin/install/guides/manual.md b/content/cn/docs/3.for-admin/install/guides/manual.md index 0efb7b3b..d17aa4f6 100644 --- a/content/cn/docs/3.for-admin/install/guides/manual.md +++ b/content/cn/docs/3.for-admin/install/guides/manual.md @@ -7,7 +7,9 @@ description: このガイドではMisskeyのインストール・セットアッ このガイドではMisskeyのインストール・セットアップ方法について解説します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ + ::: :::tip{label='前提条件'} @@ -108,7 +110,9 @@ WantedBy=multi-user.target ``` :::warning + CentOSで1024以下のポートを使用してMisskeyを使用する場合は`ExecStart=/usr/bin/sudo /usr/bin/npm start`に変更する必要があります。 + ::: systemdを再読み込みしmisskeyサービスを有効化 @@ -125,7 +129,9 @@ sudo systemctl start misskey ``` :::tip + `systemctl status misskey`と入力すると、サービスの状態を調べることができます。 + ::: :::: @@ -133,7 +139,9 @@ sudo systemctl start misskey ## Misskeyのアップデート方法 :::warning + アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 + ::: masterをpullし直し、インストール、ビルド、データベースのマイグレーションを行います: @@ -156,8 +164,10 @@ sudo systemctl restart misskey ``` :::tip + ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: - `pnpm run clean`または`pnpm run clean-all` - `pnpm rebuild` - ::: + +::: diff --git a/content/cn/docs/3.for-admin/install/guides/ubuntu-manual.md b/content/cn/docs/3.for-admin/install/guides/ubuntu-manual.md index 99b7b42a..2ece2d51 100644 --- a/content/cn/docs/3.for-admin/install/guides/ubuntu-manual.md +++ b/content/cn/docs/3.for-admin/install/guides/ubuntu-manual.md @@ -11,11 +11,15 @@ [**シェルスクリプトの詳細と使用方法はこちらから！**](./bash/) :::tip + シェルスクリプトでの開発環境へのインストールは想定されていません。 + ::: :::tip + ドメインの購入とCloudflareのセットアップ、サーバーの確保についてはご自身でご準備ください。 + ::: 不具合があれば[ @aqz@p1.a9z.dev へのメンション](https://p1.a9z.dev/@aqz)にてお知らせいただければと思います。 @@ -27,7 +31,9 @@ [docker-compose](./docker/)なら、手作業でももうちょっと簡単に実行できるはずです。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: ## はじめに @@ -52,7 +58,9 @@ OSの違い、Misskey本体や依存するソフトウェアのバージョン - ここではドメインをexample.tldとして解説を進めるので、自分が買ったドメインに適宜置き換えて読むこと。開発環境の場合はlocalhostと読み替えます（設定ファイルの項で別途説明） :::danger + 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ + ::: ## nanoの使い方 @@ -78,7 +86,9 @@ sudo adduser --disabled-password --disabled-login misskey ``` :::tip + 開発環境の場合はユーザーを分ける必要はありません + ::: ## 基本的なソフトウェアのインストールと設定 @@ -177,7 +187,9 @@ activeならOK。 nginxは、主としてリバースプロキシに用いられるWebサーバーソフトである。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。 :::tip + 開発環境の場合はnginxのセットアップは不要です + ::: nginx.orgのドキュメント http\://nginx.org/en/linux_packages.html#Ubuntu に従ってインストールする。 @@ -238,7 +250,9 @@ sudo apt install -y git build-essential サーバーをインターネットに公開する準備をする。 :::tip + 開発環境の場合はファイヤーウォールやCloudFlare、Certbotの設定は不要です + ::: ### ファイヤーウォール @@ -272,7 +286,9 @@ sudo systemctl enable ufw ``` :::tip + ufwは、netfilter(iptables)を人間が操作しやすいようにするアプリだ。インストールスクリプトは、OCI環境ではnetfilterを直接操作する。 + ::: ### CloudFlare @@ -376,7 +392,9 @@ nano .config/default.yml 設定できる値と記述方法は[.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)に書かれている。 :::tip + 開発環境の場合、urlは`url: http://localhost:3000`と指定します。 + ::: ```yml @@ -469,7 +487,9 @@ NODE_ENV=production pnpm run build ``` :::tip + 開発環境の場合、`NODE_ENV=production`は不要です。以降のコマンドでも同様に削除してください。 + ::: ### サーバーでビルドできない場合 @@ -515,7 +535,9 @@ CloudFlareのDNS設定が正しいIPアドレスになっているかもう一 ## Misskeyのデーモンを作成 :::tip + 開発環境の場合、デーモンの作成は不要です。 + ::: いったんCtrl+Cでプロセスをキルし、Misskeyをデーモンで起動する設定をしよう。 diff --git a/content/cn/docs/3.for-admin/install/resources/cdn.md b/content/cn/docs/3.for-admin/install/resources/cdn.md index 747e4490..030216b8 100644 --- a/content/cn/docs/3.for-admin/install/resources/cdn.md +++ b/content/cn/docs/3.for-admin/install/resources/cdn.md @@ -17,5 +17,7 @@ CDNで以下の設定を行なってください。 - `/api/*`以外のリクエストをすべてキャッシュする :::tip + Misskeyをアップデートした際にキャッシュのクリアは不要です。 + ::: diff --git a/content/cn/docs/3.for-admin/install/resources/troubleshooting.md b/content/cn/docs/3.for-admin/install/resources/troubleshooting.md index d9aff878..202e3705 100644 --- a/content/cn/docs/3.for-admin/install/resources/troubleshooting.md +++ b/content/cn/docs/3.for-admin/install/resources/troubleshooting.md @@ -248,6 +248,10 @@ Amazon S3に互換性のあるオブジェクトストレージであれば利 各サービス/ソフトウェアのドキュメントをよく読み、設定してみてください。 +### ローディングが終わらない + +Cloudflare を使用している場合は、Rocket LoaderやAuto Minifyが有効になっていないか確認してください。有効になっている場合は無効にすることで解決する場合があります。 + *** # まったく解決しなかった場合 diff --git a/content/cn/docs/3.for-admin/moderation-tips/disable-timelines.md b/content/cn/docs/3.for-admin/moderation-tips/disable-timelines.md index 7c11efa2..1a320724 100644 --- a/content/cn/docs/3.for-admin/moderation-tips/disable-timelines.md +++ b/content/cn/docs/3.for-admin/moderation-tips/disable-timelines.md @@ -8,7 +8,9 @@ LTLやSTLは、そのサーバー全員の投稿が見れるため、新規の もしデメリットの方が上回っていると感じたら、それらのタイムラインを無効化することも検討してください。 :::warning + 無効化を行うと、ユーザーが困惑し、短期的に見て利用者が減る可能性があります。そのため、無効化の際は影響を慎重に検討し、事前に説明してフォローを整える期間を一定程度設けることを推奨します。 + ::: なお、管理者/モデレーターは、これらのタイムラインの無効化状態は適用されず、引き続き利用することが可能です。 diff --git a/content/cn/docs/4.for-developers/aiscript.md b/content/cn/docs/4.for-developers/aiscript.md new file mode 100644 index 00000000..2c7c5860 --- /dev/null +++ b/content/cn/docs/4.for-developers/aiscript.md @@ -0,0 +1,67 @@ +# AiScript + +AiScriptは、Misskeyの以下の箇所で使用できるスクリプト言語です。 + +- [プラグイン](./plugin/) +- [ウィジェット](/docs/for-users/features/widgets/) + - ボタン + - AiScriptコンソール + - AiScript App +- Misskey Play +- スクラッチパッド + +:::tip + +AiScriptの実装はMisskeyとは別リポジトリで、[オープンソースで公開されています](https://github.com/aiscript-dev/aiscript)。 + +::: + +## 使い方 + +AiScript標準の構文や組み込み関数などが使用できます。 + +:::tip + +ドキュメントは[こちら](https://github.com/aiscript-dev/aiscript/tree/master/docs)\ +Misskey本体のバージョンにより、使用できるAiScriptのバージョンが異なる場合があります。バージョンの確認には`<: Core:v`をScratchpadなどで実行してください。 + +::: + +これらに加え、Misskey専用の組み込み定数・関数が３グループに分けて提供されています。 + +### Misskey AiScript API + +接頭辞: `Mk:`\ +Misskey内の全てのAiScript環境で使用できる定関数群です。 +詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Mk:`とついた部分を参照して下さい。 + +### プラグインAPI + +接頭辞: `Plugin:`\ +[プラグイン](./plugin/)でのみ使用できる定関数群です。 +詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Plugin:`とついた部分を参照して下さい。 + +### UI API + +接頭辞: `Ui:`\ +[ウィジェット](/docs/for-users/features/widgets/)（AiScript App）、Misskey Play、Scratchpadで使用できます。 +ドキュメントは未整備（TODO）ですが、インターネット上に有志の方が執筆された解説記事があります。 + +### 標準入出力 + +AiScript標準で定義されている`readline`関数と`print`関数（および`<:`構文）の内部実装は、Misskey側で独自に提供されています。 + +#### readline(message) + +`message`: `str`\ +返り値: `str`\ +Misskey内の全てのAiScript環境で使用できます。\ +文字列の入力を求めるポップアップを表示します。 + +#### print(message) + +`message`: `any`\ +返り値: `null`\ +[ウィジェット](/docs/for-users/features/widgets/)（AiScriptコンソール）、Scratchpadで使用できます。\ +コンソールに文字列を出力します。\ +`<:`構文も同様の働きをします。 diff --git a/content/cn/docs/4.for-developers/api/1.index.md b/content/cn/docs/4.for-developers/api/1.index.md index 11ef960c..2d2c988f 100644 --- a/content/cn/docs/4.for-developers/api/1.index.md +++ b/content/cn/docs/4.for-developers/api/1.index.md @@ -8,7 +8,9 @@ MisskeyはAPIを公開しています。APIを使ってMisskeyクライアント ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。 :::tip -Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\ + +Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\\ + ::: diff --git a/content/cn/docs/4.for-developers/api/libraries.md b/content/cn/docs/4.for-developers/api/libraries.md index 18db0f35..ee634623 100644 --- a/content/cn/docs/4.for-developers/api/libraries.md +++ b/content/cn/docs/4.for-developers/api/libraries.md @@ -15,6 +15,8 @@ description: Misskey APIに関連するライブラリの一覧 ## Python - [Misskey.py](https://github.com/YuzuRyo61/Misskey.py) +- [MiPA](https://github.com/yupix/MiPA) +- [MiPAC](https://github.com/yupix/MiPAC) ## .Net diff --git a/content/cn/docs/4.for-developers/api/permission.md b/content/cn/docs/4.for-developers/api/permission.md index 7844a7fe..50dd4be7 100644 --- a/content/cn/docs/4.for-developers/api/permission.md +++ b/content/cn/docs/4.for-developers/api/permission.md @@ -5,7 +5,9 @@ description: アプリケーションが要求する権限の一覧 # 権限の一覧 :::tip + このページは[misskey-js](https://github.com/misskey-dev/misskey/tree/develop/packages/misskey-js)から自動生成しているため、ドキュメントや翻訳が不完全な場合があります。 + ::: diff --git a/content/cn/docs/4.for-developers/api/streaming/1.index.md b/content/cn/docs/4.for-developers/api/streaming/1.index.md index af767dfc..6ce5b5bc 100644 --- a/content/cn/docs/4.for-developers/api/streaming/1.index.md +++ b/content/cn/docs/4.for-developers/api/streaming/1.index.md @@ -5,7 +5,9 @@ description: ストリーミングAPIを使うと、リアルタイムで様々 # ストリーミングAPI :::tip + 最初に[Misskey API](../index.md)のドキュメントを読むことをお勧めします。 + ::: ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、リアクションされた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。 @@ -26,7 +28,9 @@ wss://{host}/streaming?i={token} - `{token}`の部分は、ユーザーのアクセストークンに置き換えます。 :::tip + アクセストークンは省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。 + ::: ストリームに接続すると、後述投稿の購読を行ったりすることができますが、まだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。 @@ -40,7 +44,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。 :::tip + ひとつのストリーム接続上で、同時に複数のチャンネルに接続することができます。 + ::: 以下では、チャンネルの使用方法を説明します。どのようなチャンネルがあるかは、[チャンネル一覧](./channel/index.md)を参照してください。 @@ -69,7 +75,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり - `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。 :::tip + IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。 + ::: ### チャンネルからのメッセージを受け取る diff --git a/content/cn/docs/4.for-developers/api/token.md b/content/cn/docs/4.for-developers/api/token.md index 8f9d3919..d0e74076 100644 --- a/content/cn/docs/4.for-developers/api/token.md +++ b/content/cn/docs/4.for-developers/api/token.md @@ -7,7 +7,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた** アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 :::tip + ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 + ::: あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 @@ -20,7 +22,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた** Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 :::danger + アクセストークンは他人に知られないようにしてください。 + ::: ### アプリケーション利用者にアクセストークンの発行をリクエストする @@ -32,6 +36,7 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app) + ::: #### Step 1 @@ -39,7 +44,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger + このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: #### Step 2 @@ -119,7 +126,9 @@ https://{host}/api/miauth/{session}/check APIの詳細は、APIリファレンスを参照してください。 :::warning + MisskeyはRESTを採用していません。 + ::: また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 diff --git a/content/cn/docs/4.for-developers/api/token/1.index.md b/content/cn/docs/4.for-developers/api/token/1.index.md new file mode 100644 index 00000000..3305efc0 --- /dev/null +++ b/content/cn/docs/4.for-developers/api/token/1.index.md @@ -0,0 +1,88 @@ +# アクセストークンの取得 + +APIを使い始めるには、APIを利用するアカウントに紐づいた**アクセストークン**を取得する必要があります。 +このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。 + +基本的に、APIはリクエストにはアクセストークンが必要となります。 +アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 + +:::tip + +ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 + +::: + +あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 + +- 前者の場合: **「自分自身のアクセストークンを手動発行する」** に進む +- 後者の場合: **「アプリケーション利用者にアクセストークンの発行をリクエストする」** に進む + +## 自分自身のアクセストークンを手動発行する + +Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 + +:::danger + +アクセストークンは他人に知られないようにしてください。 + +::: + +## アプリケーション利用者にアクセストークンの発行をリクエストする + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の方法の一つを使います。 + +:MkIndex + +## APIの利用 + +アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。 + +:::tip + +- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。 +- 要求ヘッダーに`Content-Type: application/json`を指定します。 +- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。 +- ベースURLは`https://{サーバーのドメイン}/api`です。 + +::: + +### Authorization headerを使う方式 + +以下のようにヘッダーの`Authorization`フィールドを指定します。 + +```js +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + text: "Hello Misskey API World with My Application!" + }), + headers: { + Authorization: `Bearer ${accessToken}`, + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` + +### iを使う方式 + +アクセストークン付きのボディの例（metaの場合）: + +```json +{ + "i": "HogEFugA1341", + "detail": false +} +``` + + + +APIの詳細は、APIリファレンスを参照してください。 + +:::warning + +MisskeyはRESTを採用していません。 + +::: + +また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](../streaming/)を参照してください。 diff --git a/content/cn/docs/4.for-developers/api/token/2.miauth.md b/content/cn/docs/4.for-developers/api/token/2.miauth.md new file mode 100644 index 00000000..1100db0d --- /dev/null +++ b/content/cn/docs/4.for-developers/api/token/2.miauth.md @@ -0,0 +1,76 @@ +--- +description: v12.27.0以降で使用できる、Misskey独自の簡素な認証方法について説明しています。 +--- + +# MiAuth方式でのアクセストークン取得方式 + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 + +:::tip + +以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 + +- [よりおおく使われているOAuth方式でのアクセストークン取得方法もあります。](./oauth.md) +- [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app.md) + +::: + +## Step 1 + +UUIDを生成する。以後これを**セッションID**と呼びます。 + +:::danger + +このセッションIDは毎回生成し、使いまわさないようにしてください。 + +::: + +## Step 2 + +アプリケーション認証フォームをユーザーのブラウザで表示させる。認証フォームは、以下の形式のURLで開くことができます: + +``` +https://{host}/miauth/{session} +``` + +ここで、 + +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 +- `{session}`の部分は、セッションIDに置き換えます。 + +また、URLにクエリパラメータとしていくつかのオプションを設定できます: + +| 名前 | 説明 | +| ------------ | ------------------------------------------------------------------------------ | +| `name` | アプリケーション名。 | +| `icon` | アプリケーションのアイコン画像URL。 | +| `callback` | 認証が終わった後にリダイレクトするURL。
リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 | +| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 | + +:::tip{label='例'} + +``` +https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive +``` + +::: + +## Step 3 + +ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 + +``` +https://{host}/api/miauth/{session}/check +``` + +ここで、 + +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。 +- `{session}`の部分は、セッションIDに置き換えます。 + +レスポンスに含まれるプロパティは以下の通りです: + +| 名前 | 説明 | +| ------- | -------------- | +| `token` | ユーザーのアクセストークン。 | +| `user` | ユーザーの情報。 | diff --git a/content/cn/docs/4.for-developers/api/token/3.oauth.md b/content/cn/docs/4.for-developers/api/token/3.oauth.md new file mode 100644 index 00000000..a29644ab --- /dev/null +++ b/content/cn/docs/4.for-developers/api/token/3.oauth.md @@ -0,0 +1,179 @@ +--- +description: v2023.9.0以降で使用できる、OAuth2.0方式での認証方法について説明しています。 +--- + +# OAuth方式でのアクセストークン取得方式 + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 + +:::tip + +以下に説明する方法は、[OAuth 2.0](https://datatracker.ietf.org/doc/html/rfc6749.html)と呼ばれるものです。普通のOAuthはアプリを作成しますが、[IndieAuth](https://indieauth.spec.indieweb.org/)の拡張でアプリ作成なしで使えるようになっています。 + +OAuth方式は使えるライブラリが多いので、出来ればライブラリを使うのをおすすめします。 + +現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。 + +- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md) +- [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md) + +::: + +## Step 1 + +アプリ紹介のためのウェブページを作ります。ページがHTTPSアドレスでアクセスできるようにしてください。ページのとこかに以下のようなHTMLコードを書きます。 + +```html + + + + +
+ My Misskey App +
+``` + +あとで`redirect_uri`のアドレスに認証コードが転送されます。 + +## Step 2 + +PKCE `code_verifier`と`code_challenge`文字列, 及び`state`文字列を生成します。 + +- `code_verifier`の場合は最低43字、最高128字でアルファベット大・小文字及び`-._~`の中の文字に限られます。 +- `code_challenge`文字列は`code_verifier`文字列をSHA256アルゴリズムでハッシュしてbase64urlでエンコードした結果を使います。 +- `state`文字列には特別な制限はありません。ランダムな文字列を使います。 + +:::danger + +この文字列は毎回生成し、使いまわさないようにしてください。 + +::: + +:::tip + +[pkce-challenge](https://www.npmjs.com/package/pkce-challenge)とかのライブラリを使ったり、OAuthライブラリのPKCE機能を使うのがおすすめです。 + +::: + +:::tip{label='例'} + +```js +import crypto from "node:crypto"; + +const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-._~"; +const codeVerifier = new Array(128) + .fill(0) + .map(() => chars[Math.floor(chars.length * Math.random())]) + .join(""); +console.log('code_verifier', codeVerifier); + +const codeChallenge = crypto + .createHash("sha256") + .update(codeVerifier, "ascii") + .digest("base64url"); +console.log('code_challenge', codeChallenge); + +const state = crypto.randomUUID(); +console.log('state', state); +``` + +::: + +## Step 3 + +相手サーバーのOAuth情報を取得します。データはJSON形式になっています。 + +``` +https://{host}/.well-known/oauth-authorization-server +``` + +`{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 + +ここでは`authorization_endpoint`と`token_endpoint`を使います。 + +:::tip + +次のステップで使われる`scope`の情報も`scopes_supported`で確認できます。 + +::: + +## Step 4 + +アプリケーション認証フォームをユーザーのブラウザで表示させます。認証フォームは、以下の形式のURLで開くことができます: + +``` +{authorization_endpoint}?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&scope={scope}&code_challenge={code_challenge}&code_challenge_method=S256&state={state} +``` + +ここで、 + +- `{authorization_endpoint}`の部分は、前の情報取得で得たアドレスに置き換えます。 +- `{client_id}`の部分は、アプリの紹介ページのアドレスに置き換えます。 +- `{code_challenge}`の部分は、前に生成した`code_challenge`文字列に置き換えます +- `code_challenge_method`の部分は常に`S256`にします。 +- `{redirect_uri}`の部分は、紹介ページで使っている配達先のアドレスに置き換えます。 +- `{scope}`の部分は、アプリケーションが要求する権限に置き換えます。要求する権限を` `で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 +- `{state}`の部分は、前に生成した`state`文字列に置き換えます。 + +:::tip{label='例'} + +``` +https://misskey.local/oauth/authorize?client_id=http%3A%2F%2Fexample.com&code_challenge=C6hwMO2bmIzg3nqppTE9b79fvuOjlrKmH2xNiZSMHzw&code_challenge_method=S256&response_type=code&redirect_uri=http%3A%2F%2Fexample.com%2Fredirect&scope=write%3Anotes&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +## Step 5 + +ユーザーがアプリケーションアクセスを許可したら、`redirect_uri`のアドレスに認証コードがURLパラメータの形式で転送されます。 + +| 名前 | 説明 | +| ------- | ----------------------- | +| `code` | ユーザーの認証コード。 | +| `state` | 認証リクエストに使われた`state`文字列。 | + +:::tip{label='例'} + +``` +https://example.com/redirect?code=...&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +`state`文字列がちゃんと一致しているのか確認して、次のステップに進みます。 + +## Step 6 + +転送された認証コードを使ってアクセストークンをPOSTでリクエストします。リクエスト先は`token_endpoint`になります。データ形式は`application/json`と`application/x-www-form-urlencoded`を使えます。各パラメータは以下のようになります。 + +| 名前 | 説明 | +| --------------- | ------------------------------ | +| `grant_type` | 常に`authorization_code`にします。 | +| `client_id` | 認証リクエストに使われた`client_id`文字列。 | +| `redirect_uri` | 認証リクエストに使われた`redirect_uri`文字列。 | +| `scope` | 認証リクエストに使われた`scope`文字列。 | +| `code` | 取得した認証コード。　 | +| `code_verifier` | 前に生成した`code_verifier`文字列。 | + +:::tip{label='例'} + +```js +const res = await fetch(endpoint, { + method: "POST", + body: JSON.stringify({ + grant_type: "authorization_code", + client_id: "https://example.com", + redirect_uri: "https://example.com/redirect", + scope: "write:notes", + code: "...", + code_verifier: "hjjbCYDmDpSLjirkO-PrfWKsRhDdJr-PAEGRClRwzUKlmFIIIrZNmSvUIraeIa~WqbqQnfbJV-Hc_IfuQkesBYUpukUi~lInDfU_AZjoZqbU.ioQTRzaFfZFfGnT-OAA", + }), + headers: { + "Content-Type": "application/json" + } +}); +``` + +::: + +レスポンスはJSONオブジェクト形式で、そこから`access_token`を取得して使います。 diff --git a/content/cn/docs/4.for-developers/plugin/create-plugin.md b/content/cn/docs/4.for-developers/plugin/create-plugin.md index 5e5130ca..cd9bf91e 100644 --- a/content/cn/docs/4.for-developers/plugin/create-plugin.md +++ b/content/cn/docs/4.for-developers/plugin/create-plugin.md @@ -74,4 +74,4 @@ Misskey Webはプラグインに対してAPIを公開していて、それらを v2023.11.0以降では、あなたのウェブサイトからワンクリックでプラグインを直接インストールできるようになっています。 -プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](./publish-on-your-website.md)をご覧ください。 +プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](../publish-on-your-website.md)をご覧ください。 diff --git a/content/cn/docs/5.releases.md b/content/cn/docs/5.releases.md index b7879489..ed86bc68 100644 --- a/content/cn/docs/5.releases.md +++ b/content/cn/docs/5.releases.md @@ -6,6 +6,49 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2023.12.2 + +リリース日: 2023/12/28 + +### General + +- v2023.12.1でDockerを利用してサーバーを起動できない問題を修正 + +### Client + +- Enhance: 検索画面においてEnterキー押下で検索できるように + +## 2023.12.1 + +リリース日: 2023/12/27 + +### Note + +- アクセストークンの権限が再整理されたため、一部のAPIが古いAPIトークンでは動作しなくなりました。\ + 権限不足になる場合には権限を再設定して再生成してください。 + +### General + +- Enhance: ローカリゼーションの更新 +- Fix: 自分のdirect noteがuser list timelineに追加されない + +### Client + +- Feat: AiScript専用のMFM構文`$[clickable.ev=EVENTNAME ...]`を追加。`Mk:C:mfm`のオプション`onClickEv`に関数を渡すと、クリック時に`EVENTNAME`を引数にして呼び出す +- Enhance: MFM入力補助ボタンを投稿フォームに表示できるように #12787 +- Fix: 一部のモデログ(logYellowでの表示対象)について、表示の色が変わらない問題を修正 +- Fix: `fg`/`bg`MFMに長い単語を指定すると、オーバーフローされずはみ出る問題を修正 + +### Server + +- Enhance: センシティブワードの設定がハッシュタグトレンドにも適用されるようになりました +- Enhance: `oauth/token`エンドポイントのCORS対応 +- Fix: 1702718871541-ffVisibility.jsのdownが壊れている +- Fix:「非センシティブのみ（リモートはいいねのみ）」を設定していても、センシティブに設定されたカスタム絵文字をリアクションできる問題を修正 +- Fix: ロールアサイン時の通知で，ロールアイコンが縮小されずに表示される問題を修正 +- Fix: サードパーティアプリケーションがWebsocket APIに無条件にアクセスできる問題を修正 +- Fix: サードパーティアプリケーションがユーザーの許可なしに非公開の情報を見ることができる問題を修正 + ## 2023.12.0 リリース日: 2023/12/23 @@ -1957,7 +2000,9 @@ same as 12.112.0 ### NOTE :::warning + このバージョンからNode v16.14.0以降が必要です + ::: ### Changes @@ -2069,12 +2114,16 @@ same as 12.112.0 ### Note :::warning + ビルドする前に`npm run clean`を実行してください。 + ::: :::warning + このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 + ::: ### Improvements @@ -2142,9 +2191,11 @@ same as 12.112.0 ### NOTE ::: warning + アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。 12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。 + ::: ### Changes diff --git a/content/en/docs/1.about-misskey.md b/content/en/docs/1.about-misskey.md index 0c247495..619f2604 100644 --- a/content/en/docs/1.about-misskey.md +++ b/content/en/docs/1.about-misskey.md @@ -15,7 +15,9 @@ While Misskey started centered around Bulletin Boards as its main feature, the g Misskey was not always a decentralized service, but became decentralized through the adoption of ActivityPub in 2018. Since then, it has become a service that is acknowledged and used by many. :::tip -ℹ️ The name "Misskey" comes from a song called "Brain Diver" by a band that syuilo used to listen to at the time called May'n. + +The name "Misskey" comes from a song called "Brain Diver" by a band that syuilo used to listen to at the time called May'n. + ::: With anyone being able to join its development, Misskey is still continually being actively developed. @@ -35,7 +37,9 @@ For realizing the distributed nature of Misskey, this concept of open source is Using the same example as before, most profit-oriented services like Twitter, Facebook etc. are not open source. :::tip + Technically speaking, Misskey's source code is managed via Git, and the repository is hosted on [GitHub](https://github.com/misskey-dev) + ::: ## Joining development and supporting the project @@ -143,8 +147,11 @@ As the Misskey Web client supports PWA, it is also possible to make it act as if :::fukidashi{chara="doya_ai" charaName="藍"} For more information about me, please visit [this website](https://xn--931a.moe/)! + ::: :::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"} + It's Misskey's guardian deity, Ai.(They called Ai cute, yay!) + ::: diff --git a/content/en/docs/2.for-users/2.onboarding/2.get-started.md b/content/en/docs/2.for-users/2.onboarding/2.get-started.md index 08f67f5a..6b2f5857 100644 --- a/content/en/docs/2.for-users/2.onboarding/2.get-started.md +++ b/content/en/docs/2.for-users/2.onboarding/2.get-started.md @@ -13,13 +13,13 @@ You can choose any server from the [server list](/servers/). :::tip どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 -:::g-details{summary='Details'} +::::g-details{summary='Details'} + Misskey has federated functionality. This federated functionality allows users on different servers to follow, react, and renote in the same way as users on the same server, even if they are on different servers. -The federated functionality that Misskey incorporates is based on an open common standard called ActivityPub and is compatible with other software such as Mastodon and Pleroma. -::: +:::: ::: @@ -31,5 +31,7 @@ Some servers may have a specific theme, for example, "I like certain a thing or We recommend that you look for a server with a theme that suits you. :::tip + A list of servers can be found [here](/servers/). + ::: diff --git a/content/en/docs/2.for-users/2.onboarding/3.join-server.md b/content/en/docs/2.for-users/2.onboarding/3.join-server.md index 95a2604c..294b18e6 100644 --- a/content/en/docs/2.for-users/2.onboarding/3.join-server.md +++ b/content/en/docs/2.for-users/2.onboarding/3.join-server.md @@ -3,9 +3,11 @@ Once you have decided which server to register with, it's time to create an account. :::tip + ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 However, the information you enter may vary depending on the server.Please contact your server administrator for more information. + ::: ## Register diff --git a/content/en/docs/2.for-users/2.onboarding/4.things-to-know.md b/content/en/docs/2.for-users/2.onboarding/4.things-to-know.md index 33f022d8..4ff00496 100644 --- a/content/en/docs/2.for-users/2.onboarding/4.things-to-know.md +++ b/content/en/docs/2.for-users/2.onboarding/4.things-to-know.md @@ -7,7 +7,9 @@ Here is a summary of what you, the account creator, need to know for now. Posts on Misskey are called "notes.".There are many features compared to Twitter and other popular social networking sites, so be sure to check them out before making your first post. :::tip + For more information, see "[Notes](/docs/for-users/features/note/)". + ::: ## Timelines @@ -15,7 +17,9 @@ For more information, see "[Notes](/docs/for-users/features/note/)". Misskey has multiple timelines.The names alone may be a little confusing, so it is important to know what each of them do. :::tip + For more information, see "[Timeline](/docs/for-users/features/timeline/)". + ::: ## Other diff --git a/content/en/docs/2.for-users/3.features/ads.md b/content/en/docs/2.for-users/3.features/ads.md index 8781c4ee..cbd65ec4 100644 --- a/content/en/docs/2.for-users/3.features/ads.md +++ b/content/en/docs/2.for-users/3.features/ads.md @@ -4,7 +4,9 @@ Misskey has a feature that displays ads etc. on timelines. You can reduce the frequency of relevant ads by clicking the icon to the right of the ads. :::tip + If the total number of ads is low, ads may reappear even though their frequency has been reduced. + ::: ## Setting Up Ads (Administrators Only) diff --git a/content/en/docs/2.for-users/3.features/drive.md b/content/en/docs/2.for-users/3.features/drive.md index 3fc879de..81f0417d 100644 --- a/content/en/docs/2.for-users/3.features/drive.md +++ b/content/en/docs/2.for-users/3.features/drive.md @@ -3,7 +3,9 @@ ドライブは、Misskey上でファイルを管理できる機能です。 :::tip + 技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。 + ::: Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。 @@ -13,7 +15,9 @@ Misskey Webのドライブページから任意のファイルをアップロー ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。 :::warning + 現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。 + ::: ## センシティブ (NSFW) diff --git a/content/en/docs/2.for-users/3.features/mfm.md b/content/en/docs/2.for-users/3.features/mfm.md index 5771232a..65661bb5 100644 --- a/content/en/docs/2.for-users/3.features/mfm.md +++ b/content/en/docs/2.for-users/3.features/mfm.md @@ -7,7 +7,9 @@ description: MFMは、Misskeyの様々な場所で使用できる専用のマー MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。 :::tip + 一部の構文はMarkdownやHTMLと互換性があります。 + ::: ## MFMが使用可能な場所の例 @@ -23,7 +25,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使 アットマーク + ユーザー名で、特定のユーザーを示すことができます。 :::tip + メンションについての詳細は[こちら](./mention.md)を参照してください。 + ::: ``` @@ -42,7 +46,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使 ナンバーサイン + タグで、ハッシュタグを示すことができます。 :::tip + ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。 + ::: ``` @@ -70,6 +76,7 @@ https://example.com ``` :::tip + リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。 ``` @@ -84,7 +91,9 @@ https://example.com コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。 :::tip + カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。 + ::: ``` diff --git a/content/en/docs/2.for-users/3.features/mute-and-block.md b/content/en/docs/2.for-users/3.features/mute-and-block.md index 9ff1ddf9..6fa407ce 100644 --- a/content/en/docs/2.for-users/3.features/mute-and-block.md +++ b/content/en/docs/2.for-users/3.features/mute-and-block.md @@ -5,11 +5,15 @@ ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。 :::tip + ミュートとブロックは併用できます。 + ::: :::warning + 利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。 + ::: Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。 @@ -26,7 +30,9 @@ Misskey Webでは、設定>ミュートとブロック から、自分がミュ Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。 :::tip + ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。 + ::: ## ブロック @@ -48,9 +54,13 @@ Misskey Webでユーザーをミュートするには、対象のユーザーの Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。 :::warning + ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。 + ::: :::warning + 相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。 + ::: diff --git a/content/en/docs/2.for-users/3.features/pages.md b/content/en/docs/2.for-users/3.features/pages.md index 21a59a21..0bb1232f 100644 --- a/content/en/docs/2.for-users/3.features/pages.md +++ b/content/en/docs/2.for-users/3.features/pages.md @@ -3,7 +3,9 @@ Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。 :::warning + v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。 + ::: ## ページ設定 diff --git a/content/en/docs/2.for-users/3.features/poll.md b/content/en/docs/2.for-users/3.features/poll.md index c96f89a1..32777ede 100644 --- a/content/en/docs/2.for-users/3.features/poll.md +++ b/content/en/docs/2.for-users/3.features/poll.md @@ -13,7 +13,9 @@ 追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。 :::warning + いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。 + ::: ## 複数回答を可能にする @@ -41,7 +43,9 @@ 未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。 :::tip + 未投票アンケートには、結果を表示した状態でも投票できます。 + ::: 投票をすると、自分の投票した選択肢に✔がつきます。 diff --git a/content/en/docs/2.for-users/3.features/share-form.md b/content/en/docs/2.for-users/3.features/share-form.md index 0bd8a69a..e65fd555 100644 --- a/content/en/docs/2.for-users/3.features/share-form.md +++ b/content/en/docs/2.for-users/3.features/share-form.md @@ -7,7 +7,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく ## クエリパラメータ :::tip + すべてのパラメータは**オプション**であり、必須ではありません。 + ::: | 名前 | 説明 | @@ -46,7 +48,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく | `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) | :::warning + `visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。 + ::: ### 添付ファイル diff --git a/content/en/docs/2.for-users/3.features/thread-mute.md b/content/en/docs/2.for-users/3.features/thread-mute.md index ab4bd823..2f4378ba 100644 --- a/content/en/docs/2.for-users/3.features/thread-mute.md +++ b/content/en/docs/2.for-users/3.features/thread-mute.md @@ -1,7 +1,9 @@ # スレッドミュート :::tip + バージョン 12.95.0 以降の機能です。 + ::: スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。 @@ -11,5 +13,7 @@ Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。 :::warning + スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。 + ::: diff --git a/content/en/docs/2.for-users/3.features/webhook.md b/content/en/docs/2.for-users/3.features/webhook.md index eab0e71c..19d61ab2 100644 --- a/content/en/docs/2.for-users/3.features/webhook.md +++ b/content/en/docs/2.for-users/3.features/webhook.md @@ -1,11 +1,15 @@ # Webhook :::tip + バージョン 12.109.0 以降の機能です。 + ::: :::warning + 実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。 + ::: MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。 diff --git a/content/en/docs/2.for-users/4.resources/1.troubleshooting.md b/content/en/docs/2.for-users/4.resources/1.troubleshooting.md index 03b877a9..2aef90d3 100644 --- a/content/en/docs/2.for-users/4.resources/1.troubleshooting.md +++ b/content/en/docs/2.for-users/4.resources/1.troubleshooting.md @@ -5,7 +5,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ # トラブルシューティング :::tip + [よくある質問](./faq.md)も合わせてお役立てください。 + ::: 問題が発生したときは、まずこちらをご確認ください。 @@ -59,7 +61,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ クライアントの設定の「キャッシュをクリア」すると直ります。 :::warning + 「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。 + ::: ## 通知やアンテナ等の点滅が消えない diff --git a/content/en/docs/2.for-users/4.resources/donate.md b/content/en/docs/2.for-users/4.resources/donate.md index 0972cb72..bbd32212 100644 --- a/content/en/docs/2.for-users/4.resources/donate.md +++ b/content/en/docs/2.for-users/4.resources/donate.md @@ -13,22 +13,27 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip + 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 + ::: :::tip + 額に応じて以下の返礼を用意しています。 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 - 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載 - 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載 - ::: + +::: :::warning -:::warning + **バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。** + (メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります) -::: + ::: また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。 diff --git a/content/en/docs/2.for-users/4.resources/misskey-hub.md b/content/en/docs/2.for-users/4.resources/misskey-hub.md index bbdce97a..87114f3d 100644 --- a/content/en/docs/2.for-users/4.resources/misskey-hub.md +++ b/content/en/docs/2.for-users/4.resources/misskey-hub.md @@ -6,7 +6,9 @@ Misskey Hubは、Misskeyに関するナレッジなどのドキュメント、 Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub) :::tip + Misskey HubはNuxtを使ってビルドされた静的サイトです。 + ::: ## Misskey Hubに貢献する diff --git a/content/en/docs/3.for-admin/features/announcement.md b/content/en/docs/3.for-admin/features/announcement.md index bde4b909..d32cc0ea 100644 --- a/content/en/docs/3.for-admin/features/announcement.md +++ b/content/en/docs/3.for-admin/features/announcement.md @@ -5,12 +5,14 @@ Announcements are one of the features available in Misskey. Using the announcement feature, you can post server-wide announcements to users, as well as send messages from the server to individual users. :::warning + アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。 - Create an announcement with the "Existing Users Only" option enabled - Create an announcement with the "do not notify" option enabled - Archive closed announcements. - ::: + +::: ## Display format diff --git a/content/en/docs/3.for-admin/features/role.md b/content/en/docs/3.for-admin/features/role.md index 6ed15743..a5aeb766 100644 --- a/content/en/docs/3.for-admin/features/role.md +++ b/content/en/docs/3.for-admin/features/role.md @@ -21,11 +21,13 @@ - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) :::warning + コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 - 手動でのアサイン/アサイン解除は行えません。 - 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。 - ::: + +::: ## 権限 @@ -53,6 +55,7 @@ **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** :::tip + 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 @@ -62,7 +65,8 @@ - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ::: + +::: ### ベースロールの値を使用 @@ -85,13 +89,15 @@ アサインする際にアサインされる期間を設定することが可能です。 :::tip -:::tip + ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。 -::: + ::: :::warning + コンディショナル ロールには手動でのアサインはできません。 + ::: ## ユーザーのポリシーの確認 diff --git a/content/en/docs/3.for-admin/install/guides/1.index.md b/content/en/docs/3.for-admin/install/guides/1.index.md index 5fa9ae2b..6b1e6299 100644 --- a/content/en/docs/3.for-admin/install/guides/1.index.md +++ b/content/en/docs/3.for-admin/install/guides/1.index.md @@ -7,15 +7,19 @@ description: How to create a Misskey server. Thank you for your interest in creating a Misskey server.There are several ways to create a server, so please choose one below and read the corresponding guide. :::danger + Do not recreate the database with the domain/hostname of the server once you have started using it! + ::: :::warning + 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 Do not minify the JavaScript again as it has already been minified, Cloudflare also does not interpret the latest JavaScript correctly and would end up destroying the code inside causing Misskey to not work properly. See [misskey-dev/misskey#9791](https://github.com/misskey-dev/misskey/issues/9791) for more information. + ::: ## Installation on Xserver VPS diff --git a/content/en/docs/3.for-admin/install/guides/bash.md b/content/en/docs/3.for-admin/install/guides/bash.md index 09a6ede6..b7762eba 100644 --- a/content/en/docs/3.for-admin/install/guides/bash.md +++ b/content/en/docs/3.for-admin/install/guides/bash.md @@ -20,7 +20,9 @@ Misskeyを簡単にインストールするためのシェルスクリプトが 3. Cloudflareアカウント（推奨） :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。 @@ -28,7 +30,6 @@ Let's Encryptの認証を試行できる回数が少ないので、サーバー ## Cloudflareの設定 Cloudflareを使う場合、Cloudflareのドメインの設定を完了してからインストールを開始するようにしてください。\ -\ ネームサーバーの適用には最大で3日程度かかる場合があります。 また、nginxとCloudflareを設定する場合、Cloudflareの設定画面にて、 @@ -41,7 +42,6 @@ Cloudflareを使う場合、Cloudflareのドメインの設定を完了してか ### 1. SSH サーバーにSSH接続します。\ -\ （サーバーのデスクトップを開いている方はシェルを開きましょう。） ### 2. 環境を最新にする @@ -113,13 +113,10 @@ iptablesを使うようにしてください。 v1から、インストールメソッドにsystemdとDockerとを選べるようにしました。 Dockerと言っても、**MisskeyだけをDockerで実行**し、RedisやPostgresなどはホストで直接実行します。\ -\ [docker-composeですべての機能を動かす方法については、mamemonongaさんが作成したこちらの記事がおすすめです。](https://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0) Docker Hubイメージを使う設定であれば、Misskeyのビルドが不要になるため、**一番お勧めです**。\ -\ ただし、マイグレーションは必要なので、アップデート時にMisskeyを使えない時間がゼロになるわけではありません。\ -\ また、Misskeyのビルド環境を準備しない(git pullしない)ので、フォークを動かしたくなった時に設定が面倒になります。 ローカルでDockerをビルドする方式は、パフォーマンス面で非推奨です。 @@ -147,14 +144,12 @@ systemdは、Docker Hubにイメージを上げるまでもないものの、フ 万が一途中で失敗してもう一度スクリプトを動作させる場合、次のことに注意してください。 - RedisやPostgresのインストールが終わっている場合、「install locally」はNoにしてください。\ - \ host・port設定はそのままEnterを押します。 ユーザー名やパスワードは、前回実行した際に指定したものを入力します。 ## .envファイルについて インストールスクリプトは、2つの.envファイルを作成します。\ -\ アップデートの際に使用します。 ### /root/.misskey.env @@ -165,14 +160,12 @@ misskeyを実行するユーザーを覚えておくために必要です。 systemdの場合に生成されます。\ \ -主にディレクトリを覚えておくのに使用します。 +実行されているコンテナとイメージの番号を保存しています。 ### /home/(misskeyユーザー)/.misskey-docker.env Dockerの場合に生成されます。\ -\ 実行されているコンテナとイメージの番号を保存しています。\ -\ コンテナの番号はアップデートの際に更新されます。古いイメージは削除されます。 ## 自分で管理する @@ -184,7 +177,6 @@ Dockerの場合に生成されます。\ ### Misskeyディレクトリ Misskeyのソースは`/home/ユーザー/ディレクトリ`としてcloneされます。\ -\ （ユーザー、ディレクトリの初期値はともにmisskeyです。） Misskeyディレクトリへは、以下のように移動するとよいでしょう。 @@ -203,7 +195,6 @@ exit ### systemd systemdのプロセス名はexample.comです。\ -\ たとえば再起動するには次のようにします。 ``` @@ -259,7 +250,6 @@ requirepassとbindを`/etc/redis/misskey.conf`で設定しています。 ## Q. アップデート後に502でアクセスできない Dockerでは、起動後にマイグレーションをするため、すぐにアクセスできません。\ -\ マイグレーションが終わっているかどうか確認してみてください。 systemdの場合では、pnpm installに失敗している可能性があります。 @@ -275,5 +265,4 @@ journalctlでログを確認すると、たいていre2が云々という記述 ## Q. 同じサーバーにもう1つMisskeyを建てたい スクリプトは同じサーバーに追加でMisskeyをインストールすることは想定していません。\ -\ 幾つかの設定が上書きされるか、途中でエラーになってしまうでしょう。 diff --git a/content/en/docs/3.for-admin/install/guides/docker.md b/content/en/docs/3.for-admin/install/guides/docker.md index 69402049..2ead155c 100644 --- a/content/en/docs/3.for-admin/install/guides/docker.md +++ b/content/en/docs/3.for-admin/install/guides/docker.md @@ -1,21 +1,24 @@ --- -description: このガイドはDockerを使ったMisskeyセットアップ方法を説明します。 +description: This guide explains how to set up Misskey using Docker --- -# Docker Composeを使ったMisskey構築 +# Building Misskey using Docker Compose -このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。 +This guide explains how to set up Misskey using Docker :::danger -一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + +Do not recreate the database with the domain/hostname of the server once you have started using it! + ::: :::tip{label='前提条件'} -- DockerおよびDocker Composeがインストールされていること。 - ::: +- Make sure Docker and Docker Compose are installed on your system. -## リポジトリの取得 +::: + +## Clone the Repository ```sh git clone -b master https://github.com/misskey-dev/misskey.git @@ -23,9 +26,9 @@ cd misskey git checkout master ``` -## 設定 +## Configuration -下記コマンドで、各種設定ファイルのサンプルをコピーします。 +The following commands will copy the various config files from examples to their actual config location. ```sh cp .config/docker_example.yml .config/default.yml @@ -33,23 +36,22 @@ cp .config/docker_example.env .config/docker.env cp ./docker-compose_example.yml ./docker-compose.yml ``` -`default.yml`と`docker.env`をファイル内の説明に従って編集してください。\ -\ -また、必要に応じて、`docker-compose.yml`を編集します。(ポートを変更したい場合など) +Please edit `default.yml` and `docker.env` file as per the description.\ +Also edit `docker-compose.yml` as needed.(If you want to change the port etc.) -## ビルドと初期化 +## Build & Initialize -次のコマンドでMisskeyのビルドとデータベースの初期化を行います。 -これにはしばらく時間がかかります。 +The next set of commands will build Misskey image and perform database initialization. +This will take some time. ```shell sudo docker compose build sudo docker compose run --rm web pnpm run init ``` -## 起動 +## Startup -お疲れ様でした。以下のコマンドでMisskeyを起動できます。 +お疲れ様でした。You can launch Misskey with the following command. ```sh sudo docker compose up -d @@ -57,12 +59,12 @@ sudo docker compose up -d GLHF✨ -## Misskeyのアップデート方法 +## Updating Misskey :::warning -:::warning -アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 -::: + +Updates are always available in the [release notes](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md). Please make sure to check in advance for any changes that may be required. + ::: ```sh @@ -75,9 +77,9 @@ sudo docker compose build sudo docker compose stop && sudo docker compose up -d ``` -アップデート内容、およびデータベースの規模によっては時間がかかることがあります。 +It may take time depending on the update content and the size of the database. -## cliコマンドを実行する方法 +## How to execute CLI commands? ```sh sudo docker compose run --rm web node packages/backend/built/tools/foo bar diff --git a/content/en/docs/3.for-admin/install/guides/kubernetes.md b/content/en/docs/3.for-admin/install/guides/kubernetes.md index 8d0905fd..e313669a 100644 --- a/content/en/docs/3.for-admin/install/guides/kubernetes.md +++ b/content/en/docs/3.for-admin/install/guides/kubernetes.md @@ -3,14 +3,16 @@ このガイドでは、Kubernetes と HelmChartを使用したMisskeyセットアップ方法について説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: ## TrueCharts と TrueNAS Scale MisskeyのHelmChartsはTrueNAS Scaleで使用するためのTrueChartsで公開されていますが、HelmChartsとしてインストールすることもできます。 -[TrueCharts](https://truecharts.org/charts/description_list) のサイトには利用可能なすべてのChartsやインストール方法などのドキュメントがあります。 +現在、Misskeyは_incubator_ trainで進行中です。 また、不明な点があればTrueChartsの[Discord](https://discord.gg/Ax9ZgzKx9t)サーバーで質問をすることもできます。 diff --git a/content/en/docs/3.for-admin/install/guides/manual.md b/content/en/docs/3.for-admin/install/guides/manual.md index 0efb7b3b..d17aa4f6 100644 --- a/content/en/docs/3.for-admin/install/guides/manual.md +++ b/content/en/docs/3.for-admin/install/guides/manual.md @@ -7,7 +7,9 @@ description: このガイドではMisskeyのインストール・セットアッ このガイドではMisskeyのインストール・セットアップ方法について解説します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ + ::: :::tip{label='前提条件'} @@ -108,7 +110,9 @@ WantedBy=multi-user.target ``` :::warning + CentOSで1024以下のポートを使用してMisskeyを使用する場合は`ExecStart=/usr/bin/sudo /usr/bin/npm start`に変更する必要があります。 + ::: systemdを再読み込みしmisskeyサービスを有効化 @@ -125,7 +129,9 @@ sudo systemctl start misskey ``` :::tip + `systemctl status misskey`と入力すると、サービスの状態を調べることができます。 + ::: :::: @@ -133,7 +139,9 @@ sudo systemctl start misskey ## Misskeyのアップデート方法 :::warning + アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 + ::: masterをpullし直し、インストール、ビルド、データベースのマイグレーションを行います: @@ -156,8 +164,10 @@ sudo systemctl restart misskey ``` :::tip + ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: - `pnpm run clean`または`pnpm run clean-all` - `pnpm rebuild` - ::: + +::: diff --git a/content/en/docs/3.for-admin/install/guides/ubuntu-manual.md b/content/en/docs/3.for-admin/install/guides/ubuntu-manual.md index 99b7b42a..f86a16fa 100644 --- a/content/en/docs/3.for-admin/install/guides/ubuntu-manual.md +++ b/content/en/docs/3.for-admin/install/guides/ubuntu-manual.md @@ -11,11 +11,15 @@ [**シェルスクリプトの詳細と使用方法はこちらから！**](./bash/) :::tip + シェルスクリプトでの開発環境へのインストールは想定されていません。 + ::: :::tip + ドメインの購入とCloudflareのセットアップ、サーバーの確保についてはご自身でご準備ください。 + ::: 不具合があれば[ @aqz@p1.a9z.dev へのメンション](https://p1.a9z.dev/@aqz)にてお知らせいただければと思います。 @@ -27,7 +31,9 @@ [docker-compose](./docker/)なら、手作業でももうちょっと簡単に実行できるはずです。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: ## はじめに @@ -52,7 +58,9 @@ OSの違い、Misskey本体や依存するソフトウェアのバージョン - ここではドメインをexample.tldとして解説を進めるので、自分が買ったドメインに適宜置き換えて読むこと。開発環境の場合はlocalhostと読み替えます（設定ファイルの項で別途説明） :::danger + 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ + ::: ## nanoの使い方 @@ -78,7 +86,9 @@ sudo adduser --disabled-password --disabled-login misskey ``` :::tip + 開発環境の場合はユーザーを分ける必要はありません + ::: ## 基本的なソフトウェアのインストールと設定 @@ -174,10 +184,12 @@ activeならOK。 ### nginx -nginxは、主としてリバースプロキシに用いられるWebサーバーソフトである。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。 +http\://localhost にアクセスし、\*Welcome to nginx!\*と表示されればOK。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。 :::tip + 開発環境の場合はnginxのセットアップは不要です + ::: nginx.orgのドキュメント http\://nginx.org/en/linux_packages.html#Ubuntu に従ってインストールする。 @@ -238,7 +250,9 @@ sudo apt install -y git build-essential サーバーをインターネットに公開する準備をする。 :::tip + 開発環境の場合はファイヤーウォールやCloudFlare、Certbotの設定は不要です + ::: ### ファイヤーウォール @@ -272,7 +286,9 @@ sudo systemctl enable ufw ``` :::tip + ufwは、netfilter(iptables)を人間が操作しやすいようにするアプリだ。インストールスクリプトは、OCI環境ではnetfilterを直接操作する。 + ::: ### CloudFlare @@ -376,7 +392,9 @@ nano .config/default.yml 設定できる値と記述方法は[.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)に書かれている。 :::tip + 開発環境の場合、urlは`url: http://localhost:3000`と指定します。 + ::: ```yml @@ -469,7 +487,9 @@ NODE_ENV=production pnpm run build ``` :::tip + 開発環境の場合、`NODE_ENV=production`は不要です。以降のコマンドでも同様に削除してください。 + ::: ### サーバーでビルドできない場合 @@ -515,7 +535,9 @@ CloudFlareのDNS設定が正しいIPアドレスになっているかもう一 ## Misskeyのデーモンを作成 :::tip + 開発環境の場合、デーモンの作成は不要です。 + ::: いったんCtrl+Cでプロセスをキルし、Misskeyをデーモンで起動する設定をしよう。 diff --git a/content/en/docs/3.for-admin/install/resources/cdn.md b/content/en/docs/3.for-admin/install/resources/cdn.md index 37881403..332a14fa 100644 --- a/content/en/docs/3.for-admin/install/resources/cdn.md +++ b/content/en/docs/3.for-admin/install/resources/cdn.md @@ -16,5 +16,7 @@ Please configure your CDN in the following way: - Cache all requests except `/api/*` :::tip -It is not necessary to clear the cache when updating Misskey. + +Misskeyをアップデートした際にキャッシュのクリアは不要です。 + ::: diff --git a/content/en/docs/3.for-admin/install/resources/troubleshooting.md b/content/en/docs/3.for-admin/install/resources/troubleshooting.md index d9aff878..202e3705 100644 --- a/content/en/docs/3.for-admin/install/resources/troubleshooting.md +++ b/content/en/docs/3.for-admin/install/resources/troubleshooting.md @@ -248,6 +248,10 @@ Amazon S3に互換性のあるオブジェクトストレージであれば利 各サービス/ソフトウェアのドキュメントをよく読み、設定してみてください。 +### ローディングが終わらない + +Cloudflare を使用している場合は、Rocket LoaderやAuto Minifyが有効になっていないか確認してください。有効になっている場合は無効にすることで解決する場合があります。 + *** # まったく解決しなかった場合 diff --git a/content/en/docs/3.for-admin/moderation-tips/disable-timelines.md b/content/en/docs/3.for-admin/moderation-tips/disable-timelines.md index 09f70108..da524e69 100644 --- a/content/en/docs/3.for-admin/moderation-tips/disable-timelines.md +++ b/content/en/docs/3.for-admin/moderation-tips/disable-timelines.md @@ -8,7 +8,9 @@ As the weight of these advantages and disadvantages may vary from server to serv If you feel like the demerits outweigh the merits, please consider deactivating these respective timelines. :::warning + Disabling timelines can lead to confusion and possibly to a short-time drop in users.Therefore, please carefully consider the effects of disabling a timeline, and explain the reasoning for doing so in advance, so that your users can prepare by e. g. following users they often talk with on the LTL/STL. + ::: Additionally, Administrators / Moderators will be able to continue viewing these timelines even after they have been disabled. diff --git a/content/en/docs/4.for-developers/aiscript.md b/content/en/docs/4.for-developers/aiscript.md new file mode 100644 index 00000000..2c7c5860 --- /dev/null +++ b/content/en/docs/4.for-developers/aiscript.md @@ -0,0 +1,67 @@ +# AiScript + +AiScriptは、Misskeyの以下の箇所で使用できるスクリプト言語です。 + +- [プラグイン](./plugin/) +- [ウィジェット](/docs/for-users/features/widgets/) + - ボタン + - AiScriptコンソール + - AiScript App +- Misskey Play +- スクラッチパッド + +:::tip + +AiScriptの実装はMisskeyとは別リポジトリで、[オープンソースで公開されています](https://github.com/aiscript-dev/aiscript)。 + +::: + +## 使い方 + +AiScript標準の構文や組み込み関数などが使用できます。 + +:::tip + +ドキュメントは[こちら](https://github.com/aiscript-dev/aiscript/tree/master/docs)\ +Misskey本体のバージョンにより、使用できるAiScriptのバージョンが異なる場合があります。バージョンの確認には`<: Core:v`をScratchpadなどで実行してください。 + +::: + +これらに加え、Misskey専用の組み込み定数・関数が３グループに分けて提供されています。 + +### Misskey AiScript API + +接頭辞: `Mk:`\ +Misskey内の全てのAiScript環境で使用できる定関数群です。 +詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Mk:`とついた部分を参照して下さい。 + +### プラグインAPI + +接頭辞: `Plugin:`\ +[プラグイン](./plugin/)でのみ使用できる定関数群です。 +詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Plugin:`とついた部分を参照して下さい。 + +### UI API + +接頭辞: `Ui:`\ +[ウィジェット](/docs/for-users/features/widgets/)（AiScript App）、Misskey Play、Scratchpadで使用できます。 +ドキュメントは未整備（TODO）ですが、インターネット上に有志の方が執筆された解説記事があります。 + +### 標準入出力 + +AiScript標準で定義されている`readline`関数と`print`関数（および`<:`構文）の内部実装は、Misskey側で独自に提供されています。 + +#### readline(message) + +`message`: `str`\ +返り値: `str`\ +Misskey内の全てのAiScript環境で使用できます。\ +文字列の入力を求めるポップアップを表示します。 + +#### print(message) + +`message`: `any`\ +返り値: `null`\ +[ウィジェット](/docs/for-users/features/widgets/)（AiScriptコンソール）、Scratchpadで使用できます。\ +コンソールに文字列を出力します。\ +`<:`構文も同様の働きをします。 diff --git a/content/en/docs/4.for-developers/api/1.index.md b/content/en/docs/4.for-developers/api/1.index.md index 11ef960c..2d2c988f 100644 --- a/content/en/docs/4.for-developers/api/1.index.md +++ b/content/en/docs/4.for-developers/api/1.index.md @@ -8,7 +8,9 @@ MisskeyはAPIを公開しています。APIを使ってMisskeyクライアント ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。 :::tip -Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\ + +Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\\ + ::: diff --git a/content/en/docs/4.for-developers/api/libraries.md b/content/en/docs/4.for-developers/api/libraries.md index 18db0f35..ee634623 100644 --- a/content/en/docs/4.for-developers/api/libraries.md +++ b/content/en/docs/4.for-developers/api/libraries.md @@ -15,6 +15,8 @@ description: Misskey APIに関連するライブラリの一覧 ## Python - [Misskey.py](https://github.com/YuzuRyo61/Misskey.py) +- [MiPA](https://github.com/yupix/MiPA) +- [MiPAC](https://github.com/yupix/MiPAC) ## .Net diff --git a/content/en/docs/4.for-developers/api/permission.md b/content/en/docs/4.for-developers/api/permission.md index 7844a7fe..50dd4be7 100644 --- a/content/en/docs/4.for-developers/api/permission.md +++ b/content/en/docs/4.for-developers/api/permission.md @@ -5,7 +5,9 @@ description: アプリケーションが要求する権限の一覧 # 権限の一覧 :::tip + このページは[misskey-js](https://github.com/misskey-dev/misskey/tree/develop/packages/misskey-js)から自動生成しているため、ドキュメントや翻訳が不完全な場合があります。 + ::: diff --git a/content/en/docs/4.for-developers/api/streaming/1.index.md b/content/en/docs/4.for-developers/api/streaming/1.index.md index af767dfc..6ce5b5bc 100644 --- a/content/en/docs/4.for-developers/api/streaming/1.index.md +++ b/content/en/docs/4.for-developers/api/streaming/1.index.md @@ -5,7 +5,9 @@ description: ストリーミングAPIを使うと、リアルタイムで様々 # ストリーミングAPI :::tip + 最初に[Misskey API](../index.md)のドキュメントを読むことをお勧めします。 + ::: ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、リアクションされた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。 @@ -26,7 +28,9 @@ wss://{host}/streaming?i={token} - `{token}`の部分は、ユーザーのアクセストークンに置き換えます。 :::tip + アクセストークンは省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。 + ::: ストリームに接続すると、後述投稿の購読を行ったりすることができますが、まだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。 @@ -40,7 +44,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。 :::tip + ひとつのストリーム接続上で、同時に複数のチャンネルに接続することができます。 + ::: 以下では、チャンネルの使用方法を説明します。どのようなチャンネルがあるかは、[チャンネル一覧](./channel/index.md)を参照してください。 @@ -69,7 +75,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり - `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。 :::tip + IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。 + ::: ### チャンネルからのメッセージを受け取る diff --git a/content/en/docs/4.for-developers/api/token.md b/content/en/docs/4.for-developers/api/token.md index 8f9d3919..d0e74076 100644 --- a/content/en/docs/4.for-developers/api/token.md +++ b/content/en/docs/4.for-developers/api/token.md @@ -7,7 +7,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた** アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 :::tip + ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 + ::: あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 @@ -20,7 +22,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた** Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 :::danger + アクセストークンは他人に知られないようにしてください。 + ::: ### アプリケーション利用者にアクセストークンの発行をリクエストする @@ -32,6 +36,7 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app) + ::: #### Step 1 @@ -39,7 +44,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger + このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: #### Step 2 @@ -119,7 +126,9 @@ https://{host}/api/miauth/{session}/check APIの詳細は、APIリファレンスを参照してください。 :::warning + MisskeyはRESTを採用していません。 + ::: また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 diff --git a/content/en/docs/4.for-developers/api/token/1.index.md b/content/en/docs/4.for-developers/api/token/1.index.md new file mode 100644 index 00000000..3305efc0 --- /dev/null +++ b/content/en/docs/4.for-developers/api/token/1.index.md @@ -0,0 +1,88 @@ +# アクセストークンの取得 + +APIを使い始めるには、APIを利用するアカウントに紐づいた**アクセストークン**を取得する必要があります。 +このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。 + +基本的に、APIはリクエストにはアクセストークンが必要となります。 +アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 + +:::tip + +ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 + +::: + +あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 + +- 前者の場合: **「自分自身のアクセストークンを手動発行する」** に進む +- 後者の場合: **「アプリケーション利用者にアクセストークンの発行をリクエストする」** に進む + +## 自分自身のアクセストークンを手動発行する + +Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 + +:::danger + +アクセストークンは他人に知られないようにしてください。 + +::: + +## アプリケーション利用者にアクセストークンの発行をリクエストする + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の方法の一つを使います。 + +:MkIndex + +## APIの利用 + +アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。 + +:::tip + +- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。 +- 要求ヘッダーに`Content-Type: application/json`を指定します。 +- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。 +- ベースURLは`https://{サーバーのドメイン}/api`です。 + +::: + +### Authorization headerを使う方式 + +以下のようにヘッダーの`Authorization`フィールドを指定します。 + +```js +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + text: "Hello Misskey API World with My Application!" + }), + headers: { + Authorization: `Bearer ${accessToken}`, + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` + +### iを使う方式 + +アクセストークン付きのボディの例（metaの場合）: + +```json +{ + "i": "HogEFugA1341", + "detail": false +} +``` + + + +APIの詳細は、APIリファレンスを参照してください。 + +:::warning + +MisskeyはRESTを採用していません。 + +::: + +また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](../streaming/)を参照してください。 diff --git a/content/en/docs/4.for-developers/api/token/2.miauth.md b/content/en/docs/4.for-developers/api/token/2.miauth.md new file mode 100644 index 00000000..1100db0d --- /dev/null +++ b/content/en/docs/4.for-developers/api/token/2.miauth.md @@ -0,0 +1,76 @@ +--- +description: v12.27.0以降で使用できる、Misskey独自の簡素な認証方法について説明しています。 +--- + +# MiAuth方式でのアクセストークン取得方式 + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 + +:::tip + +以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 + +- [よりおおく使われているOAuth方式でのアクセストークン取得方法もあります。](./oauth.md) +- [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app.md) + +::: + +## Step 1 + +UUIDを生成する。以後これを**セッションID**と呼びます。 + +:::danger + +このセッションIDは毎回生成し、使いまわさないようにしてください。 + +::: + +## Step 2 + +アプリケーション認証フォームをユーザーのブラウザで表示させる。認証フォームは、以下の形式のURLで開くことができます: + +``` +https://{host}/miauth/{session} +``` + +ここで、 + +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 +- `{session}`の部分は、セッションIDに置き換えます。 + +また、URLにクエリパラメータとしていくつかのオプションを設定できます: + +| 名前 | 説明 | +| ------------ | ------------------------------------------------------------------------------ | +| `name` | アプリケーション名。 | +| `icon` | アプリケーションのアイコン画像URL。 | +| `callback` | 認証が終わった後にリダイレクトするURL。
リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 | +| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 | + +:::tip{label='例'} + +``` +https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive +``` + +::: + +## Step 3 + +ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 + +``` +https://{host}/api/miauth/{session}/check +``` + +ここで、 + +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。 +- `{session}`の部分は、セッションIDに置き換えます。 + +レスポンスに含まれるプロパティは以下の通りです: + +| 名前 | 説明 | +| ------- | -------------- | +| `token` | ユーザーのアクセストークン。 | +| `user` | ユーザーの情報。 | diff --git a/content/en/docs/4.for-developers/api/token/3.oauth.md b/content/en/docs/4.for-developers/api/token/3.oauth.md new file mode 100644 index 00000000..a29644ab --- /dev/null +++ b/content/en/docs/4.for-developers/api/token/3.oauth.md @@ -0,0 +1,179 @@ +--- +description: v2023.9.0以降で使用できる、OAuth2.0方式での認証方法について説明しています。 +--- + +# OAuth方式でのアクセストークン取得方式 + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 + +:::tip + +以下に説明する方法は、[OAuth 2.0](https://datatracker.ietf.org/doc/html/rfc6749.html)と呼ばれるものです。普通のOAuthはアプリを作成しますが、[IndieAuth](https://indieauth.spec.indieweb.org/)の拡張でアプリ作成なしで使えるようになっています。 + +OAuth方式は使えるライブラリが多いので、出来ればライブラリを使うのをおすすめします。 + +現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。 + +- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md) +- [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md) + +::: + +## Step 1 + +アプリ紹介のためのウェブページを作ります。ページがHTTPSアドレスでアクセスできるようにしてください。ページのとこかに以下のようなHTMLコードを書きます。 + +```html + + + + +
+ My Misskey App +
+``` + +あとで`redirect_uri`のアドレスに認証コードが転送されます。 + +## Step 2 + +PKCE `code_verifier`と`code_challenge`文字列, 及び`state`文字列を生成します。 + +- `code_verifier`の場合は最低43字、最高128字でアルファベット大・小文字及び`-._~`の中の文字に限られます。 +- `code_challenge`文字列は`code_verifier`文字列をSHA256アルゴリズムでハッシュしてbase64urlでエンコードした結果を使います。 +- `state`文字列には特別な制限はありません。ランダムな文字列を使います。 + +:::danger + +この文字列は毎回生成し、使いまわさないようにしてください。 + +::: + +:::tip + +[pkce-challenge](https://www.npmjs.com/package/pkce-challenge)とかのライブラリを使ったり、OAuthライブラリのPKCE機能を使うのがおすすめです。 + +::: + +:::tip{label='例'} + +```js +import crypto from "node:crypto"; + +const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-._~"; +const codeVerifier = new Array(128) + .fill(0) + .map(() => chars[Math.floor(chars.length * Math.random())]) + .join(""); +console.log('code_verifier', codeVerifier); + +const codeChallenge = crypto + .createHash("sha256") + .update(codeVerifier, "ascii") + .digest("base64url"); +console.log('code_challenge', codeChallenge); + +const state = crypto.randomUUID(); +console.log('state', state); +``` + +::: + +## Step 3 + +相手サーバーのOAuth情報を取得します。データはJSON形式になっています。 + +``` +https://{host}/.well-known/oauth-authorization-server +``` + +`{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 + +ここでは`authorization_endpoint`と`token_endpoint`を使います。 + +:::tip + +次のステップで使われる`scope`の情報も`scopes_supported`で確認できます。 + +::: + +## Step 4 + +アプリケーション認証フォームをユーザーのブラウザで表示させます。認証フォームは、以下の形式のURLで開くことができます: + +``` +{authorization_endpoint}?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&scope={scope}&code_challenge={code_challenge}&code_challenge_method=S256&state={state} +``` + +ここで、 + +- `{authorization_endpoint}`の部分は、前の情報取得で得たアドレスに置き換えます。 +- `{client_id}`の部分は、アプリの紹介ページのアドレスに置き換えます。 +- `{code_challenge}`の部分は、前に生成した`code_challenge`文字列に置き換えます +- `code_challenge_method`の部分は常に`S256`にします。 +- `{redirect_uri}`の部分は、紹介ページで使っている配達先のアドレスに置き換えます。 +- `{scope}`の部分は、アプリケーションが要求する権限に置き換えます。要求する権限を` `で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 +- `{state}`の部分は、前に生成した`state`文字列に置き換えます。 + +:::tip{label='例'} + +``` +https://misskey.local/oauth/authorize?client_id=http%3A%2F%2Fexample.com&code_challenge=C6hwMO2bmIzg3nqppTE9b79fvuOjlrKmH2xNiZSMHzw&code_challenge_method=S256&response_type=code&redirect_uri=http%3A%2F%2Fexample.com%2Fredirect&scope=write%3Anotes&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +## Step 5 + +ユーザーがアプリケーションアクセスを許可したら、`redirect_uri`のアドレスに認証コードがURLパラメータの形式で転送されます。 + +| 名前 | 説明 | +| ------- | ----------------------- | +| `code` | ユーザーの認証コード。 | +| `state` | 認証リクエストに使われた`state`文字列。 | + +:::tip{label='例'} + +``` +https://example.com/redirect?code=...&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +`state`文字列がちゃんと一致しているのか確認して、次のステップに進みます。 + +## Step 6 + +転送された認証コードを使ってアクセストークンをPOSTでリクエストします。リクエスト先は`token_endpoint`になります。データ形式は`application/json`と`application/x-www-form-urlencoded`を使えます。各パラメータは以下のようになります。 + +| 名前 | 説明 | +| --------------- | ------------------------------ | +| `grant_type` | 常に`authorization_code`にします。 | +| `client_id` | 認証リクエストに使われた`client_id`文字列。 | +| `redirect_uri` | 認証リクエストに使われた`redirect_uri`文字列。 | +| `scope` | 認証リクエストに使われた`scope`文字列。 | +| `code` | 取得した認証コード。　 | +| `code_verifier` | 前に生成した`code_verifier`文字列。 | + +:::tip{label='例'} + +```js +const res = await fetch(endpoint, { + method: "POST", + body: JSON.stringify({ + grant_type: "authorization_code", + client_id: "https://example.com", + redirect_uri: "https://example.com/redirect", + scope: "write:notes", + code: "...", + code_verifier: "hjjbCYDmDpSLjirkO-PrfWKsRhDdJr-PAEGRClRwzUKlmFIIIrZNmSvUIraeIa~WqbqQnfbJV-Hc_IfuQkesBYUpukUi~lInDfU_AZjoZqbU.ioQTRzaFfZFfGnT-OAA", + }), + headers: { + "Content-Type": "application/json" + } +}); +``` + +::: + +レスポンスはJSONオブジェクト形式で、そこから`access_token`を取得して使います。 diff --git a/content/en/docs/5.releases.md b/content/en/docs/5.releases.md index b7879489..17c4324b 100644 --- a/content/en/docs/5.releases.md +++ b/content/en/docs/5.releases.md @@ -6,6 +6,49 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2023.12.2 + +リリース日: 2023/12/28 + +### General + +- v2023.12.1でDockerを利用してサーバーを起動できない問題を修正 + +### Client + +- Enhance: 検索画面においてEnterキー押下で検索できるように + +## 2023.12.1 + +リリース日: 2023/12/27 + +### Note + +- アクセストークンの権限が再整理されたため、一部のAPIが古いAPIトークンでは動作しなくなりました。\ + 権限不足になる場合には権限を再設定して再生成してください。 + +### General + +- Enhance: ローカリゼーションの更新 +- Fix: 自分のdirect noteがuser list timelineに追加されない + +### Client + +- Feat: AiScript専用のMFM構文`$[clickable.ev=EVENTNAME ...]`を追加。`Mk:C:mfm`のオプション`onClickEv`に関数を渡すと、クリック時に`EVENTNAME`を引数にして呼び出す +- Enhance: MFM入力補助ボタンを投稿フォームに表示できるように #12787 +- Fix: 一部のモデログ(logYellowでの表示対象)について、表示の色が変わらない問題を修正 +- Fix: `fg`/`bg`MFMに長い単語を指定すると、オーバーフローされずはみ出る問題を修正 + +### Server + +- Enhance: センシティブワードの設定がハッシュタグトレンドにも適用されるようになりました +- Enhance: `oauth/token`エンドポイントのCORS対応 +- Fix: 1702718871541-ffVisibility.jsのdownが壊れている +- Fix:「非センシティブのみ（リモートはいいねのみ）」を設定していても、センシティブに設定されたカスタム絵文字をリアクションできる問題を修正 +- Fix: ロールアサイン時の通知で，ロールアイコンが縮小されずに表示される問題を修正 +- Fix: サードパーティアプリケーションがWebsocket APIに無条件にアクセスできる問題を修正 +- Fix: サードパーティアプリケーションがユーザーの許可なしに非公開の情報を見ることができる問題を修正 + ## 2023.12.0 リリース日: 2023/12/23 @@ -1957,7 +2000,9 @@ same as 12.112.0 ### NOTE :::warning + このバージョンからNode v16.14.0以降が必要です + ::: ### Changes @@ -2069,12 +2114,16 @@ same as 12.112.0 ### Note :::warning + ビルドする前に`npm run clean`を実行してください。 + ::: :::warning + このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 + ::: ### Improvements @@ -2145,6 +2194,7 @@ same as 12.112.0 アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。 12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。 + ::: ### Changes diff --git a/content/fr/docs/1.about-misskey.md b/content/fr/docs/1.about-misskey.md index a67dba09..78d3b431 100644 --- a/content/fr/docs/1.about-misskey.md +++ b/content/fr/docs/1.about-misskey.md @@ -15,7 +15,9 @@ Misskeyはオープンソースの分散型マイクロブログプラットフ 当初は分散型ではありませんでしたが、2018年にActivityPubを実装し分散型になったことで、より多くの方に認知され利用されるサービスになり、現在に至ります。 :::tip + Misskeyという名前は、syuiloが当時聴いていたMay'nというアーティストの楽曲、Brain Diverの歌詞に由来します。 + ::: 誰でも開発に参加することができ、現在でも活発に開発が続いています。 @@ -35,7 +37,9 @@ Misskeyのすべてのソースコードは[AGPL](https://github.com/misskey-dev 再び引き合いに出しますが、TwitterやFacebookなどの利益を得ているほとんどのサービスはオープンソースではありません。 :::tip + 技術的に言うと、MisskeyのソースコードはGitで管理されていて、リポジトリは[GitHub上でホスティングされています。](https://github.com/misskey-dev) + ::: ## 開発に参加する、プロジェクトを支援する @@ -143,8 +147,11 @@ Misskeyは開発が進むにつれ使用する技術も大きく変わってき :::fukidashi{chara="doya_ai" charaName="藍"} わたしについては[このホームページ](https://xn--931a.moe/)をご覧ください！ + ::: :::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"} + Misskeyの守り神、藍ちゃんです。ｱｲﾁｬﾝｶﾜｲｲﾔｯﾀｰ! + ::: diff --git a/content/fr/docs/2.for-users/2.onboarding/2.get-started.md b/content/fr/docs/2.for-users/2.onboarding/2.get-started.md index aa4d1522..69e63d26 100644 --- a/content/fr/docs/2.for-users/2.onboarding/2.get-started.md +++ b/content/fr/docs/2.for-users/2.onboarding/2.get-started.md @@ -11,14 +11,17 @@ Misskeyを利用するには、どこかのサーバーにアカウントを作 [サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。 :::tip + どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 :::g-details{summary='詳細'} + Misskeyには連合機能が備わっています。 連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。 Misskeyが搭載している連合機能はActivityPubというオープンな共通規格に基づいていて、MastodonやPleromaといったほかのソフトウェアとも互換性があります。 + ::: ::: @@ -31,5 +34,7 @@ Misskeyが搭載している連合機能はActivityPubというオープンな 自分にあったテーマのサーバーを探すのもおすすめです。 :::tip + サーバーの一覧は[こちら](/servers/)からご覧いただけます。 + ::: diff --git a/content/fr/docs/2.for-users/2.onboarding/3.join-server.md b/content/fr/docs/2.for-users/2.onboarding/3.join-server.md index 6f42c0c1..7c26053a 100644 --- a/content/fr/docs/2.for-users/2.onboarding/3.join-server.md +++ b/content/fr/docs/2.for-users/2.onboarding/3.join-server.md @@ -3,9 +3,11 @@ 登録するサーバーが決まったら、さっそくアカウントを作成しましょう。 :::tip + ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 ただし、入力事項はサーバーによって異なることがあります。詳しくは、サーバー管理者にお問い合わせください。 + ::: ## 登録する diff --git a/content/fr/docs/2.for-users/2.onboarding/4.things-to-know.md b/content/fr/docs/2.for-users/2.onboarding/4.things-to-know.md index e77c9aa2..d5428ffb 100644 --- a/content/fr/docs/2.for-users/2.onboarding/4.things-to-know.md +++ b/content/fr/docs/2.for-users/2.onboarding/4.things-to-know.md @@ -7,7 +7,9 @@ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一般的なSNSに比べたくさんの機能がありますので、初めての投稿を行う前に必ず確認して、上手に投稿しましょう！ :::tip + 詳細は、「[ノート](/docs/for-users/features/note/)」をご覧ください。 + ::: ## タイムライン @@ -15,7 +17,9 @@ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一 Misskeyは、複数のタイムラインを持っています。名前だけでは少々わかりにくいかと思いますので、それぞれがどのような働きをするのかを知っておきましょう。 :::tip + 詳細は、「[タイムライン](/docs/for-users/features/timeline/)」をご覧ください。 + ::: ## その他 diff --git a/content/fr/docs/2.for-users/3.features/ads.md b/content/fr/docs/2.for-users/3.features/ads.md index 456c5790..72aa40ec 100644 --- a/content/fr/docs/2.for-users/3.features/ads.md +++ b/content/fr/docs/2.for-users/3.features/ads.md @@ -4,7 +4,9 @@ Misskeyではサーバーによる広告をタイムラインなどに表示で 広告の右上に表示されるアイコンをクリックすることで、当該の広告の表示頻度を下げることができます。 :::tip + 広告の総数が少ない場合は、表示頻度を下げた後も連続で表示される可能性があります。 + ::: ## 広告の設定(管理者) diff --git a/content/fr/docs/2.for-users/3.features/drive.md b/content/fr/docs/2.for-users/3.features/drive.md index 3fc879de..81f0417d 100644 --- a/content/fr/docs/2.for-users/3.features/drive.md +++ b/content/fr/docs/2.for-users/3.features/drive.md @@ -3,7 +3,9 @@ ドライブは、Misskey上でファイルを管理できる機能です。 :::tip + 技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。 + ::: Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。 @@ -13,7 +15,9 @@ Misskey Webのドライブページから任意のファイルをアップロー ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。 :::warning + 現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。 + ::: ## センシティブ (NSFW) diff --git a/content/fr/docs/2.for-users/3.features/mfm.md b/content/fr/docs/2.for-users/3.features/mfm.md index 5771232a..6ec1aa36 100644 --- a/content/fr/docs/2.for-users/3.features/mfm.md +++ b/content/fr/docs/2.for-users/3.features/mfm.md @@ -7,7 +7,9 @@ description: MFMは、Misskeyの様々な場所で使用できる専用のマー MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。 :::tip + 一部の構文はMarkdownやHTMLと互換性があります。 + ::: ## MFMが使用可能な場所の例 @@ -23,7 +25,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使 アットマーク + ユーザー名で、特定のユーザーを示すことができます。 :::tip + メンションについての詳細は[こちら](./mention.md)を参照してください。 + ::: ``` @@ -42,7 +46,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使 ナンバーサイン + タグで、ハッシュタグを示すことができます。 :::tip + ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。 + ::: ``` @@ -70,6 +76,7 @@ https://example.com ``` :::tip + リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。 ``` @@ -83,8 +90,11 @@ https://example.com ### カスタム絵文字 コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。 + :::tip + カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。 + ::: ``` diff --git a/content/fr/docs/2.for-users/3.features/mute-and-block.md b/content/fr/docs/2.for-users/3.features/mute-and-block.md index 9ff1ddf9..6fa407ce 100644 --- a/content/fr/docs/2.for-users/3.features/mute-and-block.md +++ b/content/fr/docs/2.for-users/3.features/mute-and-block.md @@ -5,11 +5,15 @@ ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。 :::tip + ミュートとブロックは併用できます。 + ::: :::warning + 利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。 + ::: Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。 @@ -26,7 +30,9 @@ Misskey Webでは、設定>ミュートとブロック から、自分がミュ Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。 :::tip + ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。 + ::: ## ブロック @@ -48,9 +54,13 @@ Misskey Webでユーザーをミュートするには、対象のユーザーの Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。 :::warning + ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。 + ::: :::warning + 相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。 + ::: diff --git a/content/fr/docs/2.for-users/3.features/pages.md b/content/fr/docs/2.for-users/3.features/pages.md index 21a59a21..0bb1232f 100644 --- a/content/fr/docs/2.for-users/3.features/pages.md +++ b/content/fr/docs/2.for-users/3.features/pages.md @@ -3,7 +3,9 @@ Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。 :::warning + v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。 + ::: ## ページ設定 diff --git a/content/fr/docs/2.for-users/3.features/poll.md b/content/fr/docs/2.for-users/3.features/poll.md index c96f89a1..32777ede 100644 --- a/content/fr/docs/2.for-users/3.features/poll.md +++ b/content/fr/docs/2.for-users/3.features/poll.md @@ -13,7 +13,9 @@ 追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。 :::warning + いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。 + ::: ## 複数回答を可能にする @@ -41,7 +43,9 @@ 未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。 :::tip + 未投票アンケートには、結果を表示した状態でも投票できます。 + ::: 投票をすると、自分の投票した選択肢に✔がつきます。 diff --git a/content/fr/docs/2.for-users/3.features/share-form.md b/content/fr/docs/2.for-users/3.features/share-form.md index 0bd8a69a..e65fd555 100644 --- a/content/fr/docs/2.for-users/3.features/share-form.md +++ b/content/fr/docs/2.for-users/3.features/share-form.md @@ -7,7 +7,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく ## クエリパラメータ :::tip + すべてのパラメータは**オプション**であり、必須ではありません。 + ::: | 名前 | 説明 | @@ -46,7 +48,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく | `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) | :::warning + `visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。 + ::: ### 添付ファイル diff --git a/content/fr/docs/2.for-users/3.features/thread-mute.md b/content/fr/docs/2.for-users/3.features/thread-mute.md index ab4bd823..2f4378ba 100644 --- a/content/fr/docs/2.for-users/3.features/thread-mute.md +++ b/content/fr/docs/2.for-users/3.features/thread-mute.md @@ -1,7 +1,9 @@ # スレッドミュート :::tip + バージョン 12.95.0 以降の機能です。 + ::: スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。 @@ -11,5 +13,7 @@ Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。 :::warning + スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。 + ::: diff --git a/content/fr/docs/2.for-users/3.features/webhook.md b/content/fr/docs/2.for-users/3.features/webhook.md index eab0e71c..19d61ab2 100644 --- a/content/fr/docs/2.for-users/3.features/webhook.md +++ b/content/fr/docs/2.for-users/3.features/webhook.md @@ -1,11 +1,15 @@ # Webhook :::tip + バージョン 12.109.0 以降の機能です。 + ::: :::warning + 実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。 + ::: MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。 diff --git a/content/fr/docs/2.for-users/4.resources/1.troubleshooting.md b/content/fr/docs/2.for-users/4.resources/1.troubleshooting.md index 03b877a9..2aef90d3 100644 --- a/content/fr/docs/2.for-users/4.resources/1.troubleshooting.md +++ b/content/fr/docs/2.for-users/4.resources/1.troubleshooting.md @@ -5,7 +5,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ # トラブルシューティング :::tip + [よくある質問](./faq.md)も合わせてお役立てください。 + ::: 問題が発生したときは、まずこちらをご確認ください。 @@ -59,7 +61,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ クライアントの設定の「キャッシュをクリア」すると直ります。 :::warning + 「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。 + ::: ## 通知やアンテナ等の点滅が消えない diff --git a/content/fr/docs/2.for-users/4.resources/donate.md b/content/fr/docs/2.for-users/4.resources/donate.md index 0972cb72..bbd32212 100644 --- a/content/fr/docs/2.for-users/4.resources/donate.md +++ b/content/fr/docs/2.for-users/4.resources/donate.md @@ -13,22 +13,27 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip + 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 + ::: :::tip + 額に応じて以下の返礼を用意しています。 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 - 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載 - 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載 - ::: + +::: :::warning -:::warning + **バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。** + (メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります) -::: + ::: また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。 diff --git a/content/fr/docs/2.for-users/4.resources/misskey-hub.md b/content/fr/docs/2.for-users/4.resources/misskey-hub.md index bbdce97a..87114f3d 100644 --- a/content/fr/docs/2.for-users/4.resources/misskey-hub.md +++ b/content/fr/docs/2.for-users/4.resources/misskey-hub.md @@ -6,7 +6,9 @@ Misskey Hubは、Misskeyに関するナレッジなどのドキュメント、 Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub) :::tip + Misskey HubはNuxtを使ってビルドされた静的サイトです。 + ::: ## Misskey Hubに貢献する diff --git a/content/fr/docs/3.for-admin/features/announcement.md b/content/fr/docs/3.for-admin/features/announcement.md index 54475e35..caaa6436 100644 --- a/content/fr/docs/3.for-admin/features/announcement.md +++ b/content/fr/docs/3.for-admin/features/announcement.md @@ -5,12 +5,14 @@ お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。 :::warning + アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。 - 「既存ユーザーのみ」オプションを有効にしてお知らせを作成する - 「非通知」オプションを有効にしてお知らせを作成する - 終了したお知らせはアーカイブする - ::: + +::: ## 表示形式 diff --git a/content/fr/docs/3.for-admin/features/role.md b/content/fr/docs/3.for-admin/features/role.md index 6ed15743..a5aeb766 100644 --- a/content/fr/docs/3.for-admin/features/role.md +++ b/content/fr/docs/3.for-admin/features/role.md @@ -21,11 +21,13 @@ - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) :::warning + コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 - 手動でのアサイン/アサイン解除は行えません。 - 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。 - ::: + +::: ## 権限 @@ -53,6 +55,7 @@ **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** :::tip + 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 @@ -62,7 +65,8 @@ - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ::: + +::: ### ベースロールの値を使用 @@ -85,13 +89,15 @@ アサインする際にアサインされる期間を設定することが可能です。 :::tip -:::tip + ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。 -::: + ::: :::warning + コンディショナル ロールには手動でのアサインはできません。 + ::: ## ユーザーのポリシーの確認 diff --git a/content/fr/docs/3.for-admin/install/guides/1.index.md b/content/fr/docs/3.for-admin/install/guides/1.index.md index 73c48d68..012ad01f 100644 --- a/content/fr/docs/3.for-admin/install/guides/1.index.md +++ b/content/fr/docs/3.for-admin/install/guides/1.index.md @@ -7,15 +7,19 @@ description: Misskeyサーバーの作成方法についての案内です。 Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::warning + 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。 詳しくは [misskey-dev/misskey #9791](https://github.com/misskey-dev/misskey/issues/9791) をご覧ください。 + ::: ## Xserver VPSでインストール diff --git a/content/fr/docs/3.for-admin/install/guides/bash.md b/content/fr/docs/3.for-admin/install/guides/bash.md index 09a6ede6..b7762eba 100644 --- a/content/fr/docs/3.for-admin/install/guides/bash.md +++ b/content/fr/docs/3.for-admin/install/guides/bash.md @@ -20,7 +20,9 @@ Misskeyを簡単にインストールするためのシェルスクリプトが 3. Cloudflareアカウント（推奨） :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。 @@ -28,7 +30,6 @@ Let's Encryptの認証を試行できる回数が少ないので、サーバー ## Cloudflareの設定 Cloudflareを使う場合、Cloudflareのドメインの設定を完了してからインストールを開始するようにしてください。\ -\ ネームサーバーの適用には最大で3日程度かかる場合があります。 また、nginxとCloudflareを設定する場合、Cloudflareの設定画面にて、 @@ -41,7 +42,6 @@ Cloudflareを使う場合、Cloudflareのドメインの設定を完了してか ### 1. SSH サーバーにSSH接続します。\ -\ （サーバーのデスクトップを開いている方はシェルを開きましょう。） ### 2. 環境を最新にする @@ -113,13 +113,10 @@ iptablesを使うようにしてください。 v1から、インストールメソッドにsystemdとDockerとを選べるようにしました。 Dockerと言っても、**MisskeyだけをDockerで実行**し、RedisやPostgresなどはホストで直接実行します。\ -\ [docker-composeですべての機能を動かす方法については、mamemonongaさんが作成したこちらの記事がおすすめです。](https://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0) Docker Hubイメージを使う設定であれば、Misskeyのビルドが不要になるため、**一番お勧めです**。\ -\ ただし、マイグレーションは必要なので、アップデート時にMisskeyを使えない時間がゼロになるわけではありません。\ -\ また、Misskeyのビルド環境を準備しない(git pullしない)ので、フォークを動かしたくなった時に設定が面倒になります。 ローカルでDockerをビルドする方式は、パフォーマンス面で非推奨です。 @@ -147,14 +144,12 @@ systemdは、Docker Hubにイメージを上げるまでもないものの、フ 万が一途中で失敗してもう一度スクリプトを動作させる場合、次のことに注意してください。 - RedisやPostgresのインストールが終わっている場合、「install locally」はNoにしてください。\ - \ host・port設定はそのままEnterを押します。 ユーザー名やパスワードは、前回実行した際に指定したものを入力します。 ## .envファイルについて インストールスクリプトは、2つの.envファイルを作成します。\ -\ アップデートの際に使用します。 ### /root/.misskey.env @@ -165,14 +160,12 @@ misskeyを実行するユーザーを覚えておくために必要です。 systemdの場合に生成されます。\ \ -主にディレクトリを覚えておくのに使用します。 +実行されているコンテナとイメージの番号を保存しています。 ### /home/(misskeyユーザー)/.misskey-docker.env Dockerの場合に生成されます。\ -\ 実行されているコンテナとイメージの番号を保存しています。\ -\ コンテナの番号はアップデートの際に更新されます。古いイメージは削除されます。 ## 自分で管理する @@ -184,7 +177,6 @@ Dockerの場合に生成されます。\ ### Misskeyディレクトリ Misskeyのソースは`/home/ユーザー/ディレクトリ`としてcloneされます。\ -\ （ユーザー、ディレクトリの初期値はともにmisskeyです。） Misskeyディレクトリへは、以下のように移動するとよいでしょう。 @@ -203,7 +195,6 @@ exit ### systemd systemdのプロセス名はexample.comです。\ -\ たとえば再起動するには次のようにします。 ``` @@ -259,7 +250,6 @@ requirepassとbindを`/etc/redis/misskey.conf`で設定しています。 ## Q. アップデート後に502でアクセスできない Dockerでは、起動後にマイグレーションをするため、すぐにアクセスできません。\ -\ マイグレーションが終わっているかどうか確認してみてください。 systemdの場合では、pnpm installに失敗している可能性があります。 @@ -275,5 +265,4 @@ journalctlでログを確認すると、たいていre2が云々という記述 ## Q. 同じサーバーにもう1つMisskeyを建てたい スクリプトは同じサーバーに追加でMisskeyをインストールすることは想定していません。\ -\ 幾つかの設定が上書きされるか、途中でエラーになってしまうでしょう。 diff --git a/content/fr/docs/3.for-admin/install/guides/docker.md b/content/fr/docs/3.for-admin/install/guides/docker.md index 69402049..08c0a65f 100644 --- a/content/fr/docs/3.for-admin/install/guides/docker.md +++ b/content/fr/docs/3.for-admin/install/guides/docker.md @@ -7,13 +7,16 @@ description: このガイドはDockerを使ったMisskeyセットアップ方法 このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::tip{label='前提条件'} - DockerおよびDocker Composeがインストールされていること。 - ::: + +::: ## リポジトリの取得 @@ -34,7 +37,6 @@ cp ./docker-compose_example.yml ./docker-compose.yml ``` `default.yml`と`docker.env`をファイル内の説明に従って編集してください。\ -\ また、必要に応じて、`docker-compose.yml`を編集します。(ポートを変更したい場合など) ## ビルドと初期化 @@ -60,9 +62,9 @@ GLHF✨ ## Misskeyのアップデート方法 :::warning -:::warning + アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 -::: + ::: ```sh diff --git a/content/fr/docs/3.for-admin/install/guides/kubernetes.md b/content/fr/docs/3.for-admin/install/guides/kubernetes.md index 8d0905fd..e313669a 100644 --- a/content/fr/docs/3.for-admin/install/guides/kubernetes.md +++ b/content/fr/docs/3.for-admin/install/guides/kubernetes.md @@ -3,14 +3,16 @@ このガイドでは、Kubernetes と HelmChartを使用したMisskeyセットアップ方法について説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: ## TrueCharts と TrueNAS Scale MisskeyのHelmChartsはTrueNAS Scaleで使用するためのTrueChartsで公開されていますが、HelmChartsとしてインストールすることもできます。 -[TrueCharts](https://truecharts.org/charts/description_list) のサイトには利用可能なすべてのChartsやインストール方法などのドキュメントがあります。 +現在、Misskeyは_incubator_ trainで進行中です。 また、不明な点があればTrueChartsの[Discord](https://discord.gg/Ax9ZgzKx9t)サーバーで質問をすることもできます。 diff --git a/content/fr/docs/3.for-admin/install/guides/manual.md b/content/fr/docs/3.for-admin/install/guides/manual.md index 0efb7b3b..d17aa4f6 100644 --- a/content/fr/docs/3.for-admin/install/guides/manual.md +++ b/content/fr/docs/3.for-admin/install/guides/manual.md @@ -7,7 +7,9 @@ description: このガイドではMisskeyのインストール・セットアッ このガイドではMisskeyのインストール・セットアップ方法について解説します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ + ::: :::tip{label='前提条件'} @@ -108,7 +110,9 @@ WantedBy=multi-user.target ``` :::warning + CentOSで1024以下のポートを使用してMisskeyを使用する場合は`ExecStart=/usr/bin/sudo /usr/bin/npm start`に変更する必要があります。 + ::: systemdを再読み込みしmisskeyサービスを有効化 @@ -125,7 +129,9 @@ sudo systemctl start misskey ``` :::tip + `systemctl status misskey`と入力すると、サービスの状態を調べることができます。 + ::: :::: @@ -133,7 +139,9 @@ sudo systemctl start misskey ## Misskeyのアップデート方法 :::warning + アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 + ::: masterをpullし直し、インストール、ビルド、データベースのマイグレーションを行います: @@ -156,8 +164,10 @@ sudo systemctl restart misskey ``` :::tip + ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: - `pnpm run clean`または`pnpm run clean-all` - `pnpm rebuild` - ::: + +::: diff --git a/content/fr/docs/3.for-admin/install/guides/ubuntu-manual.md b/content/fr/docs/3.for-admin/install/guides/ubuntu-manual.md index 99b7b42a..f86a16fa 100644 --- a/content/fr/docs/3.for-admin/install/guides/ubuntu-manual.md +++ b/content/fr/docs/3.for-admin/install/guides/ubuntu-manual.md @@ -11,11 +11,15 @@ [**シェルスクリプトの詳細と使用方法はこちらから！**](./bash/) :::tip + シェルスクリプトでの開発環境へのインストールは想定されていません。 + ::: :::tip + ドメインの購入とCloudflareのセットアップ、サーバーの確保についてはご自身でご準備ください。 + ::: 不具合があれば[ @aqz@p1.a9z.dev へのメンション](https://p1.a9z.dev/@aqz)にてお知らせいただければと思います。 @@ -27,7 +31,9 @@ [docker-compose](./docker/)なら、手作業でももうちょっと簡単に実行できるはずです。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: ## はじめに @@ -52,7 +58,9 @@ OSの違い、Misskey本体や依存するソフトウェアのバージョン - ここではドメインをexample.tldとして解説を進めるので、自分が買ったドメインに適宜置き換えて読むこと。開発環境の場合はlocalhostと読み替えます（設定ファイルの項で別途説明） :::danger + 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ + ::: ## nanoの使い方 @@ -78,7 +86,9 @@ sudo adduser --disabled-password --disabled-login misskey ``` :::tip + 開発環境の場合はユーザーを分ける必要はありません + ::: ## 基本的なソフトウェアのインストールと設定 @@ -174,10 +184,12 @@ activeならOK。 ### nginx -nginxは、主としてリバースプロキシに用いられるWebサーバーソフトである。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。 +http\://localhost にアクセスし、\*Welcome to nginx!\*と表示されればOK。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。 :::tip + 開発環境の場合はnginxのセットアップは不要です + ::: nginx.orgのドキュメント http\://nginx.org/en/linux_packages.html#Ubuntu に従ってインストールする。 @@ -238,7 +250,9 @@ sudo apt install -y git build-essential サーバーをインターネットに公開する準備をする。 :::tip + 開発環境の場合はファイヤーウォールやCloudFlare、Certbotの設定は不要です + ::: ### ファイヤーウォール @@ -272,7 +286,9 @@ sudo systemctl enable ufw ``` :::tip + ufwは、netfilter(iptables)を人間が操作しやすいようにするアプリだ。インストールスクリプトは、OCI環境ではnetfilterを直接操作する。 + ::: ### CloudFlare @@ -376,7 +392,9 @@ nano .config/default.yml 設定できる値と記述方法は[.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)に書かれている。 :::tip + 開発環境の場合、urlは`url: http://localhost:3000`と指定します。 + ::: ```yml @@ -469,7 +487,9 @@ NODE_ENV=production pnpm run build ``` :::tip + 開発環境の場合、`NODE_ENV=production`は不要です。以降のコマンドでも同様に削除してください。 + ::: ### サーバーでビルドできない場合 @@ -515,7 +535,9 @@ CloudFlareのDNS設定が正しいIPアドレスになっているかもう一 ## Misskeyのデーモンを作成 :::tip + 開発環境の場合、デーモンの作成は不要です。 + ::: いったんCtrl+Cでプロセスをキルし、Misskeyをデーモンで起動する設定をしよう。 diff --git a/content/fr/docs/3.for-admin/install/resources/cdn.md b/content/fr/docs/3.for-admin/install/resources/cdn.md index 747e4490..030216b8 100644 --- a/content/fr/docs/3.for-admin/install/resources/cdn.md +++ b/content/fr/docs/3.for-admin/install/resources/cdn.md @@ -17,5 +17,7 @@ CDNで以下の設定を行なってください。 - `/api/*`以外のリクエストをすべてキャッシュする :::tip + Misskeyをアップデートした際にキャッシュのクリアは不要です。 + ::: diff --git a/content/fr/docs/3.for-admin/install/resources/troubleshooting.md b/content/fr/docs/3.for-admin/install/resources/troubleshooting.md index d9aff878..202e3705 100644 --- a/content/fr/docs/3.for-admin/install/resources/troubleshooting.md +++ b/content/fr/docs/3.for-admin/install/resources/troubleshooting.md @@ -248,6 +248,10 @@ Amazon S3に互換性のあるオブジェクトストレージであれば利 各サービス/ソフトウェアのドキュメントをよく読み、設定してみてください。 +### ローディングが終わらない + +Cloudflare を使用している場合は、Rocket LoaderやAuto Minifyが有効になっていないか確認してください。有効になっている場合は無効にすることで解決する場合があります。 + *** # まったく解決しなかった場合 diff --git a/content/fr/docs/3.for-admin/moderation-tips/disable-timelines.md b/content/fr/docs/3.for-admin/moderation-tips/disable-timelines.md index 7c11efa2..1a320724 100644 --- a/content/fr/docs/3.for-admin/moderation-tips/disable-timelines.md +++ b/content/fr/docs/3.for-admin/moderation-tips/disable-timelines.md @@ -8,7 +8,9 @@ LTLやSTLは、そのサーバー全員の投稿が見れるため、新規の もしデメリットの方が上回っていると感じたら、それらのタイムラインを無効化することも検討してください。 :::warning + 無効化を行うと、ユーザーが困惑し、短期的に見て利用者が減る可能性があります。そのため、無効化の際は影響を慎重に検討し、事前に説明してフォローを整える期間を一定程度設けることを推奨します。 + ::: なお、管理者/モデレーターは、これらのタイムラインの無効化状態は適用されず、引き続き利用することが可能です。 diff --git a/content/fr/docs/4.for-developers/aiscript.md b/content/fr/docs/4.for-developers/aiscript.md new file mode 100644 index 00000000..2c7c5860 --- /dev/null +++ b/content/fr/docs/4.for-developers/aiscript.md @@ -0,0 +1,67 @@ +# AiScript + +AiScriptは、Misskeyの以下の箇所で使用できるスクリプト言語です。 + +- [プラグイン](./plugin/) +- [ウィジェット](/docs/for-users/features/widgets/) + - ボタン + - AiScriptコンソール + - AiScript App +- Misskey Play +- スクラッチパッド + +:::tip + +AiScriptの実装はMisskeyとは別リポジトリで、[オープンソースで公開されています](https://github.com/aiscript-dev/aiscript)。 + +::: + +## 使い方 + +AiScript標準の構文や組み込み関数などが使用できます。 + +:::tip + +ドキュメントは[こちら](https://github.com/aiscript-dev/aiscript/tree/master/docs)\ +Misskey本体のバージョンにより、使用できるAiScriptのバージョンが異なる場合があります。バージョンの確認には`<: Core:v`をScratchpadなどで実行してください。 + +::: + +これらに加え、Misskey専用の組み込み定数・関数が３グループに分けて提供されています。 + +### Misskey AiScript API + +接頭辞: `Mk:`\ +Misskey内の全てのAiScript環境で使用できる定関数群です。 +詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Mk:`とついた部分を参照して下さい。 + +### プラグインAPI + +接頭辞: `Plugin:`\ +[プラグイン](./plugin/)でのみ使用できる定関数群です。 +詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Plugin:`とついた部分を参照して下さい。 + +### UI API + +接頭辞: `Ui:`\ +[ウィジェット](/docs/for-users/features/widgets/)（AiScript App）、Misskey Play、Scratchpadで使用できます。 +ドキュメントは未整備（TODO）ですが、インターネット上に有志の方が執筆された解説記事があります。 + +### 標準入出力 + +AiScript標準で定義されている`readline`関数と`print`関数（および`<:`構文）の内部実装は、Misskey側で独自に提供されています。 + +#### readline(message) + +`message`: `str`\ +返り値: `str`\ +Misskey内の全てのAiScript環境で使用できます。\ +文字列の入力を求めるポップアップを表示します。 + +#### print(message) + +`message`: `any`\ +返り値: `null`\ +[ウィジェット](/docs/for-users/features/widgets/)（AiScriptコンソール）、Scratchpadで使用できます。\ +コンソールに文字列を出力します。\ +`<:`構文も同様の働きをします。 diff --git a/content/fr/docs/4.for-developers/api/1.index.md b/content/fr/docs/4.for-developers/api/1.index.md index 11ef960c..2d2c988f 100644 --- a/content/fr/docs/4.for-developers/api/1.index.md +++ b/content/fr/docs/4.for-developers/api/1.index.md @@ -8,7 +8,9 @@ MisskeyはAPIを公開しています。APIを使ってMisskeyクライアント ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。 :::tip -Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\ + +Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\\ + ::: diff --git a/content/fr/docs/4.for-developers/api/libraries.md b/content/fr/docs/4.for-developers/api/libraries.md index 18db0f35..ee634623 100644 --- a/content/fr/docs/4.for-developers/api/libraries.md +++ b/content/fr/docs/4.for-developers/api/libraries.md @@ -15,6 +15,8 @@ description: Misskey APIに関連するライブラリの一覧 ## Python - [Misskey.py](https://github.com/YuzuRyo61/Misskey.py) +- [MiPA](https://github.com/yupix/MiPA) +- [MiPAC](https://github.com/yupix/MiPAC) ## .Net diff --git a/content/fr/docs/4.for-developers/api/permission.md b/content/fr/docs/4.for-developers/api/permission.md index 7844a7fe..50dd4be7 100644 --- a/content/fr/docs/4.for-developers/api/permission.md +++ b/content/fr/docs/4.for-developers/api/permission.md @@ -5,7 +5,9 @@ description: アプリケーションが要求する権限の一覧 # 権限の一覧 :::tip + このページは[misskey-js](https://github.com/misskey-dev/misskey/tree/develop/packages/misskey-js)から自動生成しているため、ドキュメントや翻訳が不完全な場合があります。 + ::: diff --git a/content/fr/docs/4.for-developers/api/streaming/1.index.md b/content/fr/docs/4.for-developers/api/streaming/1.index.md index af767dfc..6ce5b5bc 100644 --- a/content/fr/docs/4.for-developers/api/streaming/1.index.md +++ b/content/fr/docs/4.for-developers/api/streaming/1.index.md @@ -5,7 +5,9 @@ description: ストリーミングAPIを使うと、リアルタイムで様々 # ストリーミングAPI :::tip + 最初に[Misskey API](../index.md)のドキュメントを読むことをお勧めします。 + ::: ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、リアクションされた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。 @@ -26,7 +28,9 @@ wss://{host}/streaming?i={token} - `{token}`の部分は、ユーザーのアクセストークンに置き換えます。 :::tip + アクセストークンは省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。 + ::: ストリームに接続すると、後述投稿の購読を行ったりすることができますが、まだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。 @@ -40,7 +44,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。 :::tip + ひとつのストリーム接続上で、同時に複数のチャンネルに接続することができます。 + ::: 以下では、チャンネルの使用方法を説明します。どのようなチャンネルがあるかは、[チャンネル一覧](./channel/index.md)を参照してください。 @@ -69,7 +75,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり - `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。 :::tip + IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。 + ::: ### チャンネルからのメッセージを受け取る diff --git a/content/fr/docs/4.for-developers/api/token.md b/content/fr/docs/4.for-developers/api/token.md index 8f9d3919..d0e74076 100644 --- a/content/fr/docs/4.for-developers/api/token.md +++ b/content/fr/docs/4.for-developers/api/token.md @@ -7,7 +7,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた** アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 :::tip + ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 + ::: あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 @@ -20,7 +22,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた** Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 :::danger + アクセストークンは他人に知られないようにしてください。 + ::: ### アプリケーション利用者にアクセストークンの発行をリクエストする @@ -32,6 +36,7 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app) + ::: #### Step 1 @@ -39,7 +44,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger + このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: #### Step 2 @@ -119,7 +126,9 @@ https://{host}/api/miauth/{session}/check APIの詳細は、APIリファレンスを参照してください。 :::warning + MisskeyはRESTを採用していません。 + ::: また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 diff --git a/content/fr/docs/4.for-developers/api/token/1.index.md b/content/fr/docs/4.for-developers/api/token/1.index.md new file mode 100644 index 00000000..3305efc0 --- /dev/null +++ b/content/fr/docs/4.for-developers/api/token/1.index.md @@ -0,0 +1,88 @@ +# アクセストークンの取得 + +APIを使い始めるには、APIを利用するアカウントに紐づいた**アクセストークン**を取得する必要があります。 +このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。 + +基本的に、APIはリクエストにはアクセストークンが必要となります。 +アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 + +:::tip + +ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 + +::: + +あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 + +- 前者の場合: **「自分自身のアクセストークンを手動発行する」** に進む +- 後者の場合: **「アプリケーション利用者にアクセストークンの発行をリクエストする」** に進む + +## 自分自身のアクセストークンを手動発行する + +Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 + +:::danger + +アクセストークンは他人に知られないようにしてください。 + +::: + +## アプリケーション利用者にアクセストークンの発行をリクエストする + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の方法の一つを使います。 + +:MkIndex + +## APIの利用 + +アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。 + +:::tip + +- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。 +- 要求ヘッダーに`Content-Type: application/json`を指定します。 +- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。 +- ベースURLは`https://{サーバーのドメイン}/api`です。 + +::: + +### Authorization headerを使う方式 + +以下のようにヘッダーの`Authorization`フィールドを指定します。 + +```js +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + text: "Hello Misskey API World with My Application!" + }), + headers: { + Authorization: `Bearer ${accessToken}`, + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` + +### iを使う方式 + +アクセストークン付きのボディの例（metaの場合）: + +```json +{ + "i": "HogEFugA1341", + "detail": false +} +``` + + + +APIの詳細は、APIリファレンスを参照してください。 + +:::warning + +MisskeyはRESTを採用していません。 + +::: + +また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](../streaming/)を参照してください。 diff --git a/content/fr/docs/4.for-developers/api/token/2.miauth.md b/content/fr/docs/4.for-developers/api/token/2.miauth.md new file mode 100644 index 00000000..1100db0d --- /dev/null +++ b/content/fr/docs/4.for-developers/api/token/2.miauth.md @@ -0,0 +1,76 @@ +--- +description: v12.27.0以降で使用できる、Misskey独自の簡素な認証方法について説明しています。 +--- + +# MiAuth方式でのアクセストークン取得方式 + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 + +:::tip + +以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 + +- [よりおおく使われているOAuth方式でのアクセストークン取得方法もあります。](./oauth.md) +- [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app.md) + +::: + +## Step 1 + +UUIDを生成する。以後これを**セッションID**と呼びます。 + +:::danger + +このセッションIDは毎回生成し、使いまわさないようにしてください。 + +::: + +## Step 2 + +アプリケーション認証フォームをユーザーのブラウザで表示させる。認証フォームは、以下の形式のURLで開くことができます: + +``` +https://{host}/miauth/{session} +``` + +ここで、 + +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 +- `{session}`の部分は、セッションIDに置き換えます。 + +また、URLにクエリパラメータとしていくつかのオプションを設定できます: + +| 名前 | 説明 | +| ------------ | ------------------------------------------------------------------------------ | +| `name` | アプリケーション名。 | +| `icon` | アプリケーションのアイコン画像URL。 | +| `callback` | 認証が終わった後にリダイレクトするURL。
リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 | +| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 | + +:::tip{label='例'} + +``` +https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive +``` + +::: + +## Step 3 + +ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 + +``` +https://{host}/api/miauth/{session}/check +``` + +ここで、 + +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。 +- `{session}`の部分は、セッションIDに置き換えます。 + +レスポンスに含まれるプロパティは以下の通りです: + +| 名前 | 説明 | +| ------- | -------------- | +| `token` | ユーザーのアクセストークン。 | +| `user` | ユーザーの情報。 | diff --git a/content/fr/docs/4.for-developers/api/token/3.oauth.md b/content/fr/docs/4.for-developers/api/token/3.oauth.md new file mode 100644 index 00000000..a29644ab --- /dev/null +++ b/content/fr/docs/4.for-developers/api/token/3.oauth.md @@ -0,0 +1,179 @@ +--- +description: v2023.9.0以降で使用できる、OAuth2.0方式での認証方法について説明しています。 +--- + +# OAuth方式でのアクセストークン取得方式 + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 + +:::tip + +以下に説明する方法は、[OAuth 2.0](https://datatracker.ietf.org/doc/html/rfc6749.html)と呼ばれるものです。普通のOAuthはアプリを作成しますが、[IndieAuth](https://indieauth.spec.indieweb.org/)の拡張でアプリ作成なしで使えるようになっています。 + +OAuth方式は使えるライブラリが多いので、出来ればライブラリを使うのをおすすめします。 + +現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。 + +- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md) +- [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md) + +::: + +## Step 1 + +アプリ紹介のためのウェブページを作ります。ページがHTTPSアドレスでアクセスできるようにしてください。ページのとこかに以下のようなHTMLコードを書きます。 + +```html + + + + +
+ My Misskey App +
+``` + +あとで`redirect_uri`のアドレスに認証コードが転送されます。 + +## Step 2 + +PKCE `code_verifier`と`code_challenge`文字列, 及び`state`文字列を生成します。 + +- `code_verifier`の場合は最低43字、最高128字でアルファベット大・小文字及び`-._~`の中の文字に限られます。 +- `code_challenge`文字列は`code_verifier`文字列をSHA256アルゴリズムでハッシュしてbase64urlでエンコードした結果を使います。 +- `state`文字列には特別な制限はありません。ランダムな文字列を使います。 + +:::danger + +この文字列は毎回生成し、使いまわさないようにしてください。 + +::: + +:::tip + +[pkce-challenge](https://www.npmjs.com/package/pkce-challenge)とかのライブラリを使ったり、OAuthライブラリのPKCE機能を使うのがおすすめです。 + +::: + +:::tip{label='例'} + +```js +import crypto from "node:crypto"; + +const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-._~"; +const codeVerifier = new Array(128) + .fill(0) + .map(() => chars[Math.floor(chars.length * Math.random())]) + .join(""); +console.log('code_verifier', codeVerifier); + +const codeChallenge = crypto + .createHash("sha256") + .update(codeVerifier, "ascii") + .digest("base64url"); +console.log('code_challenge', codeChallenge); + +const state = crypto.randomUUID(); +console.log('state', state); +``` + +::: + +## Step 3 + +相手サーバーのOAuth情報を取得します。データはJSON形式になっています。 + +``` +https://{host}/.well-known/oauth-authorization-server +``` + +`{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 + +ここでは`authorization_endpoint`と`token_endpoint`を使います。 + +:::tip + +次のステップで使われる`scope`の情報も`scopes_supported`で確認できます。 + +::: + +## Step 4 + +アプリケーション認証フォームをユーザーのブラウザで表示させます。認証フォームは、以下の形式のURLで開くことができます: + +``` +{authorization_endpoint}?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&scope={scope}&code_challenge={code_challenge}&code_challenge_method=S256&state={state} +``` + +ここで、 + +- `{authorization_endpoint}`の部分は、前の情報取得で得たアドレスに置き換えます。 +- `{client_id}`の部分は、アプリの紹介ページのアドレスに置き換えます。 +- `{code_challenge}`の部分は、前に生成した`code_challenge`文字列に置き換えます +- `code_challenge_method`の部分は常に`S256`にします。 +- `{redirect_uri}`の部分は、紹介ページで使っている配達先のアドレスに置き換えます。 +- `{scope}`の部分は、アプリケーションが要求する権限に置き換えます。要求する権限を` `で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 +- `{state}`の部分は、前に生成した`state`文字列に置き換えます。 + +:::tip{label='例'} + +``` +https://misskey.local/oauth/authorize?client_id=http%3A%2F%2Fexample.com&code_challenge=C6hwMO2bmIzg3nqppTE9b79fvuOjlrKmH2xNiZSMHzw&code_challenge_method=S256&response_type=code&redirect_uri=http%3A%2F%2Fexample.com%2Fredirect&scope=write%3Anotes&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +## Step 5 + +ユーザーがアプリケーションアクセスを許可したら、`redirect_uri`のアドレスに認証コードがURLパラメータの形式で転送されます。 + +| 名前 | 説明 | +| ------- | ----------------------- | +| `code` | ユーザーの認証コード。 | +| `state` | 認証リクエストに使われた`state`文字列。 | + +:::tip{label='例'} + +``` +https://example.com/redirect?code=...&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +`state`文字列がちゃんと一致しているのか確認して、次のステップに進みます。 + +## Step 6 + +転送された認証コードを使ってアクセストークンをPOSTでリクエストします。リクエスト先は`token_endpoint`になります。データ形式は`application/json`と`application/x-www-form-urlencoded`を使えます。各パラメータは以下のようになります。 + +| 名前 | 説明 | +| --------------- | ------------------------------ | +| `grant_type` | 常に`authorization_code`にします。 | +| `client_id` | 認証リクエストに使われた`client_id`文字列。 | +| `redirect_uri` | 認証リクエストに使われた`redirect_uri`文字列。 | +| `scope` | 認証リクエストに使われた`scope`文字列。 | +| `code` | 取得した認証コード。　 | +| `code_verifier` | 前に生成した`code_verifier`文字列。 | + +:::tip{label='例'} + +```js +const res = await fetch(endpoint, { + method: "POST", + body: JSON.stringify({ + grant_type: "authorization_code", + client_id: "https://example.com", + redirect_uri: "https://example.com/redirect", + scope: "write:notes", + code: "...", + code_verifier: "hjjbCYDmDpSLjirkO-PrfWKsRhDdJr-PAEGRClRwzUKlmFIIIrZNmSvUIraeIa~WqbqQnfbJV-Hc_IfuQkesBYUpukUi~lInDfU_AZjoZqbU.ioQTRzaFfZFfGnT-OAA", + }), + headers: { + "Content-Type": "application/json" + } +}); +``` + +::: + +レスポンスはJSONオブジェクト形式で、そこから`access_token`を取得して使います。 diff --git a/content/fr/docs/4.for-developers/plugin/create-plugin.md b/content/fr/docs/4.for-developers/plugin/create-plugin.md index 5e5130ca..cd9bf91e 100644 --- a/content/fr/docs/4.for-developers/plugin/create-plugin.md +++ b/content/fr/docs/4.for-developers/plugin/create-plugin.md @@ -74,4 +74,4 @@ Misskey Webはプラグインに対してAPIを公開していて、それらを v2023.11.0以降では、あなたのウェブサイトからワンクリックでプラグインを直接インストールできるようになっています。 -プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](./publish-on-your-website.md)をご覧ください。 +プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](../publish-on-your-website.md)をご覧ください。 diff --git a/content/fr/docs/5.releases.md b/content/fr/docs/5.releases.md index b7879489..17c4324b 100644 --- a/content/fr/docs/5.releases.md +++ b/content/fr/docs/5.releases.md @@ -6,6 +6,49 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2023.12.2 + +リリース日: 2023/12/28 + +### General + +- v2023.12.1でDockerを利用してサーバーを起動できない問題を修正 + +### Client + +- Enhance: 検索画面においてEnterキー押下で検索できるように + +## 2023.12.1 + +リリース日: 2023/12/27 + +### Note + +- アクセストークンの権限が再整理されたため、一部のAPIが古いAPIトークンでは動作しなくなりました。\ + 権限不足になる場合には権限を再設定して再生成してください。 + +### General + +- Enhance: ローカリゼーションの更新 +- Fix: 自分のdirect noteがuser list timelineに追加されない + +### Client + +- Feat: AiScript専用のMFM構文`$[clickable.ev=EVENTNAME ...]`を追加。`Mk:C:mfm`のオプション`onClickEv`に関数を渡すと、クリック時に`EVENTNAME`を引数にして呼び出す +- Enhance: MFM入力補助ボタンを投稿フォームに表示できるように #12787 +- Fix: 一部のモデログ(logYellowでの表示対象)について、表示の色が変わらない問題を修正 +- Fix: `fg`/`bg`MFMに長い単語を指定すると、オーバーフローされずはみ出る問題を修正 + +### Server + +- Enhance: センシティブワードの設定がハッシュタグトレンドにも適用されるようになりました +- Enhance: `oauth/token`エンドポイントのCORS対応 +- Fix: 1702718871541-ffVisibility.jsのdownが壊れている +- Fix:「非センシティブのみ（リモートはいいねのみ）」を設定していても、センシティブに設定されたカスタム絵文字をリアクションできる問題を修正 +- Fix: ロールアサイン時の通知で，ロールアイコンが縮小されずに表示される問題を修正 +- Fix: サードパーティアプリケーションがWebsocket APIに無条件にアクセスできる問題を修正 +- Fix: サードパーティアプリケーションがユーザーの許可なしに非公開の情報を見ることができる問題を修正 + ## 2023.12.0 リリース日: 2023/12/23 @@ -1957,7 +2000,9 @@ same as 12.112.0 ### NOTE :::warning + このバージョンからNode v16.14.0以降が必要です + ::: ### Changes @@ -2069,12 +2114,16 @@ same as 12.112.0 ### Note :::warning + ビルドする前に`npm run clean`を実行してください。 + ::: :::warning + このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 + ::: ### Improvements @@ -2145,6 +2194,7 @@ same as 12.112.0 アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。 12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。 + ::: ### Changes diff --git a/content/id/docs/1.about-misskey.md b/content/id/docs/1.about-misskey.md index a67dba09..fa407191 100644 --- a/content/id/docs/1.about-misskey.md +++ b/content/id/docs/1.about-misskey.md @@ -1,150 +1,128 @@ --- ignoreDirBasedNav: true -description: Misskeyについてのドキュメントです。 +description: Dokumentasi mengenai Misskey. --- -# Misskeyについて +# Tentang Misskey -Misskeyはオープンソースの分散型マイクロブログプラットフォームプロジェクトです。 -開発は日本でsyuiloによって2014年から開始されました。 -ドライブ、リアクションなどの豊富な機能や、高いカスタマイズ性を備えたUIを持つことが特徴です。 +Misskey merupakan platform mikroblog sumber terbuka dan terfederasi. Pengembangannya dimulai pada tahun 2014 oleh syuilo di Jepang. Terdapat fitur berlimpah seperti Drive atau Reaksi dan juga antarmuka yang sangat bisa diubah suaikan. -## 歴史 +## Sejarah -開発当初は掲示板がメインのサービスでしたが、ユーザーが短文を投稿し、それを時系列で流れるタイムライン機能を追加したところ人気が高まり、徐々にそれがメインとして開発が進むようになりました。 -当初は分散型ではありませんでしたが、2018年にActivityPubを実装し分散型になったことで、より多くの方に認知され利用されるサービスになり、現在に至ります。 +Saat Misskey dimulai dari Papan Buletin sebagai fitur utamanya, pertumbuhan popularitas karena tambahan linimasa yang mengizinkan pengguna mengirim pesan pendek dan melihatnya secara urut waktu membuat pergeseran fokus pengembangan ke arah fungsionalitas tersebut. Saat itu, Misskey bukanlah layanan terdesentralisasi. Tetapi setelah mengadopsi ActivityPub pada tahun 2018, hal tersebut menjadikan Misskey sebagai layanan terdesentralisasi. Dimulai dari sana, Misskey akhirnya dikenal dan digunakan oleh banyak orang. :::tip -Misskeyという名前は、syuiloが当時聴いていたMay'nというアーティストの楽曲、Brain Diverの歌詞に由来します。 + +Nama "Misskey" berasal dari lagu berjudul "Brain Diver" oleh band bernama May'n yang syuilo dengarkan saat itu. + ::: -誰でも開発に参加することができ、現在でも活発に開発が続いています。 +Siapapun juga dapat bergabung ikut mengembangkan, pengembangan Misskey sendiri masih terus berlanjut hingga sekarang. -## 分散型とは何か？ +## Apa yang dimaksud dengan "Terdesentralisasi"? -分散(distributed)型とは、非中央集権(decentralized)とも呼ばれ、コミュニティが多数のサーバーに分散して存在し、それらが相互に通信(連合、federation)することでコンテンツ共有ネットワーク(Fediverse)を形成していることが特徴のサービスです。 -単一のサーバーしか存在しない、もしくは複数存在しても互いに独立している場合は中央集権なサービスと言われ、例えばTwitterやFacebookなどほとんどのサービスがそれに該当します。 -分散型のメリットは、自分に合った運営者やテーマのサーバーを選択できることです。自分でサーバーを作成することもできます。連合するおかげで、どのサーバーを選んでも、同じコミュニティにアクセスできます。 +Terdesentralisasi, merujuk pada layanan yang fiturnya membagi komunitas ke dalam banyak peladen yang dapat saling berkomunikasi (federasi) untuk membagikan konten, membangun jaringan (Fediverse). Layanan yang hanya terdapat satu peladen, disebut sebagai tersentralisasi. Kebanyakan layanan masuk kategori tersentralisasi, termasuk Twitter atau Facebook. Manfaat dari layanan terdistribusi adalah kamu dapat memilih administrator atau tema peladen sesuai keinganan.Bisa juga kamu membuat peladen sendiri.Terima kasih kepada sifat alamiah desentralisasi, kamu dapat mengakses komunitas yang sama, tidak peduli server mana yang kamu pilih. -## 常にオープンソース +## Selalu sumber-terbuka -Misskeyはこれまでもこれからも、オープンソースであり続けます。オープンソースとは、簡単に言うとソフトウェアのソースコード(プログラム)が公開されていることです。ソースコードの修正や再配布が可能であることを定義に含めることもあります。 -Misskeyのすべてのソースコードは[AGPL](https://github.com/misskey-dev/misskey/blob/develop/LICENSE)というオープンソースライセンスの下に[公開](https://github.com/misskey-dev)されていて、誰でも自由に閲覧、使用、修正、改変、再配布をすることができます。 -オープンソースは、自分で好きなように変えたり、有害な処理が含まれていないことを確認することができたり、誰でも開発に参加できるなどの、様々なメリットがあります。 -上述の分散型を実現するためにも、オープンソースであるということは必要不可欠な要素です。 -再び引き合いに出しますが、TwitterやFacebookなどの利益を得ているほとんどのサービスはオープンソースではありません。 +Misskey akan selalu menjadi perangkat lunak sumber terbuka.Artinya, secara sederhana, kode sumber perangkat lunak (program) Misskey tersedia dan dapat diakses secara publik.Ini juga termasuk kemampuan untuk menyesuaikan atau mendistribusikan kembali kode sumber sesuai definisi. Seluruh kode sumber Misskey [dilisensikan](https://github.com/misskey-dev) di bawah lisensi sumber terbuka [AGPL](https://github.com/misskey-dev/misskey/blob/develop/LICENSE), artinya siapa saja bebas menginspeksi, menggunakan, menyesuaikan, mengubah, atau mendistribusikan ulang jika memang sesuai. Sumber terbuka memiliki banyak kemampuan, termasuk mengizinkan siapa pun mengubah sesuai keinginan, untuk memastikan kode tidak menyertakan komponen berbahaya dan memudahkan orang berpartisipasi dalam pngembangannya. Untuk merealisasikan sifat alamiah terdistribusi Misskey, konsep sumber terbuka ini sangat diperlukan. Menggunakan contoh yang sama seperti sebelumnya, kebanyakan layanan berorientasi profit seperti Twitter, Facebook, dll bukanlah sumber terbuka. :::tip -技術的に言うと、MisskeyのソースコードはGitで管理されていて、リポジトリは[GitHub上でホスティングされています。](https://github.com/misskey-dev) + +Secara teknis, kode sumber Misskey dikelola via Git, dan repositorinya disimpan di [GitHub](https://github.com/misskey-dev). + ::: -## 開発に参加する、プロジェクトを支援する +## Bergabung di pengembangan dan mendukung proyek -Misskeyを気に入っていただけたら、ぜひプロジェクトを支援してください。プロジェクトに貢献するには、以下で紹介するようにいろいろな方法があります。方法によっては開発のスキルは不要なので、誰でも気軽に参加し貢献することができます。いつでもお待ちしています。 +Jika kamu menyukai Misskey, harap dukung proyek ini.Mendukung proyek dapat dilakukan dengan banyak cara, beberapa di antaranya seperti di bawah ini.Beberapa tidak membutuhkan keahlian pemrograman, jadi siapa saja dapat mendukung Misskey dengan caranya sendiri.Kami selalu menunggu dukunganmu. -### 機能を追加したり、バグを修正する +### Menambahkan fitur atau memperbaiki bug -ソフトウェアエンジニアのスキルをお持ちの方であれば、ソースコードを編集する形でプロジェクトに貢献することができます。 -貢献についてのガイドは[こちら](https://github.com/misskey-dev/misskey/blob/develop/CONTRIBUTING.md)です。 +Jika kamu memiliki keahlian rekayasa perangkat lunak, kamu dapat berkontribusi dengan mengedit kode sumbernya. Sebagai panduan dari cara ini, silakan lihat [di sini](https://github.com/misskey-dev/misskey/blob/develop/CONTRIBUTING.md). -### 議論に参加する +### Berpartisipasi dalam diskusi -新しい機能、または既存の機能について意見を述べたり、不具合を報告したりすることでも貢献できます。 -そのようなディスカッションは[GitHub](https://github.com/misskey-dev)上か、[フォーラム](https://forum.misskey.io/)等で行われます。 +Kamu dapat berkontribusi dengan membagikan opinimu pada fitur baru atau fitur yang sudah ada, dan juga melaporkan bug. Diskusi ini dapat dilakukan di [GitHub](https://github.com/misskey-dev), di [Forum](https://forum.misskey.io/), atau di tempat lain. -### テキストを翻訳する +### Menerjemahkan teks -Misskeyは様々な言語に対応しています(i18n -internationalizationの略- と呼ばれます)。元の言語は基本的に日本語ですが、有志によって他の言語へと翻訳されています。 -その翻訳作業に加わっていただくことでもMisskeyに貢献できます。 -Misskeyは[Crowdinというサービスを使用して翻訳の管理を行っています。](https://crowdin.com/project/misskey) +Misskey tersedia dalam banyak bahasa (atau dijuluki dengan i18n, singkatan dari Internationalization).Meskipun bahasa asalnya merupakan bahasa Jepang, sukarelawan dapat menerjemahkan Misskey ke bahasa lainnya. Membantu penerjemahan juga merupakan sebuah bentuk kontribusi. Misskey menggunakan layanan [Crowdin](https://crowdin.com/project/misskey) untuk mengelola penerjemahannya. -### 感想を投稿する +### Membagikan kesanmu -不具合報告等だけではなく、Misskeyの良い点、楽しい点といったポジティブな意見もぜひ共有してください。開発の励みになり、それは間接的ですがプロジェクトへの貢献です。 +Di samping melaporkan bug, silakan bagikan kesan positif seperti bagian Misskey yang kamu sukai, atau apa pun tentang Misskey yang membuatmu senang.Kesan-kesan seperti ini memberikan motivasi kepada pengembang, dan itu terhitung mendukung proyek secara tidak langsung. -### ミスキストを増やす +### Meningkatkan jumlah Misskist -ミスキストとは、Misskeyを使用する人のことです。 -知り合いに紹介するなどしてMisskeyを広めていただければ、ミスキストが増え開発のモチベーションが上がります。 +"Misskist" merujuk pada orang yang menggunakan Misskey. Dengan menyebarkan kabar seputar Misskey lewat pengenalan kepada kenalanmu, jumlah Misskist mungkin saja naik, yang bakal menjadi motivasi pengembang. -### 寄付をする +### Berdonasi -[こちらをご覧ください](/docs/for-users/resources/donate/) +[Silakan lihat ini](/docs/for-users/resources/donate/) -## よくある質問 +## Pertanyaan Sering Diajukan -### プロジェクトは何を目指していますか？ +### Apa tujuan yang ingin dicapai dalam proyek ini? -強いて言うと、漠然的になりますが広く使われる汎用的なプラットフォームになることを目指しています。 -Misskeyは他のプロジェクトとは違い、何らかの思想(例えば、反中央集権)やビジョンに基づいて開発が行われているわけではなく、その点ではフラットです。 -それが逆に、特定の方向性に縛られないフレキシブルさを生み出すことに繋がっていると感じています。 +Terus terang saja, meski sedikit agak kabur, Misskey bertujuan dipakai lebih banyak orang sebagai platform umum. Tidak seperti platform lain, Misskey tidak didasari oleh visi atau gagasan khusus (contohnya, anti-sentralisasi) dan dikembangkan dengan prinsip seperti itu, jadi sebetulnya ia "tidak memiliki tujuan". Di lain makna, prinsip tersebut menciptakan fleksibilitas karena tidak terikat dengan arah tujuan spesifik. -### 企業によって開発されていますか？ +### Apakah Misskey dikembangkan oleh perusahaan? -いいえ。Misskeyの開発は個人で行われており、商業的でもないため、特定の企業の関りはありません。 -開発メンバーも基本的にはボランティアです。 -また、開発に対し企業のスポンサーがつくこともありますが、その場合でもやはり開発は個人のコミュニティが主体です。 +Tidak.Misskey dikembangkan oleh perorangan dan tidak dikomersialisasi melalui hubungan dengan perusahaan tertentu. Anggota pengembangan umumnya adalah sukarelawan. Sebagai tambahan, ada beberapa sponsor perusahaan, tapi pengembangan masih terpusat di tengah komunitas. -### 誰が運営していますか？ +### Siapa yang mengelola Misskey? -Misskeyは分散型なため、各サーバーにそれぞれ異なった運営者がいます。従って、特定の個人や企業によって、Misskeyの全てが運営されているわけではありません。 -また、開発チームが運営を行うわけでもないため、運営に関する連絡は、お使いのサーバーの運営者に行ってください。 -サーバーの運営者は、サーバーの情報ページで確認することができます。 -あなたがサーバーを作成すれば、あなたが運営者になります。 +Karena sifat alamiah Misskey yang terdesentralisasi, setiap peladen memiliki administratornya sendiri.Karena itu, tidak semua Misskey dikelola oleh seseorang atau sebuah perusahaan. Artinya, tim pengembangan tidak mengendalikan server individu, untuk menanyakan hal seputar pengelolaan, kamu harus menghubungi administrator servermu. Kamu dapat memverifikasi siapa saja pengelola server di halaman ini. Jika kamu membuat server Misskey, maka kamulah yang menjadi administratornya. -### どのサーバーを選べばいいですか？ +### Peladen mana yang seharusnya aku pilih? -[サーバー一覧が公開されています。](/servers/) -サーバーによってコミュニティのテーマ(特定のこと、ものが好き 等)が決められている場合があるので、自分に合ったテーマのサーバーがあれば、そこを選ぶと良いかもしれません。 -他にも、サーバーの規模、ユーザー層、国および言語、運営者が信頼できるかどうか、などの観点があります。 -なお、Misskey公式のサーバーというものはありません。自身で新しくサーバーを作成するという選択肢もあります。 +[Kamu dapat menemukan daftar peladen di sini](/servers/). +Tergantung peladennya, komunitas atau tema beragam (contohnya, tentang menyukai acara tertentu), jadi bila terdapat peladen yang cocok dengan ketertarikanmu, bergabung di sana merupakan pilihan yang tepat. Di samping itu, ukuran peladen, basis pengguna, negara atau berbahasa sama, ketergantungan atau kepercayaan terhadap tim administrator, dan lainnya juga dapat termasuk sebagai kriteria. Jadi, tidak ada peladen tunggal yang menjadi peladen resmi Misskey.Kamu juga memiliki pilihan untuk membangun sendiri peladen baru. -基本的にどのサーバーを選んだとしても、他の全てのサーバーのユーザーと繋がることができます。 +Pokoknya, tidak peduli peladen mana tempatmu bergabung, kamu akan tetap dapat terkoneksi dengan orang-orang dari peladen lainnya. -### サーバーを建てるにはどうしたらいいですか？ +### Bagaimana cara membuat peladen sendiri? -Misskeyサーバーの作成に興味を持っていただきありがとうございます。 -2022年現在、Misskeyのホスティングサービスは存在しないため、サーバーの作成にはある程度の知識が必要です。 -サーバーの作成方法については[こちら](/docs/for-admin/install/)をご覧ください。 +Terima kasih sudah tertarik membuat server Misskey. Hingga saat ini, belum ada layanan hosting Misskey khusus, jadi untuk membuat server baru memerlukan beberapa pengetahuan. Silakan lihat [di sini](/docs/for-admin/install/) untuk membaca lebih banyak informasi tentang ini. -### どのような技術を使用していますか？ +### Teknologi apa saja yang Misskey gunakan? -Misskeyは開発が進むにつれ使用する技術も大きく変わってきました。開発当初はMySQL + PHP + jQueryといった構成でしたが、現在は以下のようになっています。 +Mengingat pengembangan Misskey terus berlanjut, teknologi yang digunakan berubah-ubah.Pada awalnya, Misskey menggunakan kombinasi MySQL + PHP + jQuery, tetapi sekarang menggunakan teknologi di bawah ini. -- サーバーサイド: Node.js -- データベース: PostgreSQL、Redis -- UIフレームワーク: Vue.js -- プログラミング言語: TypeScript +- Peladen: Node.js +- Basis data: PostgreSQL, Redis +- Kerangka kerja antarmuka: Vue.js +- Bahasa Pemrograman: TypeScript -また、MFMやAiScriptなどの、Misskeyから派生して独自の技術も開発しています。 +Sebagai tambahan, Misskey juga menggunakan teknologi turunan seperti MFM atau AiScript. -### Mastodonのフォークですか？ +### Apakah ini fork dari Mastodon? -いいえ。MisskeyはMastodonやその他のプロジェクトとは全く別のプロジェクトです。 -開発に関しても、Misskeyの方が昔から開発されています。ただし、分散型になったのはMastodonの登場より後です。 -同じActivityPubという分散のためのプロトコルを実装しているという点以外、両者に特に関りがあるわけでもありません。 +Bukan.Misskey adalah proyek yang benar-benar sangat berbeda dari Mastodon atau proyek serupa lainnya dan sudah dikembangkan sejak lama.Namun setelah kemunculan Mastodon, Misskey akhirnya menjadi jaringan terdesentralisasi. Kedua proyek memang sama-sama menerapkan protokol ActivityPub, tapi sama sekali tidak memiliki hubungan antar satu sama lain. -### iOS/Androidのアプリはありますか？ +### Apakah ada aplikasi untuk iOS / Android tersedia? -公式にはそういったOSのネイティブアプリを開発していませんが、サードパーティ製のアプリがいくつかあります。 -詳しくは[こちら](/docs/for-users/resources/apps/)をご覧ください。 +Tidak ada aplikasi Misskey resmi yang eksis untuk kedua sistem operasi, tapi ada yang menyediakan aplikasi pihak ketiga. Rincinya, silakan lihat [di sini](/docs/for-users/resources/apps/). -ただ、サードパーティ製アプリはどうしても機能への対応が遅れてしまうため、とくに拘りがなければ公式のWebクライアントの利用をおすすめします。 -なお、MisskeyのWebクライアントはPWAに対応しているので、ネイティブアプリのように動作させることも可能です。 +Bagaimana pun, fungsionalitas aplikasi pihak ketiga akan tertinggal dari klien Web resmi, kecuali kamu benar-benar ingin sekali menggunakan aplikasi murni, kami sarankan untuk menggunakan klien web resmi. Karena klien Web Misskey mendukung PWA, jadi sangat mungkin menjadikannya seperti aplikasi murni. -### Misskeyのロゴ、アイコンはどこで入手できますか？ +### Dimana aku dapat mengunduh logo atau ikon Misskey? -[こちら](/brand-assets/) +Silakan rujuk ke [koleksi aset](/brand-assets/). -### 時折目にする猫耳の可愛い女の子は？ +### Siapa gadis imut bertelinga kucing yang sering muncul di Misskey? -:::fukidashi{chara="doya_ai" charaName="藍"} +:::fukidashi{chara="doya_ai" charaName="藍(Ai)"} + +Kalo mau tau lebih jauh tentang aku, lihat dan kunjungi aku ke [situs ini](https://xn--931a.moe/)! -わたしについては[このホームページ](https://xn--931a.moe/)をご覧ください！ ::: -:::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"} -Misskeyの守り神、藍ちゃんです。ｱｲﾁｬﾝｶﾜｲｲﾔｯﾀｰ! +:::fukidashi{chara="syuilo" charaName="しゅいろ(syuilo)" direction="right"} + +Dia adalah dewa penjaga Misskey, Ai.(Yooot, mereka menganggap Ai lucu!) + ::: diff --git a/content/id/docs/2.for-users/2.onboarding/2.get-started.md b/content/id/docs/2.for-users/2.onboarding/2.get-started.md index aa4d1522..69e63d26 100644 --- a/content/id/docs/2.for-users/2.onboarding/2.get-started.md +++ b/content/id/docs/2.for-users/2.onboarding/2.get-started.md @@ -11,14 +11,17 @@ Misskeyを利用するには、どこかのサーバーにアカウントを作 [サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。 :::tip + どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 :::g-details{summary='詳細'} + Misskeyには連合機能が備わっています。 連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。 Misskeyが搭載している連合機能はActivityPubというオープンな共通規格に基づいていて、MastodonやPleromaといったほかのソフトウェアとも互換性があります。 + ::: ::: @@ -31,5 +34,7 @@ Misskeyが搭載している連合機能はActivityPubというオープンな 自分にあったテーマのサーバーを探すのもおすすめです。 :::tip + サーバーの一覧は[こちら](/servers/)からご覧いただけます。 + ::: diff --git a/content/id/docs/2.for-users/2.onboarding/3.join-server.md b/content/id/docs/2.for-users/2.onboarding/3.join-server.md index 6f42c0c1..7c26053a 100644 --- a/content/id/docs/2.for-users/2.onboarding/3.join-server.md +++ b/content/id/docs/2.for-users/2.onboarding/3.join-server.md @@ -3,9 +3,11 @@ 登録するサーバーが決まったら、さっそくアカウントを作成しましょう。 :::tip + ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 ただし、入力事項はサーバーによって異なることがあります。詳しくは、サーバー管理者にお問い合わせください。 + ::: ## 登録する diff --git a/content/id/docs/2.for-users/2.onboarding/4.things-to-know.md b/content/id/docs/2.for-users/2.onboarding/4.things-to-know.md index e77c9aa2..d5428ffb 100644 --- a/content/id/docs/2.for-users/2.onboarding/4.things-to-know.md +++ b/content/id/docs/2.for-users/2.onboarding/4.things-to-know.md @@ -7,7 +7,9 @@ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一般的なSNSに比べたくさんの機能がありますので、初めての投稿を行う前に必ず確認して、上手に投稿しましょう！ :::tip + 詳細は、「[ノート](/docs/for-users/features/note/)」をご覧ください。 + ::: ## タイムライン @@ -15,7 +17,9 @@ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一 Misskeyは、複数のタイムラインを持っています。名前だけでは少々わかりにくいかと思いますので、それぞれがどのような働きをするのかを知っておきましょう。 :::tip + 詳細は、「[タイムライン](/docs/for-users/features/timeline/)」をご覧ください。 + ::: ## その他 diff --git a/content/id/docs/2.for-users/3.features/1.index.md b/content/id/docs/2.for-users/3.features/1.index.md index fa6a44f4..18e56a90 100644 --- a/content/id/docs/2.for-users/3.features/1.index.md +++ b/content/id/docs/2.for-users/3.features/1.index.md @@ -1,9 +1,9 @@ --- -description: Misskeyの大きな特徴である、多彩な機能について解説しています。 +description: Kami akan menjeleskan beberapa banyak fungsi yang menjadi fitur utama dari Misskey. --- -# さまざまな機能 +# Fitur -Misskeyの大きな特徴は、ほかのマイクロブログシステムには見られない多彩な機能にあります。ここでは、それらについて解説していきます。 +Karakteristik utama dari Misskey adalah beberapa fiturnya yang tidak dimiliki oleh sistem mikroblog lain.Kami akan menjelaskan fitur-fitur tersebut beserta fungsinya di sini. diff --git a/content/id/docs/2.for-users/3.features/ads.md b/content/id/docs/2.for-users/3.features/ads.md index 456c5790..b53bd4b4 100644 --- a/content/id/docs/2.for-users/3.features/ads.md +++ b/content/id/docs/2.for-users/3.features/ads.md @@ -1,13 +1,13 @@ -# 広告 +# Iklan -Misskeyではサーバーによる広告をタイムラインなどに表示できる機能があります。 -広告の右上に表示されるアイコンをクリックすることで、当該の広告の表示頻度を下げることができます。 +Misskey dapat menampilkan iklan di dalam lini masa instansi dan tempat lainnya apabila diaktifkan oleh administrator instansi. Kamu dapat mengurangi seberapa sering iklan akan dimunculkan dengan mengeklik di bagian pojok kanan dari iklan. :::tip -広告の総数が少ない場合は、表示頻度を下げた後も連続で表示される可能性があります。 + +Jika angka total dari iklan ditampilkan dari instansi lebih kecil, maka iklan kemungkinan akan tetap ditampilkan sering kepada kamu meskipun kamu telah memilih untuk mengurangi seberapa sering iklan dimunculkan. + ::: -## 広告の設定(管理者) +## Mengatur Iklan (Admin) -サーバーのコントロールパネルから広告の追加、編集、削除を行えます。 -広告には任意の画像、遷移先URL、形状、表示割合を設定できます。 +Kamu dapat menambahkan, menyunting, dan menghapus iklan dari panel kendali instansi kamu. Dalam bilah panel tersebut kamu dapat mengatur gambar, URL tujuan, bentuk, dan presentasi penampilan untuk iklan. diff --git a/content/id/docs/2.for-users/3.features/antenna.md b/content/id/docs/2.for-users/3.features/antenna.md index 26f6de1e..1a22db96 100644 --- a/content/id/docs/2.for-users/3.features/antenna.md +++ b/content/id/docs/2.for-users/3.features/antenna.md @@ -1,5 +1,5 @@ -# アンテナ +# Antena -アンテナは、自由に条件を設定して、合致するノートを自動で収集することができる機能です。 +Antena merupakan fitur yang memperbolehkanmu mengatur kondisi set secara bebas untuk lini masa kustom dan secara otomatis mengumpulkan catatan yang cocok. -条件を設定したアンテナが作成された状態で、条件に合致するノートが投稿されると、リアルタイムでそのアンテナのタイムラインにノートが追加されます。 +Kondisi antena bisa termasuk kondisi untuk mencakup/mengecualikan kata kunci tertentu dan tag dalam kombinasi berbeda serta opsi lainnya. Ketika catatan yang diposting cocok dengan sebuah kondisi antena, catatan akan ditambahkan secara otomatis ke dalam lini masa antena tersebut. diff --git a/content/id/docs/2.for-users/3.features/charts.md b/content/id/docs/2.for-users/3.features/charts.md index dbbd9bbb..5f937030 100644 --- a/content/id/docs/2.for-users/3.features/charts.md +++ b/content/id/docs/2.for-users/3.features/charts.md @@ -1,74 +1,73 @@ -# チャート +# Bagan -Misskeyはサーバーの様々なデータソースに対するチャートを生成し表示する機能を備えています。 -チャートを利用することで、サーバーの利用状況や連合の状況、各ユーザーのアクティビティなどを視覚的に把握することができます。 +Misskey dapat menghasilkan dan menampilkan bagan untuk sumber data berbagai instansi yang terfederasi. Bagan memungkinkan kamu untuk mendapatkan representasi gambaran dari penggunaan, status federasi, dan aktivitas setiap pengguna. -サーバーのチャートはサーバー情報ページから表示することができます。 +Bagan instansi dapat dilihat dari halaman informasi instansi (dapat diakses dengan mengeklik logo instansi dalam menu navigasi). -以下は各チャートとその各項目の説明です。 +Berikut di bawah ini merupakan deskripsi dari setiap bagan dan isinya. -## 連合チャート +## Bagan Federasi -連合しているサーバー化ついてのチャートです。 +Bagan ini menampilkan informasi tentang instansi yang terfederasi. ### Pub -アクティビティを配送しているサーバーの数。 -言い換えると、自サーバーのユーザーをフォローしているリモートユーザーの所属サーバーのユニークなカウントを表します。 +Jumlah instansi luar yang menerima aktivitas publikasi dari instansi ini. +Dengan kata lain, menampilkan angka dari pengguna instansi luar unik yang mengikuti pengguna dari instansi sendiri. ### Sub -アクティビティを受信しているサーバーの数。 -言い換えると、自サーバーのユーザーがフォローしているリモートユーザーの所属サーバーのユニークなカウントを表します。 +Jumlah instansi luar yang mempublikasikan aktivitasnya ke instansi ini. +Dengan kata lain, menampilkan angka dari pengguna instansi luar unik dari instansi peladen luar yang diikuti oleh pengguna dari instansi sendiri. ### Received -アクティビティを送ってきたサーバーの数。 +Jumlah instansi yang telah mengirim aktivitasnya ke instansi ini. ### Delivered -アクティビティを配送したサーバーの数。 +Jumlah instansi yang menerima aktivitas dari kiriman instansi ini. ### Stalled -アクティビティを配送する際、エラーになったサーバーの数。 +Jumlah instansi dimana kesalahan ditemukan ketika mengirimkan aktivitas. -## アクティブユーザー数チャート +## Bagan Pengguna Aktif -自サーバーのユーザーの利用状況についてのチャートです。 +Bagan dari aktivitas pengguna pada instansi ini. ### Read & Write -閲覧と書き込みを行ったユーザーの数。 +Jumlah pengguna yang telah melihat dan menulis konten. ### Read -閲覧を行ったユーザーの数。 +Jumlah pengguna yang telah melihat konten. ### Write -書き込みを行ったユーザーの数。 +Jumlah pengguna yang telah menulis konten. ### < Week -閲覧を行ったユーザーのうち、アカウント作成日時が1週間未満であるユーザーの数。 +Jumlah pengguna yang telah melihat konten dan umur akunnya kurang dari satu minggu. ### < Month -閲覧を行ったユーザーのうち、アカウント作成日時が1ヶ月未満であるユーザーの数。 +Jumlah pengguna yang telah melihat konten dan umur akunnya kurang dari satu bulan. ### < Year -閲覧を行ったユーザーのうち、アカウント作成日時が1年未満であるユーザーの数。 +Jumlah pengguna yang telah melihat konten dan umur akunnya kurang dari satu tahun. ### > Week -閲覧を行ったユーザーのうち、アカウント作成日時が1週間以上前であるユーザーの数。 +Jumlah pengguna yang telah melihat konten dan umur akunnya lebih dari satu minggu. ### > Month -閲覧を行ったユーザーのうち、アカウント作成日時が1ヶ月以上前であるユーザーの数。 +Jumlah pengguna yang telah melihat konten dan umur akunnya lebih dari satu bulan. ### > Year -閲覧を行ったユーザーのうち、アカウント作成日時が1年以上前であるユーザーの数。 +Jumlah pengguna yang telah melihat konten dan umur akunnya lebih dari satu tahun. diff --git a/content/id/docs/2.for-users/3.features/clip.md b/content/id/docs/2.for-users/3.features/clip.md index 3a307c95..15685439 100644 --- a/content/id/docs/2.for-users/3.features/clip.md +++ b/content/id/docs/2.for-users/3.features/clip.md @@ -1,8 +1,7 @@ -# クリップ +# Klip -クリップは、複数のノートをまとめることができる機能です。自分のノート・他者のノートは問いません。 -クリップは複数作ることができ、それぞれに名前や説明を設定して管理することが可能です。また、クリップを他のユーザーに公開するかどうかも選択することができます。 +Klip merupakan fitur yang memperbolehkanmu untuk membuat koleksi dari sebuah catatan.Catatan tersebut bisa dari yang kamu buat ataupun orang lain yang membuatnya. Kamu dapat membuat banyak klip dan mengelolanya dengan memberikan nama serta deskripsi masing-masing.Kamu juga dapat memilih untuk membuat klipmu menjadi publik agar dapat dilihat oleh pengguna lain. -クリップを作るには、クリップ管理ページから「追加」をクリックします。 +Untuk membuat klip, klik "Tambah" pada halaman kelola klip. -クリップにノートを追加するには、対象のノートのメニューから「クリップ」をクリックし、追加先のクリップを選択します。 +Untuk menambahkan catatan ke dalam klip, pilih opsi "Klip" pada menu catatan. Lalu pilih salah satu klip untuk menambahkan catatan tersebut ke dalam klip. diff --git a/content/id/docs/2.for-users/3.features/custom-emoji.md b/content/id/docs/2.for-users/3.features/custom-emoji.md index 78b0c6b6..ef704eab 100644 --- a/content/id/docs/2.for-users/3.features/custom-emoji.md +++ b/content/id/docs/2.for-users/3.features/custom-emoji.md @@ -1,8 +1,5 @@ -# カスタム絵文字 +# Emoji kustom -カスタム絵文字は、サーバーで用意された画像を絵文字のように使える機能です。 -ノート、リアクション、チャット、自己紹介、名前などの場所で使うことができます。 -カスタム絵文字をそれらの場所で使うには、絵文字ピッカーボタン(ある場合)を押すか、`:`を入力して絵文字サジェストを表示します。 -テキスト内に`:foo:`のような形式の文字列が見つかると、`foo`の部分がカスタム絵文字名と解釈され、表示時には対応したカスタム絵文字に置き換わります。 +Emoji Kustom merupakan fitur yang dapat membolehkan kamu untuk menggunakan gambar apapun yang disediakan oleh instansimu sebagai emoji. Kamu dapat menggunakan emoji tersebut di tempat seperti catatan, reaksi, obrolan, profil kamu, nama kamu, dll. Untuk menggunakan emoji kustom di salah satu tempat tersebut, tekan tombol pemilih emoji (jika tersedia) atau ketik `:` untuk menampilkan saran emoji. Jika string dari bentuk `:foo:` ditemukan dalam teks, bagian `foo` akan diinterpretasikan sebagai nama emoji kustom dan akan digantikan dengan emoji kustom terkait ketika ditampilkan. -サーバーにどのようなカスタム絵文字が用意されているかは、Misskey Webの **サーバー情報** にある [**カスタム絵文字**](x-mi-web://about#emojis) にアクセスすると見ることができます。 +Kamu dapat melihat emoji kustom mana yang tersedia pada instansimu dengan mengunjungi menu [**emoji kustom**](x-mi-web://about#emojis) pada **informasi instansi** dari web instansi peladen Misskey kamu. diff --git a/content/id/docs/2.for-users/3.features/deck.md b/content/id/docs/2.for-users/3.features/deck.md index b26a36d3..2b8dcd27 100644 --- a/content/id/docs/2.for-users/3.features/deck.md +++ b/content/id/docs/2.for-users/3.features/deck.md @@ -1,26 +1,24 @@ -# デッキ +# Antarmuka Deck -デッキは利用可能なUIのひとつです。「カラム」と呼ばれるビューを複数並べて表示させることで、カスタマイズ性が高く、情報量の多いUIが構築できることが特徴です。\ -なお、メインカラムを追加しておくと、ノートやプロフィールをページで表示した際、メインカラムに内容が表示されます。 +Antarmuka Deck merupakan salah satu antarmuka yang tersedia di dalam Misskey.Antarmuka ini dikarakterisasikan dengan kemampuannya untuk membuat antarmuka yang informatif dan sangat disesuaikan dengan menampilkan beberapa tampilan yang disebut "kolom" secara berdampingan.\ +Opsi deck hanya tersedia pada layar yang membutuhkan ukuran besar seperti komputer/laptop. -## カラムの追加 +## Menambahkan Kolom -デッキの背景を右クリックし、「カラムを追加」して任意のカラムを追加できます。 +Kamu dapat menambahkan kolom dengan mengeklik kanan pada bagian latar deck dan memilih "Tambah Kolom". Kamu juga dapat mengeklik ikon '+' pada sisi kanan layar. -## カラムの移動 +## Pindahkan Kolom -カラムは、ドラッグアンドドロップで他のカラムと位置を入れ替えることが出来るほか、カラムメニュー(カラムのヘッダー右クリック)から位置を移動させることもできます。 +Kolom dapat diposisikan ulang dengan seret dan lepas atau dengan menggunakan menu kolom opsi "Pindah" (klik kanan pada kepala kolom). -## カラムの水平分割 +## Pembagian Kolom Secara Horisontal -カラムは左右だけでなく、上下に並べることもできます。 -カラムメニューを開き、「左に重ねる」を選択すると、左のカラムの下に現在のカラムが移動します。 -上下分割を解除するには、カラムメニューの「右に出す」を選択します。 +Kolom dapat disusun secara vertikal maupun horisontal. Buka menu kolom dan pilih "Tumpuk dengan kolom kiri" untuk memindahkan kolom saat ini ke bawah kolom yang ada di sebelah kiri kolom. Untuk membongkar kolom, pilih "Lepaskan kolom ke kanan" dari menu kolom. -## カラムの設定 +## Atur Tata Letak Kolom -カラムメニューの「編集」を選択するとカラムの設定を編集できます。カラムの名前を変えたり、幅を変えたりできます。 +Pilih "Atur Kolom" dalam menu kolom untuk menyunting aturan tata letak kolom. Jika kolom diatur ke fleksibel, maka kolom akan memperluas di luar aturan lebar untuk mengisi ruang horisontal pada layar.Dalam pengaturan ini kamu juga dapat mengubah nama dan lebar kolom. -## デッキの設定 +## Pengaturan Deck -デッキに関する設定は、[settings/deck](x-mi-web://settings/deck)で行えます。 +Pengaturan yang terkait dengan Deck dapat diubah pada menu [pengaturan](x-mi-web://settings/deck) (klik pada ikon gir di bawah kanan layar). diff --git a/content/id/docs/2.for-users/3.features/drive.md b/content/id/docs/2.for-users/3.features/drive.md index 3fc879de..3617b12d 100644 --- a/content/id/docs/2.for-users/3.features/drive.md +++ b/content/id/docs/2.for-users/3.features/drive.md @@ -1,25 +1,27 @@ -# ドライブ +# Drive -ドライブは、Misskey上でファイルを管理できる機能です。 +Drive merupakan fitur yang memungkinkan kamu untuk mengelola berkasmu di dalam Misskey. :::tip -技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。 + +Secara teknis, drive dapat dilihat sebagai antarmuka dimana semua berkas secara sentral dikelola oleh sistem Misskey, yang mana juga terbuka untuk pengguna. + ::: -Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。 +Kamu dapat mengunggah berkas apapun secara langsung ke halaman Drive pada Misskey Web, dan gambar apapun yang kamu atur sebagai avatarmu atau berkas yang kamu lampirkan pada catatanmu juga akan diunggahkan ke Drive. -ドライブにアップロードされたファイルは、いつでもダウンロードすることができるほか、ノート作成時に「ドライブからファイルを添付」することでファイルを再利用することもできます。 +Berkas yang diunggah ke drive dapat diunduh kapan saja, atau berkas dapat digunakan kembali dengan menggunakan 'lampirkan berkas dari drive' ketika membuat catatan. -ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。 +Kamu juga dapat membuat folder di dalam drivemu untuk mengorganisir banyak berkas secara bersamaan. :::warning -現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。 + +Untuk saat ini, ketika kamu menghapus sebuah berkas dari drive milikmu, semua konten (catatan, halaman, dll.) yang terlampirkan pada berkas tersebut juga akan dihapus. + ::: -## センシティブ (NSFW) +## Peringatan (NSFW) -センシティブまたはNSFW (Not safe for work) は、ドライブのファイルに設定することができるフラグです。 -センシティブフラグを設定されたファイルは、表示される際に閲覧者の操作なしには表示されなくなります。 -このフラグは、例えば職場や公共の場で閲覧するのに適切でないと思われる画像などに設定し、そのような画像が突然表示されてしまうことを防ぐ目的で使われます。 +Peringatan atau NSFW (Not Safe For Work) merupakan tanda yang dapat diatur pada berkas di dalam drivemu. Berkas yang telah ditandai sebagai tidak aman untuk dilihat tidak akan ditampilkan tanpa interaksi pengguna. Penandaan ini dapat digunakan, sebagai contoh untuk mencegah gambar yang tidak sesuai untuk dilihat dan muncul tiba-tiba ketika sedang berada tempat kerja atau tempat publik. -このフラグは手動でオンオフを切り替えられるほか、モデレーターの判断で設定される場合もあります。 +Penandaan ini dapat dinyalakan dan dimatikan secara manual, atau dapat ditetapkan berdasarkan kebijakan moderator. diff --git a/content/id/docs/2.for-users/3.features/favorite.md b/content/id/docs/2.for-users/3.features/favorite.md index 2c207333..ceb31e13 100644 --- a/content/id/docs/2.for-users/3.features/favorite.md +++ b/content/id/docs/2.for-users/3.features/favorite.md @@ -1,10 +1,9 @@ -# お気に入り +# Favorit -[ノート](./note)をお気に入りとして登録できる機能です。 +Fitur ini memperbolehkanmu untuk menandai sebuah [catatan](./note) sebagai favorit. -お気に入り登録したノートは、お気に入りページで一覧することができます。 -お気に入りに登録したことは相手に通知されず、お気に入りは自分しか見ることができません。 +Kamu dapat melihat catatan yang kamu favoritkan pada halaman Favorit. Orang lain tidak akan diberitahu apabila kamu telah menambahkan catatan mereka ke dalam favoritmu, dan hanya kamu saja yang dapat melihat favoritmu. -ノートをお気に入り登録するには、ノートメニューの「お気に入り」を押します。お気に入り解除するには、ノートメニューの「お気に入り解除」を押します。 +Untuk memfavoritkan catatan, tekan "Tambahkan ke favorit" pada menu catatan.Untuk menonfavoritkan catatan, klik "Hapus dari favorit" pada menu catatan. diff --git a/content/id/docs/2.for-users/3.features/follow.md b/content/id/docs/2.for-users/3.features/follow.md index 16838f82..69eb7c46 100644 --- a/content/id/docs/2.for-users/3.features/follow.md +++ b/content/id/docs/2.for-users/3.features/follow.md @@ -1,4 +1,4 @@ -# フォロー +# Ikuti -ユーザーをフォローすると、タイムラインにそのユーザーの投稿が表示されるようになります。ただし、他のユーザーに対する返信は含まれません。 -ユーザーをフォローするには、ユーザーページの「フォロー」ボタンをクリックします。フォローを解除するには、もう一度クリックします。 +Ketika kamu mengikuti seorang pengguna, kamu akan melihat postingan mereka di lini masa berandamu.Akan tetapi, balasan mereka ke pengguna lain tidak akan diikutkan. +Untuk mengikuti seorang pengguna, klik tombol "Ikuti" pada halaman profil pengguna.Untuk batal mengikuti pengguna, klik tombol tersebut kembali. diff --git a/content/id/docs/2.for-users/3.features/hashtag.md b/content/id/docs/2.for-users/3.features/hashtag.md index b0ff847c..f7dcd78b 100644 --- a/content/id/docs/2.for-users/3.features/hashtag.md +++ b/content/id/docs/2.for-users/3.features/hashtag.md @@ -1,4 +1,4 @@ -# ハッシュタグ +# Tagar ハッシュタグとは、投稿に検索可能なタグをつけることができる機能の一つです。 diff --git a/content/id/docs/2.for-users/3.features/mention.md b/content/id/docs/2.for-users/3.features/mention.md index 17289e1a..f615b143 100644 --- a/content/id/docs/2.for-users/3.features/mention.md +++ b/content/id/docs/2.for-users/3.features/mention.md @@ -1 +1 @@ -# メンション +# Sebut diff --git a/content/id/docs/2.for-users/3.features/mfm.md b/content/id/docs/2.for-users/3.features/mfm.md index 5771232a..8469e229 100644 --- a/content/id/docs/2.for-users/3.features/mfm.md +++ b/content/id/docs/2.for-users/3.features/mfm.md @@ -1,29 +1,33 @@ --- -description: MFMは、Misskeyの様々な場所で使用できる専用のマークアップ言語です。 +description: MFM, yang merupakan singkatan dari Misskey Flavoured Markdown, adalah bahasa markup yang dapat digunakan pada berbagai tempat di dalam Misskey. --- # MFM -MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。 +MFM, yang merupakan singkatan dari Misskey Flavoured Markdown, adalah bahasa markup yang dapat digunakan pada berbagai tempat di dalam Misskey. :::tip -一部の構文はMarkdownやHTMLと互換性があります。 + +Beberapa dari sintaks MFM memiliki kompatibilitas dengan Markdown. + ::: -## MFMが使用可能な場所の例 +## Contoh dimana MFM diperbolehkan dalam Misskey -- ノート本文 -- CW注釈 -- ユーザーの名前 -- ユーザーの自己紹介 +- Konten dalam catatan +- Spoiler konten peringatan +- Nama Pengguna +- Profil Bio Pengguna -## 構文 +## Sintaks -### メンション +### Sebutan アットマーク + ユーザー名で、特定のユーザーを示すことができます。 :::tip + メンションについての詳細は[こちら](./mention.md)を参照してください。 + ::: ``` @@ -38,11 +42,13 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使 -### ハッシュタグ +### Tagar ナンバーサイン + タグで、ハッシュタグを示すことができます。 :::tip + ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。 + ::: ``` @@ -61,30 +67,34 @@ https://example.com -### リンク +### Tautan 文章の特定の範囲を、URLに紐づけることができます。 ``` -[example link](https://example.com) +[contoh tautan](https://example.com) ``` :::tip + リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。 ``` -?[example link](https://example.com) +?[contoh tautan](https://example.com) ``` ::: -### カスタム絵文字 +### Emoji kustom コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。 + :::tip + カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。 + ::: ``` @@ -93,47 +103,47 @@ https://example.com -### 太字 +### Huruf Tebal 文字を太く表示して強調することができます。 ``` -**太字** +**Huruf Tebal** ``` -### 目立たなくする +### Huruf Kecil 内容を小さく・薄く表示させることができます。 ``` -MisskeyでFediverseの世界が広がります +Misskey membentangkan dunia Fediverse ``` -### 引用 +### Kutip 内容が引用であることを示すことができます。 ``` -> MisskeyでFediverseの世界が広がります +> Misskey membentangkan dunia Fediverse ``` -### 中央寄せ +### Tengah 内容を中央寄せで表示させることができます。 ``` -
MisskeyでFediverseの世界が広がります
+
Misskey membentangkan dunia Fediverse
``` -### コード(インライン) +### Kode (Dalam baris) プログラムなどのコードをインラインでシンタックスハイライトします。 @@ -141,7 +151,7 @@ https://example.com `<: "Hello, world!"` ``` -### コード(ブロック) +### Kode (Blok) 複数行のプログラムなどのコードをブロックでシンタックスハイライトします。 @@ -154,29 +164,29 @@ https://example.com } ``` -### 反転 +### Putar Balik 内容を上下または左右に反転させます。 ``` -$[flip MisskeyでFediverseの世界が広がります] -$[flip.v MisskeyでFediverseの世界が広がります] -$[flip.h,v MisskeyでFediverseの世界が広がります] +$[flip Misskey membentangkan dunia Fediverse] +$[flip.v Misskey membentangkan dunia Fediverse] +$[flip.h,v Misskey membentangkan dunia Fediverse] ``` -### フォント +### Font 内容のフォントを指定することができます。 ``` -$[font.serif MisskeyでFediverseの世界が広がります] -$[font.monospace MisskeyでFediverseの世界が広がります] -$[font.cursive MisskeyでFediverseの世界が広がります] -$[font.fantasy MisskeyでFediverseの世界が広がります] +$[font.serif Misskey membentangkan dunia Fediverse] +$[font.monospace Misskey membentangkan dunia Fediverse] +$[font.cursive Misskey membentangkan dunia Fediverse] +$[font.fantasy Misskey membentangkan dunia Fediverse] ``` -### ぼかし +### Buram/Kabur 内容をぼかすことができます。ポインターを上に乗せるとはっきり見えるようになります。 ``` -$[blur MisskeyでFediverseの世界が広がります] +$[blur Misskey membentangkan dunia Fediverse] ``` -### 検索 +### Kontak Pencarian 検索ボックスを表示できます。 ``` -misskey 検索 +misskey cari ``` -### 文字色・背景色 +### Warna Latar/Karakter 文字色と背景色を変更することができます。 3,4,6桁のカラーコードで色を表現します。 ``` -$[fg.color=f00 赤字] -$[bg.color=ff0 黄背景] +$[fg.color=f00 Huruf Merah] +$[bg.color=ff0 Latar Kuning] ``` -### 角度変更 +### Rotasi 指定した角度で回転させます。 @@ -228,7 +238,7 @@ $[rotate.deg=30 misskey] -### 位置変更 +### Posisi 位置をずらすことができます。 @@ -238,7 +248,7 @@ $[rotate.deg=30 misskey] -### 拡大 +### Skala 文字を引き延ばして表示します。 @@ -258,7 +268,7 @@ $[x4 x4] $[x3 x3] $[x4 x4]"> -### アニメーション(びよんびよん) +### Animasi (Jelly) ``` $[jelly 🍮] $[jelly.speed=5s 🍮] @@ -266,7 +276,7 @@ $[jelly 🍮] $[jelly.speed=5s 🍮] -### アニメーション(じゃーん) +### Animasi (Tada) ``` $[tada 🍮] $[tada.speed=5s 🍮] @@ -274,7 +284,7 @@ $[tada 🍮] $[tada.speed=5s 🍮] -### アニメーション(ジャンプ) +### Animasi (Lompat) ``` $[jump 🍮] $[jump.speed=5s 🍮] @@ -282,7 +292,7 @@ $[jump 🍮] $[jump.speed=5s 🍮] -### アニメーション(バウンド) +### Animasi (Memantul) ``` $[bounce 🍮] $[bounce.speed=5s 🍮] @@ -290,7 +300,7 @@ $[bounce 🍮] $[bounce.speed=5s 🍮] -### アニメーション(回転) +### Animasi (Putar) ``` $[spin 🍮] $[spin.left 🍮] $[spin.alternate 🍮] @@ -305,7 +315,7 @@ $[spin.x 🍮] $[spin.x,left 🍮] $[spin.x,alternate 🍮] $[spin.y 🍮] $[spin.y,left 🍮] $[spin.y,alternate 🍮] $[spin.speed=5s 🍮]]"> -### アニメーション(ぶるぶる) +### Animasi (Goyang) ``` $[shake 🍮] $[shake.speed=5s 🍮] @@ -313,7 +323,7 @@ $[shake 🍮] $[shake.speed=5s 🍮] -### アニメーション(ブレ) +### Animasi (Cubit) ``` $[twitch 🍮] $[twitch.speed=5s 🍮] @@ -321,19 +331,19 @@ $[twitch 🍮] $[twitch.speed=5s 🍮] -### レインボー +### Pelangi ``` $[rainbow 🍮] $[rainbow.speed=5s 🍮] -$[rainbow 色なし文字] -$[rainbow $[fg.color=f0f 色付き文字]] +$[rainbow Huruf Tanpa Warna] +$[rainbow $[fg.color=f0f Huruf Dengan Warna]] ``` -### キラキラ +### Kelap-kelip ``` $[sparkle 🍮] @@ -341,7 +351,7 @@ $[sparkle 🍮] -### プレーン +### Polos 内側の構文を全て無効にします。 @@ -351,7 +361,7 @@ $[sparkle 🍮] -## 開発者向け情報 +## Informasi untuk Pengembang MFMのパーサー実装はライブラリとして公開されており、簡単にクライアントにMFMを組み込むことが可能です。 diff --git a/content/id/docs/2.for-users/3.features/mute-and-block.md b/content/id/docs/2.for-users/3.features/mute-and-block.md index 9ff1ddf9..ea118c39 100644 --- a/content/id/docs/2.for-users/3.features/mute-and-block.md +++ b/content/id/docs/2.for-users/3.features/mute-and-block.md @@ -1,56 +1,64 @@ -# ミュートとブロック +# Bisukan dan Blokir -好みではないユーザーがいる場合は、ミュートを行うことでそのユーザーが自分から見えないようにすることができます。 -また、より強力な措置として、ブロックを行うことでそのユーザーから自分のコンテンツが見えないようになるほか、自分に対して関わることができないようにすることができます。 -ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。 +Jika kamu tidak menyukai seorang pengguna, kamu dapat membisukan mereka untuk membuat mereka hilang dari lini masamu. Sebagai alternatif, kamu juga dapat memblokir pengguna untuk mencegah mereka melihat kontenmu atau berinteraksi dengan kamu dalam cara apapun. Orang tidak akan tahu bahwa kamu telah membisukan mereka, tetapi mereka tahu jika kamu memblokir mereka.Semua terserah pada keputusanmu untuk memilih opsi mana yang akan kamu pilih. :::tip -ミュートとブロックは併用できます。 + +Bisukan dan blokir dapat digunakan secara bersamaan. + ::: :::warning -利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。 + +Mohon pertimbangkan untuk melaporkan pengguna manapun yang melanggar Syarat dan Ketentuan ke moderator. + ::: -Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。 +Dalam Misskey Web, kamu dapat melihat daftar pengguna yang telah kamu bisukan atau kamu blokir dengan menuju ke menu Pengaturan > Bisukan dan Blokir. -## ミュート +## Bisukan -ユーザーをミュートすると、そのユーザーに関する次のコンテンツがMisskeyに表示されなくなります: +Jika kamu membisukan seorang pengguna, konten berikut mengenai pengguna tersebut tidak akan muncul kembali di Misskey: -- タイムラインや投稿の検索結果内の、そのユーザーの投稿(およびそれらの投稿に対する返信やRenote) -- そのユーザーからの通知 -- メッセージ履歴一覧内の、そのユーザーとのメッセージ履歴 -- など +- Postingan pengguna (balasan serta renote dari postingan tersebut) dalam lini masa dan hasil pencarian postingan +- Notifikasi dari pengguna tersebut +- Riwayat pesan dengan pengguna di dalam obrolan Misskey +- dan lain-lain. -Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。 +Untuk membisukan pengguna dalam Misskey Web, buka menu pada halaman profil pengguna dan tekan tombol "Bisukan". :::tip -ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。 + +Pengguna yang dibisukan tidak akan diberi tahu bahwa kamu telah membisukan mereka, dan mereka tidak akan tahu bahwa kamu telah membisukan mereka. + ::: -## ブロック +## Blokir -ユーザーをブロックすると、そのユーザーからあなたのコンテンツが見えないようになり、またあなたに対して以下のようなアクションをすることができなくなります。 +Jika kamu memblokir pengguna, mereka tidak akan dapat melihat konten kamu dan mereka tidak akan dapat melakukan aksi berikut: -- フォローする -- ユーザーリストに追加する -- 返信する、Renoteする -- リアクションする、アンケートに投票する -- メッセージを送信する -- など +- Mengikuti kamu +- Menambahkanmu ke dalam daftar +- Membalas atau merenote kamu +- Memberikan reaksi atau memilih dari salah satu jajak pendapatmu +- Mengirim pesan ke kamu +- dan lain-lain. -また、 +Serta juga, -- ブロックする際に既にそのユーザーからフォローされていた場合はフォローが解除されます。 -- ブロックする際に既にそのユーザーがあなたをユーザーリストに入れていた場合はそのリストからあなたが削除されます。 +- Jika pengguna telah mengikuti kamu ketika kamu memblokir mereka, mereka akan membatalkan mengikuti kamu. +- Jika pengguna telah memasukkan kamu ke daftar mereka ketika kamu memblokir mereka, kamu tidak akan dihapus dari daftar tersebut. -Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。 +Untuk memblokir pengguna pada Misskey Web, buka menu pada halaman profil pengguna dan tekan tombol "Blokir". :::warning -ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。 + +Kamu tidak akan diberitahu bahwa kamu telah diblokir oleh seseorang, namun kamu tahu secara tidak langsung bahwa kamu telah diblokir karena kamu tidak dapat melakukan berbagai aksi yang disebutkan di atas, seperti mengikuti seseorang. + ::: :::warning -相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。 + +Orang lain tidak dapat melihat konten kamu, namun mereka akan tetap dapat melihat konten kamu jika mereka beralih akun atau keluar.Mohon pertimbangkan aksi ini hanya sebagai tindakan pencegahan tambahan dan sederhana. + ::: diff --git a/content/id/docs/2.for-users/3.features/pages.md b/content/id/docs/2.for-users/3.features/pages.md index 21a59a21..dc2ae6cb 100644 --- a/content/id/docs/2.for-users/3.features/pages.md +++ b/content/id/docs/2.for-users/3.features/pages.md @@ -1,12 +1,14 @@ -# ページ +# Halaman -Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。 +Kamu dapat membuat Halaman di Misskey yang terpisah dari Catatan.Pada versi 13 kami membuat Halaman menjadi halaman statis. :::warning -v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。 + +Mulai dari versi 13, Misskey Play dapat digunakan untuk menggantikan halaman dinamis yang dibuat oleh Halaman. + ::: -## ページ設定 +## Pengaturan Halaman ページに関する項目を設定します。次の項目を入力できます。 @@ -18,15 +20,15 @@ v13よりページによる動的ページ作成の代わりにMisskey Playが - ピン留めされているときにタイトルを非表示 - アイキャッチ画像 -### タイトル +### Judul このページのタイトルを入力します。一覧に表示されます。 -### ページの要約 +### Ringkasan Halaman 簡単な説明を入力します。一覧に表示されます。 -### ページURL +### URL Halaman `https://サーバー名/@ユーザー/pages/●●●` の `●●●` を任意に設定できます。 @@ -34,7 +36,7 @@ v13よりページによる動的ページ作成の代わりにMisskey Playが 有効にすると、中央に寄せて表示します。 -### フォント +### Font **セリフ** と **サンセリフ** を選択します。 @@ -42,11 +44,11 @@ v13よりページによる動的ページ作成の代わりにMisskey Playが ピン留めされているときにタイトルを非表示にします。 -### アイキャッチ画像 +### Gambar yang menarik **アイキャッチ画像を設定** より画像を設定できます。一覧表示などで表示する事が可能です。 -## コンテンツ +## Konten ページ本体を編集します。次のブロックを一つまたは複数組み合わせてページを生成できます。 @@ -55,18 +57,18 @@ v13よりページによる動的ページ作成の代わりにMisskey Playが - 画像 - ノート埋め込み -### セクション +### Bagian タイトルを設定する事で見出しとして表示します。更に中のブロックを設定できます。 -### テキスト +### Teks テキスト本文を入力します。MFMやカスタム絵文字を使用できます。 -### 画像 +### Gambar 画像を表示します。ドライブより画像を設定します。 -### ノート埋め込み +### Catatan yang ditanam ノート ID を入れる事で、そのノートを表示します。他のサーバーを埋め込みたい場合は検索でそのURLを入れ、表示させた時のIDを貼り付けて下さい。 diff --git a/content/id/docs/2.for-users/3.features/poll.md b/content/id/docs/2.for-users/3.features/poll.md index c96f89a1..32777ede 100644 --- a/content/id/docs/2.for-users/3.features/poll.md +++ b/content/id/docs/2.for-users/3.features/poll.md @@ -13,7 +13,9 @@ 追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。 :::warning + いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。 + ::: ## 複数回答を可能にする @@ -41,7 +43,9 @@ 未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。 :::tip + 未投票アンケートには、結果を表示した状態でも投票できます。 + ::: 投票をすると、自分の投票した選択肢に✔がつきます。 diff --git a/content/id/docs/2.for-users/3.features/share-form.md b/content/id/docs/2.for-users/3.features/share-form.md index 0bd8a69a..e65fd555 100644 --- a/content/id/docs/2.for-users/3.features/share-form.md +++ b/content/id/docs/2.for-users/3.features/share-form.md @@ -7,7 +7,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく ## クエリパラメータ :::tip + すべてのパラメータは**オプション**であり、必須ではありません。 + ::: | 名前 | 説明 | @@ -46,7 +48,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく | `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) | :::warning + `visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。 + ::: ### 添付ファイル diff --git a/content/id/docs/2.for-users/3.features/thread-mute.md b/content/id/docs/2.for-users/3.features/thread-mute.md index ab4bd823..2f4378ba 100644 --- a/content/id/docs/2.for-users/3.features/thread-mute.md +++ b/content/id/docs/2.for-users/3.features/thread-mute.md @@ -1,7 +1,9 @@ # スレッドミュート :::tip + バージョン 12.95.0 以降の機能です。 + ::: スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。 @@ -11,5 +13,7 @@ Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。 :::warning + スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。 + ::: diff --git a/content/id/docs/2.for-users/3.features/webhook.md b/content/id/docs/2.for-users/3.features/webhook.md index e6d291e6..f8f31f03 100644 --- a/content/id/docs/2.for-users/3.features/webhook.md +++ b/content/id/docs/2.for-users/3.features/webhook.md @@ -1,11 +1,15 @@ # Webhook :::tip + バージョン 12.109.0 以降の機能です。 + ::: :::warning + 実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。 + ::: MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。 diff --git a/content/id/docs/2.for-users/4.resources/1.troubleshooting.md b/content/id/docs/2.for-users/4.resources/1.troubleshooting.md index 03b877a9..2aef90d3 100644 --- a/content/id/docs/2.for-users/4.resources/1.troubleshooting.md +++ b/content/id/docs/2.for-users/4.resources/1.troubleshooting.md @@ -5,7 +5,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ # トラブルシューティング :::tip + [よくある質問](./faq.md)も合わせてお役立てください。 + ::: 問題が発生したときは、まずこちらをご確認ください。 @@ -59,7 +61,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ クライアントの設定の「キャッシュをクリア」すると直ります。 :::warning + 「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。 + ::: ## 通知やアンテナ等の点滅が消えない diff --git a/content/id/docs/2.for-users/4.resources/apps.md b/content/id/docs/2.for-users/4.resources/apps.md index dfd6612c..e79ab65b 100644 --- a/content/id/docs/2.for-users/4.resources/apps.md +++ b/content/id/docs/2.for-users/4.resources/apps.md @@ -2,7 +2,7 @@ description: Misskeyを使うためのアプリを紹介します。 --- -# アプリ +# Aplikasi Misskeyを使うためのアプリ（クライアント）を紹介します。 diff --git a/content/id/docs/2.for-users/4.resources/donate.md b/content/id/docs/2.for-users/4.resources/donate.md index a00e50ff..643863ae 100644 --- a/content/id/docs/2.for-users/4.resources/donate.md +++ b/content/id/docs/2.for-users/4.resources/donate.md @@ -1,32 +1,38 @@ -# プロジェクトへの寄付 +# Donasi ke proyek ini -Misskeyはビジネスではなく、利用は無料であるため、収益は皆様からの寄付のみです。(サーバーによっては広告収入を得ているような場合もありますが、それは運営者の収入であり直接開発者への収入にはなりません) -寄付をしていただければ、今後も開発を続けることが可能になり、プロジェクトへの貢献になります。以下の方法で受け付けています。 +Misskey bukanlah sebuah bisnis, dan akan tetap gratis dipakai dengan cara memperoleh pemasukan lewat donasi dari siapa saja.(Tergantung instansi, sebagian pemasukan mungkin diperoleh dari iklan yang ditampilkan, tetapi pendapatan ini tidak langsung menuju administrator instansi dan pengembang Misskey.) Karena donasi dapat membantu proyek ini tetap bertahan, akan memungkinkan kami untuk melanjutkan pengembangan dan terus berkontribusi pada proyek ini di masa depan.Kami menerima beberapa metode donasi yang ada di bawah berikut: -- 継続支援 +- Dukungan Berlangganan - [Fanbox](https://syuilo.fanbox.cc/) - [Patreon](https://www.patreon.com/syuilo) -- 単発支援 +- Dukungan Satu Kali - Kyash: @syuilo - [PayPal](https://paypal.me/syuilo) - - 仮想通貨: `0xF1121108E21C92aAC7814137DD67e0d48eAC7Fdc` - - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) + - Mata uang kripto: `0xF1121108E21C92aAC7814137DD67e0d48eAC7Fdc` + - [Daftar barang Amazon yang diinginkan](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip + 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 + ::: :::tip + 額に応じて以下の返礼を用意しています。 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 - 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載 - 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載 - ::: + +::: :::warning + **バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。** + (メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります) + ::: また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。 diff --git a/content/id/docs/2.for-users/4.resources/misskey-hub.md b/content/id/docs/2.for-users/4.resources/misskey-hub.md index bbdce97a..87114f3d 100644 --- a/content/id/docs/2.for-users/4.resources/misskey-hub.md +++ b/content/id/docs/2.for-users/4.resources/misskey-hub.md @@ -6,7 +6,9 @@ Misskey Hubは、Misskeyに関するナレッジなどのドキュメント、 Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub) :::tip + Misskey HubはNuxtを使ってビルドされた静的サイトです。 + ::: ## Misskey Hubに貢献する diff --git a/content/id/docs/3.for-admin/features/1.index.md b/content/id/docs/3.for-admin/features/1.index.md index 7179b5c1..ec3b3ad0 100644 --- a/content/id/docs/3.for-admin/features/1.index.md +++ b/content/id/docs/3.for-admin/features/1.index.md @@ -1,9 +1,9 @@ --- -description: サーバー管理者向けの機能の説明です。 +description: Fitur untuk admin peladen. --- -# サーバーの機能 +# Fitur Peladen -Misskeyではサーバー運営に役立つ様々な機能が提供されています。 +Misskey menawarkan bermacam fitur untuk membantumu menjalankan peladenmu. diff --git a/content/id/docs/3.for-admin/features/announcement.md b/content/id/docs/3.for-admin/features/announcement.md index 54475e35..9e54536e 100644 --- a/content/id/docs/3.for-admin/features/announcement.md +++ b/content/id/docs/3.for-admin/features/announcement.md @@ -1,26 +1,28 @@ -# お知らせ +# Pengumuman -お知らせ(announcement)はMisskeyで利用可能なサーバー機能のひとつです。 +Pengumuman (announcement) adalah salah satu fitur yang tersedia pada Misskey. -お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。 +Dengan menggunakan fitur pengumuman, kamu dapat memposting pengumuman kepada pengguna di dalam peladen yang kamu kelola, termasuk juga mengirimkan pesan dari peladen ke pengguna secara individu. :::warning + アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。 - 「既存ユーザーのみ」オプションを有効にしてお知らせを作成する - 「非通知」オプションを有効にしてお知らせを作成する - 終了したお知らせはアーカイブする - ::: -## 表示形式 +::: -お知らせの表示形式を以下の種類から選択することができます。 +## Gaya Tampilan -- **通常** ... お知らせ一覧ページにお知らせが掲載されます。 -- **バナー** ... お知らせ一覧ページへの掲載に加えて、クライアントの画面上部にバナーとして表示されます。 -- **ダイアログ** ... お知らせ一覧ページへの掲載に加えて、クライアント起動時にモーダル ダイアログとして表示されます。 - - ダイアログ形式のお知らせが同時に2つ以上ある場合、UXに悪影響を及ぼす可能性が非常に高いため、使用は慎重に行うことを推奨します。 +Kamu dapat memilih beberapa tipe gaya tampilan berikut. -## お知らせの作成 +- **Normal** ... Pengumuman akan diposting ke halaman Pengumuman. +- **Banner** ... Sebagai tambahan dari halaman pengumuman, banner akan ditampilkan pada posisi paling atas dari layar pengguna. +- **Dialog** ... Sebagai tambahan dari halaman pengumuman, dialog modal akan ditampilkan ketika pengguna membuka situs peladen. + - Sangat direkomendasikan untuk berhati-hati ketika terdapat dua atau lebih pengumuman yang ditampilkan dengan tipe dialog secara bersamaan, dikarenakan nantinya akan berdampak pada pengalaman pengguna (UX). + +## Membuat Pengumuman TODO diff --git a/content/id/docs/3.for-admin/features/role.md b/content/id/docs/3.for-admin/features/role.md index d8209cf8..a5aeb766 100644 --- a/content/id/docs/3.for-admin/features/role.md +++ b/content/id/docs/3.for-admin/features/role.md @@ -21,11 +21,13 @@ - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) :::warning + コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 - 手動でのアサイン/アサイン解除は行えません。 - 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。 - ::: + +::: ## 権限 @@ -53,6 +55,7 @@ **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** :::tip + 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 @@ -62,7 +65,8 @@ - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ::: + +::: ### ベースロールの値を使用 @@ -85,11 +89,15 @@ アサインする際にアサインされる期間を設定することが可能です。 :::tip + ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。 + ::: :::warning + コンディショナル ロールには手動でのアサインはできません。 + ::: ## ユーザーのポリシーの確認 diff --git a/content/id/docs/3.for-admin/install/guides/1.index.md b/content/id/docs/3.for-admin/install/guides/1.index.md index 73c48d68..012ad01f 100644 --- a/content/id/docs/3.for-admin/install/guides/1.index.md +++ b/content/id/docs/3.for-admin/install/guides/1.index.md @@ -7,15 +7,19 @@ description: Misskeyサーバーの作成方法についての案内です。 Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::warning + 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。 詳しくは [misskey-dev/misskey #9791](https://github.com/misskey-dev/misskey/issues/9791) をご覧ください。 + ::: ## Xserver VPSでインストール diff --git a/content/id/docs/3.for-admin/install/guides/bash.md b/content/id/docs/3.for-admin/install/guides/bash.md index 8daef610..6d408c1b 100644 --- a/content/id/docs/3.for-admin/install/guides/bash.md +++ b/content/id/docs/3.for-admin/install/guides/bash.md @@ -1,189 +1,190 @@ # Misskey install shell script v3.0.0 -Misskeyを簡単にインストールするためのシェルスクリプトができました！ +Pasang Misskey dengan mudah hanya menggunakan satu shell script! -いくつかの質問に答えるだけで、UbuntuサーバーへMisskey(v12)を簡単にインストールできます！ +Kamu dapat memasang misskey pada peladen Ubuntu hanya dengan menjawab beberapa pertanyaan saja. -また、アップデートスクリプトもあります。 +Terdapat juga script untuk memutakhirkan. -[v12の場合はこちら](https://github.com/joinmisskey/bash-install/blob/a096e874f93d493aa68975a31be9ce12d644e767/README.md)\ -[**English version**](./README.en.md) +[Untuk v12](https://github.com/joinmisskey/bash-install/blob/a096e874f93d493aa68975a31be9ce12d644e767/README.md)\ +[**Versi Bahasa Inggris**](./README.en.md) -## ライセンス +## Lisensi -[MIT License](./LICENSE) +[Lisensi MIT](./LICENSE) -## 準備するもの +## Bahan Yang Perlu Disiapkan -1. ドメイン -2. Ubuntuがインストールされたサーバー -3. Cloudflareアカウント（推奨） +1. Domain +2. Peladen Ubuntu +3. Akun Cloudflare (Direkomendasikan) :::danger -一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + +Jangan pernah mengganti nama domain (hostname) peladen ketika kamu sudah mulai menggunakannya! + ::: -Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。 +Pastikan pengaturan jaringan peladen DNS anda telah benar secara menyeluruh sebelum memulai instalasi. Apabila tidak, proses otentikasi Let's Encrypt akan terhambat dikarenakan percobaan permintaan sertifikat Let's Encrypt dibatasi dalam jumlah yang kecil. -## Cloudflareの設定 +## Pengaturan Cloudflare Cloudflareを使う場合、Cloudflareのドメインの設定を完了してからインストールを開始するようにしてください。\ ネームサーバーの適用には最大で3日程度かかる場合があります。 -また、nginxとCloudflareを設定する場合、Cloudflareの設定画面にて、 +Jika kamu menggunakan nginx dan Cloudflare, kamu harus mengatur Cloudflare terlebih dahulu untuk: -- DNSを設定してください。 -- SSL/TLS設定にて、暗号化モードを「フル」に設定してください。 +- Mengatur DNS. +- Pada tab pengaturan SSL/TLS, ubah mode enkripsi menjadi "Full". -## 操作 +## Prosedur ### 1. SSH -サーバーにSSH接続します。\ -（サーバーのデスクトップを開いている方はシェルを開きましょう。） +Menyambung ke peladen melalui SSH.\ +(Jika kamu memiliki peladen dengan lingkungan desktop terpasang, buka Terminal/shell） -### 2. 環境を最新にする +### 2. Perbaharui Lingkungan Peladen -すべてのパッケージを最新にし、再起動します。 +Pastikan semua paket telah termutakhirkan dan boot ulang. ``` sudo apt update; sudo apt full-upgrade -y; sudo reboot ``` -### 3. インストールをはじめる +### 3. Jalankan Pemasangan -SSHを接続しなおして、Misskeyのインストールを始めましょう。 +Hubungkan ulang SSH dan mulai pemasangan Misskey. -ただ、インストール前に[Tips](#tips)を読むことを強くお勧めします。 +Pastikan untuk membaca [Tips](#tips) sebelum memulai proses pemasangan. ``` wget https://raw.githubusercontent.com/joinmisskey/bash-install/main/ubuntu.sh -O ubuntu.sh; sudo bash ubuntu.sh ``` -example.comは自分のドメインに置き換えてください。 +Ubah domain example.com menjadi domain milik kamu. -### 4. アップデートする +### 4. Untuk memutakhirkan -アップデートのためのスクリプトもあります。 +Terdapat juga script untuk memutakhirkan peladen Misskey. -アップデートスクリプトは、環境のアップデートは行いません。CHANGELOG（日本語）および[GitHubのリリース一覧（英語）](https://github.com/joinmisskey/bash-install/releases)を参考に、適宜マイグレーション操作を行なってください。 +Script pemutakhiran tidak memutakhirkan lingkungan peladen.Mohon untuk merujuk ke CHANGELOG (Bahasa Jepang) dan [Daftar rilis di GitHub (Bahasa Inggris)](https://github.com/joinmisskey/bash-install/releases) serta lakukan operasi migrasi sesuai arahan. -まずはダウンロードします。 +Pertama, unduh script. ``` wget https://raw.githubusercontent.com/joinmisskey/bash-install/main/update.ubuntu.sh -O update.sh ``` -アップデートしたいときにスクリプトを実行してください。 +Jalankan ini ketika kamu ingin memutakhirkan Misskey. ``` sudo bash update.sh ``` -- systemd環境では、`-r`オプションでシステムのアップデートと再起動を行うことができます。 -- docker環境では、引数に更新後のリポジトリ名:タグ名を指定することができます。 +- Pada lingkungan systemd, opsi `-r` dapat digunakan untuk memutakhirkan dan memboot ulang sistem. +- Pada lingkungan docker, kamu dapat menentukan repository:tag sebagai argumen. -## 動作を確認した環境 +## Lingkungan dimana operasi ini telah diuji ### Oracle Cloud Infrastructure -このスクリプトは、Oracle Cloud InfrastructureのAlways Freeサービスで提供されている2種類のシェイプのいずれにおいても動作します。 +Script ini bekerja dengan baik pada bentuk compute berikut yang disediakan oleh Oracle Cloud Infrastructure Always Free services. - VM.Standard.E2.1.Micro (AMD) -- VM.Standard.A1.Flex (ARM) [1OCPU RAM6GB or greater] +- VM.Standard.A1.Flex (ARM) [1OCPU RAM6GB atau lebih] -iptablesを使うようにしてください。 +Pastikan untuk menggunakan iptables. -## Issues & PRs Welcome +## Isu & PRs Dipersilahkan -上記の環境で動作しない場合、バグの可能性があります。インストールの際に指定された条件を記載の上、GitHubのIssue機能にてご報告いただければ幸いです。 +Apabila script ini tidak dapat bekerja pada lingkungan diatas, kemungkinan karena bug.Kami mengapresiasi apabila kamu dapat melaporkan hal tersebut sebagai isu dengan syarat tertentu yang telah kamu input ke dalam script. -上記以外の環境についてのサポートは難しいですが、状況を詳しくお教えいただければ解決できる可能性があります。 +Sangat sulit untuk memberikan bantuan untuk lingkungan selain yang disebutkan di atas, namun kami masih dapat membantu mencarikan solusi dari masalah kamu apabila kamu memberikan informasi detil mengenai lingkungan peladenmu. -機能の提案についても歓迎いたします。 +Saran untuk fitur juga dipersilahkan. # Tips -選択肢の選び方や仕様についてなど。 +Cara memilih opsi dan spesifikasi. ## Systemd or Docker? -v1から、インストールメソッドにsystemdとDockerとを選べるようにしました。 +Mulai dari v1, terdapat metode pemasangan systemd atau Docker yang dapat dipilih. -Dockerと言っても、**MisskeyだけをDockerで実行**し、RedisやPostgresなどはホストで直接実行します。\ +Ketika memilih metode pemasangan Docker, **Misskey akan dipasang dan dijalankan melalui Docker** sedangkan Redis, Postgres dan sebagainya akan dipasang dan dijalankan pada host peladen langsung.\ [docker-composeですべての機能を動かす方法については、mamemonongaさんが作成したこちらの記事がおすすめです。](https://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0) -Docker Hubイメージを使う設定であれば、Misskeyのビルドが不要になるため、**一番お勧めです**。\ -ただし、マイグレーションは必要なので、アップデート時にMisskeyを使えない時間がゼロになるわけではありません。\ -また、Misskeyのビルド環境を準備しない(git pullしない)ので、フォークを動かしたくなった時に設定が面倒になります。 +Apabila kamu memilih menggunakan image dari Docker Hub, kebutuhan untuk build Misskey tidak diperlukan dan pilihan ini merupakan **rekomendasi dari kami**.\ +Namun ketika melakukan pemutakhiran, migrasi tetap dibutuhkan dan downtime tetap tidak dapat terhindarkan.\ +Selain itu, dengan menggunakan image dari Docker Hub tidak perlu lagi menyiapkan lingkungan untuk build Misskey (tidak ada `git pull`). Dengan kata lain, apabila ingin menyiapkan dan menjalankan fork akan lebih merepotkan. -ローカルでDockerをビルドする方式は、パフォーマンス面で非推奨です。 +Karena alasan performa, metode build Docker secara lokal tidak dipergunakan lagi. -systemdは、Docker Hubにイメージを上げるまでもないものの、フォークを使いたい場合にお勧めです。 +Metode pemasangan systemd sangat direkomendasikan apabila kamu ingin menggunakan ataupun menjalankan fork. Metode pemasangan ini juga tidak mengharuskan kamu untuk mengunggah image ke Docker Hub. -お勧めする順番は次の通りです。 +Urutan rekomendasi yang disarankan adalah sebagai berikut: 1. Docker Hub 2. systemd -3. Dockerビルド +3. Docker Build -## nginxを使うかどうか +## Gunakan nginx atau tidak? -サーバー1台でMisskeyを構築する場合は、nginxの使用をお勧めします。 +Apabila kamu ingin membuat peladen Misskey pada satu peladen, disarankan untuk menggunakan nginx. ロードバランサーを設置する場合にはnginxをインストールせず、[Misskeyのnginx設定](../resources/nginx/)を参考にロードバランサーを設定するのがよいと思います。 -## Add more swaps! +## Tambahkan swap! -スワップを設定している場合、メモリが合計で3GB以上でなければスクリプトが動作しないようになっています。 +Apabila kamu menggunakan swap, pastikan swap kamu memiliki hingga ruang hingga 3GB. Karena script akan dapat berjalan lancar apabila memiliki memori dengan minimal 3GB. -## 途中で失敗してまたスクリプトを実行する場合 +## Jika script gagal dan kamu ingin menjalankannya kembali -万が一途中で失敗してもう一度スクリプトを動作させる場合、次のことに注意してください。 +Perhatikan arahan berikut ini: -- RedisやPostgresのインストールが終わっている場合、「install locally」はNoにしてください。\ - host・port設定はそのままEnterを押します。 - ユーザー名やパスワードは、前回実行した際に指定したものを入力します。 +- Apabila Redis atau Postgres telah terpasang, atur `install locally` ke "No".\ + Biarkan pengaturan `host・port` apa adanya lalu tekan Enter. Masukkan nama pengguna dan kata sandi seperti yang telah ditentukan pada proses sebelumnya. -## .envファイルについて +## Mengenai berkas .env -インストールスクリプトは、2つの.envファイルを作成します。\ -アップデートの際に使用します。 +Script pemasangan membuat dua berkas.env yang dipergunakan untuk memutakhirkan Misskey.\ +Berkas ini dipergunakan pada saat memutakhirkan. ### /root/.misskey.env -misskeyを実行するユーザーを覚えておくために必要です。 +Diperlukan untuk mengingat pengguna yang menjalankan proses misskey -### /home/(misskeyユーザー)/.misskey.env +### /home/(pengguna_misskey)/.misskey.env -systemdの場合に生成されます。\ -主にディレクトリを覚えておくのに使用します。 +Dibuat untuk systemd yang dipertujukan mengingat direktori\ +. -### /home/(misskeyユーザー)/.misskey-docker.env +### /home/(pengguna_misskey)/.misskey-docker.env -Dockerの場合に生成されます。\ -実行されているコンテナとイメージの番号を保存しています。\ -コンテナの番号はアップデートの際に更新されます。古いイメージは削除されます。 +Dibuat untuk Docker dengan tujuan menyimpan nomor kontainer beserta image yang sedang berjalan.\ +Nomor kontainer akan diperbarui selama pemutakhiran.\ +Image lama akan dihapus. -## 自分で管理する +## Manajemen Mandiri -インストール後、構成を変更する際に役立つかもしれないメモです。 +Setelah pemasangan, ada beberapa catatan yang cukup berguna pada saat ingin mengubah konfigurasi. -"example.com"を自分のドメインに置き換えて読んでください。 +Ganti domain "example.com" dengan domain kamu sendiri. -### Misskeyディレクトリ +### Direktori Misskey -Misskeyのソースは`/home/ユーザー/ディレクトリ`としてcloneされます。\ -（ユーザー、ディレクトリの初期値はともにmisskeyです。） +Sumber kode akan diklon pada direktori `/home/pengguna/direktori`.\ +(nilai default untuk pengguna dan direktori adalah misskey） -Misskeyディレクトリへは、以下のように移動するとよいでしょう。 +Kamu dapat menavigasi ke direktori Misskey dengan melakukan perintah berikut. ``` -sudo -iu ユーザー -cd ディレクトリ +sudo -iu pengguna +cd direktori ``` -もとのユーザーに戻るにはexitを実行します。 +Untuk kembali ke pengguna sebelumnya, jalankan perintah `exit`. ``` exit @@ -191,75 +192,75 @@ exit ### systemd -systemdのプロセス名はexample.comです。\ -たとえば再起動するには次のようにします。 +Nama proses dalam systemd adalah `example.com`.\ +Sebagai contoh untuk memulai ulang proses, jalankan perintah berikut. ``` sudo systemctl restart example.com ``` -journalctlでログを確認できます。 +Kamu dapat memeriksa logs dengan menggunakan `journalctl`. ``` journalctl -t example.com ``` -設定ファイルは`/etc/systemd/system/example.com.service`として保存されています。 +Berkas konfigurasi systemd disimpan pada `/etc/systemd/system/example.com.service`. ### Docker -DockerはMisskeyユーザーでrootless実行されています。 +Docker menggunakan pengguna Misskey untuk dijalankan secara tanpa root. -sudo でMisskeyユーザーに入るときは、`XDG_RUNTIME_DIR`と`DOCKER_HOST`を変更する必要があります。 +Saat masuk ke pengguna Misskey menggunakan `sudo`, kamu perlu mengubah `XDG_RUNTIME_DIR` dan `DOCKER_HOST` terlebih dahulu. ``` -sudo -iu ユーザー +sudo -iu pengguna export XDG_RUNTIME_DIR=/run/user/$UID export DOCKER_HOST=unix://$XDG_RUNTIME_DIR/docker.sock -# プロセス一覧を表示 +# Tampilkan daftar Proses docker ps -# ビルド (リポジトリ: local/misskey:latest) +# Build (Repositori: local/misskey:latest) docker build -t local/misskey:latest ./misskey -# docker run +# Menjalankan Docker docker run -d -p 3000:3000 --add-host=docker_host:10.0.0.1 -v /home/misskey/misskey/files:/misskey/files -v "/home/misskey/misskey/.config/default.yml":/misskey/.config/default.yml:ro --restart unless-stopped -t "local/misskey:latest" -# ログを表示 -docker logs --tail 50 -f コンテナID +# Menampilkan log +docker logs --tail 50 -f ID Kontainer ``` -ワンライナーなら次のようにします。 +Proses diatas dapat dilakukan dengan perintah satu baris berikut. ``` -sudo -u ユーザー XDG_RUNTIME_DIR=/run/user/$(id -u ユーザー) DOCKER_HOST=unix:///run/user/$(id -u ユーザー)/docker.sock docker ps +sudo -u pengguna XDG_RUNTIME_DIR=/run/user/$(id -u pengguna) DOCKER_HOST=unix:///run/user/$(id -u pengguna)/docker.sock docker ps ``` ### nginx -nginxの設定は`/etc/nginx/conf.d/example.com.conf`として保存されています。 +Pengaturan situs pada nginx disimpan di `/etc/nginx/conf.d/example.com.conf`. ### Redis -requirepassとbindを`/etc/redis/misskey.conf`で設定しています。 +Parameter `requirepass` dan `bind` diatur di `/etc/redis/misskey.conf`. -## Q. アップデート後に502でアクセスできない +## Q. Error 502 tidak dapat diakses setelah melakukan pemutakhiran -Dockerでは、起動後にマイグレーションをするため、すぐにアクセスできません。\ -マイグレーションが終わっているかどうか確認してみてください。 +Apabila proses migrasi sedang berlangsung, Docker tidak dapat memberikan izin akses langsung.\ +Pastikan dan periksa apakah proses migrasi telah selesai. -systemdの場合では、pnpm installに失敗している可能性があります。 +Pada kasus menggunankan systemd, perintah `pnpm install` kemungkinan gagal. -Misskeyディレクトリで次の内容を実行し、もう一度アップデートを実行してみてください。 +Coba jalankan perintah berikut ini di direktori Misskey lalu jalankan pemutakhiran kembali. ``` pnpm run clean-all ``` -journalctlでログを確認すると、たいていre2が云々という記述が見当たります。 +Apabila kamu memeriksa log dengan `journalctl`, umumnya kamu akan menemukan pernyataan dalam log yang menampilkan `re2`. -## Q. 同じサーバーにもう1つMisskeyを建てたい +## Q. Membangun instansi Misskey lebih dari 1 di peladen yang sama -スクリプトは同じサーバーに追加でMisskeyをインストールすることは想定していません。\ -幾つかの設定が上書きされるか、途中でエラーになってしまうでしょう。 +Script ini tidak dapat melakukan pemasangan instansi Misskey lebih dari 1 pada peladen yang sama.\ +Hal ini dikarenakan beberapa pengaturan nantinya akan ditimpa dan kamu akan mendapatkan banyak galat dan kesalahan dalam proses menjalankan script ini. diff --git a/content/id/docs/3.for-admin/install/guides/docker.md b/content/id/docs/3.for-admin/install/guides/docker.md index d5d381e0..4ddeb6dc 100644 --- a/content/id/docs/3.for-admin/install/guides/docker.md +++ b/content/id/docs/3.for-admin/install/guides/docker.md @@ -1,21 +1,22 @@ --- -description: このガイドはDockerを使ったMisskeyセットアップ方法を説明します。 +description: Panduan ini akan menjelaskan tentang bagaimana cara memasang dan menyetel instansi Misskey dengan menggunakan Docker Compose. --- -# Docker Composeを使ったMisskey構築 +# Buat instansi Misskey dengan Docker Compose -このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。 +Panduan ini akan menjelaskan tentang bagaimana cara memasang dan menyetel instansi Misskey dengan menggunakan Docker Compose. :::danger -一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + +Jangan pernah mengubah nama domain (hostname) instansi peladen ketika kamu sudah mulai menggunakannya! + ::: :::tip{label='前提条件'} -- DockerおよびDocker Composeがインストールされていること。 - ::: +- `docker` dan `dockercompose` terpasang -## リポジトリの取得 +## Dapatkan repositorinya ```sh git clone -b master https://github.com/misskey-dev/misskey.git @@ -23,9 +24,9 @@ cd misskey git checkout master ``` -## 設定 +## Atur -下記コマンドで、各種設定ファイルのサンプルをコピーします。 +Salin berkas konfigurasi dengan menjalankan perintah berikut: ```sh cp .config/docker_example.yml .config/default.yml @@ -33,22 +34,21 @@ cp .config/docker_example.env .config/docker.env cp ./docker-compose_example.yml ./docker-compose.yml ``` -`default.yml`と`docker.env`をファイル内の説明に従って編集してください。\ -また、必要に応じて、`docker-compose.yml`を編集します。(ポートを変更したい場合など) +Sunting `default.yml` dan `docker.env` sesuai dengan instruksi yang terdapat di dalam berkas.\ +Sunting `docker-compose.yml` bila perlu.(Contoh: Apabila kamu ingin mengganti port peladen). -## ビルドと初期化 +## Bangun dan inisialisasi -次のコマンドでMisskeyのビルドとデータベースの初期化を行います。 -これにはしばらく時間がかかります。 +Perintah berikut akan membangun Misskey dan menginisialisasi basis data. Proses ini akan memakan waktu sesaat. ```shell sudo docker compose build sudo docker compose run --rm web pnpm run init ``` -## 起動 +## Jalankan -お疲れ様でした。以下のコマンドでMisskeyを起動できます。 +Selamat!Kamu sudah dapat memulai peladen Misskey dengan perintah berikut. ```sh sudo docker compose up -d @@ -56,10 +56,12 @@ sudo docker compose up -d GLHF✨ -## Misskeyのアップデート方法 +## Bagaimana memutakhirkan peladen Misskey kamu? :::warning -アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 + +Ketika memutakhirkan, pastikan mengecek [catatan rilisan](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md) untuk mengetahui lebih awal akan perubahan ataupun tambahan pekerjaan yang nantinya dibutuhkan (biasanya tidak perlu). + ::: ```sh @@ -72,9 +74,9 @@ sudo docker compose build sudo docker compose stop && sudo docker compose up -d ``` -アップデート内容、およびデータベースの規模によっては時間がかかることがあります。 +Perintah tersebut akan memakan waktu sesaat bergantung dengan konten dari pemutakhiran dan ukuran basis data. -## cliコマンドを実行する方法 +## Bagaimana cara mengeksekusi perintah CLI? ```sh sudo docker compose run --rm web node packages/backend/built/tools/foo bar diff --git a/content/id/docs/3.for-admin/install/guides/kubernetes.md b/content/id/docs/3.for-admin/install/guides/kubernetes.md index 8d0905fd..1799922c 100644 --- a/content/id/docs/3.for-admin/install/guides/kubernetes.md +++ b/content/id/docs/3.for-admin/install/guides/kubernetes.md @@ -3,7 +3,9 @@ このガイドでは、Kubernetes と HelmChartを使用したMisskeyセットアップ方法について説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: ## TrueCharts と TrueNAS Scale diff --git a/content/id/docs/3.for-admin/install/guides/manual.md b/content/id/docs/3.for-admin/install/guides/manual.md index 0efb7b3b..ead2ee7a 100644 --- a/content/id/docs/3.for-admin/install/guides/manual.md +++ b/content/id/docs/3.for-admin/install/guides/manual.md @@ -2,26 +2,28 @@ description: このガイドではMisskeyのインストール・セットアップ方法について解説します。 --- -# Misskeyを手動で構築する +# Panduan Pemasangan dan Penyetelan Misskey -このガイドではMisskeyのインストール・セットアップ方法について解説します。 +Panduan ini akan menjelaskan bagaimana cara memasang dan menyetel peladen Misskey. :::danger -一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ + +Jangan pernah mengubah nama domain (hostname) peladen ketika kamu sudah mulai menggunakannya! + ::: :::tip{label='前提条件'} -#### 以下のソフトウェアがインストール・設定されていること +#### Mohon pasang dan setel aplikasi berikut: -- **[Node.js](https://nodejs.org/en/)** (20.4.x以上) -- **[PostgreSQL](https://www.postgresql.org/)** (15以上) +- **[Node.js](https://nodejs.org/en/)** (versi 20.4.x atau di atasnya) +- **[PostgreSQL](https://www.postgresql.org/)** (versi 15 atau di atasnya) - **[Redis](https://redis.io/)** - **[FFmpeg](https://www.ffmpeg.org/)** -Debian/Ubuntuをお使いであれば、`build-essential`パッケージをインストールしておくと良いです。 +Jika kamu menggunakan Debian/Ubuntu, kamu harus memasang paket `build-essential`. -#### corepackが有効化されていること +#### `corepack` harus dinyalakan ```sh sudo corepack enable @@ -29,16 +31,15 @@ sudo corepack enable ::: -## ユーザーの作成 +## Buat pengguna -Misskeyはrootユーザーで実行しない方がよいため、代わりにユーザーを作成します。 -Debianの例: +Menjalankan Misskey sebagai root bukanlah ide yang bagus. Oleh karena itu, kita akan membuat pengguna baru untuk menangani masalah tersebut. Sebagai contoh dalam distribusi Debian: ```sh adduser --disabled-password --disabled-login misskey ``` -## Misskeyのインストール +## Pasang Misskey ```sh sudo -iu misskey @@ -49,29 +50,28 @@ git submodule update --init NODE_ENV=production pnpm install --frozen-lockfile ``` -## 設定 +## Atur -設定サンプルの`.config/example.yml`をコピーし、`default.yml`にリネームします。 +Salin berkas `.config/example.yml` dan ubah namanya ke `default.yml`. ```sh cp .config/example.yml .config/default.yml ``` -`default.yml` をファイル内の指示に従って編集します。 +Sunting `default.yml`. -## ビルドと初期化 +## Bangun dan inisialisasi -次のコマンドでMisskeyのビルドとデータベースの初期化を行います。 -これにはしばらく時間がかかります。 +Perintah berikut akan membangun Misskey dan menginisialisasi basis data. Proses ini akan memakan waktu sesaat. ```sh NODE_ENV=production pnpm run build pnpm run init ``` -## 起動 +## Jalankan -お疲れ様でした。以下のコマンドでMisskeyを起動できます。 +Selamat!Kamu sudah dapat memulai peladen Misskey dengan perintah berikut. ```sh NODE_ENV=production pnpm run start @@ -79,13 +79,13 @@ NODE_ENV=production pnpm run start GLHF✨ -::::g-details{summary="systemdを用いた管理"} +::::g-details{summary="Menjalankan dengan systemd"} -systemdサービスのファイルを作成 +Buat berkas layanan systemd di sini `/etc/systemd/system/misskey.service` -エディタで開き、以下のコードを貼り付けて保存: +Sunting, tempelkan konfigurasi berikut dan simpan: ```ini [Unit] @@ -108,35 +108,41 @@ WantedBy=multi-user.target ``` :::warning -CentOSで1024以下のポートを使用してMisskeyを使用する場合は`ExecStart=/usr/bin/sudo /usr/bin/npm start`に変更する必要があります。 + +Apabila kamu ingin menggunakan Misskey dengan port di bawah 1024 pada sistem operasi CentOS, kamu perlu mengubah `ExecStart=/usr/bin/sudo /usr/bin/npm start`. + ::: -systemdを再読み込みしmisskeyサービスを有効化 +Nyalakan ulang systemd dan nyalakan layanan misskey. ```sh sudo systemctl daemon-reload sudo systemctl enable misskey ``` -misskeyサービスの起動 +Jalankan layanan misskey. ```sh sudo systemctl start misskey ``` :::tip -`systemctl status misskey`と入力すると、サービスの状態を調べることができます。 + +Kamu dapat mengecek apakah layanannya berjalan dengan memasukkan perintah `systemctl status misskey`. + ::: :::: -## Misskeyのアップデート方法 +## Panduan memutakhirkan peladen Misskey ke versi terbaru :::warning -アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 + +Ketika memutakhirkan, pastikan mengecek [catatan rilisan](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md) untuk mengetahui lebih awal akan perubahan ataupun tambahan pekerjaan yang nantinya dibutuhkan (biasanya tidak perlu). + ::: -masterをpullし直し、インストール、ビルド、データベースのマイグレーションを行います: +Lakukan `pull` pada branch `master`, pasang, bangun dan migrasi basis data: ```sh git checkout master @@ -147,17 +153,19 @@ NODE_ENV=production pnpm run build pnpm run migrate ``` -アップデート内容、およびデータベースの規模によっては時間がかかることがあります。 +Perintah tersebut akan memakan waktu sesaat bergantung dengan konten dari pemutakhiran dan ukuran basis data. -アップデートが終わり次第、Misskeyプロセスを再起動してください。 +Setelah pemutakhiran selesai, mulai ulang proses Misskey. ```sh sudo systemctl restart misskey ``` :::tip -ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: -- `pnpm run clean`または`pnpm run clean-all` +Apabila kamu menemukan masalah pada saat memutakhirkan, coba jalankan perintah berikut: + +- `pnpm run clean` atau `pnpm run clean-all` - `pnpm rebuild` - ::: + +::: diff --git a/content/id/docs/3.for-admin/install/guides/ubuntu-manual.md b/content/id/docs/3.for-admin/install/guides/ubuntu-manual.md index 99b7b42a..2ece2d51 100644 --- a/content/id/docs/3.for-admin/install/guides/ubuntu-manual.md +++ b/content/id/docs/3.for-admin/install/guides/ubuntu-manual.md @@ -11,11 +11,15 @@ [**シェルスクリプトの詳細と使用方法はこちらから！**](./bash/) :::tip + シェルスクリプトでの開発環境へのインストールは想定されていません。 + ::: :::tip + ドメインの購入とCloudflareのセットアップ、サーバーの確保についてはご自身でご準備ください。 + ::: 不具合があれば[ @aqz@p1.a9z.dev へのメンション](https://p1.a9z.dev/@aqz)にてお知らせいただければと思います。 @@ -27,7 +31,9 @@ [docker-compose](./docker/)なら、手作業でももうちょっと簡単に実行できるはずです。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: ## はじめに @@ -52,7 +58,9 @@ OSの違い、Misskey本体や依存するソフトウェアのバージョン - ここではドメインをexample.tldとして解説を進めるので、自分が買ったドメインに適宜置き換えて読むこと。開発環境の場合はlocalhostと読み替えます（設定ファイルの項で別途説明） :::danger + 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ + ::: ## nanoの使い方 @@ -78,7 +86,9 @@ sudo adduser --disabled-password --disabled-login misskey ``` :::tip + 開発環境の場合はユーザーを分ける必要はありません + ::: ## 基本的なソフトウェアのインストールと設定 @@ -177,7 +187,9 @@ activeならOK。 nginxは、主としてリバースプロキシに用いられるWebサーバーソフトである。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。 :::tip + 開発環境の場合はnginxのセットアップは不要です + ::: nginx.orgのドキュメント http\://nginx.org/en/linux_packages.html#Ubuntu に従ってインストールする。 @@ -238,7 +250,9 @@ sudo apt install -y git build-essential サーバーをインターネットに公開する準備をする。 :::tip + 開発環境の場合はファイヤーウォールやCloudFlare、Certbotの設定は不要です + ::: ### ファイヤーウォール @@ -272,7 +286,9 @@ sudo systemctl enable ufw ``` :::tip + ufwは、netfilter(iptables)を人間が操作しやすいようにするアプリだ。インストールスクリプトは、OCI環境ではnetfilterを直接操作する。 + ::: ### CloudFlare @@ -376,7 +392,9 @@ nano .config/default.yml 設定できる値と記述方法は[.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)に書かれている。 :::tip + 開発環境の場合、urlは`url: http://localhost:3000`と指定します。 + ::: ```yml @@ -469,7 +487,9 @@ NODE_ENV=production pnpm run build ``` :::tip + 開発環境の場合、`NODE_ENV=production`は不要です。以降のコマンドでも同様に削除してください。 + ::: ### サーバーでビルドできない場合 @@ -515,7 +535,9 @@ CloudFlareのDNS設定が正しいIPアドレスになっているかもう一 ## Misskeyのデーモンを作成 :::tip + 開発環境の場合、デーモンの作成は不要です。 + ::: いったんCtrl+Cでプロセスをキルし、Misskeyをデーモンで起動する設定をしよう。 diff --git a/content/id/docs/3.for-admin/install/resources/cdn.md b/content/id/docs/3.for-admin/install/resources/cdn.md index 747e4490..030216b8 100644 --- a/content/id/docs/3.for-admin/install/resources/cdn.md +++ b/content/id/docs/3.for-admin/install/resources/cdn.md @@ -17,5 +17,7 @@ CDNで以下の設定を行なってください。 - `/api/*`以外のリクエストをすべてキャッシュする :::tip + Misskeyをアップデートした際にキャッシュのクリアは不要です。 + ::: diff --git a/content/id/docs/3.for-admin/install/resources/troubleshooting.md b/content/id/docs/3.for-admin/install/resources/troubleshooting.md index d9aff878..202e3705 100644 --- a/content/id/docs/3.for-admin/install/resources/troubleshooting.md +++ b/content/id/docs/3.for-admin/install/resources/troubleshooting.md @@ -248,6 +248,10 @@ Amazon S3に互換性のあるオブジェクトストレージであれば利 各サービス/ソフトウェアのドキュメントをよく読み、設定してみてください。 +### ローディングが終わらない + +Cloudflare を使用している場合は、Rocket LoaderやAuto Minifyが有効になっていないか確認してください。有効になっている場合は無効にすることで解決する場合があります。 + *** # まったく解決しなかった場合 diff --git a/content/id/docs/3.for-admin/moderation-tips/disable-timelines.md b/content/id/docs/3.for-admin/moderation-tips/disable-timelines.md index 7c11efa2..1a320724 100644 --- a/content/id/docs/3.for-admin/moderation-tips/disable-timelines.md +++ b/content/id/docs/3.for-admin/moderation-tips/disable-timelines.md @@ -8,7 +8,9 @@ LTLやSTLは、そのサーバー全員の投稿が見れるため、新規の もしデメリットの方が上回っていると感じたら、それらのタイムラインを無効化することも検討してください。 :::warning + 無効化を行うと、ユーザーが困惑し、短期的に見て利用者が減る可能性があります。そのため、無効化の際は影響を慎重に検討し、事前に説明してフォローを整える期間を一定程度設けることを推奨します。 + ::: なお、管理者/モデレーターは、これらのタイムラインの無効化状態は適用されず、引き続き利用することが可能です。 diff --git a/content/id/docs/4.for-developers/aiscript.md b/content/id/docs/4.for-developers/aiscript.md new file mode 100644 index 00000000..2c7c5860 --- /dev/null +++ b/content/id/docs/4.for-developers/aiscript.md @@ -0,0 +1,67 @@ +# AiScript + +AiScriptは、Misskeyの以下の箇所で使用できるスクリプト言語です。 + +- [プラグイン](./plugin/) +- [ウィジェット](/docs/for-users/features/widgets/) + - ボタン + - AiScriptコンソール + - AiScript App +- Misskey Play +- スクラッチパッド + +:::tip + +AiScriptの実装はMisskeyとは別リポジトリで、[オープンソースで公開されています](https://github.com/aiscript-dev/aiscript)。 + +::: + +## 使い方 + +AiScript標準の構文や組み込み関数などが使用できます。 + +:::tip + +ドキュメントは[こちら](https://github.com/aiscript-dev/aiscript/tree/master/docs)\ +Misskey本体のバージョンにより、使用できるAiScriptのバージョンが異なる場合があります。バージョンの確認には`<: Core:v`をScratchpadなどで実行してください。 + +::: + +これらに加え、Misskey専用の組み込み定数・関数が３グループに分けて提供されています。 + +### Misskey AiScript API + +接頭辞: `Mk:`\ +Misskey内の全てのAiScript環境で使用できる定関数群です。 +詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Mk:`とついた部分を参照して下さい。 + +### プラグインAPI + +接頭辞: `Plugin:`\ +[プラグイン](./plugin/)でのみ使用できる定関数群です。 +詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Plugin:`とついた部分を参照して下さい。 + +### UI API + +接頭辞: `Ui:`\ +[ウィジェット](/docs/for-users/features/widgets/)（AiScript App）、Misskey Play、Scratchpadで使用できます。 +ドキュメントは未整備（TODO）ですが、インターネット上に有志の方が執筆された解説記事があります。 + +### 標準入出力 + +AiScript標準で定義されている`readline`関数と`print`関数（および`<:`構文）の内部実装は、Misskey側で独自に提供されています。 + +#### readline(message) + +`message`: `str`\ +返り値: `str`\ +Misskey内の全てのAiScript環境で使用できます。\ +文字列の入力を求めるポップアップを表示します。 + +#### print(message) + +`message`: `any`\ +返り値: `null`\ +[ウィジェット](/docs/for-users/features/widgets/)（AiScriptコンソール）、Scratchpadで使用できます。\ +コンソールに文字列を出力します。\ +`<:`構文も同様の働きをします。 diff --git a/content/id/docs/4.for-developers/api/1.index.md b/content/id/docs/4.for-developers/api/1.index.md index 11ef960c..2d2c988f 100644 --- a/content/id/docs/4.for-developers/api/1.index.md +++ b/content/id/docs/4.for-developers/api/1.index.md @@ -8,7 +8,9 @@ MisskeyはAPIを公開しています。APIを使ってMisskeyクライアント ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。 :::tip -Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\ + +Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\\ + ::: diff --git a/content/id/docs/4.for-developers/api/libraries.md b/content/id/docs/4.for-developers/api/libraries.md index 18db0f35..ee634623 100644 --- a/content/id/docs/4.for-developers/api/libraries.md +++ b/content/id/docs/4.for-developers/api/libraries.md @@ -15,6 +15,8 @@ description: Misskey APIに関連するライブラリの一覧 ## Python - [Misskey.py](https://github.com/YuzuRyo61/Misskey.py) +- [MiPA](https://github.com/yupix/MiPA) +- [MiPAC](https://github.com/yupix/MiPAC) ## .Net diff --git a/content/id/docs/4.for-developers/api/permission.md b/content/id/docs/4.for-developers/api/permission.md index 7844a7fe..50dd4be7 100644 --- a/content/id/docs/4.for-developers/api/permission.md +++ b/content/id/docs/4.for-developers/api/permission.md @@ -5,7 +5,9 @@ description: アプリケーションが要求する権限の一覧 # 権限の一覧 :::tip + このページは[misskey-js](https://github.com/misskey-dev/misskey/tree/develop/packages/misskey-js)から自動生成しているため、ドキュメントや翻訳が不完全な場合があります。 + ::: diff --git a/content/id/docs/4.for-developers/api/streaming/1.index.md b/content/id/docs/4.for-developers/api/streaming/1.index.md index af767dfc..6ce5b5bc 100644 --- a/content/id/docs/4.for-developers/api/streaming/1.index.md +++ b/content/id/docs/4.for-developers/api/streaming/1.index.md @@ -5,7 +5,9 @@ description: ストリーミングAPIを使うと、リアルタイムで様々 # ストリーミングAPI :::tip + 最初に[Misskey API](../index.md)のドキュメントを読むことをお勧めします。 + ::: ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、リアクションされた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。 @@ -26,7 +28,9 @@ wss://{host}/streaming?i={token} - `{token}`の部分は、ユーザーのアクセストークンに置き換えます。 :::tip + アクセストークンは省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。 + ::: ストリームに接続すると、後述投稿の購読を行ったりすることができますが、まだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。 @@ -40,7 +44,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。 :::tip + ひとつのストリーム接続上で、同時に複数のチャンネルに接続することができます。 + ::: 以下では、チャンネルの使用方法を説明します。どのようなチャンネルがあるかは、[チャンネル一覧](./channel/index.md)を参照してください。 @@ -69,7 +75,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり - `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。 :::tip + IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。 + ::: ### チャンネルからのメッセージを受け取る diff --git a/content/id/docs/4.for-developers/api/token.md b/content/id/docs/4.for-developers/api/token.md index 8f9d3919..d0e74076 100644 --- a/content/id/docs/4.for-developers/api/token.md +++ b/content/id/docs/4.for-developers/api/token.md @@ -7,7 +7,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた** アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 :::tip + ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 + ::: あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 @@ -20,7 +22,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた** Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 :::danger + アクセストークンは他人に知られないようにしてください。 + ::: ### アプリケーション利用者にアクセストークンの発行をリクエストする @@ -32,6 +36,7 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app) + ::: #### Step 1 @@ -39,7 +44,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger + このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: #### Step 2 @@ -119,7 +126,9 @@ https://{host}/api/miauth/{session}/check APIの詳細は、APIリファレンスを参照してください。 :::warning + MisskeyはRESTを採用していません。 + ::: また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 diff --git a/content/id/docs/4.for-developers/api/token/1.index.md b/content/id/docs/4.for-developers/api/token/1.index.md new file mode 100644 index 00000000..3305efc0 --- /dev/null +++ b/content/id/docs/4.for-developers/api/token/1.index.md @@ -0,0 +1,88 @@ +# アクセストークンの取得 + +APIを使い始めるには、APIを利用するアカウントに紐づいた**アクセストークン**を取得する必要があります。 +このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。 + +基本的に、APIはリクエストにはアクセストークンが必要となります。 +アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 + +:::tip + +ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 + +::: + +あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 + +- 前者の場合: **「自分自身のアクセストークンを手動発行する」** に進む +- 後者の場合: **「アプリケーション利用者にアクセストークンの発行をリクエストする」** に進む + +## 自分自身のアクセストークンを手動発行する + +Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 + +:::danger + +アクセストークンは他人に知られないようにしてください。 + +::: + +## アプリケーション利用者にアクセストークンの発行をリクエストする + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の方法の一つを使います。 + +:MkIndex + +## APIの利用 + +アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。 + +:::tip + +- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。 +- 要求ヘッダーに`Content-Type: application/json`を指定します。 +- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。 +- ベースURLは`https://{サーバーのドメイン}/api`です。 + +::: + +### Authorization headerを使う方式 + +以下のようにヘッダーの`Authorization`フィールドを指定します。 + +```js +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + text: "Hello Misskey API World with My Application!" + }), + headers: { + Authorization: `Bearer ${accessToken}`, + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` + +### iを使う方式 + +アクセストークン付きのボディの例（metaの場合）: + +```json +{ + "i": "HogEFugA1341", + "detail": false +} +``` + + + +APIの詳細は、APIリファレンスを参照してください。 + +:::warning + +MisskeyはRESTを採用していません。 + +::: + +また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](../streaming/)を参照してください。 diff --git a/content/id/docs/4.for-developers/api/token/2.miauth.md b/content/id/docs/4.for-developers/api/token/2.miauth.md new file mode 100644 index 00000000..1100db0d --- /dev/null +++ b/content/id/docs/4.for-developers/api/token/2.miauth.md @@ -0,0 +1,76 @@ +--- +description: v12.27.0以降で使用できる、Misskey独自の簡素な認証方法について説明しています。 +--- + +# MiAuth方式でのアクセストークン取得方式 + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 + +:::tip + +以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 + +- [よりおおく使われているOAuth方式でのアクセストークン取得方法もあります。](./oauth.md) +- [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app.md) + +::: + +## Step 1 + +UUIDを生成する。以後これを**セッションID**と呼びます。 + +:::danger + +このセッションIDは毎回生成し、使いまわさないようにしてください。 + +::: + +## Step 2 + +アプリケーション認証フォームをユーザーのブラウザで表示させる。認証フォームは、以下の形式のURLで開くことができます: + +``` +https://{host}/miauth/{session} +``` + +ここで、 + +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 +- `{session}`の部分は、セッションIDに置き換えます。 + +また、URLにクエリパラメータとしていくつかのオプションを設定できます: + +| 名前 | 説明 | +| ------------ | ------------------------------------------------------------------------------ | +| `name` | アプリケーション名。 | +| `icon` | アプリケーションのアイコン画像URL。 | +| `callback` | 認証が終わった後にリダイレクトするURL。
リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 | +| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 | + +:::tip{label='例'} + +``` +https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive +``` + +::: + +## Step 3 + +ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 + +``` +https://{host}/api/miauth/{session}/check +``` + +ここで、 + +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。 +- `{session}`の部分は、セッションIDに置き換えます。 + +レスポンスに含まれるプロパティは以下の通りです: + +| 名前 | 説明 | +| ------- | -------------- | +| `token` | ユーザーのアクセストークン。 | +| `user` | ユーザーの情報。 | diff --git a/content/id/docs/4.for-developers/api/token/3.oauth.md b/content/id/docs/4.for-developers/api/token/3.oauth.md new file mode 100644 index 00000000..a29644ab --- /dev/null +++ b/content/id/docs/4.for-developers/api/token/3.oauth.md @@ -0,0 +1,179 @@ +--- +description: v2023.9.0以降で使用できる、OAuth2.0方式での認証方法について説明しています。 +--- + +# OAuth方式でのアクセストークン取得方式 + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 + +:::tip + +以下に説明する方法は、[OAuth 2.0](https://datatracker.ietf.org/doc/html/rfc6749.html)と呼ばれるものです。普通のOAuthはアプリを作成しますが、[IndieAuth](https://indieauth.spec.indieweb.org/)の拡張でアプリ作成なしで使えるようになっています。 + +OAuth方式は使えるライブラリが多いので、出来ればライブラリを使うのをおすすめします。 + +現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。 + +- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md) +- [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md) + +::: + +## Step 1 + +アプリ紹介のためのウェブページを作ります。ページがHTTPSアドレスでアクセスできるようにしてください。ページのとこかに以下のようなHTMLコードを書きます。 + +```html + + + + +
+ My Misskey App +
+``` + +あとで`redirect_uri`のアドレスに認証コードが転送されます。 + +## Step 2 + +PKCE `code_verifier`と`code_challenge`文字列, 及び`state`文字列を生成します。 + +- `code_verifier`の場合は最低43字、最高128字でアルファベット大・小文字及び`-._~`の中の文字に限られます。 +- `code_challenge`文字列は`code_verifier`文字列をSHA256アルゴリズムでハッシュしてbase64urlでエンコードした結果を使います。 +- `state`文字列には特別な制限はありません。ランダムな文字列を使います。 + +:::danger + +この文字列は毎回生成し、使いまわさないようにしてください。 + +::: + +:::tip + +[pkce-challenge](https://www.npmjs.com/package/pkce-challenge)とかのライブラリを使ったり、OAuthライブラリのPKCE機能を使うのがおすすめです。 + +::: + +:::tip{label='例'} + +```js +import crypto from "node:crypto"; + +const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-._~"; +const codeVerifier = new Array(128) + .fill(0) + .map(() => chars[Math.floor(chars.length * Math.random())]) + .join(""); +console.log('code_verifier', codeVerifier); + +const codeChallenge = crypto + .createHash("sha256") + .update(codeVerifier, "ascii") + .digest("base64url"); +console.log('code_challenge', codeChallenge); + +const state = crypto.randomUUID(); +console.log('state', state); +``` + +::: + +## Step 3 + +相手サーバーのOAuth情報を取得します。データはJSON形式になっています。 + +``` +https://{host}/.well-known/oauth-authorization-server +``` + +`{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 + +ここでは`authorization_endpoint`と`token_endpoint`を使います。 + +:::tip + +次のステップで使われる`scope`の情報も`scopes_supported`で確認できます。 + +::: + +## Step 4 + +アプリケーション認証フォームをユーザーのブラウザで表示させます。認証フォームは、以下の形式のURLで開くことができます: + +``` +{authorization_endpoint}?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&scope={scope}&code_challenge={code_challenge}&code_challenge_method=S256&state={state} +``` + +ここで、 + +- `{authorization_endpoint}`の部分は、前の情報取得で得たアドレスに置き換えます。 +- `{client_id}`の部分は、アプリの紹介ページのアドレスに置き換えます。 +- `{code_challenge}`の部分は、前に生成した`code_challenge`文字列に置き換えます +- `code_challenge_method`の部分は常に`S256`にします。 +- `{redirect_uri}`の部分は、紹介ページで使っている配達先のアドレスに置き換えます。 +- `{scope}`の部分は、アプリケーションが要求する権限に置き換えます。要求する権限を` `で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 +- `{state}`の部分は、前に生成した`state`文字列に置き換えます。 + +:::tip{label='例'} + +``` +https://misskey.local/oauth/authorize?client_id=http%3A%2F%2Fexample.com&code_challenge=C6hwMO2bmIzg3nqppTE9b79fvuOjlrKmH2xNiZSMHzw&code_challenge_method=S256&response_type=code&redirect_uri=http%3A%2F%2Fexample.com%2Fredirect&scope=write%3Anotes&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +## Step 5 + +ユーザーがアプリケーションアクセスを許可したら、`redirect_uri`のアドレスに認証コードがURLパラメータの形式で転送されます。 + +| 名前 | 説明 | +| ------- | ----------------------- | +| `code` | ユーザーの認証コード。 | +| `state` | 認証リクエストに使われた`state`文字列。 | + +:::tip{label='例'} + +``` +https://example.com/redirect?code=...&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +`state`文字列がちゃんと一致しているのか確認して、次のステップに進みます。 + +## Step 6 + +転送された認証コードを使ってアクセストークンをPOSTでリクエストします。リクエスト先は`token_endpoint`になります。データ形式は`application/json`と`application/x-www-form-urlencoded`を使えます。各パラメータは以下のようになります。 + +| 名前 | 説明 | +| --------------- | ------------------------------ | +| `grant_type` | 常に`authorization_code`にします。 | +| `client_id` | 認証リクエストに使われた`client_id`文字列。 | +| `redirect_uri` | 認証リクエストに使われた`redirect_uri`文字列。 | +| `scope` | 認証リクエストに使われた`scope`文字列。 | +| `code` | 取得した認証コード。　 | +| `code_verifier` | 前に生成した`code_verifier`文字列。 | + +:::tip{label='例'} + +```js +const res = await fetch(endpoint, { + method: "POST", + body: JSON.stringify({ + grant_type: "authorization_code", + client_id: "https://example.com", + redirect_uri: "https://example.com/redirect", + scope: "write:notes", + code: "...", + code_verifier: "hjjbCYDmDpSLjirkO-PrfWKsRhDdJr-PAEGRClRwzUKlmFIIIrZNmSvUIraeIa~WqbqQnfbJV-Hc_IfuQkesBYUpukUi~lInDfU_AZjoZqbU.ioQTRzaFfZFfGnT-OAA", + }), + headers: { + "Content-Type": "application/json" + } +}); +``` + +::: + +レスポンスはJSONオブジェクト形式で、そこから`access_token`を取得して使います。 diff --git a/content/id/docs/4.for-developers/plugin/create-plugin.md b/content/id/docs/4.for-developers/plugin/create-plugin.md index 5e5130ca..cd9bf91e 100644 --- a/content/id/docs/4.for-developers/plugin/create-plugin.md +++ b/content/id/docs/4.for-developers/plugin/create-plugin.md @@ -74,4 +74,4 @@ Misskey Webはプラグインに対してAPIを公開していて、それらを v2023.11.0以降では、あなたのウェブサイトからワンクリックでプラグインを直接インストールできるようになっています。 -プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](./publish-on-your-website.md)をご覧ください。 +プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](../publish-on-your-website.md)をご覧ください。 diff --git a/content/id/docs/5.releases.md b/content/id/docs/5.releases.md index b7879489..17c4324b 100644 --- a/content/id/docs/5.releases.md +++ b/content/id/docs/5.releases.md @@ -6,6 +6,49 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2023.12.2 + +リリース日: 2023/12/28 + +### General + +- v2023.12.1でDockerを利用してサーバーを起動できない問題を修正 + +### Client + +- Enhance: 検索画面においてEnterキー押下で検索できるように + +## 2023.12.1 + +リリース日: 2023/12/27 + +### Note + +- アクセストークンの権限が再整理されたため、一部のAPIが古いAPIトークンでは動作しなくなりました。\ + 権限不足になる場合には権限を再設定して再生成してください。 + +### General + +- Enhance: ローカリゼーションの更新 +- Fix: 自分のdirect noteがuser list timelineに追加されない + +### Client + +- Feat: AiScript専用のMFM構文`$[clickable.ev=EVENTNAME ...]`を追加。`Mk:C:mfm`のオプション`onClickEv`に関数を渡すと、クリック時に`EVENTNAME`を引数にして呼び出す +- Enhance: MFM入力補助ボタンを投稿フォームに表示できるように #12787 +- Fix: 一部のモデログ(logYellowでの表示対象)について、表示の色が変わらない問題を修正 +- Fix: `fg`/`bg`MFMに長い単語を指定すると、オーバーフローされずはみ出る問題を修正 + +### Server + +- Enhance: センシティブワードの設定がハッシュタグトレンドにも適用されるようになりました +- Enhance: `oauth/token`エンドポイントのCORS対応 +- Fix: 1702718871541-ffVisibility.jsのdownが壊れている +- Fix:「非センシティブのみ（リモートはいいねのみ）」を設定していても、センシティブに設定されたカスタム絵文字をリアクションできる問題を修正 +- Fix: ロールアサイン時の通知で，ロールアイコンが縮小されずに表示される問題を修正 +- Fix: サードパーティアプリケーションがWebsocket APIに無条件にアクセスできる問題を修正 +- Fix: サードパーティアプリケーションがユーザーの許可なしに非公開の情報を見ることができる問題を修正 + ## 2023.12.0 リリース日: 2023/12/23 @@ -1957,7 +2000,9 @@ same as 12.112.0 ### NOTE :::warning + このバージョンからNode v16.14.0以降が必要です + ::: ### Changes @@ -2069,12 +2114,16 @@ same as 12.112.0 ### Note :::warning + ビルドする前に`npm run clean`を実行してください。 + ::: :::warning + このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 + ::: ### Improvements @@ -2145,6 +2194,7 @@ same as 12.112.0 アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。 12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。 + ::: ### Changes diff --git a/content/it/docs/1.about-misskey.md b/content/it/docs/1.about-misskey.md index a67dba09..78d3b431 100644 --- a/content/it/docs/1.about-misskey.md +++ b/content/it/docs/1.about-misskey.md @@ -15,7 +15,9 @@ Misskeyはオープンソースの分散型マイクロブログプラットフ 当初は分散型ではありませんでしたが、2018年にActivityPubを実装し分散型になったことで、より多くの方に認知され利用されるサービスになり、現在に至ります。 :::tip + Misskeyという名前は、syuiloが当時聴いていたMay'nというアーティストの楽曲、Brain Diverの歌詞に由来します。 + ::: 誰でも開発に参加することができ、現在でも活発に開発が続いています。 @@ -35,7 +37,9 @@ Misskeyのすべてのソースコードは[AGPL](https://github.com/misskey-dev 再び引き合いに出しますが、TwitterやFacebookなどの利益を得ているほとんどのサービスはオープンソースではありません。 :::tip + 技術的に言うと、MisskeyのソースコードはGitで管理されていて、リポジトリは[GitHub上でホスティングされています。](https://github.com/misskey-dev) + ::: ## 開発に参加する、プロジェクトを支援する @@ -143,8 +147,11 @@ Misskeyは開発が進むにつれ使用する技術も大きく変わってき :::fukidashi{chara="doya_ai" charaName="藍"} わたしについては[このホームページ](https://xn--931a.moe/)をご覧ください！ + ::: :::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"} + Misskeyの守り神、藍ちゃんです。ｱｲﾁｬﾝｶﾜｲｲﾔｯﾀｰ! + ::: diff --git a/content/it/docs/2.for-users/2.onboarding/2.get-started.md b/content/it/docs/2.for-users/2.onboarding/2.get-started.md index aa4d1522..69e63d26 100644 --- a/content/it/docs/2.for-users/2.onboarding/2.get-started.md +++ b/content/it/docs/2.for-users/2.onboarding/2.get-started.md @@ -11,14 +11,17 @@ Misskeyを利用するには、どこかのサーバーにアカウントを作 [サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。 :::tip + どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 :::g-details{summary='詳細'} + Misskeyには連合機能が備わっています。 連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。 Misskeyが搭載している連合機能はActivityPubというオープンな共通規格に基づいていて、MastodonやPleromaといったほかのソフトウェアとも互換性があります。 + ::: ::: @@ -31,5 +34,7 @@ Misskeyが搭載している連合機能はActivityPubというオープンな 自分にあったテーマのサーバーを探すのもおすすめです。 :::tip + サーバーの一覧は[こちら](/servers/)からご覧いただけます。 + ::: diff --git a/content/it/docs/2.for-users/2.onboarding/3.join-server.md b/content/it/docs/2.for-users/2.onboarding/3.join-server.md index 6f42c0c1..7c26053a 100644 --- a/content/it/docs/2.for-users/2.onboarding/3.join-server.md +++ b/content/it/docs/2.for-users/2.onboarding/3.join-server.md @@ -3,9 +3,11 @@ 登録するサーバーが決まったら、さっそくアカウントを作成しましょう。 :::tip + ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 ただし、入力事項はサーバーによって異なることがあります。詳しくは、サーバー管理者にお問い合わせください。 + ::: ## 登録する diff --git a/content/it/docs/2.for-users/2.onboarding/4.things-to-know.md b/content/it/docs/2.for-users/2.onboarding/4.things-to-know.md index e77c9aa2..d5428ffb 100644 --- a/content/it/docs/2.for-users/2.onboarding/4.things-to-know.md +++ b/content/it/docs/2.for-users/2.onboarding/4.things-to-know.md @@ -7,7 +7,9 @@ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一般的なSNSに比べたくさんの機能がありますので、初めての投稿を行う前に必ず確認して、上手に投稿しましょう！ :::tip + 詳細は、「[ノート](/docs/for-users/features/note/)」をご覧ください。 + ::: ## タイムライン @@ -15,7 +17,9 @@ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一 Misskeyは、複数のタイムラインを持っています。名前だけでは少々わかりにくいかと思いますので、それぞれがどのような働きをするのかを知っておきましょう。 :::tip + 詳細は、「[タイムライン](/docs/for-users/features/timeline/)」をご覧ください。 + ::: ## その他 diff --git a/content/it/docs/2.for-users/3.features/ads.md b/content/it/docs/2.for-users/3.features/ads.md index 456c5790..72aa40ec 100644 --- a/content/it/docs/2.for-users/3.features/ads.md +++ b/content/it/docs/2.for-users/3.features/ads.md @@ -4,7 +4,9 @@ Misskeyではサーバーによる広告をタイムラインなどに表示で 広告の右上に表示されるアイコンをクリックすることで、当該の広告の表示頻度を下げることができます。 :::tip + 広告の総数が少ない場合は、表示頻度を下げた後も連続で表示される可能性があります。 + ::: ## 広告の設定(管理者) diff --git a/content/it/docs/2.for-users/3.features/drive.md b/content/it/docs/2.for-users/3.features/drive.md index 3fc879de..81f0417d 100644 --- a/content/it/docs/2.for-users/3.features/drive.md +++ b/content/it/docs/2.for-users/3.features/drive.md @@ -3,7 +3,9 @@ ドライブは、Misskey上でファイルを管理できる機能です。 :::tip + 技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。 + ::: Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。 @@ -13,7 +15,9 @@ Misskey Webのドライブページから任意のファイルをアップロー ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。 :::warning + 現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。 + ::: ## センシティブ (NSFW) diff --git a/content/it/docs/2.for-users/3.features/mfm.md b/content/it/docs/2.for-users/3.features/mfm.md index 5771232a..6ec1aa36 100644 --- a/content/it/docs/2.for-users/3.features/mfm.md +++ b/content/it/docs/2.for-users/3.features/mfm.md @@ -7,7 +7,9 @@ description: MFMは、Misskeyの様々な場所で使用できる専用のマー MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。 :::tip + 一部の構文はMarkdownやHTMLと互換性があります。 + ::: ## MFMが使用可能な場所の例 @@ -23,7 +25,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使 アットマーク + ユーザー名で、特定のユーザーを示すことができます。 :::tip + メンションについての詳細は[こちら](./mention.md)を参照してください。 + ::: ``` @@ -42,7 +46,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使 ナンバーサイン + タグで、ハッシュタグを示すことができます。 :::tip + ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。 + ::: ``` @@ -70,6 +76,7 @@ https://example.com ``` :::tip + リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。 ``` @@ -83,8 +90,11 @@ https://example.com ### カスタム絵文字 コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。 + :::tip + カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。 + ::: ``` diff --git a/content/it/docs/2.for-users/3.features/mute-and-block.md b/content/it/docs/2.for-users/3.features/mute-and-block.md index 9ff1ddf9..6fa407ce 100644 --- a/content/it/docs/2.for-users/3.features/mute-and-block.md +++ b/content/it/docs/2.for-users/3.features/mute-and-block.md @@ -5,11 +5,15 @@ ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。 :::tip + ミュートとブロックは併用できます。 + ::: :::warning + 利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。 + ::: Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。 @@ -26,7 +30,9 @@ Misskey Webでは、設定>ミュートとブロック から、自分がミュ Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。 :::tip + ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。 + ::: ## ブロック @@ -48,9 +54,13 @@ Misskey Webでユーザーをミュートするには、対象のユーザーの Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。 :::warning + ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。 + ::: :::warning + 相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。 + ::: diff --git a/content/it/docs/2.for-users/3.features/pages.md b/content/it/docs/2.for-users/3.features/pages.md index 21a59a21..0bb1232f 100644 --- a/content/it/docs/2.for-users/3.features/pages.md +++ b/content/it/docs/2.for-users/3.features/pages.md @@ -3,7 +3,9 @@ Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。 :::warning + v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。 + ::: ## ページ設定 diff --git a/content/it/docs/2.for-users/3.features/poll.md b/content/it/docs/2.for-users/3.features/poll.md index c96f89a1..32777ede 100644 --- a/content/it/docs/2.for-users/3.features/poll.md +++ b/content/it/docs/2.for-users/3.features/poll.md @@ -13,7 +13,9 @@ 追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。 :::warning + いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。 + ::: ## 複数回答を可能にする @@ -41,7 +43,9 @@ 未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。 :::tip + 未投票アンケートには、結果を表示した状態でも投票できます。 + ::: 投票をすると、自分の投票した選択肢に✔がつきます。 diff --git a/content/it/docs/2.for-users/3.features/share-form.md b/content/it/docs/2.for-users/3.features/share-form.md index 0bd8a69a..e65fd555 100644 --- a/content/it/docs/2.for-users/3.features/share-form.md +++ b/content/it/docs/2.for-users/3.features/share-form.md @@ -7,7 +7,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく ## クエリパラメータ :::tip + すべてのパラメータは**オプション**であり、必須ではありません。 + ::: | 名前 | 説明 | @@ -46,7 +48,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく | `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) | :::warning + `visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。 + ::: ### 添付ファイル diff --git a/content/it/docs/2.for-users/3.features/thread-mute.md b/content/it/docs/2.for-users/3.features/thread-mute.md index ab4bd823..2f4378ba 100644 --- a/content/it/docs/2.for-users/3.features/thread-mute.md +++ b/content/it/docs/2.for-users/3.features/thread-mute.md @@ -1,7 +1,9 @@ # スレッドミュート :::tip + バージョン 12.95.0 以降の機能です。 + ::: スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。 @@ -11,5 +13,7 @@ Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。 :::warning + スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。 + ::: diff --git a/content/it/docs/2.for-users/3.features/webhook.md b/content/it/docs/2.for-users/3.features/webhook.md index eab0e71c..2061d91d 100644 --- a/content/it/docs/2.for-users/3.features/webhook.md +++ b/content/it/docs/2.for-users/3.features/webhook.md @@ -1,11 +1,15 @@ # Webhook :::tip + バージョン 12.109.0 以降の機能です。 + ::: :::warning + 実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。 + ::: MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。 @@ -18,33 +22,33 @@ Webhookが登録されると、指定したイベントが発生した際に、 リクエストペイロードは以下のプロパティが入ります。 送信先サーバーが5xxエラーを返すか、応答しなかった場合は時間を開けてリクエストが再送されます。 @@ -57,22 +61,6 @@ Webhookは管理画面から個別にアクティブ状態を設定でき、一 ### follow -自分が誰かをフォローした際に発生します。 - - - -### followed - -自分が誰かからフォローされた際に発生します。 - -### unfollow + -自分が誰かをフォロー解除した際に発生します。 +### followed -### note + -自分がノートを投稿した際に発生します。 +### unfollow -### reply + -自分のノートに返信された際に発生します。 +### note -### renote + -自分のノートがRenoteされた際に発生します。 +### reply -### mention + -自分にメンションされた際に発生します。 +### renote + + + +### mention + +自分にメンションされた際に発生します。 + + diff --git a/content/it/docs/2.for-users/4.resources/1.troubleshooting.md b/content/it/docs/2.for-users/4.resources/1.troubleshooting.md index 03b877a9..2aef90d3 100644 --- a/content/it/docs/2.for-users/4.resources/1.troubleshooting.md +++ b/content/it/docs/2.for-users/4.resources/1.troubleshooting.md @@ -5,7 +5,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ # トラブルシューティング :::tip + [よくある質問](./faq.md)も合わせてお役立てください。 + ::: 問題が発生したときは、まずこちらをご確認ください。 @@ -59,7 +61,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ クライアントの設定の「キャッシュをクリア」すると直ります。 :::warning + 「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。 + ::: ## 通知やアンテナ等の点滅が消えない diff --git a/content/it/docs/2.for-users/4.resources/donate.md b/content/it/docs/2.for-users/4.resources/donate.md index 0972cb72..bbd32212 100644 --- a/content/it/docs/2.for-users/4.resources/donate.md +++ b/content/it/docs/2.for-users/4.resources/donate.md @@ -13,22 +13,27 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip + 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 + ::: :::tip + 額に応じて以下の返礼を用意しています。 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 - 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載 - 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載 - ::: + +::: :::warning -:::warning + **バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。** + (メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります) -::: + ::: また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。 diff --git a/content/it/docs/2.for-users/4.resources/misskey-hub.md b/content/it/docs/2.for-users/4.resources/misskey-hub.md index bbdce97a..87114f3d 100644 --- a/content/it/docs/2.for-users/4.resources/misskey-hub.md +++ b/content/it/docs/2.for-users/4.resources/misskey-hub.md @@ -6,7 +6,9 @@ Misskey Hubは、Misskeyに関するナレッジなどのドキュメント、 Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub) :::tip + Misskey HubはNuxtを使ってビルドされた静的サイトです。 + ::: ## Misskey Hubに貢献する diff --git a/content/it/docs/3.for-admin/features/announcement.md b/content/it/docs/3.for-admin/features/announcement.md index 54475e35..caaa6436 100644 --- a/content/it/docs/3.for-admin/features/announcement.md +++ b/content/it/docs/3.for-admin/features/announcement.md @@ -5,12 +5,14 @@ お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。 :::warning + アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。 - 「既存ユーザーのみ」オプションを有効にしてお知らせを作成する - 「非通知」オプションを有効にしてお知らせを作成する - 終了したお知らせはアーカイブする - ::: + +::: ## 表示形式 diff --git a/content/it/docs/3.for-admin/features/role.md b/content/it/docs/3.for-admin/features/role.md index 6ed15743..a5aeb766 100644 --- a/content/it/docs/3.for-admin/features/role.md +++ b/content/it/docs/3.for-admin/features/role.md @@ -21,11 +21,13 @@ - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) :::warning + コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 - 手動でのアサイン/アサイン解除は行えません。 - 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。 - ::: + +::: ## 権限 @@ -53,6 +55,7 @@ **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** :::tip + 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 @@ -62,7 +65,8 @@ - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ::: + +::: ### ベースロールの値を使用 @@ -85,13 +89,15 @@ アサインする際にアサインされる期間を設定することが可能です。 :::tip -:::tip + ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。 -::: + ::: :::warning + コンディショナル ロールには手動でのアサインはできません。 + ::: ## ユーザーのポリシーの確認 diff --git a/content/it/docs/3.for-admin/install/guides/1.index.md b/content/it/docs/3.for-admin/install/guides/1.index.md index 73c48d68..012ad01f 100644 --- a/content/it/docs/3.for-admin/install/guides/1.index.md +++ b/content/it/docs/3.for-admin/install/guides/1.index.md @@ -7,15 +7,19 @@ description: Misskeyサーバーの作成方法についての案内です。 Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::warning + 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。 詳しくは [misskey-dev/misskey #9791](https://github.com/misskey-dev/misskey/issues/9791) をご覧ください。 + ::: ## Xserver VPSでインストール diff --git a/content/it/docs/3.for-admin/install/guides/bash.md b/content/it/docs/3.for-admin/install/guides/bash.md index 09a6ede6..b7762eba 100644 --- a/content/it/docs/3.for-admin/install/guides/bash.md +++ b/content/it/docs/3.for-admin/install/guides/bash.md @@ -20,7 +20,9 @@ Misskeyを簡単にインストールするためのシェルスクリプトが 3. Cloudflareアカウント（推奨） :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。 @@ -28,7 +30,6 @@ Let's Encryptの認証を試行できる回数が少ないので、サーバー ## Cloudflareの設定 Cloudflareを使う場合、Cloudflareのドメインの設定を完了してからインストールを開始するようにしてください。\ -\ ネームサーバーの適用には最大で3日程度かかる場合があります。 また、nginxとCloudflareを設定する場合、Cloudflareの設定画面にて、 @@ -41,7 +42,6 @@ Cloudflareを使う場合、Cloudflareのドメインの設定を完了してか ### 1. SSH サーバーにSSH接続します。\ -\ （サーバーのデスクトップを開いている方はシェルを開きましょう。） ### 2. 環境を最新にする @@ -113,13 +113,10 @@ iptablesを使うようにしてください。 v1から、インストールメソッドにsystemdとDockerとを選べるようにしました。 Dockerと言っても、**MisskeyだけをDockerで実行**し、RedisやPostgresなどはホストで直接実行します。\ -\ [docker-composeですべての機能を動かす方法については、mamemonongaさんが作成したこちらの記事がおすすめです。](https://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0) Docker Hubイメージを使う設定であれば、Misskeyのビルドが不要になるため、**一番お勧めです**。\ -\ ただし、マイグレーションは必要なので、アップデート時にMisskeyを使えない時間がゼロになるわけではありません。\ -\ また、Misskeyのビルド環境を準備しない(git pullしない)ので、フォークを動かしたくなった時に設定が面倒になります。 ローカルでDockerをビルドする方式は、パフォーマンス面で非推奨です。 @@ -147,14 +144,12 @@ systemdは、Docker Hubにイメージを上げるまでもないものの、フ 万が一途中で失敗してもう一度スクリプトを動作させる場合、次のことに注意してください。 - RedisやPostgresのインストールが終わっている場合、「install locally」はNoにしてください。\ - \ host・port設定はそのままEnterを押します。 ユーザー名やパスワードは、前回実行した際に指定したものを入力します。 ## .envファイルについて インストールスクリプトは、2つの.envファイルを作成します。\ -\ アップデートの際に使用します。 ### /root/.misskey.env @@ -165,14 +160,12 @@ misskeyを実行するユーザーを覚えておくために必要です。 systemdの場合に生成されます。\ \ -主にディレクトリを覚えておくのに使用します。 +実行されているコンテナとイメージの番号を保存しています。 ### /home/(misskeyユーザー)/.misskey-docker.env Dockerの場合に生成されます。\ -\ 実行されているコンテナとイメージの番号を保存しています。\ -\ コンテナの番号はアップデートの際に更新されます。古いイメージは削除されます。 ## 自分で管理する @@ -184,7 +177,6 @@ Dockerの場合に生成されます。\ ### Misskeyディレクトリ Misskeyのソースは`/home/ユーザー/ディレクトリ`としてcloneされます。\ -\ （ユーザー、ディレクトリの初期値はともにmisskeyです。） Misskeyディレクトリへは、以下のように移動するとよいでしょう。 @@ -203,7 +195,6 @@ exit ### systemd systemdのプロセス名はexample.comです。\ -\ たとえば再起動するには次のようにします。 ``` @@ -259,7 +250,6 @@ requirepassとbindを`/etc/redis/misskey.conf`で設定しています。 ## Q. アップデート後に502でアクセスできない Dockerでは、起動後にマイグレーションをするため、すぐにアクセスできません。\ -\ マイグレーションが終わっているかどうか確認してみてください。 systemdの場合では、pnpm installに失敗している可能性があります。 @@ -275,5 +265,4 @@ journalctlでログを確認すると、たいていre2が云々という記述 ## Q. 同じサーバーにもう1つMisskeyを建てたい スクリプトは同じサーバーに追加でMisskeyをインストールすることは想定していません。\ -\ 幾つかの設定が上書きされるか、途中でエラーになってしまうでしょう。 diff --git a/content/it/docs/3.for-admin/install/guides/docker.md b/content/it/docs/3.for-admin/install/guides/docker.md index 69402049..08c0a65f 100644 --- a/content/it/docs/3.for-admin/install/guides/docker.md +++ b/content/it/docs/3.for-admin/install/guides/docker.md @@ -7,13 +7,16 @@ description: このガイドはDockerを使ったMisskeyセットアップ方法 このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::tip{label='前提条件'} - DockerおよびDocker Composeがインストールされていること。 - ::: + +::: ## リポジトリの取得 @@ -34,7 +37,6 @@ cp ./docker-compose_example.yml ./docker-compose.yml ``` `default.yml`と`docker.env`をファイル内の説明に従って編集してください。\ -\ また、必要に応じて、`docker-compose.yml`を編集します。(ポートを変更したい場合など) ## ビルドと初期化 @@ -60,9 +62,9 @@ GLHF✨ ## Misskeyのアップデート方法 :::warning -:::warning + アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 -::: + ::: ```sh diff --git a/content/it/docs/3.for-admin/install/guides/kubernetes.md b/content/it/docs/3.for-admin/install/guides/kubernetes.md index 8d0905fd..e313669a 100644 --- a/content/it/docs/3.for-admin/install/guides/kubernetes.md +++ b/content/it/docs/3.for-admin/install/guides/kubernetes.md @@ -3,14 +3,16 @@ このガイドでは、Kubernetes と HelmChartを使用したMisskeyセットアップ方法について説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: ## TrueCharts と TrueNAS Scale MisskeyのHelmChartsはTrueNAS Scaleで使用するためのTrueChartsで公開されていますが、HelmChartsとしてインストールすることもできます。 -[TrueCharts](https://truecharts.org/charts/description_list) のサイトには利用可能なすべてのChartsやインストール方法などのドキュメントがあります。 +現在、Misskeyは_incubator_ trainで進行中です。 また、不明な点があればTrueChartsの[Discord](https://discord.gg/Ax9ZgzKx9t)サーバーで質問をすることもできます。 diff --git a/content/it/docs/3.for-admin/install/guides/manual.md b/content/it/docs/3.for-admin/install/guides/manual.md index 0efb7b3b..d17aa4f6 100644 --- a/content/it/docs/3.for-admin/install/guides/manual.md +++ b/content/it/docs/3.for-admin/install/guides/manual.md @@ -7,7 +7,9 @@ description: このガイドではMisskeyのインストール・セットアッ このガイドではMisskeyのインストール・セットアップ方法について解説します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ + ::: :::tip{label='前提条件'} @@ -108,7 +110,9 @@ WantedBy=multi-user.target ``` :::warning + CentOSで1024以下のポートを使用してMisskeyを使用する場合は`ExecStart=/usr/bin/sudo /usr/bin/npm start`に変更する必要があります。 + ::: systemdを再読み込みしmisskeyサービスを有効化 @@ -125,7 +129,9 @@ sudo systemctl start misskey ``` :::tip + `systemctl status misskey`と入力すると、サービスの状態を調べることができます。 + ::: :::: @@ -133,7 +139,9 @@ sudo systemctl start misskey ## Misskeyのアップデート方法 :::warning + アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 + ::: masterをpullし直し、インストール、ビルド、データベースのマイグレーションを行います: @@ -156,8 +164,10 @@ sudo systemctl restart misskey ``` :::tip + ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: - `pnpm run clean`または`pnpm run clean-all` - `pnpm rebuild` - ::: + +::: diff --git a/content/it/docs/3.for-admin/install/guides/ubuntu-manual.md b/content/it/docs/3.for-admin/install/guides/ubuntu-manual.md index 99b7b42a..f86a16fa 100644 --- a/content/it/docs/3.for-admin/install/guides/ubuntu-manual.md +++ b/content/it/docs/3.for-admin/install/guides/ubuntu-manual.md @@ -11,11 +11,15 @@ [**シェルスクリプトの詳細と使用方法はこちらから！**](./bash/) :::tip + シェルスクリプトでの開発環境へのインストールは想定されていません。 + ::: :::tip + ドメインの購入とCloudflareのセットアップ、サーバーの確保についてはご自身でご準備ください。 + ::: 不具合があれば[ @aqz@p1.a9z.dev へのメンション](https://p1.a9z.dev/@aqz)にてお知らせいただければと思います。 @@ -27,7 +31,9 @@ [docker-compose](./docker/)なら、手作業でももうちょっと簡単に実行できるはずです。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: ## はじめに @@ -52,7 +58,9 @@ OSの違い、Misskey本体や依存するソフトウェアのバージョン - ここではドメインをexample.tldとして解説を進めるので、自分が買ったドメインに適宜置き換えて読むこと。開発環境の場合はlocalhostと読み替えます（設定ファイルの項で別途説明） :::danger + 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ + ::: ## nanoの使い方 @@ -78,7 +86,9 @@ sudo adduser --disabled-password --disabled-login misskey ``` :::tip + 開発環境の場合はユーザーを分ける必要はありません + ::: ## 基本的なソフトウェアのインストールと設定 @@ -174,10 +184,12 @@ activeならOK。 ### nginx -nginxは、主としてリバースプロキシに用いられるWebサーバーソフトである。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。 +http\://localhost にアクセスし、\*Welcome to nginx!\*と表示されればOK。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。 :::tip + 開発環境の場合はnginxのセットアップは不要です + ::: nginx.orgのドキュメント http\://nginx.org/en/linux_packages.html#Ubuntu に従ってインストールする。 @@ -238,7 +250,9 @@ sudo apt install -y git build-essential サーバーをインターネットに公開する準備をする。 :::tip + 開発環境の場合はファイヤーウォールやCloudFlare、Certbotの設定は不要です + ::: ### ファイヤーウォール @@ -272,7 +286,9 @@ sudo systemctl enable ufw ``` :::tip + ufwは、netfilter(iptables)を人間が操作しやすいようにするアプリだ。インストールスクリプトは、OCI環境ではnetfilterを直接操作する。 + ::: ### CloudFlare @@ -376,7 +392,9 @@ nano .config/default.yml 設定できる値と記述方法は[.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)に書かれている。 :::tip + 開発環境の場合、urlは`url: http://localhost:3000`と指定します。 + ::: ```yml @@ -469,7 +487,9 @@ NODE_ENV=production pnpm run build ``` :::tip + 開発環境の場合、`NODE_ENV=production`は不要です。以降のコマンドでも同様に削除してください。 + ::: ### サーバーでビルドできない場合 @@ -515,7 +535,9 @@ CloudFlareのDNS設定が正しいIPアドレスになっているかもう一 ## Misskeyのデーモンを作成 :::tip + 開発環境の場合、デーモンの作成は不要です。 + ::: いったんCtrl+Cでプロセスをキルし、Misskeyをデーモンで起動する設定をしよう。 diff --git a/content/it/docs/3.for-admin/install/resources/cdn.md b/content/it/docs/3.for-admin/install/resources/cdn.md index 747e4490..030216b8 100644 --- a/content/it/docs/3.for-admin/install/resources/cdn.md +++ b/content/it/docs/3.for-admin/install/resources/cdn.md @@ -17,5 +17,7 @@ CDNで以下の設定を行なってください。 - `/api/*`以外のリクエストをすべてキャッシュする :::tip + Misskeyをアップデートした際にキャッシュのクリアは不要です。 + ::: diff --git a/content/it/docs/3.for-admin/install/resources/troubleshooting.md b/content/it/docs/3.for-admin/install/resources/troubleshooting.md index d9aff878..202e3705 100644 --- a/content/it/docs/3.for-admin/install/resources/troubleshooting.md +++ b/content/it/docs/3.for-admin/install/resources/troubleshooting.md @@ -248,6 +248,10 @@ Amazon S3に互換性のあるオブジェクトストレージであれば利 各サービス/ソフトウェアのドキュメントをよく読み、設定してみてください。 +### ローディングが終わらない + +Cloudflare を使用している場合は、Rocket LoaderやAuto Minifyが有効になっていないか確認してください。有効になっている場合は無効にすることで解決する場合があります。 + *** # まったく解決しなかった場合 diff --git a/content/it/docs/3.for-admin/moderation-tips/disable-timelines.md b/content/it/docs/3.for-admin/moderation-tips/disable-timelines.md index 7c11efa2..1a320724 100644 --- a/content/it/docs/3.for-admin/moderation-tips/disable-timelines.md +++ b/content/it/docs/3.for-admin/moderation-tips/disable-timelines.md @@ -8,7 +8,9 @@ LTLやSTLは、そのサーバー全員の投稿が見れるため、新規の もしデメリットの方が上回っていると感じたら、それらのタイムラインを無効化することも検討してください。 :::warning + 無効化を行うと、ユーザーが困惑し、短期的に見て利用者が減る可能性があります。そのため、無効化の際は影響を慎重に検討し、事前に説明してフォローを整える期間を一定程度設けることを推奨します。 + ::: なお、管理者/モデレーターは、これらのタイムラインの無効化状態は適用されず、引き続き利用することが可能です。 diff --git a/content/it/docs/4.for-developers/aiscript.md b/content/it/docs/4.for-developers/aiscript.md new file mode 100644 index 00000000..2c7c5860 --- /dev/null +++ b/content/it/docs/4.for-developers/aiscript.md @@ -0,0 +1,67 @@ +# AiScript + +AiScriptは、Misskeyの以下の箇所で使用できるスクリプト言語です。 + +- [プラグイン](./plugin/) +- [ウィジェット](/docs/for-users/features/widgets/) + - ボタン + - AiScriptコンソール + - AiScript App +- Misskey Play +- スクラッチパッド + +:::tip + +AiScriptの実装はMisskeyとは別リポジトリで、[オープンソースで公開されています](https://github.com/aiscript-dev/aiscript)。 + +::: + +## 使い方 + +AiScript標準の構文や組み込み関数などが使用できます。 + +:::tip + +ドキュメントは[こちら](https://github.com/aiscript-dev/aiscript/tree/master/docs)\ +Misskey本体のバージョンにより、使用できるAiScriptのバージョンが異なる場合があります。バージョンの確認には`<: Core:v`をScratchpadなどで実行してください。 + +::: + +これらに加え、Misskey専用の組み込み定数・関数が３グループに分けて提供されています。 + +### Misskey AiScript API + +接頭辞: `Mk:`\ +Misskey内の全てのAiScript環境で使用できる定関数群です。 +詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Mk:`とついた部分を参照して下さい。 + +### プラグインAPI + +接頭辞: `Plugin:`\ +[プラグイン](./plugin/)でのみ使用できる定関数群です。 +詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Plugin:`とついた部分を参照して下さい。 + +### UI API + +接頭辞: `Ui:`\ +[ウィジェット](/docs/for-users/features/widgets/)（AiScript App）、Misskey Play、Scratchpadで使用できます。 +ドキュメントは未整備（TODO）ですが、インターネット上に有志の方が執筆された解説記事があります。 + +### 標準入出力 + +AiScript標準で定義されている`readline`関数と`print`関数（および`<:`構文）の内部実装は、Misskey側で独自に提供されています。 + +#### readline(message) + +`message`: `str`\ +返り値: `str`\ +Misskey内の全てのAiScript環境で使用できます。\ +文字列の入力を求めるポップアップを表示します。 + +#### print(message) + +`message`: `any`\ +返り値: `null`\ +[ウィジェット](/docs/for-users/features/widgets/)（AiScriptコンソール）、Scratchpadで使用できます。\ +コンソールに文字列を出力します。\ +`<:`構文も同様の働きをします。 diff --git a/content/it/docs/4.for-developers/api/1.index.md b/content/it/docs/4.for-developers/api/1.index.md index 11ef960c..2d2c988f 100644 --- a/content/it/docs/4.for-developers/api/1.index.md +++ b/content/it/docs/4.for-developers/api/1.index.md @@ -8,7 +8,9 @@ MisskeyはAPIを公開しています。APIを使ってMisskeyクライアント ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。 :::tip -Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\ + +Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\\ + ::: diff --git a/content/it/docs/4.for-developers/api/libraries.md b/content/it/docs/4.for-developers/api/libraries.md index 18db0f35..ee634623 100644 --- a/content/it/docs/4.for-developers/api/libraries.md +++ b/content/it/docs/4.for-developers/api/libraries.md @@ -15,6 +15,8 @@ description: Misskey APIに関連するライブラリの一覧 ## Python - [Misskey.py](https://github.com/YuzuRyo61/Misskey.py) +- [MiPA](https://github.com/yupix/MiPA) +- [MiPAC](https://github.com/yupix/MiPAC) ## .Net diff --git a/content/it/docs/4.for-developers/api/permission.md b/content/it/docs/4.for-developers/api/permission.md index 7844a7fe..50dd4be7 100644 --- a/content/it/docs/4.for-developers/api/permission.md +++ b/content/it/docs/4.for-developers/api/permission.md @@ -5,7 +5,9 @@ description: アプリケーションが要求する権限の一覧 # 権限の一覧 :::tip + このページは[misskey-js](https://github.com/misskey-dev/misskey/tree/develop/packages/misskey-js)から自動生成しているため、ドキュメントや翻訳が不完全な場合があります。 + ::: diff --git a/content/it/docs/4.for-developers/api/streaming/1.index.md b/content/it/docs/4.for-developers/api/streaming/1.index.md index af767dfc..6ce5b5bc 100644 --- a/content/it/docs/4.for-developers/api/streaming/1.index.md +++ b/content/it/docs/4.for-developers/api/streaming/1.index.md @@ -5,7 +5,9 @@ description: ストリーミングAPIを使うと、リアルタイムで様々 # ストリーミングAPI :::tip + 最初に[Misskey API](../index.md)のドキュメントを読むことをお勧めします。 + ::: ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、リアクションされた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。 @@ -26,7 +28,9 @@ wss://{host}/streaming?i={token} - `{token}`の部分は、ユーザーのアクセストークンに置き換えます。 :::tip + アクセストークンは省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。 + ::: ストリームに接続すると、後述投稿の購読を行ったりすることができますが、まだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。 @@ -40,7 +44,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。 :::tip + ひとつのストリーム接続上で、同時に複数のチャンネルに接続することができます。 + ::: 以下では、チャンネルの使用方法を説明します。どのようなチャンネルがあるかは、[チャンネル一覧](./channel/index.md)を参照してください。 @@ -69,7 +75,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり - `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。 :::tip + IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。 + ::: ### チャンネルからのメッセージを受け取る diff --git a/content/it/docs/4.for-developers/api/token.md b/content/it/docs/4.for-developers/api/token.md index 8f9d3919..d0e74076 100644 --- a/content/it/docs/4.for-developers/api/token.md +++ b/content/it/docs/4.for-developers/api/token.md @@ -7,7 +7,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた** アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 :::tip + ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 + ::: あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 @@ -20,7 +22,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた** Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 :::danger + アクセストークンは他人に知られないようにしてください。 + ::: ### アプリケーション利用者にアクセストークンの発行をリクエストする @@ -32,6 +36,7 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app) + ::: #### Step 1 @@ -39,7 +44,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger + このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: #### Step 2 @@ -119,7 +126,9 @@ https://{host}/api/miauth/{session}/check APIの詳細は、APIリファレンスを参照してください。 :::warning + MisskeyはRESTを採用していません。 + ::: また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 diff --git a/content/it/docs/4.for-developers/api/token/1.index.md b/content/it/docs/4.for-developers/api/token/1.index.md new file mode 100644 index 00000000..3305efc0 --- /dev/null +++ b/content/it/docs/4.for-developers/api/token/1.index.md @@ -0,0 +1,88 @@ +# アクセストークンの取得 + +APIを使い始めるには、APIを利用するアカウントに紐づいた**アクセストークン**を取得する必要があります。 +このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。 + +基本的に、APIはリクエストにはアクセストークンが必要となります。 +アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 + +:::tip + +ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 + +::: + +あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 + +- 前者の場合: **「自分自身のアクセストークンを手動発行する」** に進む +- 後者の場合: **「アプリケーション利用者にアクセストークンの発行をリクエストする」** に進む + +## 自分自身のアクセストークンを手動発行する + +Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 + +:::danger + +アクセストークンは他人に知られないようにしてください。 + +::: + +## アプリケーション利用者にアクセストークンの発行をリクエストする + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の方法の一つを使います。 + +:MkIndex + +## APIの利用 + +アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。 + +:::tip + +- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。 +- 要求ヘッダーに`Content-Type: application/json`を指定します。 +- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。 +- ベースURLは`https://{サーバーのドメイン}/api`です。 + +::: + +### Authorization headerを使う方式 + +以下のようにヘッダーの`Authorization`フィールドを指定します。 + +```js +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + text: "Hello Misskey API World with My Application!" + }), + headers: { + Authorization: `Bearer ${accessToken}`, + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` + +### iを使う方式 + +アクセストークン付きのボディの例（metaの場合）: + +```json +{ + "i": "HogEFugA1341", + "detail": false +} +``` + + + +APIの詳細は、APIリファレンスを参照してください。 + +:::warning + +MisskeyはRESTを採用していません。 + +::: + +また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](../streaming/)を参照してください。 diff --git a/content/it/docs/4.for-developers/api/token/2.miauth.md b/content/it/docs/4.for-developers/api/token/2.miauth.md new file mode 100644 index 00000000..1100db0d --- /dev/null +++ b/content/it/docs/4.for-developers/api/token/2.miauth.md @@ -0,0 +1,76 @@ +--- +description: v12.27.0以降で使用できる、Misskey独自の簡素な認証方法について説明しています。 +--- + +# MiAuth方式でのアクセストークン取得方式 + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 + +:::tip + +以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 + +- [よりおおく使われているOAuth方式でのアクセストークン取得方法もあります。](./oauth.md) +- [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app.md) + +::: + +## Step 1 + +UUIDを生成する。以後これを**セッションID**と呼びます。 + +:::danger + +このセッションIDは毎回生成し、使いまわさないようにしてください。 + +::: + +## Step 2 + +アプリケーション認証フォームをユーザーのブラウザで表示させる。認証フォームは、以下の形式のURLで開くことができます: + +``` +https://{host}/miauth/{session} +``` + +ここで、 + +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 +- `{session}`の部分は、セッションIDに置き換えます。 + +また、URLにクエリパラメータとしていくつかのオプションを設定できます: + +| 名前 | 説明 | +| ------------ | ------------------------------------------------------------------------------ | +| `name` | アプリケーション名。 | +| `icon` | アプリケーションのアイコン画像URL。 | +| `callback` | 認証が終わった後にリダイレクトするURL。
リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 | +| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 | + +:::tip{label='例'} + +``` +https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive +``` + +::: + +## Step 3 + +ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 + +``` +https://{host}/api/miauth/{session}/check +``` + +ここで、 + +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。 +- `{session}`の部分は、セッションIDに置き換えます。 + +レスポンスに含まれるプロパティは以下の通りです: + +| 名前 | 説明 | +| ------- | -------------- | +| `token` | ユーザーのアクセストークン。 | +| `user` | ユーザーの情報。 | diff --git a/content/it/docs/4.for-developers/api/token/3.oauth.md b/content/it/docs/4.for-developers/api/token/3.oauth.md new file mode 100644 index 00000000..a29644ab --- /dev/null +++ b/content/it/docs/4.for-developers/api/token/3.oauth.md @@ -0,0 +1,179 @@ +--- +description: v2023.9.0以降で使用できる、OAuth2.0方式での認証方法について説明しています。 +--- + +# OAuth方式でのアクセストークン取得方式 + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 + +:::tip + +以下に説明する方法は、[OAuth 2.0](https://datatracker.ietf.org/doc/html/rfc6749.html)と呼ばれるものです。普通のOAuthはアプリを作成しますが、[IndieAuth](https://indieauth.spec.indieweb.org/)の拡張でアプリ作成なしで使えるようになっています。 + +OAuth方式は使えるライブラリが多いので、出来ればライブラリを使うのをおすすめします。 + +現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。 + +- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md) +- [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md) + +::: + +## Step 1 + +アプリ紹介のためのウェブページを作ります。ページがHTTPSアドレスでアクセスできるようにしてください。ページのとこかに以下のようなHTMLコードを書きます。 + +```html + + + + +
+ My Misskey App +
+``` + +あとで`redirect_uri`のアドレスに認証コードが転送されます。 + +## Step 2 + +PKCE `code_verifier`と`code_challenge`文字列, 及び`state`文字列を生成します。 + +- `code_verifier`の場合は最低43字、最高128字でアルファベット大・小文字及び`-._~`の中の文字に限られます。 +- `code_challenge`文字列は`code_verifier`文字列をSHA256アルゴリズムでハッシュしてbase64urlでエンコードした結果を使います。 +- `state`文字列には特別な制限はありません。ランダムな文字列を使います。 + +:::danger + +この文字列は毎回生成し、使いまわさないようにしてください。 + +::: + +:::tip + +[pkce-challenge](https://www.npmjs.com/package/pkce-challenge)とかのライブラリを使ったり、OAuthライブラリのPKCE機能を使うのがおすすめです。 + +::: + +:::tip{label='例'} + +```js +import crypto from "node:crypto"; + +const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-._~"; +const codeVerifier = new Array(128) + .fill(0) + .map(() => chars[Math.floor(chars.length * Math.random())]) + .join(""); +console.log('code_verifier', codeVerifier); + +const codeChallenge = crypto + .createHash("sha256") + .update(codeVerifier, "ascii") + .digest("base64url"); +console.log('code_challenge', codeChallenge); + +const state = crypto.randomUUID(); +console.log('state', state); +``` + +::: + +## Step 3 + +相手サーバーのOAuth情報を取得します。データはJSON形式になっています。 + +``` +https://{host}/.well-known/oauth-authorization-server +``` + +`{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 + +ここでは`authorization_endpoint`と`token_endpoint`を使います。 + +:::tip + +次のステップで使われる`scope`の情報も`scopes_supported`で確認できます。 + +::: + +## Step 4 + +アプリケーション認証フォームをユーザーのブラウザで表示させます。認証フォームは、以下の形式のURLで開くことができます: + +``` +{authorization_endpoint}?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&scope={scope}&code_challenge={code_challenge}&code_challenge_method=S256&state={state} +``` + +ここで、 + +- `{authorization_endpoint}`の部分は、前の情報取得で得たアドレスに置き換えます。 +- `{client_id}`の部分は、アプリの紹介ページのアドレスに置き換えます。 +- `{code_challenge}`の部分は、前に生成した`code_challenge`文字列に置き換えます +- `code_challenge_method`の部分は常に`S256`にします。 +- `{redirect_uri}`の部分は、紹介ページで使っている配達先のアドレスに置き換えます。 +- `{scope}`の部分は、アプリケーションが要求する権限に置き換えます。要求する権限を` `で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 +- `{state}`の部分は、前に生成した`state`文字列に置き換えます。 + +:::tip{label='例'} + +``` +https://misskey.local/oauth/authorize?client_id=http%3A%2F%2Fexample.com&code_challenge=C6hwMO2bmIzg3nqppTE9b79fvuOjlrKmH2xNiZSMHzw&code_challenge_method=S256&response_type=code&redirect_uri=http%3A%2F%2Fexample.com%2Fredirect&scope=write%3Anotes&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +## Step 5 + +ユーザーがアプリケーションアクセスを許可したら、`redirect_uri`のアドレスに認証コードがURLパラメータの形式で転送されます。 + +| 名前 | 説明 | +| ------- | ----------------------- | +| `code` | ユーザーの認証コード。 | +| `state` | 認証リクエストに使われた`state`文字列。 | + +:::tip{label='例'} + +``` +https://example.com/redirect?code=...&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +`state`文字列がちゃんと一致しているのか確認して、次のステップに進みます。 + +## Step 6 + +転送された認証コードを使ってアクセストークンをPOSTでリクエストします。リクエスト先は`token_endpoint`になります。データ形式は`application/json`と`application/x-www-form-urlencoded`を使えます。各パラメータは以下のようになります。 + +| 名前 | 説明 | +| --------------- | ------------------------------ | +| `grant_type` | 常に`authorization_code`にします。 | +| `client_id` | 認証リクエストに使われた`client_id`文字列。 | +| `redirect_uri` | 認証リクエストに使われた`redirect_uri`文字列。 | +| `scope` | 認証リクエストに使われた`scope`文字列。 | +| `code` | 取得した認証コード。　 | +| `code_verifier` | 前に生成した`code_verifier`文字列。 | + +:::tip{label='例'} + +```js +const res = await fetch(endpoint, { + method: "POST", + body: JSON.stringify({ + grant_type: "authorization_code", + client_id: "https://example.com", + redirect_uri: "https://example.com/redirect", + scope: "write:notes", + code: "...", + code_verifier: "hjjbCYDmDpSLjirkO-PrfWKsRhDdJr-PAEGRClRwzUKlmFIIIrZNmSvUIraeIa~WqbqQnfbJV-Hc_IfuQkesBYUpukUi~lInDfU_AZjoZqbU.ioQTRzaFfZFfGnT-OAA", + }), + headers: { + "Content-Type": "application/json" + } +}); +``` + +::: + +レスポンスはJSONオブジェクト形式で、そこから`access_token`を取得して使います。 diff --git a/content/it/docs/4.for-developers/plugin/create-plugin.md b/content/it/docs/4.for-developers/plugin/create-plugin.md index 5e5130ca..cd9bf91e 100644 --- a/content/it/docs/4.for-developers/plugin/create-plugin.md +++ b/content/it/docs/4.for-developers/plugin/create-plugin.md @@ -74,4 +74,4 @@ Misskey Webはプラグインに対してAPIを公開していて、それらを v2023.11.0以降では、あなたのウェブサイトからワンクリックでプラグインを直接インストールできるようになっています。 -プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](./publish-on-your-website.md)をご覧ください。 +プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](../publish-on-your-website.md)をご覧ください。 diff --git a/content/it/docs/5.releases.md b/content/it/docs/5.releases.md index b7879489..17c4324b 100644 --- a/content/it/docs/5.releases.md +++ b/content/it/docs/5.releases.md @@ -6,6 +6,49 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2023.12.2 + +リリース日: 2023/12/28 + +### General + +- v2023.12.1でDockerを利用してサーバーを起動できない問題を修正 + +### Client + +- Enhance: 検索画面においてEnterキー押下で検索できるように + +## 2023.12.1 + +リリース日: 2023/12/27 + +### Note + +- アクセストークンの権限が再整理されたため、一部のAPIが古いAPIトークンでは動作しなくなりました。\ + 権限不足になる場合には権限を再設定して再生成してください。 + +### General + +- Enhance: ローカリゼーションの更新 +- Fix: 自分のdirect noteがuser list timelineに追加されない + +### Client + +- Feat: AiScript専用のMFM構文`$[clickable.ev=EVENTNAME ...]`を追加。`Mk:C:mfm`のオプション`onClickEv`に関数を渡すと、クリック時に`EVENTNAME`を引数にして呼び出す +- Enhance: MFM入力補助ボタンを投稿フォームに表示できるように #12787 +- Fix: 一部のモデログ(logYellowでの表示対象)について、表示の色が変わらない問題を修正 +- Fix: `fg`/`bg`MFMに長い単語を指定すると、オーバーフローされずはみ出る問題を修正 + +### Server + +- Enhance: センシティブワードの設定がハッシュタグトレンドにも適用されるようになりました +- Enhance: `oauth/token`エンドポイントのCORS対応 +- Fix: 1702718871541-ffVisibility.jsのdownが壊れている +- Fix:「非センシティブのみ（リモートはいいねのみ）」を設定していても、センシティブに設定されたカスタム絵文字をリアクションできる問題を修正 +- Fix: ロールアサイン時の通知で，ロールアイコンが縮小されずに表示される問題を修正 +- Fix: サードパーティアプリケーションがWebsocket APIに無条件にアクセスできる問題を修正 +- Fix: サードパーティアプリケーションがユーザーの許可なしに非公開の情報を見ることができる問題を修正 + ## 2023.12.0 リリース日: 2023/12/23 @@ -1957,7 +2000,9 @@ same as 12.112.0 ### NOTE :::warning + このバージョンからNode v16.14.0以降が必要です + ::: ### Changes @@ -2069,12 +2114,16 @@ same as 12.112.0 ### Note :::warning + ビルドする前に`npm run clean`を実行してください。 + ::: :::warning + このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 + ::: ### Improvements @@ -2145,6 +2194,7 @@ same as 12.112.0 アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。 12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。 + ::: ### Changes diff --git a/content/ja/.docs-legacy/api/index.md b/content/ja/.docs-legacy/api/index.md index 46093420..ae4f263d 100644 --- a/content/ja/.docs-legacy/api/index.md +++ b/content/ja/.docs-legacy/api/index.md @@ -7,8 +7,10 @@ MisskeyはAPIを公開しています。APIを使ってMisskeyクライアント ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。 :::tip + Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\ ライブラリについては[こちら](./libraries)を参照してください。 + ::: APIを使い始めるには、APIを利用するアカウントに紐づいた**アクセストークン**を取得する必要があります。 @@ -19,7 +21,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた** アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 :::tip + ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 + ::: あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 @@ -31,7 +35,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた** Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 :::danger + アクセストークンは他人に知られないようにしてください。 + ::: ### アプリケーション利用者にアクセストークンの発行をリクエストする @@ -42,13 +48,16 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app) + ::: #### Step 1 UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger + このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: #### Step 2 @@ -75,6 +84,7 @@ https://{host}/miauth/{session} ``` https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive ``` + ::: #### Step 3 @@ -119,7 +129,9 @@ https://{host}/api/miauth/{session}/check APIの詳細は、[APIリファレンス](./endpoints.html)を参照してください。 :::warning + MisskeyはRESTを採用していません。 + ::: また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 diff --git a/content/ja/docs/1.about-misskey.md b/content/ja/docs/1.about-misskey.md index 841e04c1..b39db2dc 100644 --- a/content/ja/docs/1.about-misskey.md +++ b/content/ja/docs/1.about-misskey.md @@ -126,8 +126,11 @@ Misskeyは開発が進むにつれ使用する技術も大きく変わってき 私のことですね！Misskeyのマスコットキャラクターとして、精一杯あなたをサポートさせていただきます♪ わたしについては[このホームページ](https://xn--931a.moe/)をご覧ください！ + ::: :::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"} + Misskeyの守り神、藍ちゃんです。ｱｲﾁｬﾝｶﾜｲｲﾔｯﾀｰ! + ::: diff --git a/content/ja/docs/2.for-users/2.onboarding/2.get-started.md b/content/ja/docs/2.for-users/2.onboarding/2.get-started.md index 45558b9a..9ebe8d16 100644 --- a/content/ja/docs/2.for-users/2.onboarding/2.get-started.md +++ b/content/ja/docs/2.for-users/2.onboarding/2.get-started.md @@ -19,6 +19,7 @@ Misskeyには連合機能が備わっています。 連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。 Misskeyが搭載している連合機能はActivityPubというオープンな共通規格に基づいていて、MastodonやPleromaといったほかのソフトウェアとも互換性があります。 + ::: ::: diff --git a/content/ja/docs/2.for-users/2.onboarding/3.join-server.md b/content/ja/docs/2.for-users/2.onboarding/3.join-server.md index f1b0229e..2c1ef564 100644 --- a/content/ja/docs/2.for-users/2.onboarding/3.join-server.md +++ b/content/ja/docs/2.for-users/2.onboarding/3.join-server.md @@ -7,6 +7,7 @@ ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 ただし、入力事項はサーバーによって異なることがあります。詳しくは、サーバー管理者にお問い合わせください。 + ::: ## 登録する diff --git a/content/ja/docs/2.for-users/3.features/mfm.md b/content/ja/docs/2.for-users/3.features/mfm.md index 988b0214..cdb619b1 100644 --- a/content/ja/docs/2.for-users/3.features/mfm.md +++ b/content/ja/docs/2.for-users/3.features/mfm.md @@ -73,6 +73,7 @@ https://example.com ``` ?[example link](https://example.com) ``` + ::: diff --git a/content/ja/docs/2.for-users/4.resources/donate.md b/content/ja/docs/2.for-users/4.resources/donate.md index 03692512..67b0c1a7 100644 --- a/content/ja/docs/2.for-users/4.resources/donate.md +++ b/content/ja/docs/2.for-users/4.resources/donate.md @@ -24,6 +24,7 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 - 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載 - 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載 + ::: :::warning diff --git a/content/ja/docs/3.for-admin/features/announcement.md b/content/ja/docs/3.for-admin/features/announcement.md index 333d9e19..6be50add 100644 --- a/content/ja/docs/3.for-admin/features/announcement.md +++ b/content/ja/docs/3.for-admin/features/announcement.md @@ -11,6 +11,7 @@ - 「既存ユーザーのみ」オプションを有効にしてお知らせを作成する - 「非通知」オプションを有効にしてお知らせを作成する - 終了したお知らせはアーカイブする + ::: ## 表示形式 diff --git a/content/ja/docs/3.for-admin/features/role.md b/content/ja/docs/3.for-admin/features/role.md index a65b903d..c1dff0c8 100644 --- a/content/ja/docs/3.for-admin/features/role.md +++ b/content/ja/docs/3.for-admin/features/role.md @@ -26,6 +26,7 @@ - 手動でのアサイン/アサイン解除は行えません。 - 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。 + ::: ## 権限 diff --git a/content/ja/docs/3.for-admin/install/guides/1.index.md b/content/ja/docs/3.for-admin/install/guides/1.index.md index 7eccf782..dc09c438 100644 --- a/content/ja/docs/3.for-admin/install/guides/1.index.md +++ b/content/ja/docs/3.for-admin/install/guides/1.index.md @@ -19,6 +19,7 @@ Misskeyサーバーの構築に関心をお寄せいただきありがとうご Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。 詳しくは [misskey-dev/misskey #9791](https://github.com/misskey-dev/misskey/issues/9791) をご覧ください。 + ::: ## Xserver VPSでインストール diff --git a/content/ja/docs/3.for-admin/install/guides/docker.md b/content/ja/docs/3.for-admin/install/guides/docker.md index 39a62a6e..4f7ddf0c 100644 --- a/content/ja/docs/3.for-admin/install/guides/docker.md +++ b/content/ja/docs/3.for-admin/install/guides/docker.md @@ -14,7 +14,9 @@ Docker Composeを使ったMisskey構築 ::: :::tip{label='前提条件'} + - DockerおよびDocker Composeがインストールされていること。 + ::: リポジトリの取得 diff --git a/content/ja/docs/3.for-admin/install/guides/kubernetes.md b/content/ja/docs/3.for-admin/install/guides/kubernetes.md index 9539613d..fa6fb837 100644 --- a/content/ja/docs/3.for-admin/install/guides/kubernetes.md +++ b/content/ja/docs/3.for-admin/install/guides/kubernetes.md @@ -18,6 +18,7 @@ MisskeyのHelmChartsはTrueNAS Scaleで使用するためのTrueChartsで公開 :::前提条件 + - TrueNAS Scale または - KubernetesクラスターとHelm diff --git a/content/ja/docs/3.for-admin/install/guides/manual.md b/content/ja/docs/3.for-admin/install/guides/manual.md index 0deef9bf..0995d8bf 100644 --- a/content/ja/docs/3.for-admin/install/guides/manual.md +++ b/content/ja/docs/3.for-admin/install/guides/manual.md @@ -14,6 +14,7 @@ Misskeyを手動で構築する ::: :::tip{label='前提条件'} + #### 以下のソフトウェアがインストール・設定されていること - **[Node.js](https://nodejs.org/en/)** (20.4.x以上) - **[PostgreSQL](https://www.postgresql.org/)** (15以上) @@ -26,6 +27,7 @@ Debian/Ubuntuをお使いであれば、`build-essential`パッケージをイ ```sh sudo corepack enable ``` + ::: ユーザーの作成 @@ -165,4 +167,5 @@ sudo systemctl restart misskey - `pnpm run clean`または`pnpm run clean-all` - `pnpm rebuild` + ::: diff --git a/content/ja/docs/4.for-developers/api/token/2.miauth.md b/content/ja/docs/4.for-developers/api/token/2.miauth.md index bed7413e..126bcc82 100644 --- a/content/ja/docs/4.for-developers/api/token/2.miauth.md +++ b/content/ja/docs/4.for-developers/api/token/2.miauth.md @@ -12,6 +12,7 @@ description: v12.27.0以降で使用できる、Misskey独自の簡素な認証 - [よりおおく使われているOAuth方式でのアクセストークン取得方法もあります。](./oauth.md) - [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app.md) + ::: ## Step 1 diff --git a/content/ja/docs/4.for-developers/api/token/3.oauth.md b/content/ja/docs/4.for-developers/api/token/3.oauth.md index 06a36e13..34a21e09 100644 --- a/content/ja/docs/4.for-developers/api/token/3.oauth.md +++ b/content/ja/docs/4.for-developers/api/token/3.oauth.md @@ -16,6 +16,7 @@ OAuth方式は使えるライブラリが多いので、出来ればライブラ - [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md) - [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md) + ::: ## Step 1 diff --git a/content/ja/docs/5.releases.md b/content/ja/docs/5.releases.md index 7cb02226..37dd6251 100644 --- a/content/ja/docs/5.releases.md +++ b/content/ja/docs/5.releases.md @@ -1737,6 +1737,7 @@ same as 12.112.0 ### NOTE ::: warning このバージョンからNode v16.14.0以降が必要です + ::: ### Changes @@ -1828,11 +1829,13 @@ same as 12.112.0 ### Note ::: warning ビルドする前に`npm run clean`を実行してください。 + ::: ::: warning このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 + ::: ### Improvements @@ -1894,6 +1897,7 @@ same as 12.112.0 アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。 12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。 + ::: ### Changes diff --git a/content/ko/docs/1.about-misskey.md b/content/ko/docs/1.about-misskey.md index dd0074d3..15b8923c 100644 --- a/content/ko/docs/1.about-misskey.md +++ b/content/ko/docs/1.about-misskey.md @@ -15,7 +15,9 @@ Misskey는 오픈소스 분산형 마이크로블로그 플랫폼 프로젝트 초기에는 분산형이 아니었지만, 2018년에 ActivityPub 프로토콜을 지원함으로써 분산형 SNS로 발돋움하여 널리 알려지게 되었습니다. :::tip + Misskey라는 이름은 syuilo가 당시 듣고 있던 May'n의 노래, Brain Diver의 가사에서 유래했습니다. + ::: 누구나 개발에 참가할 수 있으며, 현재도 활발한 개발이 이루어지고 있습니다. @@ -35,7 +37,9 @@ Misskey의 모든 소스 코드는 [AGPL](https://github.com/misskey-dev/misskey 다시 말씀 드리지만, X(Twitter)나 Facebook등의 이익을 얻고 있는 대부분의 서비스는 오픈 소스가 아닙니다. :::tip + 자세히 말씀드리자면, Misskey의 소스 코드는 Git으로 관리되고 저장소는 [GitHub에서 호스팅됩니다.](https://github.com/misskey-dev) + ::: ## 개발에 참가 및 프로젝트를 지원하기 @@ -58,7 +62,7 @@ Misskey는 다양한 언어를 지원하고 있습니다. (i18n-internationaliza 그 번역 작업에 참여해 주시는 것으로도 Misskey에 기여할 수 있습니다. Misskey는 [Crowdin](https://crowdin.com/project/misskey) 이라는 서비스를 사용하여 번역 관리를 하고 있습니다. -### 미스키에 대해 의견 쓰기 +### Misskey에 대해 의견 쓰기 버그 제보 뿐만 아니라 Misskey의 좋은 점, 즐거운 점 등 긍정적인 의견도 꼭 공유해 주세요.개발에 힘이 되고, 간접적이지만 그것 또한 프로젝트에 대한 기여입니다. @@ -71,7 +75,7 @@ Misskey는 [Crowdin](https://crowdin.com/project/misskey) 이라는 서비스를 [여기를 읽어 주세요.](/docs/for-users/resources/donate/) -## 자주 하는 질문 +## 자주 묻는 질문 ### 프로젝트의 목표는 무엇인가요? @@ -125,7 +129,7 @@ Misskey는 개발이 진행되면서 사용하는 기술도 크게 달라졌습 개발 자체도 Misskey 쪽이 Mastodon보다 더 옛날에 개발되었습니다.다만 분산형 서비스로 바뀐것은 Mastodon의 등장보다 나중의 일입니다. 같은 ActivityPub이라는 분산형 프로토콜을 사용하고 있다는 점 이외에는 Mastodon과의 다른 특별한 관련이 있는 것도 아닙니다. -### iOS나 Android 앱이 있나요? +### iOS/Android용 어플리케이션이 있나요? 공식적으로는 그런 OS의 네이티브 앱을 개발하지 않았지만, 서드파티 앱이 몇 개 있습니다. 자세한 내용은 [여기](/docs/for-users/resources/apps/)를 참조하십시오. @@ -143,6 +147,10 @@ Misskey는 개발이 진행되면서 사용하는 기술도 크게 달라졌습 저에 대해서는 [이 홈페이지](https://xn--931a.moe/)를 참조해주세요! -:::fukidashi{chara="syuilo" charaName="しゅいろ(슈이로)" direction="right"} -미스키의 수호신 아이짱입니다.아이쨩 귀여워 야호\~! +::: + +:::fukidashi{chara="syuilo" charaName="しゅいろ(슈이로)" direction="right"} + +Misskey의 수호신 아이짱입니다.아이쨩 귀여워 야호\~! + ::: diff --git a/content/ko/docs/2.for-users/2.onboarding/1.warning.md b/content/ko/docs/2.for-users/2.onboarding/1.warning.md index 4b027e49..295562d9 100644 --- a/content/ko/docs/2.for-users/2.onboarding/1.warning.md +++ b/content/ko/docs/2.for-users/2.onboarding/1.warning.md @@ -9,6 +9,6 @@ Misskey를 쓰는 서비스를 이용할 때에는 몇 가지를 유의해야 - Misskey는 분산형 서비스입니다.(하지만 이는 대부분의 인터넷이 그렇습니다.) - 비공개로 올린 노트도, 다른 서버에서도 동일하게 비공개로 취급할지는 보증할 수 없습니다.개인 정보, 기밀 정보를 올리실 때는 특별히 주의하시길 바랍니다.(하지만, 이 내용은 다른 인터넷 서비스들도 이렇다고 할 수 있습니다.)개인 정보, 기밀 정보를 올리실 때는 특별히 주의하시길 바랍니다.(하지만, 이 내용은 다른 인터넷 서비스들도 이렇다고 할 수 있습니다.) - 계정 삭제는 서버에 부하가 많이 가므로, 긴 시간이 걸리는 경우가 있습니다.업로드하신 데이터가 많은 경우에는 계정 삭제가 되지 않는 경우가 있습니다.한 번 업로드를 하신 데이터는 삭제하셔도 다른 서버에서도 꼭 삭제되었다고는 할 수는 없습니다.(하지만, 이 내용은 다른 인터넷 서비스들도 이렇다고 할 수 있습니다.) -- 서버에 따라선, 광고비 수입으로 운영되어지는 경우가 있습니다.서버에 따라선, 광고비 수입으로 운영되어지는 경우가 있습니다.또한 광고 차단기는 광고와 관련이 없는 컨텐츠나 기능을 차단하는 경우가 자주 있으므로, 사용자의 편리한 이용에 영향을 끼치는 경우가 있습니다.이 경우 정상적으로 Misskey를 사용하실 수 없는 경우가 있습니다.그러므로, Misskey에는 광고 차단기나 그에 준하는 기능은 끄고 사용하시길 바랍니다. +- 서버에 따라선, 광고비 수입으로 운영되어지는 경우가 있습니다.또한 광고 차단은 광고와 전혀 관련 없는 콘텐츠나 기능을 잘못 차단하기도 하므로 클라이언트 작동에 지장이 가거나 정상적으로 Misskey를 사용할 수 없을 수도 있습니다.이 경우 정상적으로 Misskey를 사용하실 수 없는 경우가 있습니다.그러므로, Misskey에는 광고 차단기나 그에 준하는 기능은 끄고 사용하시길 바랍니다. 이 내용들을 숙지하신 후, 편리한 서비스를 사용하시길 바랍니다. diff --git a/content/ko/docs/2.for-users/2.onboarding/2.get-started.md b/content/ko/docs/2.for-users/2.onboarding/2.get-started.md index 168d3245..e162209b 100644 --- a/content/ko/docs/2.for-users/2.onboarding/2.get-started.md +++ b/content/ko/docs/2.for-users/2.onboarding/2.get-started.md @@ -9,11 +9,14 @@ Misskey는 소프트웨어 및 그에 관련된 프로젝트 입니다. [서버 리스트](/servers/)에서 원하시는 서버를 찾아보실 수 있습니다. :::tip -どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 ::g-details{summary='자세히'} Misskey에는 연합 기능이 준비되어져 있습니다. +:::g-details{summary='자세히'} + +Misskey에는 연합 기능이 갖춰져 있습니다. + 연합 기능을 통해서 다른 서버의 유저라도 같은 서버의 유저랑 똑같이 팔로우나 리액션, Renote 등을 할 수 있습니다. Misskey가 탑재하고 있는 ActivityPub이라는 개방된 공통 규격을 따르고 있어 Mastodon이나 Pleroma와 같은 다른 소프트웨어 간에도 호환성을 가집니다. @@ -27,5 +30,7 @@ Misskey가 탑재하고 있는 ActivityPub이라는 개방된 공통 규격을 어떤 서버의 경우에는 "특정적인 무언가가 좋아하는 사람"들이 주제를 정하고 모인 경우가 있습니다. :::tip + 서버 리스트는 [여기](/servers/)에서 확인하실 수 있습니다. + ::: diff --git a/content/ko/docs/2.for-users/2.onboarding/3.join-server.md b/content/ko/docs/2.for-users/2.onboarding/3.join-server.md index 3dea10e4..1959e107 100644 --- a/content/ko/docs/2.for-users/2.onboarding/3.join-server.md +++ b/content/ko/docs/2.for-users/2.onboarding/3.join-server.md @@ -3,9 +3,11 @@ 가입하고 싶은 서버를 정하시면, 바로 계정을 만들어봅시다. :::tip -ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 + +여기서는 Misskey.io를 예로 들었지만, 다른 서버에서도 등록 방법은 대체로 동일합니다. 다만, 가입하실 때 필요한 정보는 서버에 따라 다른 경우가 있습니다.자세한 내용은, 서버 관리자에게 확인해보시길 바랍니다. + ::: ## 가입하기 @@ -30,6 +32,7 @@ ![확인 이메일](/img/docs/for-users/onboarding/join-server/4.ja.png) :::tip + ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 이것으로 당신도 [미스키스트](../resources/glossary/#미스키스트)!즐거운 커뮤니케이션을 보내시길 바랍니다. diff --git a/content/ko/docs/2.for-users/2.onboarding/4.things-to-know.md b/content/ko/docs/2.for-users/2.onboarding/4.things-to-know.md index 12b3dd36..e32ad972 100644 --- a/content/ko/docs/2.for-users/2.onboarding/4.things-to-know.md +++ b/content/ko/docs/2.for-users/2.onboarding/4.things-to-know.md @@ -7,17 +7,21 @@ Misskey에 올리는 것은 일반적으로 "노트"라고 부릅니다.Twitter 등의 일반적인 SNS와 비교해 더 많은 기능들이 있으니, 첫 노트를 올리시기 전에 꼭 확인해보시길 바랍니다. :::tip -자세한 내용은, "[노트](/docs/for-users/features/note/)"를 참조하시길 바랍니다. + +자세한 내용은 [노트](/docs/for-users/features/notes/)에서 확인할 수 있습니다. + ::: ## 타임라인 -Misskey는 여러 종류의 타임라인을 가지고 있습니다.이름 만으로는 바로 알기가 쉽지 않을 수도 있으므로, 각각의 타임라인이 어떤 것들을 하는지 알아봅시다.이름 만으로는 바로 알기가 쉽지 않을 수도 있으므로, 각각의 타임라인이 어떤 것들을 하는지 알아봅시다. +Misskey는 여러 개의 타임라인을 가지고 있습니다.이름만으로는 다소 이해하기 어려울 수 있으니, 각각 어떤 역할을 하는지 알아둡시다. :::tip -자세한 내용은, "[타임라인](/docs/for-users/features/timeline/)"을 참조하시길 바랍니다. + +자세한 내용은 [타임라인](/docs/for-users/features/timeline/)에서 확인할 수 있습니다. + ::: -## 기타 +## 그 외 -Misskey에는 그 외 여러가지 기능들이 많이 있습니다.Misskey에는 그 외 여러가지 기능들이 많이 있습니다.모든 기능에 대한 설명은 [여기](/docs/for-users/features/)에서 확인하실 수 있으니, 확인해보시길 바랍니다. +이 밖에도 Misskey에는 다양한 기능들이 있습니다!모든 기능에 대한 설명은 [여기](/docs/for-users/features/)에서 확인할 수 있으니 꼭 확인해보세요! diff --git a/content/ko/docs/2.for-users/3.features/ads.md b/content/ko/docs/2.for-users/3.features/ads.md index 1d22cc92..1325f274 100644 --- a/content/ko/docs/2.for-users/3.features/ads.md +++ b/content/ko/docs/2.for-users/3.features/ads.md @@ -3,9 +3,12 @@ Misskey에서는 각 서버에서 준비한 광고를 타임라인 등에 표시할 수 있는 기능이 있습니다. :::tip -광고 수가 적은 경우, 표시 빈도를 줄이셔도 계속해서 표시될 수도 있습니다. + +광고의 총 개수가 적은 경우, 표시 빈도를 낮춰도 계속 표시될 수 있습니다. + ::: -## 광고 설정 (관리자) +## 광고 설정(관리자) -서버의 제어판에서 광고를 추가, 편집, 삭제를 하실 수 있습니다. +서버 제어판에서 광고를 추가, 편집, 삭제할 수 있습니다. +광고에는 원하는 이미지, 전환 URL, 모양, 표시 비율을 설정할 수 있습니다. diff --git a/content/ko/docs/2.for-users/3.features/custom-emoji.md b/content/ko/docs/2.for-users/3.features/custom-emoji.md index d6559d65..ba3c67bd 100644 --- a/content/ko/docs/2.for-users/3.features/custom-emoji.md +++ b/content/ko/docs/2.for-users/3.features/custom-emoji.md @@ -5,4 +5,4 @@ 커스텀 이모지를 쓰실 땐, 이모지의 아이콘 버튼(이 있는 경우만)을 누르거나, `:`를 입력해서 이모지 검색창을 표시합니다. 텍스트 안에 `:foo:`와 같은 형식의 문자열을 찾으면 `foo` 부분이 커스텀 이모지로 인식되어, 표시할 때 거기에 맞는 커스텀 이모지로 바뀌어 표시됩니다. -서버에 어떤 커스텀 이모지가 준비되어져 있는지는, Misskey Web의 **서버 정보**에 있는 **커스텀 이모지**`/about#emojis`에서 확인하실 수 있습니다. +서버에 어떤 커스텀 이모지가 준비되어져 있는지는, Misskey Web의 **서버 정보**에 있는 [**커스텀 이모지**](x-mi-web://about#emojis)에서 확인하실 수 있습니다. diff --git a/content/ko/docs/2.for-users/3.features/drive.md b/content/ko/docs/2.for-users/3.features/drive.md index dd874d4e..2906f9ef 100644 --- a/content/ko/docs/2.for-users/3.features/drive.md +++ b/content/ko/docs/2.for-users/3.features/drive.md @@ -3,21 +3,27 @@ 드라이브는 Misskey에서 파일을 관리할 수 있는 기능입니다. :::tip -기술적으로 말하면, Misskey를 통해 모든 파일이 한 군데에서 관리되어지고 있는데, 그걸 유저한테도 공개한 것을 드라이브라고 생각하실 수도 있습니다. -::: Misskey Web의 드라이브 페이지에서 임의 파일을 업로드 하거나, 아바타로 설정한 이미지나, 노트를 첨부한 파일 등도 모두 드라이브에 올라갑니다. -드라이브에 올려진 파일은 언제든지 다운로드 하실 수 있으며, 노트를 쓰실 때에도 "드라이브에서 파일 첨부"하는 것으로 파일을 다시 사용하실 수도 있습니다. +::: 드라이브 안에 폴더를 만들어서 여러 파일들을 모아서 정리할 수도 있습니다. +드라이브에 업로드된 파일은 언제든지 다운로드할 수 있으며, 노트 작성 시 '드라이브에서 파일 첨부'를 통해 파일을 재사용할 수도 있습니다. + +드라이브에 폴더를 만들어 여러 파일을 한꺼번에 정리할 수도 있습니다. + :::warning -지금은 드라이브에서 파일을 지우시면, 그 파일이 첨부되어진 \*\*모든 컨텐츠(노트, 페이지 등)\*\*도 같이 사라집니다. + +현재 드라이브에서 파일을 삭제하면 해당 파일이 첨부된 \*\*모든 콘텐츠(노트, 페이지 등)\*\*도 동시에 사라집니다. + ::: -## 열람 주의 (NSFW) +## 센서티브 (NSFW) -열람 주의 또는 NSFW (Not safe for work)는 드라이브에 있는 파일에 설정할 수 있는 플래그 입니다. +민감 또는 NSFW(Not safe for work)는 드라이브의 파일에 설정할 수 있는 플래그입니다. +민감한 플래그가 설정된 파일은 표시될 때 열람자의 조작이 없으면 표시되지 않습니다. +이 플래그는 예를 들어 직장이나 공공장소에서 열람하기에 적절하지 않다고 생각되는 이미지 등에 설정하여 그러한 이미지가 갑자기 표시되는 것을 방지하는 목적으로 사용됩니다. -이 플래그는 직접 켜고 끌 수 있지만, 관리자에 의하여 설정되어지는 경우가 있습니다. +이 플래그는 수동으로 켜고 끌 수 있으며, 중재자의 판단에 따라 설정될 수도 있습니다. diff --git a/content/ko/docs/2.for-users/3.features/mfm.md b/content/ko/docs/2.for-users/3.features/mfm.md index 3054595b..61aadaab 100644 --- a/content/ko/docs/2.for-users/3.features/mfm.md +++ b/content/ko/docs/2.for-users/3.features/mfm.md @@ -7,21 +7,28 @@ description: MFM은 미스키에서 사용할 수 있는 전용 마크업 언어 MFM은 Markup langauge For Misskey의 약자로 Misskey의 여러 곳에서 사용할 수 있는 전용 마크업 언어입니다. :::tip -일부 구문은 Markdown이나 HTML과 호환성이 있습니다. + +일부 구문은 Markdown 및 HTML과 호환됩니다. + ::: -## MFM을 사용할 수 있는 곳 (예시) - -- 노트 본문 -- CW 주석 -- 유저 이름 -- 유저 자기소개 - ## 구문 -### 맨션 +- 노트 본문 +- CW 주석 +- 사용자 이름 +- 사용자 소개 -골뱅이표(@) + 유저명으로 특정 유저를 표현할 수 있습니다. +## 구문 + +### 멘션 + +@ + 사용자 이름으로 특정 사용자를 나타낼 수 있습니다. +:::tip + +멘션에 대한 자세한 내용은 [여기](./mention.md)에서 확인할 수 있습니다. + +::: ``` @ai @@ -37,7 +44,12 @@ MFM은 Markup langauge For Misskey의 약자로 Misskey의 여러 곳에서 사 ### 해시태그 -넘버 사인 + 태그로 해시태그를 표현할 수 있습니다. +숫자 기호 + 태그를 통해 해시태그를 표시할 수 있습니다. +:::tip + +해시태그에 대한 자세한 내용은 [여기](./hashtag.md)에서 확인할 수 있습니다. + +::: ``` #misskey @@ -64,7 +76,8 @@ https://example.com ``` :::tip -リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。 + +링크 텍스트 앞에 \`? '를 붙이면 링크 미리보기를 숨길 수 있습니다. ``` ?[example link](https://example.com) @@ -76,8 +89,13 @@ https://example.com ### 커스텀 이모지 +콜론(:)으로 사용자 지정 이모티콘 이름을 묶으면 사용자 지정 이모티콘을 표시할 수 있습니다. + :::tip -커스텀 이모지에 대한 자세한 내용은 [여기](./custom-emoji.md)를 참조하세요. + +커스텀 이모티콘에 대한 자세한 내용은 [여기](./custom-emoji.md)에서 확인할 수 있습니다. + +::: ``` :misskey: diff --git a/content/ko/docs/2.for-users/3.features/mute-and-block.md b/content/ko/docs/2.for-users/3.features/mute-and-block.md index 4e11b88d..ce1c2d74 100644 --- a/content/ko/docs/2.for-users/3.features/mute-and-block.md +++ b/content/ko/docs/2.for-users/3.features/mute-and-block.md @@ -5,52 +5,62 @@ 상대방은 뮤트된 것은 알 수 없지만 차단된 것은 알 수 있습니다.어느 쪽을 택할지는 스스로의 판단으로 해 주세요. :::tip -뮤트와 차단은 동시에 사용할 수도 있습니다. + +뮤트 및 차단은 같이 할 수 있습니다. + ::: :::warning -서비스 약관을 위반하는 사용자는 관리진에게 보고해 주세요. -::: - -Misskey Web에서 설정 > 뮤트 및 차단 메뉴로 들어가면 뮤트하거나 차단한 사용자의 목록을 볼 수 있습니다. - -## 뮤트 사용자를 뮤트하면, 사용자에 대한 다음 항목이 더이상 표시되지 않습니다: -- 사용자의 게시물(해당 게시물에 대한 답글과 리노트 포함) 및 검색 결과 -- 해당 사용자로부터의 알림 -- 해당 사용자와의 Misskey 대화 기록 -- 등 +::: Misskey Web에서 사용자를 뮤트하려면, 사용자의 프로필 페이지에서 메뉴를 열어 "뮤트"를 선택하세요. +## 뮤트 + +사용자를 뮤트하면 그 사용자의 콘텐츠가 Misskey에 표시되지 않게 됩니다. + +- 타임라인 및 게시물 검색 결과에서 해당 사용자의 게시물(및 해당 게시물에 대한 답글과 리노트)을 확인할 수 있습니다. +- 해당 사용자로부터의 알림 +- 메시지 기록 목록에서 해당 사용자에 대한 메시지 기록 +- 그 외 + +Misskey Web에서 사용자를 뮤트하려면 대상 사용자의 사용자 페이지 메뉴를 열고 '뮤트' 버튼을 누릅니다. + :::tip -뮤트를 했다는 알림은 발송되지 않으며, 뮤트된 사용자도 자신이 뮤트되었다는 사실을 알 수 없습니다. + +뮤트한 사실을 상대방에게 알리지 않고, 뮤트된 사실을 알 수 없습니다. + ::: ## 차단 -사용자를 차단하면 차단된 사용자는 차단한 사용자의 콘텐츠를 확인할 수 없으며, 다음 작업도 수행할 수 없습니다: +사용자를 차단하면 해당 사용자는 내 콘텐츠를 볼 수 없게 되고, 나에 대해 다음과 같은 행동을 할 수 없게 됩니다. -- 팔로우 +- 팔로우하기 - 리스트에 추가 -- 콘텐츠에 답장하거나 리노트 -- 반응을 게시하거나 투표 -- 메시지 전송 +- 답글 달기, 리노트하기 +- 리액션하기, 설문조사에 투표하기 +- 메시지 보내기 - 등 또한, -- 팔로우하고 있는 사용자를 차단하면 팔로우가 해제됩니다. -- 리스트에 있는 사용자를 차단하면 리스트에서 제거됩니다. +- 차단할 때 이미 해당 사용자로부터 팔로우를 받고 있었다면 팔로우가 해제됩니다. +- 차단할 때 해당 사용자가 이미 사용자 목록에 당신을 포함시켜 놓았다면 그 목록에서 당신을 삭제할 수 있습니다. -Misskey Web에서 사용자를 차단하려면, 사용자의 프로필 페이지에서 메뉴를 열어 "차단"을 선택해 주세요. +Misskey Web에서 사용자를 차단하려면 대상 사용자의 사용자 페이지 메뉴를 열고 '차단' 버튼을 누릅니다. :::warning -상대방에게 차단되었다는 알림은 발송되지 않지만, 위에 언급된 모든 동작을 수행할 수 없기 때문에 간접적으로 알게 될 수 있습니다. + +차단을 한 것 자체는 상대방에게 통보되지 않지만, 팔로우를 하는 등 위의 행동을 할 수 없게 되므로 간접적으로 차단된 것을 알 수 있습니다. + ::: :::warning -차단은 단순하지만 유용한 기능입니다. 차단된 사용자는 차단한 사용자의 콘텐츠를 확인할 수 없게 되지만, 계정을 변경하거나 로그아웃하면 여전히 확인할 수 있습니다.어디까지나 보조적인 조치로 생각해 주세요. + +상대방이 내 콘텐츠를 볼 수 없게 되지만, 상대방이 계정을 전환하거나 로그아웃하면 볼 수 있습니다.어디까지나 단순, 보조적인 것으로 생각해 주십시오. + ::: diff --git a/content/ko/docs/2.for-users/3.features/pages.md b/content/ko/docs/2.for-users/3.features/pages.md index 91b720bd..e73a15bf 100644 --- a/content/ko/docs/2.for-users/3.features/pages.md +++ b/content/ko/docs/2.for-users/3.features/pages.md @@ -3,7 +3,9 @@ Misskey상에서 노트와는 별개로 페이지를 작성할 수 있습니다.v13 이후에서는 정적 페이지에 특화되어 있습니다. :::warning + v13 이후에서는 페이지를 통한 동적 페이지 생성 대신 Misskey Play를 사용할 수 있습니다. + ::: ## 페이지 설정 diff --git a/content/ko/docs/2.for-users/3.features/poll.md b/content/ko/docs/2.for-users/3.features/poll.md index 7a0825ea..981c7370 100644 --- a/content/ko/docs/2.for-users/3.features/poll.md +++ b/content/ko/docs/2.for-users/3.features/poll.md @@ -13,20 +13,22 @@ 너무 많이 추가했다면, 옆의 X 버튼을 눌러 삭제할 수 있습니다. :::warning + 공백인 입력란이 하나라도 있다면, 그 투표가 첨부된 노트는 투고할 수 없습니다. + ::: ## 복수 응답 허용하기 -'복수 응답 허용' 스위치를 켜면, 설문에 응답하는 사람이 여러 개의 선택지에 투표할 수 있게 됩니다. +투표 기간을 '일시 지정', '기간 지정' 중 하나로 설정할 수 있습니다. ## 만료 시점 설정하기 -투표 기간을 '일시 지정', '기간 지정' 중 하나로 설정할 수 있습니다. +설정한 기한을 취소하려면 '기한' 란에서 '무기한'을 선택합니다. 설정하려면, '투표 기한' 란에서 '일시 지정' 또는 '경과 지정'을 선택합니다. -설정한 기한을 취소하려면 '기한' 란에서 '무기한'을 선택합니다. +투표가 첨부된 노트가 타임라인에 있을 때, 투표를 해 봅시다. ## 설문에 투표하기 @@ -41,7 +43,9 @@ 투표 결과를 다시 숨기려면 '투표하기'를 선택합니다. :::tip + 투표하지 않은 경우에는 결과가 표시되어 있어도 투표가 가능합니다. + ::: 투표를 하면, 자신이 투표한 선택지에 ✔가 붙습니다. diff --git a/content/ko/docs/2.for-users/3.features/share-form.md b/content/ko/docs/2.for-users/3.features/share-form.md index 54d37dab..a34c93e0 100644 --- a/content/ko/docs/2.for-users/3.features/share-form.md +++ b/content/ko/docs/2.for-users/3.features/share-form.md @@ -7,32 +7,34 @@ URL에 공유 내용을 포함한 몇 가지 옵션을 쿼리 파라미터로 ## 쿼리 파라미터 :::tip + 모든 파라미터는 **옵션**이며, 필수 항목이 아닙니다. + ::: -| 이름 | 설명 | -| ------- | --------------------------------------------------------------------------- | -| `title` | 제목。본문 첫머리[ … ]라고 삽입됩니다. | -| `text` | 본문. | -| `url` | URL.본문 마지막에 삽입됩니다. | +| 이름 | 설명 | +| ------- | ---------------------------------------------------------------------------- | +| `title` | 타이틀.본문의 처음에 [… ]가 표시됩니다. | +| `text` | 본문. | +| `url` | 주소.본문의 끝에 표시됩니다. | -### 회신 정보 +### 답글 정보 다음 중 하나를 지정하면 지정된 노트에 대한 답글이 될 수 있습니다. -| 이름 | 설명 | -| ---------- | ---------------------------------------- | -| `replyId` | 답장할 노트 ID. | -| `replyUri` | 답장할 URL.(원격 노트 객체 지정) | +| 이름 | 설명 | +| ---------- | -------------------------------------- | +| `replyId` | 답글 기록의 아이디. | +| `replyUri` | 답글 주소.(원격 기록 대상 지정) | -### Renote정보 +### 리노트 정보 아래 중 하나를 지정하면 지정한 노트에 대한 리노트(인용)를 할 수 있습니다. | 이름 | 설명 | | ----------- | -------------------------------------------- | | `renoteId` | 리노트 대상의 노트 ID. | -| `renoteUri` | 리노트 대상의 URL.(원격 노트 객체 지정) | +| `renoteUri` | 리노트 대상의 URL.(원격 기록 대상 지정) | ### 공개 범위 @@ -46,20 +48,22 @@ URL에 공유 내용을 포함한 몇 가지 옵션을 쿼리 파라미터로 | `visibleAccts` | 대상 사용자[acct](../resources/glossary/#acct)(쉼표로 구분) | :::warning + `visibility`에 `specified`를 지정한 경우 `visibleUserIds` 또는 `visibleAccts`의 지정도 필요합니다. + ::: ### 첨부 파일 아래 옵션으로 첨부 파일을 지정할 수 있습니다. -| 이름 | 설명 | -| --------- | -------------------------------------- | -| `fileIds` | 첨부할 파일의 ID (쉼표로 구분) | +| 이름 | 설명 | +| --------- | ------------------------------------- | +| `fileIds` | 첨부할 파일의 아이디(쉼표 구분) | -## Misskey Hub의 공유 양식 중계 서비스 소개 +## Misskey Hub의 공유 양식 중계 서비스 정보 - +[공유 버튼 생성기](/tools/share-link-generator/)도 함께 사용하시기 바랍니다. 새로운 미스키 허브에서는 미스키 공유 버튼 설치의 번거로움을 줄이기 위해 공유 양식 중계 서비스를 제공하고 있습니다.\ 이 서비스는 누구나 무료로 이용할 수 있습니다. diff --git a/content/ko/docs/2.for-users/3.features/thread-mute.md b/content/ko/docs/2.for-users/3.features/thread-mute.md index 6745ee7f..f4552d5e 100644 --- a/content/ko/docs/2.for-users/3.features/thread-mute.md +++ b/content/ko/docs/2.for-users/3.features/thread-mute.md @@ -1,7 +1,9 @@ # 스레드 뮤트 :::tip + 버전 12.95.0 이후 기능입니다. + ::: 스레드 뮤트는 지정한 노트의 스레드를 음소거합니다.스레드(thread)는 시작 노트에서 연결된 모든 답글을 의미합니다. @@ -11,5 +13,7 @@ Misskey Web에서 스레드를 뮤트하려면 대상 스레드에 속한 모든 노트 또는 시작 노트의 메뉴를 열고 '스레드 뮤트'를 선택합니다. :::warning + 스레드 내 어느 노트에서 뮤트 조작을 수행하든 상관없이 해당 스레드 전체가 뮤트됩니다. + ::: diff --git a/content/ko/docs/2.for-users/3.features/webhook.md b/content/ko/docs/2.for-users/3.features/webhook.md index 644a3931..d864b647 100644 --- a/content/ko/docs/2.for-users/3.features/webhook.md +++ b/content/ko/docs/2.for-users/3.features/webhook.md @@ -1,11 +1,15 @@ # Webhook :::tip + 버전 12.109.0 이후 기능입니다. + ::: :::warning + 실험적인 기능이기 때문에 작동이 불안정하거나 향후 사양이 변경될 수 있습니다. + ::: Misskey에는 Webhook이 준비되어 있습니다.Webhook을 이용하면 Misskey의 다양한 이벤트를 실시간으로 받아볼 수 있습니다. diff --git a/content/ko/docs/2.for-users/4.resources/1.troubleshooting.md b/content/ko/docs/2.for-users/4.resources/1.troubleshooting.md index cdde30fe..19090bdd 100644 --- a/content/ko/docs/2.for-users/4.resources/1.troubleshooting.md +++ b/content/ko/docs/2.for-users/4.resources/1.troubleshooting.md @@ -5,18 +5,20 @@ description: 문제가 발생하면 먼저 이곳을 확인하시기 바랍니 # 문제 해결 :::tip + [자주 묻는 질문](./faq.md)도 함께 참고하시기 바랍니다. + ::: 문제가 발생하면 먼저 이곳을 확인해 주세요. 해당 항목이 없거나, 해당 절차를 시도해도 해결되지 않는 경우, 서버 관리자에게 문의하거나 [문제 신고](../../about-misskey/# 토론에 참여)해 주시기 바랍니다. -## 클라이언트가 실행되지 않음 +## 클라이언트가 작동하지 않을 때 -대부분의 경우 브라우저 또는 OS 버전이 오래되었기 때문일 수 있습니다. -브라우저 및 OS 버전을 최신 버전으로 업데이트한 후 다시 시도해 보세요. +대부분의 경우, 사용하는 브라우저 또는 운영체제의 버전이 오래되었기 때문입니다. +브라우저 및 운영체제를 최신 버전으로 갱신하고 다시 시도해 보세요. -드물게 발생하지만, 그래도 실행되지 않는 경우 캐시가 원인일 수 있습니다.브라우저의 캐시를 지우고 다시 시도해 보세요. +클라이언트가 실행하는 페이지가 로드되지 않는다는 오류가 발생한다면, 네트워크에 문제가 없는지 확인해 보시기 바랍니다.또한 서버가 다운되지 않았는지 확인해야 합니다. ## 페이지가 로드되지 않음 @@ -24,50 +26,50 @@ description: 문제가 발생하면 먼저 이곳을 확인하시기 바랍니 드물지만 캐시가 원인인 경우도 있습니다.브라우저의 캐시를 지우고 다시 시도해 보세요. -그래도 문제가 지속된다면 서버의 문제인 것 같으니 서버 관리자에게 문의하시기 바랍니다. +인터넷 서비스 제공 업체의 장애 및 유지 보수 일정 확인, 네트워크의 통신 속도 상태 및 네트워크 설정 확인, 서버 측의 장애 및 유지 보수 여부를 확인한 후 다음 설정을 시도하거나 확인하십시오. ## 클라이언트 동작이 느림 인터넷 서비스 제공 업체의 장애 및 유지 보수 일정 확인, 네트워크의 통신 속도 상태 및 네트워크 설정 확인, 서버 측의 장애 및 유지 보수 여부를 확인한 후 다음 설정을 시도하거나 확인하십시오. -1.Misskey 웹 설정 -메뉴에서 설정을 열고, 클라이언트 설정 전반을 열어 아래 설정을 시도해 보세요. - -- 외형에서 'UI 애니메이션 줄이기' 활성화하기 -- 외형의 '모달에 흐림 효과 사용' 비활성화하기 -- 외형에서 '시스템 기본 글꼴 사용' 활성화하기 -- 외형에서 'OS 기본 이모티콘 사용'을 활성화하기. - 아래 설정은 Misskey의 일부 기능이 작동하지 않을 수 있음을 인지하고 시도해 보시기 바랍니다. - 동작의 'Pages의 스크립트 비활성화' 비활성화하기 - 외형에서 '움직이는 MFM 비활성화'를 활성화하기. +- 외형에서 '시스템 기본 글꼴 사용' 활성화하기 +- 외형에서 'OS 기본 이모티콘 사용'을 활성화하기. 2. 웹 브라우저 설정 - 웹 브라우저 설정에서 하드웨어 가속을 사용하도록 설정합니다. - 웹 브라우저의 애드온 및 확장 프로그램 설정을 확인하거나 해당 기능을 끄십시오. + +3. 기타 + +- PC나 스마트폰의 시스템 설정 확인하기 +- 웹 브라우저의 애드온 및 확장 프로그램 설정을 확인하거나 해당 기능을 끄십시오. - 웹 브라우저의 기타 설정 확인 3. 기타 - PC나 스마트폰의 시스템 설정 확인하기 -## Misskey Web의 UI 일부 표시가 이상함(배경이 투명하게 표시되는 등) +## Misskey Web의 사용자 인터페이스의 일부 표시가 이상할 때(배경이 투명한 경우 등) -업데이트로 인해 UI 개편이 이루어졌을 때, 테마의 캐시 시스템의 영향으로 그런 표시가 나올 수 있습니다. -클라이언트 설정에서 '캐시 지우기'를 하면 해결됩니다. +갱신으로 사용자 인터페이스의 변경이 있는 경우에 테마의 캐시 시스템의 영향으로 이러한 표시가 나타날 수 있습니다. +클라이언트 설정에서 ‘캐시 초기화’를 하면 고쳐집니다. :::warning -'클라이언트'의 캐시를 지우는 것입니다.'브라우저'의 캐시를 지우지 마십시오. + +‘클라이언트’의 캐시 초기화입니다.‘브라우저’의 캐시 초기화는 하지 마십시오. + ::: -## 알림이나 안테나 등의 깜박임이 사라지지 않음 +## Misskey Web의 UI에서 특정 요소가 표시되지 않음 -깜박임은 읽지 않은 콘텐츠가 있음을 나타냅니다.보통 깜빡임이 사라지지 않는 경우, 콘텐츠를 거슬러 올라가면 읽지 않은 콘텐츠가 남아있을 수 있습니다. -모두 읽은 것으로 간주되는데도 계속 깜빡이는 경우(아마도 결함일 가능성이 높습니다), 설정에서 강제로 모두 읽은 것으로 처리할 수 있습니다. +웹브라우저에서 광고 차단기와 같은 애드온이나 확장 프로그램을 사용하다 보면 이런 문제가 발생할 수 있습니다.해당 설정을 확인하거나 끄고 사용하시기 바랍니다. -## 리노트를 할 수 없음 +## Misskey Web의 UI에 번역되지 않은 부분이 존재함. 공개 범위가 팔로워로 한정된 노트 및 DM은 리노트를 할 수 없습니다. @@ -79,4 +81,4 @@ description: 문제가 발생하면 먼저 이곳을 확인하시기 바랍니 대부분의 경우 Misskey Web의 UI가 제대로 번역되지 않았기 때문이므로 결함이 아닙니다.번역이 끝날 때까지 잠시만 기다려 주시기 바랍니다. -만약 당신이 Misskey의 번역에 관심이 있다면 [번역에 참여하기](../../about-misskey/# 텍스트를 번역하기)해 주시는 것도 물론 가능합니다. +만약 당신이 Misskey의 번역에 관심이 있다면 [번역에 참여하기](../../about-misskey/#텍스트를 번역하기)해 주시는 것도 물론 가능합니다. diff --git a/content/ko/docs/2.for-users/4.resources/donate.md b/content/ko/docs/2.for-users/4.resources/donate.md index f0a6f65b..ae839bc7 100644 --- a/content/ko/docs/2.for-users/4.resources/donate.md +++ b/content/ko/docs/2.for-users/4.resources/donate.md @@ -13,20 +13,27 @@ Misskey는 비즈니스가 아니며, 이용은 무료이기 때문에 수익은 - [아마존 위시리스트](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip + 고액 기부(예: 5만엔 이상)를 하실 경우, PayPal 등에서는 수수료가 비싸기 때문에 Kyash를 고려하시거나, 연락 주시면 은행 계좌를 알려드리겠습니다. + ::: :::tip -額に応じて以下の返礼を用意しています。 + +금액에 따라 다음과 같은 보답을 준비했습니다. - 1,000엔 이상: misskey.io 계정에 mi 배지를 부여합니다. - 3,000엔 이상: ↑ + Misskey의 크레딧에 이름 기재 - 10,000엔 이상: ↑ + Misskey의 크레딧에 이름 + 임의의 아이콘 게재 - ::::: + +::::: :::warning + **배지 부여 및 크레딧에 자동으로 기재되지 않으므로, 원하시는 분은 기부 사실을 알 수 있는 정보를 첨부하여 @syuilo\@misskey.io로 보내주시기 바랍니다.** -(멘션을 못 알아볼 수 있으니 답글이 없으면 여러번 멘션 부탁드립니다.또한 misskey.io 외의 서버에서는 멘션이 오지 않을 수 있습니다) + +\*\*(멘션을 못 알아볼 수 있으니 답글이 없으면 여러번 멘션 부탁드립니다.또한 misskey.io 외의 서버에서는 멘션이 오지 않을 수 있습니다) + ::: 또한 서버 운영자도 기본적으로 수익을 얻지 못하고 있습니다.서버 운영에는 비용이 많이 들기 때문에 운영자 지원도 고려해보시기 바랍니다. diff --git a/content/ko/docs/2.for-users/4.resources/misskey-hub.md b/content/ko/docs/2.for-users/4.resources/misskey-hub.md index 7effd26d..1efb6ff9 100644 --- a/content/ko/docs/2.for-users/4.resources/misskey-hub.md +++ b/content/ko/docs/2.for-users/4.resources/misskey-hub.md @@ -6,9 +6,11 @@ Misskey Hub는 Misskey에 대한 지식 등의 문서, 개발 블로그, 플러 Misskey Hub도 [오픈소스로 공개되어 있습니다.](https://github.com/misskey-dev/misskey-hub) :::tip + Misskey Hub는 Nuxt를 사용하여 구축된 정적 사이트입니다. + ::: -## Misskey Hub에 기여하기 +## Misskey Hub에 이바지하기 -문서 추가, 번역 등 환영합니다. +설명 문서의 추가나 번역 등을 환영합니다. diff --git a/content/ko/docs/3.for-admin/features/announcement.md b/content/ko/docs/3.for-admin/features/announcement.md index 334528fd..4108e802 100644 --- a/content/ko/docs/3.for-admin/features/announcement.md +++ b/content/ko/docs/3.for-admin/features/announcement.md @@ -5,12 +5,14 @@ 공지사항 기능을 사용하여, 서버 전체에 있는 유저에게 공지사항을 등록할 수 있으며, 개별적으로도 유저에게 서버를 통해 메시지를 보낼 수도 있습니다. :::warning -アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。 + +활성화된 공지사항의 수가 많으면 특히 새 사용자의 확인 활동이 늘어나 사용자 경험이 줄어들 가능성이 있습니다.이 경우, 아래와 같이 검토할 수 있습니다. - "기존 유저만" 옵션을 켜고 공지사항을 작성하기 - "알림 없음" 옵션을 켜고 공지사항을 작성하기 - 이전의 공지사항을 저장하기 - ::: + +::: ## 표시 방식 diff --git a/content/ko/docs/3.for-admin/features/role.md b/content/ko/docs/3.for-admin/features/role.md index af906053..b329f77f 100644 --- a/content/ko/docs/3.for-admin/features/role.md +++ b/content/ko/docs/3.for-admin/features/role.md @@ -21,11 +21,13 @@ - **조건부 역할** ... 조건을 설정하여 이에 맞는 유저가 자동으로 역할을 부여받게 됩니다.(조건부 역할) :::warning -コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 + +조건부 롤은 수동 롤에 비해 다음과 같은 한계가 있습니다. - 수동으로 부여/부여 해제는 불가능합니다. - 지정한 조건부 역할에 포함되는 유저 목록을 불러올 수는 없습니다. - ::: + +::: ## 권한 @@ -53,7 +55,8 @@ **우선도가 같은 경우, 기본적으로 제일 크거나 제일 권한이 넓은 값이 자동으로 선택됩니다.** :::tip -例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 + +예를 들어, 사용자에게 역할 A와 역할 B가 할당되어 있고, 역할 A의 드라이브 용량 정책이 500MB, 역할 B의 드라이브 용량 정책이 300MB로 정의되어 있는 경우, - 우선도나 같거나 역할 A의 드라이브 용량 정책이 우선도가 높은 경우 500MB 값이 적용됩니다. - 역할 B의 드라이브 용량 정책의 우선도가 높은 경우 300MB 값이 적용됩니다. @@ -62,7 +65,9 @@ - 우선도가 같거나 또는 역할 D의 공개 노트 가능 정책의 우선도가 높은 경우 "예" 값이 적용됩니다. - 역할 C의 공개 노트 가능 정책 우선도가 높은 경우 "아니오" 값이 적용됩니다. - ::: +::: + +::: ### 기본 정책 값을 사용 @@ -85,13 +90,15 @@ 부여할 때 부여되는 기간에 대해서도 설정할 수 있습니다. :::tip -:::tip + 역할의 부여하기/해제하기가 반영될 떄까지 시간이 걸리는 경우가 있습니다. -::: + ::: :::warning + 조건부 역할은 수동으로 부여할 수 없습니다. + ::: ## 유저 정책 확인 diff --git a/content/ko/docs/3.for-admin/install/guides/1.index.md b/content/ko/docs/3.for-admin/install/guides/1.index.md index 43764c5d..53ee2ccf 100644 --- a/content/ko/docs/3.for-admin/install/guides/1.index.md +++ b/content/ko/docs/3.for-admin/install/guides/1.index.md @@ -7,11 +7,14 @@ description: Misskey 서버를 만드는 방법에 대해서 안내합니다. Misskey 서버 구축에 관심을 가져주셔서 감사합니다.서버를 만드는 방법은 여러가지가 있으므로, 아래 중에서 가이드를 골라서 읽어주세요. :::danger -한 번 사용한 서버의 도메인, 호스트 이름 안에선, 데이터 베이스를 다시 만들지 말아주세요! + +일단 작동하기 시작한 서버의 도메인 및 호스트 이름으로는 데이터베이스를 다시 만들지 마십시오! + ::: :::warning -自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 + +자신의 서버에 Cloudflare를 사용하는 경우, Auto Minify 설정을 사용하지 않는 것이 좋습니다. Misskey의 소스 코드는 이미 Minify되어져 있으므로, 의미가 없을 뿐만이 아니라, Cloudflare가 최신 JavaScript를 해석하지 않고, 그 안에 있는 소스 코드를 파괴하므로, Misskey가 정상적으로 움직이지 않습니다. diff --git a/content/ko/docs/3.for-admin/install/guides/bash.md b/content/ko/docs/3.for-admin/install/guides/bash.md index 9569ce26..546f11ba 100644 --- a/content/ko/docs/3.for-admin/install/guides/bash.md +++ b/content/ko/docs/3.for-admin/install/guides/bash.md @@ -20,7 +20,9 @@ Misskey를 간단하게 설치하기 위한 쉘 스크립트가 만들어졌습 3. Cloudflare 계정 (권장) :::danger + 한 번 사용한 서버의 도메인, 호스트 이름 안에선, 데이터 베이스를 다시 만들지 말아주세요! + ::: Let's Encrypt 인증을 할 수 있는 횟수가 적으므로, 서버의 네트워크가 DNS 설정을 확실히 확인한 후에 설치하시길 바랍니다. diff --git a/content/ko/docs/3.for-admin/install/guides/docker.md b/content/ko/docs/3.for-admin/install/guides/docker.md index 901e9d9b..093f54b2 100644 --- a/content/ko/docs/3.for-admin/install/guides/docker.md +++ b/content/ko/docs/3.for-admin/install/guides/docker.md @@ -7,15 +7,18 @@ description: 이 가이드는 Docker를 사용하여 Misskey를 설정하는 방 이 가이드는 Docker Compose를 사용하여 Misskey를 설정하는 방법을 설명합니다. :::danger + 일단 작동하기 시작한 서버의 도메인 및 호스트 이름으로는 데이터베이스를 다시 만들지 마십시오! + ::: :::tip{label='前提条件'} - Docker 및 Docker Compose가 설치되어 있어야 합니다. - :::. -## 리포지토리 가져오기 +:::. + +## 설정 ```sh git clone -b master https://github.com/misskey-dev/misskey.git @@ -60,7 +63,9 @@ GLHF✨ ## Misskey 업데이트 방법 :::warning + 업데이트 시 반드시 [릴리스 노트](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)를 확인하여 변경 사항 및 추가 작업 여부(대부분 없음)를 미리 파악하시기 바랍니다. + ::: ```sh diff --git a/content/ko/docs/3.for-admin/install/guides/kubernetes.md b/content/ko/docs/3.for-admin/install/guides/kubernetes.md index 0ee83a35..053a0ccb 100644 --- a/content/ko/docs/3.for-admin/install/guides/kubernetes.md +++ b/content/ko/docs/3.for-admin/install/guides/kubernetes.md @@ -3,7 +3,9 @@ 이 가이드에서는 Kubernetes와 HelmChart를 사용하여 Misskey를 설정하는 방법을 설명합니다. :::danger + 일단 작동하기 시작한 서버의 도메인 및 호스트 이름으로는 데이터베이스를 다시 만들지 마십시오! + ::: ## TrueCharts 및 TrueNAS Scale @@ -16,7 +18,7 @@ Misskey의 HelmCharts는 TrueNAS Scale에서 사용할 수 있도록 TrueCharts 현재 Misskey는 _incubator_ train을 진행 중입니다. -:::前提条件 +:::tip{label='前提条件'} - TrueNAS Scale 또는 diff --git a/content/ko/docs/3.for-admin/install/guides/manual.md b/content/ko/docs/3.for-admin/install/guides/manual.md index 84f5597a..768d2989 100644 --- a/content/ko/docs/3.for-admin/install/guides/manual.md +++ b/content/ko/docs/3.for-admin/install/guides/manual.md @@ -7,7 +7,9 @@ description: 이 가이드에서는 Misskey의 설치 및 설정 방법에 대 이 가이드에서는 Misskey의 설치 및 설정 방법에 대해 설명합니다. :::danger + 일단 사용하기 시작한 서버의 도메인 및 호스트 이름은 절대로 변경하지 마십시오! + ::: :::tip{label='前提条件'} @@ -35,10 +37,15 @@ Misskey는 루트 사용자로 실행하지 않는 것이 좋으므로, 대신 데비안 예시: ```sh -adduser --disabled-password --disabled-login misskey +sudo -iu misskey +git clone --recursive https://github.com/misskey-dev/misskey.git +cd misskey +git checkout master +git submodule update --init +NODE_ENV=production pnpm install --frozen-lockfile ``` -## Misskey 설치하기 +## 설정 ```sh sudo -iu misskey @@ -51,13 +58,14 @@ NODE_ENV=production pnpm install --frozen-lockfile ## 설정 -설정 샘플의 `.config/example.yml`을 복사하여 `default.yml`로 이름을 바꿉니다. +파일 내 지침에 따라 `default.yml`을 편집합니다. ```sh cp .config/example.yml .config/default.yml ``` -파일 내 지침에 따라 `default.yml`을 편집합니다. +다음 명령어로 Misskey를 빌드하고 데이터베이스를 초기화합니다. +이 작업은 시간이 좀 걸립니다. ## 빌드 및 초기화 @@ -77,16 +85,16 @@ pnpm run init NODE_ENV=production pnpm run start ``` -GLHF✨ - -::::g-details{summary="systemd를 이용한 관리"} - systemd 서비스 파일 생성하기 `/etc/systemd/system/misskey.service` 편집기에서 열어, 다음 코드를 붙여넣고 저장합니다. +`/etc/systemd/system/misskey.service` + +편집기에서 열어, 다음 코드를 붙여넣고 저장합니다. + ```ini [Unit] Description=Misskey daemon @@ -108,7 +116,9 @@ WantedBy=multi-user.target ``` :::warning -CentOS에서 1024 이하의 포트를 사용하여 Misskey를 사용하려면 `ExecStart=/usr/bin/sudo /usr/bin/npm start`로 변경해야 합니다. + +misskey 서비스 시작 + ::: systemd 리로드 및 misskey 서비스 활성화 @@ -125,15 +135,19 @@ sudo systemctl start misskey ``` :::tip + `systemctl status misskey`를 입력하면 서비스 상태를 확인할 수 있습니다. + ::: -:::: +업데이트가 끝나면 Misskey 프로세스를 다시 시작하십시오. ## Misskey 업데이트 방법 :::warning + 업데이트 시 반드시 [릴리스 노트](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)를 확인하여 변경 사항 및 추가 작업 여부(대부분 없음)를 미리 파악하시기 바랍니다. + ::: master를 다시 풀링하고, 설치, 빌드, 데이터베이스 마이그레이션을 수행합니다. @@ -156,8 +170,10 @@ sudo systemctl restart misskey ``` :::tip -ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: + +빌드 또는 시작 시 오류가 발생하면 다음 명령을 시도해 보세요. - `pnpm run clean` 또는 `pnpm run clean-all`을 실행합니다. - `pnpm rebuild` - ::: + +::: diff --git a/content/ko/docs/3.for-admin/install/guides/ubuntu-manual.md b/content/ko/docs/3.for-admin/install/guides/ubuntu-manual.md index aa887c94..25c63ec0 100644 --- a/content/ko/docs/3.for-admin/install/guides/ubuntu-manual.md +++ b/content/ko/docs/3.for-admin/install/guides/ubuntu-manual.md @@ -11,11 +11,15 @@ [**쉘 스크립트에 대한 자세한 내용과 사용법은 여기에서 확인하세요!**](./bash/) :::tip + 쉘 스크립트를 통한 개발 환경에서의 설치는 예상하지 않았습니다. + ::: :::tip + 도메인 구매 및 Cloudflare 설정, 서버 확보는 여러분이 직접 준비해 주시기 바랍니다. + ::: 문제가 있으면 [@aqz@p1.a9z.dev 에 멘션](https://p1.a9z.dev/@aqz)으로 알려주시면 감사하겠습니다. @@ -27,7 +31,9 @@ [docker-compose](./docker/)를 사용하면 수작업으로 조금 더 쉽게 실행할 수 있을 것입니다. :::danger + 일단 작동하기 시작한 서버의 도메인 및 호스트 이름으로는 데이터베이스를 다시 만들지 마십시오! + ::: ## 소개 @@ -52,7 +58,9 @@ OS의 차이, Misskey 본체나 의존하는 소프트웨어의 버전업으로 - 여기서는 도메인을 example.tld로 설명할 것이므로, 자신이 구입한 도메인으로 적절히 대체하여 읽도록 합니다.개발 환경의 경우 localhost로 대체합니다(설정 파일 항목에서 별도 설명). :::danger + 일단 사용하기 시작한 서버의 도메인 및 호스트 이름은 절대로 변경하지 마십시오! + ::: ## nano 사용법 @@ -78,7 +86,9 @@ sudo adduser --disabled-password --disabled-login misskey ``` :::tip + 개발 환경의 경우 사용자를 구분할 필요가 없습니다. + ::: ## 기본적인 소프트웨어 설치 및 설정 @@ -177,7 +187,9 @@ active라면 OK. nginx는 주로 리버스 프록시에 사용되는 웹 서버 소프트웨어입니다.Misskey에 필수적인 것은 아니지만, 캐시 등을 하면 성능이 향상되고 http에서 https로 전송하는 등의 작업을 위해 설치해 둡니다. :::tip + 개발 환경의 경우 nginx 설정이 필요하지 않습니다. + ::: nginx.org의 문서 http\://nginx.org/en/linux_packages.html#Ubuntu 에 따라 설치합니다. @@ -238,7 +250,9 @@ sudo apt install -y git build-essential 서버를 인터넷에 공개할 준비를 합니다. :::tip + 개발 환경의 경우 방화벽, CloudFlare, Certbot 설정이 필요하지 않습니다. + ::: ### 방화벽 @@ -272,7 +286,9 @@ sudo systemctl enable ufw ``` :::tip + ufw는 넷필터(iptables)를 사람이 쉽게 조작할 수 있도록 하는 앱입니다.설치 스크립트는 OCI 환경에서는 netfilter를 직접 조작합니다. + ::: ### CloudFlare @@ -376,7 +392,9 @@ nano .config/default.yml 설정할 수 있는 값과 작성 방법은 [.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)에 나와 있습니다. :::tip + 개발 환경의 경우 url은 `url: http://localhost:3000`로 지정합니다. + ::: ```yml @@ -469,7 +487,9 @@ NODE_ENV=production pnpm run build ``` :::tip + 개발 환경의 경우 `NODE_ENV=production`은 필요하지 않습니다.이후 명령어에서도 마찬가지로 삭제해 주세요. + ::: ### 서버에서 빌드할 수 없는 경우 @@ -515,7 +535,9 @@ CloudFlare의 DNS 설정이 올바른 IP 주소로 설정되어 있는지 다시 ## Misskey의 데몬 생성 :::tip + 개발 환경의 경우, 데몬을 만들 필요가 없습니다. + ::: 일단 Ctrl+C로 프로세스를 죽이고, Misskey를 데몬으로 실행하도록 설정해 봅시다. diff --git a/content/ko/docs/3.for-admin/install/resources/cdn.md b/content/ko/docs/3.for-admin/install/resources/cdn.md index e57bf8cd..526ba9b7 100644 --- a/content/ko/docs/3.for-admin/install/resources/cdn.md +++ b/content/ko/docs/3.for-admin/install/resources/cdn.md @@ -17,5 +17,7 @@ CDN에서 다음과 같이 설정해 주세요. - `api/api/*`를 제외한 모든 요청을 캐시. :::tip + Misskey를 업데이트할 때 캐시를 지울 필요가 없습니다. + ::: diff --git a/content/ko/docs/3.for-admin/install/resources/troubleshooting.md b/content/ko/docs/3.for-admin/install/resources/troubleshooting.md index 0162364c..f0a743be 100644 --- a/content/ko/docs/3.for-admin/install/resources/troubleshooting.md +++ b/content/ko/docs/3.for-admin/install/resources/troubleshooting.md @@ -248,6 +248,10 @@ Misskey에서는 오브젝트 스토리지 연결에 [aws-sdk](https://www.npmjs 각 서비스/소프트웨어의 설명서를 잘 읽고 설정해 보세요. +### 로딩이 끝나지 않음 + +Cloudflare를 사용하는 경우, Rocket Loader 또는 Auto Minify가 활성화되어 있는지 확인하십시오.활성화된 경우 비활성화하면 해결될 수 있습니다. + *** # 전혀 해결되지 않은 경우 diff --git a/content/ko/docs/3.for-admin/moderation-tips/disable-timelines.md b/content/ko/docs/3.for-admin/moderation-tips/disable-timelines.md index 620e83df..f4066c0a 100644 --- a/content/ko/docs/3.for-admin/moderation-tips/disable-timelines.md +++ b/content/ko/docs/3.for-admin/moderation-tips/disable-timelines.md @@ -8,7 +8,9 @@ LTL이나 STL은 해당 서버에 있는 모든 사용자의 게시물을 볼 만약 단점이 더 크다고 느낀다면, 해당 타임라인을 비활성화하는 것도 고려해볼 수 있습니다. :::warning + 비활성화를 하면 사용자가 혼란스러워하고 단기적으로 사용자가 감소할 수 있습니다.따라서 비활성화 시에는 그 영향을 신중하게 검토하고, 사전에 설명하고 후속 조치를 마련할 수 있는 기간을 어느 정도 두는 것이 좋습니다. + ::: 단, 관리자/모더레이터는 이러한 타임라인 비활성화 상태가 적용되지 않으며, 계속 사용할 수 있습니다. diff --git a/content/ko/docs/4.for-developers/aiscript.md b/content/ko/docs/4.for-developers/aiscript.md new file mode 100644 index 00000000..6e03e329 --- /dev/null +++ b/content/ko/docs/4.for-developers/aiscript.md @@ -0,0 +1,67 @@ +# AiScript + +AiScript는 Misskey의 다음 부분에서 사용할 수 있는 스크립트 언어입니다. + +- [플러그인](./plugin/) +- [위젯](/docs/for-users/features/widgets/) + - 버튼 + - AiScript 콘솔 + - AiScript App +- Misskey Play +- 스크래치 패드 + +:::tip + +AiScript의 구현은 Misskey와는 별도의 리포지토리로 [오픈소스로 공개되어 있습니다](https://github.com/aiscript-dev/aiscript). + +::: + +## 사용법 + +AiScript 표준 구문과 내장 함수 등을 사용할 수 있습니다. + +:::tip + +문서는 [여기](https://github.com/aiscript-dev/aiscript/tree/master/docs)에서 확인할 수 있습니다.\ +Misskey 본체 버전에 따라 사용할 수 있는 AiScript 버전이 다를 수 있습니다.버전 확인은 `<: Core:v`를 Scratchpad 등에서 실행해 보세요. + +::: + +이 외에도 Misskey 전용 내장 상수 및 함수가 그룹으로 나뉘어 제공되고 있습니다. + +### Misskey AiScript API + +접두사: `Mk:`\ +Misskey 내의 모든 AiScript 환경에서 사용할 수 있는 상수 함수군입니다. +자세한 내용은 [플러그인 API 레퍼런스](./plugin/plugin/plugin-api-reference/)의 `Mk:` 부분을 참고해 주세요. + +### Plugin API + +접두사: `Plugin:`\ +[플러그인](./plugin/)에서만 사용할 수 있는 상수 함수군입니다. +자세한 내용은 [플러그인 API 레퍼런스](./plugin/plugin/plugin-api-reference/)의 `Plugin:` 부분을 참고합니다. + +### UI API + +접두사: `Ui:`\ +[위젯](/docs/for-users/features/widgets/)(AiScript App), Misskey Play, Scratchpad에서 사용할 수 있습니다. +문서는 미정비(TODO)이지만, 인터넷에 자원봉사자가 작성한 설명글이 있습니다. + +### 표준입출력 + +AiScript 표준에서 정의된 `readline` 함수와 `print` 함수(및 `<:` 구문)의 내부 구현은 Misskey 측에서 독자적으로 제공하고 있습니다. + +#### readline(message) + +`message`: `str`\ +반환값: `str`\ +Misskey 내 모든 AiScript 환경에서 사용할 수 있습니다.\ +문자열 입력을 요청하는 팝업을 표시합니다. + +#### print(message) + +`message`: `any`\ +반환값: `null`\ +[위젯](/docs/for-users/features/widgets/) (AiScript 콘솔), Scratchpad에서 사용할 수 있습니다.\ +콘솔에 문자열을 출력합니다.\ +`<:`구문도 비슷한 역할을 합니다. diff --git a/content/ko/docs/4.for-developers/api/1.index.md b/content/ko/docs/4.for-developers/api/1.index.md index 0ba43e54..11cdba1c 100644 --- a/content/ko/docs/4.for-developers/api/1.index.md +++ b/content/ko/docs/4.for-developers/api/1.index.md @@ -8,7 +8,9 @@ Misskey는 API를 공개하고 있습니다.API를 사용하여 Misskey 클라 스트리밍 API도 있어 실시간 애플리케이션을 만들 수도 있습니다. :::tip -Misskey 공식 SDK나 서드파티 라이브러리를 사용하면 이 문서에서 설명하는 몇 가지 단계를 간소화할 수 있는 등 보다 편리하게 API를 사용할 수 있습니다.\ + +Misskey 공식 SDK나 서드파티 라이브러리를 사용하면 이 문서에서 설명하는 몇 가지 단계를 간소화할 수 있는 등 보다 편리하게 API를 사용할 수 있습니다.\\ + ::: diff --git a/content/ko/docs/4.for-developers/api/libraries.md b/content/ko/docs/4.for-developers/api/libraries.md index bb307e48..b929f963 100644 --- a/content/ko/docs/4.for-developers/api/libraries.md +++ b/content/ko/docs/4.for-developers/api/libraries.md @@ -15,6 +15,8 @@ description: Misskey API 관련 라이브러리 목록 ## Python - [Misskey.py](https://github.com/YuzuRyo61/Misskey.py) +- [MiPA](https://github.com/yupix/MiPA) +- [MiPAC](https://github.com/yupix/MiPAC) ## .Net diff --git a/content/ko/docs/4.for-developers/api/permission.md b/content/ko/docs/4.for-developers/api/permission.md index c4d4e2f2..dda1d498 100644 --- a/content/ko/docs/4.for-developers/api/permission.md +++ b/content/ko/docs/4.for-developers/api/permission.md @@ -5,7 +5,9 @@ description: 애플리케이션이 요구하는 권한 목록 # 권한 목록 :::tip -이 페이지는 [misskey-js](https://github.com/misskey-dev/misskey/tree/develop/packages/misskey-js)에서 자동 생성한 것이므로 문서나 번역이 불완전할 수 있습니다. + + + ::: diff --git a/content/ko/docs/4.for-developers/api/streaming/1.index.md b/content/ko/docs/4.for-developers/api/streaming/1.index.md index d7336ded..638ebe26 100644 --- a/content/ko/docs/4.for-developers/api/streaming/1.index.md +++ b/content/ko/docs/4.for-developers/api/streaming/1.index.md @@ -5,11 +5,13 @@ description: 스트리밍 API를 사용하면, 실시간으로 다양한 정보( # 스트리밍 API :::tip -처음에 [Misskey API](../index.md)의 문서를 읽는 것을 추천합니다. -::: 스트리밍 API를 사용하면, 실시간으로 다양한 정보(예를 들어 타임라인에 새로운 노트가 올라왔다거나, 리액션을 받았거나 팔로우 되었다거나 등)를 받거나, 다양한 작업을 할 수 있습니다. +::: + +스트리밍 API를 이용하려면, 먼저 Misskey 서버에 **websocket**으로 접속이 필요합니다. + ## 스트림에 접속하기 스트리밍 API를 이용하려면, 먼저 Misskey 서버에 **websocket**으로 접속이 필요합니다. @@ -26,20 +28,24 @@ wss://{host}/streaming?i={token} - `{token}`의 부분은, 유저의 액세스 토큰으로 바꿉니다. :::tip + 액세스 토큰은 생략할 수 있지만, 이 경우 비로그인으로 작동하기 때문에 수신할 수 있는 정보나 조작은 제한됩니다. + ::: 스트림에 접속하면, 후술할 노트의 구독을 하는 것이 가능합니다. 그러나, 아직 이 단계에서는 타임라인의 새로운 노트를 확인하는 등의 행동을 할 수 없습니다. 이러한 이벤트를 수신하기 위해서는, 스트림 상에 후술할 **채널**에 접속해야 합니다. -**스트림상에서 주고 받는 정보는 모두 JSON입니다.** +\*\*스트림상에서 주고 받는 정보는 모두 JSON입니다.어떠한 채널이 있는 지는, [채널 목록](./channel/index.md)를 참조해 주세요. -## 채널 +## 채널에 접속하기 Misskey의 스트리밍 API에는 채널이라는 개념이 있습니다.이것은 송수신하는 정보를 분리하기 위한 구조입니다. 스트림 상에서 채널에 접속함으로써, 다양한 정보를 받거나 보낼 수 있게 됩니다. :::tip + 하나의 스트림 연결에서, 동시에 여러 개의 채널에 접속할 수 있습니다. + ::: 아래에서 채널의 사용 방법을 설명합니다.어떠한 채널이 있는 지는, [채널 목록](./channel/index.md)를 참조해 주세요. @@ -68,7 +74,9 @@ Misskey의 스트리밍 API에는 채널이라는 개념이 있습니다.이것 - `params`는 채널에 연결할 때의 파라미터입니다.채널에 따라 연결 시 필요한 파라미터가 다릅니다.파라미터가 필요 없는 채널에 연결할 때는 이 속성을 생략할 수 있습니다. :::tip + ID는 채널 단위가 아니라 '채널 연결 단위'입니다.왜냐하면 같은 채널에 서로 다른 파라미터로 다중접속 하는 경우도 있기 때문입니다. + ::: ### 채널에서 메시지 받기 @@ -147,7 +155,7 @@ Misskey는 게시물 캡쳐라는 메커니즘을 제공하고 있습니다.지 이 문제를 해결하기 위해 Misskey는 게시물 캡처 기능을 제공하고 있습니다.게시물을 캡처하면 해당 게시물에 대한 이벤트를 수신할 수 있기 때문에 실시간으로 반응을 반영할 수 있습니다. -아래에서는 게시물 캡처 기능을 사용하는 방법을 설명합니다.어떤 캡처 이벤트가 있는지는 [캡처 이벤트 목록](. /note-capture-events.md)에서 확인할 수 있습니다. +아래에서는 게시물 캡처 기능을 사용하는 방법을 설명합니다.어떤 캡처 이벤트가 있는지는 [캡처 이벤트 목록](./note-capture-events.md)에서 확인할 수 있습니다. ### 게시물 캡처하기 @@ -162,13 +170,13 @@ Misskey는 게시물 캡쳐라는 메커니즘을 제공하고 있습니다.지 } ``` -여기서, +해당 게시물이 더 이상 화면에 표시되지 않거나, 해당 게시물에 대한 이벤트를 더 이상 받을 필요가 없을 때는 캡처 해제를 신청하세요. - `id`에 캡처하고자 하는 게시물의 `id`를 설정합니다. 이 메시지를 보내면 Misskey에 캡쳐를 요청하는 것이며, 이후 해당 게시물에 대한 이벤트가 흘러나오게 됩니다. -예를 들어, 게시물에 리액션이 붙었다고 가정하면 다음과 같은 메시지가 나옵니다. +여기서, ```js { @@ -184,7 +192,7 @@ Misskey는 게시물 캡쳐라는 메커니즘을 제공하고 있습니다.지 } ``` -여기서, +이 메시지를 보내면 이후 해당 게시물에 대한 이벤트가 발생하지 않습니다. - `body` 내의 `id`에는 이벤트를 발생시킨 게시물의 ID가 설정됩니다. - `body` 내의 `type`에는 이벤트의 종류가 설정됩니다. diff --git a/content/ko/docs/4.for-developers/api/token.md b/content/ko/docs/4.for-developers/api/token.md index d992ba84..f546afd2 100644 --- a/content/ko/docs/4.for-developers/api/token.md +++ b/content/ko/docs/4.for-developers/api/token.md @@ -7,7 +7,9 @@ API를 사용하기 위해서는 API를 사용할 계정에 연결된 **액세 액세스 토큰은 사용자에 연결된 인증 정보로, API를 이용하는 사용자를 식별하는 동시에 액세스 토큰별로 어떤 작업 권한을 가지고 있는지 관리합니다. :::tip + 사용자와 그 사용자와 연결된 액세스 토큰은 일대다 관계이며, 한 사용자에게 여러 개의 액세스 토큰이 발급될 수 있습니다. + ::: 자신의 액세스 토큰을 쉽게 획득할 수 있을 뿐만 아니라, 자신의 애플리케이션을 사용하게 될 불특정 사용자의 액세스 토큰을 획득할 수도 있습니다. @@ -20,7 +22,9 @@ API를 사용하기 위해서는 API를 사용할 계정에 연결된 **액세 Misskey Web의 '설정 > API'에서 자신의 액세스 토큰을 발행할 수 있습니다. :::danger + 액세스 토큰은 다른 사람이 알 수 없도록 해야 합니다. + ::: ### 애플리케이션 사용자에게 액세스 토큰 발급 요청하기 @@ -32,6 +36,7 @@ Misskey Web의 '설정 > API'에서 자신의 액세스 토큰을 발행할 수 아래 설명할 방법은 앱을 만들지 않고 즉시 액세스 토큰을 발급하는 MiAuth라는 방법입니다. [앱 생성 방식으로 액세스 토큰을 획득하는 방법도 있습니다(구식).](./app) + ::: #### Step 1 @@ -39,7 +44,9 @@ Misskey Web의 '설정 > API'에서 자신의 액세스 토큰을 발행할 수 UUID를 생성합니다.이후 이를 **세션 ID**라고 부릅니다. :::danger + 이 세션 ID는 매번 생성해야 하며, 반복해서 사용하지 않도록 해야 합니다. + ::: #### Step 2 @@ -119,7 +126,9 @@ https://{host}/api/miauth/{session}/check API에 대한 자세한 내용은 API 레퍼런스를 참조하세요. :::warning + Misskey는 REST를 채택하고 있지 않습니다. + ::: 또한 Misskey는 HTTP API뿐만 아니라 스트리밍 API도 제공하고 있습니다.스트리밍 API에 대한 자세한 내용은 [이 문서](./streaming/index.md)를 참고하세요. diff --git a/content/ko/docs/4.for-developers/api/token/1.index.md b/content/ko/docs/4.for-developers/api/token/1.index.md new file mode 100644 index 00000000..280e5228 --- /dev/null +++ b/content/ko/docs/4.for-developers/api/token/1.index.md @@ -0,0 +1,88 @@ +# 액세스 토큰 획득하기 + +API를 사용하기 위해서는 API를 사용할 계정에 연결된 **액세스 토큰**을 발급받아야 합니다. +이 문서에서는 액세스 토큰을 획득하는 방법을 설명한 후, 기본적인 API 사용법을 설명합니다. + +기본적으로 API는 요청 시 액세스 토큰이 필요합니다. +액세스 토큰은 사용자에 연결된 인증 정보로, API를 이용하는 사용자를 식별하는 동시에 액세스 토큰별로 어떤 작업 권한을 가지고 있는지 관리합니다. + +:::tip + +사용자와 그 사용자와 연결된 액세스 토큰은 일대다 관계이며, 한 사용자에게 여러 개의 액세스 토큰이 발급될 수 있습니다. + +::: + +자신의 액세스 토큰을 쉽게 획득할 수 있을 뿐만 아니라, 자신의 애플리케이션을 사용하게 될 불특정 사용자의 액세스 토큰을 획득할 수도 있습니다. + +- 전자의 경우: \*\*"자신의 액세스 토큰을 수동으로 발행하기"\*\*로 이동합니다. +- 후자의 경우: \*\*"애플리케이션 사용자에게 액세스 토큰 발급 요청하기"\*\*로 이동합니다. + +## 자신의 액세스 토큰을 수동으로 발행하기 + +Misskey Web의 '설정 > API'에서 자신의 액세스 토큰을 발행할 수 있습니다. + +:::danger + +액세스 토큰은 다른 사람이 알 수 없도록 해야 합니다. + +::: + +## 애플리케이션 사용자에게 액세스 토큰 발급 요청하기 + +애플리케이션을 이용하는 사용자(이하 단순히 '사용자'라 칭함)의 액세스 토큰을 얻기 위해서는 아래의 방법 중 하나를 사용합니다. + +:MkIndex + +## API 이용 + +액세스 토큰을 획득하면 각종 엔드포인트에 요청하여 API를 사용할 수 있습니다. + +:::tip + +- HTTP API는 모두 POST이며, 요청/응답 모두 JSON 형식입니다(drive/files/create 제외). +- 요청 헤더에 `Content-Type: application/json`을 지정합니다. +- 액세스 토큰은 `i`라는 파라미터 이름으로 요청 본문 JSON에 포함합니다. +- 기본 URL은 `https://{서버의 도메인}/api`입니다. + +::: + +### Authorization header를 사용하는 방식 + +아래와 같이 헤더의 `Authorization` 필드를 지정합니다. + +```js +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + text: "Hello Misskey API World with My Application!" + }), + headers: { + Authorization: `Bearer ${accessToken}`, + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` + +### i를 사용하는 방식 + +액세스 토큰이 있는 바디의 예시 (meta의 경우):. + +```json +{ + "i": "HogEFugA1341", + "detail": false +} +``` + + + +API에 대한 자세한 내용은 API 레퍼런스를 참조하세요. + +:::warning + +Misskey는 REST를 채택하고 있지 않습니다. + +::: + +또한 Misskey는 HTTP API뿐만 아니라 스트리밍 API도 제공하고 있습니다.스트리밍 API에 대한 자세한 내용은 [이 문서](./streaming/)를 참고하세요. diff --git a/content/ko/docs/4.for-developers/api/token/2.miauth.md b/content/ko/docs/4.for-developers/api/token/2.miauth.md new file mode 100644 index 00000000..a0a2681f --- /dev/null +++ b/content/ko/docs/4.for-developers/api/token/2.miauth.md @@ -0,0 +1,76 @@ +--- +description: v12.27.0 이상에서 사용할 수 있는 Misskey만의 간단한 인증 방법을 설명합니다. +--- + +# MiAuth 방식의 액세스 토큰 획득 방식 + +애플리케이션을 이용하는 사용자(이하 단순히 '사용자'라 칭함)의 액세스 토큰을 발급받으려면 아래 절차에 따라 발급을 요청합니다. + +:::tip + +아래 설명할 방법은 앱을 만들지 않고 즉시 액세스 토큰을 발급하는 MiAuth라는 방법입니다. + +- [더 많이 사용되는 OAuth 방식으로 액세스 토큰을 획득하는 방법도 있습니다.](./oauth.md) +- [앱 생성 방식으로 액세스 토큰을 획득하는 방법도 있습니다(구식).](./app.md) + +::: + +## Step 1 + +UUID를 생성합니다.이후 이를 **세션 ID**라고 부릅니다. + +:::danger + +이 세션 ID는 매번 생성해야 하며, 반복해서 사용하지 않도록 해야 합니다. + +::: + +## Step 2 + +애플리케이션 인증 양식을 사용자의 브라우저에 표시하도록 합니다.인증 양식은 다음 형식의 URL로 열 수 있습니다. + +``` +https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive +``` + +여기서, + +- `{host}`부분은 사용자 서버의 호스트로 대체합니다.보통 호스트는 사용자가 입력합니다. +- `{session}`부분은 세션 ID로 대체합니다. + +사용자가 애플리케이션 접근을 허용한 후 다음 형식의 URL에 POST 요청하면 응답으로 액세스 토큰이 포함된 JSON이 반환됩니다. + +| 이름 | 설명 | +| ------------ | ---------------------------------------------------------------------------------------- | +| `name` | 애플리케이션 이름. | +| `icon` | 애플리케이션 아이콘의 이미지 URL. | +| `callback` | 인증이 끝난 후 리디렉션되는 URL.
리디렉션 시에는 `session`이라는 쿼리 파라미터로 세션 ID가 붙습니다. | +| `permission` | 애플리케이션이 요구하는 권한.
요청하는 권한을 `,`로 구분하여 열거합니다.권한 목록은 [여기](./permission.md)에서 확인할 수 있습니다. | + +:::tip{label='例'} + +``` +https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive +``` + +::: + +## Step 3 + +사용자가 애플리케이션 접근을 허용한 후 다음 형식의 URL에 POST 요청하면 응답으로 액세스 토큰이 포함된 JSON이 반환됩니다. + +``` +https://{host}/api/miauth/{session}/check +``` + +여기서, + +- HTTP API는 모두 POST이며, 요청/응답 모두 JSON 형식입니다(drive/files/create 제외). +- 요청 헤더에 `Content-Type: application/json`을 지정합니다. + +응답에 포함된 속성은 다음과 같습니다. + +| 이름 | 설명 | +| ------- | ----------- | +| `token` | 사용자 액세스 토큰. | +| `user` | 사용자 정보. | diff --git a/content/ko/docs/4.for-developers/api/token/3.oauth.md b/content/ko/docs/4.for-developers/api/token/3.oauth.md new file mode 100644 index 00000000..11f21376 --- /dev/null +++ b/content/ko/docs/4.for-developers/api/token/3.oauth.md @@ -0,0 +1,179 @@ +--- +description: v2023.9.0 이상에서 사용할 수 있는 OAuth2.0 방식의 인증 방법을 설명합니다. +--- + +# OAuth 방식의 액세스 토큰 획득 방식 + +애플리케이션을 이용하는 사용자(이하 단순히 '사용자'라 칭함)의 액세스 토큰을 발급받으려면 아래 절차에 따라 발급을 요청합니다. + +:::tip + +아래 설명할 방법은 [OAuth 2.0](https://datatracker.ietf.org/doc/html/rfc6749.html)이라는 방법입니다.일반 OAuth는 앱을 만들어야 하지만, [IndieAuth](https://indieauth.spec.indieweb.org/)의 확장으로 앱을 만들지 않고도 사용할 수 있도록 되어 있습니다. + +OAuth 방식은 사용할 수 있는 라이브러리가 많기 때문에 가능하면 라이브러리를 사용하는 것을 추천합니다. + +현재 이 방식을 사용하려면 웹페이지가 필요합니다.웹페이지를 준비할 수 없거나 Misskey 2023.9.0 이전 버전을 지원하고자 하는 경우, 아래의 방법을 사용하시기 바랍니다. + +- [Misskey 전용 MiAuth 방식으로 액세스 토큰을 얻는 방법](./oauth.md) +- [앱 생성 방식으로 액세스 토큰을 획득하는 방법(구식).](./app.md) + +::: + +## Step 1 + +앱 소개를 위한 웹페이지를 만듭니다.페이지가 HTTPS 주소로 접속할 수 있어야 합니다.페이지 어딘가에 아래와 같은 HTML 코드를 작성합니다. + +```html + + + + +
+ My Misskey App +
+``` + +나중에 `redirect_uri` 주소로 인증 코드가 전송됩니다. + +## Step 2 + +PKCE `code_verifier`와 `code_challenge` 문자열, 그리고 `state` 문자열을 생성합니다. + +- code_verifier`의 경우 최소 43자, 최대 128자로 알파벳 대/소문자 및 `-. _\~\` 안에 있는 문자로 제한됩니다. +- code_challenge`문자열은`code_verifier\` 문자열을 SHA256 알고리즘으로 해시하여 base64url로 인코딩한 결과를 사용합니다. +- `state` 문자열에는 특별한 제한이 없습니다. 임의의 문자열을 사용합니다. + +:::danger + +이 문자열은 매번 생성해야 하며, 반복해서 사용하지 마십시오. + +::: + +:::tip + +[pkce-challenge](https://www.npmjs.com/package/pkce-challenge)와 같은 라이브러리를 사용하거나 OAuth 라이브러리의 PKCE 기능을 사용하는 것을 추천합니다. + +::: + +:::tip{label='例'} + +```js +import crypto from "node:crypto"; + +const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-._~"; +const codeVerifier = new Array(128) + .fill(0) + .map(() => chars[Math.floor(chars.length * Math.random())]) + .join(""); +console.log('code_verifier', codeVerifier); + +const codeChallenge = crypto + .createHash("sha256") + .update(codeVerifier, "ascii") + .digest("base64url"); +console.log('code_challenge', codeChallenge); + +const state = crypto.randomUUID(); +console.log('state', state); +``` + +::: + +## Step 3 + +상대 서버의 OAuth 정보를 가져옵니다. 데이터는 JSON 형식으로 되어 있습니다. + +``` +https://{host}/.well-known/oauth-authorization-server +``` + +`{host}`부분은 사용자 서버의 호스트로 대체합니다.보통 호스트는 사용자가 입력합니다. + +여기서는 `authorization_endpoint`와 `token_endpoint`를 사용합니다. + +:::tip + +다음 단계에서 사용되는 `scope`에 대한 정보도 `scopes_supported`에서 확인할 수 있습니다. + +::: + +## Step 4 + +애플리케이션 인증 양식을 사용자의 브라우저에 표시합니다.인증 양식은 다음 형식의 URL로 열 수 있습니다. + +``` +{authorization_endpoint}?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&scope={scope}&code_challenge={code_challenge}&code_challenge_method=S256&state={state} +``` + +여기서, + +- `{authorization_endpoint}`부분은 이전 정보 획득에서 얻은 주소로 대체합니다. +- `{client_id}`부분은 앱 소개 페이지의 주소로 대체합니다. +- `{code_challenge}`부분은 앞서 생성한 `code_challenge` 문자열로 대체합니다. +- `code_challenge_method`부분은 항상 `S256`으로 합니다. +- `{redirect_uri}`부분은 소개 페이지에서 사용하고 있는 전송처 주소로 대체합니다. +- `{scope}`부분은 애플리케이션이 요청하는 권한으로 대체합니다.요청하는 권한을 \`\`로 구분하여 열거합니다.권한 목록은 [여기](../permission.md)에서 확인할 수 있습니다. +- `{state}`부분은 앞서 생성한 `state` 문자열로 대체합니다. + +:::tip{label='例'} + +``` +https://misskey.local/oauth/authorize?client_id=http%3A%2F%2Fexample.com&code_challenge=C6hwMO2bmIzg3nqppTE9b79fvuOjlrKmH2xNiZSMHzw&code_challenge_method=S256&response_type=code&redirect_uri=http%3A%2F%2Fexample.com%2Fredirect&scope=write%3Anotes&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +## Step 5 + +사용자가 애플리케이션 접근을 허용하면 `redirect_uri` 주소로 인증 코드가 URL 파라미터 형태로 전송됩니다. + +| 이름 | 설명 | +| ------- | ----------------------- | +| `code` | 사용자 인증 코드. | +| `state` | 인증 요청에 사용된 `state` 문자열. | + +:::tip{label='例'} + +``` +https://example.com/redirect?code=...&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +`state`문자열이 제대로 일치하는지 확인하고 다음 단계로 넘어갑니다. + +## Step 6 + +전송된 인증 코드를 사용하여 POST로 액세스 토큰을 요청합니다.요청 대상은 `token_endpoint`가 됩니다.데이터 형식은 `application/json`과 `application/x-wwww-form-urlencoded`를 사용할 수 있습니다.각 매개변수는 다음과 같습니다. + +| 이름 | 설명 | +| --------------- | ------------------------------- | +| `grant_type` | 항상 `authorization_code`로 설정합니다. | +| `client_id` | 인증 요청에 사용되는 `client_id` 문자열. | +| `redirect_uri` | 인증 요청에 사용된 `redirect_uri` 문자열. | +| `scope` | 인증 요청에 사용된 `scope` 문자열. | +| `code` | 획득한 인증 코드.　 | +| `code_verifier` | 앞서 생성한 `code_verifier` 문자열. | + +:::tip{label='例'} + +```js +const res = await fetch(endpoint, { + method: "POST", + body: JSON.stringify({ + grant_type: "authorization_code", + client_id: "https://example.com", + redirect_uri: "https://example.com/redirect", + scope: "write:notes", + code: "...", + code_verifier: "hjjbCYDmDpSLjirkO-PrfWKsRhDdJr-PAEGRClRwzUKlmFIIIrZNmSvUIraeIa~WqbqQnfbJV-Hc_IfuQkesBYUpukUi~lInDfU_AZjoZqbU.ioQTRzaFfZFfGnT-OAA", + }), + headers: { + "Content-Type": "application/json" + } +}); +``` + +::: + +응답은 JSON 객체 형태로, 거기서 `access_token`을 가져와서 사용합니다. diff --git a/content/ko/docs/5.releases.md b/content/ko/docs/5.releases.md index 53380333..b03eb3bb 100644 --- a/content/ko/docs/5.releases.md +++ b/content/ko/docs/5.releases.md @@ -6,14 +6,57 @@ maxTocDepth: 2 Misskey의 릴리즈 노트를 표시합니다. +## 2023.12.2 + +릴리즈 일시: 2023/12/28 + +### 일반 + +- v2023.12.1에서 Docker를 이용해 서버를 시작할 수 없는 문제 해결 + +### 클라이언트 + +- Enhance: 검색 화면에서 Enter키를 눌러서 검색할 수 있도록 + +## 2023.12.1 + +릴리스 날짜: 2023/12/27 + +### 안내 + +- 액세스 토큰의 권한이 재정비되어 일부 API가 이전 API 토큰으로는 작동하지 않습니다.\ + 권한이 부족할 경우 권한을 재설정하여 다시 생성해 주세요. + +### 일반 + +- Enhance: 현지화 갱신 +- Fix: 자신의 direct note가 user list timeline에 추가되지 않음 + +### 클라이언트 + +- Feat: AiScript 전용 MFM 구문 `$[clickable.ev=EVENTNAME ...]`를 추가.`Mk:C:mfm`의 옵션 `onClickEv`에 함수를 전달하면 클릭 시 `EVENTNAME`을 인수로 하여 호출 +- Enhance: MFM 입력 보조 버튼을 게시 양식에 표시할 수 있도록 개선 #12787 +- Fix: 일부 모델로그(logYellow로 표시되는 대상)에 대해 표시 색상이 변하지 않는 문제 수정 +- Fix: `fg`/`bg`MFM에 긴 단어를 지정하면 오버플로우가 되지 않고 튀어나오는 문제 수정 + +### 서버 + +- Enhance: 센서티브 워드 설정이 해시태그 트렌드에도 적용되었습니다. +- Enhance: `auth/token` 엔드포인트 CORS 지원 +- Fix: 1702718871541-ffVisibility.js가 손상되었습니다. +- Fix: '민감하지 않음(리모컨은 좋아요만)'으로 설정해도 민감하게 설정된 커스텀 이모티콘을 반응할 수 있는 문제 수정 +- Fix: 역할 지정 시 알림에서 역할 아이콘이 축소되지 않고 표시되는 문제 수정 +- Fix: 써드파티 애플리케이션이 Websocket API에 무조건적으로 접근할 수 있는 문제 해결 +- Fix: 써드파티 애플리케이션이 사용자의 허락 없이 비공개 정보를 볼 수 있는 문제 수정 + ## 2023.12.0 릴리즈 일시: 2023/12/23 -### 안내 +### Note - 의존성 업데이트에 따라, Node.js 최소 요구 버전이 20.10.0으로 변경되었습니다 -- 이전에 이모지 추가 사전을 설치하신 분은 아번 업데이트 이후 재설치가 필요합니다. +- 이전에 이모지 추가 사전을 설치하신 분은 이번 업데이트 이후 재설치가 필요합니다. - 이모지 선택기에 고정하는 이모지가 '리액션'과 '이모지 입력'으로 분할되었습니다.이전에 설정한 이모지는 '리액션'으로 분류됩니다. **영향**: @@ -83,240 +126,240 @@ Misskey의 릴리즈 노트를 표시합니다. - Fix: 이름이 긴 채널의 게시물 작성 창이 일그러지는 문제를 해결 - Fix: 보안 향상을 위해 AiScript의 `Mk:apiExternal`을 비활성화 - Fix: 노트의 이모지를 탭하여 '리액션하기' 했을 때에, 리액션 사운드가 재생되지 않는 문제를 해결 -- Fix: ノート中のリアクションの表示を微調整 #12650 -- Fix: AiScriptの`readline`が不正な値を返すことがある問題を修正 -- Fix: 投票のみ/画像のみの引用RNが、通知欄でただのRNとして判定されるバグを修正 -- Fix: CWをつけて引用RNしても、普通のRNとして扱われてしまうバグを修正しました。 -- Fix: 「画像が1枚のみのメディアリストの高さ」を「デフォルト」以外に設定していると、CWの中などに添付された画像が見られないバグを修正 -- Fix: DeepL TranslationのPro accountトグルスイッチが表示されていなかったのを修正 -- Fix: twitterの埋め込みカード内リンクからリンク先を開けない問題を修正 -- Fix: WebKitブラウザー上でも「デバイスの画面を常にオンにする」機能が効くように -- Fix: ページ一覧ページの表示がモバイル環境において崩れているのを修正 -- Fix: MFMでルビの中のテキストがnyaizeされない問題を修正 +- Fix: 노트 중 리액션 표시 미세 조정 #12650 +- Fix: AiScript의 `readline`이 잘못된 값을 반환할 수 있는 문제 수정 +- Fix: 투표/이미지만 존재하는 노트의 인용 리노트가 알림에서 일반 리노트로 표시되는 버그 수정 +- Fix: CW를 켜고 인용 리노트를 해도 일반 리노트로 취급되는 버그를 수정했습니다. +- Fix: 「이미지가 1장뿐인 미디어 리스트의 높이」를 「디폴트」이외로 설정하고 있으면, CW로 첨부된 이미지를 볼 수 없는 버그를 수정 +- Fix: DeepL Translation의 Pro account 토글 스위치가 표시되지 않은 것을 수정 +- Fix: twitter의 게시물 확장카드 내부에서 링크를 열 수 없는 문제 수정 +- Fix: WebKit 브라우저 상에서도 '디바이스 화면을 항상 켜는' 기능이 효과가 있도록 수정 +- Fix: Misskey페이지 목록의 표시가 모바일 환경에서 무너지는 것을 수정 +- Fix: MFM에서 루비 텍스트가 nyaize되지 않는 문제 수정 -### Server +### 서버 -- Enhance: MFM `$[ruby ]` が他ソフトウェアと連合されるように -- Enhance: Meilisearchを有効にした検索で、ユーザーのミュートやブロックを考慮するように -- Enhance: カスタム絵文字のインポート時の動作を改善 -- Fix: 時間経過により無効化されたアンテナを再有効化したとき、サーバ再起動までその状況が反映されないのを修正 #12303 -- Fix: ロールタイムラインが保存されない問題を修正 -- Fix: api.jsonの生成ロジックを改善 #12402 -- Fix: 招待コードが使い回せる問題を修正 -- Fix: 特定の条件下でチャンネルやユーザーのノート一覧に最新のノートが表示されなくなる問題を修正 -- Fix: 何もノートしていないユーザーのフィードにアクセスするとエラーになる問題を修正 -- Fix: リストタイムラインにてミュートが機能しないケースがある問題と、チャンネル投稿がストリーミングで流れてきてしまう問題を修正 #10443 -- Fix: 「みつける」のなかにミュートしたユーザが現れてしまう問題を修正 #12383 -- Fix: Social/Local/Home Timelineにてインスタンスミュートが効かない問題 -- Fix: ユーザのノート一覧にてインスタンスミュートが効かない問題 -- Fix: チャンネルのノート一覧にてインスタンスミュートが効かない問題 -- Fix: 「みつける」が年越し時に壊れる問題を修正 -- Fix: アカウントをブロックした際に、自身のユーザーのページでノートが相手に表示される問題を修正 -- Fix: モデレーションログがモデレーターは閲覧できないように修正 -- Fix: ハッシュタグのトレンド除外設定が即時に効果を持つように修正 -- Fix: HTTP Digestヘッダのアルゴリズム部分に大文字の"SHA-256"しか使えない -- Fix: 管理者用APIのアクセス権限が適切に設定されていない問題を修正 +- Enhance: MFM `$[ruby ]`가 다른 소프트웨어와 연합할 수 있도록 +- Enhance: Meilisearch를 활성화한 검색에서 사용자의 음소거 및 차단을 고려하도록 +- Enhance: 커스텀 이모티콘을 가져올 때 동작 개선 +- Fix: 시간 경과로 인해 비활성화된 안테나를 다시 활성화했을 때, 서버 재부팅 전까지 해당 상황이 반영되지 않는 문제 수정 #12303 +- Fix: 역할 타임라인이 저장되지 않는 문제 수정 +- Fix: api.json의 생성 로직 개선 #12402 +- 수정: 초대 코드가 중복되는 문제 해결 +- Fix: 특정 조건에서 채널 및 사용자 노트 목록에 최신 노트가 표시되지 않는 문제를 수정 +- Fix: 아무것도 기록하지 않은 사용자의 피드에 접속하면 오류가 발생하는 문제 수정 +- Fix: 리스트 타임라인에서 음소거가 작동하지 않는 경우와 채널 게시물이 스트리밍으로 흘러나오는 문제 수정 #10443 +- Fix: '찾기' 중 뮤트된 사용자가 나타나는 문제 수정 #12383 +- Fix: 소셜/로컬/홈 타임라인에서 인스턴스 뮤트가 작동하지 않는 문제 해결 +- Fix: 사용자 노트 목록에서 인스턴스 뮤트가 작동하지 않는 문제 수정 +- Fix: 채널 노트 목록에서 인스턴스 뮤트가 작동하지 않는 문제 수정 +- Fix: 연말연시에 '찾기'가 깨지는 문제 수정 +- Fix: 계정을 차단했을 때 자신의 사용자 페이지에서 상대방에게 노트가 표시되는 문제 수정 +- Fix: 모더레이터가 모더레이터 로그를 열람하지 못하도록 수정 +- Fix: 해시태그 트렌드 제외 설정이 즉각적인 효과를 발휘하도록 수정 +- Fix: HTTP 다이제스트 헤더의 알고리즘 부분에 대문자 "SHA-256"만 사용할 수 있습니다. +- Fix: 관리자용 API의 접근 권한이 제대로 설정되지 않는 문제 수정 ## 2023.11.1 -リリース日: 2023/11/17 +릴리스 날짜: 2023/11/17 ### Note -- 悪意のある第三者がリモートユーザーになりすました任意のアクティビティを受け取れてしまう問題を修正しました。詳しくは[GitHub security advisory](https://github.com/misskey-dev/misskey/security/advisories/GHSA-3f39-6537-3cgc)をご覧ください。 +- 악의적인 제3자가 원격 사용자를 사칭하여 임의의 활동을 수신할 수 있는 문제를 수정했습니다.자세한 내용은 [GitHub security advisory](https://github.com/misskey-dev/misskey/security/advisories/GHSA-3f39-6537-3cgc)에서 확인할 수 있습니다. -### General +### 일반 -- Feat: 管理者がコントロールパネルからメールアドレスの照会を行えるようになりました -- Enhance: ローカリゼーションの更新 -- Enhance: 依存関係の更新 +- Feat: 관리자가 제어판에서 이메일 주소를 조회할 수 있게 되었습니다. +- Enhance: 현지화 갱신 +- Enhance: 종속성 업데이트 -### Client +### 클라이언트 -- Enhance: MFMでルビを振れるように - - 例: `$[ruby 三須木 みすき]` -- Enhance: MFMでUNIX時間を指定して日時を表示できるように - - 例: `$[unixtime 1701356400]` -- Enhance: プラグインでエラーが発生した場合のハンドリングを強化 -- Enhance: 細かなUIのブラッシュアップ -- Fix: 効果音が再生されるとデバイスで再生している動画や音声が停止する問題を修正 #12339 -- Fix: デッキに表示されたチャンネルの表示先チャンネルを切り替えた際、即座に反映されない問題を修正 #12236 -- Fix: プラグインでノートの表示を書き換えられない問題を修正 -- Fix: アイコンデコレーションが見切れる場合がある問題を修正 -- Fix: 「フォロー中の人全員の返信を含める/含めないようにする」のボタンを押下した際の確認が機能していない問題を修正 -- Fix: 非ログイン時に「メモを追加」を表示しないように変更 #12309 -- Fix: 絵文字ピッカーでの検索が更新されない問題を修正 -- Fix: 特定の条件下でノートがnyaizeされない問題を修正 +- Enhance: MFM에서 루비를 흔들 수 있도록 + - 예: `$[ruby 三須木 미스키]` +- Enhance: MFM에서 UNIX 시간을 지정하여 날짜 및 시간 표시 가능 + - 예: `$[unixtime 1701356400]` +- Enhance: 플러그인에서 오류 발생 시 처리 강화 +- Enhance: 세세한 UI 개선 +- Fix: 효과음이 재생될 때 기기에서 재생 중인 동영상이나 음성이 멈추는 문제 수정 #12339 +- Fix: 덱에 표시된 채널의 표시 대상 채널을 전환할 때 즉시 반영되지 않는 문제 수정 #12236 +- Fix: 플러그인에서 노트 표시를 다시 작성할 수 없는 문제 수정 +- Fix: 아이콘 장식이 보이지 않는 문제 수정 +- Fix: '팔로우 중인 모든 사람의 답장 포함/비포함' 버튼을 눌렀을 때 확인이 작동하지 않는 문제 수정 +- Fix: 비로그인 시 '메모 추가'를 표시하지 않도록 변경 #12309 +- Fix: 이모티콘 피커에서 검색이 업데이트되지 않는 문제 수정 +- Fix: 특정 조건에서 노트가 nyaize되지 않는 문제 수정 -### Server +### 서버 -- Enhance: FTTのデータベースへのフォールバック処理を行うかどうかを設定可能に -- Fix: トークンのないプラグインをアンインストールするときにエラーが出ないように -- Fix: 投稿通知がオンでもダイレクト投稿はユーザーに通知されないようにされました -- Fix: ユーザタイムラインの「ノート」選択時にリノートが混ざり込んでしまうことがある問題の修正 #12306 -- Fix: LTLに特定条件下にてチャンネルへの投稿が混ざり込む現象を修正 -- Fix: ActivityPub: 追加情報のカスタム絵文字がユーザー情報のtagに含まれない問題を修正 -- Fix: ActivityPubに関するセキュリティの向上 -- Fix: 非公開の投稿に対して返信できないように +- Enhance: FTT의 데이터베이스에 대한 폴백 처리 여부를 설정할 수 있습니다. +- Fix: 토큰이 없는 플러그인을 제거할 때 오류가 발생하지 않도록 수정 +- Fix: 게시 알림이 켜져 있어도 직접 게시가 사용자에게 알림을 보내지 않도록 수정되었습니다. +- Fix: 사용자 타임라인에서 '노트' 선택 시 리노트가 섞여있는 문제 수정 #12306 +- Fix: LTL에서 특정 조건에서 채널에 게시물이 혼재되는 현상 수정 +- Fix: ActivityPub: 사용자 정보 태그에 사용자 지정 이모티콘이 추가 정보 태그에 포함되지 않는 문제 수정 +- 수정: ActivityPub 관련 보안 개선 +- 수정: 비공개 게시물에 대한 답글을 달지 못하도록 수정 ## 2023.11.0 -リリース日: 2023/11/05 +릴리스 날짜: 2023/11/05 ### Note -- iOS 16.4未満を使用している場合はiOS 16.4以上にアップデートをお願いします +- iOS 16.4 미만을 사용하는 경우 iOS 16.4 이상으로 업데이트하십시오. -### General +### 일반 -- Feat: アイコンデコレーション機能 - - サーバーで用意された画像をアイコンに重ねることができます - - 画像のテンプレートはこちらです: https\://misskey-hub.net/brand-assets/#avatar-decoration - - 最大でも黄色いエリア内にデコレーションを収めることを推奨します。 - - 画像は512x512pxを推奨します。 -- Feat: チャンネル設定にリノート／引用リノートの可否を設定できる項目を追加 -- Enhance: アカウント登録時のメールアドレス認証に30分の有効期限を設定 - - 有効期限が切れた後であれば、登録時に使用した招待コードを再度利用できるように変更しました。 - - ユーザーが誤ったメールアドレスを入力した場合に招待コードが失効してしまう問題が解消されます。 -- Enhance: すでにフォローしたすべての人の返信をTLに追加できるように -- Enhance: 未読の通知数を表示できるように -- Enhance: 通知されず、確認の必要もないお知らせ(silence)を作成可能になりました -- Enhance: ローカリゼーションの更新 -- Enhance: 依存関係の更新 -- Change: CWを使用する場合、注釈を空にすることは許可されなくなりました +- Feat: 아이콘 꾸미기 기능 + - 서버에서 준비된 이미지를 아이콘에 중첩할 수 있습니다. + - 이미지 템플릿은 여기: https\://misskey-hub.net/brand-assets/#avatar-decoration + - 최대로 노란색 영역 안에 장식을 넣는 것이 좋습니다. + - 이미지 크기는 512x512px를 권장합니다. +- Feat: 채널 설정에 리노트/인용 리노트 허용 여부를 설정할 수 있는 항목이 추가되었습니다. +- Enhance: 계정 등록 시 이메일 주소 인증에 30분 유효기간을 설정합니다. + - 유효기간이 만료된 후에는 등록 시 사용한 초대 코드를 다시 사용할 수 있도록 변경했습니다. + - 사용자가 잘못된 이메일 주소를 입력할 경우 초대 코드가 만료되는 문제가 해결됩니다. +- Enhance: 이미 팔로우한 모든 사람의 답글을 TL에 추가할 수 있도록 +- Enhance: 읽지 않은 알림의 수를 표시할 수 있도록 +- Enhance: 알림이 없고 확인이 필요 없는 알림(silence)을 생성할 수 있습니다. +- Enhance: 현지화 업데이트 +- Enhance: 종속성 업데이트 +- Change: CW를 사용할 때 주석을 비우는 것이 더 이상 허용되지 않습니다. -### Client +### 클라이언트 -- Feat: プラグイン・テーマを外部サイトから直接インストールできるようになりました - - 外部サイトでの実装が必要です。詳細は Misskey Hub をご覧ください +- Feat: 플러그인 테마를 외부 사이트에서 직접 설치할 수 있게 되었습니다. + - 외부 사이트에서 구현이 필요합니다.자세한 내용은 Misskey Hub에서 확인할 수 있습니다. https\://misskey-hub.net/docs/advanced/publish-on-your-website.html -- Feat: 通知をグルーピングして表示するオプション(オプトアウト) -- Feat: Misskeyの基本的なチュートリアルを実装 -- Feat: スワイプしてタイムラインを再読込できるように - - PCの場合は右上のボタンからでも再読込できます -- Enhance: タイムラインの自動更新を無効にできるように -- Enhance: コードのシンタックスハイライトエンジンをShikiに変更 - - AiScriptのシンタックスハイライトに対応 - - MFMでAiScriptをハイライトする場合、コードブロックの開始部分を ` ```is ` もしくは ` ```aiscript ` としてください -- Enhance: データセーバー有効時はアニメーション付きのアバター画像が停止するように -- Enhance: プラグインを削除した際には、使用されていたアクセストークンも同時に削除されるようになりました -- Enhance: プラグインで`Plugin:register_note_view_interruptor`を用いてnoteの代わりにnullを返却することでノートを非表示にできるようになりました -- Enhance: AiScript関数`Mk:nyaize()`が追加されました -- Enhance: 情報→ツール はナビゲーションバーにツールとして独立した項目になりました -- Enhance: ノート内の絵文字をクリックすることで、コピーおよびリアクションができるように -- Enhance: その他細かなブラッシュアップ -- Fix: 投稿フォームでのユーザー変更がプレビューに反映されない問題を修正 -- Fix: ユーザーページの ノート > ファイル付き タブにリプライが表示されてしまう -- Fix: 「検索」MFMにおいて一部の検索キーワードが正しく認識されない問題を修正 -- Fix: 一部の言語でMisskey Webがクラッシュする問題を修正 -- Fix: チャンネルの作成・更新時に失敗した場合何も表示されない問題を修正 #11983 -- Fix: 個人カードのemojiがバッテリーになっている問題を修正 -- Fix: 標準テーマと同じIDを使用してインストールできてしまう問題を修正 -- Fix: 絵文字ピッカーでバッテリーの絵文字が複数表示される問題を修正 #12197 -- Fix: 11以上されているリアクションにおいてツールチップで示されるリアクション数が本来よりも1多い問題を修正 #12174 -- Fix: サイレンス状態で公開範囲のパブリックを選択できてしまう問題を修正 #12224 -- Fix: In deck layout, replies option is not saved after refresh -- Fix: アーカイブしたお知らせがコントロールパネルに表示される問題を修正 -- Note: アップデート後、サウンドに関する設定が初期化されます +- Feat: 알림을 그룹화하여 표시하는 옵션(선택 사항) +- Feat: Misskey의 기본적인 튜토리얼 구현 +- Feat: 스와이프해서 타임라인을 다시 불러올 수 있도록 + - PC의 경우 오른쪽 상단의 버튼을 통해서도 다시 불러올 수 있습니다. +- Enhance: 타임라인의 자동 업데이트를 비활성화할 수 있습니다. +- Enhance: 코드의 구문 강조 엔진을 Shiki로 변경 + - AiScript의 구문 강조 표시 지원 + - MFM에서 AiScript를 강조 표시하는 경우, 코드 블록의 시작 부분을 ` ```is` 또는 ` ```aiscript`로 지정해 주십시오. +- Enhance: 데이터 세이버 활성화 시 애니메이션이 적용된 아바타 이미지가 정지되도록 +- Enhance: 플러그인 삭제 시 사용하던 액세스 토큰도 동시에 삭제되도록 개선되었습니다. +- Enhance: 플러그인에서 `Plugin:register_note_view_interruptor`를 사용하여 note 대신 null을 반환하여 메모를 숨길 수 있게 되었습니다. +- Enhance: AiScript 함수 `Mk:nyaize()`가 추가되었습니다. +- Enhance: 정보 → 도구가 탐색 모음에 도구로 독립된 항목이 되었습니다. +- Enhance: 노트 내 이모티콘을 클릭하여 복사 및 리액션을 할 수 있도록 +- Enhance: 기타 세세한 부분까지 다듬기 +- Fix: 게시글 양식에서 사용자 변경사항이 미리보기에 반영되지 않는 문제 수정 +- 수정: 사용자 페이지의 노트 > 파일 포함 탭에 답글이 표시되는 문제 해결 +- Fix: '검색' MFM에서 일부 검색 키워드가 제대로 인식되지 않는 문제 수정 +- Fix: 일부 언어에서 Misskey Web이 충돌하는 문제 해결 +- Fix: 채널 생성/갱신 실패 시 아무것도 표시되지 않는 문제 수정 #11983 +- Fix: 개인 카드의 emoji가 배터리로 표시되는 문제 수정 +- Fix: 표준 테마와 동일한 ID를 사용하여 설치되는 문제 수정 +- Fix: 이모티콘 선택기에서 배터리 이모티콘이 여러 개 표시되는 문제 수정 #12197 +- Fix: 11개 이상의 리액션에서 툴팁에 표시되는 리액션 수가 원래보다 1개 더 많은 문제 수정 #12174 +- Fix: 뮤트 상태에서 공개 범위의 퍼블릭을 선택할 수 있는 문제 수정 #12224 +- Fix: 덱 레이아웃에서 새로고침 후 답글 옵션이 저장되지 않음 +- Fix: 보관한 공지사항이 제어판에 표시되는 문제 수정 +- Note: 업데이트 후 사운드 관련 설정이 초기화됩니다. -### Server +### 서버 -- Feat: Registry APIがサードパーティから利用可能になりました -- Enhance: RedisへのTLのキャッシュ(FTT)をオフにできるように -- Enhance: フォローしているチャンネルをフォロー解除した時（またはその逆）、タイムラインに反映される間隔を改善 -- Enhance: プロフィールの自己紹介欄のMFMが連合するようになりました - - 相手がMisskey v2023.11.0以降である必要があります -- Enhance: チャンネル取得時のパフォーマンスを向上 -- Enhance: AP: ApplicationタイプのアカウントをisBotとして扱うように -- Fix: リストTLに自分のフォロワー限定投稿が含まれない問題を修正 -- Fix: ローカルタイムラインに投稿者自身の投稿への返信が含まれない問題を修正 -- Fix: 自分のフォローしているユーザーの自分のフォローしていないユーザーの visibility: followers な投稿への返信がストリーミングで流れてくる問題を修正 -- Fix: RedisへのTLキャッシュが有効の場合にHTL/LTL/STLが空になることがある問題を修正 -- Fix: STLでフォローしていないチャンネルが取得される問題を修正 -- Fix: `hashtags/trend`にてRedisからトレンドの情報が取得できない際にInternal Server Errorになる問題を修正 -- Fix: HTLをリロードまたは遡行したとき、フォローしているチャンネルのノートが含まれない問題を修正 #11765 #12181 -- Fix: リノートをリノートできるのを修正 -- Fix: アクセストークンを削除すると、通知が取得できなくなる場合がある問題を修正 -- Fix: 自身の宛先なしダイレクト投稿がストリーミングで流れてこない問題を修正 -- Fix: サーバーサイドからのテスト通知を正しく行えるように修正 -- Fix: GTLの「リノートを表示」オプションが機能しないのを修正 #1223 +- Feat: 이제 서드파티에서 Registry API를 사용할 수 있습니다. +- Enhance: Redis에 TL의 캐시(FTT)를 끌 수 있도록 개선 +- Enhance: 팔로우하고 있는 채널을 팔로우 해제했을 때 (또는 그 반대로) 타임라인에 반영되는 간격 개선 +- Enhance: 프로필의 자기소개란의 MFM이 연합을 이루게 되었습니다. + - 상대방이 Misskey v2023.11.0 이상이어야 합니다. +- Enhance: 채널 획득 시 성능 향상 +- Enhance: AP: Application 타입의 계정을 isBot으로 취급하도록 +- Fix: 리스트 TL에 자신의 팔로워 한정 게시물이 포함되지 않는 문제 수정 +- Fix: 로컬 타임라인에 게시자 자신의 게시글에 대한 답글이 포함되지 않는 문제 수정 +- Fix: 내가 팔로잉하는 사용자의 팔로잉하지 않은 사용자의 visibility: followers 게시물에 대한 답글이 스트리밍으로 흘러나오는 문제 수정 +- Fix: Redis에 TL 캐싱이 활성화된 경우 HTL/LTL/STL이 비어있는 문제 수정 +- Fix: STL에서 팔로우하지 않는 채널이 검색되는 문제 수정 +- Fix: `hashtags/trend`에서 Redis에서 트렌드 정보를 가져올 수 없을 때 Internal Server Error로 표시되는 문제 수정 +- Fix: HTL을 다시 로드하거나 소급할 때 팔로우 중인 채널의 노트가 포함되지 않는 문제 수정 #11765 #12181 +- Fix: 리노트를 다시 작성할 수 있는 문제 수정 +- Fix: 액세스 토큰을 삭제하면 알림을 받을 수 없는 문제 해결 +- Fix: 자신의 목적지 없는 직접 게시물이 스트리밍으로 전송되지 않는 문제 수정 +- Fix: 서버 측에서 테스트 알림을 올바르게 수행할 수 있도록 수정 +- Fix: GTL의 '리노트 보기' 옵션이 작동하지 않는 문제 수정 #1223 ## 2023.10.2 -リリース日: 2023/10/21 +릴리스 날짜: 2023/10/21 -### General +### 일반 -- Feat: アンテナでローカルの投稿のみ収集できるようになりました -- Feat: サーバーサイレンス機能が追加されました -- Enhance: 新規にフォローした人の返信をデフォルトでTLに追加できるオプションを追加 -- Enhance: HTL/LTL/STLを2023.10.0アップデート以前まで遡れるように -- Enhance: フォロー/フォロー解除したときに過去分のHTLにも含まれる投稿が反映されるように -- Enhance: ローカリゼーションの更新 -- Enhance: 依存関係の更新 +- Feat: 안테나 타임라인에서 로컬 노트만 수집하는 기능이 추가 되었습니다. +- Feat: 서버 사일런스 기능이 추가 되었습니다. +- Enhance: 새로 팔로우한 사람이 멘션한 노트를 기본적으로 TL에도 추가할 수 있는 옵션을 추가 +- Enhance: HTL/LTL/STL을 2023.10.0 업데이트 이전의 내용까지 되짚어 볼 수 있음 +- Enhance: 팔로우/팔로우 해제 했을 때 과거의 HTL에도 포함되는 노트가 반영 될 수 있도록 함 +- Enhance: 현지화 업데이트 +- Enhance: 종속성 업데이트 -### Client +### 클라이언트 -- Enhance: TLの返信表示オプションを記憶するように -- Enhance: 投稿されてから時間が経過しているノートであることを視覚的に分かりやすく +- Enhance: TL 멘션 표시 옵션을 기억할 수 있도록 함 +- Enhance: 시간이 오래 지난 노트를 시각적으로 알기 쉽도록 함 -### Server +### 서버 -- Enhance: タイムライン取得時のパフォーマンスを向上 -- Enhance: ストリーミングAPIのパフォーマンスを向上 -- Fix: users/notesでDBから参照した際にチャンネル投稿のみ取得される問題を修正 -- Fix: コントロールパネルの設定項目が正しく保存できない問題を修正 -- Fix: 管理者権限のロールを持っていても一部のAPIが使用できないことがある問題を修正 -- Change: ユーザーのisCatがtrueでも、サーバーではnyaizeが行われなくなりました - - isCatな場合、クライアントでnyaize処理を行うことを推奨します +- Enhance: 타임라인 로딩 시의 퍼포먼스를 향상 +- Enhance: 스트리밍 API 퍼포먼스를 향상 +- Fix: users/notes에서 DB를 참조 했을 때 채널에 있는 노트만 불러와지는 문제를 수정 +- Fix: 제어판 설정 항목이 정상적으로 저장되지 않는 문제를 수정 +- Fix: 관리자 권한 롤을 가지고 있어도 일부 API를 사용할 수 없었던 문제를 수정 +- Change: 유저의 isCat 설정이 true여도, 서버에서는 nyaize를 하지 않도록 바뀌었습니다 + - isCat인 경우, 클라이언트 측에서 nyaize 처리를 하게 하는 것을 권장 합니다. ## 2023.10.1 -リリース日: 2023/10/12 +릴리스 날짜: 2023/10/12 -### General +### 일반 -- Enhance: ローカルタイムライン、ソーシャルタイムラインで返信を含むかどうか設定可能に +- Enhance: 로컬 타임라인, 소셜 타임라인에서 멘션을 할지 안할지 설정할 수 있도록 함 -### Client +### 클라이언트 -- Fix: 絵文字ピッカーで横に長いカスタム絵文字が見切れる問題を修正 +- Fix: 이모지 선택기에서 옆으로 길은 커스텀 이모지가 잘려 보이는 문제를 수정 -### Server +### 서버 -- Fix: フォローしているユーザーからの自分の投稿への返信がタイムラインに含まれない問題を修正 -- Fix: users/notesでセンシティブチャンネルの投稿が含まれる場合がある問題を修正 +- Fix: 본인의 노트에 팔로우 유저로부터 멘션을 해도 타임라인에서 보이지 않는 문제를 수정 +- Fix: users/notes에서 열람 주의 채널에 올라온 노트가 포함되는 문제를 수정 ## 2023.10.0 -リリース日: 2023/10/10 +릴리스 날짜: 2023/10/10 ### NOTE -- 2023.9.2で導入されたノート編集機能はクオリティの高い実装が困難であることが判明したため撤回されました -- アップデートを行うと、タイムラインが一時的にリセットされます +- 2023.9.2에서 추가된 노트 편집 기능은 정상적인 구현을 할 수 없었으므로 취소합니다. +- 업데이트를 실행하면, 타임라인이 일시적으로 초기화 됩니다. -### Changes +### 변경 -- API: users/notes, notes/local-timeline で fileType 指定はできなくなりました -- API: notes/featured でページネーションは他APIと同様 untilId を使って行うようになりました +- API: 더 이상 users/notes, notes/local-timeline에서 fileType 지정을 할 수 없습니다. +- API: 앞으로 notes/featured에서 페이지네이션은 다른 API와 같이 untilId로 처리합니다. -### General +### 일반 -- Feat: ユーザーごとに他ユーザーへの返信をタイムラインに含めるか設定可能になりました -- Feat: ユーザーリスト内のメンバーごとに他ユーザーへの返信をユーザーリストタイムラインに含めるか設定可能になりました -- Feat: ユーザーごとのハイライト -- Feat: プライバシーポリシー・運営者情報（Impressum）の指定が可能になりました - - プライバシーポリシーはサーバー登録時に同意確認が入ります -- Feat: タイムラインがリアルタイム更新中に広告を挿入できるようになりました - - デフォルトは無効 - - 頻度はコントロールパネルから設定できます。運営中のサーバーのTLの流速を見て、最適な値を指定してください。 -- Enhance: ソフトワードミュートとハードワードミュートは統合されました -- Enhance: モデレーションログ機能の強化 -- Enhance: ローカリゼーションの更新 -- Enhance: 依存関係の更新 -- Fix: ダイレクト投稿をリノートできてしまう問題を修正 -- Fix: ユーザーリストTLにチャンネル投稿が含まれる問題を修正 +- Feat: 다른 유저에 멘션한 노트를 타임라인에 표시할지 말지의 설정을 각 유저마다 설정할 수 있습니다. +- Feat: 유저 리스트 안에 있는 멤버가 다른 유저에게 보낸 노트를 유저 리스트 타임라인에 보이게 하는지의 여부를 각 유저마다 설정할 수 있습니다. +- Feat: 유저마다 하이라이트 하기 +- Feat: 정보 보호 정책, 운영자 정보 (Impressum) 지정을 할 수 있습니다. + - 정보 보호 정책은 서버에 회원 가입할 때 동의하도록 설정할 수 있습니다. +- Feat: 타임라인 안에 실시간 업데이트 중에도 광고를 넣을 수 있게 되었습니다. + - 기본 설정은 OFF + - 표시 빈도는 제어판에서 바꿀 수 있습니다.운영하고 있는 서버의 TL이 어느 정도 속도로 지나가는지 확인하고, 여기에 맞춰서 설정하세요. +- Enhance: 하드 단어 뮤트는 소프트 단어 뮤트에 통합 되었습니다. +- Enhance: 모더레이션 로그 기능을 강화 함 +- Enhance: 현지화 업데이트 +- Enhance: 종속성 업데이트 +- Fix: 다이렉트 노트인데도 리노트 되는 문제를 수정 +- Fix: 유저 리스트 TL에 채널에서만 볼 수 있는 노트도 같이 표시되는 문제를 수정 ### Client @@ -1446,7 +1489,7 @@ Meilisearchの設定に`index`が必要になりました。値はMisskeyサー ### Notable features -- ロール機能 +- 역할 기능 - 従来より柔軟にユーザーのポリシーを管理できます。例えば、「インスタンスのパトロンはアンテナを30個まで作れる」「基本的にLTLは見れないが、許可した人だけ見れる」「招待制インスタンスだけどユーザーなら誰でも他者を招待できる」のような運用はもちろん、「ローカルユーザーかつアカウント作成から1日未満のユーザーはパブリックな投稿を行えない」のように複数条件を組み合わせて、自動でロールを付与する設定も可能です。 - Misskey Play - 従来の動的なPagesに代わる、新しいプラットフォームです。動的なコンテンツ(アプリケーション)に特化していて、Pagesに比べてはるかに柔軟なアプリケーションを作成可能です。 @@ -1957,7 +2000,9 @@ same as 12.112.0 ### NOTE :::warning + このバージョンからNode v16.14.0以降が必要です + ::: ### Changes @@ -2069,12 +2114,16 @@ same as 12.112.0 ### Note :::warning + ビルドする前に`npm run clean`を実行してください。 + ::: :::warning + このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 + ::: ### Improvements @@ -2145,6 +2194,7 @@ same as 12.112.0 アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。 12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。 + ::: ### Changes @@ -2598,17 +2648,17 @@ same as 12.112.0 ## 12.86.0 -リリース日: 2021/08/11 +릴리스 날짜: 2021/08/11 ### Improvements -- ドキュメントの更新 - - ドキュメントにchangelogを追加 -- ぼかし効果のオプションを追加 -- Vueを3.2.1に更新 -- UIの調整 +- 문서 업데이트 + - 문서에 changelog 추가 +- 흐림 효과 옵션 추가 +- Vue 3.2.1로 업데이트 +- UI 조정 ### Bugfixes -- ハッシュタグ入力が空のときに#が付くのを修正 -- フォローリクエストのEメール通知を修正 +- 해시태그 입력이 비어있을 때 #이 붙는 현상 수정 +- 팔로우 요청 이메일 알림 수정 diff --git a/content/ns.md b/content/ns.md index e0dff9c9..092147cd 100644 --- a/content/ns.md +++ b/content/ns.md @@ -12,8 +12,10 @@ The prefix `misskey` is used to refer to `https://misskey-hub-net/ns#`. - canonical IRI: `https://misskey-hub.net/ns#_misskey_content` :::warning + This value is deprecated and might be removed in the future. See also . + ::: This value is identical to having a `source` property like this: @@ -40,7 +42,9 @@ Used on actors to display their summary as MFM. The content is same as `summary` - canonical IRI: `https://misskey-hub.net/ns#_misskey_quote` :::tip + Ways to potentially provide this information using the core ActivityPub vocabulary are currently underway, see . + ::: Indicates that this note is quoting another note. It contains the `id` of the note being quoted. diff --git a/content/pl/docs/1.about-misskey.md b/content/pl/docs/1.about-misskey.md index a67dba09..78d3b431 100644 --- a/content/pl/docs/1.about-misskey.md +++ b/content/pl/docs/1.about-misskey.md @@ -15,7 +15,9 @@ Misskeyはオープンソースの分散型マイクロブログプラットフ 当初は分散型ではありませんでしたが、2018年にActivityPubを実装し分散型になったことで、より多くの方に認知され利用されるサービスになり、現在に至ります。 :::tip + Misskeyという名前は、syuiloが当時聴いていたMay'nというアーティストの楽曲、Brain Diverの歌詞に由来します。 + ::: 誰でも開発に参加することができ、現在でも活発に開発が続いています。 @@ -35,7 +37,9 @@ Misskeyのすべてのソースコードは[AGPL](https://github.com/misskey-dev 再び引き合いに出しますが、TwitterやFacebookなどの利益を得ているほとんどのサービスはオープンソースではありません。 :::tip + 技術的に言うと、MisskeyのソースコードはGitで管理されていて、リポジトリは[GitHub上でホスティングされています。](https://github.com/misskey-dev) + ::: ## 開発に参加する、プロジェクトを支援する @@ -143,8 +147,11 @@ Misskeyは開発が進むにつれ使用する技術も大きく変わってき :::fukidashi{chara="doya_ai" charaName="藍"} わたしについては[このホームページ](https://xn--931a.moe/)をご覧ください！ + ::: :::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"} + Misskeyの守り神、藍ちゃんです。ｱｲﾁｬﾝｶﾜｲｲﾔｯﾀｰ! + ::: diff --git a/content/pl/docs/2.for-users/2.onboarding/2.get-started.md b/content/pl/docs/2.for-users/2.onboarding/2.get-started.md index aa4d1522..69e63d26 100644 --- a/content/pl/docs/2.for-users/2.onboarding/2.get-started.md +++ b/content/pl/docs/2.for-users/2.onboarding/2.get-started.md @@ -11,14 +11,17 @@ Misskeyを利用するには、どこかのサーバーにアカウントを作 [サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。 :::tip + どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 :::g-details{summary='詳細'} + Misskeyには連合機能が備わっています。 連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。 Misskeyが搭載している連合機能はActivityPubというオープンな共通規格に基づいていて、MastodonやPleromaといったほかのソフトウェアとも互換性があります。 + ::: ::: @@ -31,5 +34,7 @@ Misskeyが搭載している連合機能はActivityPubというオープンな 自分にあったテーマのサーバーを探すのもおすすめです。 :::tip + サーバーの一覧は[こちら](/servers/)からご覧いただけます。 + ::: diff --git a/content/pl/docs/2.for-users/2.onboarding/3.join-server.md b/content/pl/docs/2.for-users/2.onboarding/3.join-server.md index 6f42c0c1..7c26053a 100644 --- a/content/pl/docs/2.for-users/2.onboarding/3.join-server.md +++ b/content/pl/docs/2.for-users/2.onboarding/3.join-server.md @@ -3,9 +3,11 @@ 登録するサーバーが決まったら、さっそくアカウントを作成しましょう。 :::tip + ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 ただし、入力事項はサーバーによって異なることがあります。詳しくは、サーバー管理者にお問い合わせください。 + ::: ## 登録する diff --git a/content/pl/docs/2.for-users/2.onboarding/4.things-to-know.md b/content/pl/docs/2.for-users/2.onboarding/4.things-to-know.md index e77c9aa2..d5428ffb 100644 --- a/content/pl/docs/2.for-users/2.onboarding/4.things-to-know.md +++ b/content/pl/docs/2.for-users/2.onboarding/4.things-to-know.md @@ -7,7 +7,9 @@ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一般的なSNSに比べたくさんの機能がありますので、初めての投稿を行う前に必ず確認して、上手に投稿しましょう！ :::tip + 詳細は、「[ノート](/docs/for-users/features/note/)」をご覧ください。 + ::: ## タイムライン @@ -15,7 +17,9 @@ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一 Misskeyは、複数のタイムラインを持っています。名前だけでは少々わかりにくいかと思いますので、それぞれがどのような働きをするのかを知っておきましょう。 :::tip + 詳細は、「[タイムライン](/docs/for-users/features/timeline/)」をご覧ください。 + ::: ## その他 diff --git a/content/pl/docs/2.for-users/3.features/ads.md b/content/pl/docs/2.for-users/3.features/ads.md index 456c5790..72aa40ec 100644 --- a/content/pl/docs/2.for-users/3.features/ads.md +++ b/content/pl/docs/2.for-users/3.features/ads.md @@ -4,7 +4,9 @@ Misskeyではサーバーによる広告をタイムラインなどに表示で 広告の右上に表示されるアイコンをクリックすることで、当該の広告の表示頻度を下げることができます。 :::tip + 広告の総数が少ない場合は、表示頻度を下げた後も連続で表示される可能性があります。 + ::: ## 広告の設定(管理者) diff --git a/content/pl/docs/2.for-users/3.features/drive.md b/content/pl/docs/2.for-users/3.features/drive.md index 3fc879de..81f0417d 100644 --- a/content/pl/docs/2.for-users/3.features/drive.md +++ b/content/pl/docs/2.for-users/3.features/drive.md @@ -3,7 +3,9 @@ ドライブは、Misskey上でファイルを管理できる機能です。 :::tip + 技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。 + ::: Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。 @@ -13,7 +15,9 @@ Misskey Webのドライブページから任意のファイルをアップロー ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。 :::warning + 現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。 + ::: ## センシティブ (NSFW) diff --git a/content/pl/docs/2.for-users/3.features/mfm.md b/content/pl/docs/2.for-users/3.features/mfm.md index 5771232a..6ec1aa36 100644 --- a/content/pl/docs/2.for-users/3.features/mfm.md +++ b/content/pl/docs/2.for-users/3.features/mfm.md @@ -7,7 +7,9 @@ description: MFMは、Misskeyの様々な場所で使用できる専用のマー MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。 :::tip + 一部の構文はMarkdownやHTMLと互換性があります。 + ::: ## MFMが使用可能な場所の例 @@ -23,7 +25,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使 アットマーク + ユーザー名で、特定のユーザーを示すことができます。 :::tip + メンションについての詳細は[こちら](./mention.md)を参照してください。 + ::: ``` @@ -42,7 +46,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使 ナンバーサイン + タグで、ハッシュタグを示すことができます。 :::tip + ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。 + ::: ``` @@ -70,6 +76,7 @@ https://example.com ``` :::tip + リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。 ``` @@ -83,8 +90,11 @@ https://example.com ### カスタム絵文字 コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。 + :::tip + カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。 + ::: ``` diff --git a/content/pl/docs/2.for-users/3.features/mute-and-block.md b/content/pl/docs/2.for-users/3.features/mute-and-block.md index 9ff1ddf9..6fa407ce 100644 --- a/content/pl/docs/2.for-users/3.features/mute-and-block.md +++ b/content/pl/docs/2.for-users/3.features/mute-and-block.md @@ -5,11 +5,15 @@ ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。 :::tip + ミュートとブロックは併用できます。 + ::: :::warning + 利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。 + ::: Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。 @@ -26,7 +30,9 @@ Misskey Webでは、設定>ミュートとブロック から、自分がミュ Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。 :::tip + ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。 + ::: ## ブロック @@ -48,9 +54,13 @@ Misskey Webでユーザーをミュートするには、対象のユーザーの Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。 :::warning + ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。 + ::: :::warning + 相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。 + ::: diff --git a/content/pl/docs/2.for-users/3.features/pages.md b/content/pl/docs/2.for-users/3.features/pages.md index 21a59a21..0bb1232f 100644 --- a/content/pl/docs/2.for-users/3.features/pages.md +++ b/content/pl/docs/2.for-users/3.features/pages.md @@ -3,7 +3,9 @@ Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。 :::warning + v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。 + ::: ## ページ設定 diff --git a/content/pl/docs/2.for-users/3.features/poll.md b/content/pl/docs/2.for-users/3.features/poll.md index c96f89a1..32777ede 100644 --- a/content/pl/docs/2.for-users/3.features/poll.md +++ b/content/pl/docs/2.for-users/3.features/poll.md @@ -13,7 +13,9 @@ 追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。 :::warning + いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。 + ::: ## 複数回答を可能にする @@ -41,7 +43,9 @@ 未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。 :::tip + 未投票アンケートには、結果を表示した状態でも投票できます。 + ::: 投票をすると、自分の投票した選択肢に✔がつきます。 diff --git a/content/pl/docs/2.for-users/3.features/share-form.md b/content/pl/docs/2.for-users/3.features/share-form.md index 0bd8a69a..e65fd555 100644 --- a/content/pl/docs/2.for-users/3.features/share-form.md +++ b/content/pl/docs/2.for-users/3.features/share-form.md @@ -7,7 +7,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく ## クエリパラメータ :::tip + すべてのパラメータは**オプション**であり、必須ではありません。 + ::: | 名前 | 説明 | @@ -46,7 +48,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく | `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) | :::warning + `visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。 + ::: ### 添付ファイル diff --git a/content/pl/docs/2.for-users/3.features/thread-mute.md b/content/pl/docs/2.for-users/3.features/thread-mute.md index ab4bd823..2f4378ba 100644 --- a/content/pl/docs/2.for-users/3.features/thread-mute.md +++ b/content/pl/docs/2.for-users/3.features/thread-mute.md @@ -1,7 +1,9 @@ # スレッドミュート :::tip + バージョン 12.95.0 以降の機能です。 + ::: スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。 @@ -11,5 +13,7 @@ Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。 :::warning + スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。 + ::: diff --git a/content/pl/docs/2.for-users/3.features/webhook.md b/content/pl/docs/2.for-users/3.features/webhook.md index eab0e71c..19d61ab2 100644 --- a/content/pl/docs/2.for-users/3.features/webhook.md +++ b/content/pl/docs/2.for-users/3.features/webhook.md @@ -1,11 +1,15 @@ # Webhook :::tip + バージョン 12.109.0 以降の機能です。 + ::: :::warning + 実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。 + ::: MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。 diff --git a/content/pl/docs/2.for-users/4.resources/1.troubleshooting.md b/content/pl/docs/2.for-users/4.resources/1.troubleshooting.md index 03b877a9..2aef90d3 100644 --- a/content/pl/docs/2.for-users/4.resources/1.troubleshooting.md +++ b/content/pl/docs/2.for-users/4.resources/1.troubleshooting.md @@ -5,7 +5,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ # トラブルシューティング :::tip + [よくある質問](./faq.md)も合わせてお役立てください。 + ::: 問題が発生したときは、まずこちらをご確認ください。 @@ -59,7 +61,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ クライアントの設定の「キャッシュをクリア」すると直ります。 :::warning + 「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。 + ::: ## 通知やアンテナ等の点滅が消えない diff --git a/content/pl/docs/2.for-users/4.resources/donate.md b/content/pl/docs/2.for-users/4.resources/donate.md index 0972cb72..bbd32212 100644 --- a/content/pl/docs/2.for-users/4.resources/donate.md +++ b/content/pl/docs/2.for-users/4.resources/donate.md @@ -13,22 +13,27 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip + 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 + ::: :::tip + 額に応じて以下の返礼を用意しています。 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 - 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載 - 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載 - ::: + +::: :::warning -:::warning + **バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。** + (メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります) -::: + ::: また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。 diff --git a/content/pl/docs/2.for-users/4.resources/misskey-hub.md b/content/pl/docs/2.for-users/4.resources/misskey-hub.md index bbdce97a..87114f3d 100644 --- a/content/pl/docs/2.for-users/4.resources/misskey-hub.md +++ b/content/pl/docs/2.for-users/4.resources/misskey-hub.md @@ -6,7 +6,9 @@ Misskey Hubは、Misskeyに関するナレッジなどのドキュメント、 Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub) :::tip + Misskey HubはNuxtを使ってビルドされた静的サイトです。 + ::: ## Misskey Hubに貢献する diff --git a/content/pl/docs/3.for-admin/features/announcement.md b/content/pl/docs/3.for-admin/features/announcement.md index 54475e35..caaa6436 100644 --- a/content/pl/docs/3.for-admin/features/announcement.md +++ b/content/pl/docs/3.for-admin/features/announcement.md @@ -5,12 +5,14 @@ お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。 :::warning + アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。 - 「既存ユーザーのみ」オプションを有効にしてお知らせを作成する - 「非通知」オプションを有効にしてお知らせを作成する - 終了したお知らせはアーカイブする - ::: + +::: ## 表示形式 diff --git a/content/pl/docs/3.for-admin/features/role.md b/content/pl/docs/3.for-admin/features/role.md index 6ed15743..fa0e6444 100644 --- a/content/pl/docs/3.for-admin/features/role.md +++ b/content/pl/docs/3.for-admin/features/role.md @@ -21,11 +21,13 @@ - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) :::warning + コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 - 手動でのアサイン/アサイン解除は行えません。 - 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。 - ::: + +::: ## 権限 @@ -53,6 +55,7 @@ **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** :::tip + 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 @@ -62,7 +65,8 @@ - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ::: + +::: ### ベースロールの値を使用 @@ -84,14 +88,14 @@ アサインする際にアサインされる期間を設定することが可能です。 -:::tip :::tip ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。 ::: -::: :::warning + コンディショナル ロールには手動でのアサインはできません。 + ::: ## ユーザーのポリシーの確認 diff --git a/content/pl/docs/3.for-admin/install/guides/1.index.md b/content/pl/docs/3.for-admin/install/guides/1.index.md index 73c48d68..012ad01f 100644 --- a/content/pl/docs/3.for-admin/install/guides/1.index.md +++ b/content/pl/docs/3.for-admin/install/guides/1.index.md @@ -7,15 +7,19 @@ description: Misskeyサーバーの作成方法についての案内です。 Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::warning + 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。 詳しくは [misskey-dev/misskey #9791](https://github.com/misskey-dev/misskey/issues/9791) をご覧ください。 + ::: ## Xserver VPSでインストール diff --git a/content/pl/docs/3.for-admin/install/guides/bash.md b/content/pl/docs/3.for-admin/install/guides/bash.md index 09a6ede6..b7762eba 100644 --- a/content/pl/docs/3.for-admin/install/guides/bash.md +++ b/content/pl/docs/3.for-admin/install/guides/bash.md @@ -20,7 +20,9 @@ Misskeyを簡単にインストールするためのシェルスクリプトが 3. Cloudflareアカウント（推奨） :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。 @@ -28,7 +30,6 @@ Let's Encryptの認証を試行できる回数が少ないので、サーバー ## Cloudflareの設定 Cloudflareを使う場合、Cloudflareのドメインの設定を完了してからインストールを開始するようにしてください。\ -\ ネームサーバーの適用には最大で3日程度かかる場合があります。 また、nginxとCloudflareを設定する場合、Cloudflareの設定画面にて、 @@ -41,7 +42,6 @@ Cloudflareを使う場合、Cloudflareのドメインの設定を完了してか ### 1. SSH サーバーにSSH接続します。\ -\ （サーバーのデスクトップを開いている方はシェルを開きましょう。） ### 2. 環境を最新にする @@ -113,13 +113,10 @@ iptablesを使うようにしてください。 v1から、インストールメソッドにsystemdとDockerとを選べるようにしました。 Dockerと言っても、**MisskeyだけをDockerで実行**し、RedisやPostgresなどはホストで直接実行します。\ -\ [docker-composeですべての機能を動かす方法については、mamemonongaさんが作成したこちらの記事がおすすめです。](https://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0) Docker Hubイメージを使う設定であれば、Misskeyのビルドが不要になるため、**一番お勧めです**。\ -\ ただし、マイグレーションは必要なので、アップデート時にMisskeyを使えない時間がゼロになるわけではありません。\ -\ また、Misskeyのビルド環境を準備しない(git pullしない)ので、フォークを動かしたくなった時に設定が面倒になります。 ローカルでDockerをビルドする方式は、パフォーマンス面で非推奨です。 @@ -147,14 +144,12 @@ systemdは、Docker Hubにイメージを上げるまでもないものの、フ 万が一途中で失敗してもう一度スクリプトを動作させる場合、次のことに注意してください。 - RedisやPostgresのインストールが終わっている場合、「install locally」はNoにしてください。\ - \ host・port設定はそのままEnterを押します。 ユーザー名やパスワードは、前回実行した際に指定したものを入力します。 ## .envファイルについて インストールスクリプトは、2つの.envファイルを作成します。\ -\ アップデートの際に使用します。 ### /root/.misskey.env @@ -165,14 +160,12 @@ misskeyを実行するユーザーを覚えておくために必要です。 systemdの場合に生成されます。\ \ -主にディレクトリを覚えておくのに使用します。 +実行されているコンテナとイメージの番号を保存しています。 ### /home/(misskeyユーザー)/.misskey-docker.env Dockerの場合に生成されます。\ -\ 実行されているコンテナとイメージの番号を保存しています。\ -\ コンテナの番号はアップデートの際に更新されます。古いイメージは削除されます。 ## 自分で管理する @@ -184,7 +177,6 @@ Dockerの場合に生成されます。\ ### Misskeyディレクトリ Misskeyのソースは`/home/ユーザー/ディレクトリ`としてcloneされます。\ -\ （ユーザー、ディレクトリの初期値はともにmisskeyです。） Misskeyディレクトリへは、以下のように移動するとよいでしょう。 @@ -203,7 +195,6 @@ exit ### systemd systemdのプロセス名はexample.comです。\ -\ たとえば再起動するには次のようにします。 ``` @@ -259,7 +250,6 @@ requirepassとbindを`/etc/redis/misskey.conf`で設定しています。 ## Q. アップデート後に502でアクセスできない Dockerでは、起動後にマイグレーションをするため、すぐにアクセスできません。\ -\ マイグレーションが終わっているかどうか確認してみてください。 systemdの場合では、pnpm installに失敗している可能性があります。 @@ -275,5 +265,4 @@ journalctlでログを確認すると、たいていre2が云々という記述 ## Q. 同じサーバーにもう1つMisskeyを建てたい スクリプトは同じサーバーに追加でMisskeyをインストールすることは想定していません。\ -\ 幾つかの設定が上書きされるか、途中でエラーになってしまうでしょう。 diff --git a/content/pl/docs/3.for-admin/install/guides/docker.md b/content/pl/docs/3.for-admin/install/guides/docker.md index 69402049..08c0a65f 100644 --- a/content/pl/docs/3.for-admin/install/guides/docker.md +++ b/content/pl/docs/3.for-admin/install/guides/docker.md @@ -7,13 +7,16 @@ description: このガイドはDockerを使ったMisskeyセットアップ方法 このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::tip{label='前提条件'} - DockerおよびDocker Composeがインストールされていること。 - ::: + +::: ## リポジトリの取得 @@ -34,7 +37,6 @@ cp ./docker-compose_example.yml ./docker-compose.yml ``` `default.yml`と`docker.env`をファイル内の説明に従って編集してください。\ -\ また、必要に応じて、`docker-compose.yml`を編集します。(ポートを変更したい場合など) ## ビルドと初期化 @@ -60,9 +62,9 @@ GLHF✨ ## Misskeyのアップデート方法 :::warning -:::warning + アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 -::: + ::: ```sh diff --git a/content/pl/docs/3.for-admin/install/guides/kubernetes.md b/content/pl/docs/3.for-admin/install/guides/kubernetes.md index 8d0905fd..e313669a 100644 --- a/content/pl/docs/3.for-admin/install/guides/kubernetes.md +++ b/content/pl/docs/3.for-admin/install/guides/kubernetes.md @@ -3,14 +3,16 @@ このガイドでは、Kubernetes と HelmChartを使用したMisskeyセットアップ方法について説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: ## TrueCharts と TrueNAS Scale MisskeyのHelmChartsはTrueNAS Scaleで使用するためのTrueChartsで公開されていますが、HelmChartsとしてインストールすることもできます。 -[TrueCharts](https://truecharts.org/charts/description_list) のサイトには利用可能なすべてのChartsやインストール方法などのドキュメントがあります。 +現在、Misskeyは_incubator_ trainで進行中です。 また、不明な点があればTrueChartsの[Discord](https://discord.gg/Ax9ZgzKx9t)サーバーで質問をすることもできます。 diff --git a/content/pl/docs/3.for-admin/install/guides/manual.md b/content/pl/docs/3.for-admin/install/guides/manual.md index 0efb7b3b..d17aa4f6 100644 --- a/content/pl/docs/3.for-admin/install/guides/manual.md +++ b/content/pl/docs/3.for-admin/install/guides/manual.md @@ -7,7 +7,9 @@ description: このガイドではMisskeyのインストール・セットアッ このガイドではMisskeyのインストール・セットアップ方法について解説します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ + ::: :::tip{label='前提条件'} @@ -108,7 +110,9 @@ WantedBy=multi-user.target ``` :::warning + CentOSで1024以下のポートを使用してMisskeyを使用する場合は`ExecStart=/usr/bin/sudo /usr/bin/npm start`に変更する必要があります。 + ::: systemdを再読み込みしmisskeyサービスを有効化 @@ -125,7 +129,9 @@ sudo systemctl start misskey ``` :::tip + `systemctl status misskey`と入力すると、サービスの状態を調べることができます。 + ::: :::: @@ -133,7 +139,9 @@ sudo systemctl start misskey ## Misskeyのアップデート方法 :::warning + アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 + ::: masterをpullし直し、インストール、ビルド、データベースのマイグレーションを行います: @@ -156,8 +164,10 @@ sudo systemctl restart misskey ``` :::tip + ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: - `pnpm run clean`または`pnpm run clean-all` - `pnpm rebuild` - ::: + +::: diff --git a/content/pl/docs/3.for-admin/install/guides/ubuntu-manual.md b/content/pl/docs/3.for-admin/install/guides/ubuntu-manual.md index 99b7b42a..f86a16fa 100644 --- a/content/pl/docs/3.for-admin/install/guides/ubuntu-manual.md +++ b/content/pl/docs/3.for-admin/install/guides/ubuntu-manual.md @@ -11,11 +11,15 @@ [**シェルスクリプトの詳細と使用方法はこちらから！**](./bash/) :::tip + シェルスクリプトでの開発環境へのインストールは想定されていません。 + ::: :::tip + ドメインの購入とCloudflareのセットアップ、サーバーの確保についてはご自身でご準備ください。 + ::: 不具合があれば[ @aqz@p1.a9z.dev へのメンション](https://p1.a9z.dev/@aqz)にてお知らせいただければと思います。 @@ -27,7 +31,9 @@ [docker-compose](./docker/)なら、手作業でももうちょっと簡単に実行できるはずです。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: ## はじめに @@ -52,7 +58,9 @@ OSの違い、Misskey本体や依存するソフトウェアのバージョン - ここではドメインをexample.tldとして解説を進めるので、自分が買ったドメインに適宜置き換えて読むこと。開発環境の場合はlocalhostと読み替えます（設定ファイルの項で別途説明） :::danger + 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ + ::: ## nanoの使い方 @@ -78,7 +86,9 @@ sudo adduser --disabled-password --disabled-login misskey ``` :::tip + 開発環境の場合はユーザーを分ける必要はありません + ::: ## 基本的なソフトウェアのインストールと設定 @@ -174,10 +184,12 @@ activeならOK。 ### nginx -nginxは、主としてリバースプロキシに用いられるWebサーバーソフトである。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。 +http\://localhost にアクセスし、\*Welcome to nginx!\*と表示されればOK。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。 :::tip + 開発環境の場合はnginxのセットアップは不要です + ::: nginx.orgのドキュメント http\://nginx.org/en/linux_packages.html#Ubuntu に従ってインストールする。 @@ -238,7 +250,9 @@ sudo apt install -y git build-essential サーバーをインターネットに公開する準備をする。 :::tip + 開発環境の場合はファイヤーウォールやCloudFlare、Certbotの設定は不要です + ::: ### ファイヤーウォール @@ -272,7 +286,9 @@ sudo systemctl enable ufw ``` :::tip + ufwは、netfilter(iptables)を人間が操作しやすいようにするアプリだ。インストールスクリプトは、OCI環境ではnetfilterを直接操作する。 + ::: ### CloudFlare @@ -376,7 +392,9 @@ nano .config/default.yml 設定できる値と記述方法は[.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)に書かれている。 :::tip + 開発環境の場合、urlは`url: http://localhost:3000`と指定します。 + ::: ```yml @@ -469,7 +487,9 @@ NODE_ENV=production pnpm run build ``` :::tip + 開発環境の場合、`NODE_ENV=production`は不要です。以降のコマンドでも同様に削除してください。 + ::: ### サーバーでビルドできない場合 @@ -515,7 +535,9 @@ CloudFlareのDNS設定が正しいIPアドレスになっているかもう一 ## Misskeyのデーモンを作成 :::tip + 開発環境の場合、デーモンの作成は不要です。 + ::: いったんCtrl+Cでプロセスをキルし、Misskeyをデーモンで起動する設定をしよう。 diff --git a/content/pl/docs/3.for-admin/install/resources/cdn.md b/content/pl/docs/3.for-admin/install/resources/cdn.md index 747e4490..030216b8 100644 --- a/content/pl/docs/3.for-admin/install/resources/cdn.md +++ b/content/pl/docs/3.for-admin/install/resources/cdn.md @@ -17,5 +17,7 @@ CDNで以下の設定を行なってください。 - `/api/*`以外のリクエストをすべてキャッシュする :::tip + Misskeyをアップデートした際にキャッシュのクリアは不要です。 + ::: diff --git a/content/pl/docs/3.for-admin/install/resources/troubleshooting.md b/content/pl/docs/3.for-admin/install/resources/troubleshooting.md index d9aff878..202e3705 100644 --- a/content/pl/docs/3.for-admin/install/resources/troubleshooting.md +++ b/content/pl/docs/3.for-admin/install/resources/troubleshooting.md @@ -248,6 +248,10 @@ Amazon S3に互換性のあるオブジェクトストレージであれば利 各サービス/ソフトウェアのドキュメントをよく読み、設定してみてください。 +### ローディングが終わらない + +Cloudflare を使用している場合は、Rocket LoaderやAuto Minifyが有効になっていないか確認してください。有効になっている場合は無効にすることで解決する場合があります。 + *** # まったく解決しなかった場合 diff --git a/content/pl/docs/3.for-admin/moderation-tips/disable-timelines.md b/content/pl/docs/3.for-admin/moderation-tips/disable-timelines.md index 7c11efa2..1a320724 100644 --- a/content/pl/docs/3.for-admin/moderation-tips/disable-timelines.md +++ b/content/pl/docs/3.for-admin/moderation-tips/disable-timelines.md @@ -8,7 +8,9 @@ LTLやSTLは、そのサーバー全員の投稿が見れるため、新規の もしデメリットの方が上回っていると感じたら、それらのタイムラインを無効化することも検討してください。 :::warning + 無効化を行うと、ユーザーが困惑し、短期的に見て利用者が減る可能性があります。そのため、無効化の際は影響を慎重に検討し、事前に説明してフォローを整える期間を一定程度設けることを推奨します。 + ::: なお、管理者/モデレーターは、これらのタイムラインの無効化状態は適用されず、引き続き利用することが可能です。 diff --git a/content/pl/docs/4.for-developers/aiscript.md b/content/pl/docs/4.for-developers/aiscript.md new file mode 100644 index 00000000..2c7c5860 --- /dev/null +++ b/content/pl/docs/4.for-developers/aiscript.md @@ -0,0 +1,67 @@ +# AiScript + +AiScriptは、Misskeyの以下の箇所で使用できるスクリプト言語です。 + +- [プラグイン](./plugin/) +- [ウィジェット](/docs/for-users/features/widgets/) + - ボタン + - AiScriptコンソール + - AiScript App +- Misskey Play +- スクラッチパッド + +:::tip + +AiScriptの実装はMisskeyとは別リポジトリで、[オープンソースで公開されています](https://github.com/aiscript-dev/aiscript)。 + +::: + +## 使い方 + +AiScript標準の構文や組み込み関数などが使用できます。 + +:::tip + +ドキュメントは[こちら](https://github.com/aiscript-dev/aiscript/tree/master/docs)\ +Misskey本体のバージョンにより、使用できるAiScriptのバージョンが異なる場合があります。バージョンの確認には`<: Core:v`をScratchpadなどで実行してください。 + +::: + +これらに加え、Misskey専用の組み込み定数・関数が３グループに分けて提供されています。 + +### Misskey AiScript API + +接頭辞: `Mk:`\ +Misskey内の全てのAiScript環境で使用できる定関数群です。 +詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Mk:`とついた部分を参照して下さい。 + +### プラグインAPI + +接頭辞: `Plugin:`\ +[プラグイン](./plugin/)でのみ使用できる定関数群です。 +詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Plugin:`とついた部分を参照して下さい。 + +### UI API + +接頭辞: `Ui:`\ +[ウィジェット](/docs/for-users/features/widgets/)（AiScript App）、Misskey Play、Scratchpadで使用できます。 +ドキュメントは未整備（TODO）ですが、インターネット上に有志の方が執筆された解説記事があります。 + +### 標準入出力 + +AiScript標準で定義されている`readline`関数と`print`関数（および`<:`構文）の内部実装は、Misskey側で独自に提供されています。 + +#### readline(message) + +`message`: `str`\ +返り値: `str`\ +Misskey内の全てのAiScript環境で使用できます。\ +文字列の入力を求めるポップアップを表示します。 + +#### print(message) + +`message`: `any`\ +返り値: `null`\ +[ウィジェット](/docs/for-users/features/widgets/)（AiScriptコンソール）、Scratchpadで使用できます。\ +コンソールに文字列を出力します。\ +`<:`構文も同様の働きをします。 diff --git a/content/pl/docs/4.for-developers/api/1.index.md b/content/pl/docs/4.for-developers/api/1.index.md index 11ef960c..2d2c988f 100644 --- a/content/pl/docs/4.for-developers/api/1.index.md +++ b/content/pl/docs/4.for-developers/api/1.index.md @@ -8,7 +8,9 @@ MisskeyはAPIを公開しています。APIを使ってMisskeyクライアント ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。 :::tip -Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\ + +Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\\ + ::: diff --git a/content/pl/docs/4.for-developers/api/libraries.md b/content/pl/docs/4.for-developers/api/libraries.md index 18db0f35..ee634623 100644 --- a/content/pl/docs/4.for-developers/api/libraries.md +++ b/content/pl/docs/4.for-developers/api/libraries.md @@ -15,6 +15,8 @@ description: Misskey APIに関連するライブラリの一覧 ## Python - [Misskey.py](https://github.com/YuzuRyo61/Misskey.py) +- [MiPA](https://github.com/yupix/MiPA) +- [MiPAC](https://github.com/yupix/MiPAC) ## .Net diff --git a/content/pl/docs/4.for-developers/api/permission.md b/content/pl/docs/4.for-developers/api/permission.md index 7844a7fe..50dd4be7 100644 --- a/content/pl/docs/4.for-developers/api/permission.md +++ b/content/pl/docs/4.for-developers/api/permission.md @@ -5,7 +5,9 @@ description: アプリケーションが要求する権限の一覧 # 権限の一覧 :::tip + このページは[misskey-js](https://github.com/misskey-dev/misskey/tree/develop/packages/misskey-js)から自動生成しているため、ドキュメントや翻訳が不完全な場合があります。 + ::: diff --git a/content/pl/docs/4.for-developers/api/streaming/1.index.md b/content/pl/docs/4.for-developers/api/streaming/1.index.md index af767dfc..6ce5b5bc 100644 --- a/content/pl/docs/4.for-developers/api/streaming/1.index.md +++ b/content/pl/docs/4.for-developers/api/streaming/1.index.md @@ -5,7 +5,9 @@ description: ストリーミングAPIを使うと、リアルタイムで様々 # ストリーミングAPI :::tip + 最初に[Misskey API](../index.md)のドキュメントを読むことをお勧めします。 + ::: ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、リアクションされた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。 @@ -26,7 +28,9 @@ wss://{host}/streaming?i={token} - `{token}`の部分は、ユーザーのアクセストークンに置き換えます。 :::tip + アクセストークンは省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。 + ::: ストリームに接続すると、後述投稿の購読を行ったりすることができますが、まだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。 @@ -40,7 +44,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。 :::tip + ひとつのストリーム接続上で、同時に複数のチャンネルに接続することができます。 + ::: 以下では、チャンネルの使用方法を説明します。どのようなチャンネルがあるかは、[チャンネル一覧](./channel/index.md)を参照してください。 @@ -69,7 +75,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり - `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。 :::tip + IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。 + ::: ### チャンネルからのメッセージを受け取る diff --git a/content/pl/docs/4.for-developers/api/token.md b/content/pl/docs/4.for-developers/api/token.md index 8f9d3919..d0e74076 100644 --- a/content/pl/docs/4.for-developers/api/token.md +++ b/content/pl/docs/4.for-developers/api/token.md @@ -7,7 +7,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた** アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 :::tip + ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 + ::: あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 @@ -20,7 +22,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた** Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 :::danger + アクセストークンは他人に知られないようにしてください。 + ::: ### アプリケーション利用者にアクセストークンの発行をリクエストする @@ -32,6 +36,7 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app) + ::: #### Step 1 @@ -39,7 +44,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger + このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: #### Step 2 @@ -119,7 +126,9 @@ https://{host}/api/miauth/{session}/check APIの詳細は、APIリファレンスを参照してください。 :::warning + MisskeyはRESTを採用していません。 + ::: また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 diff --git a/content/pl/docs/4.for-developers/api/token/1.index.md b/content/pl/docs/4.for-developers/api/token/1.index.md new file mode 100644 index 00000000..3305efc0 --- /dev/null +++ b/content/pl/docs/4.for-developers/api/token/1.index.md @@ -0,0 +1,88 @@ +# アクセストークンの取得 + +APIを使い始めるには、APIを利用するアカウントに紐づいた**アクセストークン**を取得する必要があります。 +このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。 + +基本的に、APIはリクエストにはアクセストークンが必要となります。 +アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 + +:::tip + +ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 + +::: + +あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 + +- 前者の場合: **「自分自身のアクセストークンを手動発行する」** に進む +- 後者の場合: **「アプリケーション利用者にアクセストークンの発行をリクエストする」** に進む + +## 自分自身のアクセストークンを手動発行する + +Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 + +:::danger + +アクセストークンは他人に知られないようにしてください。 + +::: + +## アプリケーション利用者にアクセストークンの発行をリクエストする + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の方法の一つを使います。 + +:MkIndex + +## APIの利用 + +アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。 + +:::tip + +- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。 +- 要求ヘッダーに`Content-Type: application/json`を指定します。 +- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。 +- ベースURLは`https://{サーバーのドメイン}/api`です。 + +::: + +### Authorization headerを使う方式 + +以下のようにヘッダーの`Authorization`フィールドを指定します。 + +```js +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + text: "Hello Misskey API World with My Application!" + }), + headers: { + Authorization: `Bearer ${accessToken}`, + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` + +### iを使う方式 + +アクセストークン付きのボディの例（metaの場合）: + +```json +{ + "i": "HogEFugA1341", + "detail": false +} +``` + + + +APIの詳細は、APIリファレンスを参照してください。 + +:::warning + +MisskeyはRESTを採用していません。 + +::: + +また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](../streaming/)を参照してください。 diff --git a/content/pl/docs/4.for-developers/api/token/2.miauth.md b/content/pl/docs/4.for-developers/api/token/2.miauth.md new file mode 100644 index 00000000..1100db0d --- /dev/null +++ b/content/pl/docs/4.for-developers/api/token/2.miauth.md @@ -0,0 +1,76 @@ +--- +description: v12.27.0以降で使用できる、Misskey独自の簡素な認証方法について説明しています。 +--- + +# MiAuth方式でのアクセストークン取得方式 + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 + +:::tip + +以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 + +- [よりおおく使われているOAuth方式でのアクセストークン取得方法もあります。](./oauth.md) +- [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app.md) + +::: + +## Step 1 + +UUIDを生成する。以後これを**セッションID**と呼びます。 + +:::danger + +このセッションIDは毎回生成し、使いまわさないようにしてください。 + +::: + +## Step 2 + +アプリケーション認証フォームをユーザーのブラウザで表示させる。認証フォームは、以下の形式のURLで開くことができます: + +``` +https://{host}/miauth/{session} +``` + +ここで、 + +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 +- `{session}`の部分は、セッションIDに置き換えます。 + +また、URLにクエリパラメータとしていくつかのオプションを設定できます: + +| 名前 | 説明 | +| ------------ | ------------------------------------------------------------------------------ | +| `name` | アプリケーション名。 | +| `icon` | アプリケーションのアイコン画像URL。 | +| `callback` | 認証が終わった後にリダイレクトするURL。
リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 | +| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 | + +:::tip{label='例'} + +``` +https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive +``` + +::: + +## Step 3 + +ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 + +``` +https://{host}/api/miauth/{session}/check +``` + +ここで、 + +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。 +- `{session}`の部分は、セッションIDに置き換えます。 + +レスポンスに含まれるプロパティは以下の通りです: + +| 名前 | 説明 | +| ------- | -------------- | +| `token` | ユーザーのアクセストークン。 | +| `user` | ユーザーの情報。 | diff --git a/content/pl/docs/4.for-developers/api/token/3.oauth.md b/content/pl/docs/4.for-developers/api/token/3.oauth.md new file mode 100644 index 00000000..a29644ab --- /dev/null +++ b/content/pl/docs/4.for-developers/api/token/3.oauth.md @@ -0,0 +1,179 @@ +--- +description: v2023.9.0以降で使用できる、OAuth2.0方式での認証方法について説明しています。 +--- + +# OAuth方式でのアクセストークン取得方式 + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 + +:::tip + +以下に説明する方法は、[OAuth 2.0](https://datatracker.ietf.org/doc/html/rfc6749.html)と呼ばれるものです。普通のOAuthはアプリを作成しますが、[IndieAuth](https://indieauth.spec.indieweb.org/)の拡張でアプリ作成なしで使えるようになっています。 + +OAuth方式は使えるライブラリが多いので、出来ればライブラリを使うのをおすすめします。 + +現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。 + +- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md) +- [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md) + +::: + +## Step 1 + +アプリ紹介のためのウェブページを作ります。ページがHTTPSアドレスでアクセスできるようにしてください。ページのとこかに以下のようなHTMLコードを書きます。 + +```html + + + + +
+ My Misskey App +
+``` + +あとで`redirect_uri`のアドレスに認証コードが転送されます。 + +## Step 2 + +PKCE `code_verifier`と`code_challenge`文字列, 及び`state`文字列を生成します。 + +- `code_verifier`の場合は最低43字、最高128字でアルファベット大・小文字及び`-._~`の中の文字に限られます。 +- `code_challenge`文字列は`code_verifier`文字列をSHA256アルゴリズムでハッシュしてbase64urlでエンコードした結果を使います。 +- `state`文字列には特別な制限はありません。ランダムな文字列を使います。 + +:::danger + +この文字列は毎回生成し、使いまわさないようにしてください。 + +::: + +:::tip + +[pkce-challenge](https://www.npmjs.com/package/pkce-challenge)とかのライブラリを使ったり、OAuthライブラリのPKCE機能を使うのがおすすめです。 + +::: + +:::tip{label='例'} + +```js +import crypto from "node:crypto"; + +const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-._~"; +const codeVerifier = new Array(128) + .fill(0) + .map(() => chars[Math.floor(chars.length * Math.random())]) + .join(""); +console.log('code_verifier', codeVerifier); + +const codeChallenge = crypto + .createHash("sha256") + .update(codeVerifier, "ascii") + .digest("base64url"); +console.log('code_challenge', codeChallenge); + +const state = crypto.randomUUID(); +console.log('state', state); +``` + +::: + +## Step 3 + +相手サーバーのOAuth情報を取得します。データはJSON形式になっています。 + +``` +https://{host}/.well-known/oauth-authorization-server +``` + +`{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 + +ここでは`authorization_endpoint`と`token_endpoint`を使います。 + +:::tip + +次のステップで使われる`scope`の情報も`scopes_supported`で確認できます。 + +::: + +## Step 4 + +アプリケーション認証フォームをユーザーのブラウザで表示させます。認証フォームは、以下の形式のURLで開くことができます: + +``` +{authorization_endpoint}?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&scope={scope}&code_challenge={code_challenge}&code_challenge_method=S256&state={state} +``` + +ここで、 + +- `{authorization_endpoint}`の部分は、前の情報取得で得たアドレスに置き換えます。 +- `{client_id}`の部分は、アプリの紹介ページのアドレスに置き換えます。 +- `{code_challenge}`の部分は、前に生成した`code_challenge`文字列に置き換えます +- `code_challenge_method`の部分は常に`S256`にします。 +- `{redirect_uri}`の部分は、紹介ページで使っている配達先のアドレスに置き換えます。 +- `{scope}`の部分は、アプリケーションが要求する権限に置き換えます。要求する権限を` `で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 +- `{state}`の部分は、前に生成した`state`文字列に置き換えます。 + +:::tip{label='例'} + +``` +https://misskey.local/oauth/authorize?client_id=http%3A%2F%2Fexample.com&code_challenge=C6hwMO2bmIzg3nqppTE9b79fvuOjlrKmH2xNiZSMHzw&code_challenge_method=S256&response_type=code&redirect_uri=http%3A%2F%2Fexample.com%2Fredirect&scope=write%3Anotes&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +## Step 5 + +ユーザーがアプリケーションアクセスを許可したら、`redirect_uri`のアドレスに認証コードがURLパラメータの形式で転送されます。 + +| 名前 | 説明 | +| ------- | ----------------------- | +| `code` | ユーザーの認証コード。 | +| `state` | 認証リクエストに使われた`state`文字列。 | + +:::tip{label='例'} + +``` +https://example.com/redirect?code=...&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +`state`文字列がちゃんと一致しているのか確認して、次のステップに進みます。 + +## Step 6 + +転送された認証コードを使ってアクセストークンをPOSTでリクエストします。リクエスト先は`token_endpoint`になります。データ形式は`application/json`と`application/x-www-form-urlencoded`を使えます。各パラメータは以下のようになります。 + +| 名前 | 説明 | +| --------------- | ------------------------------ | +| `grant_type` | 常に`authorization_code`にします。 | +| `client_id` | 認証リクエストに使われた`client_id`文字列。 | +| `redirect_uri` | 認証リクエストに使われた`redirect_uri`文字列。 | +| `scope` | 認証リクエストに使われた`scope`文字列。 | +| `code` | 取得した認証コード。　 | +| `code_verifier` | 前に生成した`code_verifier`文字列。 | + +:::tip{label='例'} + +```js +const res = await fetch(endpoint, { + method: "POST", + body: JSON.stringify({ + grant_type: "authorization_code", + client_id: "https://example.com", + redirect_uri: "https://example.com/redirect", + scope: "write:notes", + code: "...", + code_verifier: "hjjbCYDmDpSLjirkO-PrfWKsRhDdJr-PAEGRClRwzUKlmFIIIrZNmSvUIraeIa~WqbqQnfbJV-Hc_IfuQkesBYUpukUi~lInDfU_AZjoZqbU.ioQTRzaFfZFfGnT-OAA", + }), + headers: { + "Content-Type": "application/json" + } +}); +``` + +::: + +レスポンスはJSONオブジェクト形式で、そこから`access_token`を取得して使います。 diff --git a/content/pl/docs/4.for-developers/plugin/create-plugin.md b/content/pl/docs/4.for-developers/plugin/create-plugin.md index 5e5130ca..cd9bf91e 100644 --- a/content/pl/docs/4.for-developers/plugin/create-plugin.md +++ b/content/pl/docs/4.for-developers/plugin/create-plugin.md @@ -74,4 +74,4 @@ Misskey Webはプラグインに対してAPIを公開していて、それらを v2023.11.0以降では、あなたのウェブサイトからワンクリックでプラグインを直接インストールできるようになっています。 -プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](./publish-on-your-website.md)をご覧ください。 +プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](../publish-on-your-website.md)をご覧ください。 diff --git a/content/pl/docs/5.releases.md b/content/pl/docs/5.releases.md index b7879489..17c4324b 100644 --- a/content/pl/docs/5.releases.md +++ b/content/pl/docs/5.releases.md @@ -6,6 +6,49 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2023.12.2 + +リリース日: 2023/12/28 + +### General + +- v2023.12.1でDockerを利用してサーバーを起動できない問題を修正 + +### Client + +- Enhance: 検索画面においてEnterキー押下で検索できるように + +## 2023.12.1 + +リリース日: 2023/12/27 + +### Note + +- アクセストークンの権限が再整理されたため、一部のAPIが古いAPIトークンでは動作しなくなりました。\ + 権限不足になる場合には権限を再設定して再生成してください。 + +### General + +- Enhance: ローカリゼーションの更新 +- Fix: 自分のdirect noteがuser list timelineに追加されない + +### Client + +- Feat: AiScript専用のMFM構文`$[clickable.ev=EVENTNAME ...]`を追加。`Mk:C:mfm`のオプション`onClickEv`に関数を渡すと、クリック時に`EVENTNAME`を引数にして呼び出す +- Enhance: MFM入力補助ボタンを投稿フォームに表示できるように #12787 +- Fix: 一部のモデログ(logYellowでの表示対象)について、表示の色が変わらない問題を修正 +- Fix: `fg`/`bg`MFMに長い単語を指定すると、オーバーフローされずはみ出る問題を修正 + +### Server + +- Enhance: センシティブワードの設定がハッシュタグトレンドにも適用されるようになりました +- Enhance: `oauth/token`エンドポイントのCORS対応 +- Fix: 1702718871541-ffVisibility.jsのdownが壊れている +- Fix:「非センシティブのみ（リモートはいいねのみ）」を設定していても、センシティブに設定されたカスタム絵文字をリアクションできる問題を修正 +- Fix: ロールアサイン時の通知で，ロールアイコンが縮小されずに表示される問題を修正 +- Fix: サードパーティアプリケーションがWebsocket APIに無条件にアクセスできる問題を修正 +- Fix: サードパーティアプリケーションがユーザーの許可なしに非公開の情報を見ることができる問題を修正 + ## 2023.12.0 リリース日: 2023/12/23 @@ -1957,7 +2000,9 @@ same as 12.112.0 ### NOTE :::warning + このバージョンからNode v16.14.0以降が必要です + ::: ### Changes @@ -2069,12 +2114,16 @@ same as 12.112.0 ### Note :::warning + ビルドする前に`npm run clean`を実行してください。 + ::: :::warning + このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 + ::: ### Improvements @@ -2145,6 +2194,7 @@ same as 12.112.0 アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。 12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。 + ::: ### Changes diff --git a/content/tw/docs/1.about-misskey.md b/content/tw/docs/1.about-misskey.md index bc2f8122..c37ed8c8 100644 --- a/content/tw/docs/1.about-misskey.md +++ b/content/tw/docs/1.about-misskey.md @@ -15,7 +15,9 @@ Misskey 是一個開源分散式微網誌平台專案。 最初不是分散式的，但在2018年實施了ActivityPub並轉為分散式，使服務更廣泛被認知和使用，一直持續至今。 :::tip + Misskey 這個名字來自歌手 May'n 的歌曲 Brain Diver 的歌詞，syuilo 當時正在聽這首歌。 + ::: 任何人都可以參與開發，目前開發工作仍在積極進行中。 @@ -35,7 +37,9 @@ Misskey 的所有原始碼均在開放原始碼許可證[AGPL](https://github.co 再舉一個例子，Twitter 和 Facebook 等大多數獲利服務都不是開源的。 :::tip + 從技術上來說，Misskey 的原始碼用 Git 管理，[託管在 GitHub。](https://github.com/misskey-dev) + ::: ## 參與開發和支援專案 @@ -141,8 +145,11 @@ Miskist 是指使用Misskey的人。 如果您透過向朋友和熟人介紹來 :::fukidashi{chara="doya_ai" charaName="藍"} 想了解更多關於我的訊息，請訪問 [這個網站](https://xn--931a.moe/)！ + ::: :::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"} + Misskey 的守護神小藍。小藍超級可愛！ + ::: diff --git a/content/tw/docs/2.for-users/2.onboarding/2.get-started.md b/content/tw/docs/2.for-users/2.onboarding/2.get-started.md index c25b9714..deff9106 100644 --- a/content/tw/docs/2.for-users/2.onboarding/2.get-started.md +++ b/content/tw/docs/2.for-users/2.onboarding/2.get-started.md @@ -11,14 +11,17 @@ Misskey 是一款軟體及其專案。 您可以從[伺服器清單](/servers/)中選擇您喜歡的伺服器。 :::tip + どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 :::g-details{summary='詳細'} + Misskey 具有聯邦功能。 聯邦功能允許不同伺服器上的使用者以與同一伺服器上的使用者相同的方式關注、反應、轉發等。 Misskey 中包含的聯邦功能基於稱為 ActivityPub 的開放通用標準，並且與 Mastodon 和 Pleroma 等其他軟體相容。 + ::: ::: @@ -31,5 +34,7 @@ Misskey 中包含的聯邦功能基於稱為 ActivityPub 的開放通用標準 建議尋找一個主題適合您的伺服器。 :::tip + 您可以在[此處](/servers/)查看伺服器清單。 + ::: diff --git a/content/tw/docs/2.for-users/2.onboarding/3.join-server.md b/content/tw/docs/2.for-users/2.onboarding/3.join-server.md index 316226c9..6fea7507 100644 --- a/content/tw/docs/2.for-users/2.onboarding/3.join-server.md +++ b/content/tw/docs/2.for-users/2.onboarding/3.join-server.md @@ -3,9 +3,11 @@ 一旦您決定了要註冊的伺服器，就可以建立帳戶了。 :::tip + ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 但是，您需要輸入的資訊可能會因伺服器而異。請聯絡您的伺服器管理員以取得更多資訊。 + ::: ## 開始註冊 diff --git a/content/tw/docs/2.for-users/2.onboarding/4.things-to-know.md b/content/tw/docs/2.for-users/2.onboarding/4.things-to-know.md index 79f1cecd..63ac7ff2 100644 --- a/content/tw/docs/2.for-users/2.onboarding/4.things-to-know.md +++ b/content/tw/docs/2.for-users/2.onboarding/4.things-to-know.md @@ -7,7 +7,9 @@ 在 Misskey 上發布訊息被稱為「貼文」。與 Twitter 等一般的 SNS 相比它的功能更多，所以第一次發文前請務必確認並好好發文！ :::tip + 詳情請參閱 [note](/docs/for-users/features/note/)。 + ::: ## 時間軸 @@ -15,7 +17,9 @@ Misskey 有多個時間軸。光是名稱可能就有點令人困惑，因此了解每個時間軸的作用非常重要。 :::tip + 詳情請參閱"[時間軸](/docs/for-users/features/timeline/)"。 + ::: ## 其他 diff --git a/content/tw/docs/2.for-users/3.features/ads.md b/content/tw/docs/2.for-users/3.features/ads.md index d470b4ba..eb7d2425 100644 --- a/content/tw/docs/2.for-users/3.features/ads.md +++ b/content/tw/docs/2.for-users/3.features/ads.md @@ -4,7 +4,9 @@ Misskey有一個功能，可以讓您在時間軸上顯示來自伺服器的廣 您可以點擊廣告右上角顯示的圖示來減少廣告的顯示頻率。 :::tip + 如果廣告總數較少，即使降低展示頻率，也可能會繼續展示。 + ::: ## 設定廣告（管理員） diff --git a/content/tw/docs/2.for-users/3.features/drive.md b/content/tw/docs/2.for-users/3.features/drive.md index 30413af6..23a43263 100644 --- a/content/tw/docs/2.for-users/3.features/drive.md +++ b/content/tw/docs/2.for-users/3.features/drive.md @@ -3,7 +3,9 @@ 雲端硬碟是一項允許您在 Misskey 管理上傳檔案的功能。 :::tip + 從技術上來說，所有上傳檔案都由 Misskey 系統集中管理，向使用者提供這些資訊的介面可以視作一個雲端硬碟。 + ::: 您可以從 Misskey Web 上的雲端硬碟頁面上傳任何檔案，也可以將您設定為頭像的任何圖片和您貼文中附加的任何檔案上傳到雲端硬碟。 @@ -13,7 +15,9 @@ 您也可以在硬碟中建立資料夾，將多個檔案組織在一起。 :::warning + 目前，如果從雲端硬碟中刪除檔案， **該檔案所依附的所有內容（貼文、頁面等）** 都會同時消失。 + ::: ## 敏感內容 (NSFW) diff --git a/content/tw/docs/2.for-users/3.features/mfm.md b/content/tw/docs/2.for-users/3.features/mfm.md index 41aeb75c..b335d9dc 100644 --- a/content/tw/docs/2.for-users/3.features/mfm.md +++ b/content/tw/docs/2.for-users/3.features/mfm.md @@ -7,7 +7,9 @@ description: MFM 是一種專有的標記語言，可以在 Misskey 的各個地 MFM 代表 Markup language For Misskey，是一種專有的標記語言，可以在 Misskey 的各個地方使用。 :::tip + 某些語法與 Markdown 和 HTML 相容。 + ::: ## 可使用 MFM 的地方 @@ -23,7 +25,9 @@ MFM 代表 Markup language For Misskey，是一種專有的標記語言，可以 「@ + 使用者名稱」可用來表示特定使用者。 :::tip + 有關提及的更多資訊，請參閱[此處](./mention.md)。 + ::: ``` @@ -42,7 +46,9 @@ MFM 代表 Markup language For Misskey，是一種專有的標記語言，可以 「# + 標籤」來表示主題標籤。 :::tip + 有關主題標籤的更多資訊，請參閱[此處](./hashtag.md)。 + ::: ``` @@ -70,6 +76,7 @@ https://example.com ``` :::tip + リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。 ``` @@ -84,7 +91,9 @@ https://example.com 您可以透過用冒號包圍自訂表情符號名稱來顯示自訂表情符號。 :::tip + 有關自訂表情符號的更多信息，請參閱[此處](./custom-emoji.md)。 + ::: ``` diff --git a/content/tw/docs/2.for-users/3.features/mute-and-block.md b/content/tw/docs/2.for-users/3.features/mute-and-block.md index 54c6eefa..f1658075 100644 --- a/content/tw/docs/2.for-users/3.features/mute-and-block.md +++ b/content/tw/docs/2.for-users/3.features/mute-and-block.md @@ -5,11 +5,15 @@ 對方不會知道你被靜音了，但會知道你被封鎖了。您可以自行決定選擇其中一種方式。 :::tip + 靜音和封鎖可以一起使用。 + ::: :::warning + 如果有任何違反服務條款的惱人用戶，請考慮向管理者檢舉。 + ::: 在 Misskey Web 上，您可以透過前往「設定」>「靜音和封鎖」來查看已靜音或封鎖的使用者清單。 @@ -26,7 +30,9 @@ 若要在 Misskey Web 上將使用者靜音，請開啟該使用者個人檔案頁面上的選單，然後按下「靜音」按鈕。 :::tip + 對方不會收到您將其靜音的通知，他們也不會知道已被您靜音。 + ::: ## 封鎖 @@ -48,9 +54,13 @@ 若要在 Misskey Web 上封鎖用戶，請開啟該使用者個人檔案頁面的選單，然後按下「封鎖」按鈕 :::warning + 對方不會收到您已封鎖他們的通知，但他們會間接知道自己被封鎖，因為他們將無法執行上述操作（例如追隨您）。 + ::: :::warning + 對方將無法看到您的內容，但如果他們切換帳戶或登出則可以看到您的內容。請將此作為一項簡單的輔助措施。 + ::: diff --git a/content/tw/docs/2.for-users/3.features/pages.md b/content/tw/docs/2.for-users/3.features/pages.md index 0f23663f..dc1a46fc 100644 --- a/content/tw/docs/2.for-users/3.features/pages.md +++ b/content/tw/docs/2.for-users/3.features/pages.md @@ -3,7 +3,9 @@ 您可以在 Misskey 上建立獨立於筆記的頁面。v13 以後專門用於靜態頁面。 :::warning + 從 v13 開始，需使用 Misskey Play 來建立動態頁面。 + ::: ## 頁面設定 diff --git a/content/tw/docs/2.for-users/3.features/poll.md b/content/tw/docs/2.for-users/3.features/poll.md index 7812eca1..4c70ae62 100644 --- a/content/tw/docs/2.for-users/3.features/poll.md +++ b/content/tw/docs/2.for-users/3.features/poll.md @@ -13,7 +13,9 @@ 如果您新增了太多選項，可以透過按下選項旁邊的 ☓ 按鈕將其刪除。 :::warning + 如果任何選項欄位為空值，您將無法發布附有該投票的貼文。 + ::: ## 允許複選 @@ -41,7 +43,9 @@ 如果您想在查看未投票的調查結果後再次隱藏這些結果，請按一下「投票」。 :::tip + 未投票的票選活動仍可進行投票，並顯示結果。 + ::: 當您投票後，您投票的選項旁邊會出現 ✔。 diff --git a/content/tw/docs/2.for-users/3.features/share-form.md b/content/tw/docs/2.for-users/3.features/share-form.md index 05ea2f7d..175f4db7 100644 --- a/content/tw/docs/2.for-users/3.features/share-form.md +++ b/content/tw/docs/2.for-users/3.features/share-form.md @@ -7,7 +7,9 @@ ## 查詢參數 :::tip + 所有參數均為**可選**參數，非必要參數。 + ::: | 名稱 | 說明 | @@ -46,7 +48,9 @@ | `visibleAccts` | 目標使用者 [acct](../resources/glossary/#acct)（逗號分隔） | :::warning + 如果為 `visibility` 指定了 `specified`，則也必須指定 `visibleUserIds` 或 `visibleAccts`。 + ::: ### 附加檔案 diff --git a/content/tw/docs/2.for-users/3.features/thread-mute.md b/content/tw/docs/2.for-users/3.features/thread-mute.md index f775c2a4..eeb034a2 100644 --- a/content/tw/docs/2.for-users/3.features/thread-mute.md +++ b/content/tw/docs/2.for-users/3.features/thread-mute.md @@ -1,7 +1,9 @@ # 將貼文串設為靜音 :::tip + 從 v12.95.0 新增的功能。 + ::: 貼文串靜音將指定貼文整串靜音。貼文串是指從起始貼文開始連接的所有回覆。 @@ -11,5 +13,7 @@ 若要將 Misskey Web 上的貼文串靜音，請開啟屬於貼文串該的任何貼文或起始貼文的選單，然後選擇「將貼文串設為靜音」。 :::warning + 無論您將貼文串的哪個貼文靜音，整個貼文串都會靜音。 + ::: diff --git a/content/tw/docs/2.for-users/3.features/webhook.md b/content/tw/docs/2.for-users/3.features/webhook.md index b32bdf6f..74200662 100644 --- a/content/tw/docs/2.for-users/3.features/webhook.md +++ b/content/tw/docs/2.for-users/3.features/webhook.md @@ -1,11 +1,15 @@ # Webhook :::tip + 從 v12.109.0 新增的功能。 + ::: :::warning + 由於這是一項試驗性功能，因此可能不穩定，或者將來規格可能會發生變化。 + ::: Misskey 提供了 Webhook。使用 Webhook，您可以即時接收 Misskey 上的各種事件。 diff --git a/content/tw/docs/2.for-users/4.resources/1.troubleshooting.md b/content/tw/docs/2.for-users/4.resources/1.troubleshooting.md index d3ef1585..f9b4d860 100644 --- a/content/tw/docs/2.for-users/4.resources/1.troubleshooting.md +++ b/content/tw/docs/2.for-users/4.resources/1.troubleshooting.md @@ -5,7 +5,9 @@ description: 如果您遇到問題，請先檢查此處。 # 故障排除 :::tip + 也請參考[常見問題](./faq.md)。 + ::: 如果您遇到問題，請先檢查此處。 @@ -59,7 +61,9 @@ description: 如果您遇到問題，請先檢查此處。 可以透過客戶端設定中的「清除快取資料」來修復此問題。 :::warning + 是清除「客戶端」的快取。請不要清除「瀏覽器」的快取。 + ::: ## 閃爍的通知、天線等不會消失 diff --git a/content/tw/docs/2.for-users/4.resources/donate.md b/content/tw/docs/2.for-users/4.resources/donate.md index b5353172..2cdb8c28 100644 --- a/content/tw/docs/2.for-users/4.resources/donate.md +++ b/content/tw/docs/2.for-users/4.resources/donate.md @@ -13,20 +13,27 @@ Misskey不是一家企業，由於它是免費使用的，開發者所能獲得 - [亞馬遜的願望清單](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip + 如果您的捐款金額較大（例如5萬日圓以上），使用PayPal等方式會被抽取高額手續費，因此請考慮使用Kyash或聯絡我們，我們將為您提供銀行帳戶資訊。 + ::: :::tip + 額に応じて以下の返礼を用意しています。 - 1,000日圓以上: 將mi徽章附加到您的misskey.io帳戶上 - 3,000日圓以上: ↑ + 在Misskey的捐款芳名錄上記載您的名字 - 10,000日圓以上: ↑ + 在Misskey的捐款芳名錄上記載您的名字 + 任意圖示 - ::: + +::: :::warning + **由於徽章的分配和列入捐款芳名錄不是自動的，請將您的申請發送至 @syuilo\@misskey.io ，並提供您已捐款的資訊。** + (如果您沒有收到回覆，請多次提及我，因為我可能沒有注意到您的提及。此外，您可能無法從 misskey.io 以外的伺服器收到訊息。) + ::: 此外，伺服器的運營者基本上不能賺錢。由於運營伺服器需要成本，請考慮支援運營者。 diff --git a/content/tw/docs/2.for-users/4.resources/misskey-hub.md b/content/tw/docs/2.for-users/4.resources/misskey-hub.md index f5d8939c..01018dec 100644 --- a/content/tw/docs/2.for-users/4.resources/misskey-hub.md +++ b/content/tw/docs/2.for-users/4.resources/misskey-hub.md @@ -6,7 +6,9 @@ Misskey Hub 是 Misskey 的官方網站，提供有關 Misskey 的知識和其 歡迎提供更多文件和翻譯。Misskey Hub 也是[開放原始碼](https://github.com/misskey-dev/misskey-hub) :::tip + Misskey Hub 是使用 Nuxt 建置的靜態網站。 + ::: ## 為 Misskey Hub 做出貢獻 diff --git a/content/tw/docs/3.for-admin/features/announcement.md b/content/tw/docs/3.for-admin/features/announcement.md index d79e2ecc..da116889 100644 --- a/content/tw/docs/3.for-admin/features/announcement.md +++ b/content/tw/docs/3.for-admin/features/announcement.md @@ -5,12 +5,14 @@ 透過公告功能，使用者可以發布伺服器範圍內的公告，也可以從伺服器發送訊息給單一使用者。 :::warning + アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。 - 建立公告時啟用「僅限既有的使用者」選項 - 建立公告時啟用「不發送通知」選項 - 將已到期的公告封存 - ::: + +::: ## 顯示樣式 diff --git a/content/tw/docs/3.for-admin/features/role.md b/content/tw/docs/3.for-admin/features/role.md index f355dd5b..7780f2ec 100644 --- a/content/tw/docs/3.for-admin/features/role.md +++ b/content/tw/docs/3.for-admin/features/role.md @@ -21,11 +21,13 @@ - **有條件的** ... 您可以設定條件，滿足條件的使用者將自動包含在內。（條件角色） :::warning + コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 - 無法手動指派/取消指派。 可以執行基本的審查操作。 它也不能在基本角色中設定。 - 無法檢索指定條件角色中包含的使用者清單。 - ::: + +::: ## 權限 @@ -53,6 +55,7 @@ **如果優先權相同，則預設選擇最大或最權威的值。** :::tip + 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 - 如果優先權相同而角色 A 的雲端硬碟容量政策優先權較高，則使用500MB的值。 @@ -61,8 +64,9 @@ 此外，如果為使用者指派了角色 C 和角色 D，並且角色 C 的公開發布政策定義為「否」，而角色 D 的公開發布政策定義為「是」的情況 - 如果優先順序相同而角色 D 中公開發布政策的優先順序較高，則採用「是」。 -- 如果角色 C 的公開發布政策的優先順序較高，則採用「否」。 - ::: +- ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 + +::: ### 使用基本角色的值 @@ -85,11 +89,15 @@ 指派時，可以設定指派的期間。 :::tip + 角色指派/取消指派可能需要一些時間才能反映出來。 + ::: :::warning + 無法手動指派條件角色。 + ::: ## 檢查使用者政策 diff --git a/content/tw/docs/3.for-admin/install/guides/1.index.md b/content/tw/docs/3.for-admin/install/guides/1.index.md index 9282cb95..230aea6b 100644 --- a/content/tw/docs/3.for-admin/install/guides/1.index.md +++ b/content/tw/docs/3.for-admin/install/guides/1.index.md @@ -7,15 +7,19 @@ description: 有關如何建立 Misskey 伺服器的指南。 感謝您對 Misskey 伺服器的建置表達興趣。建立伺服器有幾種方法，請選擇以下一種並閱讀指南。 :::danger -一旦開始使用，請勿使用伺服器的網域名稱/主機名稱重新建立資料庫！ + +一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::warning + 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 Misskey 的原始碼已經被壓縮，這不僅是無意義的，而且由於 Cloudflare 無法解析最新的 JavaScript 並破壞內部原始碼，導致 Misskey 無法正常運作。 詳情請參閱 [misskey-dev/misskey #9791](https://github.com/misskey-dev/misskey/issues/9791)。 + ::: ## 安裝在 Xserver VPS 上 diff --git a/content/tw/docs/3.for-admin/install/guides/bash.md b/content/tw/docs/3.for-admin/install/guides/bash.md index 24768666..6db85fa0 100644 --- a/content/tw/docs/3.for-admin/install/guides/bash.md +++ b/content/tw/docs/3.for-admin/install/guides/bash.md @@ -20,7 +20,9 @@ 3. Cloudflareアカウント（推奨） :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。 @@ -28,7 +30,6 @@ Let's Encryptの認証を試行できる回数が少ないので、サーバー ## Cloudflareの設定 Cloudflareを使う場合、Cloudflareのドメインの設定を完了してからインストールを開始するようにしてください。\ -\ ネームサーバーの適用には最大で3日程度かかる場合があります。 また、nginxとCloudflareを設定する場合、Cloudflareの設定画面にて、 @@ -41,7 +42,6 @@ Cloudflareを使う場合、Cloudflareのドメインの設定を完了してか ### 1. SSH サーバーにSSH接続します。\ -\ （サーバーのデスクトップを開いている方はシェルを開きましょう。） ### 2. 環境を最新にする @@ -113,13 +113,10 @@ iptablesを使うようにしてください。 v1から、インストールメソッドにsystemdとDockerとを選べるようにしました。 Dockerと言っても、**MisskeyだけをDockerで実行**し、RedisやPostgresなどはホストで直接実行します。\ -\ [docker-composeですべての機能を動かす方法については、mamemonongaさんが作成したこちらの記事がおすすめです。](https://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0) Docker Hubイメージを使う設定であれば、Misskeyのビルドが不要になるため、**一番お勧めです**。\ -\ ただし、マイグレーションは必要なので、アップデート時にMisskeyを使えない時間がゼロになるわけではありません。\ -\ また、Misskeyのビルド環境を準備しない(git pullしない)ので、フォークを動かしたくなった時に設定が面倒になります。 ローカルでDockerをビルドする方式は、パフォーマンス面で非推奨です。 @@ -147,14 +144,12 @@ systemdは、Docker Hubにイメージを上げるまでもないものの、フ 万が一途中で失敗してもう一度スクリプトを動作させる場合、次のことに注意してください。 - RedisやPostgresのインストールが終わっている場合、「install locally」はNoにしてください。\ - \ host・port設定はそのままEnterを押します。 ユーザー名やパスワードは、前回実行した際に指定したものを入力します。 ## .envファイルについて インストールスクリプトは、2つの.envファイルを作成します。\ -\ アップデートの際に使用します。 ### /root/.misskey.env @@ -165,14 +160,12 @@ misskeyを実行するユーザーを覚えておくために必要です。 systemdの場合に生成されます。\ \ -主にディレクトリを覚えておくのに使用します。 +実行されているコンテナとイメージの番号を保存しています。 ### /home/(misskeyユーザー)/.misskey-docker.env Dockerの場合に生成されます。\ -\ 実行されているコンテナとイメージの番号を保存しています。\ -\ コンテナの番号はアップデートの際に更新されます。古いイメージは削除されます。 ## 自分で管理する @@ -184,7 +177,6 @@ Dockerの場合に生成されます。\ ### Misskeyディレクトリ Misskeyのソースは`/home/ユーザー/ディレクトリ`としてcloneされます。\ -\ （ユーザー、ディレクトリの初期値はともにmisskeyです。） Misskeyディレクトリへは、以下のように移動するとよいでしょう。 @@ -203,7 +195,6 @@ exit ### systemd systemdのプロセス名はexample.comです。\ -\ たとえば再起動するには次のようにします。 ``` @@ -259,7 +250,6 @@ requirepassとbindを`/etc/redis/misskey.conf`で設定しています。 ## Q. アップデート後に502でアクセスできない Dockerでは、起動後にマイグレーションをするため、すぐにアクセスできません。\ -\ マイグレーションが終わっているかどうか確認してみてください。 systemdの場合では、pnpm installに失敗している可能性があります。 @@ -275,5 +265,4 @@ journalctlでログを確認すると、たいていre2が云々という記述 ## Q. 同じサーバーにもう1つMisskeyを建てたい スクリプトは同じサーバーに追加でMisskeyをインストールすることは想定していません。\ -\ 幾つかの設定が上書きされるか、途中でエラーになってしまうでしょう。 diff --git a/content/tw/docs/3.for-admin/install/guides/docker.md b/content/tw/docs/3.for-admin/install/guides/docker.md index 08c66a86..c5b8f8e7 100644 --- a/content/tw/docs/3.for-admin/install/guides/docker.md +++ b/content/tw/docs/3.for-admin/install/guides/docker.md @@ -7,15 +7,18 @@ description: 本指南介紹如何使用 Docker 安裝設置 Misskey。 本指南介紹如何使用 Docker Compose 安裝設置 Misskey。 :::danger -一旦開始使用，請勿使用伺服器的網域名稱/主機名稱重新建立資料庫！ + +一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::tip{label='前提条件'} -- 必須安裝 Docker 和 Docker Compose。 - ::: +- DockerおよびDocker Composeがインストールされていること。 -## 取得 Misskey 原始碼 +::: + +## 設定 ```sh git clone -b master https://github.com/misskey-dev/misskey.git @@ -25,30 +28,30 @@ git checkout master ## 設定 -使用以下命令複製各種設定檔的範例。 +下記コマンドで、各種設定ファイルのサンプルをコピーします。 ```sh cp .config/docker_example.yml .config/default.yml cp .config/docker_example.env .config/docker.env -cp ./docker-compose.yml.example ./docker-compose.yml +cp ./docker-compose_example.yml ./docker-compose.yml ``` -按照檔案中的說明編輯 `default.yml` 和 `docker.env`。\ -如有必要，也可編輯 `docker-compose.yml`。（例如，如果您想更改連接埠） +`default.yml`と`docker.env`をファイル内の説明に従って編集してください。\ +また、必要に応じて、`docker-compose.yml`を編集します。(ポートを変更したい場合など) -## 建構和初始化 +## ビルドと初期化 -使用以下命令建構 Misskey 並初始化資料庫。 -這需要一些時間。 +次のコマンドでMisskeyのビルドとデータベースの初期化を行います。 +これにはしばらく時間がかかります。 ```shell sudo docker compose build sudo docker compose run --rm web pnpm run init ``` -## 啟動 +## 起動 -辛苦了。可以使用以下指令啟動 Misskey。 +お疲れ様でした。以下のコマンドでMisskeyを起動できます。 ```sh sudo docker compose up -d @@ -56,10 +59,12 @@ sudo docker compose up -d GLHF✨ -## 如何更新Miskey +## Misskeyのアップデート方法 :::warning -在進行更新時，請務必確認[變更日誌](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)，預先了解變更和可能需要的作業（通常不需要）。 + +アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 + ::: ```sh @@ -72,9 +77,9 @@ sudo docker compose build sudo docker compose stop && sudo docker compose up -d ``` -根據更新內容和資料庫大小，可能需要一些時間。 +アップデート内容、およびデータベースの規模によっては時間がかかることがあります。 -## 如何執行 cli 命令 +## cliコマンドを実行する方法 ```sh sudo docker compose run --rm web node packages/backend/built/tools/foo bar diff --git a/content/tw/docs/3.for-admin/install/guides/kubernetes.md b/content/tw/docs/3.for-admin/install/guides/kubernetes.md index 1c900bd8..7a35ec0e 100644 --- a/content/tw/docs/3.for-admin/install/guides/kubernetes.md +++ b/content/tw/docs/3.for-admin/install/guides/kubernetes.md @@ -3,14 +3,16 @@ 本指南說明如何使用 Kubernetes 和 HelmChart 設定 Misskey。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: ## TrueCharts と TrueNAS Scale MisskeyのHelmChartsはTrueNAS Scaleで使用するためのTrueChartsで公開されていますが、HelmChartsとしてインストールすることもできます。 -[TrueCharts](https://truecharts.org/charts/description_list) のサイトには利用可能なすべてのChartsやインストール方法などのドキュメントがあります。 +現在、Misskeyは_incubator_ trainで進行中です。 また、不明な点があればTrueChartsの[Discord](https://discord.gg/Ax9ZgzKx9t)サーバーで質問をすることもできます。 diff --git a/content/tw/docs/3.for-admin/install/guides/manual.md b/content/tw/docs/3.for-admin/install/guides/manual.md index 8b7fff6d..bc3f5ec5 100644 --- a/content/tw/docs/3.for-admin/install/guides/manual.md +++ b/content/tw/docs/3.for-admin/install/guides/manual.md @@ -7,21 +7,23 @@ description: 本指南介紹如何安裝和設定 Misskey。 本指南介紹如何安裝和設定 Misskey。 :::danger -一旦開始使用伺服器，切勿更改伺服器的網域名稱/主機名稱！ + +一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ + ::: :::tip{label='前提条件'} -#### 必須安裝並設定以下軟體 +#### 以下のソフトウェアがインストール・設定されていること - **[Node.js](https://nodejs.org/en/)** (20.4.x以上) - **[PostgreSQL](https://www.postgresql.org/)** (15以上) - **[Redis](https://redis.io/)** - **[FFmpeg](https://www.ffmpeg.org/)** -如果您使用 Debian/Ubuntu，最好安裝 `build-essential` 軟體包。 +Debian/Ubuntuをお使いであれば、`build-essential`パッケージをインストールしておくと良いです。 -#### 必須啟用 corepack +#### corepackが有効化されていること ```sh sudo corepack enable @@ -29,16 +31,10 @@ sudo corepack enable ::: -## 建立使用者 +## ユーザーの作成 -Misskey 不應以 root 使用者身分執行，因此應建立使用者。 -Debian 範例： - -```sh -adduser --disabled-password --disabled-login misskey -``` - -## 安裝 Misskey +Misskeyはrootユーザーで実行しない方がよいため、代わりにユーザーを作成します。 +Debianの例: ```sh sudo -iu misskey @@ -51,42 +47,54 @@ NODE_ENV=production pnpm install --frozen-lockfile ## 設定 -複製設定範例 `.config/example.yml`，並將其重新命名為 `default.yml`。 +```sh +sudo -iu misskey +git clone --recursive https://github.com/misskey-dev/misskey.git +cd misskey +git checkout master +git submodule update --init +NODE_ENV=production pnpm install --frozen-lockfile +``` + +## 設定 + +根據檔案中的說明編輯 `default.yml`。 ```sh cp .config/example.yml .config/default.yml ``` -根據檔案中的說明編輯 `default.yml`。 - -## 建構和初始化 - 以下命令將建構 Misskey 並初始化資料庫。 這需要一些時間。 +## ビルドと初期化 + +次のコマンドでMisskeyのビルドとデータベースの初期化を行います。 +これにはしばらく時間がかかります。 + ```sh NODE_ENV=production pnpm run build pnpm run init ``` -## 啟動 +## 起動 -您做到了！可以使用以下指令啟動 Misskey。 +お疲れ様でした。以下のコマンドでMisskeyを起動できます。 ```sh NODE_ENV=production pnpm run start ``` -GLHF✨ - -::::g-details{summary="systemdを用いた管理"} - 建立 systemd 服務檔案 `/etc/systemd/system/misskey.service` 在編輯器中打開它，貼上下面的代碼並儲存： +`/etc/systemd/system/misskey.service` + +エディタで開き、以下のコードを貼り付けて保存: + ```ini [Unit] Description=Misskey daemon @@ -108,35 +116,41 @@ WantedBy=multi-user.target ``` :::warning -如果你想在 CentOS 上讓 Misskey 使用的連接埠低於 1024，需要將其更改為 `ExecStart=/usr/bin/sudo /usr/bin/npm start`。 + +啟動misskey服務 + ::: -重新載入 systemd 並啟用 misskey 服務。 +systemdを再読み込みしmisskeyサービスを有効化 ```sh sudo systemctl daemon-reload sudo systemctl enable misskey ``` -啟動misskey服務 +misskeyサービスの起動 ```sh sudo systemctl start misskey ``` :::tip -鍵入 `systemctl status misskey` 查看服務狀態。 + +`systemctl status misskey`と入力すると、サービスの状態を調べることができます。 + ::: -:::: +更新完成後，請重新啟動 Misskey 服務。 -## 如何更新Miskey +## Misskeyのアップデート方法 :::warning -更新前請務必查看[版本說明](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)，以便提前了解所做的更改以及是否需要額外工作（大多數情況下不需要）。 + +アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 + ::: -拉回 master，安裝、建置和遷移資料庫： +masterをpullし直し、インストール、ビルド、データベースのマイグレーションを行います: ```sh git checkout master @@ -147,17 +161,19 @@ NODE_ENV=production pnpm run build pnpm run migrate ``` -根據更新內容和資料庫大小，可能需要一些時間。 +アップデート内容、およびデータベースの規模によっては時間がかかることがあります。 -更新完成後，請重新啟動 Misskey 服務。 +アップデートが終わり次第、Misskeyプロセスを再起動してください。 ```sh sudo systemctl restart misskey ``` :::tip + ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: - `pnpm run clean` 或 `pnpm run clean-all` - `pnpm rebuild` - ::: + +::: diff --git a/content/tw/docs/3.for-admin/install/guides/ubuntu-manual.md b/content/tw/docs/3.for-admin/install/guides/ubuntu-manual.md index 1c1c41a4..514f57c2 100644 --- a/content/tw/docs/3.for-admin/install/guides/ubuntu-manual.md +++ b/content/tw/docs/3.for-admin/install/guides/ubuntu-manual.md @@ -11,11 +11,15 @@ [**シェルスクリプトの詳細と使用方法はこちらから！**](./bash/) :::tip + シェルスクリプトでの開発環境へのインストールは想定されていません。 + ::: :::tip + ドメインの購入とCloudflareのセットアップ、サーバーの確保についてはご自身でご準備ください。 + ::: 不具合があれば[ @aqz@p1.a9z.dev へのメンション](https://p1.a9z.dev/@aqz)にてお知らせいただければと思います。 @@ -27,7 +31,9 @@ [docker-compose](./docker/)なら、手作業でももうちょっと簡単に実行できるはずです。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: ## はじめに @@ -52,7 +58,9 @@ OSの違い、Misskey本体や依存するソフトウェアのバージョン - ここではドメインをexample.tldとして解説を進めるので、自分が買ったドメインに適宜置き換えて読むこと。開発環境の場合はlocalhostと読み替えます（設定ファイルの項で別途説明） :::danger + 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ + ::: ## nanoの使い方 @@ -78,7 +86,9 @@ sudo adduser --disabled-password --disabled-login misskey ``` :::tip + 開発環境の場合はユーザーを分ける必要はありません + ::: ## 基本的なソフトウェアのインストールと設定 @@ -174,10 +184,12 @@ activeならOK。 ### nginx -nginxは、主としてリバースプロキシに用いられるWebサーバーソフトである。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。 +http\://localhost にアクセスし、\*Welcome to nginx!\*と表示されればOK。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。 :::tip + 開発環境の場合はnginxのセットアップは不要です + ::: nginx.orgのドキュメント http\://nginx.org/en/linux_packages.html#Ubuntu に従ってインストールする。 @@ -238,7 +250,9 @@ sudo apt install -y git build-essential サーバーをインターネットに公開する準備をする。 :::tip + 開発環境の場合はファイヤーウォールやCloudFlare、Certbotの設定は不要です + ::: ### ファイヤーウォール @@ -272,7 +286,9 @@ sudo systemctl enable ufw ``` :::tip + ufwは、netfilter(iptables)を人間が操作しやすいようにするアプリだ。インストールスクリプトは、OCI環境ではnetfilterを直接操作する。 + ::: ### CloudFlare @@ -376,7 +392,9 @@ nano .config/default.yml 設定できる値と記述方法は[.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)に書かれている。 :::tip + 開発環境の場合、urlは`url: http://localhost:3000`と指定します。 + ::: ```yml @@ -469,7 +487,9 @@ NODE_ENV=production pnpm run build ``` :::tip + 開発環境の場合、`NODE_ENV=production`は不要です。以降のコマンドでも同様に削除してください。 + ::: ### サーバーでビルドできない場合 @@ -515,7 +535,9 @@ CloudFlareのDNS設定が正しいIPアドレスになっているかもう一 ## Misskeyのデーモンを作成 :::tip + 開発環境の場合、デーモンの作成は不要です。 + ::: いったんCtrl+Cでプロセスをキルし、Misskeyをデーモンで起動する設定をしよう。 diff --git a/content/tw/docs/3.for-admin/install/resources/cdn.md b/content/tw/docs/3.for-admin/install/resources/cdn.md index 4a40322d..65c265eb 100644 --- a/content/tw/docs/3.for-admin/install/resources/cdn.md +++ b/content/tw/docs/3.for-admin/install/resources/cdn.md @@ -17,5 +17,7 @@ Misskey Web 是完全靜態的，不需要伺服器來運作。因此整個 Miss - 除 `/api/*` 以外的網址全部進行快取 :::tip -更新 Misskey 時無需清除快取。 + +Misskeyをアップデートした際にキャッシュのクリアは不要です。 + ::: diff --git a/content/tw/docs/3.for-admin/install/resources/troubleshooting.md b/content/tw/docs/3.for-admin/install/resources/troubleshooting.md index 3391233a..21435e13 100644 --- a/content/tw/docs/3.for-admin/install/resources/troubleshooting.md +++ b/content/tw/docs/3.for-admin/install/resources/troubleshooting.md @@ -248,6 +248,10 @@ Amazon S3に互換性のあるオブジェクトストレージであれば利 各サービス/ソフトウェアのドキュメントをよく読み、設定してみてください。 +### ローディングが終わらない + +Cloudflare を使用している場合は、Rocket LoaderやAuto Minifyが有効になっていないか確認してください。有効になっている場合は無効にすることで解決する場合があります。 + *** # まったく解決しなかった場合 diff --git a/content/tw/docs/3.for-admin/moderation-tips/disable-timelines.md b/content/tw/docs/3.for-admin/moderation-tips/disable-timelines.md index 48fd2be1..97bd681c 100644 --- a/content/tw/docs/3.for-admin/moderation-tips/disable-timelines.md +++ b/content/tw/docs/3.for-admin/moderation-tips/disable-timelines.md @@ -8,7 +8,9 @@ LTL 和 STL 的優點在於，新用戶無需搜尋用戶，因為他們可以 如果您認為弊大於利，請考慮停用這些時間軸。 :::warning -停用可能會使用戶感到困惑，並在短期內減少用戶數量。因此，建議仔細考慮禁用的影響，並留出一定的時間提前解釋和安排後續工作。 + +無効化を行うと、ユーザーが困惑し、短期的に見て利用者が減る可能性があります。そのため、無効化の際は影響を慎重に検討し、事前に説明してフォローを整える期間を一定程度設けることを推奨します。 + ::: -請注意，這些時間軸的停用狀態不適用於管理員/審查員，他們可以繼續使用這些時間軸。 +なお、管理者/モデレーターは、これらのタイムラインの無効化状態は適用されず、引き続き利用することが可能です。 diff --git a/content/tw/docs/4.for-developers/aiscript.md b/content/tw/docs/4.for-developers/aiscript.md new file mode 100644 index 00000000..2c7c5860 --- /dev/null +++ b/content/tw/docs/4.for-developers/aiscript.md @@ -0,0 +1,67 @@ +# AiScript + +AiScriptは、Misskeyの以下の箇所で使用できるスクリプト言語です。 + +- [プラグイン](./plugin/) +- [ウィジェット](/docs/for-users/features/widgets/) + - ボタン + - AiScriptコンソール + - AiScript App +- Misskey Play +- スクラッチパッド + +:::tip + +AiScriptの実装はMisskeyとは別リポジトリで、[オープンソースで公開されています](https://github.com/aiscript-dev/aiscript)。 + +::: + +## 使い方 + +AiScript標準の構文や組み込み関数などが使用できます。 + +:::tip + +ドキュメントは[こちら](https://github.com/aiscript-dev/aiscript/tree/master/docs)\ +Misskey本体のバージョンにより、使用できるAiScriptのバージョンが異なる場合があります。バージョンの確認には`<: Core:v`をScratchpadなどで実行してください。 + +::: + +これらに加え、Misskey専用の組み込み定数・関数が３グループに分けて提供されています。 + +### Misskey AiScript API + +接頭辞: `Mk:`\ +Misskey内の全てのAiScript環境で使用できる定関数群です。 +詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Mk:`とついた部分を参照して下さい。 + +### プラグインAPI + +接頭辞: `Plugin:`\ +[プラグイン](./plugin/)でのみ使用できる定関数群です。 +詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Plugin:`とついた部分を参照して下さい。 + +### UI API + +接頭辞: `Ui:`\ +[ウィジェット](/docs/for-users/features/widgets/)（AiScript App）、Misskey Play、Scratchpadで使用できます。 +ドキュメントは未整備（TODO）ですが、インターネット上に有志の方が執筆された解説記事があります。 + +### 標準入出力 + +AiScript標準で定義されている`readline`関数と`print`関数（および`<:`構文）の内部実装は、Misskey側で独自に提供されています。 + +#### readline(message) + +`message`: `str`\ +返り値: `str`\ +Misskey内の全てのAiScript環境で使用できます。\ +文字列の入力を求めるポップアップを表示します。 + +#### print(message) + +`message`: `any`\ +返り値: `null`\ +[ウィジェット](/docs/for-users/features/widgets/)（AiScriptコンソール）、Scratchpadで使用できます。\ +コンソールに文字列を出力します。\ +`<:`構文も同様の働きをします。 diff --git a/content/tw/docs/4.for-developers/api/1.index.md b/content/tw/docs/4.for-developers/api/1.index.md index 50b3206a..590a01c1 100644 --- a/content/tw/docs/4.for-developers/api/1.index.md +++ b/content/tw/docs/4.for-developers/api/1.index.md @@ -8,7 +8,9 @@ Misskey已經公開了API。使用API，您可以開發Misskey客戶端、整合 由於還有資料流API，因此您還可以創建具有即時性的應用程序。 :::tip -透過使用Misskey官方SDK或第三方函式庫，您可以簡化本文中所述的一些步驟，更方便地使用API​​。\ + +Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\\ + ::: diff --git a/content/tw/docs/4.for-developers/api/libraries.md b/content/tw/docs/4.for-developers/api/libraries.md index 2091d23f..b5fc4cfa 100644 --- a/content/tw/docs/4.for-developers/api/libraries.md +++ b/content/tw/docs/4.for-developers/api/libraries.md @@ -15,6 +15,8 @@ description: 與 Misskey API 相關的函式庫列表 ## Python - [Misskey.py](https://github.com/YuzuRyo61/Misskey.py) +- [MiPA](https://github.com/yupix/MiPA) +- [MiPAC](https://github.com/yupix/MiPAC) ## .Net diff --git a/content/tw/docs/4.for-developers/api/permission.md b/content/tw/docs/4.for-developers/api/permission.md index 484b68da..9db3a981 100644 --- a/content/tw/docs/4.for-developers/api/permission.md +++ b/content/tw/docs/4.for-developers/api/permission.md @@ -5,7 +5,9 @@ description: 應用程式所需的權限一覽 # 權限列表 :::tip -本頁由 [misskey-js](https://github.com/misskey-dev/misskey/tree/develop/packages/misskey-js) 自動生成，因此文件和翻譯可能不完整。 + +このページは[misskey-js](https://github.com/misskey-dev/misskey/tree/develop/packages/misskey-js)から自動生成しているため、ドキュメントや翻訳が不完全な場合があります。 + ::: diff --git a/content/tw/docs/4.for-developers/api/streaming/1.index.md b/content/tw/docs/4.for-developers/api/streaming/1.index.md index af767dfc..6ce5b5bc 100644 --- a/content/tw/docs/4.for-developers/api/streaming/1.index.md +++ b/content/tw/docs/4.for-developers/api/streaming/1.index.md @@ -5,7 +5,9 @@ description: ストリーミングAPIを使うと、リアルタイムで様々 # ストリーミングAPI :::tip + 最初に[Misskey API](../index.md)のドキュメントを読むことをお勧めします。 + ::: ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、リアクションされた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。 @@ -26,7 +28,9 @@ wss://{host}/streaming?i={token} - `{token}`の部分は、ユーザーのアクセストークンに置き換えます。 :::tip + アクセストークンは省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。 + ::: ストリームに接続すると、後述投稿の購読を行ったりすることができますが、まだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。 @@ -40,7 +44,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。 :::tip + ひとつのストリーム接続上で、同時に複数のチャンネルに接続することができます。 + ::: 以下では、チャンネルの使用方法を説明します。どのようなチャンネルがあるかは、[チャンネル一覧](./channel/index.md)を参照してください。 @@ -69,7 +75,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり - `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。 :::tip + IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。 + ::: ### チャンネルからのメッセージを受け取る diff --git a/content/tw/docs/4.for-developers/api/token.md b/content/tw/docs/4.for-developers/api/token.md index 69160dba..33030a30 100644 --- a/content/tw/docs/4.for-developers/api/token.md +++ b/content/tw/docs/4.for-developers/api/token.md @@ -7,7 +7,9 @@ 存取權杖是與用戶關聯的身份驗證資料，用於識別使用API的用戶，同時管理每個存取權杖具有什麼樣的操作權限。 :::tip + 使用者和與該使用者關聯的存取權杖之間存在一對多關係，並且可以向​​使用者發行多個存取權杖。 + ::: 你可以輕鬆地獲得自己的存取權杖，也可以獲取使用你的應用程序的不特定用戶的存取權杖。 @@ -20,7 +22,9 @@ 您可以在 Misskey Web 的「設定 > API」中發行自己的存取權杖。 :::danger + 請不要與他人分享您的存取權杖。 + ::: ### 請求應用程式使用者發行存取權杖 @@ -32,6 +36,7 @@ 下面描述的方法稱為 MiAuth，它無需創建應用程式即可立即發行存取權杖。 [還有一種獲取存取權杖的方法是使用應用程式建立方法（舊方法）。](./app) + ::: #### 步驟1 @@ -39,7 +44,9 @@ 產生 UUID。從現在起，這將被稱為**工作階段ID**。 :::danger + 此工作階段 ID 應每次生成，不應重複使用。 + ::: #### 步驟2 @@ -119,7 +126,9 @@ https://{host}/api/miauth/{session}/check 有關 API 的更多資訊，請參閱 API 參考。 :::warning + Misskey 不使用 REST。 + ::: 此外，Misskey 不僅提供 HTTP API，還提供資料流 API。有關資料流 API 的詳細資訊，請參閱[此文件](./streaming/index.md)。 diff --git a/content/tw/docs/4.for-developers/api/token/1.index.md b/content/tw/docs/4.for-developers/api/token/1.index.md new file mode 100644 index 00000000..3305efc0 --- /dev/null +++ b/content/tw/docs/4.for-developers/api/token/1.index.md @@ -0,0 +1,88 @@ +# アクセストークンの取得 + +APIを使い始めるには、APIを利用するアカウントに紐づいた**アクセストークン**を取得する必要があります。 +このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。 + +基本的に、APIはリクエストにはアクセストークンが必要となります。 +アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 + +:::tip + +ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 + +::: + +あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 + +- 前者の場合: **「自分自身のアクセストークンを手動発行する」** に進む +- 後者の場合: **「アプリケーション利用者にアクセストークンの発行をリクエストする」** に進む + +## 自分自身のアクセストークンを手動発行する + +Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 + +:::danger + +アクセストークンは他人に知られないようにしてください。 + +::: + +## アプリケーション利用者にアクセストークンの発行をリクエストする + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の方法の一つを使います。 + +:MkIndex + +## APIの利用 + +アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。 + +:::tip + +- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。 +- 要求ヘッダーに`Content-Type: application/json`を指定します。 +- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。 +- ベースURLは`https://{サーバーのドメイン}/api`です。 + +::: + +### Authorization headerを使う方式 + +以下のようにヘッダーの`Authorization`フィールドを指定します。 + +```js +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + text: "Hello Misskey API World with My Application!" + }), + headers: { + Authorization: `Bearer ${accessToken}`, + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` + +### iを使う方式 + +アクセストークン付きのボディの例（metaの場合）: + +```json +{ + "i": "HogEFugA1341", + "detail": false +} +``` + + + +APIの詳細は、APIリファレンスを参照してください。 + +:::warning + +MisskeyはRESTを採用していません。 + +::: + +また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](../streaming/)を参照してください。 diff --git a/content/tw/docs/4.for-developers/api/token/2.miauth.md b/content/tw/docs/4.for-developers/api/token/2.miauth.md new file mode 100644 index 00000000..9cfe21cb --- /dev/null +++ b/content/tw/docs/4.for-developers/api/token/2.miauth.md @@ -0,0 +1,76 @@ +--- +description: v12.27.0以降で使用できる、Misskey独自の簡素な認証方法について説明しています。 +--- + +# MiAuth方式でのアクセストークン取得方式 + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 + +:::tip + +以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 + +- [よりおおく使われているOAuth方式でのアクセストークン取得方法もあります。](./oauth.md) +- [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app.md) + +::: + +## Step 1 + +UUIDを生成する。以後これを**セッションID**と呼びます。 + +:::danger + +このセッションIDは毎回生成し、使いまわさないようにしてください。 + +::: + +## Step 2 + +アプリケーション認証フォームをユーザーのブラウザで表示させる。認証フォームは、以下の形式のURLで開くことができます: + +``` +https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive +``` + +ここで、 + +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 +- `{session}`の部分は、セッションIDに置き換えます。 + +使用者授予應用程式存取權限後，向下列格式的網址傳送 POST 請求，將傳回一個包含存取權杖的 JSON 作為回應。 + +| 名前 | 説明 | +| ------------ | ------------------------------------------------------------------------------ | +| `name` | アプリケーション名。 | +| `icon` | アプリケーションのアイコン画像URL。 | +| `callback` | 認証が終わった後にリダイレクトするURL。
リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 | +| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 | + +:::tip{label='例'} + +``` +https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive +``` + +::: + +## Step 3 + +ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 + +``` +https://{host}/api/miauth/{session}/check +``` + +ここで、 + +- 所有 HTTP API 均為 POST，請求和回應均為 JSON 格式（drive/files/create 除外）。 +- 在請求標頭中指定 `Content-Type: application/json`。 + +レスポンスに含まれるプロパティは以下の通りです: + +| 名前 | 説明 | +| ------- | -------------- | +| `token` | ユーザーのアクセストークン。 | +| `user` | ユーザーの情報。 | diff --git a/content/tw/docs/4.for-developers/api/token/3.oauth.md b/content/tw/docs/4.for-developers/api/token/3.oauth.md new file mode 100644 index 00000000..a29644ab --- /dev/null +++ b/content/tw/docs/4.for-developers/api/token/3.oauth.md @@ -0,0 +1,179 @@ +--- +description: v2023.9.0以降で使用できる、OAuth2.0方式での認証方法について説明しています。 +--- + +# OAuth方式でのアクセストークン取得方式 + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 + +:::tip + +以下に説明する方法は、[OAuth 2.0](https://datatracker.ietf.org/doc/html/rfc6749.html)と呼ばれるものです。普通のOAuthはアプリを作成しますが、[IndieAuth](https://indieauth.spec.indieweb.org/)の拡張でアプリ作成なしで使えるようになっています。 + +OAuth方式は使えるライブラリが多いので、出来ればライブラリを使うのをおすすめします。 + +現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。 + +- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md) +- [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md) + +::: + +## Step 1 + +アプリ紹介のためのウェブページを作ります。ページがHTTPSアドレスでアクセスできるようにしてください。ページのとこかに以下のようなHTMLコードを書きます。 + +```html + + + + +
+ My Misskey App +
+``` + +あとで`redirect_uri`のアドレスに認証コードが転送されます。 + +## Step 2 + +PKCE `code_verifier`と`code_challenge`文字列, 及び`state`文字列を生成します。 + +- `code_verifier`の場合は最低43字、最高128字でアルファベット大・小文字及び`-._~`の中の文字に限られます。 +- `code_challenge`文字列は`code_verifier`文字列をSHA256アルゴリズムでハッシュしてbase64urlでエンコードした結果を使います。 +- `state`文字列には特別な制限はありません。ランダムな文字列を使います。 + +:::danger + +この文字列は毎回生成し、使いまわさないようにしてください。 + +::: + +:::tip + +[pkce-challenge](https://www.npmjs.com/package/pkce-challenge)とかのライブラリを使ったり、OAuthライブラリのPKCE機能を使うのがおすすめです。 + +::: + +:::tip{label='例'} + +```js +import crypto from "node:crypto"; + +const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-._~"; +const codeVerifier = new Array(128) + .fill(0) + .map(() => chars[Math.floor(chars.length * Math.random())]) + .join(""); +console.log('code_verifier', codeVerifier); + +const codeChallenge = crypto + .createHash("sha256") + .update(codeVerifier, "ascii") + .digest("base64url"); +console.log('code_challenge', codeChallenge); + +const state = crypto.randomUUID(); +console.log('state', state); +``` + +::: + +## Step 3 + +相手サーバーのOAuth情報を取得します。データはJSON形式になっています。 + +``` +https://{host}/.well-known/oauth-authorization-server +``` + +`{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 + +ここでは`authorization_endpoint`と`token_endpoint`を使います。 + +:::tip + +次のステップで使われる`scope`の情報も`scopes_supported`で確認できます。 + +::: + +## Step 4 + +アプリケーション認証フォームをユーザーのブラウザで表示させます。認証フォームは、以下の形式のURLで開くことができます: + +``` +{authorization_endpoint}?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&scope={scope}&code_challenge={code_challenge}&code_challenge_method=S256&state={state} +``` + +ここで、 + +- `{authorization_endpoint}`の部分は、前の情報取得で得たアドレスに置き換えます。 +- `{client_id}`の部分は、アプリの紹介ページのアドレスに置き換えます。 +- `{code_challenge}`の部分は、前に生成した`code_challenge`文字列に置き換えます +- `code_challenge_method`の部分は常に`S256`にします。 +- `{redirect_uri}`の部分は、紹介ページで使っている配達先のアドレスに置き換えます。 +- `{scope}`の部分は、アプリケーションが要求する権限に置き換えます。要求する権限を` `で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 +- `{state}`の部分は、前に生成した`state`文字列に置き換えます。 + +:::tip{label='例'} + +``` +https://misskey.local/oauth/authorize?client_id=http%3A%2F%2Fexample.com&code_challenge=C6hwMO2bmIzg3nqppTE9b79fvuOjlrKmH2xNiZSMHzw&code_challenge_method=S256&response_type=code&redirect_uri=http%3A%2F%2Fexample.com%2Fredirect&scope=write%3Anotes&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +## Step 5 + +ユーザーがアプリケーションアクセスを許可したら、`redirect_uri`のアドレスに認証コードがURLパラメータの形式で転送されます。 + +| 名前 | 説明 | +| ------- | ----------------------- | +| `code` | ユーザーの認証コード。 | +| `state` | 認証リクエストに使われた`state`文字列。 | + +:::tip{label='例'} + +``` +https://example.com/redirect?code=...&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab +``` + +::: + +`state`文字列がちゃんと一致しているのか確認して、次のステップに進みます。 + +## Step 6 + +転送された認証コードを使ってアクセストークンをPOSTでリクエストします。リクエスト先は`token_endpoint`になります。データ形式は`application/json`と`application/x-www-form-urlencoded`を使えます。各パラメータは以下のようになります。 + +| 名前 | 説明 | +| --------------- | ------------------------------ | +| `grant_type` | 常に`authorization_code`にします。 | +| `client_id` | 認証リクエストに使われた`client_id`文字列。 | +| `redirect_uri` | 認証リクエストに使われた`redirect_uri`文字列。 | +| `scope` | 認証リクエストに使われた`scope`文字列。 | +| `code` | 取得した認証コード。　 | +| `code_verifier` | 前に生成した`code_verifier`文字列。 | + +:::tip{label='例'} + +```js +const res = await fetch(endpoint, { + method: "POST", + body: JSON.stringify({ + grant_type: "authorization_code", + client_id: "https://example.com", + redirect_uri: "https://example.com/redirect", + scope: "write:notes", + code: "...", + code_verifier: "hjjbCYDmDpSLjirkO-PrfWKsRhDdJr-PAEGRClRwzUKlmFIIIrZNmSvUIraeIa~WqbqQnfbJV-Hc_IfuQkesBYUpukUi~lInDfU_AZjoZqbU.ioQTRzaFfZFfGnT-OAA", + }), + headers: { + "Content-Type": "application/json" + } +}); +``` + +::: + +レスポンスはJSONオブジェクト形式で、そこから`access_token`を取得して使います。 diff --git a/content/tw/docs/4.for-developers/plugin/create-plugin.md b/content/tw/docs/4.for-developers/plugin/create-plugin.md index 5e5130ca..cd9bf91e 100644 --- a/content/tw/docs/4.for-developers/plugin/create-plugin.md +++ b/content/tw/docs/4.for-developers/plugin/create-plugin.md @@ -74,4 +74,4 @@ Misskey Webはプラグインに対してAPIを公開していて、それらを v2023.11.0以降では、あなたのウェブサイトからワンクリックでプラグインを直接インストールできるようになっています。 -プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](./publish-on-your-website.md)をご覧ください。 +プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](../publish-on-your-website.md)をご覧ください。 diff --git a/content/tw/docs/4.for-developers/publish-on-your-website.md b/content/tw/docs/4.for-developers/publish-on-your-website.md index 65fdc1df..9053016a 100644 --- a/content/tw/docs/4.for-developers/publish-on-your-website.md +++ b/content/tw/docs/4.for-developers/publish-on-your-website.md @@ -1,6 +1,6 @@ -# プラグイン・テーマを配布する +# 發行外掛與主題 -Misskey v2023.11.0以降では、様々な追加リソースをあなたのウェブサイトから直接インストールできるようになりました。特に、プラグインやテーマなどをたくさん制作している方や、プラグイン配布サイトを作りたい方にとっては便利な機能です。 +從 Misskey v2023.11.0 開始，可以直接從您的網站安裝各種外掛與主題。這對製作大量外掛程式和主題的使用者或想建立外掛程式發佈網站的使用者特別有用。 ## 外部からのインストールに対応しているリソース diff --git a/content/tw/docs/5.releases.md b/content/tw/docs/5.releases.md index bd4fc67e..d276b28c 100644 --- a/content/tw/docs/5.releases.md +++ b/content/tw/docs/5.releases.md @@ -6,11 +6,54 @@ maxTocDepth: 2 Misskey 的版本資訊被發布在此。 +## 2023.12.2 + +リリース日: 2023/12/28 + +### 一般 + +- v2023.12.1でDockerを利用してサーバーを起動できない問題を修正 + +### 客戶端 + +- Enhance: 検索画面においてEnterキー押下で検索できるように + +## 2023.12.1 + +リリース日: 2023/12/27 + +### 註記 + +- アクセストークンの権限が再整理されたため、一部のAPIが古いAPIトークンでは動作しなくなりました。\ + 権限不足になる場合には権限を再設定して再生成してください。 + +### General + +- Enhance: 在地化更新 +- Fix: 自分のdirect noteがuser list timelineに追加されない + +### Client + +- Feat: AiScript専用のMFM構文`$[clickable.ev=EVENTNAME ...]`を追加。`Mk:C:mfm`のオプション`onClickEv`に関数を渡すと、クリック時に`EVENTNAME`を引数にして呼び出す +- Enhance: MFM入力補助ボタンを投稿フォームに表示できるように #12787 +- Fix: 一部のモデログ(logYellowでの表示対象)について、表示の色が変わらない問題を修正 +- Fix: `fg`/`bg`MFMに長い単語を指定すると、オーバーフローされずはみ出る問題を修正 + +### 伺服器 + +- Enhance: センシティブワードの設定がハッシュタグトレンドにも適用されるようになりました +- Enhance: `oauth/token`エンドポイントのCORS対応 +- Fix: 1702718871541-ffVisibility.jsのdownが壊れている +- Fix:「非センシティブのみ（リモートはいいねのみ）」を設定していても、センシティブに設定されたカスタム絵文字をリアクションできる問題を修正 +- Fix: ロールアサイン時の通知で，ロールアイコンが縮小されずに表示される問題を修正 +- Fix: サードパーティアプリケーションがWebsocket APIに無条件にアクセスできる問題を修正 +- Fix: サードパーティアプリケーションがユーザーの許可なしに非公開の情報を見ることができる問題を修正 + ## 2023.12.0 發行日：2023/12/23 -### 註記 +### Note - 依存関係の更新に伴い、Node.js 20.10.0が最小要件になりました - 絵文字の追加辞書を既にインストールしている場合は、お手数ですが再インストールのほどお願いします @@ -24,7 +67,7 @@ Misskey 的版本資訊被發布在此。 2. 「ピン留 (全般)」のタブを選択します。 3. 「リアクション設定から上書きする」ボタンを押すことで、アップデート前の状態に戻すことができます。 -### 一般 +### General - Feat: メールアドレスの認証にverifymail.ioを使えるように (cherry-pick from https\://github.com/TeamNijimiss/misskey/commit/971ba07a44550f68d2ba31c62066db2d43a0caed) - Feat: モデレーターがユーザーのアイコンもしくはバナー画像を未設定状態にできる機能を追加 (cherry-pick from https\://github.com/TeamNijimiss/misskey/commit/e0eb5a752f6e5616d6312bb7c9790302f9dbff83) @@ -34,11 +77,11 @@ Misskey 的版本資訊被發布在此。 - Enhance: アイコンデコレーションを複数設定できるように - Enhance: アイコンデコレーションの位置を微調整できるように - Enhance: つながりの公開範囲をフォロー/フォロワーで個別に設定可能に #12072 -- Enhance: 在地化更新 +- Enhance: ローカリゼーションの更新 - Enhance: 依賴關係更新 - Fix: MFM `$[unixtime ]` に不正な値を入力した際に発生する各種エラーを修正 -### 客戶端 +### Client - Feat: 今日誕生日のフォロー中のユーザーを一覧表示できるウィジェットを追加 - Feat: 画面に雪を降らせられるように @@ -94,7 +137,7 @@ Misskey 的版本資訊被發布在此。 - Fix: ページ一覧ページの表示がモバイル環境において崩れているのを修正 - Fix: MFMでルビの中のテキストがnyaizeされない問題を修正 -### 伺服器 +### Server - Enhance: MFM `$[ruby ]` が他ソフトウェアと連合されるように - Enhance: Meilisearchを有効にした検索で、ユーザーのミュートやブロックを考慮するように @@ -1957,7 +2000,9 @@ same as 12.112.0 ### NOTE :::warning + このバージョンからNode v16.14.0以降が必要です + ::: ### Changes @@ -2069,12 +2114,16 @@ same as 12.112.0 ### Note :::warning + ビルドする前に`npm run clean`を実行してください。 + ::: :::warning + このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 + ::: ### Improvements @@ -2145,6 +2194,7 @@ same as 12.112.0 アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。 12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。 + ::: ### Changes diff --git a/locales/en-US.yml b/locales/en-US.yml index d1e1ca45..6b14cab5 100644 --- a/locales/en-US.yml +++ b/locales/en-US.yml @@ -7,6 +7,8 @@ share: "Share" note: "Note" other: "Other" add: "Add" +browse: "参照" +settings: "設定" goToLegacyHub: "Legacy Misskey Hub" _error: notFound: "Page not found" @@ -197,6 +199,8 @@ _tools: menuToggle: "Menu" _forUsers: title: "For Misskey Users" + _forAdmin: + title: "サーバー運営者向け" _mfmPlayground: title: "MFM Playground" description: "Practice MFM freely!" @@ -251,7 +255,7 @@ _share: addServer: "Add Server" domain: "Server domain" compatibleWith: "Compatible with Misskey and certain Misskey forks." - recommendedByWebsite: "シェア元Webサイトからのおすすめ" + recommendedByWebsite: "Recommended Server Domain" _noteVisibility: public: "Public" home: "Home" @@ -295,6 +299,17 @@ _avatarDecorationPreview: username: "Ai" noteText: "Just had a chocolate-glazed donut 🍩😋" profileDescription: "Misskey常駐AIの藍です！よろしくお願いします♪" +_customEmojiPreview: + title: "カスタム絵文字 プレビュー" + description: "カスタム絵文字の視認性をチェックできます。" + preview: "プレビュー" + emoji: "絵文字 #{number}" + placeholder: "「追加」から、カスタム絵文字を追加してプレビューできます。" + _options: + text: "ノート文面" + textDescription: "追加したカスタム絵文字は{emoji_id}で参照できます。" + _placeholder: + noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" _api: _permissions: title: "Permissions" @@ -336,3 +351,52 @@ _api: "write:flash": "Edit Plays" "read:flash-likes": "View list of liked Plays" "write:flash-likes": "Edit list of liked Plays" + "read:admin:abuse-user-reports": "ユーザーからの通報を見る" + "write:admin:delete-account": "ユーザーアカウントを削除する" + "write:admin:delete-all-files-of-a-user": "ユーザーのすべてのファイルを削除する" + "read:admin:index-stats": "データベースインデックスに関する情報を見る" + "read:admin:table-stats": "データベーステーブルに関する情報を見る" + "read:admin:user-ips": "ユーザーのIPアドレスを見る" + "read:admin:meta": "インスタンスのメタデータを見る" + "write:admin:reset-password": "ユーザーのパスワードをリセットする" + "write:admin:resolve-abuse-user-report": "ユーザーからの通報を解決する" + "write:admin:send-email": "メールを送る" + "read:admin:server-info": "サーバーの情報を見る" + "read:admin:show-moderation-log": "モデレーションログを見る" + "read:admin:show-user": "ユーザーのプライベートな情報を見る" + "read:admin:show-users": "ユーザーのプライベートな情報を見る" + "write:admin:suspend-user": "ユーザーを凍結する" + "write:admin:unset-user-avatar": "ユーザーのアバターを削除する" + "write:admin:unset-user-banner": "ユーザーのバーナーを削除する" + "write:admin:unsuspend-user": "ユーザーの凍結を解除する" + "write:admin:meta": "インスタンスのメタデータを操作する" + "write:admin:user-note": "モデレーションノートを操作する" + "write:admin:roles": "ロールを操作する" + "read:admin:roles": "ロールを見る" + "write:admin:relays": "リレーを操作する" + "read:admin:relays": "リレーを見る" + "write:admin:invite-codes": "招待コードを操作する" + "read:admin:invite-codes": "招待コードを見る" + "write:admin:announcements": "お知らせを操作する" + "read:admin:announcements": "お知らせを見る" + "write:admin:avatar-decorations": "アバターデコレーションを操作する" + "read:admin:avatar-decorations": "アバターデコレーションを見る" + "write:admin:federation": "連合に関する情報を操作する" + "write:admin:account": "ユーザーアカウントを操作する" + "read:admin:account": "ユーザーに関する情報を見る" + "write:admin:emoji": "絵文字を操作する" + "read:admin:emoji": "絵文字を見る" + "write:admin:queue": "ジョブキューを操作する" + "read:admin:queue": "ジョブキューに関する情報を見る" + "write:admin:promo": "プロモーションノートを操作する" + "write:admin:drive": "ユーザーのドライブを操作する" + "read:admin:drive": "ユーザーのドライブの関する情報を見る" + "read:admin:stream": "管理者用のWebsocket APIを使う" + "write:admin:ad": "広告を操作する" + "read:admin:ad": "広告を見る" + "write:invite-codes": "招待コードを作成する" + "read:invite-codes": "招待コードを取得する" + "write:clip-favorite": "クリップのいいねを操作する" + "read:clip-favorite": "クリップのいいねを見る" + "read:federation": "連合に関する情報を取得する" + "write:report-abuse": "違反を報告する" diff --git a/locales/fr-FR.yml b/locales/fr-FR.yml index 610fe127..017f6044 100644 --- a/locales/fr-FR.yml +++ b/locales/fr-FR.yml @@ -7,6 +7,8 @@ share: "Partager" note: "Note" other: "Autres" add: "Ajouter" +browse: "参照" +settings: "設定" goToLegacyHub: "L'ancien Misskey Hub" _error: notFound: "La page demandée est introuvable !" @@ -197,6 +199,8 @@ _tools: menuToggle: "Menu" _forUsers: title: "Pour les utilisateurs de Misskey" + _forAdmin: + title: "サーバー運営者向け" _mfmPlayground: title: "Terrain de jeu de MFM" description: "Pratiquez librement le MFM ici ! Les prévisualisations du formulaire de publication et de la note sont incluses !" @@ -295,6 +299,17 @@ _avatarDecorationPreview: username: "Ai-Chan" noteText: "J'ai mangé un beignet enrobé de chocolat 🍩😋" profileDescription: "Je suis Ai-Chan, l'IA qui réside sur Misskey ! Enchantée de vous rencontrer ♪" +_customEmojiPreview: + title: "カスタム絵文字 プレビュー" + description: "カスタム絵文字の視認性をチェックできます。" + preview: "プレビュー" + emoji: "絵文字 #{number}" + placeholder: "「追加」から、カスタム絵文字を追加してプレビューできます。" + _options: + text: "ノート文面" + textDescription: "追加したカスタム絵文字は{emoji_id}で参照できます。" + _placeholder: + noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" _api: _permissions: title: "Permissions" @@ -336,3 +351,52 @@ _api: "write:flash": "Modifier vos Play" "read:flash-likes": "Lire vos mentions j'aime des Play" "write:flash-likes": "Modifier vos mentions j'aime des Play" + "read:admin:abuse-user-reports": "ユーザーからの通報を見る" + "write:admin:delete-account": "ユーザーアカウントを削除する" + "write:admin:delete-all-files-of-a-user": "ユーザーのすべてのファイルを削除する" + "read:admin:index-stats": "データベースインデックスに関する情報を見る" + "read:admin:table-stats": "データベーステーブルに関する情報を見る" + "read:admin:user-ips": "ユーザーのIPアドレスを見る" + "read:admin:meta": "インスタンスのメタデータを見る" + "write:admin:reset-password": "ユーザーのパスワードをリセットする" + "write:admin:resolve-abuse-user-report": "ユーザーからの通報を解決する" + "write:admin:send-email": "メールを送る" + "read:admin:server-info": "サーバーの情報を見る" + "read:admin:show-moderation-log": "モデレーションログを見る" + "read:admin:show-user": "ユーザーのプライベートな情報を見る" + "read:admin:show-users": "ユーザーのプライベートな情報を見る" + "write:admin:suspend-user": "ユーザーを凍結する" + "write:admin:unset-user-avatar": "ユーザーのアバターを削除する" + "write:admin:unset-user-banner": "ユーザーのバーナーを削除する" + "write:admin:unsuspend-user": "ユーザーの凍結を解除する" + "write:admin:meta": "インスタンスのメタデータを操作する" + "write:admin:user-note": "モデレーションノートを操作する" + "write:admin:roles": "ロールを操作する" + "read:admin:roles": "ロールを見る" + "write:admin:relays": "リレーを操作する" + "read:admin:relays": "リレーを見る" + "write:admin:invite-codes": "招待コードを操作する" + "read:admin:invite-codes": "招待コードを見る" + "write:admin:announcements": "お知らせを操作する" + "read:admin:announcements": "お知らせを見る" + "write:admin:avatar-decorations": "アバターデコレーションを操作する" + "read:admin:avatar-decorations": "アバターデコレーションを見る" + "write:admin:federation": "連合に関する情報を操作する" + "write:admin:account": "ユーザーアカウントを操作する" + "read:admin:account": "ユーザーに関する情報を見る" + "write:admin:emoji": "絵文字を操作する" + "read:admin:emoji": "絵文字を見る" + "write:admin:queue": "ジョブキューを操作する" + "read:admin:queue": "ジョブキューに関する情報を見る" + "write:admin:promo": "プロモーションノートを操作する" + "write:admin:drive": "ユーザーのドライブを操作する" + "read:admin:drive": "ユーザーのドライブの関する情報を見る" + "read:admin:stream": "管理者用のWebsocket APIを使う" + "write:admin:ad": "広告を操作する" + "read:admin:ad": "広告を見る" + "write:invite-codes": "招待コードを作成する" + "read:invite-codes": "招待コードを取得する" + "write:clip-favorite": "クリップのいいねを操作する" + "read:clip-favorite": "クリップのいいねを見る" + "read:federation": "連合に関する情報を取得する" + "write:report-abuse": "違反を報告する" diff --git a/locales/id-ID.yml b/locales/id-ID.yml index 41185840..e293b57f 100644 --- a/locales/id-ID.yml +++ b/locales/id-ID.yml @@ -1,338 +1,402 @@ -noScript: "現在Javascriptが無効になっています。サイトの表示にはJavascriptが必須となりますので有効にしてください。" -learnMore: "詳しく知る" -loading: "読み込み中…" -clickToExpand: "（クリックして展開）" -copy: "コピー" -share: "共有する" -note: "ノート" -other: "その他" -add: "追加" -goToLegacyHub: "従来のMisskey Hub" +noScript: "JavaScript dinonaktifkan. Mohon aktifkan JavaScript karena dibutuhkan untuk situs agar dapat berjalan dengan normal." +learnMore: "Pelajari lebih lanjut" +loading: "Memuat..." +clickToExpand: "(Klik untuk perluas)" +copy: "Salin" +share: "Bagikan" +note: "Catatan" +other: "Lainnya" +add: "Tambahkan" +browse: "参照" +settings: "設定" +goToLegacyHub: "Misskey Hub Jadul" _error: - notFound: "ページが見つかりませんでした" - notFoundDesc: "お探しのページは見つかりませんでした。URLをお確かめください。" - generalError: "エラーが発生しました" - generalErrorDesc: "これが意図した操作でない場合は、以下から不具合報告をお願いします。" - reportProblem: "問題を報告する" - goToTop: "トップページにもどる" + notFound: "Halaman Tidak Ditemukan" + notFoundDesc: "Halaman yang kamu cari tidak dapat ditemukan. Mohon cek kembali URL yang kamu tuju." + generalError: "Terjadi kesalahan" + generalErrorDesc: "Jika ini bukan yang kamu maksud, mohon klik tombol di bawah ini untuk melaporkan masalah." + reportProblem: "Laporkan Masalah" + goToTop: "Kembali ke halaman atas" _seo: siteName: "Misskey Hub" - siteNameLong: "Misskey Hub – Misskeyプロジェクト 公式サイト" - defaultTitleTagline: "ノートでひろがるネットワーク" - defaultDescription: "【ノートでひろがるネットワーク】分散型SNS Misskeyの公式サイト。Misskeyのはじめかたやサーバー一覧など、Misskeyに関する情報が満載！" + siteNameLong: "Misskey Hub – Situs web resmi Proyek Misskey" + defaultTitleTagline: "Jaringan membentang melalui catatan" + defaultDescription: "Situs web resmi Misskey, sebuah perangkat lunak jejaring sosial yang terdesentralisasi. Temukan cara untuk memulai, daftar peladen, dan informasi lebih lanjut tentang Misskey!" _nav: - servers: "サーバー" - docs: "ドキュメント" - blog: "ブログ" - other: "もっと！" - switchLang: "言語の設定" + servers: "Peladen" + docs: "Dokumen" + blog: "Blog" + other: "Lainnya" + switchLang: "Pengaturan Bahasa" _landing: _hero: - description: "Misskey（ミスキー）はオープンソースの分散型ソーシャルネットワーキングプラットフォームです。" - gettingStarted: "はじめる" + description: "Misskey merupakan platform media sosial terdesentralisasi bersumber terbuka." + gettingStarted: "Memulai" _keyFeatures: _open: - title: "オープン" - description: "Misskeyはオープンソースのソフトウェアで、誰でも自由にMisskeyを利用できます。" + title: "Terbuka" + description: "Misskey merupakan perangkat lunak bersumber terbuka dan semua orang dapat menggunakanya secara bebas." _federated: - title: "分散" - description: "Misskeyは分散型のプロトコルを実装しているため、異なるサーバーのコミュニティ同士が繋がります。" + title: "Federasi" + description: "Misskey merupakan platform terdesentralisasi, sehingga komunitas dari peladen lain dapat terhubung dengan satu sama lain." _multifunction: - title: "高機能" - description: "Misskeyは他にはない様々な機能を備えていて、プロのようにmicro-blogging可能です。" + title: "Modern" + description: "Misskey menawarkan banyak fitur unggul yang mudah dipahami untuk pemula maupun pengguna mikro blog mahir." _customizable: - title: "高カスタマイズ性" - description: "Misskeyの柔軟なWebインターフェイスにより、自分好みのUIを作れます。" + title: "Ubahsuai" + description: "Antarmuka web Misskey yang fleksibel memungkinkanmu untuk mengubahsuaikan antarmuka sesuai keinginanmu sendiri." _decenterized: - title: "Misskeyは{0}" - decenterizedPlatform: "分散型プラットフォーム" - description: "Misskeyはフリーかつオープンなプロジェクトで、誰でも自由にMisskeyを使ったサーバーを作成できるため、既に様々なサーバーがインターネット上に公開されています。また重要な特徴として、Misskeyは{0}と呼ばれる分散通信プロトコルを実装しているので、どのサーバーを選んでも他のサーバーのユーザーとやりとりすることができます。これが分散型と言われる所以で、単一の運営者によって単一のURLで公開されるような、Twitterなどの他サービスとは根本的に異なっています。サーバーによって主な話題のテーマやユーザー層、言語などは異なり、自分にあったサーバーを探すのも楽しみのひとつです(もちろん自分のサーバーを作るのも一興です)。" + title: "Misskey merupakan platform {0}." + decenterizedPlatform: "Terdesentralisasi" + description: "Misskey adalah proyek bebas dan terbuka. Semua orang dapat membuat instansi peladen Misskey secara bebas dan bermacam peladen Misskey di Internet telah tersedia. Salah satu fitur penting dari Misskey adalah implementasi protokol komunikasi terdesentralisasi bernama {0}. Dengan {0}, pengguna dapat berinteraksi dengan pengguna lain yang berbeda peladen dimana pun mereka terdaftar. Inilah kenapa disebut terdesentralisasi dan secara fundamental berbeda dengan layanan lain seperti Twitter yang mana disediakan dalam URL dan operator tunggal. Setiap peladen memiliki topik, grup pengguna, dan bahasa yang berbeda-beda dari satu peladen dengan peladen lain. Menemukan peladen yang tepat bagimu tersebut juga bagian dari hal yang menyenangkan (tidak lupa juga membuat peladenmu sendiri juga menyenangkan lho)." activityPub: "ActivityPub" _features: _root: - title: "主な機能" - description: "Misskeyは一般的なものから特別なものまで、様々な機能を持っています。その一部を紹介します。" + title: "Fitur" + description: "Misskey memiliki banyak fitur yang diunggulkan. Temukan mulai dari yang umum hingga khusus." _note: - title: "ノート" - description: "Misskeyでは、ユーザーの投稿は「ノート」と呼ばれます。他のノートを引用したり、画像、動画、オーディオ、その他の任意のファイルを添付することもできます。" + title: "Catatan" + description: "Di Misskey, postingan dari pengguna disebut sebagai \"catatan\". Kamu juga memberi balasan, kutipan, menambahkan emoji kustom, teks beranimasi, gambar, video, klip audio, dan masih banyak lagi!" _federation: - title: "連合" - description: "オープンな分散プロトコルであるActivityPubを実装しているため、他のMisskeyサーバーだけでなく、ActivityPubをサポートする他のソフトウェアともやりとりできます。" + title: "Federasi" + description: "Misskey menggunakan protokol ActivityPub untuk berkomunikasi dengan peladen lain. Tidak hanya terbatas untuk peladen Misskey saja, Misskey juga dapat berkomunikasi dengan perangkat lunak yang mendukung protokol ActivityPub seperti Pleroma, Mastodon, dan Pixelfed." _reaction: - title: "リアクション" - description: "ノートには「リアクション」を付けることができ、簡単・気軽に自分のフィーリングを表現して伝えることが出来ます。" + title: "Reaksi" + description: "Kamu juga dapat menambahkan reaksi emoji ke postingan apapun! Dengan begitu kamu tidak terbatas hanya pada tombol suka dan sekarang kamu bisa menunjukkan perasaanmu kepada semua orang." _drive: - title: "ドライブ" - description: "アップロードしたファイルを管理するインターフェイスがあります。そのため、お気に入りの画像をフォルダにまとめたり、再度共有することも簡単に行えます。" + title: "Drive" + description: "Kesulitan untuk menemukan hal yang sudah kamu unggah sebelumnya? Adanya Drive membantumu untuk menyelesaikan masalah tersebut. Kamu dapat mengelola gambar atau video favoritmu yang telah kamu unggah dan membagikannya kembali." _theme: - title: "テーマ" - description: "自分の好きなデザインでMisskeyを使えます。もちろんダークモードも完全サポート。自分で高度にテーマを作ることも可能です。" + title: "Tema" + description: "Kamu dapat menggunakan Misskey dengan desain favoritmu. Tidak lagi terbatas tema gelap ataupun terang. Kamupun juga dapat membuat tema sesuai dengan keinginanmu sendiri." _thread: - title: "スレッド" - description: "もちろんノートはスレッドにすることができ、気が済むまで会話を続けられます。" + title: "Utas" + description: "Punya banyak hal yang diutarakan? Catatan di Misskey bisa dibuat sebagai utas. Kamu juga bisa membuat utas hingga maksimal 3000 karakter dan menyambungnya hingga menjadi percakapan panjang." _charts: - title: "チャート" - description: "Misskeyは組み込みのチャートエンジンを備えていて、サーバーの利用状況などが簡単に可視化できます。" + title: "Bagan" + description: "Bagi kalian yang ingin melihat segalanya, Misskey memiliki mesin penggambar Bagan bawaan yang dapat dilihat oleh admin maupun pengguna untuk memvisualisasikan beban penggunaan peladen dan lain-lain secara realtime" _widgets: - title: "ウィジェット" - description: "様々な種類のウィジェットを配置し、UIを好みにカスタマイズできます。" + title: "Gawit" + description: "Buat dirimu mudah dengan banyaknya jenis gawit yang disediakan oleh Misskey. Ubahsuaikan antarmuka berandamu sesuai keinginanmu." _getStarted: - title: "Misskeyをはじめよう" + title: "Memulai dengan Misskey" _find: - title: "サーバーを見つける" - list: "サーバーのリスト" + title: "Temukan Peladen" + list: "Daftar Peladen" _create: - title: "サーバーを作成" - guide: "セットアップガイド" + title: "Buat Peladen" + guide: "Panduan Pemasangan" _docs: - title: "さらに詳しく知る" - docs: "ドキュメントを見る" + title: "Pelajari Lebih Lanjut" + docs: "Lihat Dokumentasi" _donation: - title: "寄付のお願い" - description: "Misskeyは非営利なため、開発資金は皆様からの寄付に頼っています。Misskeyを気に入られたら、今後も開発を続けられるようにぜひ支援をお願いします。" + title: "Permohonan Donasi" + description: "Misskey merupakan produk nirlaba, kami bergantung pada donasi kamu untuk mendanai pengembangan perangkat lunak ini. Apabila kamu menyukai Misskey, mohon pertimbangkan untuk berdonasi agar kami dapat terus melanjutkan pengembangan Misskey dan membuatnya semakin menarik untuk kedepannya." _sponsors: - title: "スポンサー" + title: "Sponsor" _servers: - title: "サーバー一覧" - description: "Misskeyは単一のサービスではなく、各々がサービスを提供する分散型ネットワークとなっています。Misskeyを利用するには、サービスを提供しているサーバーでアカウントを作成する必要があります。" - addYourServer: "あなたのサーバーが表示されませんか？{0}から登録してください！" - addYourServerLink: "こちら" + title: "Daftar Peladen" + description: "Misskey bukanlah layanan satuan namun jejaring terdesentralisasi dimana para individu menyediakan banyak layanan. Untuk menggunakan Misskey, kamu perlu membuat akun di peladen yang menawarkan layanan tersebut." + addYourServer: "Apakah peladenmu tidak terdaftar? Daftarkan segera di {0}!" + addYourServerLink: "di sini" _system: - fetchError: "データの読み込みに失敗しました。後でもう一度お試しください。" + fetchError: "Gagal untuk mengambil data. Mohon coba lagi nanti." _statistics: - title: "サーバー統計" - description: "Misskeyサーバーの統計データをグラフでご紹介。" - viewFullStats: "詳しい統計を見る" - lang: "プライマリ言語" - registerAcceptance: "新規登録受付方式" - version: "バージョン" - notes: "ノート数" - users: "ユーザー数" - servers: "サーバー数" + title: "Statistik Peladen" + description: "Presentasikan statistik peladen Misskey ke dalam Bagan." + viewFullStats: "Lihat statistik lengkap" + lang: "Bahasa Utama" + registerAcceptance: "Menerima pendaftaran" + version: "Versi" + notes: "Jumlah catatan" + users: "Jumlah pengguna" + servers: "Jumlah peladen" _search: - title: "絞り込み検索" - all: "すべて" - query: "キーワードで検索" - lang: "言語" - orderBy: "並び替え" - recomendded: "デフォルト" - notesCount: "ノート数" - notesPer15Days: "1日あたりのノート数（15日平均）" - usersCount: "ユーザー数" + title: "Pencarian tingkat lanjut" + all: "Semua" + query: "Pencarian dengan kata kunci" + lang: "Bahasa" + orderBy: "Tata ulang" + recomendded: "Bawaan" + notesCount: "Jumlah catatan" + notesPer15Days: "Jumlah catatan per hari (rata-rata 15 hari terakhir)" + usersCount: "Jumlah pengguna" _registerAcceptance: - title: "新規登録" - public: "開放" - inviteOnly: "招待のみ" + title: "Kebijakan Pendaftaran" + public: "Publik" + inviteOnly: "Hanya Undangan" _list: - notFound: "指定された条件に合致するサーバーは見つかりませんでした。" - showMore: "もっと見る" + notFound: "Tidak ada peladen yang cocok ditemukan dengan kriteria yang dimaksud." + showMore: "Selebihnya" _view: - title: "表示形式" - list: "リスト" - grid: "グリッド" + title: "Gaya Tampilan" + list: "Daftar" + grid: "Kisi" _docs: - title: "ドキュメント" - description: "Misskeyはオープンソースの分散型ソーシャルネットワーキングプラットフォームです。Misskeyの上手な使い方から、サーバーの運営者・プログラムの開発者向けの情報まで網羅しています。" - indexTitle: "目次ページ" + title: "Dokumen" + description: "Informasi komprehensif dimulai dari cara menggunakan Misskey hingga sumber daya untuk pengembang serta operator peladen." + indexTitle: "Daftar Isi" _contribute: - editThis: "このページを編集" - translateThis: "このページを翻訳" + editThis: "Sunting Halaman ini" + translateThis: "Terjemahkan Halaman Ini" _aboutMisskey: - title: "Misskeyについて" - description: "Misskeyをはじめて知ったかたや、これから使うかた向け！基本的なしくみや機能を見ていきましょう。" + title: "Tentang Misskey" + description: "Panduan lengkap bagi para pengguna Misskey baru ataupun yang sedang mempertimbangkan untuk menggunakannya! Mari jelajahi dasar-dasar Misskey beserta fiturnya." _changelog: - title: "リリースノート" - description: "Misskeyのバージョンアップ履歴をご覧いただけます。最新のバージョンで何が変わったのかを確認しましょう！" + title: "Catatan Rilis" + description: "Lihat riwayat versi Misskey. Cari tahu apa yang terbaru di versi terakhir!" _forUsers: - title: "Misskeyユーザー向け" + title: "Untuk Pengguna Misskey" _forAdmin: - title: "サーバー運営者向け" + title: "Untuk Operator Peladen" _forDevelopers: - title: "開発者向け" + title: "Untuk Pengembang" _prevNext: - prev: "前へ" - next: "次へ" + prev: "Sebelumnya" + next: "Berikutnya" _toc: - title: "このページの内容" - toPageTop: "ページ上部に戻る" + title: "Daftar Isi" + toPageTop: "Kembali ke Atas" _blog: - title: "ブログ" - description: "Misskey開発本部から、Misskeyに関する最新情報やTips等をお届けします！（日本語のみ）" - back: "戻る" + title: "Blog" + description: "Dapatkan informasi dan tips mengenai Misskey langsung dari Tim Pengembang Misskey! (hanya Bahasa Jepang)" + back: "Kembali" _content: - tip: "ヒント" - warning: "注意" - danger: "警告" - preview: "プレビュー" + tip: "Tips" + warning: "Peringatan" + danger: "Bahaya" + preview: "Pratinjau" _other: - title: "もっと！" - description: "Misskeyをもっと楽しめるその他のリソースをご紹介しています。" + title: "Lainnya" + description: "Memperkenalkan sumber daya yang menyenangkan untuk Misskey!" _brandAssets: - title: "アセット集" - description: "Misskeyのロゴ、アイコンなどのアセットのコレクションです。一定のライセンスのもとでご自由にお使いいただけます。" - license: "アセットは、CC BY-NC-SAのライセンスの下で自由にお使いいただけます🎉" - assetsDirectory: "全てのアセットは、{0}で管理されています。" - logo: "ロゴ" - icon: "アイコン" - banner: "バナー" - avatarDecorationTemplate: "アバターデコレーション テンプレート" + title: "Aset Brand" + description: "Koleksi dari logo, ikon serta aset Misskey lainnya. Gunakan secara bebas untuk apapun selama dalam lisensi CC BY-NC-SA!" + license: "Aset tersedia dalam lisensi CC BY-NC-SA🎉." + assetsDirectory: "Semua aset dikelola di {0}." + logo: "Logo" + icon: "Ikon" + banner: "Banner" + avatarDecorationTemplate: "Templat Dekorasi Avatar" _links: - title: "リンク" + title: "Tautan" _github: title: "Github" - description: "Misskeyの開発はGithub上で行われています。機能リクエストやバグ報告などはこちらから行えます。" + description: "Pengembangan Misskey berada di Github. Kamu dapat memberikan permintaan fitur dan pelaporan bug di sini." _crowdin: title: "Crowdin" - description: "Misskey本体、およびドキュメントの翻訳はこちらで管理されています。皆さんのご協力をお願いします。" + description: "Penerjemahan untuk Misskey dan dokumentasinya dikelola di sini. Kami sangat mengapresiasi kontribusimu." _discord: - title: "Discordサーバー" - description: "Misskeyに関する質問や会話などをお楽しみいただけます。" + title: "Peladen Discord" + description: "Berpartisipasi dalam diskusi dan mengajukan pertanyaan tentang Misskey ada di sini." _aiChan: - title: "藍" - description: "Misskeyの看板娘、藍のウェブサイトです。" + title: "Ai-chan" + description: "Kunjungi situs web Ai-chan, maskot dari Misskey." _tools: - title: "ツール集" - index: "ツール集 ホーム画面" - description: "Misskey向けの便利ツールを公開中！" - menuToggle: "メニュー" + title: "Koleksi Alat" + index: "Beranda Koleksi Alat" + description: "Temukan alat yang berguna untuk Misskey!" + menuToggle: "Menu" _forUsers: - title: "Misskeyユーザー向け" + title: "Untuk Pengguna Misskey" + _forAdmin: + title: "サーバー運営者向け" _mfmPlayground: - title: "MFMお試しコーナー" - description: "MFMを自由に練習できます！Misskeyの投稿画面・ノートの画面を再現！" - preview: "プレビュー" - disclaimer: "ここに表示される通りに描画されるとは限りません。コードのシンタックスハイライトには対応していません。" + title: "Taman bermain MFM" + description: "Berlatih MFM sebebasnya!" + preview: "Pratinjau" + disclaimer: "Terdapat kemungkinan tidak dapat ditampilkan secara tepat di sini. Hal ini dikarenakan penyorotan sintaks untuk kode tidak didukung karena alasan performa." mfm: "MFM" - character: "{0} 文字" - domain: "表示を再現するサーバー" - noteIt: "ノート" - clearEmojiCacheDescription: "絵文字が表示されないとき" - clearEmojiCache: "絵文字のキャッシュを削除" + character: "{0} karakter" + domain: "Peladen yang ingin ditiru penampilannya (contoh: emoji kustom)" + noteIt: "Catatan" + clearEmojiCacheDescription: "Ketika emoji tidak ditampilkan:" + clearEmojiCache: "Hapus Tembolok Emoji" _aidConverter: - title: "aid/aidxツール" - description: "Misskeyの内部で使用されているランダムID生成アルゴリズム「aid」と「aidx」の変換・生成ができます。" - aidToDate: "aid/aidx→日付時刻" - dateToAid: "日付時刻→aid/aidx" - mode: "作成するid" - date: "日付時刻" + title: "alat aid/aidx" + description: "Alat ini dapat mengubah dan membuat aid serta aidx, yang merupakan algoritma generator ID random digunakan dalam Misskey." + aidToDate: "aid/aidx ke Tanggal" + dateToAid: "Tanggal ke aid/aidx" + mode: "Tipe id" + date: "Tanggal/Waktu" _aboutUs: - title: "Misskey Development Divisionについて" - description: "Misskey開発チームについての情報を掲載しています。" + title: "Tentang Divisi Pengembangan Misskey" + description: "Informasi mengenai tim pengembangan Misskey." _team: - title: "開発メンバー" - description: "Misskeyの開発に関わっている方を紹介しています。" + title: "Anggota Pengembang" + description: "Memperkenalkan orang-orang yang terlibat dalam pengembangan Misskey!" _core: - title: "コア チームメンバー" - description: "こちらのコアチームメンバーは、Misskey関連のプロジェクトを積極的にメンテナンスしています。" + title: "Anggota Tim Inti" + description: "Anggota tim inti berikut ini merupakan orang yang aktif dalam mengembangkan proyek terkait dengan Misskey." _coreEmeriti: - title: "名誉コアチームメンバー" - description: "過去に価値のある貢献をしてくださっていた、元コアチームメンバーの皆さんです。" + title: "Anggota Tim Inti Purna" + description: "Berikut merupakan anggota tim inti sebelumnya yang telah membuat kontribusi yang bernilai di masa lalu." _contributors: - title: "コントリビューター" - description: "こちらの皆さんは、Misskeyに特に貢献してくださっています。" - seeMore: "すべてのコントリビューター" + title: "Kontributor" + description: "Berikut ini merupakan beberapa dari kontributor Misskey yang paling aktif." + seeMore: "Semua kontributor" _orgPartner: - title: "企業・団体パートナー" - description: "こちらの企業・団体から、金銭的・技術的な観点でMisskeyの開発へご協力いただいております。" + title: "Rekan Korporasi & Organisasi" + description: "Perusahaan serta organisasi berikut telah berkontribusi secara teknis dan finansial terhadap pengembangan Misskey." _hubTranslators: - title: "Misskey Hub ローカライザー" - description: "Misskey Hubの翻訳に協力いただいている皆さんです。" + title: "Penerjemah Misskey Hub" + description: "Berikut orang-orang yang telah membantu menerjemahkan Misskey Hub." _coreTranslators: - title: "Misskey ローカライザー" - description: "Misskeyの翻訳に協力いただいている皆さんです。" + title: "Penerjemah Misskey" + description: "Berikut orang-orang yang telah membantu menerjemahkan Misskey." _i18n: _missing: - title: "翻訳にご協力ください" - description: "このドキュメントはコミュニティによる翻訳です。ドキュメントの翻訳は{link}から行えます。ご協力をお願いします🙏" + title: "Bantu kami menerjemahkan" + description: "Dokumen ini diterjemahkan oleh komunitas. Kamu dapat berkontribusi di {link}. Kami sangat mengapresiasi atas kerjasamamu terhadap proyek ini 🙏." linkLabel: "Crowdin" _share: - title: "Misskeyへノート" - chooseServer: "ノートするサーバーを選択してください" - addServer: "サーバーを追加" - domain: "サーバーのドメイン" - compatibleWith: "Misskeyと、一部のMisskeyフォークに対応しています。" - recommendedByWebsite: "シェア元Webサイトからのおすすめ" + title: "Catat ke Misskey" + chooseServer: "Pilih peladen dimana kamu ingin mencatat" + addServer: "Tambahkan Peladen" + domain: "Domain Peladen" + compatibleWith: "Kompatibel dengan Misskey dan beberapa fork Misskey." + recommendedByWebsite: "Domain Peladen yang direkomendasikan" _noteVisibility: - public: "パブリック" - home: "ホーム" - followers: "フォロワー" - specified: "ダイレクト" - localOnly: "連合なし" + public: "Publik" + home: "Beranda" + followers: "Pengikut" + specified: "Catatan langsung" + localOnly: "Matikan federasi" _shareLinkGenerator: - title: "共有ボタンジェネレーター" - description: "Misskey Hubの共有ボタン中継サービスを利用して、Misskey用の共有ボタンを作成できます。" - body: "本文" - bodyWarning: "どのサーバーでも共有できるようにするため、カスタム絵文字は使用できません。" + title: "Generator Tombol Bagikan" + description: "Buat tombol bagikan untuk Misskey menggunakan layanan relai tautan berbagi Misskey Hub." + body: "Badan Pesan" + bodyWarning: "Kamu tidak dapa menggunakan emoji kustom untuk membuatnya kompatibel dengan peladen apapun." url: "URL" - urlCaption: "任意。本文の後ろに挿入されます。" - settings: "詳細設定" - manualInstance: "おすすめサーバー ドメイン" - manualInstanceDescription: "ここに指定したサーバー（ひとつ）をシェアボタン中継ページのトップに表示できます。ご自身のサーバーに誘導する際などにお使いいただけます。" - visibility: "公開範囲" - recipents: "ダイレクトを受け取る人のacct（改行区切り）" - resultLink: "リンク生成結果" - resultButton: "共有ボタンのサンプル" - testLink: "共有リンクを試す" - typeSomethingToGetLink: "本文を入力するとリンクが生成されます。" - typeSomethingToGetButton: "本文を入力するとボタンが生成されます。" + urlCaption: "Opsional. Akan dimasukkan setelah badan teks." + settings: "Pengaturan Lanjutan" + manualInstance: "Domain Peladen yang direkomendasikan" + manualInstanceDescription: "Salah satu peladen yang disebutkan di sini dapat ditampilkan di atas tombol bagikan perantara. Hal ini membantu untuk mengarahkan pengguna ke peladen milikmu." + visibility: "Visibilitas" + recipents: "Acct dari orang yang menerima pesan langsung (masukkan pada baris baru sebagai pemisah)" + resultLink: "Hasil dari tautan yang dibagikan" + resultButton: "Contoh tombol bagikan" + testLink: "Tes tautan yang dibagikan" + typeSomethingToGetLink: "Masukkan teks untuk membuat tautan berbagi." + typeSomethingToGetButton: "Masukkan teks untuk membuat kode tombol berbagi." _goToMisskey: - title: "Misskey Webに移動" - heading: "このページを開きたいサーバーを選択してください" + title: "Pergi ke Situs Misskey" + heading: "Pilih peladen yang kamu ingin buka halamannya dan lanjutkan" _avatarDecorationPreview: - title: "アバターデコレーション プレビュー" - description: "アバターデコレーションがきれいに反映できるかをチェックできます。" - preview: "プレビュー" - settings: "設定" - decoration: "デコ #{number}" - placeholder: "「追加」から、アバターデコレーションを追加してプレビューできます。" + title: "Penampil Dekorasi Avatar" + description: "Kamu dapat mengecek apakah dekorasi avatar dapat ditampilkan dengan baik." + preview: "Pratinjau" + settings: "Pengaturan" + decoration: "Dekorasi #{number}" + placeholder: "Kamu dapat menambahkan serta mempratinjau dekorasi avatar dari menu \"Tambahkan\"." _options: - offsetX: "横位置調整" - offsetY: "縦位置調整" - angle: "角度" - flip: "左右反転" - overlayTemplate: "テンプレートを重ねる" + offsetX: "Posisi x" + offsetY: "Posisi y" + angle: "Sudut" + flip: "Balikkan Horizontal" + overlayTemplate: "Templat lapisan" _placeholder: - username: "藍" - noteText: "チョコのかかったドーナツを食べました🍩😋" - profileDescription: "Misskey常駐AIの藍です！よろしくお願いします♪" + username: "Ai" + noteText: "Baru aja makan donat berlapis coklat 🍩😋" + profileDescription: "Aku Ai bertugas sebagai AI Misskey! Senang berkenalan denganmu♪" +_customEmojiPreview: + title: "カスタム絵文字 プレビュー" + description: "カスタム絵文字の視認性をチェックできます。" + preview: "プレビュー" + emoji: "絵文字 #{number}" + placeholder: "「追加」から、カスタム絵文字を追加してプレビューできます。" + _options: + text: "ノート文面" + textDescription: "追加したカスタム絵文字は{emoji_id}で参照できます。" + _placeholder: + noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" _api: _permissions: - title: "権限" - description: "説明" + title: "Hak akses" + description: "Deskripsi" _types: - "read:account": "アカウントの情報を見る" - "write:account": "アカウントの情報を変更する" - "read:blocks": "ブロックを見る" - "write:blocks": "ブロックを操作する" - "read:drive": "ドライブを見る" - "write:drive": "ドライブを操作する" - "read:favorites": "お気に入りを見る" - "write:favorites": "お気に入りを操作する" - "read:following": "フォローの情報を見る" - "write:following": "フォロー・フォロー解除する" - "read:messaging": "チャットを見る" - "write:messaging": "チャットを操作する" - "read:mutes": "ミュートを見る" - "write:mutes": "ミュートを操作する" - "write:notes": "ノートを作成・削除する" - "read:notifications": "通知を見る" - "write:notifications": "通知を操作する" - "read:reactions": "リアクションを見る" - "write:reactions": "リアクションを操作する" - "write:votes": "投票する" - "read:pages": "ページを見る" - "write:pages": "ページを操作する" - "read:page-likes": "ページのいいねを見る" - "write:page-likes": "ページのいいねを操作する" - "read:user-groups": "ユーザーグループを見る" - "write:user-groups": "ユーザーグループを操作する" - "read:channels": "チャンネルを見る" - "write:channels": "チャンネルを操作する" - "read:gallery": "ギャラリーを見る" - "write:gallery": "ギャラリーを操作する" - "read:gallery-likes": "ギャラリーのいいねを見る" - "write:gallery-likes": "ギャラリーのいいねを操作する" - "read:flash": "Playを見る" - "write:flash": "Playを操作する" - "read:flash-likes": "Playのいいねを見る" - "write:flash-likes": "Playのいいねを操作する" + "read:account": "Melihat informasi akun kamu" + "write:account": "Menyunting informasi akun kamu" + "read:blocks": "Melihat daftar pengguna yang kamu blokir" + "write:blocks": "Menyunting daftar pengguna yang kamu blokir" + "read:drive": "Mengakses berkas dan folder Drive kamu" + "write:drive": "Menyunting atau menghapus berkas dan folder Drive kamu" + "read:favorites": "Melihat daftar favorit kamu" + "write:favorites": "Menyunting daftar favorit kamu" + "read:following": "Melihat informasi orang yang kamu ikuti" + "write:following": "Mengikuti atau membatalkan ikuti akun pengguna lain" + "read:messaging": "Melihat pesan percakapan akun kamu" + "write:messaging": "Menulis atau menghapus pesan percakapan akun kamu" + "read:mutes": "Melihat daftar pengguna yang kamu bisukan" + "write:mutes": "Menyunting daftar pengguna yang kamu bisukan" + "write:notes": "Menulis atau menghapus catatan" + "read:notifications": "Lihat notifikasi" + "write:notifications": "Mengelola notifikasi akun kamu" + "read:reactions": "Melihat reaksi akun kamu" + "write:reactions": "Menyunting reaksi akun kamu" + "write:votes": "Memberikan suara dalam angket" + "read:pages": "Melihat Halaman akun kamu" + "write:pages": "Menyunting atau menghapus Halaman akun kamu" + "read:page-likes": "Melihat daftar Halaman yang kamu sukai" + "write:page-likes": "Menyunting daftar Halaman yang kamu sukai" + "read:user-groups": "Melihat grup pengguna akun kamu" + "write:user-groups": "Menyunting atau menghapus grup pengguna akun kamu" + "read:channels": "Melihat Kanal akun kamu" + "write:channels": "Menyunting Kanal akun kamu" + "read:gallery": "Melihat Galeri akun kamu" + "write:gallery": "Menyunting Galeri akun kamu" + "read:gallery-likes": "Melihat daftar postingan galeri yang disukai" + "write:gallery-likes": "Menyunting daftar postingan galeri yang disukai" + "read:flash": "Melihat Play" + "write:flash": "Menyunting Play" + "read:flash-likes": "Melihat daftar Play yang disukai" + "write:flash-likes": "Menyunting daftar Play yang disukai" + "read:admin:abuse-user-reports": "ユーザーからの通報を見る" + "write:admin:delete-account": "ユーザーアカウントを削除する" + "write:admin:delete-all-files-of-a-user": "ユーザーのすべてのファイルを削除する" + "read:admin:index-stats": "データベースインデックスに関する情報を見る" + "read:admin:table-stats": "データベーステーブルに関する情報を見る" + "read:admin:user-ips": "ユーザーのIPアドレスを見る" + "read:admin:meta": "インスタンスのメタデータを見る" + "write:admin:reset-password": "ユーザーのパスワードをリセットする" + "write:admin:resolve-abuse-user-report": "ユーザーからの通報を解決する" + "write:admin:send-email": "メールを送る" + "read:admin:server-info": "サーバーの情報を見る" + "read:admin:show-moderation-log": "モデレーションログを見る" + "read:admin:show-user": "ユーザーのプライベートな情報を見る" + "read:admin:show-users": "ユーザーのプライベートな情報を見る" + "write:admin:suspend-user": "ユーザーを凍結する" + "write:admin:unset-user-avatar": "ユーザーのアバターを削除する" + "write:admin:unset-user-banner": "ユーザーのバーナーを削除する" + "write:admin:unsuspend-user": "ユーザーの凍結を解除する" + "write:admin:meta": "インスタンスのメタデータを操作する" + "write:admin:user-note": "モデレーションノートを操作する" + "write:admin:roles": "ロールを操作する" + "read:admin:roles": "ロールを見る" + "write:admin:relays": "リレーを操作する" + "read:admin:relays": "リレーを見る" + "write:admin:invite-codes": "招待コードを操作する" + "read:admin:invite-codes": "招待コードを見る" + "write:admin:announcements": "お知らせを操作する" + "read:admin:announcements": "お知らせを見る" + "write:admin:avatar-decorations": "アバターデコレーションを操作する" + "read:admin:avatar-decorations": "アバターデコレーションを見る" + "write:admin:federation": "連合に関する情報を操作する" + "write:admin:account": "ユーザーアカウントを操作する" + "read:admin:account": "ユーザーに関する情報を見る" + "write:admin:emoji": "絵文字を操作する" + "read:admin:emoji": "絵文字を見る" + "write:admin:queue": "ジョブキューを操作する" + "read:admin:queue": "ジョブキューに関する情報を見る" + "write:admin:promo": "プロモーションノートを操作する" + "write:admin:drive": "ユーザーのドライブを操作する" + "read:admin:drive": "ユーザーのドライブの関する情報を見る" + "read:admin:stream": "管理者用のWebsocket APIを使う" + "write:admin:ad": "広告を操作する" + "read:admin:ad": "広告を見る" + "write:invite-codes": "招待コードを作成する" + "read:invite-codes": "招待コードを取得する" + "write:clip-favorite": "クリップのいいねを操作する" + "read:clip-favorite": "クリップのいいねを見る" + "read:federation": "連合に関する情報を取得する" + "write:report-abuse": "違反を報告する" diff --git a/locales/it-IT.yml b/locales/it-IT.yml index 42f83fbf..c9d556bb 100644 --- a/locales/it-IT.yml +++ b/locales/it-IT.yml @@ -7,6 +7,8 @@ share: "共有する" note: "ノート" other: "その他" add: "追加" +browse: "参照" +settings: "設定" goToLegacyHub: "従来のMisskey Hub" _error: notFound: "ページが見つかりませんでした" @@ -197,6 +199,8 @@ _tools: menuToggle: "メニュー" _forUsers: title: "Misskeyユーザー向け" + _forAdmin: + title: "サーバー運営者向け" _mfmPlayground: title: "MFMお試しコーナー" description: "MFMを自由に練習できます！Misskeyの投稿画面・ノートの画面を再現！" @@ -295,6 +299,17 @@ _avatarDecorationPreview: username: "藍" noteText: "チョコのかかったドーナツを食べました🍩😋" profileDescription: "Misskey常駐AIの藍です！よろしくお願いします♪" +_customEmojiPreview: + title: "カスタム絵文字 プレビュー" + description: "カスタム絵文字の視認性をチェックできます。" + preview: "プレビュー" + emoji: "絵文字 #{number}" + placeholder: "「追加」から、カスタム絵文字を追加してプレビューできます。" + _options: + text: "ノート文面" + textDescription: "追加したカスタム絵文字は{emoji_id}で参照できます。" + _placeholder: + noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" _api: _permissions: title: "権限" @@ -336,3 +351,52 @@ _api: "write:flash": "Playを操作する" "read:flash-likes": "Playのいいねを見る" "write:flash-likes": "Playのいいねを操作する" + "read:admin:abuse-user-reports": "ユーザーからの通報を見る" + "write:admin:delete-account": "ユーザーアカウントを削除する" + "write:admin:delete-all-files-of-a-user": "ユーザーのすべてのファイルを削除する" + "read:admin:index-stats": "データベースインデックスに関する情報を見る" + "read:admin:table-stats": "データベーステーブルに関する情報を見る" + "read:admin:user-ips": "ユーザーのIPアドレスを見る" + "read:admin:meta": "インスタンスのメタデータを見る" + "write:admin:reset-password": "ユーザーのパスワードをリセットする" + "write:admin:resolve-abuse-user-report": "ユーザーからの通報を解決する" + "write:admin:send-email": "メールを送る" + "read:admin:server-info": "サーバーの情報を見る" + "read:admin:show-moderation-log": "モデレーションログを見る" + "read:admin:show-user": "ユーザーのプライベートな情報を見る" + "read:admin:show-users": "ユーザーのプライベートな情報を見る" + "write:admin:suspend-user": "ユーザーを凍結する" + "write:admin:unset-user-avatar": "ユーザーのアバターを削除する" + "write:admin:unset-user-banner": "ユーザーのバーナーを削除する" + "write:admin:unsuspend-user": "ユーザーの凍結を解除する" + "write:admin:meta": "インスタンスのメタデータを操作する" + "write:admin:user-note": "モデレーションノートを操作する" + "write:admin:roles": "ロールを操作する" + "read:admin:roles": "ロールを見る" + "write:admin:relays": "リレーを操作する" + "read:admin:relays": "リレーを見る" + "write:admin:invite-codes": "招待コードを操作する" + "read:admin:invite-codes": "招待コードを見る" + "write:admin:announcements": "お知らせを操作する" + "read:admin:announcements": "お知らせを見る" + "write:admin:avatar-decorations": "アバターデコレーションを操作する" + "read:admin:avatar-decorations": "アバターデコレーションを見る" + "write:admin:federation": "連合に関する情報を操作する" + "write:admin:account": "ユーザーアカウントを操作する" + "read:admin:account": "ユーザーに関する情報を見る" + "write:admin:emoji": "絵文字を操作する" + "read:admin:emoji": "絵文字を見る" + "write:admin:queue": "ジョブキューを操作する" + "read:admin:queue": "ジョブキューに関する情報を見る" + "write:admin:promo": "プロモーションノートを操作する" + "write:admin:drive": "ユーザーのドライブを操作する" + "read:admin:drive": "ユーザーのドライブの関する情報を見る" + "read:admin:stream": "管理者用のWebsocket APIを使う" + "write:admin:ad": "広告を操作する" + "read:admin:ad": "広告を見る" + "write:invite-codes": "招待コードを作成する" + "read:invite-codes": "招待コードを取得する" + "write:clip-favorite": "クリップのいいねを操作する" + "read:clip-favorite": "クリップのいいねを見る" + "read:federation": "連合に関する情報を取得する" + "write:report-abuse": "違反を報告する" diff --git a/locales/ko-KR.yml b/locales/ko-KR.yml index 7272e657..3ef20221 100644 --- a/locales/ko-KR.yml +++ b/locales/ko-KR.yml @@ -7,6 +7,8 @@ share: "공유" note: "노트" other: "기타" add: "추가" +browse: "참고자료" +settings: "설정" goToLegacyHub: "이전 Misskey Hub" _error: notFound: "페이지를 찾을 수 없습니다" @@ -197,6 +199,8 @@ _tools: menuToggle: "메뉴" _forUsers: title: "Misskey 유저용" + _forAdmin: + title: "서버 운영자용" _mfmPlayground: title: "MFM 테스트 코너" description: "MFM를 자유롭게 연습하실 수 있습니다! Misskey의 글쓰기 화면, 노트 화면을 재현!" @@ -295,6 +299,17 @@ _avatarDecorationPreview: username: "아이(Ai)" noteText: "방금 초코도넛을 먹었어요 🍩😋" profileDescription: "Misskey 상주 AI인 아이입니다! 잘 부탁드려요♪。" +_customEmojiPreview: + title: "커스텀 이모티콘 미리보기" + description: "커스텀 이모티콘의 가시성을 확인할 수 있습니다." + preview: "미리보기" + emoji: "이모티콘 #{number}" + placeholder: "'추가'에서 사용자 지정 이모티콘을 추가하고 미리 볼 수 있습니다." + _options: + text: "노트 본문" + textDescription: "추가한 사용자 지정 이모티콘은 {emoji_id}로 참조할 수 있습니다." + _placeholder: + noteText: "커스텀 이모티콘은 다음과 같이 표시됩니다 → :emoji_preview_1:.\n문장을 다시 써서 사용성을 시험해 보세요✨." _api: _permissions: title: "권한" @@ -336,3 +351,52 @@ _api: "write:flash": "Play를 조작합니다" "read:flash-likes": "Play의 좋아요를 봅니다" "write:flash-likes": "Play의 좋아요를 조작합니다" + "read:admin:abuse-user-reports": "ユーザーからの通報を見る" + "write:admin:delete-account": "ユーザーアカウントを削除する" + "write:admin:delete-all-files-of-a-user": "ユーザーのすべてのファイルを削除する" + "read:admin:index-stats": "データベースインデックスに関する情報を見る" + "read:admin:table-stats": "データベーステーブルに関する情報を見る" + "read:admin:user-ips": "ユーザーのIPアドレスを見る" + "read:admin:meta": "インスタンスのメタデータを見る" + "write:admin:reset-password": "ユーザーのパスワードをリセットする" + "write:admin:resolve-abuse-user-report": "ユーザーからの通報を解決する" + "write:admin:send-email": "メールを送る" + "read:admin:server-info": "サーバーの情報を見る" + "read:admin:show-moderation-log": "モデレーションログを見る" + "read:admin:show-user": "ユーザーのプライベートな情報を見る" + "read:admin:show-users": "ユーザーのプライベートな情報を見る" + "write:admin:suspend-user": "ユーザーを凍結する" + "write:admin:unset-user-avatar": "ユーザーのアバターを削除する" + "write:admin:unset-user-banner": "ユーザーのバーナーを削除する" + "write:admin:unsuspend-user": "ユーザーの凍結を解除する" + "write:admin:meta": "インスタンスのメタデータを操作する" + "write:admin:user-note": "モデレーションノートを操作する" + "write:admin:roles": "ロールを操作する" + "read:admin:roles": "ロールを見る" + "write:admin:relays": "リレーを操作する" + "read:admin:relays": "リレーを見る" + "write:admin:invite-codes": "招待コードを操作する" + "read:admin:invite-codes": "招待コードを見る" + "write:admin:announcements": "お知らせを操作する" + "read:admin:announcements": "お知らせを見る" + "write:admin:avatar-decorations": "アバターデコレーションを操作する" + "read:admin:avatar-decorations": "アバターデコレーションを見る" + "write:admin:federation": "連合に関する情報を操作する" + "write:admin:account": "ユーザーアカウントを操作する" + "read:admin:account": "ユーザーに関する情報を見る" + "write:admin:emoji": "絵文字を操作する" + "read:admin:emoji": "絵文字を見る" + "write:admin:queue": "ジョブキューを操作する" + "read:admin:queue": "ジョブキューに関する情報を見る" + "write:admin:promo": "プロモーションノートを操作する" + "write:admin:drive": "ユーザーのドライブを操作する" + "read:admin:drive": "ユーザーのドライブの関する情報を見る" + "read:admin:stream": "管理者用のWebsocket APIを使う" + "write:admin:ad": "広告を操作する" + "read:admin:ad": "広告を見る" + "write:invite-codes": "招待コードを作成する" + "read:invite-codes": "招待コードを取得する" + "write:clip-favorite": "クリップのいいねを操作する" + "read:clip-favorite": "クリップのいいねを見る" + "read:federation": "連合に関する情報を取得する" + "write:report-abuse": "違反を報告する" diff --git a/locales/pl-PL.yml b/locales/pl-PL.yml index 41185840..d411a536 100644 --- a/locales/pl-PL.yml +++ b/locales/pl-PL.yml @@ -7,6 +7,8 @@ share: "共有する" note: "ノート" other: "その他" add: "追加" +browse: "参照" +settings: "設定" goToLegacyHub: "従来のMisskey Hub" _error: notFound: "ページが見つかりませんでした" @@ -197,6 +199,8 @@ _tools: menuToggle: "メニュー" _forUsers: title: "Misskeyユーザー向け" + _forAdmin: + title: "サーバー運営者向け" _mfmPlayground: title: "MFMお試しコーナー" description: "MFMを自由に練習できます！Misskeyの投稿画面・ノートの画面を再現！" @@ -295,6 +299,17 @@ _avatarDecorationPreview: username: "藍" noteText: "チョコのかかったドーナツを食べました🍩😋" profileDescription: "Misskey常駐AIの藍です！よろしくお願いします♪" +_customEmojiPreview: + title: "カスタム絵文字 プレビュー" + description: "カスタム絵文字の視認性をチェックできます。" + preview: "プレビュー" + emoji: "絵文字 #{number}" + placeholder: "「追加」から、カスタム絵文字を追加してプレビューできます。" + _options: + text: "ノート文面" + textDescription: "追加したカスタム絵文字は{emoji_id}で参照できます。" + _placeholder: + noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" _api: _permissions: title: "権限" @@ -336,3 +351,52 @@ _api: "write:flash": "Playを操作する" "read:flash-likes": "Playのいいねを見る" "write:flash-likes": "Playのいいねを操作する" + "read:admin:abuse-user-reports": "ユーザーからの通報を見る" + "write:admin:delete-account": "ユーザーアカウントを削除する" + "write:admin:delete-all-files-of-a-user": "ユーザーのすべてのファイルを削除する" + "read:admin:index-stats": "データベースインデックスに関する情報を見る" + "read:admin:table-stats": "データベーステーブルに関する情報を見る" + "read:admin:user-ips": "ユーザーのIPアドレスを見る" + "read:admin:meta": "インスタンスのメタデータを見る" + "write:admin:reset-password": "ユーザーのパスワードをリセットする" + "write:admin:resolve-abuse-user-report": "ユーザーからの通報を解決する" + "write:admin:send-email": "メールを送る" + "read:admin:server-info": "サーバーの情報を見る" + "read:admin:show-moderation-log": "モデレーションログを見る" + "read:admin:show-user": "ユーザーのプライベートな情報を見る" + "read:admin:show-users": "ユーザーのプライベートな情報を見る" + "write:admin:suspend-user": "ユーザーを凍結する" + "write:admin:unset-user-avatar": "ユーザーのアバターを削除する" + "write:admin:unset-user-banner": "ユーザーのバーナーを削除する" + "write:admin:unsuspend-user": "ユーザーの凍結を解除する" + "write:admin:meta": "インスタンスのメタデータを操作する" + "write:admin:user-note": "モデレーションノートを操作する" + "write:admin:roles": "ロールを操作する" + "read:admin:roles": "ロールを見る" + "write:admin:relays": "リレーを操作する" + "read:admin:relays": "リレーを見る" + "write:admin:invite-codes": "招待コードを操作する" + "read:admin:invite-codes": "招待コードを見る" + "write:admin:announcements": "お知らせを操作する" + "read:admin:announcements": "お知らせを見る" + "write:admin:avatar-decorations": "アバターデコレーションを操作する" + "read:admin:avatar-decorations": "アバターデコレーションを見る" + "write:admin:federation": "連合に関する情報を操作する" + "write:admin:account": "ユーザーアカウントを操作する" + "read:admin:account": "ユーザーに関する情報を見る" + "write:admin:emoji": "絵文字を操作する" + "read:admin:emoji": "絵文字を見る" + "write:admin:queue": "ジョブキューを操作する" + "read:admin:queue": "ジョブキューに関する情報を見る" + "write:admin:promo": "プロモーションノートを操作する" + "write:admin:drive": "ユーザーのドライブを操作する" + "read:admin:drive": "ユーザーのドライブの関する情報を見る" + "read:admin:stream": "管理者用のWebsocket APIを使う" + "write:admin:ad": "広告を操作する" + "read:admin:ad": "広告を見る" + "write:invite-codes": "招待コードを作成する" + "read:invite-codes": "招待コードを取得する" + "write:clip-favorite": "クリップのいいねを操作する" + "read:clip-favorite": "クリップのいいねを見る" + "read:federation": "連合に関する情報を取得する" + "write:report-abuse": "違反を報告する" diff --git a/locales/zh-CN.yml b/locales/zh-CN.yml index 41185840..a26ac680 100644 --- a/locales/zh-CN.yml +++ b/locales/zh-CN.yml @@ -1,19 +1,21 @@ -noScript: "現在Javascriptが無効になっています。サイトの表示にはJavascriptが必須となりますので有効にしてください。" +noScript: "JavaScript 目前处于禁用状态。必须启用 JavaScript 才能浏览网站。" learnMore: "詳しく知る" -loading: "読み込み中…" -clickToExpand: "（クリックして展開）" -copy: "コピー" -share: "共有する" +loading: "加载中…" +clickToExpand: "（点击以展开）" +copy: "复制" +share: "分享" note: "ノート" -other: "その他" +other: "其他" add: "追加" +browse: "参照" +settings: "設定" goToLegacyHub: "従来のMisskey Hub" _error: - notFound: "ページが見つかりませんでした" - notFoundDesc: "お探しのページは見つかりませんでした。URLをお確かめください。" - generalError: "エラーが発生しました" + notFound: "找不到页面" + notFoundDesc: "找不到您要查找的页面，请检查 URL。" + generalError: "发生了错误" generalErrorDesc: "これが意図した操作でない場合は、以下から不具合報告をお願いします。" - reportProblem: "問題を報告する" + reportProblem: "报告问题" goToTop: "トップページにもどる" _seo: siteName: "Misskey Hub" @@ -21,11 +23,11 @@ _seo: defaultTitleTagline: "ノートでひろがるネットワーク" defaultDescription: "【ノートでひろがるネットワーク】分散型SNS Misskeyの公式サイト。Misskeyのはじめかたやサーバー一覧など、Misskeyに関する情報が満載！" _nav: - servers: "サーバー" - docs: "ドキュメント" - blog: "ブログ" - other: "もっと！" - switchLang: "言語の設定" + servers: "服务器" + docs: "文档" + blog: "博客" + other: "更多！" + switchLang: "语音设定" _landing: _hero: description: "Misskey（ミスキー）はオープンソースの分散型ソーシャルネットワーキングプラットフォームです。" @@ -91,24 +93,24 @@ _landing: title: "寄付のお願い" description: "Misskeyは非営利なため、開発資金は皆様からの寄付に頼っています。Misskeyを気に入られたら、今後も開発を続けられるようにぜひ支援をお願いします。" _sponsors: - title: "スポンサー" + title: "赞助者" _servers: - title: "サーバー一覧" + title: "服务器列表" description: "Misskeyは単一のサービスではなく、各々がサービスを提供する分散型ネットワークとなっています。Misskeyを利用するには、サービスを提供しているサーバーでアカウントを作成する必要があります。" addYourServer: "あなたのサーバーが表示されませんか？{0}から登録してください！" addYourServerLink: "こちら" _system: fetchError: "データの読み込みに失敗しました。後でもう一度お試しください。" _statistics: - title: "サーバー統計" + title: "服务器统计数据" description: "Misskeyサーバーの統計データをグラフでご紹介。" viewFullStats: "詳しい統計を見る" lang: "プライマリ言語" registerAcceptance: "新規登録受付方式" - version: "バージョン" + version: "版本" notes: "ノート数" - users: "ユーザー数" - servers: "サーバー数" + users: "用户数量" + servers: "服务器数量" _search: title: "絞り込み検索" all: "すべて" @@ -135,13 +137,13 @@ _docs: description: "Misskeyはオープンソースの分散型ソーシャルネットワーキングプラットフォームです。Misskeyの上手な使い方から、サーバーの運営者・プログラムの開発者向けの情報まで網羅しています。" indexTitle: "目次ページ" _contribute: - editThis: "このページを編集" - translateThis: "このページを翻訳" + editThis: "编辑本页面" + translateThis: "翻译本页面" _aboutMisskey: title: "Misskeyについて" description: "Misskeyをはじめて知ったかたや、これから使うかた向け！基本的なしくみや機能を見ていきましょう。" _changelog: - title: "リリースノート" + title: "发布日志" description: "Misskeyのバージョンアップ履歴をご覧いただけます。最新のバージョンで何が変わったのかを確認しましょう！" _forUsers: title: "Misskeyユーザー向け" @@ -154,9 +156,9 @@ _docs: next: "次へ" _toc: title: "このページの内容" - toPageTop: "ページ上部に戻る" + toPageTop: "回到顶部" _blog: - title: "ブログ" + title: "博客" description: "Misskey開発本部から、Misskeyに関する最新情報やTips等をお届けします！（日本語のみ）" back: "戻る" _content: @@ -179,7 +181,7 @@ _brandAssets: _links: title: "リンク" _github: - title: "Github" + title: "GitHub" description: "Misskeyの開発はGithub上で行われています。機能リクエストやバグ報告などはこちらから行えます。" _crowdin: title: "Crowdin" @@ -197,6 +199,8 @@ _tools: menuToggle: "メニュー" _forUsers: title: "Misskeyユーザー向け" + _forAdmin: + title: "サーバー運営者向け" _mfmPlayground: title: "MFMお試しコーナー" description: "MFMを自由に練習できます！Misskeyの投稿画面・ノートの画面を再現！" @@ -242,13 +246,13 @@ _aboutUs: description: "Misskeyの翻訳に協力いただいている皆さんです。" _i18n: _missing: - title: "翻訳にご協力ください" - description: "このドキュメントはコミュニティによる翻訳です。ドキュメントの翻訳は{link}から行えます。ご協力をお願いします🙏" + title: "请协助我们进行翻译" + description: "本文档为社区翻译，您可以通过 {link} 翻译该文档。我们需要您的帮助🙏" linkLabel: "Crowdin" _share: title: "Misskeyへノート" chooseServer: "ノートするサーバーを選択してください" - addServer: "サーバーを追加" + addServer: "添加服务器" domain: "サーバーのドメイン" compatibleWith: "Misskeyと、一部のMisskeyフォークに対応しています。" recommendedByWebsite: "シェア元Webサイトからのおすすめ" @@ -295,6 +299,17 @@ _avatarDecorationPreview: username: "藍" noteText: "チョコのかかったドーナツを食べました🍩😋" profileDescription: "Misskey常駐AIの藍です！よろしくお願いします♪" +_customEmojiPreview: + title: "カスタム絵文字 プレビュー" + description: "カスタム絵文字の視認性をチェックできます。" + preview: "プレビュー" + emoji: "絵文字 #{number}" + placeholder: "「追加」から、カスタム絵文字を追加してプレビューできます。" + _options: + text: "ノート文面" + textDescription: "追加したカスタム絵文字は{emoji_id}で参照できます。" + _placeholder: + noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" _api: _permissions: title: "権限" @@ -336,3 +351,52 @@ _api: "write:flash": "Playを操作する" "read:flash-likes": "Playのいいねを見る" "write:flash-likes": "Playのいいねを操作する" + "read:admin:abuse-user-reports": "ユーザーからの通報を見る" + "write:admin:delete-account": "ユーザーアカウントを削除する" + "write:admin:delete-all-files-of-a-user": "ユーザーのすべてのファイルを削除する" + "read:admin:index-stats": "データベースインデックスに関する情報を見る" + "read:admin:table-stats": "データベーステーブルに関する情報を見る" + "read:admin:user-ips": "ユーザーのIPアドレスを見る" + "read:admin:meta": "インスタンスのメタデータを見る" + "write:admin:reset-password": "ユーザーのパスワードをリセットする" + "write:admin:resolve-abuse-user-report": "ユーザーからの通報を解決する" + "write:admin:send-email": "メールを送る" + "read:admin:server-info": "サーバーの情報を見る" + "read:admin:show-moderation-log": "モデレーションログを見る" + "read:admin:show-user": "ユーザーのプライベートな情報を見る" + "read:admin:show-users": "ユーザーのプライベートな情報を見る" + "write:admin:suspend-user": "ユーザーを凍結する" + "write:admin:unset-user-avatar": "ユーザーのアバターを削除する" + "write:admin:unset-user-banner": "ユーザーのバーナーを削除する" + "write:admin:unsuspend-user": "ユーザーの凍結を解除する" + "write:admin:meta": "インスタンスのメタデータを操作する" + "write:admin:user-note": "モデレーションノートを操作する" + "write:admin:roles": "ロールを操作する" + "read:admin:roles": "ロールを見る" + "write:admin:relays": "リレーを操作する" + "read:admin:relays": "リレーを見る" + "write:admin:invite-codes": "招待コードを操作する" + "read:admin:invite-codes": "招待コードを見る" + "write:admin:announcements": "お知らせを操作する" + "read:admin:announcements": "お知らせを見る" + "write:admin:avatar-decorations": "アバターデコレーションを操作する" + "read:admin:avatar-decorations": "アバターデコレーションを見る" + "write:admin:federation": "連合に関する情報を操作する" + "write:admin:account": "ユーザーアカウントを操作する" + "read:admin:account": "ユーザーに関する情報を見る" + "write:admin:emoji": "絵文字を操作する" + "read:admin:emoji": "絵文字を見る" + "write:admin:queue": "ジョブキューを操作する" + "read:admin:queue": "ジョブキューに関する情報を見る" + "write:admin:promo": "プロモーションノートを操作する" + "write:admin:drive": "ユーザーのドライブを操作する" + "read:admin:drive": "ユーザーのドライブの関する情報を見る" + "read:admin:stream": "管理者用のWebsocket APIを使う" + "write:admin:ad": "広告を操作する" + "read:admin:ad": "広告を見る" + "write:invite-codes": "招待コードを作成する" + "read:invite-codes": "招待コードを取得する" + "write:clip-favorite": "クリップのいいねを操作する" + "read:clip-favorite": "クリップのいいねを見る" + "read:federation": "連合に関する情報を取得する" + "write:report-abuse": "違反を報告する" diff --git a/locales/zh-TW.yml b/locales/zh-TW.yml index fe3506d7..f69fb930 100644 --- a/locales/zh-TW.yml +++ b/locales/zh-TW.yml @@ -6,7 +6,10 @@ copy: "複製" share: "分享" note: "貼文" other: "其他" -goToLegacyHub: "従来のMisskey Hub" +add: "新增" +browse: "参照" +settings: "設定" +goToLegacyHub: "舊版的 Misskey Hub" _error: notFound: "找不到此頁面" notFoundDesc: "找不到此頁面，請確認網址是否正確。" @@ -126,9 +129,9 @@ _servers: notFound: "未找到符合指定條件的伺服器。" showMore: "查看更多" _view: - title: "表示形式" - list: "リスト" - grid: "グリッド" + title: "顯示樣式" + list: "精簡" + grid: "完整" _docs: title: "文件" description: "Misskey 是一個開源去中心化社群網路平台。它涵蓋了從如何正確使用 Misskey 到為伺服器營運者和程式開發人員提供的資訊的所有內容。" @@ -196,6 +199,8 @@ _tools: menuToggle: "選單" _forUsers: title: "針對 Misskey 的使用者" + _forAdmin: + title: "サーバー運営者向け" _mfmPlayground: title: "MFM 試用區" description: "您可以自由練習MFM！下面重現了 Misskey 的發文畫面/貼文畫面！" @@ -233,6 +238,12 @@ _aboutUs: _orgPartner: title: "企業和組織合作夥伴" description: "這些公司和組織在資金和技術上為 Misskey 的發展做出了貢獻。" + _hubTranslators: + title: "Misskey Hub 翻譯者" + description: "感謝所有幫助我們翻譯 Misskey Hub 的人。" + _coreTranslators: + title: "Misskey 翻譯者" + description: "感謝所有幫助我們翻譯 Misskey 的人。" _i18n: _missing: title: "請協助翻譯" @@ -244,6 +255,7 @@ _share: addServer: "新增伺服器" domain: "伺服器的網域" compatibleWith: "相容 Misskey 與部份 Misskey 分支。" + recommendedByWebsite: "來自分享網站的推薦" _noteVisibility: public: "公開" home: "首頁" @@ -258,6 +270,8 @@ _shareLinkGenerator: url: "網址" urlCaption: "可選。將插入在正文之後。" settings: "進階設定" + manualInstance: "推薦的伺服器網域" + manualInstanceDescription: "此處指定的伺服器（一個）可以顯示在共用按鈕中繼頁面的頂部。例如，您可以用它將人們引導到自己的伺服器。" visibility: "公開範圍" recipents: "指定接收訊息的帳號（以換行符號區分）" resultLink: "連結生成結果" @@ -268,6 +282,34 @@ _shareLinkGenerator: _goToMisskey: title: "前往 Misskey Web" heading: "請選擇要開啟此頁面的伺服器" +_avatarDecorationPreview: + title: "頭像裝飾預覽" + description: "您可以檢查頭像裝飾是否正確反映。" + preview: "預覽" + settings: "設定" + decoration: "裝飾 #{number}" + placeholder: "您可以透過「新增」按鈕來新增和預覽頭像裝飾。" + _options: + offsetX: "水平對齊" + offsetY: "垂直對齊" + angle: "角度" + flip: "左右翻轉" + overlayTemplate: "疊加模板" + _placeholder: + username: "小藍" + noteText: "我吃了一個巧克力甜甜圈🍩😋" + profileDescription: "我是 Misskey 的常駐人工智慧小藍！很高興見到你♪" +_customEmojiPreview: + title: "カスタム絵文字 プレビュー" + description: "カスタム絵文字の視認性をチェックできます。" + preview: "プレビュー" + emoji: "絵文字 #{number}" + placeholder: "「追加」から、カスタム絵文字を追加してプレビューできます。" + _options: + text: "ノート文面" + textDescription: "追加したカスタム絵文字は{emoji_id}で参照できます。" + _placeholder: + noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" _api: _permissions: title: "權限" @@ -281,31 +323,80 @@ _api: "write:drive": "存取雲端硬碟" "read:favorites": "瀏覽我的最愛" "write:favorites": "編輯我的最愛列表" - "read:following": "フォローの情報を見る" - "write:following": "フォロー・フォロー解除する" - "read:messaging": "チャットを見る" - "write:messaging": "チャットを操作する" - "read:mutes": "ミュートを見る" - "write:mutes": "ミュートを操作する" - "write:notes": "ノートを作成・削除する" - "read:notifications": "通知を見る" - "write:notifications": "通知を操作する" - "read:reactions": "リアクションを見る" - "write:reactions": "リアクションを操作する" - "write:votes": "投票する" - "read:pages": "ページを見る" - "write:pages": "ページを操作する" - "read:page-likes": "ページのいいねを見る" - "write:page-likes": "ページのいいねを操作する" - "read:user-groups": "ユーザーグループを見る" - "write:user-groups": "ユーザーグループを操作する" - "read:channels": "チャンネルを見る" - "write:channels": "チャンネルを操作する" - "read:gallery": "ギャラリーを見る" - "write:gallery": "ギャラリーを操作する" - "read:gallery-likes": "ギャラリーのいいねを見る" - "write:gallery-likes": "ギャラリーのいいねを操作する" + "read:following": "查看追隨中的使用者資訊" + "write:following": "追隨／解除追隨" + "read:messaging": "顯示訊息" + "write:messaging": "撰寫或刪除訊息" + "read:mutes": "顯示已靜音列表" + "write:mutes": "編輯已靜音列表" + "write:notes": "撰寫或刪除貼文" + "read:notifications": "查看通知" + "write:notifications": "編輯通知" + "read:reactions": "查看反應" + "write:reactions": "編輯反應" + "write:votes": "投票" + "read:pages": "顯示頁面" + "write:pages": "編輯頁面" + "read:page-likes": "顯示已按讚的頁面" + "write:page-likes": "編輯頁面上的讚" + "read:user-groups": "顯示使用者群組" + "write:user-groups": "編輯使用者群組" + "read:channels": "瀏覽頻道" + "write:channels": "編輯頻道" + "read:gallery": "瀏覽相簿" + "write:gallery": "操作相簿" + "read:gallery-likes": "瀏覽相簿的讚" + "write:gallery-likes": "編輯相簿的讚" "read:flash": "Playを見る" "write:flash": "Playを操作する" "read:flash-likes": "Playのいいねを見る" "write:flash-likes": "Playのいいねを操作する" + "read:admin:abuse-user-reports": "ユーザーからの通報を見る" + "write:admin:delete-account": "ユーザーアカウントを削除する" + "write:admin:delete-all-files-of-a-user": "ユーザーのすべてのファイルを削除する" + "read:admin:index-stats": "データベースインデックスに関する情報を見る" + "read:admin:table-stats": "データベーステーブルに関する情報を見る" + "read:admin:user-ips": "ユーザーのIPアドレスを見る" + "read:admin:meta": "インスタンスのメタデータを見る" + "write:admin:reset-password": "ユーザーのパスワードをリセットする" + "write:admin:resolve-abuse-user-report": "ユーザーからの通報を解決する" + "write:admin:send-email": "メールを送る" + "read:admin:server-info": "サーバーの情報を見る" + "read:admin:show-moderation-log": "モデレーションログを見る" + "read:admin:show-user": "ユーザーのプライベートな情報を見る" + "read:admin:show-users": "ユーザーのプライベートな情報を見る" + "write:admin:suspend-user": "ユーザーを凍結する" + "write:admin:unset-user-avatar": "ユーザーのアバターを削除する" + "write:admin:unset-user-banner": "ユーザーのバーナーを削除する" + "write:admin:unsuspend-user": "ユーザーの凍結を解除する" + "write:admin:meta": "インスタンスのメタデータを操作する" + "write:admin:user-note": "モデレーションノートを操作する" + "write:admin:roles": "ロールを操作する" + "read:admin:roles": "ロールを見る" + "write:admin:relays": "リレーを操作する" + "read:admin:relays": "リレーを見る" + "write:admin:invite-codes": "招待コードを操作する" + "read:admin:invite-codes": "招待コードを見る" + "write:admin:announcements": "お知らせを操作する" + "read:admin:announcements": "お知らせを見る" + "write:admin:avatar-decorations": "アバターデコレーションを操作する" + "read:admin:avatar-decorations": "アバターデコレーションを見る" + "write:admin:federation": "連合に関する情報を操作する" + "write:admin:account": "ユーザーアカウントを操作する" + "read:admin:account": "ユーザーに関する情報を見る" + "write:admin:emoji": "絵文字を操作する" + "read:admin:emoji": "絵文字を見る" + "write:admin:queue": "ジョブキューを操作する" + "read:admin:queue": "ジョブキューに関する情報を見る" + "write:admin:promo": "プロモーションノートを操作する" + "write:admin:drive": "ユーザーのドライブを操作する" + "read:admin:drive": "ユーザーのドライブの関する情報を見る" + "read:admin:stream": "管理者用のWebsocket APIを使う" + "write:admin:ad": "広告を操作する" + "read:admin:ad": "広告を見る" + "write:invite-codes": "招待コードを作成する" + "read:invite-codes": "招待コードを取得する" + "write:clip-favorite": "クリップのいいねを操作する" + "read:clip-favorite": "クリップのいいねを見る" + "read:federation": "連合に関する情報を取得する" + "write:report-abuse": "違反を報告する"