From d7ad8387a9b590b4ed10f91a06d5f542f9f9a5aa 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: Fri, 29 Dec 2023 13:23:03 +0900 Subject: [PATCH] New Crowdin updates (#92) * New translations 1.about-misskey.md (French) * New translations 2.get-started.md (French) * New translations 3.join-server.md (French) * New translations 4.things-to-know.md (French) * New translations ads.md (French) * New translations drive.md (French) * New translations mfm.md (French) * New translations mute-and-block.md (French) * New translations pages.md (French) * New translations poll.md (French) * New translations thread-mute.md (French) * New translations webhook.md (French) * New translations 1.troubleshooting.md (French) * New translations donate.md (French) * New translations misskey-hub.md (French) * New translations announcement.md (French) * New translations role.md (French) * New translations 1.index.md (French) * New translations bash.md (French) * New translations docker.md (French) * New translations kubernetes.md (French) * New translations manual.md (French) * New translations ubuntu-manual.md (French) * New translations cdn.md (French) * New translations disable-timelines.md (French) * New translations 1.index.md (French) * New translations permission.md (French) * New translations 1.index.md (French) * New translations token.md (French) * New translations 5.releases.md (French) * New translations 1.about-misskey.md (Italian) * New translations 2.get-started.md (Italian) * New translations 3.join-server.md (Italian) * New translations 4.things-to-know.md (Italian) * New translations ads.md (Italian) * New translations drive.md (Italian) * New translations mfm.md (Italian) * New translations mute-and-block.md (Italian) * New translations pages.md (Italian) * New translations poll.md (Italian) * New translations share-form.md (Italian) * New translations thread-mute.md (Italian) * New translations webhook.md (Italian) * New translations 1.troubleshooting.md (Italian) * New translations donate.md (Italian) * New translations misskey-hub.md (Italian) * New translations announcement.md (Italian) * New translations role.md (Italian) * New translations 1.index.md (Italian) * New translations bash.md (Italian) * New translations docker.md (Italian) * New translations kubernetes.md (Italian) * New translations manual.md (Italian) * New translations ubuntu-manual.md (Italian) * New translations cdn.md (Italian) * New translations disable-timelines.md (Italian) * New translations 1.index.md (Italian) * New translations permission.md (Italian) * New translations 1.index.md (Italian) * New translations token.md (Italian) * New translations 5.releases.md (Italian) * New translations 1.about-misskey.md (Korean) * New translations 1.warning.md (Korean) * New translations 2.get-started.md (Korean) * New translations 3.join-server.md (Korean) * New translations 4.things-to-know.md (Korean) * New translations ads.md (Korean) * New translations drive.md (Korean) * New translations mfm.md (Korean) * New translations mute-and-block.md (Korean) * New translations pages.md (Korean) * New translations poll.md (Korean) * New translations share-form.md (Korean) * New translations thread-mute.md (Korean) * New translations webhook.md (Korean) * New translations 1.troubleshooting.md (Korean) * New translations donate.md (Korean) * New translations misskey-hub.md (Korean) * New translations announcement.md (Korean) * New translations role.md (Korean) * New translations 1.index.md (Korean) * New translations bash.md (Korean) * New translations docker.md (Korean) * New translations kubernetes.md (Korean) * New translations manual.md (Korean) * New translations ubuntu-manual.md (Korean) * New translations cdn.md (Korean) * New translations disable-timelines.md (Korean) * New translations 1.index.md (Korean) * New translations permission.md (Korean) * New translations 1.index.md (Korean) * New translations token.md (Korean) * New translations 5.releases.md (Korean) * New translations 1.about-misskey.md (Polish) * New translations 2.get-started.md (Polish) * New translations 3.join-server.md (Polish) * New translations 4.things-to-know.md (Polish) * New translations ads.md (Polish) * New translations drive.md (Polish) * New translations mfm.md (Polish) * New translations mute-and-block.md (Polish) * New translations pages.md (Polish) * New translations poll.md (Polish) * New translations share-form.md (Polish) * New translations thread-mute.md (Polish) * New translations webhook.md (Polish) * New translations 1.troubleshooting.md (Polish) * New translations donate.md (Polish) * New translations misskey-hub.md (Polish) * New translations announcement.md (Polish) * New translations role.md (Polish) * New translations 1.index.md (Polish) * New translations bash.md (Polish) * New translations docker.md (Polish) * New translations kubernetes.md (Polish) * New translations manual.md (Polish) * New translations ubuntu-manual.md (Polish) * New translations cdn.md (Polish) * New translations disable-timelines.md (Polish) * New translations 1.index.md (Polish) * New translations permission.md (Polish) * New translations 1.index.md (Polish) * New translations token.md (Polish) * New translations 5.releases.md (Polish) * New translations ja-jp.yml (Chinese Simplified) * New translations 1.about-misskey.md (Chinese Simplified) * New translations 2.get-started.md (Chinese Simplified) * New translations 3.join-server.md (Chinese Simplified) * New translations 4.things-to-know.md (Chinese Simplified) * New translations ads.md (Chinese Simplified) * New translations drive.md (Chinese Simplified) * New translations mfm.md (Chinese Simplified) * New translations mute-and-block.md (Chinese Simplified) * New translations pages.md (Chinese Simplified) * New translations poll.md (Chinese Simplified) * New translations share-form.md (Chinese Simplified) * 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 token.md (Chinese Simplified) * New translations 5.releases.md (Chinese Simplified) * 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 token.md (Chinese Traditional) * New translations publish-on-your-website.md (Chinese Traditional) * New translations 5.releases.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 token.md (English) * New translations 5.releases.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 token.md (Indonesian) * New translations 5.releases.md (Indonesian) --- content/cn/docs/1.about-misskey.md | 4 + .../2.for-users/2.onboarding/2.get-started.md | 4 + .../2.for-users/2.onboarding/3.join-server.md | 1 + .../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 | 6 + .../2.for-users/4.resources/misskey-hub.md | 2 + .../docs/3.for-admin/features/announcement.md | 1 + content/cn/docs/3.for-admin/features/role.md | 9 +- .../3.for-admin/install/guides/1.index.md | 3 + .../docs/3.for-admin/install/guides/bash.md | 2 + .../docs/3.for-admin/install/guides/docker.md | 4 + .../3.for-admin/install/guides/kubernetes.md | 2 + .../docs/3.for-admin/install/guides/manual.md | 9 + .../install/guides/ubuntu-manual.md | 22 + .../docs/3.for-admin/install/resources/cdn.md | 2 + .../moderation-tips/disable-timelines.md | 2 + .../cn/docs/4.for-developers/api/1.index.md | 4 +- .../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 | 8 + content/cn/docs/5.releases.md | 41 ++ content/en/docs/1.about-misskey.md | 139 ++--- .../2.for-users/2.onboarding/2.get-started.md | 7 +- .../2.for-users/2.onboarding/3.join-server.md | 1 + .../2.onboarding/4.things-to-know.md | 16 +- content/en/docs/2.for-users/3.features/ads.md | 9 +- .../en/docs/2.for-users/3.features/drive.md | 4 + content/en/docs/2.for-users/3.features/mfm.md | 10 + .../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 | 158 +++-- .../4.resources/1.troubleshooting.md | 4 + .../en/docs/2.for-users/4.resources/donate.md | 6 + .../2.for-users/4.resources/misskey-hub.md | 2 + .../docs/3.for-admin/features/announcement.md | 1 + content/en/docs/3.for-admin/features/role.md | 9 +- .../3.for-admin/install/guides/1.index.md | 5 +- .../docs/3.for-admin/install/guides/bash.md | 17 +- .../docs/3.for-admin/install/guides/docker.md | 7 +- .../3.for-admin/install/guides/kubernetes.md | 4 +- .../docs/3.for-admin/install/guides/manual.md | 9 + .../install/guides/ubuntu-manual.md | 24 +- .../docs/3.for-admin/install/resources/cdn.md | 4 +- .../moderation-tips/disable-timelines.md | 6 +- .../en/docs/4.for-developers/api/1.index.md | 4 +- .../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 | 8 + content/en/docs/5.releases.md | 41 ++ content/fr/docs/1.about-misskey.md | 4 + .../2.for-users/2.onboarding/2.get-started.md | 4 + .../2.for-users/2.onboarding/3.join-server.md | 1 + .../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 + .../2.for-users/3.features/thread-mute.md | 4 + .../fr/docs/2.for-users/3.features/webhook.md | 158 +++-- .../4.resources/1.troubleshooting.md | 4 + .../fr/docs/2.for-users/4.resources/donate.md | 6 + .../2.for-users/4.resources/misskey-hub.md | 2 + .../docs/3.for-admin/features/announcement.md | 1 + content/fr/docs/3.for-admin/features/role.md | 9 +- .../3.for-admin/install/guides/1.index.md | 3 + .../docs/3.for-admin/install/guides/bash.md | 17 +- .../docs/3.for-admin/install/guides/docker.md | 7 +- .../3.for-admin/install/guides/kubernetes.md | 4 +- .../docs/3.for-admin/install/guides/manual.md | 9 + .../install/guides/ubuntu-manual.md | 24 +- .../docs/3.for-admin/install/resources/cdn.md | 2 + .../moderation-tips/disable-timelines.md | 2 + .../fr/docs/4.for-developers/api/1.index.md | 4 +- .../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 | 8 + content/fr/docs/5.releases.md | 41 ++ content/id/docs/1.about-misskey.md | 4 + .../2.for-users/2.onboarding/2.get-started.md | 4 + .../2.for-users/2.onboarding/3.join-server.md | 1 + .../2.onboarding/4.things-to-know.md | 4 + content/id/docs/2.for-users/3.features/ads.md | 2 + .../id/docs/2.for-users/3.features/drive.md | 4 + content/id/docs/2.for-users/3.features/mfm.md | 10 + .../2.for-users/3.features/mute-and-block.md | 10 + .../id/docs/2.for-users/3.features/pages.md | 2 + .../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/donate.md | 6 + .../2.for-users/4.resources/misskey-hub.md | 2 + .../docs/3.for-admin/features/announcement.md | 1 + content/id/docs/3.for-admin/features/role.md | 9 +- .../3.for-admin/install/guides/1.index.md | 3 + .../docs/3.for-admin/install/guides/bash.md | 2 + .../docs/3.for-admin/install/guides/docker.md | 4 + .../3.for-admin/install/guides/kubernetes.md | 2 + .../docs/3.for-admin/install/guides/manual.md | 9 + .../install/guides/ubuntu-manual.md | 22 + .../docs/3.for-admin/install/resources/cdn.md | 2 + .../moderation-tips/disable-timelines.md | 2 + .../id/docs/4.for-developers/api/1.index.md | 4 +- .../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 | 8 + content/id/docs/5.releases.md | 41 ++ content/it/docs/1.about-misskey.md | 4 + .../2.for-users/2.onboarding/2.get-started.md | 4 + .../2.for-users/2.onboarding/3.join-server.md | 1 + .../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 | 6 + .../2.for-users/4.resources/misskey-hub.md | 2 + .../docs/3.for-admin/features/announcement.md | 1 + content/it/docs/3.for-admin/features/role.md | 9 +- .../3.for-admin/install/guides/1.index.md | 3 + .../docs/3.for-admin/install/guides/bash.md | 17 +- .../docs/3.for-admin/install/guides/docker.md | 7 +- .../3.for-admin/install/guides/kubernetes.md | 4 +- .../docs/3.for-admin/install/guides/manual.md | 9 + .../install/guides/ubuntu-manual.md | 24 +- .../docs/3.for-admin/install/resources/cdn.md | 2 + .../moderation-tips/disable-timelines.md | 2 + .../it/docs/4.for-developers/api/1.index.md | 4 +- .../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 | 8 + content/it/docs/5.releases.md | 41 ++ content/ko/docs/1.about-misskey.md | 12 +- .../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 | 3 +- .../2.onboarding/4.things-to-know.md | 14 +- content/ko/docs/2.for-users/3.features/ads.md | 9 +- .../ko/docs/2.for-users/3.features/drive.md | 24 +- 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 | 44 +- .../ko/docs/2.for-users/3.features/poll.md | 32 +- .../docs/2.for-users/3.features/share-form.md | 96 +-- .../2.for-users/3.features/thread-mute.md | 14 +- .../ko/docs/2.for-users/3.features/webhook.md | 120 ++-- .../4.resources/1.troubleshooting.md | 45 +- .../ko/docs/2.for-users/4.resources/donate.md | 10 +- .../2.for-users/4.resources/misskey-hub.md | 8 +- .../docs/3.for-admin/features/announcement.md | 3 +- content/ko/docs/3.for-admin/features/role.md | 11 +- .../3.for-admin/install/guides/1.index.md | 5 +- .../docs/3.for-admin/install/guides/bash.md | 222 +++---- .../docs/3.for-admin/install/guides/docker.md | 39 +- .../3.for-admin/install/guides/kubernetes.md | 36 +- .../docs/3.for-admin/install/guides/manual.md | 87 +-- .../install/guides/ubuntu-manual.md | 558 +++++++++--------- .../docs/3.for-admin/install/resources/cdn.md | 4 +- .../moderation-tips/disable-timelines.md | 6 +- .../ko/docs/4.for-developers/api/1.index.md | 4 +- .../docs/4.for-developers/api/permission.md | 4 +- .../4.for-developers/api/streaming/1.index.md | 165 +++--- content/ko/docs/4.for-developers/api/token.md | 114 ++-- content/ko/docs/5.releases.md | 73 ++- content/pl/docs/1.about-misskey.md | 4 + .../2.for-users/2.onboarding/2.get-started.md | 4 + .../2.for-users/2.onboarding/3.join-server.md | 1 + .../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 | 158 +++-- .../4.resources/1.troubleshooting.md | 4 + .../pl/docs/2.for-users/4.resources/donate.md | 6 + .../2.for-users/4.resources/misskey-hub.md | 2 + .../docs/3.for-admin/features/announcement.md | 1 + content/pl/docs/3.for-admin/features/role.md | 9 +- .../3.for-admin/install/guides/1.index.md | 3 + .../docs/3.for-admin/install/guides/bash.md | 17 +- .../docs/3.for-admin/install/guides/docker.md | 7 +- .../3.for-admin/install/guides/kubernetes.md | 4 +- .../docs/3.for-admin/install/guides/manual.md | 9 + .../install/guides/ubuntu-manual.md | 24 +- .../docs/3.for-admin/install/resources/cdn.md | 2 + .../moderation-tips/disable-timelines.md | 2 + .../pl/docs/4.for-developers/api/1.index.md | 4 +- .../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 | 8 + content/pl/docs/5.releases.md | 41 ++ content/tw/docs/1.about-misskey.md | 137 +++-- .../2.for-users/2.onboarding/2.get-started.md | 7 +- .../2.for-users/2.onboarding/3.join-server.md | 1 + .../2.onboarding/4.things-to-know.md | 16 +- content/tw/docs/2.for-users/3.features/ads.md | 10 +- .../tw/docs/2.for-users/3.features/drive.md | 26 +- content/tw/docs/2.for-users/3.features/mfm.md | 40 +- .../2.for-users/3.features/mute-and-block.md | 62 +- .../tw/docs/2.for-users/3.features/pages.md | 48 +- .../tw/docs/2.for-users/3.features/poll.md | 32 +- .../docs/2.for-users/3.features/share-form.md | 68 ++- .../2.for-users/3.features/thread-mute.md | 14 +- .../tw/docs/2.for-users/3.features/webhook.md | 152 +++-- .../4.resources/1.troubleshooting.md | 67 ++- .../tw/docs/2.for-users/4.resources/donate.md | 10 +- .../2.for-users/4.resources/misskey-hub.md | 8 +- .../docs/3.for-admin/features/announcement.md | 1 + content/tw/docs/3.for-admin/features/role.md | 11 +- .../3.for-admin/install/guides/1.index.md | 5 +- .../docs/3.for-admin/install/guides/bash.md | 17 +- .../docs/3.for-admin/install/guides/docker.md | 36 +- .../3.for-admin/install/guides/kubernetes.md | 4 +- .../docs/3.for-admin/install/guides/manual.md | 83 +-- .../install/guides/ubuntu-manual.md | 24 +- .../docs/3.for-admin/install/resources/cdn.md | 4 +- .../moderation-tips/disable-timelines.md | 6 +- .../tw/docs/4.for-developers/api/1.index.md | 4 +- .../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 | 120 ++-- .../publish-on-your-website.md | 4 +- content/tw/docs/5.releases.md | 51 +- locales/zh-CN.yml | 60 +- 250 files changed, 3316 insertions(+), 1686 deletions(-) diff --git a/content/cn/docs/1.about-misskey.md b/content/cn/docs/1.about-misskey.md index a67dba09..4fb377d2 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) + ::: ## 開発に参加する、プロジェクトを支援する 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..832a67be 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,9 +11,11 @@ Misskeyを利用するには、どこかのサーバーにアカウントを作 [サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。 :::tip + どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 :::g-details{summary='詳細'} + Misskeyには連合機能が備わっています。 連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。 @@ -31,5 +33,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..699a1e15 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,6 +3,7 @@ 登録するサーバーが決まったら、さっそくアカウントを作成しましょう。 :::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..5be60bb3 100644 --- a/content/cn/docs/2.for-users/4.resources/donate.md +++ b/content/cn/docs/2.for-users/4.resources/donate.md @@ -13,10 +13,13 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip + 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 + ::: :::tip + 額に応じて以下の返礼を用意しています。 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 @@ -25,8 +28,11 @@ 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..1f934100 100644 --- a/content/cn/docs/3.for-admin/features/announcement.md +++ b/content/cn/docs/3.for-admin/features/announcement.md @@ -5,6 +5,7 @@ お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。 :::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..d84e7aa0 100644 --- a/content/cn/docs/3.for-admin/features/role.md +++ b/content/cn/docs/3.for-admin/features/role.md @@ -21,6 +21,7 @@ - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) :::warning + コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 - 手動でのアサイン/アサイン解除は行えません。 @@ -53,6 +54,7 @@ **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** :::tip + 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 @@ -62,7 +64,8 @@ - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ::: + +::: ### ベースロールの値を使用 @@ -85,11 +88,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..f01b059d 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,10 +7,13 @@ description: Misskeyサーバーの作成方法についての案内です。 Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::warning + 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。 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..2b0b84be 100644 --- a/content/cn/docs/3.for-admin/install/guides/docker.md +++ b/content/cn/docs/3.for-admin/install/guides/docker.md @@ -7,7 +7,9 @@ description: このガイドはDockerを使ったMisskeyセットアップ方法 このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::tip{label='前提条件'} @@ -59,7 +61,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..250b3fab 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,6 +164,7 @@ sudo systemctl restart misskey ``` :::tip + ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: - `pnpm run clean`または`pnpm run clean-all` 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/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/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/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..9c25afc2 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 + アクセストークンは他人に知られないようにしてください。 + ::: ### アプリケーション利用者にアクセストークンの発行をリクエストする @@ -39,7 +43,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger + このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: #### Step 2 @@ -119,7 +125,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/5.releases.md b/content/cn/docs/5.releases.md index b7879489..c54e5eb9 100644 --- a/content/cn/docs/5.releases.md +++ b/content/cn/docs/5.releases.md @@ -6,6 +6,47 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2023.12.2 + +### 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 diff --git a/content/en/docs/1.about-misskey.md b/content/en/docs/1.about-misskey.md index 0c247495..620e093c 100644 --- a/content/en/docs/1.about-misskey.md +++ b/content/en/docs/1.about-misskey.md @@ -15,16 +15,12 @@ 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. -::: With anyone being able to join its development, Misskey is still continually being actively developed. -## What does "Decentralized" mean? +::: -A Decentralized service, refers to a service which features the division of a community into many servers that all mutually communicate (federate) with each other to share their contents, building a network (Fediverse). -Services for which only one server exists, or for which many independent server exist, are called centralized. Most services fall under the category of centralized, some examples for this are Twitter (X) or Facebook. -The advantage of decentralized services is being able to select the administration or server theme that suits you freely.It's also possible for you to make your own server.Thanks to the federated nature, you will be able to access the same communities, no matter which server you choose. +誰でも開発に参加することができ、現在でも活発に開発が続いています。 ## Always Open-Source @@ -34,117 +30,128 @@ Open source has many merits, including allowing anyone being able to make change For realizing the distributed nature of Misskey, this concept of open source is indispensable. Using the same example as before, most profit-oriented services like Twitter, Facebook etc. are not open source. +## 常にオープンソース + +Misskeyはこれまでもこれからも、オープンソースであり続けます。オープンソースとは、簡単に言うとソフトウェアのソースコード(プログラム)が公開されていることです。ソースコードの修正や再配布が可能であることを定義に含めることもあります。 +Misskeyのすべてのソースコードは[AGPL](https://github.com/misskey-dev/misskey/blob/develop/LICENSE)というオープンソースライセンスの下に[公開](https://github.com/misskey-dev)されていて、誰でも自由に閲覧、使用、修正、改変、再配布をすることができます。 +オープンソースは、自分で好きなように変えたり、有害な処理が含まれていないことを確認することができたり、誰でも開発に参加できるなどの、様々なメリットがあります。 +上述の分散型を実現するためにも、オープンソースであるということは必要不可欠な要素です。 +再び引き合いに出しますが、TwitterやFacebookなどの利益を得ているほとんどのサービスはオープンソースではありません。 + :::tip -Technically speaking, Misskey's source code is managed via Git, and the repository is hosted on [GitHub](https://github.com/misskey-dev) + +技術的に言うと、MisskeyのソースコードはGitで管理されていて、リポジトリは[GitHub上でホスティングされています。](https://github.com/misskey-dev) + ::: -## Joining development and supporting the project +## Participating in discussions -If you like Misskey, please support the project.Supporting the project can be done in many ways, with some of them introduced below\.Some of these do not require programming skills, so anyone can feel free to support Misskey their own way.We are always looking forward to hearing from you. - -### Adding features or fixing bugs - -If you possess software engineering skills, you can contribute to the project through editing the source code. -For guidelines regarding this, please see [here](https://github.com/misskey-dev/misskey/blob/develop/CONTRIBUTING.md). - -### Participating in discussions - -You can contribute by sharing your opinion on new or existing features, as well as by reporting bugs. -Such discussions can be held at [GitHub](https://github.com/misskey-dev) or the [Forums](https://forum.misskey.io/) and so on. +Misskeyを気に入っていただけたら、ぜひプロジェクトを支援してください。プロジェクトに貢献するには、以下で紹介するようにいろいろな方法があります。方法によっては開発のスキルは不要なので、誰でも気軽に参加し貢献することができます。いつでもお待ちしています。 ### Translating text -Misskey is available in many languages (also called i18n, which is an abbreviation for Internationalization).While the original language is generally japanese, volunteers are translating Misskey into other languages. -Helping out with this translation work is also a form of contributing. -Misskey uses a service called [Crowdin to manage its translations.](https://crowdin.com/project/misskey) +ソフトウェアエンジニアのスキルをお持ちの方であれば、ソースコードを編集する形でプロジェクトに貢献することができます。 +貢献についてのガイドは[こちら](https://github.com/misskey-dev/misskey/blob/develop/CONTRIBUTING.md)です。 ### Sharing your impressions -Besides reporting bugs, please also feel free to share positive impressions such as which parts of Misskey you personally like, or things about Misskey that you find fun.As things like these serve as motivation for the developers, it also counts as indirect support for the project. +新しい機能、または既存の機能について意見を述べたり、不具合を報告したりすることでも貢献できます。 +そのようなディスカッションは[GitHub](https://github.com/misskey-dev)上か、[フォーラム](https://forum.misskey.io/)等で行われます。 ### Increasing the number of Misskists -"Misskist" refers to the people using Misskey. -By spreading the word about Misskey through introducing it to your acquaintances, the number of Misskists may increase, which serves as motivation for the developers. +Misskeyは様々な言語に対応しています(i18n -internationalizationの略- と呼ばれます)。元の言語は基本的に日本語ですが、有志によって他の言語へと翻訳されています。 +その翻訳作業に加わっていただくことでもMisskeyに貢献できます。 +Misskeyは[Crowdinというサービスを使用して翻訳の管理を行っています。](https://crowdin.com/project/misskey) ### Making donations -[Please click here](/docs/for-users/resources/donate/) +不具合報告等だけではなく、Misskeyの良い点、楽しい点といったポジティブな意見もぜひ共有してください。開発の励みになり、それは間接的ですがプロジェクトへの貢献です。 -## Frequently Asked Questions +### Frequently Asked Questions -### What is this project aiming to achieve? +ミスキストとは、Misskeyを使用する人のことです。 +知り合いに紹介するなどしてMisskeyを広めていただければ、ミスキストが増え開発のモチベーションが上がります。 -To put it bluntly, while this is a bit vague, Misskey is aiming to be a widely-used all-purpose platform. -Unlike other platforms, Misskey is not grounded in a specific idea (for example, anti-centralization) or vision and being developed with that in mind, so it's a bit "aimless" in this respect. -On the other hand though, this creates a flexibility due to not being bound by a specific direction to go towards. +### 寄付をする + +[こちらをご覧ください](/docs/for-users/resources/donate/) + +## Is Misskey being developed by a company? + +### プロジェクトは何を目指していますか？ + +強いて言うと、漠然的になりますが広く使われる汎用的なプラットフォームになることを目指しています。 +Misskeyは他のプロジェクトとは違い、何らかの思想(例えば、反中央集権)やビジョンに基づいて開発が行われているわけではなく、その点ではフラットです。 +それが逆に、特定の方向性に縛られないフレキシブルさを生み出すことに繋がっていると感じています。 -### Is Misskey being developed by a company? - -No.Misskey is being developed by an individual person and not commercialized through connection with any particular company. -Development members are generally volunteers. -Additionally, while there are some corporate sponsors, development is still centered around the community. - -### Who is managing Misskey? - -Due to the decentralized nature of Misskey, each individual server has their own administration.Therefore, not all of Misskey is managed by one individual person or company. -This means that, as the development team does not control individual servers, for management-related questions you should contact your server's administration instead. -The administrator of a server can be found on the server's information page. -If you were to create a server, then you would also become its administrator. - ### Which server should I choose? [A list of servers is available here.](/servers/) Depending on the server, its community or central theme (for example, liking a show) may vary, so if there is a server that suits your interests, joining it would likely be a good choice. Besides that, server size, userbase, country or spoken language, reliance or trust in the administration team and many other things can also serve as criteria. -There is however no single server that serves as the official server of Misskey.You also have the choice of creating a new server of your own. +There is however no single server that serves as the official server of Misskey. -Generally speaking, no matter which server you join, you will still be able to connect with users from all other servers. +### 誰が運営していますか？ -### How can I create my own server? +Misskeyは分散型なため、各サーバーにそれぞれ異なった運営者がいます。従って、特定の個人や企業によって、Misskeyの全てが運営されているわけではありません。 +また、開発チームが運営を行うわけでもないため、運営に関する連絡は、お使いのサーバーの運営者に行ってください。 +サーバーの運営者は、サーバーの情報ページで確認することができます。 +あなたがサーバーを作成すれば、あなたが運営者になります。 -Thank you for having an interest in creating a Misskey server. -As of 2022 there is no specialized Misskey hosting service, so creating a new server requires a certain amount of knowledge. -Please see [here](/docs/for-admin/install/) for instructions on how to create a server. +### どのサーバーを選べばいいですか？ -### What kind of technology does Misskey use? +[サーバー一覧が公開されています。](/servers/) +サーバーによってコミュニティのテーマ(特定のこと、ものが好き 等)が決められている場合があるので、自分に合ったテーマのサーバーがあれば、そこを選ぶと良いかもしれません。 +他にも、サーバーの規模、ユーザー層、国および言語、運営者が信頼できるかどうか、などの観点があります。 +なお、Misskey公式のサーバーというものはありません。自身で新しくサーバーを作成するという選択肢もあります。 -As development on Misskey progressed, the technology it has used has changed greatly.In the beginning, it used a combination of MySQL + PHP + jQuery, but currently uses the following. +基本的にどのサーバーを選んだとしても、他の全てのサーバーのユーザーと繋がることができます。 -- Server-side: Node.js -- Database: PostgreSQL, Redis -- UI Framework: Vue.js -- Programming language: TypeScript +### サーバーを建てるにはどうしたらいいですか？ In addition to this, from Misskey derived technology such as MFM or AiScript are also being used. ### Is this a fork of Mastodon? No.Misskey is a project completely different from Mastodon or other alike projects. -It has been in development for a long time already.However, it only became a decentralized network after the appearance of Mastodon. -Besides both projects implementing the ActivityPub protocol, there is no relation between the two. +It has been in development for a long time already. -### Are there any apps for iOS / Android available? +- サーバーサイド: Node.js +- データベース: PostgreSQL、Redis +- UIフレームワーク: Vue.js +- プログラミング言語: TypeScript We do not officially develop native apps for those operating systems, but there are several third-party apps available. Please see [here](/docs/for-users/resources/apps/) for more information. -However, functionality of third-party applications will inevitably lag behind the official Web client, so unless you really want to use a native application, we recommend the official Web client instead. -As the Misskey Web client supports PWA, it is also possible to make it act as if it was a native application instead.. +### Mastodonのフォークですか？ -### Where can I download Misskey's logo or icon? +いいえ。MisskeyはMastodonやその他のプロジェクトとは全く別のプロジェクトです。 +開発に関しても、Misskeyの方が昔から開発されています。ただし、分散型になったのはMastodonの登場より後です。 +同じActivityPubという分散のためのプロトコルを実装しているという点以外、両者に特に関りがあるわけでもありません。 -[Click here](/brand-assets/) +### iOS/Androidのアプリはありますか？ -### Who are those cute cat-eared girls that you see sometimes? +公式にはそういったOSのネイティブアプリを開発していませんが、サードパーティ製のアプリがいくつかあります。 +詳しくは[こちら](/docs/for-users/resources/apps/)をご覧ください。 + +ただ、サードパーティ製アプリはどうしても機能への対応が遅れてしまうため、とくに拘りがなければ公式のWebクライアントの利用をおすすめします。 +なお、MisskeyのWebクライアントはPWAに対応しているので、ネイティブアプリのように動作させることも可能です。 + +### Misskeyのロゴ、アイコンはどこで入手できますか？ + +[こちら](/brand-assets/) + +### 時折目にする猫耳の可愛い女の子は？ :::fukidashi{chara="doya_ai" charaName="藍"} -For more information about me, please visit [this website](https://xn--931a.moe/)! +わたしについては[このホームページ](https://xn--931a.moe/)をご覧ください！ ::: :::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"} -It's Misskey's guardian deity, Ai.(They called Ai cute, yay!) +Misskeyの守り神、藍ちゃんです。ｱｲﾁｬﾝｶﾜｲｲﾔｯﾀｰ! ::: 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..f3430264 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 @@ -11,11 +11,14 @@ To use Misskey, you create an account on one of these servers and use that serve You can choose any server from the [server list](/servers/). :::tip -どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 :::g-details{summary='Details'} Misskey has federated functionality. +:::g-details{summary='詳細'} + +Misskeyには連合機能が備わっています。 + 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 +34,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..3415de70 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,6 +3,7 @@ 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. 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..8a5bd05f 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,17 +7,21 @@ 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/)". + +詳細は、「[ノート](/docs/for-users/features/note/)」をご覧ください。 + ::: -## Timelines +## タイムライン -Misskey has multiple timelines.The names alone may be a little confusing, so it is important to know what each of them do. +Misskeyは、複数のタイムラインを持っています。名前だけでは少々わかりにくいかと思いますので、それぞれがどのような働きをするのかを知っておきましょう。 :::tip -For more information, see "[Timeline](/docs/for-users/features/timeline/)". + +詳細は、「[タイムライン](/docs/for-users/features/timeline/)」をご覧ください。 + ::: -## Other +## その他 -Misskey also has many other features that make it fun to use!Please see [here](/docs/for-users/features/) for a description of all features! +その他にも、Misskeyには、使って楽しい機能が盛りだくさん！すべての機能に関する説明は[こちら](/docs/for-users/features/)に記載されていますので、ぜひご覧ください！ 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..410eb51a 100644 --- a/content/en/docs/2.for-users/3.features/ads.md +++ b/content/en/docs/2.for-users/3.features/ads.md @@ -4,9 +4,12 @@ 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) +## 広告の設定(管理者) -You can add, edit, delete ads on your server control panel. You can set images, target URL, shape, percentage of display of ads. +サーバーのコントロールパネルから広告の追加、編集、削除を行えます。 +広告には任意の画像、遷移先URL、形状、表示割合を設定できます。 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..6ec1aa36 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 + リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。 ``` @@ -83,8 +90,11 @@ 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..2061d91d 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上の様々なイベントをリアルタイムに受け取ることが可能です。 @@ -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/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..cc9f14b2 100644 --- a/content/en/docs/2.for-users/4.resources/donate.md +++ b/content/en/docs/2.for-users/4.resources/donate.md @@ -13,10 +13,13 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip + 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 + ::: :::tip + 額に応じて以下の返礼を用意しています。 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 @@ -25,10 +28,13 @@ 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..b24ee698 100644 --- a/content/en/docs/3.for-admin/features/announcement.md +++ b/content/en/docs/3.for-admin/features/announcement.md @@ -5,6 +5,7 @@ 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 diff --git a/content/en/docs/3.for-admin/features/role.md b/content/en/docs/3.for-admin/features/role.md index 6ed15743..d7aad8b5 100644 --- a/content/en/docs/3.for-admin/features/role.md +++ b/content/en/docs/3.for-admin/features/role.md @@ -21,6 +21,7 @@ - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) :::warning + コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 - 手動でのアサイン/アサイン解除は行えません。 @@ -53,6 +54,7 @@ **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** :::tip + 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 @@ -62,7 +64,8 @@ - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ::: + +::: ### ベースロールの値を使用 @@ -85,13 +88,17 @@ アサインする際にアサインされる期間を設定することが可能です。 :::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..42c6ee93 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,10 +7,13 @@ 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. 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..2b0b84be 100644 --- a/content/en/docs/3.for-admin/install/guides/docker.md +++ b/content/en/docs/3.for-admin/install/guides/docker.md @@ -7,7 +7,9 @@ description: このガイドはDockerを使ったMisskeyセットアップ方法 このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::tip{label='前提条件'} @@ -34,7 +36,6 @@ cp ./docker-compose_example.yml ./docker-compose.yml ``` `default.yml`と`docker.env`をファイル内の説明に従って編集してください。\ -\ また、必要に応じて、`docker-compose.yml`を編集します。(ポートを変更したい場合など) ## ビルドと初期化 @@ -60,9 +61,9 @@ GLHF✨ ## Misskeyのアップデート方法 :::warning -:::warning + アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 -::: + ::: ```sh 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..250b3fab 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,6 +164,7 @@ sudo systemctl restart misskey ``` :::tip + ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: - `pnpm run clean`または`pnpm run clean-all` 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/moderation-tips/disable-timelines.md b/content/en/docs/3.for-admin/moderation-tips/disable-timelines.md index 09f70108..482d5060 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/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/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..9c25afc2 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 + アクセストークンは他人に知られないようにしてください。 + ::: ### アプリケーション利用者にアクセストークンの発行をリクエストする @@ -39,7 +43,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger + このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: #### Step 2 @@ -119,7 +125,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/5.releases.md b/content/en/docs/5.releases.md index b7879489..c54e5eb9 100644 --- a/content/en/docs/5.releases.md +++ b/content/en/docs/5.releases.md @@ -6,6 +6,47 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2023.12.2 + +### 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 diff --git a/content/fr/docs/1.about-misskey.md b/content/fr/docs/1.about-misskey.md index a67dba09..4fb377d2 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) + ::: ## 開発に参加する、プロジェクトを支援する 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..832a67be 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,9 +11,11 @@ Misskeyを利用するには、どこかのサーバーにアカウントを作 [サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。 :::tip + どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 :::g-details{summary='詳細'} + Misskeyには連合機能が備わっています。 連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。 @@ -31,5 +33,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..699a1e15 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,6 +3,7 @@ 登録するサーバーが決まったら、さっそくアカウントを作成しましょう。 :::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/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..2061d91d 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上の様々なイベントをリアルタイムに受け取ることが可能です。 @@ -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/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..cc9f14b2 100644 --- a/content/fr/docs/2.for-users/4.resources/donate.md +++ b/content/fr/docs/2.for-users/4.resources/donate.md @@ -13,10 +13,13 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip + 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 + ::: :::tip + 額に応じて以下の返礼を用意しています。 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 @@ -25,10 +28,13 @@ 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..1f934100 100644 --- a/content/fr/docs/3.for-admin/features/announcement.md +++ b/content/fr/docs/3.for-admin/features/announcement.md @@ -5,6 +5,7 @@ お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。 :::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..d7aad8b5 100644 --- a/content/fr/docs/3.for-admin/features/role.md +++ b/content/fr/docs/3.for-admin/features/role.md @@ -21,6 +21,7 @@ - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) :::warning + コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 - 手動でのアサイン/アサイン解除は行えません。 @@ -53,6 +54,7 @@ **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** :::tip + 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 @@ -62,7 +64,8 @@ - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ::: + +::: ### ベースロールの値を使用 @@ -85,13 +88,17 @@ アサインする際にアサインされる期間を設定することが可能です。 :::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..f01b059d 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,10 +7,13 @@ description: Misskeyサーバーの作成方法についての案内です。 Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::warning + 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。 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..2b0b84be 100644 --- a/content/fr/docs/3.for-admin/install/guides/docker.md +++ b/content/fr/docs/3.for-admin/install/guides/docker.md @@ -7,7 +7,9 @@ description: このガイドはDockerを使ったMisskeyセットアップ方法 このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::tip{label='前提条件'} @@ -34,7 +36,6 @@ cp ./docker-compose_example.yml ./docker-compose.yml ``` `default.yml`と`docker.env`をファイル内の説明に従って編集してください。\ -\ また、必要に応じて、`docker-compose.yml`を編集します。(ポートを変更したい場合など) ## ビルドと初期化 @@ -60,9 +61,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..250b3fab 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,6 +164,7 @@ sudo systemctl restart misskey ``` :::tip + ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: - `pnpm run clean`または`pnpm run clean-all` 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/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/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/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..9c25afc2 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 + アクセストークンは他人に知られないようにしてください。 + ::: ### アプリケーション利用者にアクセストークンの発行をリクエストする @@ -39,7 +43,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger + このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: #### Step 2 @@ -119,7 +125,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/5.releases.md b/content/fr/docs/5.releases.md index b7879489..c54e5eb9 100644 --- a/content/fr/docs/5.releases.md +++ b/content/fr/docs/5.releases.md @@ -6,6 +6,47 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2023.12.2 + +### 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 diff --git a/content/id/docs/1.about-misskey.md b/content/id/docs/1.about-misskey.md index a67dba09..4fb377d2 100644 --- a/content/id/docs/1.about-misskey.md +++ b/content/id/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) + ::: ## 開発に参加する、プロジェクトを支援する 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..832a67be 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,9 +11,11 @@ Misskeyを利用するには、どこかのサーバーにアカウントを作 [サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。 :::tip + どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 :::g-details{summary='詳細'} + Misskeyには連合機能が備わっています。 連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。 @@ -31,5 +33,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..699a1e15 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,6 +3,7 @@ 登録するサーバーが決まったら、さっそくアカウントを作成しましょう。 :::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/ads.md b/content/id/docs/2.for-users/3.features/ads.md index 456c5790..72aa40ec 100644 --- a/content/id/docs/2.for-users/3.features/ads.md +++ b/content/id/docs/2.for-users/3.features/ads.md @@ -4,7 +4,9 @@ Misskeyではサーバーによる広告をタイムラインなどに表示で 広告の右上に表示されるアイコンをクリックすることで、当該の広告の表示頻度を下げることができます。 :::tip + 広告の総数が少ない場合は、表示頻度を下げた後も連続で表示される可能性があります。 + ::: ## 広告の設定(管理者) 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..81f0417d 100644 --- a/content/id/docs/2.for-users/3.features/drive.md +++ b/content/id/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/id/docs/2.for-users/3.features/mfm.md b/content/id/docs/2.for-users/3.features/mfm.md index 5771232a..6ec1aa36 100644 --- a/content/id/docs/2.for-users/3.features/mfm.md +++ b/content/id/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/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..6fa407ce 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 @@ -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/id/docs/2.for-users/3.features/pages.md b/content/id/docs/2.for-users/3.features/pages.md index 21a59a21..0bb1232f 100644 --- a/content/id/docs/2.for-users/3.features/pages.md +++ b/content/id/docs/2.for-users/3.features/pages.md @@ -3,7 +3,9 @@ Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。 :::warning + v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。 + ::: ## ページ設定 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/donate.md b/content/id/docs/2.for-users/4.resources/donate.md index a00e50ff..5be60bb3 100644 --- a/content/id/docs/2.for-users/4.resources/donate.md +++ b/content/id/docs/2.for-users/4.resources/donate.md @@ -13,10 +13,13 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip + 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 + ::: :::tip + 額に応じて以下の返礼を用意しています。 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 @@ -25,8 +28,11 @@ 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/announcement.md b/content/id/docs/3.for-admin/features/announcement.md index 54475e35..1f934100 100644 --- a/content/id/docs/3.for-admin/features/announcement.md +++ b/content/id/docs/3.for-admin/features/announcement.md @@ -5,6 +5,7 @@ お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。 :::warning + アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。 - 「既存ユーザーのみ」オプションを有効にしてお知らせを作成する diff --git a/content/id/docs/3.for-admin/features/role.md b/content/id/docs/3.for-admin/features/role.md index d8209cf8..d84e7aa0 100644 --- a/content/id/docs/3.for-admin/features/role.md +++ b/content/id/docs/3.for-admin/features/role.md @@ -21,6 +21,7 @@ - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) :::warning + コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 - 手動でのアサイン/アサイン解除は行えません。 @@ -53,6 +54,7 @@ **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** :::tip + 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 @@ -62,7 +64,8 @@ - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ::: + +::: ### ベースロールの値を使用 @@ -85,11 +88,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..f01b059d 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,10 +7,13 @@ description: Misskeyサーバーの作成方法についての案内です。 Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::warning + 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。 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..ad742294 100644 --- a/content/id/docs/3.for-admin/install/guides/bash.md +++ b/content/id/docs/3.for-admin/install/guides/bash.md @@ -20,7 +20,9 @@ Misskeyを簡単にインストールするためのシェルスクリプトが 3. Cloudflareアカウント（推奨） :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。 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..2b0b84be 100644 --- a/content/id/docs/3.for-admin/install/guides/docker.md +++ b/content/id/docs/3.for-admin/install/guides/docker.md @@ -7,7 +7,9 @@ description: このガイドはDockerを使ったMisskeyセットアップ方法 このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::tip{label='前提条件'} @@ -59,7 +61,9 @@ GLHF✨ ## Misskeyのアップデート方法 :::warning + アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 + ::: ```sh 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..250b3fab 100644 --- a/content/id/docs/3.for-admin/install/guides/manual.md +++ b/content/id/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,6 +164,7 @@ sudo systemctl restart misskey ``` :::tip + ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: - `pnpm run clean`または`pnpm run clean-all` 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/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/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/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..9c25afc2 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 + アクセストークンは他人に知られないようにしてください。 + ::: ### アプリケーション利用者にアクセストークンの発行をリクエストする @@ -39,7 +43,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger + このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: #### Step 2 @@ -119,7 +125,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/5.releases.md b/content/id/docs/5.releases.md index b7879489..c54e5eb9 100644 --- a/content/id/docs/5.releases.md +++ b/content/id/docs/5.releases.md @@ -6,6 +6,47 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2023.12.2 + +### 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 diff --git a/content/it/docs/1.about-misskey.md b/content/it/docs/1.about-misskey.md index a67dba09..4fb377d2 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) + ::: ## 開発に参加する、プロジェクトを支援する 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..832a67be 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,9 +11,11 @@ Misskeyを利用するには、どこかのサーバーにアカウントを作 [サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。 :::tip + どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 :::g-details{summary='詳細'} + Misskeyには連合機能が備わっています。 連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。 @@ -31,5 +33,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..699a1e15 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,6 +3,7 @@ 登録するサーバーが決まったら、さっそくアカウントを作成しましょう。 :::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..cc9f14b2 100644 --- a/content/it/docs/2.for-users/4.resources/donate.md +++ b/content/it/docs/2.for-users/4.resources/donate.md @@ -13,10 +13,13 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip + 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 + ::: :::tip + 額に応じて以下の返礼を用意しています。 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 @@ -25,10 +28,13 @@ 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..1f934100 100644 --- a/content/it/docs/3.for-admin/features/announcement.md +++ b/content/it/docs/3.for-admin/features/announcement.md @@ -5,6 +5,7 @@ お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。 :::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..d7aad8b5 100644 --- a/content/it/docs/3.for-admin/features/role.md +++ b/content/it/docs/3.for-admin/features/role.md @@ -21,6 +21,7 @@ - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) :::warning + コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 - 手動でのアサイン/アサイン解除は行えません。 @@ -53,6 +54,7 @@ **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** :::tip + 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 @@ -62,7 +64,8 @@ - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ::: + +::: ### ベースロールの値を使用 @@ -85,13 +88,17 @@ アサインする際にアサインされる期間を設定することが可能です。 :::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..f01b059d 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,10 +7,13 @@ description: Misskeyサーバーの作成方法についての案内です。 Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::warning + 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。 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..2b0b84be 100644 --- a/content/it/docs/3.for-admin/install/guides/docker.md +++ b/content/it/docs/3.for-admin/install/guides/docker.md @@ -7,7 +7,9 @@ description: このガイドはDockerを使ったMisskeyセットアップ方法 このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::tip{label='前提条件'} @@ -34,7 +36,6 @@ cp ./docker-compose_example.yml ./docker-compose.yml ``` `default.yml`と`docker.env`をファイル内の説明に従って編集してください。\ -\ また、必要に応じて、`docker-compose.yml`を編集します。(ポートを変更したい場合など) ## ビルドと初期化 @@ -60,9 +61,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..250b3fab 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,6 +164,7 @@ sudo systemctl restart misskey ``` :::tip + ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: - `pnpm run clean`または`pnpm run clean-all` 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/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/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/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..9c25afc2 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 + アクセストークンは他人に知られないようにしてください。 + ::: ### アプリケーション利用者にアクセストークンの発行をリクエストする @@ -39,7 +43,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger + このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: #### Step 2 @@ -119,7 +125,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/5.releases.md b/content/it/docs/5.releases.md index b7879489..c54e5eb9 100644 --- a/content/it/docs/5.releases.md +++ b/content/it/docs/5.releases.md @@ -6,6 +6,47 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2023.12.2 + +### 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 diff --git a/content/ko/docs/1.about-misskey.md b/content/ko/docs/1.about-misskey.md index dd0074d3..63f3726f 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/)를 참조하십시오. @@ -144,5 +148,5 @@ Misskey는 개발이 진행되면서 사용하는 기술도 크게 달라졌습 저에 대해서는 [이 홈페이지](https://xn--931a.moe/)를 참조해주세요! :::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..2fc49e64 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,7 +3,8 @@ 가입하고 싶은 서버를 정하시면, 바로 계정을 만들어봅시다. :::tip -ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 + +여기서는 Misskey.io를 예로 들었지만, 다른 서버에서도 등록 방법은 대체로 동일합니다. 다만, 가입하실 때 필요한 정보는 서버에 따라 다른 경우가 있습니다.자세한 내용은, 서버 관리자에게 확인해보시길 바랍니다. ::: 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/drive.md b/content/ko/docs/2.for-users/3.features/drive.md index dd874d4e..530e1eb9 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 (Not safe for work)는 드라이브에 있는 파일에 설정할 수 있는 플래그 입니다. 이 플래그는 직접 켜고 끌 수 있지만, 관리자에 의하여 설정되어지는 경우가 있습니다. + +::: + +## 센서티브 (NSFW) + +민감 또는 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..b26d34fb 100644 --- a/content/ko/docs/2.for-users/3.features/pages.md +++ b/content/ko/docs/2.for-users/3.features/pages.md @@ -3,24 +3,22 @@ Misskey상에서 노트와는 별개로 페이지를 작성할 수 있습니다.v13 이후에서는 정적 페이지에 특화되어 있습니다. :::warning -v13 이후에서는 페이지를 통한 동적 페이지 생성 대신 Misskey Play를 사용할 수 있습니다. + +v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。 + ::: -## 페이지 설정 +## ページ設定 -페이지에 관한 항목을 설정합니다.다음 항목을 입력할 수 있습니다. +ページに関する項目を設定します。次の項目を入力できます。 - 제목 -- 페이지 요약 -- 페이지 URL +- ページの要約 +- 페이지 주소 - 가운데 정렬 -- 폰트 -- 프로필에 고정한 경우 타이틀을 표시하지 않음 -- 아이캐치 이미지 - -### 제목 - -페이지의 제목을 입력합니다.이 제목은 페이지 목록에 표시됩니다. +- 글꼴 +- 프로필을 고정할 때 제목을 표시하지 않음 +- アイキャッチ画像 ### 페이지 요약 @@ -28,7 +26,7 @@ v13 이후에서는 페이지를 통한 동적 페이지 생성 대신 Misskey P ### 페이지 URL -`https://서버이름/@사용자/pages/●●●`의 `●●●`을 원하는 대로 설정할 수 있습니다. +簡単な説明を入力します。一覧に表示されます。 ### 가운데 정렬 @@ -44,20 +42,20 @@ v13 이후에서는 페이지를 통한 동적 페이지 생성 대신 Misskey P ### 아이캐치 이미지 -**아이캐치 이미지를 설정**에서 이미지를 설정할 수 있습니다.이 이미지는 페이지 목록에 표시됩니다. +ピン留めされているときにタイトルを非表示にします。 -## 콘텐츠 +### 콘텐츠 페이지 본문을 편집합니다.다음 블록을 하나 이상 조합해 페이지를 생성할 수 있습니다. -- 섹션 -- 텍스트 -- 이미지 -- 노트필기 +## コンテンツ -### 섹션 +ページ本体を編集します。次のブロックを一つまたは複数組み合わせてページを生成できます。 -제목을 설정해 묶을 수 있습니다.안에 블록을 추가할 수 있습니다. +- セクション +- テキスト +- 画像 +- ノート埋め込み ### 텍스트 @@ -70,3 +68,7 @@ v13 이후에서는 페이지를 통한 동적 페이지 생성 대신 Misskey P ### 노트필기 노트 ID를 넣는 것으로 그 노트를 표시합니다.다른 서버의 노트를 삽입하려면, 검색에서 해당 URL을 넣고 표시된 ID를 붙여주세요. + +### ノート埋め込み + +ノート ID を入れる事で、そのノートを表示します。他のサーバーを埋め込みたい場合は検索でそのURLを入れ、表示させた時のIDを貼り付けて下さい。 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..d16c7ba1 100644 --- a/content/ko/docs/2.for-users/3.features/poll.md +++ b/content/ko/docs/2.for-users/3.features/poll.md @@ -13,35 +13,39 @@ 너무 많이 추가했다면, 옆의 X 버튼을 눌러 삭제할 수 있습니다. :::warning -공백인 입력란이 하나라도 있다면, 그 투표가 첨부된 노트는 투고할 수 없습니다. + +いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。 + ::: -## 복수 응답 허용하기 - -'복수 응답 허용' 스위치를 켜면, 설문에 응답하는 사람이 여러 개의 선택지에 투표할 수 있게 됩니다. - ## 만료 시점 설정하기 투표 기간을 '일시 지정', '기간 지정' 중 하나로 설정할 수 있습니다. -설정하려면, '투표 기한' 란에서 '일시 지정' 또는 '경과 지정'을 선택합니다. +## アンケートの期限を設定する 설정한 기한을 취소하려면 '기한' 란에서 '무기한'을 선택합니다. -## 설문에 투표하기 +設定するには、「期限」の欄から「日時指定」もしくは「経過指定」をクリックします。 투표가 첨부된 노트가 타임라인에 있을 때, 투표를 해 봅시다. -투표하려면 선택지를 누릅니다.중복 투표가 불가하다면, 이 시점에서 투표 결과가 표시됩니다. +## アンケートに投票する -복수 응답이 가능한 투표에서는 다른 선택지에도 투표할 수 있습니다.이때에는 결과가 자동으로 표시되지 않습니다. +アンケートが添付されたノートがタイムラインに流れてきたときは、アンケートに投票してみましょう。 -복수 응답 설정에 관계없이 자동으로 설문 결과를 표시하지 않게 하거나 투표 전에 결과를 보고 싶은 경우에는, 선택지 하단의 '결과 보기'를 선택해 투표 결과를 표시할 수 있습니다. +アンケートに投票するには、各選択肢をクリックします。アンケートを投稿したユーザーが複数回答可に設定していない場合は、その時点でのアンケートの結果が表示されます。 -투표 결과를 다시 숨기려면 '투표하기'를 선택합니다. +アンケートを投稿したユーザーが複数回答可に設定していた場合、他の選択肢にも投票することができます。この場合、結果は自動では表示されません。 -:::tip -투표하지 않은 경우에는 결과가 표시되어 있어도 투표가 가능합니다. -::: +複数回答の設定に関わらず、自動でアンケートの結果が表示されなかったり、投票前に結果を見たい時は、選択肢の下にある「結果を見る」をクリックしてアンケートの結果を表示することができます。 투표를 하면, 자신이 투표한 선택지에 ✔가 붙습니다. + +:::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..03748e94 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,91 +7,95 @@ URL에 공유 내용을 포함한 몇 가지 옵션을 쿼리 파라미터로 ## 쿼리 파라미터 :::tip -모든 파라미터는 **옵션**이며, 필수 항목이 아닙니다. + +すべてのパラメータは**オプション**であり、必須ではありません。 + ::: -| 이름 | 설명 | -| ------- | --------------------------------------------------------------------------- | -| `title` | 제목。본문 첫머리[ … ]라고 삽입됩니다. | -| `text` | 본문. | -| `url` | URL.본문 마지막에 삽입됩니다. | +| 이름 | 설명 | +| ------- | ---------------------------------------------------------------------------- | +| `title` | 타이틀.본문의 처음에 [… ]가 표시됩니다. | +| `text` | 본문. | +| `url` | 주소.본문의 끝에 표시됩니다. | -### 회신 정보 +### 답글 정보 -다음 중 하나를 지정하면 지정된 노트에 대한 답글이 될 수 있습니다. +以下のいずれかを指定すると、指定のノートに対するリプライにすることができます。 -| 이름 | 설명 | -| ---------- | ---------------------------------------- | -| `replyId` | 답장할 노트 ID. | -| `replyUri` | 답장할 URL.(원격 노트 객체 지정) | +| 이름 | 설명 | +| ---------- | -------------------------------------- | +| `replyId` | 답글 기록의 아이디. | +| `replyUri` | 답글 주소.(원격 기록 대상 지정) | -### Renote정보 +### 리노트 정보 -아래 중 하나를 지정하면 지정한 노트에 대한 리노트(인용)를 할 수 있습니다. +以下のいずれかを指定すると、指定のノートに対するRenote(引用)にすることができます。 -| 이름 | 설명 | -| ----------- | -------------------------------------------- | -| `renoteId` | 리노트 대상의 노트 ID. | -| `renoteUri` | 리노트 대상의 URL.(원격 노트 객체 지정) | +| 名前 | 説明 | +| ----------- | ------------------------------- | +| `renoteId` | Renote先のノートID。 | +| `renoteUri` | Renote先のURL。（リモートのノートオブジェクトを指定） | -### 공개 범위 +### 公開範囲 -다음 옵션으로 공개 범위를 지정할 수 있습니다. +以下のオプションで公開範囲の指定を行えます。 -| 이름 | 설명 | +| 名前 | 説明 | | ---------------- | -------------------------------------------------------------------- | -| `visibility` | `public`, `home`, `followers`, `specified` 중 하나 이상 | +| `visibility` | `public`, `home`, `followers`, `specified` のいずれか | | `localOnly` | 0(false) or 1(true) | -| `visibleUserIds` | 대상 사용자 ID(쉼표로 구분) | -| `visibleAccts` | 대상 사용자[acct](../resources/glossary/#acct)(쉼표로 구분) | +| `visibleUserIds` | 対象ユーザーID(カンマ区切り) | +| `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) | :::warning -`visibility`에 `specified`를 지정한 경우 `visibleUserIds` 또는 `visibleAccts`의 지정도 필요합니다. + +`visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。 + ::: ### 첨부 파일 -아래 옵션으로 첨부 파일을 지정할 수 있습니다. +以下のオプションで添付ファイルの指定を行えます。 -| 이름 | 설명 | -| --------- | -------------------------------------- | -| `fileIds` | 첨부할 파일의 ID (쉼표로 구분) | +| 이름 | 설명 | +| --------- | ------------------------------------- | +| `fileIds` | 첨부할 파일의 아이디(쉼표 구분) | -## Misskey Hub의 공유 양식 중계 서비스 소개 - - - -새로운 미스키 허브에서는 미스키 공유 버튼 설치의 번거로움을 줄이기 위해 공유 양식 중계 서비스를 제공하고 있습니다.\ -이 서비스는 누구나 무료로 이용할 수 있습니다. - -기존 공유 폼 링크의 각 서버 도메인 부분을 `misskey-hub.net`으로 변경하기만 하면 다양한 Misskey 서버에 대한 공유 링크로 진화할 수 있습니다! - -:::tip +## Misskey Hub의 공유 양식 중계 서비스 정보 [공유 버튼 생성기](/tools/share-link-generator/)도 함께 사용하시기 바랍니다. +新Misskey Hubでは、Misskeyのシェアボタンの設置にかかる煩雑な手間を減らすために、共有フォームの中継サービスを提供しています。\ +こちらのサービスは、無料でどなたでもお使いいただけます。 + +今までの共有フォームのリンクの各サーバーのドメイン部分を `misskey-hub.net` に変更するだけで、様々なMisskeyサーバーへの共有リンクへと進化させることができます！ + +:::tip + +[共有ボタンジェネレーター](/tools/share-link-generator/) も併せてお使いください。 + ::: :::warning -공유 폼 중계 서비스(이하 '본 서비스'라 함)는 웹사이트 관리자의 편의를 위해 Misskey Development Division(이하 '당사'라 함)이 무상, 무보증으로 제공하는 기능입니다.본 서비스를 이용했거나 어떤 원인으로 인해 본 서비스를 이용하지 못하여 발생한 어떠한 손해에 대해서도 당사는 어떠한 책임도 지지 않습니다. +共有フォーム中継サービス（以下、「本サービス」という）はWebサイト管理者の便宜のためにMisskey Development Division（以下、「当方」という）が無償・無保証で提供する機能です。本サービスを利用したこと、または何らかの原因によりこれをご利用できなかったことにより生じたいかなる損害について、当方は一切の責任を負いません。 ::: -### 기본 파라미터 +### 基本のパラメータ -기본적으로 위에서 소개한 파라미터를 그대로 사용할 수 있지만, 사용자 ID, 파일 ID 등 **각 서버에 따라 달라지는 파라미터는 사용할 수 없습니다.** 지정되어 있다면 Misskey Hub에서 삭제됩니다. +基本的に上記で紹介されているパラメーターをそのままお使いいただけますが、ユーザーIDやファイルIDなど、 **各サーバーに依存するパラメーターは使用できません。** それらが指定されていた場合、Misskey Hub上で削除されます。 -### 독자적인 기능 +### 独自機能 #### 추천 서버 기능 -URL 파라미터 `manualInstance`에 Misskey 서버의 도메인을 입력하면 '공유 웹사이트의 추천'으로 해당 서버에 대한 링크를 별도로 설정할 수 있습니다.자신의 서버로 유도할 때 등에 사용할 수 있습니다. +URLパラメータ `manualInstance` にMisskeyサーバーのドメインを入力することで、「シェア元Webサイトからのおすすめ」として、別枠でそのサーバーへのリンクを設置することができます。ご自身のサーバーに誘導する際などにお使いいただけます。 :::warning -'추천 서버 기능'은 웹사이트 관리자의 편의를 위해 설치한 기능이며, 당사가 '공유 웹사이트의 추천'란에 있는 서버를 추천하는 것이 아닙니다. +「おすすめサーバー機能」はWebサイト管理者の便宜のために設置してある機能であり、当方が「シェア元Webサイトからのおすすめ」欄にあるサーバーをおすすめしているものではございません。 -'공유 웹사이트의 추천'에서 전환된 서버를 이용, 등록함으로써 발생하는 어떠한 손해 및 불이익에 대해서도 당사는 책임을 지지 않습니다. +「シェア元Webサイトからのおすすめ」から遷移したサーバーを利用・登録したことに起因するいかなる損害・不利益について、当方では責任を負いかねます。 ::: 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..ed2008ac 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,15 +1,19 @@ # 스레드 뮤트 :::tip -버전 12.95.0 이후 기능입니다. + +バージョン 12.95.0 以降の機能です。 + ::: -스레드 뮤트는 지정한 노트의 스레드를 음소거합니다.스레드(thread)는 시작 노트에서 연결된 모든 답글을 의미합니다. +スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。 -스레드를 뮤트하면 해당 스레드에 대한 새로운 리플과 리플에 포함된 내 멘션에 대한 알림을 받지 못하며, '나에게'에도 표시되지 않습니다. +スレッドをミュートすると、そのスレッドへの新たなリプライおよびリプライに含まれるあなた宛てのメンションが、通知されなくなるほか「あなた宛て」にも載らなくなります。 -Misskey Web에서 스레드를 뮤트하려면 대상 스레드에 속한 모든 노트 또는 시작 노트의 메뉴를 열고 '스레드 뮤트'를 선택합니다. +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..f76beef9 100644 --- a/content/ko/docs/2.for-users/3.features/webhook.md +++ b/content/ko/docs/2.for-users/3.features/webhook.md @@ -1,64 +1,48 @@ # Webhook :::tip -버전 12.109.0 이후 기능입니다. + +バージョン 12.109.0 以降の機能です。 + ::: :::warning -실험적인 기능이기 때문에 작동이 불안정하거나 향후 사양이 변경될 수 있습니다. + +実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。 + ::: -Misskey에는 Webhook이 준비되어 있습니다.Webhook을 이용하면 Misskey의 다양한 이벤트를 실시간으로 받아볼 수 있습니다. +MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。 -설정 > Webhook에서 Webhook을 관리할 수 있습니다. +대상 서버가 5xx 오류를 반환하거나 응답하지 않는 경우 시간을 열어 요청을 다시 전송합니다. -Webhook이 등록되면 지정한 이벤트가 발생하면 지정한 URL로 HTTP 요청이 전송됩니다.요청의 메서드는 POST이고, 본문은 JSON입니다. -또한, 요청 헤더에는 `X-Misskey-Hook-Secret`이라는 이름으로 등록 시 설정한 시크릿이 포함됩니다.이 시크릿이 올바른지 확인하여 요청이 유효한지 판단할 수 있습니다. +Webhookが登録されると、指定したイベントが発生した際に、指定したURLにHTTPリクエストが送信されます。リクエストのメソッドはPOSTで、ボディはJSONです。 +さらに、リクエストヘッダーには`X-Misskey-Hook-Secret`という名前で、登録時に設定したシークレットが含まれます。このシークレットが正しいか検証することで、リクエストが正規のものか判定することができます。 -요청 페이로드에는 다음과 같은 속성이 들어갑니다. +リクエストペイロードは以下のプロパティが入ります。 + +각 이벤트마다 설명과 페이로드를 표시합니다. + +送信先サーバーが5xxエラーを返すか、応答しなかった場合は時間を開けてリクエストが再送されます。 + +자신이 누군가를 팔로우했을 때 발생합니다. + +## イベント + +イベントごとに説明とペイロードを示します。 + +### follow -대상 서버가 5xx 오류를 반환하거나 응답하지 않는 경우 시간을 열어 요청을 다시 전송합니다. - -Webhook은 관리 화면에서 개별적으로 활성 상태를 설정할 수 있으며, 일시적으로 요청 전송을 중지시킬 수 있습니다. - -## 이벤트 - -각 이벤트마다 설명과 페이로드를 표시합니다. - -### follow - -자신이 누군가를 팔로우했을 때 발생합니다. - /dev/null - -gpg --dry-run --quiet --no-keyring --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg -``` - -이때 출력에 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62가 있는지 확인합니다. +Redisは、NoSQLのインメモリデータベースソフトであり、データベースや連合との通信を管理するなどのために必要だ。 +redis.ioのドキュメントに従いインストールする。 https\://redis.io/docs/getting-started/installation/install-redis-on-linux/ ```sh echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" | sudo tee /etc/apt/sources.list.d/nginx.list @@ -208,44 +169,48 @@ systemctl로 데몬 상태 확인. systemctl status nginx ``` -active라면 OK.그렇지 않은 경우 다음 명령을 실행합니다. +activeならOK。 -```sh -sudo systemctl start nginx - -sudo systemctl enable nginx -``` +### nginx http\://localhost에 접속하여 \*Welcome to nginx!\*라고 표시되면 OK.\ curl에서 확인하는 것도 좋은 방법입니다. -```sh -curl http://localhost -``` +:::tip -### 기타 +開発環境の場合はnginxのセットアップは不要です -Git(버전 관리 소프트웨어) 및 build-essential(Misskey 빌드 시 필요)을 설치합니다. +::: + +nginx.orgのドキュメント http\://nginx.org/en/linux_packages.html#Ubuntu に従ってインストールする。 ```sh -sudo apt update +sudo apt install ubuntu-keyring -sudo apt install -y git build-essential +curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null + +gpg --dry-run --quiet --no-keyring --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg ``` -## 추가 설정 및 설치 - 서버를 인터넷에 공개할 준비를 합니다. -:::tip -개발 환경의 경우 방화벽, CloudFlare, Certbot 설정이 필요하지 않습니다. -::: +```sh +echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" | sudo tee /etc/apt/sources.list.d/nginx.list -### 방화벽 +echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" | sudo tee /etc/apt/preferences.d/99nginx -이번에는 방화벽으로 ufw를 사용합니다. +sudo apt update -다음은 접속 허용을 화이트리스트 형식으로 하여 22번 SSH 포트를 접속 횟수 제한을 두어 개방하고, 80번 HTTP 포트와 443번 HTTPS 포트를 개방했습니다. +sudo apt install -y nginx +``` + +systemctlでデーモンの状態を確認。 + +```sh +systemctl status nginx +``` + +activeならOK。そうでなければ、次のコマンドを実行。 ```sh sudo ufw enable @@ -259,33 +224,32 @@ sudo ufw allow 80 sudo ufw allow 443 ``` -ufw의 상태를 확인합니다. +http\://localhost にアクセスし、\*Welcome to nginx!\*と表示されればOK。\ +curlで確認するのもよいだろう。 ```sh sudo ufw status ``` -systemctl로 영구화합니다. +### その他 + +Git（バージョン管理ソフト）およびbuild-essential（Misskeyのビルド時に必要）をインストールする。 ```sh -sudo systemctl enable ufw +sudo apt update + +sudo apt install -y git build-essential ``` +## CloudFlare + +サーバーをインターネットに公開する準備をする。 + :::tip -ufw는 넷필터(iptables)를 사람이 쉽게 조작할 수 있도록 하는 앱입니다.설치 스크립트는 OCI 환경에서는 netfilter를 직접 조작합니다. -::: - -### CloudFlare - -CloudFlare는 자신의 도메인에 대해 DNS 서버, 리버스 프록시, CDN을 한 번에 제공해 주는 매우 편리한 서비스입니다.\ -CloudFlare를 경유하지 않고 서버를 공개하는 것도 가능하지만, 매우 편리하기 때문에 도입하는 것이 좋습니다. -[**→ CDN 설정**](../resources/cdn/) - -[CloudFlare에 가입(https\://dash.cloudflare.com/sign-up)하고, 구매한 도메인을 안내에 따라 등록합니다. DNS 등록 화면에서 서버의 IP 주소를 입력하면 됩니다. -도메인 구입처에 따라 적용에 3일 정도 소요될 수 있습니다. +::: ### Certbot (Let's Encrypt) 설정 @@ -297,11 +261,11 @@ certbot과 CloudFlare 플러그인 설치하기 sudo apt install -y certbot python3-certbot-dns-cloudflare ``` -Cloudflare의 API 키를 얻습니다.아래 절차에 따라 취득합니다. +ufwのステータスを確認しておく。 -1. https\://dash.cloudflare.com/profile/api-tokens에 접속 -2. Global API Key의 View 선택 -3. 비밀번호 입력 및 hCaptcha 해제, View 선택 +```sh +sudo ufw status +``` CloudFlare의 정보를 담은 설정 파일 /etc/cloudflare/cloudflare.ini를 생성합니다. @@ -310,30 +274,23 @@ mkdir /etc/cloudflare nano /etc/cloudflare/cloudflare.ini ``` -dns_cloudflare_email(아래 예에서는 bar\@fuga.foo)에는 CloudFlare에 등록한 이메일 주소를 설정합니다. +:::tip -```sh -dns_cloudflare_email = bar@fuga.foo -dns_cloudflare_api_key = xxxxxxxxxxxxxxxxxxxxxxxxxx -``` +ufwは、netfilter(iptables)を人間が操作しやすいようにするアプリだ。インストールスクリプトは、OCI環境ではnetfilterを直接操作する。 -이를 저장하고 권한을 600으로 설정합니다. +::: -```sh -sudo chmod 600 /etc/cloudflare/cloudflare.ini -``` +### CloudFlare 준비가 되었으니 명령을 실행합니다.**중간에 있는 2곳의 example.tld는 자신의 것으로 교체**. -```sh -sudo certbot certonly --dns-cloudflare --dns-cloudflare-credentials /etc/cloudflare/cloudflare.ini --dns-cloudflare-propagation-seconds 60 --server https://acme-v02.api.letsencrypt.org/directory -d example.tld -d *.example.tld -``` +[CloudFlareにサインアップ](https://dash.cloudflare.com/sign-up) し、購入したドメインを案内に従って登録する。 -\*Congratulations!\*라고 표시되면 OK.생성된 .pem 파일의 경로는 나중에 사용할 것이므로 기록해 두어야 합니다. +DNSの登録画面でサーバーのIPアドレスを入力しておくとよい。 자동 업데이트 설정은 설치와 동시에 이루어지기 때문에 불필요합니다. -## Misskey 설치하기 +### Misskey 설치하기 이제 사전 준비는 어느 정도 끝났으니 미스키를 준비할 차례입니다. @@ -343,15 +300,11 @@ misskey 사용자로 변경. sudo su - misskey ``` -Git으로 파일들을 전개. +CloudflareのAPIキーを取得する。以下の手順で取得されたい。 -```sh -git clone -b master https://github.com/misskey-dev/misskey.git --recurse-submodules - -cd misskey - -git checkout master -``` +1. https\://dash.cloudflare.com/profile/api-tokens にアクセス +2. Global API KeyのViewを選択 +3. パスワードを入力しhCaptchaを解除、Viewを選択 필요한 npm 패키지를 설치합니다. @@ -359,9 +312,12 @@ git checkout master NODE_ENV=production pnpm install --frozen-lockfile ``` -## Misskey 구성하기 +dns_cloudflare_email（下の例ではbar\@fuga.foo）にはCloudFlareで登録しているメールアドレスを設定する。 -### default.yml +```sh +dns_cloudflare_email = bar@fuga.foo +dns_cloudflare_api_key = xxxxxxxxxxxxxxxxxxxxxxxxxx +``` 설정 파일 .config/default.yml을 생성합니다. @@ -371,47 +327,23 @@ nano .config/default.yml 다음 내용을 붙여넣고 적절하게 바꿉니다.설정값의 변경이 필요한 부분은 ●, 지금까지의 흐름에서 설정된 값을 사용하는 부분은 ○으로 표시하였습니다. -이 설정 파일은 YAML 형식으로 작성되어 있으며, 줄의 시작 부분의 띄어쓰기 등을 잘못하면 Misskey가 동작하지 않으므로 특히 주의해야 합니다. - -설정할 수 있는 값과 작성 방법은 [.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)에 나와 있습니다. - -:::tip -개발 환경의 경우 url은 `url: http://localhost:3000`로 지정합니다. -::: - -```yml -# ● Misskey를 공개할 URL -url: https://example.tld/ -# 포트를 3000으로 설정한다. -port: 3000 - -# ● PostgreSQL 설정。 -db: - host: localhost - port: 5432 - db : mk1 # 〇 PostgreSQL의 데이터베이스 이름 - user: misskey # 〇 PostgreSQL 사용자 이름 - pass: hoge # ● PostgreSQL 패스워드 - -# 　 Redis 설정. -redis: - host: localhost - port: 6379 - -# 　 ID 유형 설정. -id: 'aid' - -# 　 syslog -syslog: - host: localhost - port: 514 +```sh +sudo certbot certonly --dns-cloudflare --dns-cloudflare-credentials /etc/cloudflare/cloudflare.ini --dns-cloudflare-propagation-seconds 60 --server https://acme-v02.api.letsencrypt.org/directory -d example.tld -d *.example.tld ``` +\*Congratulations!\*と表示されたらOK。生成された.pemファイルのパスは今後使うので記録しておくこと。 + +自動更新の設定はインストールと同時に行われているため不要。 + +## Misskeyのインストール + 지정이 완료되면 저장합니다. -### nginx 설정하기 +misskeyユーザーに変更。 -nginx를 설정합니다. +```sh +sudo su - misskey +``` 루트 권한으로 변경합니다. @@ -425,43 +357,111 @@ exit sudo nano /etc/nginx/conf.d/misskey.conf ``` -[Misskey Hub](https://misskey-hub.net/docs/admin/nginx/)의 설정 예시를 nano에 복사하여 붙여넣고, 다음 부분을 자신의 것으로 바꿔서 작성합니다. +## Misskeyを設定する -- 18행과 30행의 도메인 이름 -- 34-35번째 행의 인증서 경로를 Certbot으로 취득한 인증서로 바꾸면 됩니다(기본적으로 example.tld를 대체하면 됩니다). -- 56행 (다른 리버스 프록시 또는 CDN 뒤에 있는 경우 다음을 제거합니다.) 에서 4행 삭제 +### default.yml 변경 사항을 저장합니다. -설정 파일이 제대로 작동하는지 확인합니다. +```sh +nano .config/default.yml +``` + +次の内容を貼り付け、適宜置き換える。設定値の変更が必要な箇所は●で、これまでの流れの中で設定した値を用いる箇所は〇で示した。 + +OK라면 nginx 데몬을 재시작합니다. + +設定できる値と記述方法は[.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)に書かれている。 + +:::tip + +開発環境の場合、urlは`url: http://localhost:3000`と指定します。 + +::: + +```yml +# ● Misskeyを公開するURL +url: https://example.tld/ +# ポートを3000とする。 +port: 3000 + +# ● PostgreSQLの設定。 +db: + host: localhost + port: 5432 + db : mk1 # 〇 PostgreSQLのデータベース名 + user: misskey # 〇 PostgreSQLのユーザー名 + pass: hoge # ● PostgreSQLのパスワード + +# 　 Redisの設定。 +redis: + host: localhost + port: 6379 + +# 　 IDタイプの設定。 +id: 'aid' + +# 　 syslog +syslog: + host: localhost + port: 514 +``` + +misskey 사용자로 다시 로그인합니다. + +### nginxの設定 + +nginxの設定を行う。 + +ルート権限で行う。 + +```sh +exit +``` + +/etc/nginx/conf.d/misskey.confを作成する。 + +```sh +sudo nano /etc/nginx/conf.d/misskey.conf +``` + +[Misskey Hub](https://misskey-hub.net/docs/admin/nginx/)の設定例をnanoへコピー＆ペーストし、次の部分を自分のものに書き換える。 + +- 서버에 스왑 추가하기 +- 로컬에서 빌드한 것(built 디렉토리)을 sftp로 전송하기 +- 56行目 (If it's behind another reverse proxy or CDN, remove the following.) から4行を削除 + +変更を保存する。 + +設定ファイルがきちんと機能するか確認。 ```sh sudo nginx -t ``` -OK라면 nginx 데몬을 재시작합니다. +OKならば、nginxデーモンを再起動。 ```sh sudo systemctl restart nginx ``` -상태를 확인합니다. +Misskey의 웰컴 페이지가 표시되어야 합니다. ```sh sudo systemctl status nginx ``` -active이면 OK. +activeであればOK。 -## Misskey 빌드 +## CloudFlare의 DNS 확인하기 -misskey 사용자로 다시 로그인합니다. +CloudFlare의 DNS 설정이 올바른 IP 주소로 설정되어 있는지 다시 한 번 확인해봅니다. ```sh sudo su - misskey ``` -빌드합니다.네, 할 수 있습니다... +ビルドをする。yes we can… ```sh cd misskey @@ -469,70 +469,94 @@ NODE_ENV=production pnpm run build ``` :::tip -개발 환경의 경우 `NODE_ENV=production`은 필요하지 않습니다.이후 명령어에서도 마찬가지로 삭제해 주세요. + +開発環境の場合、`NODE_ENV=production`は不要です。以降のコマンドでも同様に削除してください。 + ::: -### 서버에서 빌드할 수 없는 경우 +### サーバーでビルドできない場合 -RAM 부족이 원인일 수 있습니다. +RAMの不足が考えられる。 -미스키의 빌드 및 데이터베이스 마이그레이션(초기화 포함)을 위해서는 2GB 이상의 RAM이 필요합니다.\ -RAM이 부족한 경우 다음과 같은 해결책을 생각해 볼 수 있습니다. +Misskeyのビルドやデータベースのマイグレーション（初期化を含む）には、RAMが2GB以上必要になっている。\ +RAMが足りない場合、以下のような解決策が考えられる。 -- 서버에 스왑 추가하기 -- 로컬에서 빌드한 것(built 디렉토리)을 sftp로 전송하기 +- サーバーにスワップを追加する +- ローカルでビルドしたもの（builtディレクトリ）をsftpで転送する -## 데이터베이스 초기화 +## データベースの初期化 ```sh -pnpm run init +[Unit] +Description=Misskey daemon + +[Service] +Type=simple +User=misskey +ExecStart=/usr/bin/npm start +WorkingDirectory=/home/misskey/misskey +Environment="NODE_ENV=production" +TimeoutSec=60 +StandardOutput=journal +StandardError=journal +SyslogIdentifier=misskey +Restart=always + +[Install] +WantedBy=multi-user.target ``` -## Misskey 실행하기 +## Misskeyを起動する ```sh -NODE_ENV=production pnpm run start +sudo systemctl daemon-reload + +sudo systemctl enable misskey + +sudo systemctl start misskey ``` -**Now listening on port 3000 on** [**http://example.tld**](http://example.tld) 라고 표시되면 설정한 URL에 접속합니다. +**Now listening on port 3000 on** [**http://example.tld**](http://example.tld) と表示されたら、設定したURLにアクセスする。 -Misskey의 웰컴 페이지가 표시되어야 합니다. +Misskeyのウェルカムページが表示されるはずだ。 -계정 생성, 노트 작성, 파일 업로드 등 일련의 작업이 제대로 이루어지고 있는지 확인해 봅니다. +active라면 OK. -### 액세스 할 수 없는 경우 +### アクセスできない場合 -#### CloudFlare의 DNS 확인하기 +#### CloudFlareのDNSを確認する -CloudFlare의 DNS 설정이 올바른 IP 주소로 설정되어 있는지 다시 한 번 확인해봅니다. +CloudFlareのDNS設定が正しいIPアドレスになっているかもう一度確認しよう。 -#### 라우터 설정 확인하기 +#### ルーターの設定を確認する -홈 서버의 경우, 라우터가 서버와 외부와의 80포트, 443포트 통신을 허용하도록 설정되어 있는지 확인합니다. +自宅サーバーの場合、ルーターがサーバーと外部との80ポート・443ポートの通信を許可する設定になっているかどうか確認しよう。 -클라우드의 경우에도 네트워크 설정에서 포트 개방이 필요한 경우가 많습니다. +[Misskey 업데이트 방법](. /manual/#misskey 업데이트 방법) -## Misskey의 데몬 생성 +## Misskeyのデーモンを作成 :::tip -개발 환경의 경우, 데몬을 만들 필요가 없습니다. + +開発環境の場合、デーモンの作成は不要です。 + ::: -일단 Ctrl+C로 프로세스를 죽이고, Misskey를 데몬으로 실행하도록 설정해 봅시다. +재부팅 후 Misskey는 자동으로 시작됩니다. -루트 권한으로 변경합니다. +ルート権限で行う。 ```sh -exit +sudo systemctl start misskey ``` -/etc/systemd/system/misskey.service를 만듭니다. +/etc/systemd/system/misskey.serviceを作成する。 ```sh sudo nano /etc/systemd/system/misskey.service ``` -다음 내용을 붙여넣고 저장합니다. +次の内容を貼り付け、保存する。 ```ini [Unit] @@ -554,7 +578,7 @@ Restart=always WantedBy=multi-user.target ``` -systemd를 설정하고 misskey 데몬을 실행합니다. +systemdを設定し、misskeyデーモンを開始。 ```sh sudo systemctl daemon-reload @@ -564,29 +588,29 @@ sudo systemctl enable misskey sudo systemctl start misskey ``` -systemctl로 데몬 상태를 확인합니다.실행에 시간이 조금 걸리므로 15초 정도 기다렸다가 시작하는 것이 좋습니다. +systemctlでデーモンの状態を確認。起動に少し時間がかかるため、15秒程度待ってからのほうが良い。 ```sh sudo systemctl status misskey ``` -active라면 OK. +activeならOK。 -**이것으로 Misskey 설치가 거의 완료되었습니다.** +**これでMisskeyのインストールはほぼ完了だ。** -Misskey 서버에 자신의 계정을 등록하고 로그인하여 설정을 진행합니다. +Misskeyサーバーに自分のアカウントを登録・ログインし、設定を続けよう。 -## Misskey 설정 계속하기 +## Misskeyの設定を続ける -- [Misskey 서버에서 가장 먼저 설정해야 할 서버 설정 및 기타 설정에 대한 설명\*\*](https://hide.ac/articles/Y504SIabp) -- [**Squid 프록시를 설정하여 Misskey를 보호하세요**](https://hide.ac/articles/MC7WsPDqw) -- [**Misskey의 데이터베이스를 백업하자【OCI 오브젝트 스토리지 편】**](https://hide.ac/articles/E2Ea3cauk) +- [**Misskeyサーバーで最初に設定するべきサーバー設定とその他設定の説明**](https://hide.ac/articles/Y504SIabp) +- [**Squidプロキシを設定してMisskeyを守る**](https://hide.ac/articles/MC7WsPDqw) +- [**Misskeyのデータベースをバックアップしよう【OCIオブジェクトストレージ編】**](https://hide.ac/articles/E2Ea3cauk) -## Misskey 업데이트 +## Misskeyのアップデート -[Misskey 업데이트 방법](. /manual/#misskey 업데이트 방법) +[Misskeyのアップデート方法](./manual/#misskeyのアップデート方法) -작업 중에는 Misskey를 사용할 수 없습니다. +作業中はMisskeyを使うことができません。 ```sh sudo systemctl stop misskey @@ -602,7 +626,7 @@ pnpm run migrate; exit ``` -### Case 1: apt upgrade를 하는 경우 +### Case 1: apt upgradeをする場合 ```sh sudo apt update -y @@ -610,9 +634,9 @@ sudo apt full-upgrade -y sudo reboot ``` -재부팅 후 Misskey는 자동으로 시작됩니다. +再起動後はMisskeyは自動で起動します。 -### Case 2: 그대로 실행 +### Case 2: そのまま起動 ```sh sudo systemctl start 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..9e183fe8 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를 업데이트할 때 캐시를 지울 필요가 없습니다. + +Misskeyをアップデートした際にキャッシュのクリアは不要です。 + ::: 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..d6690e18 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/api/1.index.md b/content/ko/docs/4.for-developers/api/1.index.md index 0ba43e54..37d1b5d6 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/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..b33974ff 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,48 +5,55 @@ description: 스트리밍 API를 사용하면, 실시간으로 다양한 정보( # 스트리밍 API :::tip -처음에 [Misskey API](../index.md)의 문서를 읽는 것을 추천합니다. -::: 스트리밍 API를 사용하면, 실시간으로 다양한 정보(예를 들어 타임라인에 새로운 노트가 올라왔다거나, 리액션을 받았거나 팔로우 되었다거나 등)를 받거나, 다양한 작업을 할 수 있습니다. -## 스트림에 접속하기 +::: 스트리밍 API를 이용하려면, 먼저 Misskey 서버에 **websocket**으로 접속이 필요합니다. -아래 형식의 URL로 websocket에 접속합니다: +## ストリームに接続する + +ストリーミングAPIを利用するには、まずMisskeyサーバーに**websocket**で接続する必要があります。 + +여기서, ``` wss://{host}/streaming?i={token} ``` -여기서, +ここで、 -- `{host}`의 부분을 접속하고 싶은 서버의 호스트명으로 바꿉니다. -- `{token}`의 부분은, 유저의 액세스 토큰으로 바꿉니다. +- `{host}`の部分は、接続したいサーバーのホストに置き換えます。 +- `{token}`の部分は、ユーザーのアクセストークンに置き換えます。 :::tip -액세스 토큰은 생략할 수 있지만, 이 경우 비로그인으로 작동하기 때문에 수신할 수 있는 정보나 조작은 제한됩니다. + +アクセストークンは省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。 + ::: -스트림에 접속하면, 후술할 노트의 구독을 하는 것이 가능합니다. 그러나, 아직 이 단계에서는 타임라인의 새로운 노트를 확인하는 등의 행동을 할 수 없습니다. -이러한 이벤트를 수신하기 위해서는, 스트림 상에 후술할 **채널**에 접속해야 합니다. - -**스트림상에서 주고 받는 정보는 모두 JSON입니다.** - -## 채널 - -Misskey의 스트리밍 API에는 채널이라는 개념이 있습니다.이것은 송수신하는 정보를 분리하기 위한 구조입니다. 스트림 상에서 채널에 접속함으로써, 다양한 정보를 받거나 보낼 수 있게 됩니다. - -:::tip -하나의 스트림 연결에서, 동시에 여러 개의 채널에 접속할 수 있습니다. -::: +ストリームに接続すると、後述投稿の購読を行ったりすることができますが、まだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。 +そのようなイベントを受信するには、ストリーム上で後述する**チャンネル**に接続する必要があります。 아래에서 채널의 사용 방법을 설명합니다.어떠한 채널이 있는 지는, [채널 목록](./channel/index.md)를 참조해 주세요. -### 채널에 접속하기 +## 채널에 접속하기 -채널에 연결하려면 다음과 같은 데이터를 JSON으로 스트림에 전송합니다. +MisskeyのストリーミングAPIにはチャンネルという概念があります。これは、送受信する情報を分離するための仕組みです。 +ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。 + +:::tip + +여기서, + +::: + +以下では、チャンネルの使用方法を説明します。どのようなチャンネルがあるかは、[チャンネル一覧](./channel/index.md)を参照してください。 + +### 채널에서 메시지 받기 + +チャンネルに接続するには、次のようなデータをJSONでストリームに送信します: ```js { @@ -61,21 +68,23 @@ Misskey의 스트리밍 API에는 채널이라는 개념이 있습니다.이것 } ``` -여기서, +ここで、 -- `channel`에는 접속하고자 하는 채널명을 입력합니다.[채널 목록](./channel/index.md)를 참고하세요. -- `id`에는 해당 채널과 상호작용할 수 있는 임의의 ID를 설정합니다.스트림에는 다양한 메시지가 흘러나오기 때문에 어떤 채널에서 온 메시지인지 식별해야 하기 때문입니다.이 ID는 UUID나 난수 같은 것이 될 수 있습니다. -- `params`는 채널에 연결할 때의 파라미터입니다.채널에 따라 연결 시 필요한 파라미터가 다릅니다.파라미터가 필요 없는 채널에 연결할 때는 이 속성을 생략할 수 있습니다. +- `channel`には接続したいチャンネル名を設定します。[チャンネル一覧](./channel/index.md)を参照してください。 +- `id`にはそのチャンネルとやり取りするための任意のIDを設定します。ストリームでは様々なメッセージが流れるので、そのメッセージがどのチャンネルからのものなのか識別する必要があるからです。このIDは、UUIDや、乱数のようなもので構いません。 +- `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。 :::tip -ID는 채널 단위가 아니라 '채널 연결 단위'입니다.왜냐하면 같은 채널에 서로 다른 파라미터로 다중접속 하는 경우도 있기 때문입니다. + +IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。 + ::: -### 채널에서 메시지 받기 +### チャンネルからのメッセージを受け取る -예를 들어, 타임라인 채널의 경우 새로운 게시물이 올라오면 메시지를 발신합니다.해당 메시지를 받으면 타임라인에 새로운 게시물이 올라왔다는 것을 실시간으로 알 수 있습니다. +例えばタイムラインのチャンネルなら、新しい投稿があった時にメッセージを発します。そのメッセージを受け取ることで、タイムラインに新しい投稿がされたことをリアルタイムで知ることができます。 -채널이 메시지를 보내면 다음과 같은 데이터가 JSON으로 스트림에 유입됩니다. +여기서, ```js { @@ -90,17 +99,17 @@ ID는 채널 단위가 아니라 '채널 연결 단위'입니다.왜냐하면 } ``` +ここで、 + +- `id`には前述したそのチャンネルに接続する際に設定したIDが設定されています。これで、このメッセージがどのチャンネルからのものなのか知ることができます。 +- `type`にはメッセージの種類が設定されます。チャンネルによって、どのような種類のメッセージが流れてくるかは異なります。 +- `body`にはメッセージの内容が設定されます。チャンネルによって、どのような内容のメッセージが流れてくるかは異なります。 + +### チャンネルに向けてメッセージを送信する + 여기서, -- `id`에는 앞서 언급한 해당 채널에 접속할 때 설정한 ID가 설정되어 있습니다.이제 이 메시지가 어느 채널에서 온 것인지 알 수 있습니다. -- `type`에는 메시지 종류가 설정됩니다.채널에 따라 어떤 종류의 메시지가 흘러나오는지는 달라질 수 있습니다. -- `body`에는 메시지 내용이 설정됩니다.채널에 따라 어떤 내용의 메시지가 흘러나오는지는 달라질 수 있습니다. - -### 채널에 메시지 보내기 - -채널에 따라서는 메시지를 받을 수 있을 뿐만 아니라, 여기에서 메시지를 보내거나 어떤 조작을 할 수 있는 경우도 있습니다. - -채널에 메시지를 보내려면 다음과 같은 데이터를 JSON으로 스트림에 전송합니다. +チャンネルにメッセージを送信するには、次のようなデータをJSONでストリームに送信します: ```js { @@ -115,15 +124,15 @@ ID는 채널 단위가 아니라 '채널 연결 단위'입니다.왜냐하면 } ``` -여기서, +ここで、 -- `id`에는 앞서 설명한 해당 채널에 접속할 때 설정한 ID를 설정합니다.이제 이 메시지가 어떤 채널을 대상으로 하는 메시지인지 식별할 수 있습니다. -- `type`에는 메시지 종류를 설정합니다.채널에 따라 어떤 종류의 메시지를 받을 수 있는지는 달라질 수 있습니다. -- `body`에는 메시지 내용을 설정합니다.채널에 따라 어떤 내용의 메시지를 받아들이는지는 달라질 수 있습니다. +- `id`には前述したそのチャンネルに接続する際に設定したIDを設定します。これで、このメッセージがどのチャンネルに向けたものなのか識別させることができます。 +- `type`にはメッセージの種類を設定します。チャンネルによって、どのような種類のメッセージを受け付けるかは異なります。 +- `body`にはメッセージの内容を設定します。チャンネルによって、どのような内容のメッセージを受け付けるかは異なります。 -### 채널 연결 끊기 +### チャンネルから切断する -채널에서 연결을 끊으려면 다음과 같은 데이터를 JSON으로 스트림에 전송합니다. +チャンネルから切断するには、次のようなデータをJSONでストリームに送信します: ```js { @@ -134,25 +143,25 @@ ID는 채널 단위가 아니라 '채널 연결 단위'입니다.왜냐하면 } ``` -여기서, - -- `id`에는 앞서 설명한 해당 채널에 접속할 때 설정한 ID를 설정합니다. - -## 게시물 캡처 - -Misskey는 게시물 캡쳐라는 메커니즘을 제공하고 있습니다.지정한 게시물의 이벤트를 스트림으로 받아볼 수 있는 기능입니다. - -예를 들어 타임라인을 가져와서 사용자에게 보여줬다고 가정해 봅시다.여기서 누군가가 해당 타임라인에 포함된 어떤 게시물에 리액션을 했다고 가정해봅시다. -하지만 클라이언트 입장에서는 어떤 게시물에 리액션이 붙었다는 것을 알 길이 없기 때문에 실시간으로 리액션을 타임라인의 게시물에 반영하여 표시하는 등의 작업을 할 수 없습니다. - -이 문제를 해결하기 위해 Misskey는 게시물 캡처 기능을 제공하고 있습니다.게시물을 캡처하면 해당 게시물에 대한 이벤트를 수신할 수 있기 때문에 실시간으로 반응을 반영할 수 있습니다. - -아래에서는 게시물 캡처 기능을 사용하는 방법을 설명합니다.어떤 캡처 이벤트가 있는지는 [캡처 이벤트 목록](. /note-capture-events.md)에서 확인할 수 있습니다. - -### 게시물 캡처하기 - 게시물을 캡처하려면 스트림에 다음과 같은 메시지를 보냅니다. +- `id`には前述したそのチャンネルに接続する際に設定したIDを設定します。 + +## 投稿のキャプチャ + +Misskeyは投稿のキャプチャと呼ばれる仕組みを提供しています。これは、指定した投稿のイベントをストリームで受け取る機能です。 + +例えばタイムラインを取得してユーザーに表示したとします。ここで誰かがそのタイムラインに含まれるどれかの投稿に対してリアクションしたとします。 +しかし、クライアントからするとある投稿にリアクションが付いたことなどは知る由がないため、リアルタイムでリアクションをタイムライン上の投稿に反映して表示するといったことができません。 + +この問題を解決するために、Misskeyは投稿のキャプチャ機構を用意しています。投稿をキャプチャすると、その投稿に関するイベントを受け取ることができるため、リアルタイムでリアクションを反映させたりすることが可能になります。 + +以下では、投稿のキャプチャ機能の使用方法を説明します。どのようなキャプチャイベントがあるかは、[キャプチャイベント一覧](./note-capture-events.md)を参照してください。 + +### 投稿をキャプチャする + +投稿をキャプチャするには、ストリームに次のようなメッセージを送信します: + ```js { type: 'subNote', @@ -162,14 +171,14 @@ Misskey는 게시물 캡쳐라는 메커니즘을 제공하고 있습니다.지 } ``` +해당 게시물이 더 이상 화면에 표시되지 않거나, 해당 게시물에 대한 이벤트를 더 이상 받을 필요가 없을 때는 캡처 해제를 신청하세요. + +- `id`にキャプチャしたい投稿の`id`を設定します。 + +このメッセージを送信すると、Misskeyにキャプチャを要請したことになり、以後、その投稿に関するイベントが流れてくるようになります。 + 여기서, -- `id`에 캡처하고자 하는 게시물의 `id`를 설정합니다. - -이 메시지를 보내면 Misskey에 캡쳐를 요청하는 것이며, 이후 해당 게시물에 대한 이벤트가 흘러나오게 됩니다. - -예를 들어, 게시물에 리액션이 붙었다고 가정하면 다음과 같은 메시지가 나옵니다. - ```js { type: 'noteUpdated', @@ -184,17 +193,17 @@ Misskey는 게시물 캡쳐라는 메커니즘을 제공하고 있습니다.지 } ``` -여기서, +이 메시지를 보내면 이후 해당 게시물에 대한 이벤트가 발생하지 않습니다. -- `body` 내의 `id`에는 이벤트를 발생시킨 게시물의 ID가 설정됩니다. -- `body` 내의 `type`에는 이벤트의 종류가 설정됩니다. -- `body` 내의 `body`에는 이벤트의 세부 정보가 설정됩니다. +- `body`内の`id`に、イベントを発生させた投稿のIDが設定されます。 +- `body`内の`type`に、イベントの種類が設定されます。 +- `body`内の`body`に、イベントの詳細が設定されます。 -### 게시물 캡쳐 해제하기 +### 投稿のキャプチャを解除する -해당 게시물이 더 이상 화면에 표시되지 않거나, 해당 게시물에 대한 이벤트를 더 이상 받을 필요가 없을 때는 캡처 해제를 신청하세요. +その投稿がもう画面に表示されなくなったりして、その投稿に関するイベントをもう受け取る必要がなくなったときは、キャプチャの解除を申請してください。 -다음 메시지를 보냅니다: +次のメッセージを送信します: ```js { @@ -205,8 +214,8 @@ Misskey는 게시물 캡쳐라는 메커니즘을 제공하고 있습니다.지 } ``` -여기서, +ここで、 -- `id`에 캡처를 해제하고 싶은 게시물의 `id`를 설정합니다. +- `id`にキャプチャを解除したい投稿の`id`を設定します。 -이 메시지를 보내면 이후 해당 게시물에 대한 이벤트가 발생하지 않습니다. +このメッセージを送信すると、以後、その投稿に関するイベントは流れてこないようになります。 diff --git a/content/ko/docs/4.for-developers/api/token.md b/content/ko/docs/4.for-developers/api/token.md index d992ba84..bec5ffd3 100644 --- a/content/ko/docs/4.for-developers/api/token.md +++ b/content/ko/docs/4.for-developers/api/token.md @@ -7,62 +7,68 @@ API를 사용하기 위해서는 API를 사용할 계정에 연결된 **액세 액세스 토큰은 사용자에 연결된 인증 정보로, API를 이용하는 사용자를 식별하는 동시에 액세스 토큰별로 어떤 작업 권한을 가지고 있는지 관리합니다. :::tip -사용자와 그 사용자와 연결된 액세스 토큰은 일대다 관계이며, 한 사용자에게 여러 개의 액세스 토큰이 발급될 수 있습니다. -::: 자신의 액세스 토큰을 쉽게 획득할 수 있을 뿐만 아니라, 자신의 애플리케이션을 사용하게 될 불특정 사용자의 액세스 토큰을 획득할 수도 있습니다. -- 전자의 경우: \*\*"자신의 액세스 토큰을 수동으로 발행하기"\*\*로 이동합니다. -- 후자의 경우: \*\*"애플리케이션 사용자에게 액세스 토큰 발급 요청하기"\*\*로 이동합니다. - -### 자신의 액세스 토큰을 수동으로 발행하기 - -Misskey Web의 '설정 > API'에서 자신의 액세스 토큰을 발행할 수 있습니다. - -:::danger -액세스 토큰은 다른 사람이 알 수 없도록 해야 합니다. ::: -### 애플리케이션 사용자에게 액세스 토큰 발급 요청하기 +あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 -애플리케이션을 이용하는 사용자(이하 단순히 '사용자'라 칭함)의 액세스 토큰을 발급받으려면 아래 절차에 따라 발급을 요청합니다. +- 前者の場合: **「自分自身のアクセストークンを手動発行する」** に進む +- 後者の場合: **「アプリケーション利用者にアクセストークンの発行をリクエストする」** に進む + +### 自分自身のアクセストークンを手動発行する + +Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 + +:::danger + +アクセストークンは他人に知られないようにしてください。 + +::: + +### アプリケーション利用者にアクセストークンの発行をリクエストする + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 :::tip -아래 설명할 방법은 앱을 만들지 않고 즉시 액세스 토큰을 발급하는 MiAuth라는 방법입니다. +以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 -[앱 생성 방식으로 액세스 토큰을 획득하는 방법도 있습니다(구식).](./app) +[アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app) ::: #### Step 1 -UUID를 생성합니다.이후 이를 **세션 ID**라고 부릅니다. +UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger -이 세션 ID는 매번 생성해야 하며, 반복해서 사용하지 않도록 해야 합니다. + +このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: #### Step 2 -애플리케이션 인증 양식을 사용자의 브라우저에 표시하도록 합니다.인증 양식은 다음 형식의 URL로 열 수 있습니다. +アプリケーション認証フォームをユーザーのブラウザで表示させる。認証フォームは、以下の形式のURLで開くことができます: ``` -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 ``` -여기서, +ここで、 -- `{host}`부분은 사용자 서버의 호스트로 대체합니다.보통 호스트는 사용자가 입력합니다. -- `{session}`부분은 세션 ID로 대체합니다. +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 +- `{session}`の部分は、セッションIDに置き換えます。 -또한 URL에 몇 가지 옵션을 쿼리 파라미터로 설정할 수 있습니다. +사용자가 애플리케이션 접근을 허용한 후 다음 형식의 URL에 POST 요청하면 응답으로 액세스 토큰이 포함된 JSON이 반환됩니다. -| 이름 | 설명 | -| ------------ | ---------------------------------------------------------------------------------------- | -| `name` | 애플리케이션 이름。 | -| `icon` | 애플리케이션 아이콘의 이미지 URL。 | -| `callback` | 인증이 끝난 후 리디렉션되는 URL。
리디렉션 시에는 `session`이라는 쿼리 파라미터로 세션 ID가 붙습니다. | -| `permission` | 애플리케이션이 요구하는 권한.
요청하는 권한을 `,`로 구분하여 열거합니다.권한 목록은 [여기](./permission.md)에서 확인할 수 있습니다. | +| 名前 | 説明 | +| ------------ | ----------------------------------------------------------------------------- | +| `name` | アプリケーション名。 | +| `icon` | アプリケーションのアイコン画像URL。 | +| `callback` | 認証が終わった後にリダイレクトするURL。
リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 | +| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](./permission.md)で確認できます。 | :::tip{label='例'} @@ -74,38 +80,38 @@ https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callba #### Step 3 -사용자가 애플리케이션 접근을 허용한 후 다음 형식의 URL에 POST 요청하면 응답으로 액세스 토큰이 포함된 JSON이 반환됩니다. +ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 ``` https://{host}/api/miauth/{session}/check ``` -여기서, - -- `{host}`부분은 사용자 서버의 호스트로 대체합니다. -- `{session}`부분은 세션 ID로 대체합니다. - -응답에 포함된 속성은 다음과 같습니다. - -| 이름 | 설명 | -| ------- | ----------- | -| `token` | 사용자 액세스 토큰. | -| `user` | 사용자 정보. | - -## API 이용 - -액세스 토큰을 획득하면 각종 엔드포인트에 요청하여 API를 사용할 수 있습니다. - -:::tip +ここで、 - HTTP API는 모두 POST이며, 요청/응답 모두 JSON 형식입니다(drive/files/create 제외). - 요청 헤더에 `Content-Type: application/json`을 지정합니다. -- 액세스 토큰은 `i`라는 파라미터 이름으로 요청 본문 JSON에 포함합니다. -- 기본 URL은 `https://{서버의 도메인}/api`입니다. + +レスポンスに含まれるプロパティは以下の通りです: + +| 名前 | 説明 | +| ------- | -------------- | +| `token` | ユーザーのアクセストークン。 | +| `user` | ユーザーの情報。 | + +## APIの利用 + +アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。 + +:::tip + +- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。 +- 要求ヘッダーに`Content-Type: application/json`を指定します。 +- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。 +- ベースURLは`https://{サーバーのドメイン}/api`です。 ::: -액세스 토큰이 있는 바디의 예시 (meta의 경우):. +アクセストークン付きのボディの例（metaの場合）: ```json { @@ -116,10 +122,12 @@ https://{host}/api/miauth/{session}/check -API에 대한 자세한 내용은 API 레퍼런스를 참조하세요. +APIの詳細は、APIリファレンスを参照してください。 :::warning -Misskey는 REST를 채택하고 있지 않습니다. + +MisskeyはRESTを採用していません。 + ::: -또한 Misskey는 HTTP API뿐만 아니라 스트리밍 API도 제공하고 있습니다.스트리밍 API에 대한 자세한 내용은 [이 문서](./streaming/index.md)를 참고하세요. +また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 diff --git a/content/ko/docs/5.releases.md b/content/ko/docs/5.releases.md index 53380333..6e8f288d 100644 --- a/content/ko/docs/5.releases.md +++ b/content/ko/docs/5.releases.md @@ -6,14 +6,55 @@ maxTocDepth: 2 Misskey의 릴리즈 노트를 표시합니다. +## 2023.12.2 + +### 일반 + +- 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 +65,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 +75,11 @@ Misskey의 릴리즈 노트를 표시합니다. - Enhance: 아이콘 장식을 중복하여 설정할 수 있도록 - Enhance: 아이콘 장식의 위치를 미세 조정할 수 있도록 - Enhance: 팔로잉/팔로워 관계를 팔로우/팔로워 개별적으로 설정할 수 있도록 #12072 -- Enhance: 현지화 갱신 +- Enhance: ローカリゼーションの更新 - Enhance: 의존성 패키지 업데이트 - Fix: MFM `$[unixtime ]`에 올바르지 않은 값을 입력하였을 때에 발생하는 각종 오류를 수정 -### 클라이언트 +### Client - Feat: 팔로우 중인 유저 가운데 오늘 생일인 유저를 표시하는 위젯을 추가 - Feat: 화면에 눈이 흩날리는 효과를 추가 @@ -83,16 +124,16 @@ 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 @@ -1446,7 +1487,7 @@ Meilisearchの設定に`index`が必要になりました。値はMisskeyサー ### Notable features -- ロール機能 +- 역할 기능 - 従来より柔軟にユーザーのポリシーを管理できます。例えば、「インスタンスのパトロンはアンテナを30個まで作れる」「基本的にLTLは見れないが、許可した人だけ見れる」「招待制インスタンスだけどユーザーなら誰でも他者を招待できる」のような運用はもちろん、「ローカルユーザーかつアカウント作成から1日未満のユーザーはパブリックな投稿を行えない」のように複数条件を組み合わせて、自動でロールを付与する設定も可能です。 - Misskey Play - 従来の動的なPagesに代わる、新しいプラットフォームです。動的なコンテンツ(アプリケーション)に特化していて、Pagesに比べてはるかに柔軟なアプリケーションを作成可能です。 diff --git a/content/pl/docs/1.about-misskey.md b/content/pl/docs/1.about-misskey.md index a67dba09..4fb377d2 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) + ::: ## 開発に参加する、プロジェクトを支援する 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..832a67be 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,9 +11,11 @@ Misskeyを利用するには、どこかのサーバーにアカウントを作 [サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。 :::tip + どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 :::g-details{summary='詳細'} + Misskeyには連合機能が備わっています。 連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。 @@ -31,5 +33,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..699a1e15 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,6 +3,7 @@ 登録するサーバーが決まったら、さっそくアカウントを作成しましょう。 :::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..2061d91d 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上の様々なイベントをリアルタイムに受け取ることが可能です。 @@ -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/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..cc9f14b2 100644 --- a/content/pl/docs/2.for-users/4.resources/donate.md +++ b/content/pl/docs/2.for-users/4.resources/donate.md @@ -13,10 +13,13 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip + 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 + ::: :::tip + 額に応じて以下の返礼を用意しています。 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 @@ -25,10 +28,13 @@ 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..1f934100 100644 --- a/content/pl/docs/3.for-admin/features/announcement.md +++ b/content/pl/docs/3.for-admin/features/announcement.md @@ -5,6 +5,7 @@ お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。 :::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..d7aad8b5 100644 --- a/content/pl/docs/3.for-admin/features/role.md +++ b/content/pl/docs/3.for-admin/features/role.md @@ -21,6 +21,7 @@ - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) :::warning + コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 - 手動でのアサイン/アサイン解除は行えません。 @@ -53,6 +54,7 @@ **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** :::tip + 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 @@ -62,7 +64,8 @@ - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ::: + +::: ### ベースロールの値を使用 @@ -85,13 +88,17 @@ アサインする際にアサインされる期間を設定することが可能です。 :::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..f01b059d 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,10 +7,13 @@ description: Misskeyサーバーの作成方法についての案内です。 Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::warning + 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。 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..2b0b84be 100644 --- a/content/pl/docs/3.for-admin/install/guides/docker.md +++ b/content/pl/docs/3.for-admin/install/guides/docker.md @@ -7,7 +7,9 @@ description: このガイドはDockerを使ったMisskeyセットアップ方法 このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。 :::danger + 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::tip{label='前提条件'} @@ -34,7 +36,6 @@ cp ./docker-compose_example.yml ./docker-compose.yml ``` `default.yml`と`docker.env`をファイル内の説明に従って編集してください。\ -\ また、必要に応じて、`docker-compose.yml`を編集します。(ポートを変更したい場合など) ## ビルドと初期化 @@ -60,9 +61,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..250b3fab 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,6 +164,7 @@ sudo systemctl restart misskey ``` :::tip + ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: - `pnpm run clean`または`pnpm run clean-all` 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/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/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/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..9c25afc2 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 + アクセストークンは他人に知られないようにしてください。 + ::: ### アプリケーション利用者にアクセストークンの発行をリクエストする @@ -39,7 +43,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行 UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger + このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: #### Step 2 @@ -119,7 +125,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/5.releases.md b/content/pl/docs/5.releases.md index b7879489..c54e5eb9 100644 --- a/content/pl/docs/5.releases.md +++ b/content/pl/docs/5.releases.md @@ -6,6 +6,47 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2023.12.2 + +### 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 diff --git a/content/tw/docs/1.about-misskey.md b/content/tw/docs/1.about-misskey.md index bc2f8122..cf231969 100644 --- a/content/tw/docs/1.about-misskey.md +++ b/content/tw/docs/1.about-misskey.md @@ -15,16 +15,12 @@ Misskey 是一個開源分散式微網誌平台專案。 最初不是分散式的，但在2018年實施了ActivityPub並轉為分散式，使服務更廣泛被認知和使用，一直持續至今。 :::tip -Misskey 這個名字來自歌手 May'n 的歌曲 Brain Diver 的歌詞，syuilo 當時正在聽這首歌。 -::: 任何人都可以參與開發，目前開發工作仍在積極進行中。 -## 什麼是分散式？ +::: -分散(distributed)式，也稱去中心化(decentralized)，其特點是社群分佈在許多伺服器上，這些伺服器相互通信(聯邦、federation)，形成內容共享網路(聯邦宇宙、Fediverse)的服務。 -如果只有一個伺服器，或者有多個伺服器但彼此獨立，則稱為集中式服務，例如 Twitter 和 Facebook 等大多數服務就是這種情況。 -分散式系統的優點在於，您可以選擇最適合您的伺服器營運者和主題。您也可以建立自己的伺服器。透過聯邦，無論您選擇哪個伺服器，都可以存取同一個社群。 +誰でも開発に参加することができ、現在でも活発に開発が続いています。 ## 始終開放原始碼 @@ -34,115 +30,128 @@ Misskey 的所有原始碼均在開放原始碼許可證[AGPL](https://github.co 開源對於上述分散式方法也至關重要。 再舉一個例子，Twitter 和 Facebook 等大多數獲利服務都不是開源的。 +## 常にオープンソース + +Misskeyはこれまでもこれからも、オープンソースであり続けます。オープンソースとは、簡単に言うとソフトウェアのソースコード(プログラム)が公開されていることです。ソースコードの修正や再配布が可能であることを定義に含めることもあります。 +Misskeyのすべてのソースコードは[AGPL](https://github.com/misskey-dev/misskey/blob/develop/LICENSE)というオープンソースライセンスの下に[公開](https://github.com/misskey-dev)されていて、誰でも自由に閲覧、使用、修正、改変、再配布をすることができます。 +オープンソースは、自分で好きなように変えたり、有害な処理が含まれていないことを確認することができたり、誰でも開発に参加できるなどの、様々なメリットがあります。 +上述の分散型を実現するためにも、オープンソースであるということは必要不可欠な要素です。 +再び引き合いに出しますが、TwitterやFacebookなどの利益を得ているほとんどのサービスはオープンソースではありません。 + :::tip -從技術上來說，Misskey 的原始碼用 Git 管理，[託管在 GitHub。](https://github.com/misskey-dev) + +技術的に言うと、MisskeyのソースコードはGitで管理されていて、リポジトリは[GitHub上でホスティングされています。](https://github.com/misskey-dev) + ::: -## 參與開發和支援專案 +## 加入討論 -如果您喜歡 Misskey，請支持此專案。如下所述，有多種方式可以為專案做出貢獻。 我們期待您的參與。有些方法不需要任何開發技能，因此任何人都可以輕鬆加入並做出貢獻。我們期待您的參與。 - -### 新增功能或修復錯誤 - -其他可以幫助您更好地享受 Misskey 的資源。 - -### 加入討論 - -您也可以透過評論新功能或現有功能或報告錯誤來做出貢獻。 -此類討論可能會在 [GitHub](https://github.com/misskey-dev) 或 [論壇](https://forum.misskey.io/) 上進行。 +Misskeyを気に入っていただけたら、ぜひプロジェクトを支援してください。プロジェクトに貢献するには、以下で紹介するようにいろいろな方法があります。方法によっては開発のスキルは不要なので、誰でも気軽に参加し貢献することができます。いつでもお待ちしています。 ### 翻譯文字 -Misskey 支援多種語言（稱為 i18n - internationalization 的縮寫）。原始語言基本上是日語，但已被志願者翻譯成其他語言。 -您也可以透過參與翻譯工作為 Misskey 做出貢獻。 -Misskey 使用名為 [Crowdin 的服務來管理其翻譯。](https://crowdin.com/project/misskey) +ソフトウェアエンジニアのスキルをお持ちの方であれば、ソースコードを編集する形でプロジェクトに貢献することができます。 +貢献についてのガイドは[こちら](https://github.com/misskey-dev/misskey/blob/develop/CONTRIBUTING.md)です。 ### 發表您的想法 -除了報告錯誤之外，也請分享您對 Misskey 的優點和樂趣的正面看法。它將鼓勵發展並間接為專案做出貢獻。 +新しい機能、または既存の機能について意見を述べたり、不具合を報告したりすることでも貢献できます。 +そのようなディスカッションは[GitHub](https://github.com/misskey-dev)上か、[フォーラム](https://forum.misskey.io/)等で行われます。 ### 增加 Miskist -Miskist 是指使用Misskey的人。 如果您透過向朋友和熟人介紹來宣傳 Misskey，就會增加 Miskist 的數量，並激勵開發的動力。 +Misskeyは様々な言語に対応しています(i18n -internationalizationの略- と呼ばれます)。元の言語は基本的に日本語ですが、有志によって他の言語へと翻訳されています。 +その翻訳作業に加わっていただくことでもMisskeyに貢献できます。 +Misskeyは[Crowdinというサービスを使用して翻訳の管理を行っています。](https://crowdin.com/project/misskey) ### 捐款 -[請查看這裡](/docs/for-users/resources/donate/) +不具合報告等だけではなく、Misskeyの良い点、楽しい点といったポジティブな意見もぜひ共有してください。開発の励みになり、それは間接的ですがプロジェクトへの貢献です。 -## 常見問題 +### 常見問題 -### 專案的目標是什麼？ +ミスキストとは、Misskeyを使用する人のことです。 +知り合いに紹介するなどしてMisskeyを広めていただければ、ミスキストが増え開発のモチベーションが上がります。 -如果一定要說的話，雖然有些籠統，我們的目標是成為一個被廣泛使用的通用平台。 -與其他項目不同，Misskey的開發不基於任何意識形態（例如反對集中化）或願景，這一點上我們是比較開明的。 -反過來說，這創造了一種不受特定方向約束的靈活性。 +### 寄付をする + +[こちらをご覧ください](/docs/for-users/resources/donate/) + +## 是公司開發的嗎？ + +### プロジェクトは何を目指していますか？ + +強いて言うと、漠然的になりますが広く使われる汎用的なプラットフォームになることを目指しています。 +Misskeyは他のプロジェクトとは違い、何らかの思想(例えば、反中央集権)やビジョンに基づいて開発が行われているわけではなく、その点ではフラットです。 +それが逆に、特定の方向性に縛られないフレキシブルさを生み出すことに繋がっていると感じています。 -### 是公司開發的嗎？ - -不是。Misskey的開發是由個人進行的，並且不涉及商業活動，因此沒有與特定企業的聯繫。 -開發成員基本上都是志願者。 -此外，雖然有可能有企業贊助開發，但在這種情況下，開發仍然主要由個人社群主導。 - -### 誰在運行它？ - -由於 Misskey 是分散式的，因此每個伺服器都有不同的營運者。因此，Misskey並非全部由特定個人或公司經營。 -此外，由於開發團隊不運營伺服器，因此有關操作的任何疑問，請聯絡您所使用的伺服器的運營者。 -您可以在伺服器資訊頁面查看伺服器運營者。 -如果您建立了伺服器，您就成為營運者了。 - ### 應該選擇哪個伺服器？ [請參考伺服器清單。](/servers/) 有時候，伺服器會設定社群的主題（例如特定的事物或喜好）。因此，如果能找到符合自己興趣的伺服器，可能是個不錯的選擇。 此外，還有其他考慮因素，如伺服器的規模、使用者層、國家和語言，以及運營者是否可信賴等。 -需要注意的是，Misskey沒有官方的伺服器。您也可以選擇自己建立新伺服器。 +需要注意的是，Misskey沒有官方的伺服器。 -基本上，無論您選擇哪個伺服器，您都可以與所有其他伺服器的使用者聯繫。 +### 誰が運営していますか？ -### 如何建立伺服器？ +Misskeyは分散型なため、各サーバーにそれぞれ異なった運営者がいます。従って、特定の個人や企業によって、Misskeyの全てが運営されているわけではありません。 +また、開発チームが運営を行うわけでもないため、運営に関する連絡は、お使いのサーバーの運営者に行ってください。 +サーバーの運営者は、サーバーの情報ページで確認することができます。 +あなたがサーバーを作成すれば、あなたが運営者になります。 -感謝您對創建 Misskey 伺服器的興趣。 -截至 2022 年，Misskey 還沒有提供託管服務，因此建立伺服器需要一定的知識。 -有關如何建立伺服器的資訊，請參閱[此處](/docs/for-admin/install/)。 +### どのサーバーを選べばいいですか？ -### 使用了哪些技術？ +[サーバー一覧が公開されています。](/servers/) +サーバーによってコミュニティのテーマ(特定のこと、ものが好き 等)が決められている場合があるので、自分に合ったテーマのサーバーがあれば、そこを選ぶと良いかもしれません。 +他にも、サーバーの規模、ユーザー層、国および言語、運営者が信頼できるかどうか、などの観点があります。 +なお、Misskey公式のサーバーというものはありません。自身で新しくサーバーを作成するという選択肢もあります。 -隨著開發的進展，Misskey 使用的技術發生了顯著變化。開發之初的配置是MySQL + PHP + jQuery，但現在是這樣的。 +基本的にどのサーバーを選んだとしても、他の全てのサーバーのユーザーと繋がることができます。 -- 伺服器端：Node.js -- 資料庫：PostgreSQL、Redis -- 使用者介面框架：Vue.js -- 程式語言： TypeScript +### サーバーを建てるにはどうしたらいいですか？ 我們也正在開發源自 Misskey 的專有技術，例如 MFM 和 AiScript。 ### 是 Mastodon 的分支嗎？ 不是。Misskey是一個完全獨立於Mastodon和其他軟體平台的專案。 -就開發而言，Misskey的開發歷史比較長。然而，Misskey實做分散式協議的時間是在Mastodon之後。 -除了實現了相同的ActivityPub協議這一點之外，兩者並沒有特別的關聯。 +就開發而言，Misskey的開發歷史比較長。 -### 有 iOS/Android 應用程式嗎？ +- サーバーサイド: Node.js +- データベース: PostgreSQL、Redis +- UIフレームワーク: Vue.js +- プログラミング言語: TypeScript 官方沒有為此類作業系統開發原生應用程序，但有一些第三方應用程式可供使用。 詳情請參閱 [此處](/docs/for-users/resources/apps/)。 -不過，由於第三方應用程式不可避免地會在功能支援方面落後，如果你不是特別挑剔，我們建議你使用官方網頁用戶端。 -此外，Misskey 網頁用戶端支援 PWA，因此可以像原生應用程式一樣運作。 +### Mastodonのフォークですか？ -### 在哪裡可以獲得 Misskey 標誌和圖示？ +いいえ。MisskeyはMastodonやその他のプロジェクトとは全く別のプロジェクトです。 +開発に関しても、Misskeyの方が昔から開発されています。ただし、分散型になったのはMastodonの登場より後です。 +同じActivityPubという分散のためのプロトコルを実装しているという点以外、両者に特に関りがあるわけでもありません。 -[在這裡](/brand-assets/) +### iOS/Androidのアプリはありますか？ -### 那偶爾出現的可愛貓耳女孩是誰？ +公式にはそういったOSのネイティブアプリを開発していませんが、サードパーティ製のアプリがいくつかあります。 +詳しくは[こちら](/docs/for-users/resources/apps/)をご覧ください。 + +ただ、サードパーティ製アプリはどうしても機能への対応が遅れてしまうため、とくに拘りがなければ公式のWebクライアントの利用をおすすめします。 +なお、MisskeyのWebクライアントはPWAに対応しているので、ネイティブアプリのように動作させることも可能です。 + +### Misskeyのロゴ、アイコンはどこで入手できますか？ + +[こちら](/brand-assets/) + +### 時折目にする猫耳の可愛い女の子は？ :::fukidashi{chara="doya_ai" charaName="藍"} -想了解更多關於我的訊息，請訪問 [這個網站](https://xn--931a.moe/)！ +わたしについては[このホームページ](https://xn--931a.moe/)をご覧ください！ ::: :::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"} -Misskey 的守護神小藍。小藍超級可愛！ +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..ffcb0311 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,11 +11,14 @@ Misskey 是一款軟體及其專案。 您可以從[伺服器清單](/servers/)中選擇您喜歡的伺服器。 :::tip -どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 :::g-details{summary='詳細'} Misskey 具有聯邦功能。 +:::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..59c308cb 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,6 +3,7 @@ 一旦您決定了要註冊的伺服器，就可以建立帳戶了。 :::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..15fbd50c 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,17 +7,21 @@ 在 Misskey 上發布訊息被稱為「貼文」。與 Twitter 等一般的 SNS 相比它的功能更多，所以第一次發文前請務必確認並好好發文！ :::tip -詳情請參閱 [note](/docs/for-users/features/note/)。 + +詳細は、「[ノート](/docs/for-users/features/note/)」をご覧ください。 + ::: -## 時間軸 +## タイムライン -Misskey 有多個時間軸。光是名稱可能就有點令人困惑，因此了解每個時間軸的作用非常重要。 +Misskeyは、複数のタイムラインを持っています。名前だけでは少々わかりにくいかと思いますので、それぞれがどのような働きをするのかを知っておきましょう。 :::tip -詳情請參閱"[時間軸](/docs/for-users/features/timeline/)"。 + +詳細は、「[タイムライン](/docs/for-users/features/timeline/)」をご覧ください。 + ::: -## 其他 +## その他 -Misskey 還有許多有趣的功能！所有功能說明均可在[這裡](/docs/for-users/features/)找到，請務必查看！ +その他にも、Misskeyには、使って楽しい機能が盛りだくさん！すべての機能に関する説明は[こちら](/docs/for-users/features/)に記載されていますので、ぜひご覧ください！ 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..475153d5 100644 --- a/content/tw/docs/2.for-users/3.features/ads.md +++ b/content/tw/docs/2.for-users/3.features/ads.md @@ -4,10 +4,12 @@ Misskey有一個功能，可以讓您在時間軸上顯示來自伺服器的廣 您可以點擊廣告右上角顯示的圖示來減少廣告的顯示頻率。 :::tip -如果廣告總數較少，即使降低展示頻率，也可能會繼續展示。 + +広告の総数が少ない場合は、表示頻度を下げた後も連続で表示される可能性があります。 + ::: -## 設定廣告（管理員） +## 広告の設定(管理者) -可以從伺服器的控制台新增、編輯和刪除廣告。 -廣告可配置任何圖片、目標 URL、形狀和顯示比例 +サーバーのコントロールパネルから広告の追加、編集、削除を行えます。 +広告には任意の画像、遷移先URL、形状、表示割合を設定できます。 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..528043b6 100644 --- a/content/tw/docs/2.for-users/3.features/drive.md +++ b/content/tw/docs/2.for-users/3.features/drive.md @@ -3,23 +3,27 @@ 雲端硬碟是一項允許您在 Misskey 管理上傳檔案的功能。 :::tip -從技術上來說，所有上傳檔案都由 Misskey 系統集中管理，向使用者提供這些資訊的介面可以視作一個雲端硬碟。 -::: 您可以從 Misskey Web 上的雲端硬碟頁面上傳任何檔案，也可以將您設定為頭像的任何圖片和您貼文中附加的任何檔案上傳到雲端硬碟。 -上傳到雲端硬碟的檔案可以隨時下載，或在建立貼文時透過「從雲端空間」重複使用檔案。 +::: 您也可以在硬碟中建立資料夾，將多個檔案組織在一起。 +ドライブにアップロードされたファイルは、いつでもダウンロードすることができるほか、ノート作成時に「ドライブからファイルを添付」することでファイルを再利用することもできます。 + +ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。 + :::warning -目前，如果從雲端硬碟中刪除檔案， **該檔案所依附的所有內容（貼文、頁面等）** 都會同時消失。 -::: - -## 敏感內容 (NSFW) - -敏感或NSFW（Not safe for work，工作場所不宜）是可以在雲端硬碟中的檔案上設定的標記。 -設定了敏感標記的檔案在查看時，如果沒有查看者的主動操作則不可見。 -例如，在工作場所或公共場所不適合觀看的圖像上設定此標記，目的是防止突然顯示此類圖像。 此標記可以手動開啟或關閉，也可以由審查員自行設定。 + +::: + +## センシティブ (NSFW) + +センシティブまたはNSFW (Not safe for work) は、ドライブのファイルに設定することができるフラグです。 +センシティブフラグを設定されたファイルは、表示される際に閲覧者の操作なしには表示されなくなります。 +このフラグは、例えば職場や公共の場で閲覧するのに適切でないと思われる画像などに設定し、そのような画像が突然表示されてしまうことを防ぐ目的で使われます。 + +このフラグは手動でオンオフを切り替えられるほか、モデレーターの判断で設定される場合もあります。 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..48392942 100644 --- a/content/tw/docs/2.for-users/3.features/mfm.md +++ b/content/tw/docs/2.for-users/3.features/mfm.md @@ -7,23 +7,27 @@ description: MFM 是一種專有的標記語言，可以在 Misskey 的各個地 MFM 代表 Markup language For Misskey，是一種專有的標記語言，可以在 Misskey 的各個地方使用。 :::tip -某些語法與 Markdown 和 HTML 相容。 + +一部の構文はMarkdownやHTMLと互換性があります。 + ::: -## 可使用 MFM 的地方 - -- 貼文的正文 -- CW註釋 -- 使用者名稱 -- 使用者的自我介紹 - ## 語法 -### 提及 +- ノート本文 +- CW注釈 +- ユーザーの名前 +- ユーザーの自己紹介 -「@ + 使用者名稱」可用來表示特定使用者。 +## 構文 + +### メンション + +アットマーク + ユーザー名で、特定のユーザーを示すことができます。 :::tip -有關提及的更多資訊，請參閱[此處](./mention.md)。 + +メンションについての詳細は[こちら](./mention.md)を参照してください。 + ::: ``` @@ -40,9 +44,11 @@ MFM 代表 Markup language For Misskey，是一種專有的標記語言，可以 ### 主題標籤 -「# + 標籤」來表示主題標籤。 +ナンバーサイン + タグで、ハッシュタグを示すことができます。 :::tip -有關主題標籤的更多資訊，請參閱[此處](./hashtag.md)。 + +ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。 + ::: ``` @@ -70,6 +76,7 @@ https://example.com ``` :::tip + リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。 ``` @@ -82,9 +89,12 @@ https://example.com ### 自訂表情符號 -您可以透過用冒號包圍自訂表情符號名稱來顯示自訂表情符號。 +コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。 + :::tip -有關自訂表情符號的更多信息，請參閱[此處](./custom-emoji.md)。 + +カスタム絵文字についての詳細は[こちら](./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..351fa1a5 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,52 +5,62 @@ 對方不會知道你被靜音了，但會知道你被封鎖了。您可以自行決定選擇其中一種方式。 :::tip -靜音和封鎖可以一起使用。 + +ミュートとブロックは併用できます。 + ::: :::warning -如果有任何違反服務條款的惱人用戶，請考慮向管理者檢舉。 -::: - -在 Misskey Web 上，您可以透過前往「設定」>「靜音和封鎖」來查看已靜音或封鎖的使用者清單。 - -## 靜音 將使用者靜音後，Misskey 中將不會顯示該使用者的以下內容： -- 時間軸和貼文搜尋結果中的使用者貼文（以及對這些貼文的回覆和轉發） -- 來自該使用者的通知 -- 通知訊息歷史清單中該使用者的通知訊息歷史記錄 -- 追隨 +::: 若要在 Misskey Web 上將使用者靜音，請開啟該使用者個人檔案頁面上的選單，然後按下「靜音」按鈕。 +## ミュート + +ユーザーをミュートすると、そのユーザーに関する次のコンテンツがMisskeyに表示されなくなります: + +- タイムラインや投稿の検索結果内の、そのユーザーの投稿(およびそれらの投稿に対する返信やRenote) +- そのユーザーからの通知 +- メッセージ履歴一覧内の、そのユーザーとのメッセージ履歴 +- など + +Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。 + :::tip -對方不會收到您將其靜音的通知，他們也不會知道已被您靜音。 + +ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。 + ::: -## 封鎖 +## ブロック -封鎖用戶會使該用戶無法看到您的內容，並阻止他們對您採取以下行動。 +ユーザーをブロックすると、そのユーザーからあなたのコンテンツが見えないようになり、またあなたに対して以下のようなアクションをすることができなくなります。 -- 追隨 -- 新增使用者到清單 -- 回覆或轉發貼文 -- 對您的貼文做出反應或參與投票活動 -- 發送提及給您 -- 追隨 +- フォローする +- ユーザーリストに追加する +- 返信する、Renoteする +- リアクションする、アンケートに投票する +- メッセージを送信する +- など -等等 +また、 -- 如果您封鎖用戶時該用戶已經追隨您，將被取消追隨 -- 如果您封鎖該使用者時，該使用者的清單中已包含您，您將從該清單中刪除。 +- ブロックする際に既にそのユーザーからフォローされていた場合はフォローが解除されます。 +- ブロックする際に既にそのユーザーがあなたをユーザーリストに入れていた場合はそのリストからあなたが削除されます。 -若要在 Misskey Web 上封鎖用戶，請開啟該使用者個人檔案頁面的選單，然後按下「封鎖」按鈕 +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..0fa290e1 100644 --- a/content/tw/docs/2.for-users/3.features/pages.md +++ b/content/tw/docs/2.for-users/3.features/pages.md @@ -3,24 +3,22 @@ 您可以在 Misskey 上建立獨立於筆記的頁面。v13 以後專門用於靜態頁面。 :::warning -從 v13 開始，需使用 Misskey Play 來建立動態頁面。 + +v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。 + ::: -## 頁面設定 +## ページ設定 -設定與頁面相關的項目，包含： +ページに関する項目を設定します。次の項目を入力できます。 -- 標題 -- 頁面摘要 -- 頁面網址 -- 置中 -- 字型 -- 被置頂於個人資料時隱藏頁面標題 -- 封面影像 - -### 標題 - -輸入該頁面的標題。它將顯示在列表中。 +- タイトル +- ページの要約 +- ページURL +- 中央寄せ +- フォント +- ピン留めされているときにタイトルを非表示 +- アイキャッチ画像 ### 頁面摘要 @@ -28,7 +26,7 @@ ### 頁面網址 -`https://伺服器名/@使用者/pages/●●●` 的 `●●●` 可以任意設置。 +簡単な説明を入力します。一覧に表示されます。 ### 置中 @@ -44,20 +42,20 @@ ### 封面影像 -設定 **封面影像** 。它將顯示在列表中。 +ピン留めされているときにタイトルを非表示にします。 -## 內容 +### 內容 編輯頁面正文。您可以透過組合以下一個或多個區塊來產生頁面。 -- 區段 -- 文字 -- 圖片 -- 嵌入貼文 +## コンテンツ -### 區段 +ページ本体を編集します。次のブロックを一つまたは複数組み合わせてページを生成できます。 -可以設置專屬的標題。並且可在其中增加額外的區塊。 +- セクション +- テキスト +- 画像 +- ノート埋め込み ### 文字 @@ -70,3 +68,7 @@ ### 嵌入貼文 輸入貼文 ID 後，貼文就會顯示出來。如果要嵌入其他伺服器，請在搜尋中輸入其 URL，然後在顯示時貼上 ID。 + +### ノート埋め込み + +ノート ID を入れる事で、そのノートを表示します。他のサーバーを埋め込みたい場合は検索でそのURLを入れ、表示させた時のIDを貼り付けて下さい。 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..ef2769a5 100644 --- a/content/tw/docs/2.for-users/3.features/poll.md +++ b/content/tw/docs/2.for-users/3.features/poll.md @@ -13,35 +13,39 @@ 如果您新增了太多選項，可以透過按下選項旁邊的 ☓ 按鈕將其刪除。 :::warning -如果任何選項欄位為空值，您將無法發布附有該投票的貼文。 + +いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。 + ::: -## 允許複選 - -打開「允許複選」開關，允許參與您票選活動的人對多個選項進行投票。 - ## 設定票選活動截止日期 可以透過指定日期和時間或指定時效來設定票選活動的結束期限。 -若要進行設置，請按一下「期限」欄位中的「結束時間」或「指定時效」。 +## アンケートの期限を設定する 如果要取消已設定的截止期限，請從「期限」欄位中選擇「無期限」。 -## 對票選活動進行投票 +設定するには、「期限」の欄から「日時指定」もしくは「経過指定」をクリックします。 當您看到時間軸上附有票選活動的貼文時，可進行投票。 -點擊各個選項即可對票選活動進行投票。如果發布票選活動的使用者不允許多個答案，則會顯示當下的投票結果。 +## アンケートに投票する -如果發布票選活動的用戶已將其設定為允許複選，也可以對其他選項進行投票。在這種情況下，結果不會自動顯示。 +アンケートが添付されたノートがタイムラインに流れてきたときは、アンケートに投票してみましょう。 -無論允許複選的設定為何，如果您沒有自動看到投票結果，或者您想在投票前看到結果，都可以點擊選項下方的「顯示結果」來查看調查結果。 +アンケートに投票するには、各選択肢をクリックします。アンケートを投稿したユーザーが複数回答可に設定していない場合は、その時点でのアンケートの結果が表示されます。 -如果您想在查看未投票的調查結果後再次隱藏這些結果，請按一下「投票」。 +アンケートを投稿したユーザーが複数回答可に設定していた場合、他の選択肢にも投票することができます。この場合、結果は自動では表示されません。 -:::tip -未投票的票選活動仍可進行投票，並顯示結果。 -::: +複数回答の設定に関わらず、自動でアンケートの結果が表示されなかったり、投票前に結果を見たい時は、選択肢の下にある「結果を見る」をクリックしてアンケートの結果を表示することができます。 當您投票後，您投票的選項旁邊會出現 ✔。 + +:::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..a222307d 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,55 +7,59 @@ ## 查詢參數 :::tip -所有參數均為**可選**參數，非必要參數。 + +すべてのパラメータは**オプション**であり、必須ではありません。 + ::: -| 名稱 | 說明 | -| ------- | -------------------------------------------------------------------- | -| `title` | 名稱在本文的開頭[ … ]插入。 | -| `text` | 本文 | -| `url` | 網址。將被插入在本文的末尾。 | +| 名前 | 説明 | +| ------- | ---------------------------------------------------------------------------- | +| `title` | タイトル。本文の先頭に[ … ]と挿入されます。 | +| `text` | 本文。 | +| `url` | URL。本文の末尾に挿入されます。 | -### 回覆訊息 +### リプライ情報 -您可以指定以下其中一項以使其成為對指定貼文的回應。 +以下のいずれかを指定すると、指定のノートに対するリプライにすることができます。 -| 名稱 | 說明 | -| ---------- | ------------------- | -| `replyId` | 要回覆的貼文 ID。 | -| `replyUri` | 回覆的目標網址。（指定遠端貼文物件）。 | +| 名前 | 説明 | +| ---------- | ----------------------------- | +| `replyId` | リプライ先のノートID。 | +| `replyUri` | リプライ先のURL。（リモートのノートオブジェクトを指定） | -### 轉發訊息 +### Renote情報 -指定以下其中一項，可以將它設為指定貼文的轉發（引用）。 +以下のいずれかを指定すると、指定のノートに対するRenote(引用)にすることができます。 -| 名前 | 説明 | -| ----------- | ------------------- | -| `renoteId` | 要回覆的貼文 ID。 | -| `renoteUri` | 回覆的目標網址。（指定遠端貼文物件）。 | +| 名前 | 説明 | +| ----------- | ------------------------------- | +| `renoteId` | Renote先のノートID。 | +| `renoteUri` | Renote先のURL。（リモートのノートオブジェクトを指定） | -### 公開範圍 +### 公開範囲 -您可以使用下列選項指定公開範圍。 +以下のオプションで公開範囲の指定を行えます。 -| 名稱 | 說明 | -| ---------------- | ----------------------------------------------------------------------- | -| `visibility` | `public` （公開）， `home` （首頁）， `followers` （追隨者）， `specified` （指定使用者）中選擇其一 | -| `localOnly` | 停用聯邦（僅限本地），可使用 0(false) 或 1(true) | -| `visibleUserIds` | 目標使用者 ID（以逗號分隔） | -| `visibleAccts` | 目標使用者 [acct](../resources/glossary/#acct)（逗號分隔） | +| 名前 | 説明 | +| ---------------- | -------------------------------------------------------------------- | +| `visibility` | `public`, `home`, `followers`, `specified` のいずれか | +| `localOnly` | 0(false) or 1(true) | +| `visibleUserIds` | 対象ユーザーID(カンマ区切り) | +| `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) | :::warning -如果為 `visibility` 指定了 `specified`，則也必須指定 `visibleUserIds` 或 `visibleAccts`。 + +`visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。 + ::: -### 附加檔案 +### 添付ファイル -您可以使用下列選項指定附加檔案。 +以下のオプションで添付ファイルの指定を行えます。 -| 名稱 | 說明 | -| --------- | -------------- | -| `fileIds` | 附加檔案 ID（以逗號分隔） | +| 名前 | 説明 | +| --------- | -------------------------------------- | +| `fileIds` | 添付するファイルのID(カンマ区切り) | ## Misskey Hubの共有フォーム中継サービスについて 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..d44608b6 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,15 +1,19 @@ # 將貼文串設為靜音 :::tip -從 v12.95.0 新增的功能。 + +バージョン 12.95.0 以降の機能です。 + ::: -貼文串靜音將指定貼文整串靜音。貼文串是指從起始貼文開始連接的所有回覆。 +スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。 -當您將某個貼文串設定為靜音後，您將不再收到貼文串的新回覆和回覆中對您的任何提及，也不會出現通知功能的「提及」部分。 +スレッドをミュートすると、そのスレッドへの新たなリプライおよびリプライに含まれるあなた宛てのメンションが、通知されなくなるほか「あなた宛て」にも載らなくなります。 -若要將 Misskey Web 上的貼文串靜音，請開啟屬於貼文串該的任何貼文或起始貼文的選單，然後選擇「將貼文串設為靜音」。 +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..e45c608e 100644 --- a/content/tw/docs/2.for-users/3.features/webhook.md +++ b/content/tw/docs/2.for-users/3.features/webhook.md @@ -1,77 +1,37 @@ # Webhook :::tip -從 v12.109.0 新增的功能。 + +バージョン 12.109.0 以降の機能です。 + ::: :::warning -由於這是一項試驗性功能，因此可能不穩定，或者將來規格可能會發生變化。 + +実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。 + ::: -Misskey 提供了 Webhook。使用 Webhook，您可以即時接收 Misskey 上的各種事件。 - -您可以在「設定」>「Webhook」中管理您的 Webhook。 - -Webhook 註冊後，當指定事件發生時，將向指定 URL 傳送 HTTP 請求。請求方法為 POST，內文為 JSON。 -此外，請求標頭將包含您在註冊期間設定的金鑰，名為「X-Misskey-Hook-Secret」。透過驗證此機密，可以確定請求是否合法。 - -請求負載包含以下屬性。 - - +MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。 如果目標伺服器傳回 5xx 錯誤或無回應，則請求將在一段時間後重新傳輸。 -您可以從管理畫面單獨設定 Webhook 的活動狀態，並且可以暫時停止傳送請求。 +Webhookが登録されると、指定したイベントが発生した際に、指定したURLにHTTPリクエストが送信されます。リクエストのメソッドはPOSTで、ボディはJSONです。 +さらに、リクエストヘッダーには`X-Misskey-Hook-Secret`という名前で、登録時に設定したシークレットが含まれます。このシークレットが正しいか検証することで、リクエストが正規のものか判定することができます。 -## 事件 +リクエストペイロードは以下のプロパティが入ります。 提供每個事件的描述和負載。 -### follow +送信先サーバーが5xxエラーを返すか、応答しなかった場合は時間を開けてリクエストが再送されます。 當您追隨某人時會發生。 - +## イベント -### followed +イベントごとに説明とペイロードを示します。 -當有人追隨您時發生。 +### follow -### unfollow + -當您取消追隨某人時會發生。 當您發布貼文時發生。 +### followed -### note + -當您發布貼文時發生。 +### unfollow -### reply + -當您回覆貼文時發生。 +### note -### renote + -當您自己的貼文被轉發時發生。 +### reply -### mention + -當有人提到你時發生。 +### renote + + + +### mention + +自分にメンションされた際に発生します。 + + 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..21c021da 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,78 +5,81 @@ description: 如果您遇到問題，請先檢查此處。 # 故障排除 :::tip -也請參考[常見問題](./faq.md)。 -::: 如果您遇到問題，請先檢查此處。 如果沒有適用的項目，或嘗試這些步驟後問題仍未解決，請聯絡伺服器管理員或[報告錯誤](../../about-misskey/#議論に参加する)。 -## 客戶端無法啟動 +::: 大多數情況下，這是由於瀏覽器或作業系統版本過時造成的。 請將瀏覽器和作業系統更新到最新版本，然後再試一次。 -儘管這種情況很少見，但如果仍然無法啟動，則您的快取可能是罪魁禍首。請清除瀏覽器快取並重試。 +## クライアントが起動しない -## 頁面無法載入 +ほとんどの場合、お使いのブラウザまたはOSのバージョンが古いことが原因です。 +ブラウザおよびOSのバージョンを最新のものに更新してから、再度試してみてください。 如果出現用戶端啟動但無法載入頁面的錯誤，請檢查網路是否有問題。也要檢查伺服器是否當機。 -儘管這種情況很少見，但這可能是由快取引起的。請清除瀏覽器快取並重試。 +## ページが読み込めない -如果您仍然遇到問題，請聯絡您的伺服器管理員，因為這可能是伺服器問題。 +クライアントが起動するもののページが読み込めないというエラーが出る場合は、ネットワークに問題がないか確認してください。また、サーバーがダウンしていないか確認してください。 -## 客戶端運作緩慢 +これは稀ですが、キャッシュが原因の場合があります。ブラウザのキャッシュをクリアして、再度試してみてください。 檢查網路服務供應商的故障或維護計劃，檢查網路通訊速度狀態和網路設置，並檢查伺服器端是否有任何問題或維護，然後嘗試或確認以下設定： -1.Misskey Web的設定 -從選單中開啟設定，開啟客戶端設定的「一般」，然後嘗試以下設定： +## クライアントの動作が遅い -- 在外觀停用「在 UI 上使用模糊效果」 -- 在外觀停用「在 UI 上使用模糊效果」 -- 在外觀啟用「使用系統預設的字型」 -- 在外觀的「表情符號的風格」選擇「原生」（預設是Twemoji） +インターネットサービスプロバイダーの障害やメンテナンス予定の確認、ネットワークの通信速度の状態やネットワーク設定の確認、そしてサーバー側で何らかの障害やメンテナンスが発生しているかどうかを確認した上で、以下の設定を試すまたは確認してください: 請嘗試以下設置，但請注意某些 Misskey 功能可能無法運作。 -- 動作の「Pagesのスクリプトを無効にする」を無効にする -- アピアランスの「動きのあるMFMを無効にする」を有効にする +- アピアランスの「UIのアニメーションを減らす」を有効にする +- アピアランスの「モーダルにぼかし効果を使用」を無効にする +- アピアランスの「システムデフォルトのフォントを使う」を有効にする +- アピアランスの「OSネイティブの絵文字を使用」を有効にする 2.網頁瀏覽器設定 - 在網頁瀏覽器設定中啟用硬體加速 - 檢查您的網頁瀏覽器外掛程式和擴充功能設定或將其關閉 -- 檢查網頁瀏覽器的其他設定 3.其他 - 檢查您的電腦或智慧型手機的系統設置 +- お使いのWebブラウザのアドオンや拡張機能の設定を確認するか、それらの機能をオフにする +- お使いのWebブラウザのその他の設定を確認する -## Misskey Web UI 的一部分顯示很奇怪（背景是透明的等） +3.その他 -當UI因更新而修改時，由於主題的快取系統，可能會出現這樣的顯示。 -可以透過客戶端設定中的「清除快取資料」來修復此問題。 +- お使いのPCやスマートフォンのシステム設定を確認する + +## Misskey WebのUIの一部表示がおかしい(背景が透明になっている等) + +アップデートによりUIの改修が行われたときに、テーマのキャッシュシステムの影響でそのような表示になることがあります。 +クライアントの設定の「キャッシュをクリア」すると直ります。 :::warning -是清除「客戶端」的快取。請不要清除「瀏覽器」的快取。 + +「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。 + ::: -## 閃爍的通知、天線等不會消失 - -閃爍表示有未讀內容。通常情況下，如果閃爍沒有消失，代表較早的時間仍有未讀內容。 -如果您認為已經閱讀了所有內容，但閃爍仍在繼續（可能是故障），您可以透過設定強制將所有內容標記為已讀。 - -## 無法轉發貼文 - -僅限追隨者可見的貼文和私訊無法轉發。 - ## 某些元素在 Misskey Web UI 上不可見 如果您在網路瀏覽器上使用廣告攔截器等附加元件或擴充程序，則可能會出現此類問題。請檢查這些設定或將其關閉。 ## Misskey Web UI 上有未翻譯的部分 -大多數情況下，這是由於 Misskey Web UI 沒有及時翻譯所致，因此不是故障。對不起，請稍等片刻，等待翻譯完成。 +公開範囲がフォロワー限定のノートおよびDMはRenoteすることはできません。 -如果您有興趣進一步了解 Misskey 的翻譯工作，當然也可以[參與翻譯](../../about-misskey/#テキストを翻訳する)。 +## Misskey WebのUI上で特定の要素が表示されない + +Webブラウザで広告ブロッカーなどのアドオンや拡張機能を使用していると、そのような不具合が発生することがあります。それらの設定を確認するか、オフにしてご利用ください。 + +## Misskey WebのUI上で未翻訳の部分がある + +ほとんどの場合、Misskey WebのUIの翻訳が間に合っていないことが原因ですので、不具合ではありません。翻訳が終わるまで申し訳ありませんが、しばらくお待ちください。 + +もし、あなたがMisskeyの翻訳についてご興味があるなら[翻訳に参加](../../about-misskey/#テキストを翻訳する)していただくことは、もちろん可能です。 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..12d8563b 100644 --- a/content/tw/docs/2.for-users/4.resources/donate.md +++ b/content/tw/docs/2.for-users/4.resources/donate.md @@ -13,10 +13,13 @@ Misskey不是一家企業，由於它是免費使用的，開發者所能獲得 - [亞馬遜的願望清單](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) :::tip -如果您的捐款金額較大（例如5萬日圓以上），使用PayPal等方式會被抽取高額手續費，因此請考慮使用Kyash或聯絡我們，我們將為您提供銀行帳戶資訊。 + +高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 + ::: :::tip + 額に応じて以下の返礼を用意しています。 - 1,000日圓以上: 將mi徽章附加到您的misskey.io帳戶上 @@ -25,8 +28,11 @@ Misskey不是一家企業，由於它是免費使用的，開發者所能獲得 ::: :::warning + **由於徽章的分配和列入捐款芳名錄不是自動的，請將您的申請發送至 @syuilo\@misskey.io ，並提供您已捐款的資訊。** -(如果您沒有收到回覆，請多次提及我，因為我可能沒有注意到您的提及。此外，您可能無法從 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..3b4d8078 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,9 +6,11 @@ Misskey Hub 是 Misskey 的官方網站，提供有關 Misskey 的知識和其 歡迎提供更多文件和翻譯。Misskey Hub 也是[開放原始碼](https://github.com/misskey-dev/misskey-hub) :::tip -Misskey Hub 是使用 Nuxt 建置的靜態網站。 + +Misskey HubはNuxtを使ってビルドされた静的サイトです。 + ::: -## 為 Misskey Hub 做出貢獻 +## 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..ec3e91ff 100644 --- a/content/tw/docs/3.for-admin/features/announcement.md +++ b/content/tw/docs/3.for-admin/features/announcement.md @@ -5,6 +5,7 @@ 透過公告功能，使用者可以發布伺服器範圍內的公告，也可以從伺服器發送訊息給單一使用者。 :::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..9e069f94 100644 --- a/content/tw/docs/3.for-admin/features/role.md +++ b/content/tw/docs/3.for-admin/features/role.md @@ -21,6 +21,7 @@ - **有條件的** ... 您可以設定條件，滿足條件的使用者將自動包含在內。（條件角色） :::warning + コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 - 無法手動指派/取消指派。 可以執行基本的審查操作。 它也不能在基本角色中設定。 @@ -53,6 +54,7 @@ **如果優先權相同，則預設選擇最大或最權威的值。** :::tip + 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 - 如果優先權相同而角色 A 的雲端硬碟容量政策優先權較高，則使用500MB的值。 @@ -61,8 +63,9 @@ 此外，如果為使用者指派了角色 C 和角色 D，並且角色 C 的公開發布政策定義為「否」，而角色 D 的公開發布政策定義為「是」的情況 - 如果優先順序相同而角色 D 中公開發布政策的優先順序較高，則採用「是」。 -- 如果角色 C 的公開發布政策的優先順序較高，則採用「否」。 - ::: +- ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 + +::: ### 使用基本角色的值 @@ -85,11 +88,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..49efba1c 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,10 +7,13 @@ description: 有關如何建立 Misskey 伺服器的指南。 感謝您對 Misskey 伺服器的建置表達興趣。建立伺服器有幾種方法，請選擇以下一種並閱讀指南。 :::danger -一旦開始使用，請勿使用伺服器的網域名稱/主機名稱重新建立資料庫！ + +一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ + ::: :::warning + 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 Misskey 的原始碼已經被壓縮，這不僅是無意義的，而且由於 Cloudflare 無法解析最新的 JavaScript 並破壞內部原始碼，導致 Misskey 無法正常運作。 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..c0002d55 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,17 @@ 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 +27,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 +58,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 +76,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..3f2eea1b 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,15 +161,16 @@ NODE_ENV=production pnpm run build pnpm run migrate ``` -根據更新內容和資料庫大小，可能需要一些時間。 +アップデート内容、およびデータベースの規模によっては時間がかかることがあります。 -更新完成後，請重新啟動 Misskey 服務。 +アップデートが終わり次第、Misskeyプロセスを再起動してください。 ```sh sudo systemctl restart misskey ``` :::tip + ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: - `pnpm run clean` 或 `pnpm run clean-all` 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/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/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/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..dd3d7f1b 100644 --- a/content/tw/docs/4.for-developers/api/token.md +++ b/content/tw/docs/4.for-developers/api/token.md @@ -7,62 +7,68 @@ 存取權杖是與用戶關聯的身份驗證資料，用於識別使用API的用戶，同時管理每個存取權杖具有什麼樣的操作權限。 :::tip -使用者和與該使用者關聯的存取權杖之間存在一對多關係，並且可以向​​使用者發行多個存取權杖。 -::: 你可以輕鬆地獲得自己的存取權杖，也可以獲取使用你的應用程序的不特定用戶的存取權杖。 -- 如果是前者：**閱讀「手動發行您自己的存取權杖」** -- 如果是後者：閱讀「**請求應用程式使用者發行存取權杖**」 - -### 手動發行您自己的存取權杖 - -您可以在 Misskey Web 的「設定 > API」中發行自己的存取權杖。 - -:::danger -請不要與他人分享您的存取權杖。 ::: -### 請求應用程式使用者發行存取權杖 +あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 -若要為使用應用程式的使用者（以下簡稱「使用者」）取得存取權杖，請依照下列步驟請求核發。 +- 前者の場合: **「自分自身のアクセストークンを手動発行する」** に進む +- 後者の場合: **「アプリケーション利用者にアクセストークンの発行をリクエストする」** に進む + +### 自分自身のアクセストークンを手動発行する + +Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 + +:::danger + +アクセストークンは他人に知られないようにしてください。 + +::: + +### アプリケーション利用者にアクセストークンの発行をリクエストする + +アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。 :::tip -下面描述的方法稱為 MiAuth，它無需創建應用程式即可立即發行存取權杖。 +以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 -[還有一種獲取存取權杖的方法是使用應用程式建立方法（舊方法）。](./app) +[アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app) ::: -#### 步驟1 +#### Step 1 -產生 UUID。從現在起，這將被稱為**工作階段ID**。 +UUIDを生成する。以後これを**セッションID**と呼びます。 :::danger -此工作階段 ID 應每次生成，不應重複使用。 + +このセッションIDは毎回生成し、使いまわさないようにしてください。 + ::: -#### 步驟2 +#### Step 2 -在使用者瀏覽器中顯示應用程式授權表單。授權表格可透過以下格式的網址開啟： +アプリケーション認証フォームをユーザーのブラウザで表示させる。認証フォームは、以下の形式のURLで開くことができます: ``` -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 ``` -需要變更的部份 +ここで、 -- 將 `{host}` 替換為使用者伺服器的主機。主機通常由使用者輸入。 -- 將 `{session}` 替換為工作階段 ID。 +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 +- `{session}`の部分は、セッションIDに置き換えます。 -您也可以在網址中設定多個選項作為查詢參數： +使用者授予應用程式存取權限後，向下列格式的網址傳送 POST 請求，將傳回一個包含存取權杖的 JSON 作為回應。 -| 名稱 | 說明 | -| ------------ | ------------------------------------------------------------------- | -| `name` | 應用程式名稱。 | -| `icon` | 應用程式的圖標圖像網址。 | -| `callback` | 驗證後重導向的網址。
重導向時，工作階段 ID 會附加到查詢參數 `session`。 | -| `permission` | 應用程式所需的權限。
列舉所請求的授權，以半形逗號 `,` 分隔。可以在[此處](./permission.md)查看權限清單。 | +| 名前 | 説明 | +| ------------ | ----------------------------------------------------------------------------- | +| `name` | アプリケーション名。 | +| `icon` | アプリケーションのアイコン画像URL。 | +| `callback` | 認証が終わった後にリダイレクトするURL。
リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 | +| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](./permission.md)で確認できます。 | :::tip{label='例'} @@ -72,40 +78,40 @@ https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callba ::: -#### 步驟3 +#### Step 3 -使用者授予應用程式存取權限後，向下列格式的網址傳送 POST 請求，將傳回一個包含存取權杖的 JSON 作為回應。 +ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 ``` https://{host}/api/miauth/{session}/check ``` -需要變更的部份 - -- 將 `{host}` 替換為使用者伺服器的主機。 -- 將 `{session}` 替換為工作階段 ID。 - -回應中包含的屬性有： - -| 名稱 | 說明 | -| ------- | --------- | -| `token` | 使用者的存取權杖。 | -| `user` | 使用者資料。 | - -## 使用API - -取得存取權杖後，就可以透過向各種端點發出請求來使用API。 - -:::tip +ここで、 - 所有 HTTP API 均為 POST，請求和回應均為 JSON 格式（drive/files/create 除外）。 - 在請求標頭中指定 `Content-Type: application/json`。 -- 存取權杖包含在請求內文 JSON 中，參數名為 `i`。 -- 基礎網址是 `https://{伺服器網域}/api`。 + +レスポンスに含まれるプロパティは以下の通りです: + +| 名前 | 説明 | +| ------- | -------------- | +| `token` | ユーザーのアクセストークン。 | +| `user` | ユーザーの情報。 | + +## APIの利用 + +アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。 + +:::tip + +- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。 +- 要求ヘッダーに`Content-Type: application/json`を指定します。 +- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。 +- ベースURLは`https://{サーバーのドメイン}/api`です。 ::: -帶有存取權杖（中介資訊）的正文範例： +アクセストークン付きのボディの例（metaの場合）: ```json { @@ -116,10 +122,12 @@ https://{host}/api/miauth/{session}/check -有關 API 的更多資訊，請參閱 API 參考。 +APIの詳細は、APIリファレンスを参照してください。 :::warning -Misskey 不使用 REST。 + +MisskeyはRESTを採用していません。 + ::: -此外，Misskey 不僅提供 HTTP API，還提供資料流 API。有關資料流 API 的詳細資訊，請參閱[此文件](./streaming/index.md)。 +また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.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..95a8a605 100644 --- a/content/tw/docs/5.releases.md +++ b/content/tw/docs/5.releases.md @@ -6,11 +6,52 @@ maxTocDepth: 2 Misskey 的版本資訊被發布在此。 +## 2023.12.2 + +### 一般 + +- 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 +65,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 +75,11 @@ Misskey 的版本資訊被發布在此。 - Enhance: アイコンデコレーションを複数設定できるように - Enhance: アイコンデコレーションの位置を微調整できるように - Enhance: つながりの公開範囲をフォロー/フォロワーで個別に設定可能に #12072 -- Enhance: 在地化更新 +- Enhance: ローカリゼーションの更新 - Enhance: 依賴關係更新 - Fix: MFM `$[unixtime ]` に不正な値を入力した際に発生する各種エラーを修正 -### 客戶端 +### Client - Feat: 今日誕生日のフォロー中のユーザーを一覧表示できるウィジェットを追加 - Feat: 画面に雪を降らせられるように @@ -94,7 +135,7 @@ Misskey 的版本資訊被發布在此。 - Fix: ページ一覧ページの表示がモバイル環境において崩れているのを修正 - Fix: MFMでルビの中のテキストがnyaizeされない問題を修正 -### 伺服器 +### Server - Enhance: MFM `$[ruby ]` が他ソフトウェアと連合されるように - Enhance: Meilisearchを有効にした検索で、ユーザーのミュートやブロックを考慮するように diff --git a/locales/zh-CN.yml b/locales/zh-CN.yml index 41185840..51ba6ced 100644 --- a/locales/zh-CN.yml +++ b/locales/zh-CN.yml @@ -1,19 +1,19 @@ -noScript: "現在Javascriptが無効になっています。サイトの表示にはJavascriptが必須となりますので有効にしてください。" +noScript: "JavaScript 目前处于禁用状态。必须启用 JavaScript 才能浏览网站。" learnMore: "詳しく知る" -loading: "読み込み中…" -clickToExpand: "（クリックして展開）" -copy: "コピー" -share: "共有する" +loading: "加载中…" +clickToExpand: "（点击以展开）" +copy: "复制" +share: "分享" note: "ノート" -other: "その他" +other: "其他" add: "追加" goToLegacyHub: "従来のMisskey Hub" _error: - notFound: "ページが見つかりませんでした" - notFoundDesc: "お探しのページは見つかりませんでした。URLをお確かめください。" - generalError: "エラーが発生しました" + notFound: "找不到页面" + notFoundDesc: "找不到您要查找的页面，请检查 URL。" + generalError: "发生了错误" generalErrorDesc: "これが意図した操作でない場合は、以下から不具合報告をお願いします。" - reportProblem: "問題を報告する" + reportProblem: "报告问题" goToTop: "トップページにもどる" _seo: siteName: "Misskey Hub" @@ -21,11 +21,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 +91,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 +135,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 +154,9 @@ _docs: next: "次へ" _toc: title: "このページの内容" - toPageTop: "ページ上部に戻る" + toPageTop: "回到顶部" _blog: - title: "ブログ" + title: "博客" description: "Misskey開発本部から、Misskeyに関する最新情報やTips等をお届けします！（日本語のみ）" back: "戻る" _content: @@ -179,7 +179,7 @@ _brandAssets: _links: title: "リンク" _github: - title: "Github" + title: "GitHub" description: "Misskeyの開発はGithub上で行われています。機能リクエストやバグ報告などはこちらから行えます。" _crowdin: title: "Crowdin" @@ -242,13 +242,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サイトからのおすすめ"