161sh/jointrashposs
1
0
Fork 0
mirror of https://iceshrimp.dev/Crimekillz/jointrashposs.git synced 2024-11-24 17:59:07 +01:00
Code Issues Packages Projects Releases Wiki Activity

New Crowdin updates (#98)

Browse Source 
* New translations thread-mute.md (Chinese Simplified)

* New translations webhook.md (Chinese Simplified)

* New translations 1.troubleshooting.md (Chinese Simplified)

* New translations donate.md (Chinese Simplified)

* New translations misskey-hub.md (Chinese Simplified)

* New translations announcement.md (Chinese Simplified)

* New translations role.md (Chinese Simplified)

* New translations 1.index.md (Chinese Simplified)

* New translations bash.md (Chinese Simplified)

* New translations docker.md (Chinese Simplified)

* New translations kubernetes.md (Chinese Simplified)

* New translations manual.md (Chinese Simplified)

* New translations ubuntu-manual.md (Chinese Simplified)

* New translations cdn.md (Chinese Simplified)

* New translations disable-timelines.md (Chinese Simplified)

* New translations 1.index.md (Chinese Simplified)

* New translations permission.md (Chinese Simplified)

* New translations 1.index.md (Chinese Simplified)

* New translations 2.miauth.md (Chinese Simplified)

* New translations 5.releases.md (Chinese Simplified)

* New translations 1.index.md (Chinese Simplified)

* New translations 3.oauth.md (Chinese Simplified)

* New translations ja-jp.yml (Chinese Traditional)

* New translations 1.about-misskey.md (Chinese Traditional)

* New translations 2.get-started.md (Chinese Traditional)

* New translations 3.join-server.md (Chinese Traditional)

* New translations 4.things-to-know.md (Chinese Traditional)

* New translations ads.md (Chinese Traditional)

* New translations drive.md (Chinese Traditional)

* New translations mfm.md (Chinese Traditional)

* New translations mute-and-block.md (Chinese Traditional)

* New translations pages.md (Chinese Traditional)

* New translations poll.md (Chinese Traditional)

* New translations share-form.md (Chinese Traditional)

* New translations thread-mute.md (Chinese Traditional)

* New translations webhook.md (Chinese Traditional)

* New translations 1.troubleshooting.md (Chinese Traditional)

* New translations donate.md (Chinese Traditional)

* New translations misskey-hub.md (Chinese Traditional)

* New translations announcement.md (Chinese Traditional)

* New translations role.md (Chinese Traditional)

* New translations 1.index.md (Chinese Traditional)

* New translations bash.md (Chinese Traditional)

* New translations docker.md (Chinese Traditional)

* New translations kubernetes.md (Chinese Traditional)

* New translations manual.md (Chinese Traditional)

* New translations ubuntu-manual.md (Chinese Traditional)

* New translations cdn.md (Chinese Traditional)

* New translations disable-timelines.md (Chinese Traditional)

* New translations 1.index.md (Chinese Traditional)

* New translations permission.md (Chinese Traditional)

* New translations 1.index.md (Chinese Traditional)

* New translations 2.miauth.md (Chinese Traditional)

* New translations publish-on-your-website.md (Chinese Traditional)

* New translations 5.releases.md (Chinese Traditional)

* New translations 1.index.md (Chinese Traditional)

* New translations 3.oauth.md (Chinese Traditional)

* New translations 1.about-misskey.md (English)

* New translations 2.get-started.md (English)

* New translations 3.join-server.md (English)

* New translations 4.things-to-know.md (English)

* New translations ads.md (English)

* New translations drive.md (English)

* New translations mfm.md (English)

* New translations mute-and-block.md (English)

* New translations pages.md (English)

* New translations poll.md (English)

* New translations share-form.md (English)

* New translations thread-mute.md (English)

* New translations webhook.md (English)

* New translations 1.troubleshooting.md (English)

* New translations donate.md (English)

* New translations misskey-hub.md (English)

* New translations announcement.md (English)

* New translations role.md (English)

* New translations 1.index.md (English)

* New translations bash.md (English)

* New translations docker.md (English)

* New translations kubernetes.md (English)

* New translations manual.md (English)

* New translations ubuntu-manual.md (English)

* New translations cdn.md (English)

* New translations disable-timelines.md (English)

* New translations 1.index.md (English)

* New translations permission.md (English)

* New translations 1.index.md (English)

* New translations 2.miauth.md (English)

* New translations 5.releases.md (English)

* New translations 1.index.md (English)

* New translations 3.oauth.md (English)

* New translations 1.about-misskey.md (Indonesian)

* New translations 2.get-started.md (Indonesian)

* New translations 3.join-server.md (Indonesian)

* New translations 4.things-to-know.md (Indonesian)

* New translations ads.md (Indonesian)

* New translations drive.md (Indonesian)

* New translations mfm.md (Indonesian)

* New translations mute-and-block.md (Indonesian)

* New translations pages.md (Indonesian)

* New translations poll.md (Indonesian)

* New translations share-form.md (Indonesian)

* New translations thread-mute.md (Indonesian)

* New translations webhook.md (Indonesian)

* New translations 1.troubleshooting.md (Indonesian)

* New translations donate.md (Indonesian)

* New translations misskey-hub.md (Indonesian)

* New translations announcement.md (Indonesian)

* New translations role.md (Indonesian)

* New translations 1.index.md (Indonesian)

* New translations bash.md (Indonesian)

* New translations docker.md (Indonesian)

* New translations kubernetes.md (Indonesian)

* New translations manual.md (Indonesian)

* New translations ubuntu-manual.md (Indonesian)

* New translations cdn.md (Indonesian)

* New translations disable-timelines.md (Indonesian)

* New translations 1.index.md (Indonesian)

* New translations permission.md (Indonesian)

* New translations 1.index.md (Indonesian)

* New translations 2.miauth.md (Indonesian)

* New translations 5.releases.md (Indonesian)

* New translations 1.index.md (Indonesian)

* New translations 3.oauth.md (Indonesian)

* New translations 5.releases.md (Korean)

* New translations ja-jp.yml (English)

* New translations docker.md (English)

* New translations ja-jp.yml (Indonesian)

* New translations 5.releases.md (Korean)

* New translations ja-jp.yml (Indonesian)

* New translations 1.about-misskey.md (Indonesian)

* New translations 1.index.md (Indonesian)

* New translations ads.md (Indonesian)

* New translations antenna.md (Indonesian)

* New translations charts.md (Indonesian)

* New translations clip.md (Indonesian)

* New translations custom-emoji.md (Indonesian)

* New translations deck.md (Indonesian)

* New translations drive.md (Indonesian)

* New translations favorite.md (Indonesian)

* New translations follow.md (Indonesian)

* New translations hashtag.md (Indonesian)

* New translations mention.md (Indonesian)

* New translations mfm.md (Indonesian)

* New translations 1.index.md (Indonesian)

* New translations announcement.md (Indonesian)

* New translations bash.md (Indonesian)

* New translations ja-jp.yml (Indonesian)

* New translations mute-and-block.md (Indonesian)

* New translations pages.md (Indonesian)

* New translations apps.md (Indonesian)

* New translations donate.md (Indonesian)

* New translations bash.md (Indonesian)

* New translations docker.md (Indonesian)

* New translations manual.md (Indonesian)

* New translations 1.about-misskey.md (Chinese Traditional)

* New translations 1.about-misskey.md (Chinese Traditional)

* New translations create-plugin.md (French)

* New translations create-plugin.md (Italian)

* New translations create-plugin.md (Polish)

* New translations create-plugin.md (Chinese Simplified)

* New translations create-plugin.md (Chinese Traditional)

* New translations create-plugin.md (Indonesian)

* New translations aiscript.md (French)

* New translations aiscript.md (Italian)

* New translations aiscript.md (Korean)

* New translations aiscript.md (Polish)

* New translations aiscript.md (Chinese Simplified)

* New translations aiscript.md (Chinese Traditional)

* New translations aiscript.md (English)

* New translations aiscript.md (Indonesian)

* New translations ja-jp.yml (Chinese Traditional)

* New translations ja-jp.yml (Chinese Traditional)

* New translations troubleshooting.md (French)

* New translations libraries.md (French)

* New translations troubleshooting.md (Italian)

* New translations libraries.md (Italian)

* New translations troubleshooting.md (Korean)

* New translations libraries.md (Korean)

* New translations troubleshooting.md (Polish)

* New translations libraries.md (Polish)

* New translations troubleshooting.md (Chinese Simplified)

* New translations libraries.md (Chinese Simplified)

* New translations troubleshooting.md (Chinese Traditional)

* New translations libraries.md (Chinese Traditional)

* New translations troubleshooting.md (English)

* New translations libraries.md (English)

* New translations troubleshooting.md (Indonesian)

* New translations libraries.md (Indonesian)

* New translations ja-jp.yml (Chinese Traditional)

* New translations ja-jp.yml (French)

* New translations 2.miauth.md (French)

* New translations ja-jp.yml (Italian)

* New translations 2.miauth.md (Italian)

* New translations ja-jp.yml (Korean)

* New translations ja-jp.yml (Polish)

* New translations 2.miauth.md (Polish)

* New translations ja-jp.yml (Chinese Simplified)

* New translations 2.miauth.md (Chinese Simplified)

* New translations 2.miauth.md (Chinese Traditional)

* New translations ja-jp.yml (English)

* New translations 2.miauth.md (English)

* New translations ja-jp.yml (Indonesian)

* New translations 2.miauth.md (Indonesian)

* Revert "New translations 1.about-misskey.md (English)"

This reverts commit 2b9572c2cf.

* Revert "New translations 2.get-started.md (English)"

This reverts commit 2fa05a5aee.

* Revert "New translations 4.things-to-know.md (English)"

This reverts commit 698c5e980d.

* Revert "New translations ads.md (English)"

This reverts commit f0e1cd2965.

* Revert "New translations mfm.md (English)"

This reverts commit 51dcc0fc10.

* Revert "New translations webhook.md (English)"

This reverts commit cfbebc5783.

* Revert "New translations 1.index.md (English)"

This reverts commit 67d2bec45c.

* Revert "New translations disable-timelines.md (English)"

This reverts commit 19ead90df6.

* Revert "New translations webhook.md (French)"

This reverts commit 52e6a8429a.

* Revert "New translations webhook.md (Chinese Traditional)"

This reverts commit 395f0fbc4a.

* Revert "New translations webhook.md (Polish)"

This reverts commit ac4e2c534e.

* Revert "New translations webhook.md (Korean)"

This reverts commit 14853e1eab.

* Revert "New translations pages.md (Korean)"

This reverts commit f88e73d1ce.

* Revert "New translations bash.md (Korean)"

This reverts commit 60c9fae6a8.

* Revert "New translations kubernetes.md (Korean)"

This reverts commit 2239e8fd23.

* Revert "New translations ubuntu-manual.md (Korean)"

This reverts commit 3aab982625.

* Revert "New translations 1.about-misskey.md (Chinese Traditional)"

This reverts commit 5ac92102db.

* Revert "New translations 2.get-started.md (Chinese Traditional)"

This reverts commit d090253e34.

* Revert "New translations 3.join-server.md (Chinese Traditional)"

This reverts commit 634db4d49b.

* Revert "New translations 4.things-to-know.md (Chinese Traditional)"

This reverts commit 383ee08013.

* Revert "New translations ads.md (Chinese Traditional)"

This reverts commit 6ed3b6885f.

* Revert "New translations drive.md (Chinese Traditional)"

This reverts commit 988cacb17e.

* Revert "New translations mfm.md (Chinese Traditional)"

This reverts commit 6b53e36fc4.

* Revert "New translations mute-and-block.md (Chinese Traditional)"

This reverts commit 44b1b3c723.

* Revert "New translations pages.md (Chinese Traditional)"

This reverts commit 4e60747a55.

* Revert "New translations poll.md (Chinese Traditional)"

This reverts commit 00385dc6a1.

* Revert "New translations share-form.md (Chinese Traditional)"

This reverts commit 8858eaf2f7.

* Revert "New translations thread-mute.md (Chinese Traditional)"

This reverts commit d07bd70000.

* Revert "New translations 1.troubleshooting.md (Chinese Traditional)"

This reverts commit 7405a91ff9.

* fix

* New translations aiscript.md (Korean)

* New translations ja-jp.yml (Chinese Traditional)

* New translations troubleshooting.md (Korean)

* New translations ja-jp.yml (French)

* New translations ja-jp.yml (Italian)

* New translations ja-jp.yml (Korean)

* New translations ja-jp.yml (Polish)

* New translations ja-jp.yml (Chinese Simplified)

* New translations ja-jp.yml (English)

* New translations ja-jp.yml (Indonesian)

* New translations 5.releases.md (Korean)

* fix

* fix

* fix

* fix
This commit is contained in:
かっこかり 2024-01-23 13:18:36 +09:00 committed by GitHub
parent 574ab894b8
commit 811461f235
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
346 changed files with 6921 additions and 1401 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
content/blog/2021-12-01-inside-misskey-hub.md
View File

@ -6,7 +6,9 @@ description: 'Misskey Advent Calendar 2021 1日目の記事です。Misskey Hub
# インサイド Misskey Hub # インサイド Misskey Hub
:::tip :::tip
この記事は、[Misskey Advent Calendar 2021](https://adventar.org/calendars/6273) 1日目の記事です。 この記事は、[Misskey Advent Calendar 2021](https://adventar.org/calendars/6273) 1日目の記事です。
::: :::
こんにちはsyuiloです。いつもMisskeyを利用してくださってありがとうございます。開発の励みになります！ こんにちはsyuiloです。いつもMisskeyを利用してくださってありがとうございます。開発の励みになります！
@ -29,7 +31,9 @@ Misskey Hubの実装について理解するためには、いくつかの前提
## 静的サイト is 何 ## 静的サイト is 何
:::warning :::warning
**性的サイト**と誤変換しやすいので注意 **性的サイト**と誤変換しやすいので注意
::: :::
こういった記事がメインのWebサイトは、一般的にはWordpressなどのソフトウェアを使って管理することが多いですが、Misskey Hubはそうではありません。\ こういった記事がメインのWebサイトは、一般的にはWordpressなどのソフトウェアを使って管理することが多いですが、Misskey Hubはそうではありません。\
@ -42,9 +46,11 @@ Misskey Hubは、Misskey Hub内のMisskey Hub説明ページにもあるよう
静的なサイトは逆に、そういったリッチなことは行わず、**予め用意したコンテンツをどのユーザーに対しても同じように表示するだけのサイト**です。Misskey Hubは(サイト更新を除けば)誰がいつ見ても同じ内容なので、静的サイトです。 静的なサイトは逆に、そういったリッチなことは行わず、**予め用意したコンテンツをどのユーザーに対しても同じように表示するだけのサイト**です。Misskey Hubは(サイト更新を除けば)誰がいつ見ても同じ内容なので、静的サイトです。
:::tip :::tip
技術的な話になりますが、静的と言っても、静的なのは「サーバーから」送られてくる内容だけであって、JavaScriptを使ってブラウザ上で動的にページの内容を変えることは可能です。 技術的な話になりますが、静的と言っても、静的なのは「サーバーから」送られてくる内容だけであって、JavaScriptを使ってブラウザ上で動的にページの内容を変えることは可能です。
例えばMisskey Hubでは、サイドバーに表示されるMisskeyや藍ちゃんの広告はページを訪れるたびにランダムで変わるようになっています。\ 例えばMisskey Hubでは、サイドバーに表示されるMisskeyや藍ちゃんの広告はページを訪れるたびにランダムで変わるようになっています。\
さらに言うと、静的サイト内に別の動的サイトを埋め込んで表示することも可能です。これを利用して、将来的にはそのページに対するMisskeyのコメントタイムラインをページに表示する、といったことも実装されるかもしれません。 さらに言うと、静的サイト内に別の動的サイトを埋め込んで表示することも可能です。これを利用して、将来的にはそのページに対するMisskeyのコメントタイムラインをページに表示する、といったことも実装されるかもしれません。
::: :::
### 静的サイトだと何が嬉しいのか ### 静的サイトだと何が嬉しいのか
@ -64,6 +70,7 @@ Misskey Hubは、Misskey Hub内のMisskey Hub説明ページにもあるよう
動的サイトを運営する際に発生するそのような諸々の心配から解放されるというのは非常に大きなメリットです。つまり、金銭面においても精神面においても、**ゼロコスト**でMisskey Hubを運用できます。 動的サイトを運営する際に発生するそのような諸々の心配から解放されるというのは非常に大きなメリットです。つまり、金銭面においても精神面においても、**ゼロコスト**でMisskey Hubを運用できます。
:::g-details{summary="さらに技術的な話(危険)"} :::g-details{summary="さらに技術的な話(危険)"}
ここまで言っておいてなんですが、先ほど言った ここまで言っておいてなんですが、先ほど言った
> もちろんMisskeyは動的サイトということになります。 > もちろんMisskeyは動的サイトということになります。
@ -80,6 +87,7 @@ MisskeyのWebサーバーは、その不変なJavaScriptを送り返すだけで
実際、インスタンスサーバーがトラブルなどで落ちていても、クライアントにはアクセスすることができますし、テーマの設定などサーバーに依存しない操作は普通に行うことができます。 実際、インスタンスサーバーがトラブルなどで落ちていても、クライアントにはアクセスすることができますし、テーマの設定などサーバーに依存しない操作は普通に行うことができます。
ちなみに、こういう構成のことをIT界では**サーバーレス**と呼んだりするっぽいです。知らんけど。 ちなみに、こういう構成のことをIT界では**サーバーレス**と呼んだりするっぽいです。知らんけど。
::: :::
## SSG is 何 ## SSG is 何
@ -122,7 +130,9 @@ Misskey Hubもプラグイン機能を使っていて、「関連するページ
さらに、MFMを実際に書いて試せるプレイグラウンド機能や、APIリファレンスにおけるAPIコンソールなども今後実装予定です。 さらに、MFMを実際に書いて試せるプレイグラウンド機能や、APIリファレンスにおけるAPIコンソールなども今後実装予定です。
:::tip :::tip
「関連するページ」「最近更新されたページ」は我ながら便利機能だと思っているので、Misskey Hub以外のvuepressを採用したサイトでも使えるようにnpmで一般公開しようかとも考えています。 「関連するページ」「最近更新されたページ」は我ながら便利機能だと思っているので、Misskey Hub以外のvuepressを採用したサイトでも使えるようにnpmで一般公開しようかとも考えています。
::: :::
### 多言語対応(i18n) ### 多言語対応(i18n)
@ -150,15 +160,21 @@ vuepress標準の機能で、右上にあるやつです。各ページの見出
各ページはMarkdown(MFMみたいなもの(いや本来はMFMが「Markdownのようなもの」という立ち位置だけれども))というマークアップ言語で書かれています。Markdownを使うことで、簡単に見出し、リンク、画像、表といった要素を表現できるほか、 各ページはMarkdown(MFMみたいなもの(いや本来はMFMが「Markdownのようなもの」という立ち位置だけれども))というマークアップ言語で書かれています。Markdownを使うことで、簡単に見出し、リンク、画像、表といった要素を表現できるほか、
:::tip :::tip
こんな こんな
::: :::
:::warning :::warning
感じの 感じの
::: :::
:::danger :::danger
メッセージ メッセージ
::: :::
を表示したりできます。(厳密にはMarkdownの拡張構文) を表示したりできます。(厳密にはMarkdownの拡張構文)
@ -187,7 +203,9 @@ Misskey Hub内のMisskey Hub説明ページにもあるように、Misskey Hub
各インスタンス紹介は、インスタンス側で用意されたプロフィールレンダリングページをiframeというHTMLの機能で埋め込んで表示するようになっています。したがって、一度Misskey Hubにインスタンスを登録してしまえば、インスタンスの名前、説明、バナー画像といった情報を更新した場合でもリアルタイムでインスタンス一覧に反映されます。 各インスタンス紹介は、インスタンス側で用意されたプロフィールレンダリングページをiframeというHTMLの機能で埋め込んで表示するようになっています。したがって、一度Misskey Hubにインスタンスを登録してしまえば、インスタンスの名前、説明、バナー画像といった情報を更新した場合でもリアルタイムでインスタンス一覧に反映されます。
:::tip :::tip
インスタンス一覧へ掲載するインスタンスを募集しています。お気軽にご連絡ください🤗 インスタンス一覧へ掲載するインスタンスを募集しています。お気軽にご連絡ください🤗
::: :::
## 管理 ## 管理
@ -207,7 +225,9 @@ Misskey Hubにおいては、GitHub ActionsというGitHubの機能を利用し
GitHub Pagesは前述した「静的サイトを提供してくれる機能」です。GitHubのインフラストラクチャ上で動くため、いちどデプロイしてしまえば、あとは何の心配もなくMisskey Hubが提供され続けます。 GitHub Pagesは前述した「静的サイトを提供してくれる機能」です。GitHubのインフラストラクチャ上で動くため、いちどデプロイしてしまえば、あとは何の心配もなくMisskey Hubが提供され続けます。
:::warning :::warning
「何の心配もなく」はちょっと言い過ぎたかもしれません。というのも、(強いていうと)ひとつだけ心配があって、それはドメインです。Misskey Hubはmisskey-hub.netというドメインで提供されていますが、これは私が用意したものです。そのため、もし万が一私がドメインの更新を忘れるとMisskey Hubに繋がらなくなりますが、そこは𝑇𝑟𝑢𝑠𝑡 𝑚𝑒 「何の心配もなく」はちょっと言い過ぎたかもしれません。というのも、(強いていうと)ひとつだけ心配があって、それはドメインです。Misskey Hubはmisskey-hub.netというドメインで提供されていますが、これは私が用意したものです。そのため、もし万が一私がドメインの更新を忘れるとMisskey Hubに繋がらなくなりますが、そこは𝑇𝑟𝑢𝑠𝑡 𝑚𝑒
::: :::
通常のWebサイトであれば、サーバーにFTPでファイルをアップロードしたり、サーバーにSSHで繋いでファイルをダウンロードしてきたりといった作業が必要になりますが、GitHub Pagesではそのような手間すら要りません。 通常のWebサイトであれば、サーバーにFTPでファイルをアップロードしたり、サーバーにSSHで繋いでファイルをダウンロードしてきたりといった作業が必要になりますが、GitHub Pagesではそのような手間すら要りません。
@ -230,7 +250,9 @@ SSGはMisskey Hubのようなドキュメントサイトだけでなく、ブロ
静的サイトはいいぞ。vuepressはいいぞ。Misskey Hubに幸あれ🙏 静的サイトはいいぞ。vuepressはいいぞ。Misskey Hubに幸あれ🙏
:::g-details{summary="Webで記事を公開する際に必ず記述しなければならないと法令で定められている言葉"} :::g-details{summary="Webで記事を公開する際に必ず記述しなければならないと法令で定められている言葉"}
> いかがでしたか？ > いかがでしたか？
::: :::
--- ---
@ -248,5 +270,7 @@ SSGはMisskey Hubのようなドキュメントサイトだけでなく、ブロ
栄養があるし、加熱不要で調理も楽(ハサミで切って味噌に突っ込んでチンするだけで味噌汁できる) 栄養があるし、加熱不要で調理も楽(ハサミで切って味噌に突っ込んでチンするだけで味噌汁できる)
:::danger :::danger
ただし加熱しないと風味が強すぎ、ちょっとしたワサビ食べてるみたいになるので多少訓練が必要 ただし加熱しないと風味が強すぎ、ちょっとしたワサビ食べてるみたいになるので多少訓練が必要
::: :::

4
content/blog/2023-02-08-contribute-to-earn.md
View File

@ -10,18 +10,22 @@ We offer campaigns you to recieve rewards for contributing to the development of
<https://misskey.io/notes/9auj9aj1ww> <https://misskey.io/notes/9auj9aj1ww>
:::tip :::tip
条件や報奨金の額は、予告なく変更になる場合があります。 条件や報奨金の額は、予告なく変更になる場合があります。
Conditions and reward amounts are subject to change without notice. Conditions and reward amounts are subject to change without notice.
これ以外にも貢献に応じて不定期に給付金を支給中 これ以外にも貢献に応じて不定期に給付金を支給中
In addition to those, benefits are being paid at irregular intervals based on contributions. In addition to those, benefits are being paid at irregular intervals based on contributions.
::: :::
:::warning :::warning
報奨金の原資はパトロンの皆様からの寄付で成り立っています。 報奨金の原資はパトロンの皆様からの寄付で成り立っています。
Rewards come from donations from patrons. Rewards come from donations from patrons.
[**→ 寄付について / About Donations**](../docs/donate.html) [**→ 寄付について / About Donations**](../docs/donate.html)
::: :::
## カバレッジ上げ / Increase Coverage ## カバレッジ上げ / Increase Coverage

4
content/blog/2023-12-01-2023recap.md
View File

@ -6,7 +6,9 @@ date: 2023-12-01
# Misskey 2023 recap # Misskey 2023 recap
:::tip :::tip
これは[Misskey Advent Calendar 2023](https://adventar.org/calendars/8742)一日目の記事です。 これは[Misskey Advent Calendar 2023](https://adventar.org/calendars/8742)一日目の記事です。
::: :::
こんにちは、しゅいろです。2023年も残すところあと1ヶ月となりました。 こんにちは、しゅいろです。2023年も残すところあと1ヶ月となりました。
@ -329,7 +331,9 @@ https://xn--931a.moe/
そして来年もMisskeyを発展させていきますので何卒よろしくお願いいたします！！ そして来年もMisskeyを発展させていきますので何卒よろしくお願いいたします！！
:::tip :::tip
Misskeyの今のコードネーム(v13~)は「nasubi」です。今年の初め、コードネームは今後野菜で統一していこうと思い、一番手は「一富士二鷹三茄子」とも言われ縁起の良い🍆を選びました。そして言葉通り縁起の良い年になりました。 Misskeyの今のコードネーム(v13~)は「nasubi」です。今年の初め、コードネームは今後野菜で統一していこうと思い、一番手は「一富士二鷹三茄子」とも言われ縁起の良い🍆を選びました。そして言葉通り縁起の良い年になりました。
::: :::
それでは(ちょっと早いですが)、Merry Christmas and Happy New Year! それでは(ちょっと早いですが)、Merry Christmas and Happy New Year!

15
content/blog/2023-12-03-inside-misskey-hub-next.md
View File

@ -6,7 +6,9 @@ date: 2023-12-03
# インサイド Misskey Hub Next # インサイド Misskey Hub Next
:::tip :::tip
この記事は、[Misskey Alt Advent Calendar 2023](https://adventar.org/calendars/8658) 3日目の記事です。 この記事は、[Misskey Alt Advent Calendar 2023](https://adventar.org/calendars/8658) 3日目の記事です。
::: :::
![](/img/og/misskey-hub-screenshot-d.png) ![](/img/og/misskey-hub-screenshot-d.png)
@ -22,7 +24,9 @@ date: 2023-12-03
しかし、もともとのMisskey Hubの計画上、ドキュメント以外のページもかなり必要になるということで、ドキュメント生成に特化したフレームワークではなく、より拡張性が高く、汎用的な[Nuxt](https://nuxt.com/)をフレームワークとして採用しました。 しかし、もともとのMisskey Hubの計画上、ドキュメント以外のページもかなり必要になるということで、ドキュメント生成に特化したフレームワークではなく、より拡張性が高く、汎用的な[Nuxt](https://nuxt.com/)をフレームワークとして採用しました。
:::warning :::warning
VuePressよりは、今はどちらかというと[VitePress](https://vitepress.dev/)のほうがメジャーな感じがします。 VuePressよりは、今はどちらかというと[VitePress](https://vitepress.dev/)のほうがメジャーな感じがします。
::: :::
:::g-details{summary="詳しい技術スタックはこちら"} :::g-details{summary="詳しい技術スタックはこちら"}
@ -60,7 +64,9 @@ VuePressよりは、今はどちらかというと[VitePress](https://vitepress.
そして、今回のMisskey Hub Nextでは、ドキュメントページとブログページに**ISR**を、それ以外のページに**SSG**を適用しています。略称多くてこんがらがりそう。 そして、今回のMisskey Hub Nextでは、ドキュメントページとブログページに**ISR**を、それ以外のページに**SSG**を適用しています。略称多くてこんがらがりそう。
:::tip :::tip
プロジェクト名に`Next`と入っているのでReactフレームワークの[Next.js](https://nextjs.org/)のほうを思い浮かべたかもしれませんが、**罠です。** Nuxtで作ってあります。 プロジェクト名に`Next`と入っているのでReactフレームワークの[Next.js](https://nextjs.org/)のほうを思い浮かべたかもしれませんが、**罠です。** Nuxtで作ってあります。
::: :::
## ISRとは？ ## ISRとは？
@ -127,6 +133,7 @@ Misskeyをより多くの人に広めるために、ぜひご協力お願いし
::: :::
:::g-details{summary="【マニアック】フォントのはなし"} :::g-details{summary="【マニアック】フォントのはなし"}
Misskey Hub Nextでは、フォントの改善も行いました。 Misskey Hub Nextでは、フォントの改善も行いました。
現行のMisskey Hubで使われているフォント（Kosugi Maru）は、英字が歪で、英単語や英文になると読みにくくなっていました。また、日本語の漢字部分が中国語とバッティングして不自然に見えてしまうという問題もありました。 現行のMisskey Hubで使われているフォント（Kosugi Maru）は、英字が歪で、英単語や英文になると読みにくくなっていました。また、日本語の漢字部分が中国語とバッティングして不自然に見えてしまうという問題もありました。
@ -168,7 +175,9 @@ Misskeyの[サーバー一覧](/servers/)を、[Misskeyをはじめよう(joinmi
これにより、基本的には**サーバーを追加するのに特別な作業や申請は必要なくなり、新しく見つかったサーバーは自動的に追加されるようになりました！** これにより、基本的には**サーバーを追加するのに特別な作業や申請は必要なくなり、新しく見つかったサーバーは自動的に追加されるようになりました！**
:::tip :::tip
なので近日中にjoinmisskeyはMisskey Hubに統合されるかも…？ なので近日中にjoinmisskeyはMisskey Hubに統合されるかも…？
::: :::
### 【新機能】ツール集 ### 【新機能】ツール集
@ -185,7 +194,9 @@ Misskey関連のさまざまな便利ツールを提供するページ「[ツー
をご利用いただけますが、今後も随時拡充していく予定です💪 をご利用いただけますが、今後も随時拡充していく予定です💪
:::tip :::tip
[MFMお試しコーナー](/tools/mfm-playground/)の再現精度は割と高いのでMFMアートづくりにもおすすめです [MFMお試しコーナー](/tools/mfm-playground/)の再現精度は割と高いのでMFMアートづくりにもおすすめです
::: :::
### 【新機能】AiScriptに対応 ### 【新機能】AiScriptに対応
@ -205,12 +216,14 @@ for (let i, 100) {
:::fukidashi{chara="doya_ai" charaName="藍"} :::fukidashi{chara="doya_ai" charaName="藍"}
Misskey Hub Nextでは、わたし・藍も色々なところにいます！ Misskey Hub Nextでは、わたし・藍も色々なところにいます！
ほら、こんなところにも！ ほら、こんなところにも！
![](https://media.misskeyusercontent.com/io/7f980e50-bbd8-4527-b9f7-f6f97564956a.png) ![](https://media.misskeyusercontent.com/io/7f980e50-bbd8-4527-b9f7-f6f97564956a.png)
ほかにも色々なところに隠れているので、ぜひ探してみてくださいね♪ ほかにも色々なところに隠れているので、ぜひ探してみてくださいね♪
::: :::
さらに、<ruby>古<rt>いにしえ</rt></ruby>のミスキストや、現行Misskey Hubのヘビーユーザーしか知らないであろう、知る人ぞ知る機能・**藍モード**も移植しました！ さらに、<ruby>古<rt>いにしえ</rt></ruby>のミスキストや、現行Misskey Hubのヘビーユーザーしか知らないであろう、知る人ぞ知る機能・**藍モード**も移植しました！
@ -231,7 +244,9 @@ Misskey Hub Nextでは、わたし・藍も色々なところにいます！
こちらは、現在[株式会社MisskeyHQ (村上さん)](https://misskey.io/notes/9l0i92bvr1)と連携しながら、ドキュメントの拡充に取り組んでいます。もう少しお待ち下さい🙏 こちらは、現在[株式会社MisskeyHQ (村上さん)](https://misskey.io/notes/9l0i92bvr1)と連携しながら、ドキュメントの拡充に取り組んでいます。もう少しお待ち下さい🙏
:::tip :::tip
ドキュメントの拡充にご協力いただける方は、[こちら](https://misskey.io/notes/9l0i92bvr1)をご覧のうえ、ぜひご参加ください！ ドキュメントの拡充にご協力いただける方は、[こちら](https://misskey.io/notes/9l0i92bvr1)をご覧のうえ、ぜひご参加ください！
::: :::
### シェアボタン中継機能 ### シェアボタン中継機能

8
content/blog/2023-12-19-mac202319.md
View File

@ -5,7 +5,9 @@ date: 2023-12-19
# Deep dive on the linkage between Misskey and Vue.js # Deep dive on the linkage between Misskey and Vue.js
:::tip :::tip
これは&emsp14;[Misskey Advent Calendar 2023](https://adventar.org/calendars/8742)&emsp14;19&emsp14;日目の記事です. これは&emsp14;[Misskey Advent Calendar 2023](https://adventar.org/calendars/8742)&emsp14;19&emsp14;日目の記事です.
::: :::
こんにちは,&ensp;コアチームメンバーの&emsp14;[acid-chicken](https://github.com/acid-chicken)&emsp14;です.&ensp;Misskey&emsp14;の開発には&emsp14;nighthike v4&emsp14;あたりから参加しており,&ensp;現在は本業の傍ら,&ensp;余暇にリファクタリングやコードレビューなどをやっていることが多いです. こんにちは,&ensp;コアチームメンバーの&emsp14;[acid-chicken](https://github.com/acid-chicken)&emsp14;です.&ensp;Misskey&emsp14;の開発には&emsp14;nighthike v4&emsp14;あたりから参加しており,&ensp;現在は本業の傍ら,&ensp;余暇にリファクタリングやコードレビューなどをやっていることが多いです.
@ -13,7 +15,9 @@ date: 2023-12-19
Misskey&emsp14;では&emsp14;[2018&emsp14;年からフロントエンドの&emsp14;UI&emsp14;フレームワークに&emsp14;Vue.js&emsp14;を採用し](https://github.com/misskey-dev/misskey/pull/1116)ており,&ensp;メジャーアップデートのマイグレーションなどを経て,&ensp;現在も継続して使用しています.&ensp;今回は,&ensp;Misskey&emsp14;のフロントエンド構造について,&ensp;Vue.js&emsp14;の機能との接点を中心に深掘りしていきます. Misskey&emsp14;では&emsp14;[2018&emsp14;年からフロントエンドの&emsp14;UI&emsp14;フレームワークに&emsp14;Vue.js&emsp14;を採用し](https://github.com/misskey-dev/misskey/pull/1116)ており,&ensp;メジャーアップデートのマイグレーションなどを経て,&ensp;現在も継続して使用しています.&ensp;今回は,&ensp;Misskey&emsp14;のフロントエンド構造について,&ensp;Vue.js&emsp14;の機能との接点を中心に深掘りしていきます.
:::tip :::tip
大まかな解説は既に&emsp14;syuilo&emsp14;連載[「Misskey & Webテクノロジー最前線」9月](/blog/2023-09-11-gihyo)などで触れられています.&ensp;一方で,&ensp;本記事では連載で触れないような,&ensp;細かい部分に焦点を絞った話題を扱うため,&ensp;もしかすると読んでいてつまらない内容になっているかもしれません.&ensp;予めご了承ください. 大まかな解説は既に&emsp14;syuilo&emsp14;連載[「Misskey & Webテクノロジー最前線」9月](/blog/2023-09-11-gihyo)などで触れられています.&ensp;一方で,&ensp;本記事では連載で触れないような,&ensp;細かい部分に焦点を絞った話題を扱うため,&ensp;もしかすると読んでいてつまらない内容になっているかもしれません.&ensp;予めご了承ください.
::: :::
## Misskey&emsp14;のフロントエンド構造 ## Misskey&emsp14;のフロントエンド構造
@ -112,9 +116,11 @@ Misskey&emsp14;と&emsp14;Vue.js&emsp14;に話を戻すと,&ensp;SFC&emsp14;に
Misskey&emsp14;が&emsp14;CSS&emsp14;モジュールを使うようになった後のある日,&ensp;syuilo&emsp14;は言いました. Misskey&emsp14;が&emsp14;CSS&emsp14;モジュールを使うようになった後のある日,&ensp;syuilo&emsp14;は言いました.
:::fukidashi{chara="syuilo" charaName="しゅいろ"} :::fukidashi{chara="syuilo" charaName="しゅいろ"}
えー、CSS Modulesってminifyしてくれにゃいんだ えー、CSS Modulesってminifyしてくれにゃいんだ
![](https://s3.arkjp.net/misskey/1b008643-4932-40d8-980b-fe3da75db856.png) ![](https://s3.arkjp.net/misskey/1b008643-4932-40d8-980b-fe3da75db856.png)
::: :::
&mdash; https://misskey.io/notes/9fd9w06qah &mdash; https://misskey.io/notes/9fd9w06qah
@ -199,7 +205,9 @@ HelloWorld.__cssModules = {
このようなことになってしまうのは,&ensp;バインドの参照を常に静的に置換できるとは限らないためです.&ensp;例えば,&ensp;<code>$style.redColoredText</code>&emsp14;のような参照は静的に置換できても,&ensp;<code>$style\[color + "ColoredText"\]</code>&emsp14;のような参照はビルド時に&emsp14;<code>color</code>&emsp14;の値が定まるとは保証できないので,&ensp;静的に置換できません.&ensp;また,&ensp;Vue.js&emsp14;の&emsp14;Composition API&emsp14;では,&ensp;<code>useCssModule()</code>&emsp14;を呼び出すことで,&ensp;バインド用のマップ全体を取得することを許容しています.&ensp;このような経緯で,&emsp14;成果物にマップがそのまま含まれているのです.&ensp;逆に,&ensp;それらの機能を一切使わないのであれば,&ensp;完全にそれらは無駄になっているといえます.&ensp;完全に無駄なものは安全に除去できるはずです.&ensp;そこで,&ensp;Misskey&emsp14;では,&ensp;<code>$style</code>&emsp14;配下を識別子のメンバーアクセスによる参照のみを認めるルールで運用することを前提に,&ensp;静的置換を行う&emsp14;Rollup&emsp14;プラグインを開発および使用することで,&ensp;成果物からマップを除去するようにしました.&ensp;これにより,&ensp;バンドルサイズの&emsp14;3%&emsp14;程度の削減につながりました. このようなことになってしまうのは,&ensp;バインドの参照を常に静的に置換できるとは限らないためです.&ensp;例えば,&ensp;<code>$style.redColoredText</code>&emsp14;のような参照は静的に置換できても,&ensp;<code>$style\[color + "ColoredText"\]</code>&emsp14;のような参照はビルド時に&emsp14;<code>color</code>&emsp14;の値が定まるとは保証できないので,&ensp;静的に置換できません.&ensp;また,&ensp;Vue.js&emsp14;の&emsp14;Composition API&emsp14;では,&ensp;<code>useCssModule()</code>&emsp14;を呼び出すことで,&ensp;バインド用のマップ全体を取得することを許容しています.&ensp;このような経緯で,&emsp14;成果物にマップがそのまま含まれているのです.&ensp;逆に,&ensp;それらの機能を一切使わないのであれば,&ensp;完全にそれらは無駄になっているといえます.&ensp;完全に無駄なものは安全に除去できるはずです.&ensp;そこで,&ensp;Misskey&emsp14;では,&ensp;<code>$style</code>&emsp14;配下を識別子のメンバーアクセスによる参照のみを認めるルールで運用することを前提に,&ensp;静的置換を行う&emsp14;Rollup&emsp14;プラグインを開発および使用することで,&ensp;成果物からマップを除去するようにしました.&ensp;これにより,&ensp;バンドルサイズの&emsp14;3%&emsp14;程度の削減につながりました.
:::tip :::tip
詳細は&emsp14;[#10923](https://github.com/misskey-dev/misskey/issues/10923)&emsp14;を参照してください. 詳細は&emsp14;[#10923](https://github.com/misskey-dev/misskey/issues/10923)&emsp14;を参照してください.
::: :::
## 今後の展望 ## 今後の展望

7
content/cn/docs/1.about-misskey.md
View File

@ -15,7 +15,9 @@ Misskeyはオープンソースの分散型マイクロブログプラットフ
当初は分散型ではありませんでしたが、2018年にActivityPubを実装し分散型になったことで、より多くの方に認知され利用されるサービスになり、現在に至ります。 当初は分散型ではありませんでしたが、2018年にActivityPubを実装し分散型になったことで、より多くの方に認知され利用されるサービスになり、現在に至ります。
:::tip :::tip
Misskeyという名前は、syuiloが当時聴いていたMay'nというアーティストの楽曲、Brain Diverの歌詞に由来します。 Misskeyという名前は、syuiloが当時聴いていたMay'nというアーティストの楽曲、Brain Diverの歌詞に由来します。
::: :::
誰でも開発に参加することができ、現在でも活発に開発が続いています。 誰でも開発に参加することができ、現在でも活発に開発が続いています。
@ -35,7 +37,9 @@ Misskeyのすべてのソースコードは[AGPL](https://github.com/misskey-dev
再び引き合いに出しますが、TwitterやFacebookなどの利益を得ているほとんどのサービスはオープンソースではありません。 再び引き合いに出しますが、TwitterやFacebookなどの利益を得ているほとんどのサービスはオープンソースではありません。
:::tip :::tip
技術的に言うと、MisskeyのソースコードはGitで管理されていて、リポジトリは[GitHub上でホスティングされています。](https://github.com/misskey-dev) 技術的に言うと、MisskeyのソースコードはGitで管理されていて、リポジトリは[GitHub上でホスティングされています。](https://github.com/misskey-dev)
::: :::
## 開発に参加する、プロジェクトを支援する ## 開発に参加する、プロジェクトを支援する
@ -143,8 +147,11 @@ Misskeyは開発が進むにつれ使用する技術も大きく変わってき
:::fukidashi{chara="doya_ai" charaName="藍"} :::fukidashi{chara="doya_ai" charaName="藍"}
わたしについては[このホームページ](https://xn--931a.moe/)をご覧ください！ わたしについては[このホームページ](https://xn--931a.moe/)をご覧ください！
::: :::
:::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"} :::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"}
Misskeyの守り神、藍ちゃんです。ｱｲﾁｬﾝｶﾜｲｲﾔｯﾀｰ! Misskeyの守り神、藍ちゃんです。ｱｲﾁｬﾝｶﾜｲｲﾔｯﾀｰ!
::: :::

5
content/cn/docs/2.for-users/2.onboarding/2.get-started.md
View File

@ -11,14 +11,17 @@ Misskeyを利用するには、どこかのサーバーにアカウントを作
[サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。 [サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。
:::tip :::tip
どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。
:::g-details{summary='詳細'} :::g-details{summary='詳細'}
Misskeyには連合機能が備わっています。 Misskeyには連合機能が備わっています。
連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。 連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。
Misskeyが搭載している連合機能はActivityPubというオープンな共通規格に基づいていて、MastodonやPleromaといったほかのソフトウェアとも互換性があります。 Misskeyが搭載している連合機能はActivityPubというオープンな共通規格に基づいていて、MastodonやPleromaといったほかのソフトウェアとも互換性があります。
::: :::
::: :::
@ -31,5 +34,7 @@ Misskeyが搭載している連合機能はActivityPubというオープンな
自分にあったテーマのサーバーを探すのもおすすめです。 自分にあったテーマのサーバーを探すのもおすすめです。
:::tip :::tip
サーバーの一覧は[こちら](/servers/)からご覧いただけます。 サーバーの一覧は[こちら](/servers/)からご覧いただけます。
::: :::

2
content/cn/docs/2.for-users/2.onboarding/3.join-server.md
View File

@ -3,9 +3,11 @@
登録するサーバーが決まったら、さっそくアカウントを作成しましょう。 登録するサーバーが決まったら、さっそくアカウントを作成しましょう。
:::tip :::tip
ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。
ただし、入力事項はサーバーによって異なることがあります。詳しくは、サーバー管理者にお問い合わせください。 ただし、入力事項はサーバーによって異なることがあります。詳しくは、サーバー管理者にお問い合わせください。
::: :::
## 登録する ## 登録する

4
content/cn/docs/2.for-users/2.onboarding/4.things-to-know.md
View File

@ -7,7 +7,9 @@
Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一般的なSNSに比べたくさんの機能がありますので、初めての投稿を行う前に必ず確認して、上手に投稿しましょう！ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一般的なSNSに比べたくさんの機能がありますので、初めての投稿を行う前に必ず確認して、上手に投稿しましょう！
:::tip :::tip
詳細は、「[ノート](/docs/for-users/features/note/)」をご覧ください。 詳細は、「[ノート](/docs/for-users/features/note/)」をご覧ください。
::: :::
## タイムライン ## タイムライン
@ -15,7 +17,9 @@ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一
Misskeyは、複数のタイムラインを持っています。名前だけでは少々わかりにくいかと思いますので、それぞれがどのような働きをするのかを知っておきましょう。 Misskeyは、複数のタイムラインを持っています。名前だけでは少々わかりにくいかと思いますので、それぞれがどのような働きをするのかを知っておきましょう。
:::tip :::tip
詳細は、「[タイムライン](/docs/for-users/features/timeline/)」をご覧ください。 詳細は、「[タイムライン](/docs/for-users/features/timeline/)」をご覧ください。
::: :::
## その他 ## その他

2
content/cn/docs/2.for-users/3.features/ads.md
View File

@ -4,7 +4,9 @@ Misskeyではサーバーによる広告をタイムラインなどに表示で
広告の右上に表示されるアイコンをクリックすることで、当該の広告の表示頻度を下げることができます。 広告の右上に表示されるアイコンをクリックすることで、当該の広告の表示頻度を下げることができます。
:::tip :::tip
広告の総数が少ない場合は、表示頻度を下げた後も連続で表示される可能性があります。 広告の総数が少ない場合は、表示頻度を下げた後も連続で表示される可能性があります。
::: :::
## 広告の設定(管理者) ## 広告の設定(管理者)

4
content/cn/docs/2.for-users/3.features/drive.md
View File

@ -3,7 +3,9 @@
ドライブは、Misskey上でファイルを管理できる機能です。 ドライブは、Misskey上でファイルを管理できる機能です。
:::tip :::tip
技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。 技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。
::: :::
Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。 Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。
@ -13,7 +15,9 @@ Misskey Webのドライブページから任意のファイルをアップロー
ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。 ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。
:::warning :::warning
現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。 現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。
::: :::
## センシティブ (NSFW) ## センシティブ (NSFW)

10
content/cn/docs/2.for-users/3.features/mfm.md
View File

@ -7,7 +7,9 @@ description: MFMは、Misskeyの様々な場所で使用できる専用のマー
MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。 MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。
:::tip :::tip
一部の構文はMarkdownやHTMLと互換性があります。 一部の構文はMarkdownやHTMLと互換性があります。
::: :::
## MFMが使用可能な場所の例 ## MFMが使用可能な場所の例
@ -23,7 +25,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使
アットマーク + ユーザー名で、特定のユーザーを示すことができます。 アットマーク + ユーザー名で、特定のユーザーを示すことができます。
:::tip :::tip
メンションについての詳細は[こちら](./mention.md)を参照してください。 メンションについての詳細は[こちら](./mention.md)を参照してください。
::: :::
``` ```
@ -42,7 +46,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使
ナンバーサイン + タグで、ハッシュタグを示すことができます。 ナンバーサイン + タグで、ハッシュタグを示すことができます。
:::tip :::tip
ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。 ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。
::: :::
``` ```
@ -70,6 +76,7 @@ https://example.com
``` ```
:::tip :::tip
リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。 リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。
``` ```
@ -83,8 +90,11 @@ https://example.com
### カスタム絵文字 ### カスタム絵文字
コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。 コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。
:::tip :::tip
カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。 カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。
::: :::
``` ```

10
content/cn/docs/2.for-users/3.features/mute-and-block.md
View File

@ -5,11 +5,15 @@
ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。 ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。
:::tip :::tip
ミュートとブロックは併用できます。 ミュートとブロックは併用できます。
::: :::
:::warning :::warning
利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。 利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。
::: :::
Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。 Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。
@ -26,7 +30,9 @@ Misskey Webでは、設定>ミュートとブロック から、自分がミュ
Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。 Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。
:::tip :::tip
ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。 ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。
::: :::
## ブロック ## ブロック
@ -48,9 +54,13 @@ Misskey Webでユーザーをミュートするには、対象のユーザーの
Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。 Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。
:::warning :::warning
ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。 ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。
::: :::
:::warning :::warning
相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。 相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。
::: :::

2
content/cn/docs/2.for-users/3.features/pages.md
View File

@ -3,7 +3,9 @@
Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。 Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。
:::warning :::warning
v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。 v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。
::: :::
## ページ設定 ## ページ設定

4
content/cn/docs/2.for-users/3.features/poll.md
View File

@ -13,7 +13,9 @@
追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。 追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。
:::warning :::warning
いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。 いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。
::: :::
## 複数回答を可能にする ## 複数回答を可能にする
@ -41,7 +43,9 @@
未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。 未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。
:::tip :::tip
未投票アンケートには、結果を表示した状態でも投票できます。 未投票アンケートには、結果を表示した状態でも投票できます。
::: :::
投票をすると、自分の投票した選択肢に✔がつきます。 投票をすると、自分の投票した選択肢に✔がつきます。

4
content/cn/docs/2.for-users/3.features/share-form.md
View File

@ -7,7 +7,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく
## クエリパラメータ ## クエリパラメータ
:::tip :::tip
すべてのパラメータは**オプション**であり、必須ではありません。 すべてのパラメータは**オプション**であり、必須ではありません。
::: :::
| 名前 | 説明 | | 名前 | 説明 |
@ -46,7 +48,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく
| `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) | | `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) |
:::warning :::warning
`visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。 `visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。
::: :::
### 添付ファイル ### 添付ファイル

4
content/cn/docs/2.for-users/3.features/thread-mute.md
View File

@ -1,7 +1,9 @@
# スレッドミュート # スレッドミュート
:::tip :::tip
バージョン 12.95.0 以降の機能です。 バージョン 12.95.0 以降の機能です。
::: :::
スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。 スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。
@ -11,5 +13,7 @@
Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。 Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。
:::warning :::warning
スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。 スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。
::: :::

4
content/cn/docs/2.for-users/3.features/webhook.md
View File

@ -1,11 +1,15 @@
# Webhook # Webhook
:::tip :::tip
バージョン 12.109.0 以降の機能です。 バージョン 12.109.0 以降の機能です。
::: :::
:::warning :::warning
実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。 実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。
::: :::
MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。 MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。

4
content/cn/docs/2.for-users/4.resources/1.troubleshooting.md
View File

@ -5,7 +5,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ
# トラブルシューティング # トラブルシューティング
:::tip :::tip
[よくある質問](./faq.md)も合わせてお役立てください。 [よくある質問](./faq.md)も合わせてお役立てください。
::: :::
問題が発生したときは、まずこちらをご確認ください。 問題が発生したときは、まずこちらをご確認ください。
@ -59,7 +61,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ
クライアントの設定の「キャッシュをクリア」すると直ります。 クライアントの設定の「キャッシュをクリア」すると直ります。
:::warning :::warning
「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。 「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。
::: :::
## 通知やアンテナ等の点滅が消えない ## 通知やアンテナ等の点滅が消えない

7
content/cn/docs/2.for-users/4.resources/donate.md
View File

@ -13,20 +13,27 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は
- [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share)
:::tip :::tip
高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。
::: :::
:::tip :::tip
額に応じて以下の返礼を用意しています。 額に応じて以下の返礼を用意しています。
- 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与
- 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載 - 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載
- 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載 - 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載
::: :::
:::warning :::warning
**バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。** **バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。**
(メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります) (メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります)
::: :::
また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。 また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。

2
content/cn/docs/2.for-users/4.resources/misskey-hub.md
View File

@ -6,7 +6,9 @@ Misskey Hubは、Misskeyに関するナレッジなどのドキュメント、
Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub) Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub)
:::tip :::tip
Misskey HubはNuxtを使ってビルドされた静的サイトです。 Misskey HubはNuxtを使ってビルドされた静的サイトです。
::: :::
## Misskey Hubに貢献する ## Misskey Hubに貢献する

2
content/cn/docs/3.for-admin/features/announcement.md
View File

@ -5,11 +5,13 @@
お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。 お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。
:::warning :::warning
アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。 アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。
- 「既存ユーザーのみ」オプションを有効にしてお知らせを作成する - 「既存ユーザーのみ」オプションを有効にしてお知らせを作成する
- 「非通知」オプションを有効にしてお知らせを作成する - 「非通知」オプションを有効にしてお知らせを作成する
- 終了したお知らせはアーカイブする - 終了したお知らせはアーカイブする
::: :::
## 表示形式 ## 表示形式

8
content/cn/docs/3.for-admin/features/role.md
View File

@ -21,10 +21,12 @@
- **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール)
:::warning :::warning
コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。
- 手動でのアサイン/アサイン解除は行えません。 - 手動でのアサイン/アサイン解除は行えません。
- 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。 - 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。
::: :::
## 権限 ## 権限
@ -53,6 +55,7 @@
**優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。**
:::tip :::tip
例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、
- 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。
@ -62,6 +65,7 @@
- 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。
- ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。
::: :::
### ベースロールの値を使用 ### ベースロールの値を使用
@ -85,11 +89,15 @@
アサインする際にアサインされる期間を設定することが可能です。 アサインする際にアサインされる期間を設定することが可能です。
:::tip :::tip
ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。 ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。
::: :::
:::warning :::warning
コンディショナル ロールには手動でのアサインはできません。 コンディショナル ロールには手動でのアサインはできません。
::: :::
## ユーザーのポリシーの確認 ## ユーザーのポリシーの確認

4
content/cn/docs/3.for-admin/install/guides/1.index.md
View File

@ -7,15 +7,19 @@ description: Misskeyサーバーの作成方法についての案内です。
Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。 Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
::: :::
:::warning :::warning
自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。
Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。 Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。
詳しくは [misskey-dev/misskey #9791](https://github.com/misskey-dev/misskey/issues/9791) をご覧ください。 詳しくは [misskey-dev/misskey #9791](https://github.com/misskey-dev/misskey/issues/9791) をご覧ください。
::: :::
## Xserver VPSでインストール ## Xserver VPSでインストール

2
content/cn/docs/3.for-admin/install/guides/bash.md
View File

@ -20,7 +20,9 @@ Misskeyを簡単にインストールするためのシェルスクリプトが
3. Cloudflareアカウント（推奨） 3. Cloudflareアカウント（推奨）
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
::: :::
Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。 Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。

5
content/cn/docs/3.for-admin/install/guides/docker.md
View File

@ -7,12 +7,15 @@ description: このガイドはDockerを使ったMisskeyセットアップ方法
このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。 このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
::: :::
:::tip{label='前提条件'} :::tip{label='前提条件'}
- DockerおよびDocker Composeがインストールされていること。 - DockerおよびDocker Composeがインストールされていること。
::: :::
## リポジトリの取得 ## リポジトリの取得
@ -59,7 +62,9 @@ GLHF✨
## Misskeyのアップデート方法 ## Misskeyのアップデート方法
:::warning :::warning
アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。
::: :::
```sh ```sh

2
content/cn/docs/3.for-admin/install/guides/kubernetes.md
View File

@ -3,7 +3,9 @@
このガイドでは、Kubernetes と HelmChartを使用したMisskeyセットアップ方法について説明します。 このガイドでは、Kubernetes と HelmChartを使用したMisskeyセットアップ方法について説明します。
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
::: :::
## TrueCharts と TrueNAS Scale ## TrueCharts と TrueNAS Scale

10
content/cn/docs/3.for-admin/install/guides/manual.md
View File

@ -7,7 +7,9 @@ description: このガイドではMisskeyのインストール・セットアッ
このガイドではMisskeyのインストール・セットアップ方法について解説します。 このガイドではMisskeyのインストール・セットアップ方法について解説します。
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！
::: :::
:::tip{label='前提条件'} :::tip{label='前提条件'}
@ -108,7 +110,9 @@ WantedBy=multi-user.target
``` ```
:::warning :::warning
CentOSで1024以下のポートを使用してMisskeyを使用する場合は`ExecStart=/usr/bin/sudo /usr/bin/npm start`に変更する必要があります。 CentOSで1024以下のポートを使用してMisskeyを使用する場合は`ExecStart=/usr/bin/sudo /usr/bin/npm start`に変更する必要があります。
::: :::
systemdを再読み込みしmisskeyサービスを有効化 systemdを再読み込みしmisskeyサービスを有効化
@ -125,7 +129,9 @@ sudo systemctl start misskey
``` ```
:::tip :::tip
`systemctl status misskey`と入力すると、サービスの状態を調べることができます。 `systemctl status misskey`と入力すると、サービスの状態を調べることができます。
::: :::
:::: ::::
@ -133,7 +139,9 @@ sudo systemctl start misskey
## Misskeyのアップデート方法 ## Misskeyのアップデート方法
:::warning :::warning
アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。
::: :::
masterをpullし直し、インストール、ビルド、データベースのマイグレーションを行います: masterをpullし直し、インストール、ビルド、データベースのマイグレーションを行います:
@ -156,8 +164,10 @@ sudo systemctl restart misskey
``` ```
:::tip :::tip
ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください:
- `pnpm run clean`または`pnpm run clean-all` - `pnpm run clean`または`pnpm run clean-all`
- `pnpm rebuild` - `pnpm rebuild`
::: :::

22
content/cn/docs/3.for-admin/install/guides/ubuntu-manual.md
View File

@ -11,11 +11,15 @@
[**シェルスクリプトの詳細と使用方法はこちらから！**](./bash/) [**シェルスクリプトの詳細と使用方法はこちらから！**](./bash/)
:::tip :::tip
シェルスクリプトでの開発環境へのインストールは想定されていません。 シェルスクリプトでの開発環境へのインストールは想定されていません。
::: :::
:::tip :::tip
ドメインの購入とCloudflareのセットアップ、サーバーの確保についてはご自身でご準備ください。 ドメインの購入とCloudflareのセットアップ、サーバーの確保についてはご自身でご準備ください。
::: :::
不具合があれば[ @aqz@p1.a9z.dev へのメンション](https://p1.a9z.dev/@aqz)にてお知らせいただければと思います。 不具合があれば[ @aqz@p1.a9z.dev へのメンション](https://p1.a9z.dev/@aqz)にてお知らせいただければと思います。
@ -27,7 +31,9 @@
[docker-compose](./docker/)なら、手作業でももうちょっと簡単に実行できるはずです。 [docker-compose](./docker/)なら、手作業でももうちょっと簡単に実行できるはずです。
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
::: :::
## はじめに ## はじめに
@ -52,7 +58,9 @@ OSの違い、Misskey本体や依存するソフトウェアのバージョン
- ここではドメインをexample.tldとして解説を進めるので、自分が買ったドメインに適宜置き換えて読むこと。開発環境の場合はlocalhostと読み替えます（設定ファイルの項で別途説明） - ここではドメインをexample.tldとして解説を進めるので、自分が買ったドメインに適宜置き換えて読むこと。開発環境の場合はlocalhostと読み替えます（設定ファイルの項で別途説明）
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！
::: :::
## nanoの使い方 ## nanoの使い方
@ -78,7 +86,9 @@ sudo adduser --disabled-password --disabled-login misskey
``` ```
:::tip :::tip
開発環境の場合はユーザーを分ける必要はありません 開発環境の場合はユーザーを分ける必要はありません
::: :::
## 基本的なソフトウェアのインストールと設定 ## 基本的なソフトウェアのインストールと設定
@ -177,7 +187,9 @@ activeならOK。
nginxは、主としてリバースプロキシに用いられるWebサーバーソフトである。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。 nginxは、主としてリバースプロキシに用いられるWebサーバーソフトである。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。
:::tip :::tip
開発環境の場合はnginxのセットアップは不要です 開発環境の場合はnginxのセットアップは不要です
::: :::
nginx.orgのドキュメント http\://nginx.org/en/linux_packages.html#Ubuntu に従ってインストールする。 nginx.orgのドキュメント http\://nginx.org/en/linux_packages.html#Ubuntu に従ってインストールする。
@ -238,7 +250,9 @@ sudo apt install -y git build-essential
サーバーをインターネットに公開する準備をする。 サーバーをインターネットに公開する準備をする。
:::tip :::tip
開発環境の場合はファイヤーウォールやCloudFlare、Certbotの設定は不要です 開発環境の場合はファイヤーウォールやCloudFlare、Certbotの設定は不要です
::: :::
### ファイヤーウォール ### ファイヤーウォール
@ -272,7 +286,9 @@ sudo systemctl enable ufw
``` ```
:::tip :::tip
ufwは、netfilter(iptables)を人間が操作しやすいようにするアプリだ。インストールスクリプトは、OCI環境ではnetfilterを直接操作する。 ufwは、netfilter(iptables)を人間が操作しやすいようにするアプリだ。インストールスクリプトは、OCI環境ではnetfilterを直接操作する。
::: :::
### CloudFlare ### CloudFlare
@ -376,7 +392,9 @@ nano .config/default.yml
設定できる値と記述方法は[.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)に書かれている。 設定できる値と記述方法は[.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)に書かれている。
:::tip :::tip
開発環境の場合、urlは`url: http://localhost:3000`と指定します。 開発環境の場合、urlは`url: http://localhost:3000`と指定します。
::: :::
```yml ```yml
@ -469,7 +487,9 @@ NODE_ENV=production pnpm run build
``` ```
:::tip :::tip
開発環境の場合、`NODE_ENV=production`は不要です。以降のコマンドでも同様に削除してください。 開発環境の場合、`NODE_ENV=production`は不要です。以降のコマンドでも同様に削除してください。
::: :::
### サーバーでビルドできない場合 ### サーバーでビルドできない場合
@ -515,7 +535,9 @@ CloudFlareのDNS設定が正しいIPアドレスになっているかもう一
## Misskeyのデーモンを作成 ## Misskeyのデーモンを作成
:::tip :::tip
開発環境の場合、デーモンの作成は不要です。 開発環境の場合、デーモンの作成は不要です。
::: :::
いったんCtrl+Cでプロセスをキルし、Misskeyをデーモンで起動する設定をしよう。 いったんCtrl+Cでプロセスをキルし、Misskeyをデーモンで起動する設定をしよう。

2
content/cn/docs/3.for-admin/install/resources/cdn.md
View File

@ -17,5 +17,7 @@ CDNで以下の設定を行なってください。
- `/api/*`以外のリクエストをすべてキャッシュする - `/api/*`以外のリクエストをすべてキャッシュする
:::tip :::tip
Misskeyをアップデートした際にキャッシュのクリアは不要です。 Misskeyをアップデートした際にキャッシュのクリアは不要です。
::: :::

4
content/cn/docs/3.for-admin/install/resources/troubleshooting.md
View File

@ -248,6 +248,10 @@ Amazon S3に互換性のあるオブジェクトストレージであれば利
各サービス/ソフトウェアのドキュメントをよく読み、設定してみてください。 各サービス/ソフトウェアのドキュメントをよく読み、設定してみてください。
### ローディングが終わらない
Cloudflare を使用している場合は、Rocket LoaderやAuto Minifyが有効になっていないか確認してください。有効になっている場合は無効にすることで解決する場合があります。
*** ***
# まったく解決しなかった場合 # まったく解決しなかった場合

2
content/cn/docs/3.for-admin/moderation-tips/disable-timelines.md
View File

@ -8,7 +8,9 @@ LTLやSTLは、そのサーバー全員の投稿が見れるため、新規の
もしデメリットの方が上回っていると感じたら、それらのタイムラインを無効化することも検討してください。 もしデメリットの方が上回っていると感じたら、それらのタイムラインを無効化することも検討してください。
:::warning :::warning
無効化を行うと、ユーザーが困惑し、短期的に見て利用者が減る可能性があります。そのため、無効化の際は影響を慎重に検討し、事前に説明してフォローを整える期間を一定程度設けることを推奨します。 無効化を行うと、ユーザーが困惑し、短期的に見て利用者が減る可能性があります。そのため、無効化の際は影響を慎重に検討し、事前に説明してフォローを整える期間を一定程度設けることを推奨します。
::: :::
なお、管理者/モデレーターは、これらのタイムラインの無効化状態は適用されず、引き続き利用することが可能です。 なお、管理者/モデレーターは、これらのタイムラインの無効化状態は適用されず、引き続き利用することが可能です。

67
content/cn/docs/4.for-developers/aiscript.md Normal file
View File

@ -0,0 +1,67 @@
# AiScript
AiScriptは、Misskeyの以下の箇所で使用できるスクリプト言語です。
- [プラグイン](./plugin/)
- [ウィジェット](/docs/for-users/features/widgets/)
- ボタン
- AiScriptコンソール
- AiScript App
- Misskey Play
- スクラッチパッド
:::tip
AiScriptの実装はMisskeyとは別リポジトリで、[オープンソースで公開されています](https://github.com/aiscript-dev/aiscript)。
:::
## 使い方
AiScript標準の構文や組み込み関数などが使用できます。
:::tip
ドキュメントは[こちら](https://github.com/aiscript-dev/aiscript/tree/master/docs)\
Misskey本体のバージョンにより、使用できるAiScriptのバージョンが異なる場合があります。バージョンの確認には`<: Core:v`をScratchpadなどで実行してください。
:::
これらに加え、Misskey専用の組み込み定数・関数が３グループに分けて提供されています。
### Misskey AiScript API
接頭辞: `Mk:`\
Misskey内の全てのAiScript環境で使用できる定関数群です。
詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Mk:`とついた部分を参照して下さい。
### プラグインAPI
接頭辞: `Plugin:`\
[プラグイン](./plugin/)でのみ使用できる定関数群です。
詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Plugin:`とついた部分を参照して下さい。
### UI API
接頭辞: `Ui:`\
[ウィジェット](/docs/for-users/features/widgets/)（AiScript App）、Misskey Play、Scratchpadで使用できます。
ドキュメントは未整備（TODO）ですが、インターネット上に有志の方が執筆された解説記事があります。
### 標準入出力
AiScript標準で定義されている`readline`関数と`print`関数（および`<:`構文）の内部実装は、Misskey側で独自に提供されています。
#### readline(message)
`message`: `str`\
返り値: `str`\
Misskey内の全てのAiScript環境で使用できます。\
文字列の入力を求めるポップアップを表示します。
#### print(message)
`message`: `any`\
返り値: `null`\
[ウィジェット](/docs/for-users/features/widgets/)（AiScriptコンソール）、Scratchpadで使用できます。\
コンソールに文字列を出力します。\
`<:`構文も同様の働きをします。

4
content/cn/docs/4.for-developers/api/1.index.md
View File

@ -8,7 +8,9 @@ MisskeyはAPIを公開しています。APIを使ってMisskeyクライアント
ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。 ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。
:::tip :::tip
Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\
Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\\
::: :::
<MkIndex /> <MkIndex />

2
content/cn/docs/4.for-developers/api/libraries.md
View File

@ -15,6 +15,8 @@ description: Misskey APIに関連するライブラリの一覧
## Python ## Python
- [Misskey.py](https://github.com/YuzuRyo61/Misskey.py) - [Misskey.py](https://github.com/YuzuRyo61/Misskey.py)
- [MiPA](https://github.com/yupix/MiPA)
- [MiPAC](https://github.com/yupix/MiPAC)
## .Net ## .Net

2
content/cn/docs/4.for-developers/api/permission.md
View File

@ -5,7 +5,9 @@ description: アプリケーションが要求する権限の一覧
# 権限の一覧 # 権限の一覧
:::tip :::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)から自動生成しているため、ドキュメントや翻訳が不完全な場合があります。
::: :::
<ApiPermissions></ApiPermissions> <ApiPermissions></ApiPermissions>

8
content/cn/docs/4.for-developers/api/streaming/1.index.md
View File

@ -5,7 +5,9 @@ description: ストリーミングAPIを使うと、リアルタイムで様々
# ストリーミングAPI # ストリーミングAPI
:::tip :::tip
最初に[Misskey API](../index.md)のドキュメントを読むことをお勧めします。 最初に[Misskey API](../index.md)のドキュメントを読むことをお勧めします。
::: :::
ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、リアクションされた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。 ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、リアクションされた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。
@ -26,7 +28,9 @@ wss://{host}/streaming?i={token}
- `{token}`の部分は、ユーザーのアクセストークンに置き換えます。 - `{token}`の部分は、ユーザーのアクセストークンに置き換えます。
:::tip :::tip
アクセストークンは省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。 アクセストークンは省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。
::: :::
ストリームに接続すると、後述投稿の購読を行ったりすることができますが、まだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。 ストリームに接続すると、後述投稿の購読を行ったりすることができますが、まだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。
@ -40,7 +44,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり
ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。 ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。
:::tip :::tip
ひとつのストリーム接続上で、同時に複数のチャンネルに接続することができます。 ひとつのストリーム接続上で、同時に複数のチャンネルに接続することができます。
::: :::
以下では、チャンネルの使用方法を説明します。どのようなチャンネルがあるかは、[チャンネル一覧](./channel/index.md)を参照してください。 以下では、チャンネルの使用方法を説明します。どのようなチャンネルがあるかは、[チャンネル一覧](./channel/index.md)を参照してください。
@ -69,7 +75,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり
- `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。 - `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。
:::tip :::tip
IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。 IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。
::: :::
### チャンネルからのメッセージを受け取る ### チャンネルからのメッセージを受け取る

9
content/cn/docs/4.for-developers/api/token.md
View File

@ -7,7 +7,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた**
アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。
:::tip :::tip
ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。
::: :::
あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。
@ -20,7 +22,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた**
Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。
:::danger :::danger
アクセストークンは他人に知られないようにしてください。 アクセストークンは他人に知られないようにしてください。
::: :::
### アプリケーション利用者にアクセストークンの発行をリクエストする ### アプリケーション利用者にアクセストークンの発行をリクエストする
@ -32,6 +36,7 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行
以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。
[アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app) [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app)
::: :::
#### Step 1 #### Step 1
@ -39,7 +44,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行
UUIDを生成する。以後これを**セッションID**と呼びます。 UUIDを生成する。以後これを**セッションID**と呼びます。
:::danger :::danger
このセッションIDは毎回生成し、使いまわさないようにしてください。 このセッションIDは毎回生成し、使いまわさないようにしてください。
::: :::
#### Step 2 #### Step 2
@ -119,7 +126,9 @@ https://{host}/api/miauth/{session}/check
APIの詳細は、APIリファレンスを参照してください。 APIの詳細は、APIリファレンスを参照してください。
:::warning :::warning
MisskeyはRESTを採用していません。 MisskeyはRESTを採用していません。
::: :::
また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。

88
content/cn/docs/4.for-developers/api/token/1.index.md Normal file
View File

@ -0,0 +1,88 @@
# アクセストークンの取得
APIを使い始めるには、APIを利用するアカウントに紐づいた**アクセストークン**を取得する必要があります。
このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。
基本的に、APIはリクエストにはアクセストークンが必要となります。
アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。
:::tip
ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。
:::
あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。
- 前者の場合: **「自分自身のアクセストークンを手動発行する」** に進む
- 後者の場合: **「アプリケーション利用者にアクセストークンの発行をリクエストする」** に進む
## 自分自身のアクセストークンを手動発行する
Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。
:::danger
アクセストークンは他人に知られないようにしてください。
:::
## アプリケーション利用者にアクセストークンの発行をリクエストする
アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の方法の一つを使います。
:MkIndex
## APIの利用
アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。
:::tip
- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。
- 要求ヘッダーに`Content-Type: application/json`を指定します。
- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。
- ベースURLは`https://{サーバーのドメイン}/api`です。
:::
### Authorization headerを使う方式
以下のようにヘッダーの`Authorization`フィールドを指定します。
```js
fetch("https://misskey.io/api/notes/create", {
method: 'POST',
body: JSON.stringify({
text: "Hello Misskey API World with My Application!"
}),
headers: {
Authorization: `Bearer ${accessToken}`,
'Content-Type': 'application/json',
},
credentials: 'omit',
});
```
### iを使う方式
アクセストークン付きのボディの例（metaの場合）:
```json
{
"i": "HogEFugA1341",
"detail": false
}
```
<!--TODO:「APIリファレンス」をリンクに差し替え-->
APIの詳細は、APIリファレンスを参照してください。
:::warning
MisskeyはRESTを採用していません。
:::
また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](../streaming/)を参照してください。

76
content/cn/docs/4.for-developers/api/token/2.miauth.md Normal file
View File

@ -0,0 +1,76 @@
---
description: v12.27.0以降で使用できる、Misskey独自の簡素な認証方法について説明しています。
---
# MiAuth方式でのアクセストークン取得方式
アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。
:::tip
以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。
- [よりおおく使われているOAuth方式でのアクセストークン取得方法もあります。](./oauth.md)
- [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app.md)
:::
## Step 1
UUIDを生成する。以後これを**セッションID**と呼びます。
:::danger
このセッションIDは毎回生成し、使いまわさないようにしてください。
:::
## Step 2
アプリケーション認証フォームをユーザーのブラウザで表示させる。認証フォームは、以下の形式のURLで開くことができます:
```
https://{host}/miauth/{session}
```
ここで、
- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。
- `{session}`の部分は、セッションIDに置き換えます。
また、URLにクエリパラメータとしていくつかのオプションを設定できます:
| 名前 | 説明 |
| ------------ | ------------------------------------------------------------------------------ |
| `name` | アプリケーション名。 |
| `icon` | アプリケーションのアイコン画像URL。 |
| `callback` | 認証が終わった後にリダイレクトするURL。<br>リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 |
| `permission` | アプリケーションが要求する権限。<br>要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 |
:::tip{label='例'}
```
https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive
```
:::
## Step 3
ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。
```
https://{host}/api/miauth/{session}/check
```
ここで、
- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。
- `{session}`の部分は、セッションIDに置き換えます。
レスポンスに含まれるプロパティは以下の通りです:
| 名前 | 説明 |
| ------- | -------------- |
| `token` | ユーザーのアクセストークン。 |
| `user` | ユーザーの情報。 |

179
content/cn/docs/4.for-developers/api/token/3.oauth.md Normal file
View File

@ -0,0 +1,179 @@
---
description: v2023.9.0以降で使用できる、OAuth2.0方式での認証方法について説明しています。
---
# OAuth方式でのアクセストークン取得方式
アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。
:::tip
以下に説明する方法は、[OAuth 2.0](https://datatracker.ietf.org/doc/html/rfc6749.html)と呼ばれるものです。普通のOAuthはアプリを作成しますが、[IndieAuth](https://indieauth.spec.indieweb.org/)の拡張でアプリ作成なしで使えるようになっています。
OAuth方式は使えるライブラリが多いので、出来ればライブラリを使うのをおすすめします。
現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。
- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md)
- [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md)
:::
## Step 1
アプリ紹介のためのウェブページを作ります。ページがHTTPSアドレスでアクセスできるようにしてください。ページのとこかに以下のようなHTMLコードを書きます。
```html
<!-- （必須項目）hrefのアドレスが認証コードの転送先になります。 -->
<link rel='redirect_uri' href='/redirect'>
<!-- ユーザーに見せるアプリの名前になります。なかったらこのページのアドレスが名前になります。 -->
<div class='h-app'>
<a href="/" class="u-url p-name">My Misskey App</a>
</div>
```
あとで`redirect_uri`のアドレスに認証コードが転送されます。
## Step 2
PKCE `code_verifier`と`code_challenge`文字列, 及び`state`文字列を生成します。
- `code_verifier`の場合は最低43字、最高128字でアルファベット大・小文字及び`-._~`の中の文字に限られます。
- `code_challenge`文字列は`code_verifier`文字列をSHA256アルゴリズムでハッシュしてbase64urlでエンコードした結果を使います。
- `state`文字列には特別な制限はありません。ランダムな文字列を使います。
:::danger
この文字列は毎回生成し、使いまわさないようにしてください。
:::
:::tip
[pkce-challenge](https://www.npmjs.com/package/pkce-challenge)とかのライブラリを使ったり、OAuthライブラリのPKCE機能を使うのがおすすめです。
:::
:::tip{label='例'}
```js
import crypto from "node:crypto";
const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-._~";
const codeVerifier = new Array(128)
.fill(0)
.map(() => chars[Math.floor(chars.length * Math.random())])
.join("");
console.log('code_verifier', codeVerifier);
const codeChallenge = crypto
.createHash("sha256")
.update(codeVerifier, "ascii")
.digest("base64url");
console.log('code_challenge', codeChallenge);
const state = crypto.randomUUID();
console.log('state', state);
```
:::
## Step 3
相手サーバーのOAuth情報を取得します。データはJSON形式になっています。
```
https://{host}/.well-known/oauth-authorization-server
```
`{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。
ここでは`authorization_endpoint`と`token_endpoint`を使います。
:::tip
次のステップで使われる`scope`の情報も`scopes_supported`で確認できます。
:::
## Step 4
アプリケーション認証フォームをユーザーのブラウザで表示させます。認証フォームは、以下の形式のURLで開くことができます:
```
{authorization_endpoint}?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&scope={scope}&code_challenge={code_challenge}&code_challenge_method=S256&state={state}
```
ここで、
- `{authorization_endpoint}`の部分は、前の情報取得で得たアドレスに置き換えます。
- `{client_id}`の部分は、アプリの紹介ページのアドレスに置き換えます。
- `{code_challenge}`の部分は、前に生成した`code_challenge`文字列に置き換えます
- `code_challenge_method`の部分は常に`S256`にします。
- `{redirect_uri}`の部分は、紹介ページで使っている配達先のアドレスに置き換えます。
- `{scope}`の部分は、アプリケーションが要求する権限に置き換えます。要求する権限を` `で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。
- `{state}`の部分は、前に生成した`state`文字列に置き換えます。
:::tip{label='例'}
```
https://misskey.local/oauth/authorize?client_id=http%3A%2F%2Fexample.com&code_challenge=C6hwMO2bmIzg3nqppTE9b79fvuOjlrKmH2xNiZSMHzw&code_challenge_method=S256&response_type=code&redirect_uri=http%3A%2F%2Fexample.com%2Fredirect&scope=write%3Anotes&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab
```
:::
## Step 5
ユーザーがアプリケーションアクセスを許可したら、`redirect_uri`のアドレスに認証コードがURLパラメータの形式で転送されます。
| 名前 | 説明 |
| ------- | ----------------------- |
| `code` | ユーザーの認証コード。 |
| `state` | 認証リクエストに使われた`state`文字列。 |
:::tip{label='例'}
```
https://example.com/redirect?code=...&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab
```
:::
`state`文字列がちゃんと一致しているのか確認して、次のステップに進みます。
## Step 6
転送された認証コードを使ってアクセストークンをPOSTでリクエストします。リクエスト先は`token_endpoint`になります。データ形式は`application/json`と`application/x-www-form-urlencoded`を使えます。各パラメータは以下のようになります。
| 名前 | 説明 |
| --------------- | ------------------------------ |
| `grant_type` | 常に`authorization_code`にします。 |
| `client_id` | 認証リクエストに使われた`client_id`文字列。 |
| `redirect_uri` | 認証リクエストに使われた`redirect_uri`文字列。 |
| `scope` | 認証リクエストに使われた`scope`文字列。 |
| `code` | 取得した認証コード。　 |
| `code_verifier` | 前に生成した`code_verifier`文字列。 |
:::tip{label='例'}
```js
const res = await fetch(endpoint, {
method: "POST",
body: JSON.stringify({
grant_type: "authorization_code",
client_id: "https://example.com",
redirect_uri: "https://example.com/redirect",
scope: "write:notes",
code: "...",
code_verifier: "hjjbCYDmDpSLjirkO-PrfWKsRhDdJr-PAEGRClRwzUKlmFIIIrZNmSvUIraeIa~WqbqQnfbJV-Hc_IfuQkesBYUpukUi~lInDfU_AZjoZqbU.ioQTRzaFfZFfGnT-OAA",
}),
headers: {
"Content-Type": "application/json"
}
});
```
:::
レスポンスはJSONオブジェクト形式で、そこから`access_token`を取得して使います。

2
content/cn/docs/4.for-developers/plugin/create-plugin.md
View File

@ -74,4 +74,4 @@ Misskey Webはプラグインに対してAPIを公開していて、それらを
v2023.11.0以降では、あなたのウェブサイトからワンクリックでプラグインを直接インストールできるようになっています。 v2023.11.0以降では、あなたのウェブサイトからワンクリックでプラグインを直接インストールできるようになっています。
プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](./publish-on-your-website.md)をご覧ください。 プラグインのインストール機能を提供する場合は、あなたのサイト上にAPIを実装する必要があります。詳しくは[こちら](../publish-on-your-website.md)をご覧ください。

51
content/cn/docs/5.releases.md
View File

@ -6,6 +6,49 @@ maxTocDepth: 2
Misskeyのリリースノートを掲載しています。 Misskeyのリリースノートを掲載しています。
## 2023.12.2
リリース日: 2023/12/28
### General
- v2023.12.1でDockerを利用してサーバーを起動できない問題を修正
### Client
- Enhance: 検索画面においてEnterキー押下で検索できるように
## 2023.12.1
リリース日: 2023/12/27
### Note
- アクセストークンの権限が再整理されたため、一部のAPIが古いAPIトークンでは動作しなくなりました。\
権限不足になる場合には権限を再設定して再生成してください。
### General
- Enhance: ローカリゼーションの更新
- Fix: 自分のdirect noteがuser list timelineに追加されない
### Client
- Feat: AiScript専用のMFM構文`$[clickable.ev=EVENTNAME ...]`を追加。`Mk:C:mfm`のオプション`onClickEv`に関数を渡すと、クリック時に`EVENTNAME`を引数にして呼び出す
- Enhance: MFM入力補助ボタンを投稿フォームに表示できるように #12787
- Fix: 一部のモデログ(logYellowでの表示対象)について、表示の色が変わらない問題を修正
- Fix: `fg`/`bg`MFMに長い単語を指定すると、オーバーフローされずはみ出る問題を修正
### Server
- Enhance: センシティブワードの設定がハッシュタグトレンドにも適用されるようになりました
- Enhance: `oauth/token`エンドポイントのCORS対応
- Fix: 1702718871541-ffVisibility.jsのdownが壊れている
- Fix:「非センシティブのみ（リモートはいいねのみ）」を設定していても、センシティブに設定されたカスタム絵文字をリアクションできる問題を修正
- Fix: ロールアサイン時の通知で，ロールアイコンが縮小されずに表示される問題を修正
- Fix: サードパーティアプリケーションがWebsocket APIに無条件にアクセスできる問題を修正
- Fix: サードパーティアプリケーションがユーザーの許可なしに非公開の情報を見ることができる問題を修正
## 2023.12.0 ## 2023.12.0
リリース日: 2023/12/23 リリース日: 2023/12/23
@ -1957,7 +2000,9 @@ same as 12.112.0
### NOTE ### NOTE
:::warning :::warning
このバージョンからNode v16.14.0以降が必要です このバージョンからNode v16.14.0以降が必要です
::: :::
### Changes ### Changes
@ -2069,12 +2114,16 @@ same as 12.112.0
### Note ### Note
:::warning :::warning
ビルドする前に`npm run clean`を実行してください。 ビルドする前に`npm run clean`を実行してください。
::: :::
:::warning :::warning
このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。
マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。
::: :::
### Improvements ### Improvements
@ -2142,9 +2191,11 @@ same as 12.112.0
### NOTE ### NOTE
::: warning ::: warning
アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。 アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。
12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。 12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。
::: :::
### Changes ### Changes

9
content/en/docs/1.about-misskey.md
View File

@ -15,7 +15,9 @@ While Misskey started centered around Bulletin Boards as its main feature, the g
Misskey was not always a decentralized service, but became decentralized through the adoption of ActivityPub in 2018. Since then, it has become a service that is acknowledged and used by many. 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 :::tip
ℹ️ The name "Misskey" comes from a song called "Brain Diver" by a band that syuilo used to listen to at the time called May'n.
The name "Misskey" comes from a song called "Brain Diver" by a band that syuilo used to listen to at the time called May'n.
::: :::
With anyone being able to join its development, Misskey is still continually being actively developed. With anyone being able to join its development, Misskey is still continually being actively developed.
@ -35,7 +37,9 @@ For realizing the distributed nature of Misskey, this concept of open source is
Using the same example as before, most profit-oriented services like Twitter, Facebook etc. are not open source. Using the same example as before, most profit-oriented services like Twitter, Facebook etc. are not open source.
:::tip :::tip
Technically speaking, Misskey's source code is managed via Git, and the repository is hosted on [GitHub](https://github.com/misskey-dev) Technically speaking, Misskey's source code is managed via Git, and the repository is hosted on [GitHub](https://github.com/misskey-dev)
::: :::
## Joining development and supporting the project ## Joining development and supporting the project
@ -143,8 +147,11 @@ As the Misskey Web client supports PWA, it is also possible to make it act as if
:::fukidashi{chara="doya_ai" charaName="藍"} :::fukidashi{chara="doya_ai" charaName="藍"}
For more information about me, please visit [this website](https://xn--931a.moe/)! For more information about me, please visit [this website](https://xn--931a.moe/)!
::: :::
:::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"} :::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"}
It's Misskey's guardian deity, Ai.(They called Ai cute, yay!) It's Misskey's guardian deity, Ai.(They called Ai cute, yay!)
::: :::

8
content/en/docs/2.for-users/2.onboarding/2.get-started.md
View File

@ -13,13 +13,13 @@ You can choose any server from the [server list](/servers/).
:::tip :::tip
どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。
:::g-details{summary='Details'} ::::g-details{summary='Details'}
Misskey has federated functionality. Misskey has federated functionality.
This federated functionality allows users on different servers to follow, react, and renote in the same way as users on the same server, even if they are on different servers. This federated functionality allows users on different servers to follow, react, and renote in the same way as users on the same server, even if they are on different servers.
The federated functionality that Misskey incorporates is based on an open common standard called ActivityPub and is compatible with other software such as Mastodon and Pleroma. ::::
:::
::: :::
@ -31,5 +31,7 @@ Some servers may have a specific theme, for example, "I like certain a thing or
We recommend that you look for a server with a theme that suits you. We recommend that you look for a server with a theme that suits you.
:::tip :::tip
A list of servers can be found [here](/servers/). A list of servers can be found [here](/servers/).
::: :::

2
content/en/docs/2.for-users/2.onboarding/3.join-server.md
View File

@ -3,9 +3,11 @@
Once you have decided which server to register with, it's time to create an account. Once you have decided which server to register with, it's time to create an account.
:::tip :::tip
ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。
However, the information you enter may vary depending on the server.Please contact your server administrator for more information. However, the information you enter may vary depending on the server.Please contact your server administrator for more information.
::: :::
## Register ## Register

4
content/en/docs/2.for-users/2.onboarding/4.things-to-know.md
View File

@ -7,7 +7,9 @@ Here is a summary of what you, the account creator, need to know for now.
Posts on Misskey are called "notes.".There are many features compared to Twitter and other popular social networking sites, so be sure to check them out before making your first post. 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 :::tip
For more information, see "[Notes](/docs/for-users/features/note/)". For more information, see "[Notes](/docs/for-users/features/note/)".
::: :::
## Timelines ## Timelines
@ -15,7 +17,9 @@ For more information, see "[Notes](/docs/for-users/features/note/)".
Misskey has multiple timelines.The names alone may be a little confusing, so it is important to know what each of them do. Misskey has multiple timelines.The names alone may be a little confusing, so it is important to know what each of them do.
:::tip :::tip
For more information, see "[Timeline](/docs/for-users/features/timeline/)". For more information, see "[Timeline](/docs/for-users/features/timeline/)".
::: :::
## Other ## Other

2
content/en/docs/2.for-users/3.features/ads.md
View File

@ -4,7 +4,9 @@ Misskey has a feature that displays ads etc. on timelines.
You can reduce the frequency of relevant ads by clicking the icon to the right of the ads. You can reduce the frequency of relevant ads by clicking the icon to the right of the ads.
:::tip :::tip
If the total number of ads is low, ads may reappear even though their frequency has been reduced. If the total number of ads is low, ads may reappear even though their frequency has been reduced.
::: :::
## Setting Up Ads (Administrators Only) ## Setting Up Ads (Administrators Only)

4
content/en/docs/2.for-users/3.features/drive.md
View File

@ -3,7 +3,9 @@
ドライブは、Misskey上でファイルを管理できる機能です。 ドライブは、Misskey上でファイルを管理できる機能です。
:::tip :::tip
技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。 技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。
::: :::
Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。 Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。
@ -13,7 +15,9 @@ Misskey Webのドライブページから任意のファイルをアップロー
ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。 ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。
:::warning :::warning
現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。 現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。
::: :::
## センシティブ (NSFW) ## センシティブ (NSFW)

9
content/en/docs/2.for-users/3.features/mfm.md
View File

@ -7,7 +7,9 @@ description: MFMは、Misskeyの様々な場所で使用できる専用のマー
MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。 MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。
:::tip :::tip
一部の構文はMarkdownやHTMLと互換性があります。 一部の構文はMarkdownやHTMLと互換性があります。
::: :::
## MFMが使用可能な場所の例 ## MFMが使用可能な場所の例
@ -23,7 +25,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使
アットマーク + ユーザー名で、特定のユーザーを示すことができます。 アットマーク + ユーザー名で、特定のユーザーを示すことができます。
:::tip :::tip
メンションについての詳細は[こちら](./mention.md)を参照してください。 メンションについての詳細は[こちら](./mention.md)を参照してください。
::: :::
``` ```
@ -42,7 +46,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使
ナンバーサイン + タグで、ハッシュタグを示すことができます。 ナンバーサイン + タグで、ハッシュタグを示すことができます。
:::tip :::tip
ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。 ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。
::: :::
``` ```
@ -70,6 +76,7 @@ https://example.com
``` ```
:::tip :::tip
リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。 リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。
``` ```
@ -84,7 +91,9 @@ https://example.com
コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。 コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。
:::tip :::tip
カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。 カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。
::: :::
``` ```

10
content/en/docs/2.for-users/3.features/mute-and-block.md
View File

@ -5,11 +5,15 @@
ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。 ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。
:::tip :::tip
ミュートとブロックは併用できます。 ミュートとブロックは併用できます。
::: :::
:::warning :::warning
利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。 利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。
::: :::
Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。 Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。
@ -26,7 +30,9 @@ Misskey Webでは、設定>ミュートとブロック から、自分がミュ
Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。 Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。
:::tip :::tip
ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。 ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。
::: :::
## ブロック ## ブロック
@ -48,9 +54,13 @@ Misskey Webでユーザーをミュートするには、対象のユーザーの
Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。 Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。
:::warning :::warning
ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。 ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。
::: :::
:::warning :::warning
相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。 相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。
::: :::

2
content/en/docs/2.for-users/3.features/pages.md
View File

@ -3,7 +3,9 @@
Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。 Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。
:::warning :::warning
v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。 v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。
::: :::
## ページ設定 ## ページ設定

4
content/en/docs/2.for-users/3.features/poll.md
View File

@ -13,7 +13,9 @@
追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。 追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。
:::warning :::warning
いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。 いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。
::: :::
## 複数回答を可能にする ## 複数回答を可能にする
@ -41,7 +43,9 @@
未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。 未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。
:::tip :::tip
未投票アンケートには、結果を表示した状態でも投票できます。 未投票アンケートには、結果を表示した状態でも投票できます。
::: :::
投票をすると、自分の投票した選択肢に✔がつきます。 投票をすると、自分の投票した選択肢に✔がつきます。

4
content/en/docs/2.for-users/3.features/share-form.md
View File

@ -7,7 +7,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく
## クエリパラメータ ## クエリパラメータ
:::tip :::tip
すべてのパラメータは**オプション**であり、必須ではありません。 すべてのパラメータは**オプション**であり、必須ではありません。
::: :::
| 名前 | 説明 | | 名前 | 説明 |
@ -46,7 +48,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく
| `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) | | `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) |
:::warning :::warning
`visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。 `visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。
::: :::
### 添付ファイル ### 添付ファイル

4
content/en/docs/2.for-users/3.features/thread-mute.md
View File

@ -1,7 +1,9 @@
# スレッドミュート # スレッドミュート
:::tip :::tip
バージョン 12.95.0 以降の機能です。 バージョン 12.95.0 以降の機能です。
::: :::
スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。 スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。
@ -11,5 +13,7 @@
Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。 Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。
:::warning :::warning
スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。 スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。
::: :::

4
content/en/docs/2.for-users/3.features/webhook.md
View File

@ -1,11 +1,15 @@
# Webhook # Webhook
:::tip :::tip
バージョン 12.109.0 以降の機能です。 バージョン 12.109.0 以降の機能です。
::: :::
:::warning :::warning
実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。 実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。
::: :::
MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。 MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。

4
content/en/docs/2.for-users/4.resources/1.troubleshooting.md
View File

@ -5,7 +5,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ
# トラブルシューティング # トラブルシューティング
:::tip :::tip
[よくある質問](./faq.md)も合わせてお役立てください。 [よくある質問](./faq.md)も合わせてお役立てください。
::: :::
問題が発生したときは、まずこちらをご確認ください。 問題が発生したときは、まずこちらをご確認ください。
@ -59,7 +61,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ
クライアントの設定の「キャッシュをクリア」すると直ります。 クライアントの設定の「キャッシュをクリア」すると直ります。
:::warning :::warning
「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。 「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。
::: :::
## 通知やアンテナ等の点滅が消えない ## 通知やアンテナ等の点滅が消えない

9
content/en/docs/2.for-users/4.resources/donate.md
View File

@ -13,22 +13,27 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は
- [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share)
:::tip :::tip
高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。
::: :::
:::tip :::tip
額に応じて以下の返礼を用意しています。 額に応じて以下の返礼を用意しています。
- 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与
- 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載 - 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載
- 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載 - 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載
::: :::
:::warning :::warning
:::warning
**バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。** **バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。**
(メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります) (メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります)
:::
::: :::
また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。 また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。

2
content/en/docs/2.for-users/4.resources/misskey-hub.md
View File

@ -6,7 +6,9 @@ Misskey Hubは、Misskeyに関するナレッジなどのドキュメント、
Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub) Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub)
:::tip :::tip
Misskey HubはNuxtを使ってビルドされた静的サイトです。 Misskey HubはNuxtを使ってビルドされた静的サイトです。
::: :::
## Misskey Hubに貢献する ## Misskey Hubに貢献する

2
content/en/docs/3.for-admin/features/announcement.md
View File

@ -5,11 +5,13 @@ 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. Using the announcement feature, you can post server-wide announcements to users, as well as send messages from the server to individual users.
:::warning :::warning
アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。 アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。
- Create an announcement with the "Existing Users Only" option enabled - Create an announcement with the "Existing Users Only" option enabled
- Create an announcement with the "do not notify" option enabled - Create an announcement with the "do not notify" option enabled
- Archive closed announcements. - Archive closed announcements.
::: :::
## Display format ## Display format

10
content/en/docs/3.for-admin/features/role.md
View File

@ -21,10 +21,12 @@
- **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール)
:::warning :::warning
コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。
- 手動でのアサイン/アサイン解除は行えません。 - 手動でのアサイン/アサイン解除は行えません。
- 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。 - 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。
::: :::
## 権限 ## 権限
@ -53,6 +55,7 @@
**優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。**
:::tip :::tip
例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、
- 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。
@ -62,6 +65,7 @@
- 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。
- ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。
::: :::
### ベースロールの値を使用 ### ベースロールの値を使用
@ -85,13 +89,15 @@
アサインする際にアサインされる期間を設定することが可能です。 アサインする際にアサインされる期間を設定することが可能です。
:::tip :::tip
:::tip
ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。 ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。
:::
::: :::
:::warning :::warning
コンディショナル ロールには手動でのアサインはできません。 コンディショナル ロールには手動でのアサインはできません。
::: :::
## ユーザーのポリシーの確認 ## ユーザーのポリシーの確認

4
content/en/docs/3.for-admin/install/guides/1.index.md
View File

@ -7,15 +7,19 @@ description: How to create a Misskey server.
Thank you for your interest in creating a Misskey server.There are several ways to create a server, so please choose one below and read the corresponding guide. 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 :::danger
Do not recreate the database with the domain/hostname of the server once you have started using it! Do not recreate the database with the domain/hostname of the server once you have started using it!
::: :::
:::warning :::warning
自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 自分のサーバーに対して 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. Do not minify the JavaScript again as it has already been minified, Cloudflare also does not interpret the latest JavaScript correctly and would end up destroying the code inside causing Misskey to not work properly.
See [misskey-dev/misskey#9791](https://github.com/misskey-dev/misskey/issues/9791) for more information. See [misskey-dev/misskey#9791](https://github.com/misskey-dev/misskey/issues/9791) for more information.
::: :::
## Installation on Xserver VPS ## Installation on Xserver VPS

17
content/en/docs/3.for-admin/install/guides/bash.md
View File

@ -20,7 +20,9 @@ Misskeyを簡単にインストールするためのシェルスクリプトが
3. Cloudflareアカウント（推奨） 3. Cloudflareアカウント（推奨）
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
::: :::
Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。 Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。
@ -28,7 +30,6 @@ Let's Encryptの認証を試行できる回数が少ないので、サーバー
## Cloudflareの設定 ## Cloudflareの設定
Cloudflareを使う場合、Cloudflareのドメインの設定を完了してからインストールを開始するようにしてください。\ Cloudflareを使う場合、Cloudflareのドメインの設定を完了してからインストールを開始するようにしてください。\
\
ネームサーバーの適用には最大で3日程度かかる場合があります。 ネームサーバーの適用には最大で3日程度かかる場合があります。
また、nginxとCloudflareを設定する場合、Cloudflareの設定画面にて、 また、nginxとCloudflareを設定する場合、Cloudflareの設定画面にて、
@ -41,7 +42,6 @@ Cloudflareを使う場合、Cloudflareのドメインの設定を完了してか
### 1. SSH ### 1. SSH
サーバーにSSH接続します。\ サーバーにSSH接続します。\
\
（サーバーのデスクトップを開いている方はシェルを開きましょう。） （サーバーのデスクトップを開いている方はシェルを開きましょう。）
### 2. 環境を最新にする ### 2. 環境を最新にする
@ -113,13 +113,10 @@ iptablesを使うようにしてください。
v1から、インストールメソッドにsystemdとDockerとを選べるようにしました。 v1から、インストールメソッドにsystemdとDockerとを選べるようにしました。
Dockerと言っても、**MisskeyだけをDockerで実行**し、RedisやPostgresなどはホストで直接実行します。\ Dockerと言っても、**MisskeyだけをDockerで実行**し、RedisやPostgresなどはホストで直接実行します。\
\
[docker-composeですべての機能を動かす方法については、mamemonongaさんが作成したこちらの記事がおすすめです。](https://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0) [docker-composeですべての機能を動かす方法については、mamemonongaさんが作成したこちらの記事がおすすめです。](https://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0)
Docker Hubイメージを使う設定であれば、Misskeyのビルドが不要になるため、**一番お勧めです**。\ Docker Hubイメージを使う設定であれば、Misskeyのビルドが不要になるため、**一番お勧めです**。\
\
ただし、マイグレーションは必要なので、アップデート時にMisskeyを使えない時間がゼロになるわけではありません。\ ただし、マイグレーションは必要なので、アップデート時にMisskeyを使えない時間がゼロになるわけではありません。\
\
また、Misskeyのビルド環境を準備しない(git pullしない)ので、フォークを動かしたくなった時に設定が面倒になります。 また、Misskeyのビルド環境を準備しない(git pullしない)ので、フォークを動かしたくなった時に設定が面倒になります。
ローカルでDockerをビルドする方式は、パフォーマンス面で非推奨です。 ローカルでDockerをビルドする方式は、パフォーマンス面で非推奨です。
@ -147,14 +144,12 @@ systemdは、Docker Hubにイメージを上げるまでもないものの、フ
万が一途中で失敗してもう一度スクリプトを動作させる場合、次のことに注意してください。 万が一途中で失敗してもう一度スクリプトを動作させる場合、次のことに注意してください。
- RedisやPostgresのインストールが終わっている場合、「install locally」はNoにしてください。\ - RedisやPostgresのインストールが終わっている場合、「install locally」はNoにしてください。\
\
host・port設定はそのままEnterを押します。 host・port設定はそのままEnterを押します。
ユーザー名やパスワードは、前回実行した際に指定したものを入力します。 ユーザー名やパスワードは、前回実行した際に指定したものを入力します。
## .envファイルについて ## .envファイルについて
インストールスクリプトは、2つの.envファイルを作成します。\ インストールスクリプトは、2つの.envファイルを作成します。\
\
アップデートの際に使用します。 アップデートの際に使用します。
### /root/.misskey.env ### /root/.misskey.env
@ -165,14 +160,12 @@ misskeyを実行するユーザーを覚えておくために必要です。
systemdの場合に生成されます。\ systemdの場合に生成されます。\
\ \
主にディレクトリを覚えておくのに使用します。 実行されているコンテナとイメージの番号を保存しています。
### /home/(misskeyユーザー)/.misskey-docker.env ### /home/(misskeyユーザー)/.misskey-docker.env
Dockerの場合に生成されます。\ Dockerの場合に生成されます。\
\
実行されているコンテナとイメージの番号を保存しています。\ 実行されているコンテナとイメージの番号を保存しています。\
\
コンテナの番号はアップデートの際に更新されます。古いイメージは削除されます。 コンテナの番号はアップデートの際に更新されます。古いイメージは削除されます。
## 自分で管理する ## 自分で管理する
@ -184,7 +177,6 @@ Dockerの場合に生成されます。\
### Misskeyディレクトリ ### Misskeyディレクトリ
Misskeyのソースは`/home/ユーザー/ディレクトリ`としてcloneされます。\ Misskeyのソースは`/home/ユーザー/ディレクトリ`としてcloneされます。\
\
（ユーザー、ディレクトリの初期値はともにmisskeyです。） （ユーザー、ディレクトリの初期値はともにmisskeyです。）
Misskeyディレクトリへは、以下のように移動するとよいでしょう。 Misskeyディレクトリへは、以下のように移動するとよいでしょう。
@ -203,7 +195,6 @@ exit
### systemd ### systemd
systemdのプロセス名はexample.comです。\ systemdのプロセス名はexample.comです。\
\
たとえば再起動するには次のようにします。 たとえば再起動するには次のようにします。
``` ```
@ -259,7 +250,6 @@ requirepassとbindを`/etc/redis/misskey.conf`で設定しています。
## Q. アップデート後に502でアクセスできない ## Q. アップデート後に502でアクセスできない
Dockerでは、起動後にマイグレーションをするため、すぐにアクセスできません。\ Dockerでは、起動後にマイグレーションをするため、すぐにアクセスできません。\
\
マイグレーションが終わっているかどうか確認してみてください。 マイグレーションが終わっているかどうか確認してみてください。
systemdの場合では、pnpm installに失敗している可能性があります。 systemdの場合では、pnpm installに失敗している可能性があります。
@ -275,5 +265,4 @@ journalctlでログを確認すると、たいていre2が云々という記述
## Q. 同じサーバーにもう1つMisskeyを建てたい ## Q. 同じサーバーにもう1つMisskeyを建てたい
スクリプトは同じサーバーに追加でMisskeyをインストールすることは想定していません。\ スクリプトは同じサーバーに追加でMisskeyをインストールすることは想定していません。\
\
幾つかの設定が上書きされるか、途中でエラーになってしまうでしょう。 幾つかの設定が上書きされるか、途中でエラーになってしまうでしょう。

46
content/en/docs/3.for-admin/install/guides/docker.md
View File

@ -1,21 +1,24 @@
--- ---
description: このガイドはDockerを使ったMisskeyセットアップ方法を説明します。 description: This guide explains how to set up Misskey using Docker
--- ---
# Docker Composeを使ったMisskey構築 # Building Misskey using Docker Compose
このガイドはDocker Composeを使ったMisskeyセットアップ方法を説明します。 This guide explains how to set up Misskey using Docker
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
Do not recreate the database with the domain/hostname of the server once you have started using it!
::: :::
:::tip{label='前提条件'} :::tip{label='前提条件'}
- DockerおよびDocker Composeがインストールされていること。 - Make sure Docker and Docker Compose are installed on your system.
::: :::
## リポジトリの取得 ## Clone the Repository
```sh ```sh
git clone -b master https://github.com/misskey-dev/misskey.git git clone -b master https://github.com/misskey-dev/misskey.git
@ -23,9 +26,9 @@ cd misskey
git checkout master git checkout master
``` ```
## 設定 ## Configuration
下記コマンドで、各種設定ファイルのサンプルをコピーします。 The following commands will copy the various config files from examples to their actual config location.
```sh ```sh
cp .config/docker_example.yml .config/default.yml cp .config/docker_example.yml .config/default.yml
@ -33,23 +36,22 @@ cp .config/docker_example.env .config/docker.env
cp ./docker-compose_example.yml ./docker-compose.yml cp ./docker-compose_example.yml ./docker-compose.yml
``` ```
`default.yml`と`docker.env`をファイル内の説明に従って編集してください。\ Please edit `default.yml` and `docker.env` file as per the description.\
\ Also edit `docker-compose.yml` as needed.(If you want to change the port etc.)
また、必要に応じて、`docker-compose.yml`を編集します。(ポートを変更したい場合など)
## ビルドと初期化 ## Build & Initialize
次のコマンドでMisskeyのビルドとデータベースの初期化を行います。 The next set of commands will build Misskey image and perform database initialization.
これにはしばらく時間がかかります。 This will take some time.
```shell ```shell
sudo docker compose build sudo docker compose build
sudo docker compose run --rm web pnpm run init sudo docker compose run --rm web pnpm run init
``` ```
## 起動 ## Startup
お疲れ様でした。以下のコマンドでMisskeyを起動できます。 お疲れ様でした。You can launch Misskey with the following command.
```sh ```sh
sudo docker compose up -d sudo docker compose up -d
@ -57,12 +59,12 @@ sudo docker compose up -d
GLHF✨ GLHF✨
## Misskeyのアップデート方法 ## Updating Misskey
:::warning :::warning
:::warning
アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 Updates are always available in the [release notes](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md). Please make sure to check in advance for any changes that may be required.
:::
::: :::
```sh ```sh
@ -75,9 +77,9 @@ sudo docker compose build
sudo docker compose stop && sudo docker compose up -d sudo docker compose stop && sudo docker compose up -d
``` ```
アップデート内容、およびデータベースの規模によっては時間がかかることがあります。 It may take time depending on the update content and the size of the database.
## cliコマンドを実行する方法 ## How to execute CLI commands?
```sh ```sh
sudo docker compose run --rm web node packages/backend/built/tools/foo bar sudo docker compose run --rm web node packages/backend/built/tools/foo bar

4
content/en/docs/3.for-admin/install/guides/kubernetes.md
View File

@ -3,14 +3,16 @@
このガイドでは、Kubernetes と HelmChartを使用したMisskeyセットアップ方法について説明します。 このガイドでは、Kubernetes と HelmChartを使用したMisskeyセットアップ方法について説明します。
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
::: :::
## TrueCharts と TrueNAS Scale ## TrueCharts と TrueNAS Scale
MisskeyのHelmChartsはTrueNAS Scaleで使用するためのTrueChartsで公開されていますが、HelmChartsとしてインストールすることもできます。 MisskeyのHelmChartsはTrueNAS Scaleで使用するためのTrueChartsで公開されていますが、HelmChartsとしてインストールすることもできます。
[TrueCharts](https://truecharts.org/charts/description_list) のサイトには利用可能なすべてのChartsやインストール方法などのドキュメントがあります。 現在、Misskeyは_incubator_ trainで進行中です。
また、不明な点があればTrueChartsの[Discord](https://discord.gg/Ax9ZgzKx9t)サーバーで質問をすることもできます。 また、不明な点があればTrueChartsの[Discord](https://discord.gg/Ax9ZgzKx9t)サーバーで質問をすることもできます。

10
content/en/docs/3.for-admin/install/guides/manual.md
View File

@ -7,7 +7,9 @@ description: このガイドではMisskeyのインストール・セットアッ
このガイドではMisskeyのインストール・セットアップ方法について解説します。 このガイドではMisskeyのインストール・セットアップ方法について解説します。
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！
::: :::
:::tip{label='前提条件'} :::tip{label='前提条件'}
@ -108,7 +110,9 @@ WantedBy=multi-user.target
``` ```
:::warning :::warning
CentOSで1024以下のポートを使用してMisskeyを使用する場合は`ExecStart=/usr/bin/sudo /usr/bin/npm start`に変更する必要があります。 CentOSで1024以下のポートを使用してMisskeyを使用する場合は`ExecStart=/usr/bin/sudo /usr/bin/npm start`に変更する必要があります。
::: :::
systemdを再読み込みしmisskeyサービスを有効化 systemdを再読み込みしmisskeyサービスを有効化
@ -125,7 +129,9 @@ sudo systemctl start misskey
``` ```
:::tip :::tip
`systemctl status misskey`と入力すると、サービスの状態を調べることができます。 `systemctl status misskey`と入力すると、サービスの状態を調べることができます。
::: :::
:::: ::::
@ -133,7 +139,9 @@ sudo systemctl start misskey
## Misskeyのアップデート方法 ## Misskeyのアップデート方法
:::warning :::warning
アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。 アップデートの際は必ず[リリースノート](https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md)を確認し、変更点や追加で必要になる作業の有無(ほとんどの場合ありません)を予め把握するようにしてください。
::: :::
masterをpullし直し、インストール、ビルド、データベースのマイグレーションを行います: masterをpullし直し、インストール、ビルド、データベースのマイグレーションを行います:
@ -156,8 +164,10 @@ sudo systemctl restart misskey
``` ```
:::tip :::tip
ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください: ビルドや起動時にエラーが発生した場合は、以下のコマンドをお試しください:
- `pnpm run clean`または`pnpm run clean-all` - `pnpm run clean`または`pnpm run clean-all`
- `pnpm rebuild` - `pnpm rebuild`
::: :::

24
content/en/docs/3.for-admin/install/guides/ubuntu-manual.md
View File

@ -11,11 +11,15 @@
[**シェルスクリプトの詳細と使用方法はこちらから！**](./bash/) [**シェルスクリプトの詳細と使用方法はこちらから！**](./bash/)
:::tip :::tip
シェルスクリプトでの開発環境へのインストールは想定されていません。 シェルスクリプトでの開発環境へのインストールは想定されていません。
::: :::
:::tip :::tip
ドメインの購入とCloudflareのセットアップ、サーバーの確保についてはご自身でご準備ください。 ドメインの購入とCloudflareのセットアップ、サーバーの確保についてはご自身でご準備ください。
::: :::
不具合があれば[ @aqz@p1.a9z.dev へのメンション](https://p1.a9z.dev/@aqz)にてお知らせいただければと思います。 不具合があれば[ @aqz@p1.a9z.dev へのメンション](https://p1.a9z.dev/@aqz)にてお知らせいただければと思います。
@ -27,7 +31,9 @@
[docker-compose](./docker/)なら、手作業でももうちょっと簡単に実行できるはずです。 [docker-compose](./docker/)なら、手作業でももうちょっと簡単に実行できるはずです。
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
::: :::
## はじめに ## はじめに
@ -52,7 +58,9 @@ OSの違い、Misskey本体や依存するソフトウェアのバージョン
- ここではドメインをexample.tldとして解説を進めるので、自分が買ったドメインに適宜置き換えて読むこと。開発環境の場合はlocalhostと読み替えます（設定ファイルの項で別途説明） - ここではドメインをexample.tldとして解説を進めるので、自分が買ったドメインに適宜置き換えて読むこと。開発環境の場合はlocalhostと読み替えます（設定ファイルの項で別途説明）
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！ 一度使用を始めたサーバーのドメイン・ホスト名は、決して変更しないでください！
::: :::
## nanoの使い方 ## nanoの使い方
@ -78,7 +86,9 @@ sudo adduser --disabled-password --disabled-login misskey
``` ```
:::tip :::tip
開発環境の場合はユーザーを分ける必要はありません 開発環境の場合はユーザーを分ける必要はありません
::: :::
## 基本的なソフトウェアのインストールと設定 ## 基本的なソフトウェアのインストールと設定
@ -174,10 +184,12 @@ activeならOK。
### nginx ### nginx
nginxは、主としてリバースプロキシに用いられるWebサーバーソフトである。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。 http\://localhost にアクセスし、\*Welcome to nginx!\*と表示されればOK。Misskeyには必須ではないが、キャッシュ等をするとパフォーマンスが向上したり、httpからhttpsへの転送などをするために、インストールしておこう。
:::tip :::tip
開発環境の場合はnginxのセットアップは不要です 開発環境の場合はnginxのセットアップは不要です
::: :::
nginx.orgのドキュメント http\://nginx.org/en/linux_packages.html#Ubuntu に従ってインストールする。 nginx.orgのドキュメント http\://nginx.org/en/linux_packages.html#Ubuntu に従ってインストールする。
@ -238,7 +250,9 @@ sudo apt install -y git build-essential
サーバーをインターネットに公開する準備をする。 サーバーをインターネットに公開する準備をする。
:::tip :::tip
開発環境の場合はファイヤーウォールやCloudFlare、Certbotの設定は不要です 開発環境の場合はファイヤーウォールやCloudFlare、Certbotの設定は不要です
::: :::
### ファイヤーウォール ### ファイヤーウォール
@ -272,7 +286,9 @@ sudo systemctl enable ufw
``` ```
:::tip :::tip
ufwは、netfilter(iptables)を人間が操作しやすいようにするアプリだ。インストールスクリプトは、OCI環境ではnetfilterを直接操作する。 ufwは、netfilter(iptables)を人間が操作しやすいようにするアプリだ。インストールスクリプトは、OCI環境ではnetfilterを直接操作する。
::: :::
### CloudFlare ### CloudFlare
@ -376,7 +392,9 @@ nano .config/default.yml
設定できる値と記述方法は[.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)に書かれている。 設定できる値と記述方法は[.config/example.yml](https://github.com/syuilo/misskey/blob/develop/.config/example.yml)に書かれている。
:::tip :::tip
開発環境の場合、urlは`url: http://localhost:3000`と指定します。 開発環境の場合、urlは`url: http://localhost:3000`と指定します。
::: :::
```yml ```yml
@ -469,7 +487,9 @@ NODE_ENV=production pnpm run build
``` ```
:::tip :::tip
開発環境の場合、`NODE_ENV=production`は不要です。以降のコマンドでも同様に削除してください。 開発環境の場合、`NODE_ENV=production`は不要です。以降のコマンドでも同様に削除してください。
::: :::
### サーバーでビルドできない場合 ### サーバーでビルドできない場合
@ -515,7 +535,9 @@ CloudFlareのDNS設定が正しいIPアドレスになっているかもう一
## Misskeyのデーモンを作成 ## Misskeyのデーモンを作成
:::tip :::tip
開発環境の場合、デーモンの作成は不要です。 開発環境の場合、デーモンの作成は不要です。
::: :::
いったんCtrl+Cでプロセスをキルし、Misskeyをデーモンで起動する設定をしよう。 いったんCtrl+Cでプロセスをキルし、Misskeyをデーモンで起動する設定をしよう。

4
content/en/docs/3.for-admin/install/resources/cdn.md
View File

@ -16,5 +16,7 @@ Please configure your CDN in the following way:
- Cache all requests except `/api/*` - Cache all requests except `/api/*`
:::tip :::tip
It is not necessary to clear the cache when updating Misskey.
Misskeyをアップデートした際にキャッシュのクリアは不要です。
::: :::

4
content/en/docs/3.for-admin/install/resources/troubleshooting.md
View File

@ -248,6 +248,10 @@ Amazon S3に互換性のあるオブジェクトストレージであれば利
各サービス/ソフトウェアのドキュメントをよく読み、設定してみてください。 各サービス/ソフトウェアのドキュメントをよく読み、設定してみてください。
### ローディングが終わらない
Cloudflare を使用している場合は、Rocket LoaderやAuto Minifyが有効になっていないか確認してください。有効になっている場合は無効にすることで解決する場合があります。
*** ***
# まったく解決しなかった場合 # まったく解決しなかった場合

2
content/en/docs/3.for-admin/moderation-tips/disable-timelines.md
View File

@ -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. If you feel like the demerits outweigh the merits, please consider deactivating these respective timelines.
:::warning :::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. 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. Additionally, Administrators / Moderators will be able to continue viewing these timelines even after they have been disabled.

67
content/en/docs/4.for-developers/aiscript.md Normal file
View File

@ -0,0 +1,67 @@
# AiScript
AiScriptは、Misskeyの以下の箇所で使用できるスクリプト言語です。
- [プラグイン](./plugin/)
- [ウィジェット](/docs/for-users/features/widgets/)
- ボタン
- AiScriptコンソール
- AiScript App
- Misskey Play
- スクラッチパッド
:::tip
AiScriptの実装はMisskeyとは別リポジトリで、[オープンソースで公開されています](https://github.com/aiscript-dev/aiscript)。
:::
## 使い方
AiScript標準の構文や組み込み関数などが使用できます。
:::tip
ドキュメントは[こちら](https://github.com/aiscript-dev/aiscript/tree/master/docs)\
Misskey本体のバージョンにより、使用できるAiScriptのバージョンが異なる場合があります。バージョンの確認には`<: Core:v`をScratchpadなどで実行してください。
:::
これらに加え、Misskey専用の組み込み定数・関数が３グループに分けて提供されています。
### Misskey AiScript API
接頭辞: `Mk:`\
Misskey内の全てのAiScript環境で使用できる定関数群です。
詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Mk:`とついた部分を参照して下さい。
### プラグインAPI
接頭辞: `Plugin:`\
[プラグイン](./plugin/)でのみ使用できる定関数群です。
詳しくは[プラグインAPIリファレンス](./plugin/plugin-api-reference/)の`Plugin:`とついた部分を参照して下さい。
### UI API
接頭辞: `Ui:`\
[ウィジェット](/docs/for-users/features/widgets/)（AiScript App）、Misskey Play、Scratchpadで使用できます。
ドキュメントは未整備（TODO）ですが、インターネット上に有志の方が執筆された解説記事があります。
### 標準入出力
AiScript標準で定義されている`readline`関数と`print`関数（および`<:`構文）の内部実装は、Misskey側で独自に提供されています。
#### readline(message)
`message`: `str`\
返り値: `str`\
Misskey内の全てのAiScript環境で使用できます。\
文字列の入力を求めるポップアップを表示します。
#### print(message)
`message`: `any`\
返り値: `null`\
[ウィジェット](/docs/for-users/features/widgets/)（AiScriptコンソール）、Scratchpadで使用できます。\
コンソールに文字列を出力します。\
`<:`構文も同様の働きをします。

4
content/en/docs/4.for-developers/api/1.index.md
View File

@ -8,7 +8,9 @@ MisskeyはAPIを公開しています。APIを使ってMisskeyクライアント
ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。 ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。
:::tip :::tip
Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\
Misskey公式SDKやサードパーティライブラリを使うことによって、このドキュメントで説明するいくつかの手順を簡略化できるなど、より便利にAPIを利用することができます。\\
::: :::
<MkIndex /> <MkIndex />

2
content/en/docs/4.for-developers/api/libraries.md
View File

@ -15,6 +15,8 @@ description: Misskey APIに関連するライブラリの一覧
## Python ## Python
- [Misskey.py](https://github.com/YuzuRyo61/Misskey.py) - [Misskey.py](https://github.com/YuzuRyo61/Misskey.py)
- [MiPA](https://github.com/yupix/MiPA)
- [MiPAC](https://github.com/yupix/MiPAC)
## .Net ## .Net

2
content/en/docs/4.for-developers/api/permission.md
View File

@ -5,7 +5,9 @@ description: アプリケーションが要求する権限の一覧
# 権限の一覧 # 権限の一覧
:::tip :::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)から自動生成しているため、ドキュメントや翻訳が不完全な場合があります。
::: :::
<ApiPermissions></ApiPermissions> <ApiPermissions></ApiPermissions>

8
content/en/docs/4.for-developers/api/streaming/1.index.md
View File

@ -5,7 +5,9 @@ description: ストリーミングAPIを使うと、リアルタイムで様々
# ストリーミングAPI # ストリーミングAPI
:::tip :::tip
最初に[Misskey API](../index.md)のドキュメントを読むことをお勧めします。 最初に[Misskey API](../index.md)のドキュメントを読むことをお勧めします。
::: :::
ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、リアクションされた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。 ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、リアクションされた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。
@ -26,7 +28,9 @@ wss://{host}/streaming?i={token}
- `{token}`の部分は、ユーザーのアクセストークンに置き換えます。 - `{token}`の部分は、ユーザーのアクセストークンに置き換えます。
:::tip :::tip
アクセストークンは省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。 アクセストークンは省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。
::: :::
ストリームに接続すると、後述投稿の購読を行ったりすることができますが、まだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。 ストリームに接続すると、後述投稿の購読を行ったりすることができますが、まだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。
@ -40,7 +44,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり
ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。 ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。
:::tip :::tip
ひとつのストリーム接続上で、同時に複数のチャンネルに接続することができます。 ひとつのストリーム接続上で、同時に複数のチャンネルに接続することができます。
::: :::
以下では、チャンネルの使用方法を説明します。どのようなチャンネルがあるかは、[チャンネル一覧](./channel/index.md)を参照してください。 以下では、チャンネルの使用方法を説明します。どのようなチャンネルがあるかは、[チャンネル一覧](./channel/index.md)を参照してください。
@ -69,7 +75,9 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり
- `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。 - `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。
:::tip :::tip
IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。 IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。
::: :::
### チャンネルからのメッセージを受け取る ### チャンネルからのメッセージを受け取る

9
content/en/docs/4.for-developers/api/token.md
View File

@ -7,7 +7,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた**
アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。 アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。
:::tip :::tip
ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。 ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。
::: :::
あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。 あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。
@ -20,7 +22,9 @@ APIを使い始めるには、APIを利用するアカウントに紐づいた**
Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。 Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。
:::danger :::danger
アクセストークンは他人に知られないようにしてください。 アクセストークンは他人に知られないようにしてください。
::: :::
### アプリケーション利用者にアクセストークンの発行をリクエストする ### アプリケーション利用者にアクセストークンの発行をリクエストする
@ -32,6 +36,7 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行
以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。 以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。
[アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app) [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app)
::: :::
#### Step 1 #### Step 1
@ -39,7 +44,9 @@ Misskey Webの「設定 > API」で、自分のアクセストークンを発行
UUIDを生成する。以後これを**セッションID**と呼びます。 UUIDを生成する。以後これを**セッションID**と呼びます。
:::danger :::danger
このセッションIDは毎回生成し、使いまわさないようにしてください。 このセッションIDは毎回生成し、使いまわさないようにしてください。
::: :::
#### Step 2 #### Step 2
@ -119,7 +126,9 @@ https://{host}/api/miauth/{session}/check
APIの詳細は、APIリファレンスを参照してください。 APIの詳細は、APIリファレンスを参照してください。
:::warning :::warning
MisskeyはRESTを採用していません。 MisskeyはRESTを採用していません。
::: :::
また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。

88
content/en/docs/4.for-developers/api/token/1.index.md Normal file
View File

@ -0,0 +1,88 @@
# アクセストークンの取得
APIを使い始めるには、APIを利用するアカウントに紐づいた**アクセストークン**を取得する必要があります。
このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。
基本的に、APIはリクエストにはアクセストークンが必要となります。
アクセストークンは、ユーザーに紐づいた認証情報で、APIを利用するユーザーを識別するとともに、アクセストークンごとにどういった操作の権限を持っているかが管理されます。
:::tip
ユーザーとそのユーザーに紐づいたアクセストークンは一対多の関係であり、あるユーザーに対して複数のアクセストークンが発行され得ます。
:::
あなた自分自身のアクセストークンは簡単に取得できるほか、あなたのアプリケーションを使用することになる不特定のユーザーのアクセストークンを取得することもできます。
- 前者の場合: **「自分自身のアクセストークンを手動発行する」** に進む
- 後者の場合: **「アプリケーション利用者にアクセストークンの発行をリクエストする」** に進む
## 自分自身のアクセストークンを手動発行する
Misskey Webの「設定 > API」で、自分のアクセストークンを発行できます。
:::danger
アクセストークンは他人に知られないようにしてください。
:::
## アプリケーション利用者にアクセストークンの発行をリクエストする
アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の方法の一つを使います。
:MkIndex
## APIの利用
アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。
:::tip
- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。
- 要求ヘッダーに`Content-Type: application/json`を指定します。
- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。
- ベースURLは`https://{サーバーのドメイン}/api`です。
:::
### Authorization headerを使う方式
以下のようにヘッダーの`Authorization`フィールドを指定します。
```js
fetch("https://misskey.io/api/notes/create", {
method: 'POST',
body: JSON.stringify({
text: "Hello Misskey API World with My Application!"
}),
headers: {
Authorization: `Bearer ${accessToken}`,
'Content-Type': 'application/json',
},
credentials: 'omit',
});
```
### iを使う方式
アクセストークン付きのボディの例（metaの場合）:
```json
{
"i": "HogEFugA1341",
"detail": false
}
```
<!--TODO:「APIリファレンス」をリンクに差し替え-->
APIの詳細は、APIリファレンスを参照してください。
:::warning
MisskeyはRESTを採用していません。
:::
また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](../streaming/)を参照してください。

76
content/en/docs/4.for-developers/api/token/2.miauth.md Normal file
View File

@ -0,0 +1,76 @@
---
description: v12.27.0以降で使用できる、Misskey独自の簡素な認証方法について説明しています。
---
# MiAuth方式でのアクセストークン取得方式
アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。
:::tip
以下に説明する方法は、アプリを作成せずインスタントにアクセストークンを発行する、MiAuthと呼ばれるものです。
- [よりおおく使われているOAuth方式でのアクセストークン取得方法もあります。](./oauth.md)
- [アプリ作成方式でのアクセストークン取得方法もあります（旧来型）。](./app.md)
:::
## Step 1
UUIDを生成する。以後これを**セッションID**と呼びます。
:::danger
このセッションIDは毎回生成し、使いまわさないようにしてください。
:::
## Step 2
アプリケーション認証フォームをユーザーのブラウザで表示させる。認証フォームは、以下の形式のURLで開くことができます:
```
https://{host}/miauth/{session}
```
ここで、
- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。
- `{session}`の部分は、セッションIDに置き換えます。
また、URLにクエリパラメータとしていくつかのオプションを設定できます:
| 名前 | 説明 |
| ------------ | ------------------------------------------------------------------------------ |
| `name` | アプリケーション名。 |
| `icon` | アプリケーションのアイコン画像URL。 |
| `callback` | 認証が終わった後にリダイレクトするURL。<br>リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 |
| `permission` | アプリケーションが要求する権限。<br>要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。 |
:::tip{label='例'}
```
https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive
```
:::
## Step 3
ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。
```
https://{host}/api/miauth/{session}/check
```
ここで、
- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。
- `{session}`の部分は、セッションIDに置き換えます。
レスポンスに含まれるプロパティは以下の通りです:
| 名前 | 説明 |
| ------- | -------------- |
| `token` | ユーザーのアクセストークン。 |
| `user` | ユーザーの情報。 |

179
content/en/docs/4.for-developers/api/token/3.oauth.md Normal file
View File

@ -0,0 +1,179 @@
---
description: v2023.9.0以降で使用できる、OAuth2.0方式での認証方法について説明しています。
---
# OAuth方式でのアクセストークン取得方式
アプリケーションを利用するユーザー(以下単に「ユーザー」と呼びます)のアクセストークンを取得するには、以下の手順で発行をリクエストします。
:::tip
以下に説明する方法は、[OAuth 2.0](https://datatracker.ietf.org/doc/html/rfc6749.html)と呼ばれるものです。普通のOAuthはアプリを作成しますが、[IndieAuth](https://indieauth.spec.indieweb.org/)の拡張でアプリ作成なしで使えるようになっています。
OAuth方式は使えるライブラリが多いので、出来ればライブラリを使うのをおすすめします。
現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。
- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md)
- [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md)
:::
## Step 1
アプリ紹介のためのウェブページを作ります。ページがHTTPSアドレスでアクセスできるようにしてください。ページのとこかに以下のようなHTMLコードを書きます。
```html
<!-- （必須項目）hrefのアドレスが認証コードの転送先になります。 -->
<link rel='redirect_uri' href='/redirect'>
<!-- ユーザーに見せるアプリの名前になります。なかったらこのページのアドレスが名前になります。 -->
<div class='h-app'>
<a href="/" class="u-url p-name">My Misskey App</a>
</div>
```
あとで`redirect_uri`のアドレスに認証コードが転送されます。
## Step 2
PKCE `code_verifier`と`code_challenge`文字列, 及び`state`文字列を生成します。
- `code_verifier`の場合は最低43字、最高128字でアルファベット大・小文字及び`-._~`の中の文字に限られます。
- `code_challenge`文字列は`code_verifier`文字列をSHA256アルゴリズムでハッシュしてbase64urlでエンコードした結果を使います。
- `state`文字列には特別な制限はありません。ランダムな文字列を使います。
:::danger
この文字列は毎回生成し、使いまわさないようにしてください。
:::
:::tip
[pkce-challenge](https://www.npmjs.com/package/pkce-challenge)とかのライブラリを使ったり、OAuthライブラリのPKCE機能を使うのがおすすめです。
:::
:::tip{label='例'}
```js
import crypto from "node:crypto";
const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-._~";
const codeVerifier = new Array(128)
.fill(0)
.map(() => chars[Math.floor(chars.length * Math.random())])
.join("");
console.log('code_verifier', codeVerifier);
const codeChallenge = crypto
.createHash("sha256")
.update(codeVerifier, "ascii")
.digest("base64url");
console.log('code_challenge', codeChallenge);
const state = crypto.randomUUID();
console.log('state', state);
```
:::
## Step 3
相手サーバーのOAuth情報を取得します。データはJSON形式になっています。
```
https://{host}/.well-known/oauth-authorization-server
```
`{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。
ここでは`authorization_endpoint`と`token_endpoint`を使います。
:::tip
次のステップで使われる`scope`の情報も`scopes_supported`で確認できます。
:::
## Step 4
アプリケーション認証フォームをユーザーのブラウザで表示させます。認証フォームは、以下の形式のURLで開くことができます:
```
{authorization_endpoint}?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&scope={scope}&code_challenge={code_challenge}&code_challenge_method=S256&state={state}
```
ここで、
- `{authorization_endpoint}`の部分は、前の情報取得で得たアドレスに置き換えます。
- `{client_id}`の部分は、アプリの紹介ページのアドレスに置き換えます。
- `{code_challenge}`の部分は、前に生成した`code_challenge`文字列に置き換えます
- `code_challenge_method`の部分は常に`S256`にします。
- `{redirect_uri}`の部分は、紹介ページで使っている配達先のアドレスに置き換えます。
- `{scope}`の部分は、アプリケーションが要求する権限に置き換えます。要求する権限を` `で区切って列挙します。権限の一覧は[こちら](../permission.md)で確認できます。
- `{state}`の部分は、前に生成した`state`文字列に置き換えます。
:::tip{label='例'}
```
https://misskey.local/oauth/authorize?client_id=http%3A%2F%2Fexample.com&code_challenge=C6hwMO2bmIzg3nqppTE9b79fvuOjlrKmH2xNiZSMHzw&code_challenge_method=S256&response_type=code&redirect_uri=http%3A%2F%2Fexample.com%2Fredirect&scope=write%3Anotes&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab
```
:::
## Step 5
ユーザーがアプリケーションアクセスを許可したら、`redirect_uri`のアドレスに認証コードがURLパラメータの形式で転送されます。
| 名前 | 説明 |
| ------- | ----------------------- |
| `code` | ユーザーの認証コード。 |
| `state` | 認証リクエストに使われた`state`文字列。 |
:::tip{label='例'}
```
https://example.com/redirect?code=...&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab
```
:::
`state`文字列がちゃんと一致しているのか確認して、次のステップに進みます。
## Step 6
転送された認証コードを使ってアクセストークンをPOSTでリクエストします。リクエスト先は`token_endpoint`になります。データ形式は`application/json`と`application/x-www-form-urlencoded`を使えます。各パラメータは以下のようになります。
| 名前 | 説明 |
| --------------- | ------------------------------ |
| `grant_type` | 常に`authorization_code`にします。 |
| `client_id` | 認証リクエストに使われた`client_id`文字列。 |
| `redirect_uri` | 認証リクエストに使われた`redirect_uri`文字列。 |
| `scope` | 認証リクエストに使われた`scope`文字列。 |
| `code` | 取得した認証コード。　 |
| `code_verifier` | 前に生成した`code_verifier`文字列。 |
:::tip{label='例'}
```js
const res = await fetch(endpoint, {
method: "POST",
body: JSON.stringify({
grant_type: "authorization_code",
client_id: "https://example.com",
redirect_uri: "https://example.com/redirect",
scope: "write:notes",
code: "...",
code_verifier: "hjjbCYDmDpSLjirkO-PrfWKsRhDdJr-PAEGRClRwzUKlmFIIIrZNmSvUIraeIa~WqbqQnfbJV-Hc_IfuQkesBYUpukUi~lInDfU_AZjoZqbU.ioQTRzaFfZFfGnT-OAA",
}),
headers: {
"Content-Type": "application/json"
}
});
```
:::
レスポンスはJSONオブジェクト形式で、そこから`access_token`を取得して使います。

50
content/en/docs/5.releases.md
View File

@ -6,6 +6,49 @@ maxTocDepth: 2
Misskeyのリリースノートを掲載しています。 Misskeyのリリースノートを掲載しています。
## 2023.12.2
リリース日: 2023/12/28
### General
- v2023.12.1でDockerを利用してサーバーを起動できない問題を修正
### Client
- Enhance: 検索画面においてEnterキー押下で検索できるように
## 2023.12.1
リリース日: 2023/12/27
### Note
- アクセストークンの権限が再整理されたため、一部のAPIが古いAPIトークンでは動作しなくなりました。\
権限不足になる場合には権限を再設定して再生成してください。
### General
- Enhance: ローカリゼーションの更新
- Fix: 自分のdirect noteがuser list timelineに追加されない
### Client
- Feat: AiScript専用のMFM構文`$[clickable.ev=EVENTNAME ...]`を追加。`Mk:C:mfm`のオプション`onClickEv`に関数を渡すと、クリック時に`EVENTNAME`を引数にして呼び出す
- Enhance: MFM入力補助ボタンを投稿フォームに表示できるように #12787
- Fix: 一部のモデログ(logYellowでの表示対象)について、表示の色が変わらない問題を修正
- Fix: `fg`/`bg`MFMに長い単語を指定すると、オーバーフローされずはみ出る問題を修正
### Server
- Enhance: センシティブワードの設定がハッシュタグトレンドにも適用されるようになりました
- Enhance: `oauth/token`エンドポイントのCORS対応
- Fix: 1702718871541-ffVisibility.jsのdownが壊れている
- Fix:「非センシティブのみ（リモートはいいねのみ）」を設定していても、センシティブに設定されたカスタム絵文字をリアクションできる問題を修正
- Fix: ロールアサイン時の通知で，ロールアイコンが縮小されずに表示される問題を修正
- Fix: サードパーティアプリケーションがWebsocket APIに無条件にアクセスできる問題を修正
- Fix: サードパーティアプリケーションがユーザーの許可なしに非公開の情報を見ることができる問題を修正
## 2023.12.0 ## 2023.12.0
リリース日: 2023/12/23 リリース日: 2023/12/23
@ -1957,7 +2000,9 @@ same as 12.112.0
### NOTE ### NOTE
:::warning :::warning
このバージョンからNode v16.14.0以降が必要です このバージョンからNode v16.14.0以降が必要です
::: :::
### Changes ### Changes
@ -2069,12 +2114,16 @@ same as 12.112.0
### Note ### Note
:::warning :::warning
ビルドする前に`npm run clean`を実行してください。 ビルドする前に`npm run clean`を実行してください。
::: :::
:::warning :::warning
このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。
マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。
::: :::
### Improvements ### Improvements
@ -2145,6 +2194,7 @@ same as 12.112.0
アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。 アップデート後、一部カスタム絵文字が表示できなくなる場合があります。その場合、一旦絵文字管理ページから絵文字を一括エクスポートし、再度コントロールパネルから一括インポートすると直ります。
12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。 12.102.0以前にエクスポートされたzipとは互換性がありません。アップデートしてからエクスポートを行なってください。
::: :::
### Changes ### Changes

7
content/fr/docs/1.about-misskey.md
View File

@ -15,7 +15,9 @@ Misskeyはオープンソースの分散型マイクロブログプラットフ
当初は分散型ではありませんでしたが、2018年にActivityPubを実装し分散型になったことで、より多くの方に認知され利用されるサービスになり、現在に至ります。 当初は分散型ではありませんでしたが、2018年にActivityPubを実装し分散型になったことで、より多くの方に認知され利用されるサービスになり、現在に至ります。
:::tip :::tip
Misskeyという名前は、syuiloが当時聴いていたMay'nというアーティストの楽曲、Brain Diverの歌詞に由来します。 Misskeyという名前は、syuiloが当時聴いていたMay'nというアーティストの楽曲、Brain Diverの歌詞に由来します。
::: :::
誰でも開発に参加することができ、現在でも活発に開発が続いています。 誰でも開発に参加することができ、現在でも活発に開発が続いています。
@ -35,7 +37,9 @@ Misskeyのすべてのソースコードは[AGPL](https://github.com/misskey-dev
再び引き合いに出しますが、TwitterやFacebookなどの利益を得ているほとんどのサービスはオープンソースではありません。 再び引き合いに出しますが、TwitterやFacebookなどの利益を得ているほとんどのサービスはオープンソースではありません。
:::tip :::tip
技術的に言うと、MisskeyのソースコードはGitで管理されていて、リポジトリは[GitHub上でホスティングされています。](https://github.com/misskey-dev) 技術的に言うと、MisskeyのソースコードはGitで管理されていて、リポジトリは[GitHub上でホスティングされています。](https://github.com/misskey-dev)
::: :::
## 開発に参加する、プロジェクトを支援する ## 開発に参加する、プロジェクトを支援する
@ -143,8 +147,11 @@ Misskeyは開発が進むにつれ使用する技術も大きく変わってき
:::fukidashi{chara="doya_ai" charaName="藍"} :::fukidashi{chara="doya_ai" charaName="藍"}
わたしについては[このホームページ](https://xn--931a.moe/)をご覧ください！ わたしについては[このホームページ](https://xn--931a.moe/)をご覧ください！
::: :::
:::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"} :::fukidashi{chara="syuilo" charaName="しゅいろ" direction="right"}
Misskeyの守り神、藍ちゃんです。ｱｲﾁｬﾝｶﾜｲｲﾔｯﾀｰ! Misskeyの守り神、藍ちゃんです。ｱｲﾁｬﾝｶﾜｲｲﾔｯﾀｰ!
::: :::

5
content/fr/docs/2.for-users/2.onboarding/2.get-started.md
View File

@ -11,14 +11,17 @@ Misskeyを利用するには、どこかのサーバーにアカウントを作
[サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。 [サーバー一覧](/servers/)から、好きなサーバーを選ぶことができます。
:::tip :::tip
どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。
:::g-details{summary='詳細'} :::g-details{summary='詳細'}
Misskeyには連合機能が備わっています。 Misskeyには連合機能が備わっています。
連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。 連合機能によって、別のサーバーのユーザーであっても、同じサーバーのユーザーと同じようにフォローやリアクション、Renoteなどができるようになっています。
Misskeyが搭載している連合機能はActivityPubというオープンな共通規格に基づいていて、MastodonやPleromaといったほかのソフトウェアとも互換性があります。 Misskeyが搭載している連合機能はActivityPubというオープンな共通規格に基づいていて、MastodonやPleromaといったほかのソフトウェアとも互換性があります。
::: :::
::: :::
@ -31,5 +34,7 @@ Misskeyが搭載している連合機能はActivityPubというオープンな
自分にあったテーマのサーバーを探すのもおすすめです。 自分にあったテーマのサーバーを探すのもおすすめです。
:::tip :::tip
サーバーの一覧は[こちら](/servers/)からご覧いただけます。 サーバーの一覧は[こちら](/servers/)からご覧いただけます。
::: :::

2
content/fr/docs/2.for-users/2.onboarding/3.join-server.md
View File

@ -3,9 +3,11 @@
登録するサーバーが決まったら、さっそくアカウントを作成しましょう。 登録するサーバーが決まったら、さっそくアカウントを作成しましょう。
:::tip :::tip
ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。
ただし、入力事項はサーバーによって異なることがあります。詳しくは、サーバー管理者にお問い合わせください。 ただし、入力事項はサーバーによって異なることがあります。詳しくは、サーバー管理者にお問い合わせください。
::: :::
## 登録する ## 登録する

4
content/fr/docs/2.for-users/2.onboarding/4.things-to-know.md
View File

@ -7,7 +7,9 @@
Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一般的なSNSに比べたくさんの機能がありますので、初めての投稿を行う前に必ず確認して、上手に投稿しましょう！ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一般的なSNSに比べたくさんの機能がありますので、初めての投稿を行う前に必ず確認して、上手に投稿しましょう！
:::tip :::tip
詳細は、「[ノート](/docs/for-users/features/note/)」をご覧ください。 詳細は、「[ノート](/docs/for-users/features/note/)」をご覧ください。
::: :::
## タイムライン ## タイムライン
@ -15,7 +17,9 @@ Misskeyへの投稿は、「ノート」と呼ばれます。Twitterなどの一
Misskeyは、複数のタイムラインを持っています。名前だけでは少々わかりにくいかと思いますので、それぞれがどのような働きをするのかを知っておきましょう。 Misskeyは、複数のタイムラインを持っています。名前だけでは少々わかりにくいかと思いますので、それぞれがどのような働きをするのかを知っておきましょう。
:::tip :::tip
詳細は、「[タイムライン](/docs/for-users/features/timeline/)」をご覧ください。 詳細は、「[タイムライン](/docs/for-users/features/timeline/)」をご覧ください。
::: :::
## その他 ## その他

2
content/fr/docs/2.for-users/3.features/ads.md
View File

@ -4,7 +4,9 @@ Misskeyではサーバーによる広告をタイムラインなどに表示で
広告の右上に表示されるアイコンをクリックすることで、当該の広告の表示頻度を下げることができます。 広告の右上に表示されるアイコンをクリックすることで、当該の広告の表示頻度を下げることができます。
:::tip :::tip
広告の総数が少ない場合は、表示頻度を下げた後も連続で表示される可能性があります。 広告の総数が少ない場合は、表示頻度を下げた後も連続で表示される可能性があります。
::: :::
## 広告の設定(管理者) ## 広告の設定(管理者)

4
content/fr/docs/2.for-users/3.features/drive.md
View File

@ -3,7 +3,9 @@
ドライブは、Misskey上でファイルを管理できる機能です。 ドライブは、Misskey上でファイルを管理できる機能です。
:::tip :::tip
技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。 技術的に言うと、Misskeyのシステム上、すべてのファイルが一元管理されており、それをユーザーにも公開したインターフェイスがドライブと捉えることができます。
::: :::
Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。 Misskey Webのドライブページから任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。
@ -13,7 +15,9 @@ Misskey Webのドライブページから任意のファイルをアップロー
ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。 ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。
:::warning :::warning
現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。 現時点で、ドライブからファイルを削除すると、そのファイルが添付された **すべてのコンテンツ(ノート、ページなど)** も同時に消えます。
::: :::
## センシティブ (NSFW) ## センシティブ (NSFW)

10
content/fr/docs/2.for-users/3.features/mfm.md
View File

@ -7,7 +7,9 @@ description: MFMは、Misskeyの様々な場所で使用できる専用のマー
MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。 MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。
:::tip :::tip
一部の構文はMarkdownやHTMLと互換性があります。 一部の構文はMarkdownやHTMLと互換性があります。
::: :::
## MFMが使用可能な場所の例 ## MFMが使用可能な場所の例
@ -23,7 +25,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使
アットマーク + ユーザー名で、特定のユーザーを示すことができます。 アットマーク + ユーザー名で、特定のユーザーを示すことができます。
:::tip :::tip
メンションについての詳細は[こちら](./mention.md)を参照してください。 メンションについての詳細は[こちら](./mention.md)を参照してください。
::: :::
``` ```
@ -42,7 +46,9 @@ MFMは、Markup language For Misskeyの略で、Misskeyの様々な場所で使
ナンバーサイン + タグで、ハッシュタグを示すことができます。 ナンバーサイン + タグで、ハッシュタグを示すことができます。
:::tip :::tip
ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。 ハッシュタグについての詳細は[こちら](./hashtag.md)を参照してください。
::: :::
``` ```
@ -70,6 +76,7 @@ https://example.com
``` ```
:::tip :::tip
リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。 リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。
``` ```
@ -83,8 +90,11 @@ https://example.com
### カスタム絵文字 ### カスタム絵文字
コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。 コロンでカスタム絵文字名を囲むと、カスタム絵文字を表示させることができます。
:::tip :::tip
カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。 カスタム絵文字についての詳細は[こちら](./custom-emoji.md)を参照してください。
::: :::
``` ```

10
content/fr/docs/2.for-users/3.features/mute-and-block.md
View File

@ -5,11 +5,15 @@
ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。 ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。
:::tip :::tip
ミュートとブロックは併用できます。 ミュートとブロックは併用できます。
::: :::
:::warning :::warning
利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。 利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。
::: :::
Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。 Misskey Webでは、設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。
@ -26,7 +30,9 @@ Misskey Webでは、設定>ミュートとブロック から、自分がミュ
Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。 Misskey Webでユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。
:::tip :::tip
ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。 ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。
::: :::
## ブロック ## ブロック
@ -48,9 +54,13 @@ Misskey Webでユーザーをミュートするには、対象のユーザーの
Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。 Misskey Webでユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。
:::warning :::warning
ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。 ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。
::: :::
:::warning :::warning
相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。 相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。
::: :::

2
content/fr/docs/2.for-users/3.features/pages.md
View File

@ -3,7 +3,9 @@
Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。 Misskey上でノートとは別にページを作成できます。v13では静的ページに特化しています。
:::warning :::warning
v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。 v13よりページによる動的ページ作成の代わりにMisskey Playが使用できます。
::: :::
## ページ設定 ## ページ設定

4
content/fr/docs/2.for-users/3.features/poll.md
View File

@ -13,7 +13,9 @@
追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。 追加しすぎてしまった入力欄は、入力欄の横の☓ボタンを押すことで削除することができます。
:::warning :::warning
いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。 いずれかの入力欄が空白だった場合、そのアンケートが添付されたノートは投稿できません。
::: :::
## 複数回答を可能にする ## 複数回答を可能にする
@ -41,7 +43,9 @@
未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。 未投票のアンケートの結果を見たあと、もう一度隠すときは「投票する」をクリックします。
:::tip :::tip
未投票アンケートには、結果を表示した状態でも投票できます。 未投票アンケートには、結果を表示した状態でも投票できます。
::: :::
投票をすると、自分の投票した選択肢に✔がつきます。 投票をすると、自分の投票した選択肢に✔がつきます。

4
content/fr/docs/2.for-users/3.features/share-form.md
View File

@ -7,7 +7,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく
## クエリパラメータ ## クエリパラメータ
:::tip :::tip
すべてのパラメータは**オプション**であり、必須ではありません。 すべてのパラメータは**オプション**であり、必須ではありません。
::: :::
| 名前 | 説明 | | 名前 | 説明 |
@ -46,7 +48,9 @@ URLにクエリパラメータとして共有内容をはじめとするいく
| `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) | | `visibleAccts` | 対象ユーザー[acct](../resources/glossary/#acct)(カンマ区切り) |
:::warning :::warning
`visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。 `visibility`に`specified`を指定した場合は、`visibleUserIds`または`visibleAccts`の指定も必要です。
::: :::
### 添付ファイル ### 添付ファイル

4
content/fr/docs/2.for-users/3.features/thread-mute.md
View File

@ -1,7 +1,9 @@
# スレッドミュート # スレッドミュート
:::tip :::tip
バージョン 12.95.0 以降の機能です。 バージョン 12.95.0 以降の機能です。
::: :::
スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。 スレッドミュートは、指定したノートのスレッドをミュートします。スレッドとは、起点のノートから繋がった全てのリプライのことです。
@ -11,5 +13,7 @@
Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。 Misskey Webでスレッドをミュートするには、対象のスレッドに属する任意のノートもしくは起点のノートのメニューを開き、「スレッドをミュート」を選択します。
:::warning :::warning
スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。 スレッド内のどのノートからミュート操作を行ったかに関わらず、そのスレッド全体がミュートされます。
::: :::

4
content/fr/docs/2.for-users/3.features/webhook.md
View File

@ -1,11 +1,15 @@
# Webhook # Webhook
:::tip :::tip
バージョン 12.109.0 以降の機能です。 バージョン 12.109.0 以降の機能です。
::: :::
:::warning :::warning
実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。 実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。
::: :::
MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。 MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。

4
content/fr/docs/2.for-users/4.resources/1.troubleshooting.md
View File

@ -5,7 +5,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ
# トラブルシューティング # トラブルシューティング
:::tip :::tip
[よくある質問](./faq.md)も合わせてお役立てください。 [よくある質問](./faq.md)も合わせてお役立てください。
::: :::
問題が発生したときは、まずこちらをご確認ください。 問題が発生したときは、まずこちらをご確認ください。
@ -59,7 +61,9 @@ description: 問題が発生したときは、まずこちらをご確認くだ
クライアントの設定の「キャッシュをクリア」すると直ります。 クライアントの設定の「キャッシュをクリア」すると直ります。
:::warning :::warning
「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。 「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。
::: :::
## 通知やアンテナ等の点滅が消えない ## 通知やアンテナ等の点滅が消えない

9
content/fr/docs/2.for-users/4.resources/donate.md
View File

@ -13,22 +13,27 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は
- [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share)
:::tip :::tip
高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。
::: :::
:::tip :::tip
額に応じて以下の返礼を用意しています。 額に応じて以下の返礼を用意しています。
- 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与
- 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載 - 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載
- 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載 - 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載
::: :::
:::warning :::warning
:::warning
**バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。** **バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。**
(メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります) (メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります)
:::
::: :::
また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。 また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。

2
content/fr/docs/2.for-users/4.resources/misskey-hub.md
View File

@ -6,7 +6,9 @@ Misskey Hubは、Misskeyに関するナレッジなどのドキュメント、
Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub) Misskey Hubも[オープンソースで公開されています。](https://github.com/misskey-dev/misskey-hub)
:::tip :::tip
Misskey HubはNuxtを使ってビルドされた静的サイトです。 Misskey HubはNuxtを使ってビルドされた静的サイトです。
::: :::
## Misskey Hubに貢献する ## Misskey Hubに貢献する

2
content/fr/docs/3.for-admin/features/announcement.md
View File

@ -5,11 +5,13 @@
お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。 お知らせ機能を使用すると、ユーザーにサーバー全体のお知らせを掲示することができるほか、ユーザー個別にサーバーからのメッセージを送ることができます。
:::warning :::warning
アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。 アクティブなお知らせの数が多いと、特に新規ユーザーの確認作業が増え、UXが低下する可能性があります。その場合、以下のオプションを検討できます。
- 「既存ユーザーのみ」オプションを有効にしてお知らせを作成する - 「既存ユーザーのみ」オプションを有効にしてお知らせを作成する
- 「非通知」オプションを有効にしてお知らせを作成する - 「非通知」オプションを有効にしてお知らせを作成する
- 終了したお知らせはアーカイブする - 終了したお知らせはアーカイブする
::: :::
## 表示形式 ## 表示形式

10
content/fr/docs/3.for-admin/features/role.md
View File

@ -21,10 +21,12 @@
- **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール) - **コンディショナル** ... 条件を設定し、それに合致するユーザーが自動で含まれるようになります。(コンディショナル ロール)
:::warning :::warning
コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。 コンディショナル ロールは、マニュアル ロールと比較して以下の制限があります。
- 手動でのアサイン/アサイン解除は行えません。 - 手動でのアサイン/アサイン解除は行えません。
- 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。 - 指定したコンディショナル ロールに含まれるユーザー一覧を取得することはできません。
::: :::
## 権限 ## 権限
@ -53,6 +55,7 @@
**優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。** **優先度が同じ場合、デフォルトで最も大きい、または最も権限が広い値が選択されます。**
:::tip :::tip
例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、 例えば、ユーザーにロールAとロールBがアサインされていて、ロールAのドライブ容量ポリシーが 500MB、ロールBのドライブ容量ポリシーが 300MB に定義されている場合、
- 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。 - 優先度が同じ、もしくはロールAのドライブ容量ポリシーの優先度の方が高い場合 500MB の値が採用されます。
@ -62,6 +65,7 @@
- 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。 - 優先度が同じ、もしくはロールDのパブリック投稿可否ポリシーの優先度の方が高い場合「はい」の値が採用されます。
- ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。 - ロールCのパブリック投稿可否ポリシーの優先度の方が高い場合「いいえ」の値が採用されます。
::: :::
### ベースロールの値を使用 ### ベースロールの値を使用
@ -85,13 +89,15 @@
アサインする際にアサインされる期間を設定することが可能です。 アサインする際にアサインされる期間を設定することが可能です。
:::tip :::tip
:::tip
ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。 ロールのアサイン/アサイン解除が反映されるまで時間がかかることがあります。
:::
::: :::
:::warning :::warning
コンディショナル ロールには手動でのアサインはできません。 コンディショナル ロールには手動でのアサインはできません。
::: :::
## ユーザーのポリシーの確認 ## ユーザーのポリシーの確認

4
content/fr/docs/3.for-admin/install/guides/1.index.md
View File

@ -7,15 +7,19 @@ description: Misskeyサーバーの作成方法についての案内です。
Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。 Misskeyサーバーの構築に関心をお寄せいただきありがとうございます。サーバーの作成方法はいくつかあるので、下記から選んでガイドをお読みください。
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
::: :::
:::warning :::warning
自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。 自分のサーバーに対して Cloudflare を使用する場合、 Auto Minify 設定は使用しないようにしてください。
Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。 Misskeyのソースコードは既にMinifyされているため意味がないばかりでなく、Cloudflare が最新の JavaScript を解釈せず、中のソースコードを破壊するため、Misskey が正常に動作しません。
詳しくは [misskey-dev/misskey #9791](https://github.com/misskey-dev/misskey/issues/9791) をご覧ください。 詳しくは [misskey-dev/misskey #9791](https://github.com/misskey-dev/misskey/issues/9791) をご覧ください。
::: :::
## Xserver VPSでインストール ## Xserver VPSでインストール

17
content/fr/docs/3.for-admin/install/guides/bash.md
View File

@ -20,7 +20,9 @@ Misskeyを簡単にインストールするためのシェルスクリプトが
3. Cloudflareアカウント（推奨） 3. Cloudflareアカウント（推奨）
:::danger :::danger
一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！ 一度使用を始めたサーバーのドメイン・ホスト名では、データベースを作り直さないでください！
::: :::
Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。 Let's Encryptの認証を試行できる回数が少ないので、サーバーのネットワークやDNSの設定を十分確認してからインストールを開始してください。
@ -28,7 +30,6 @@ Let's Encryptの認証を試行できる回数が少ないので、サーバー
## Cloudflareの設定 ## Cloudflareの設定
Cloudflareを使う場合、Cloudflareのドメインの設定を完了してからインストールを開始するようにしてください。\ Cloudflareを使う場合、Cloudflareのドメインの設定を完了してからインストールを開始するようにしてください。\
\
ネームサーバーの適用には最大で3日程度かかる場合があります。 ネームサーバーの適用には最大で3日程度かかる場合があります。
また、nginxとCloudflareを設定する場合、Cloudflareの設定画面にて、 また、nginxとCloudflareを設定する場合、Cloudflareの設定画面にて、
@ -41,7 +42,6 @@ Cloudflareを使う場合、Cloudflareのドメインの設定を完了してか
### 1. SSH ### 1. SSH
サーバーにSSH接続します。\ サーバーにSSH接続します。\
\
（サーバーのデスクトップを開いている方はシェルを開きましょう。） （サーバーのデスクトップを開いている方はシェルを開きましょう。）
### 2. 環境を最新にする ### 2. 環境を最新にする
@ -113,13 +113,10 @@ iptablesを使うようにしてください。
v1から、インストールメソッドにsystemdとDockerとを選べるようにしました。 v1から、インストールメソッドにsystemdとDockerとを選べるようにしました。
Dockerと言っても、**MisskeyだけをDockerで実行**し、RedisやPostgresなどはホストで直接実行します。\ Dockerと言っても、**MisskeyだけをDockerで実行**し、RedisやPostgresなどはホストで直接実行します。\
\
[docker-composeですべての機能を動かす方法については、mamemonongaさんが作成したこちらの記事がおすすめです。](https://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0) [docker-composeですべての機能を動かす方法については、mamemonongaさんが作成したこちらの記事がおすすめです。](https://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0)
Docker Hubイメージを使う設定であれば、Misskeyのビルドが不要になるため、**一番お勧めです**。\ Docker Hubイメージを使う設定であれば、Misskeyのビルドが不要になるため、**一番お勧めです**。\
\
ただし、マイグレーションは必要なので、アップデート時にMisskeyを使えない時間がゼロになるわけではありません。\ ただし、マイグレーションは必要なので、アップデート時にMisskeyを使えない時間がゼロになるわけではありません。\
\
また、Misskeyのビルド環境を準備しない(git pullしない)ので、フォークを動かしたくなった時に設定が面倒になります。 また、Misskeyのビルド環境を準備しない(git pullしない)ので、フォークを動かしたくなった時に設定が面倒になります。
ローカルでDockerをビルドする方式は、パフォーマンス面で非推奨です。 ローカルでDockerをビルドする方式は、パフォーマンス面で非推奨です。
@ -147,14 +144,12 @@ systemdは、Docker Hubにイメージを上げるまでもないものの、フ
万が一途中で失敗してもう一度スクリプトを動作させる場合、次のことに注意してください。 万が一途中で失敗してもう一度スクリプトを動作させる場合、次のことに注意してください。
- RedisやPostgresのインストールが終わっている場合、「install locally」はNoにしてください。\ - RedisやPostgresのインストールが終わっている場合、「install locally」はNoにしてください。\
\
host・port設定はそのままEnterを押します。 host・port設定はそのままEnterを押します。
ユーザー名やパスワードは、前回実行した際に指定したものを入力します。 ユーザー名やパスワードは、前回実行した際に指定したものを入力します。
## .envファイルについて ## .envファイルについて
インストールスクリプトは、2つの.envファイルを作成します。\ インストールスクリプトは、2つの.envファイルを作成します。\
\
アップデートの際に使用します。 アップデートの際に使用します。
### /root/.misskey.env ### /root/.misskey.env
@ -165,14 +160,12 @@ misskeyを実行するユーザーを覚えておくために必要です。
systemdの場合に生成されます。\ systemdの場合に生成されます。\
\ \
主にディレクトリを覚えておくのに使用します。 実行されているコンテナとイメージの番号を保存しています。
### /home/(misskeyユーザー)/.misskey-docker.env ### /home/(misskeyユーザー)/.misskey-docker.env
Dockerの場合に生成されます。\ Dockerの場合に生成されます。\
\
実行されているコンテナとイメージの番号を保存しています。\ 実行されているコンテナとイメージの番号を保存しています。\
\
コンテナの番号はアップデートの際に更新されます。古いイメージは削除されます。 コンテナの番号はアップデートの際に更新されます。古いイメージは削除されます。
## 自分で管理する ## 自分で管理する
@ -184,7 +177,6 @@ Dockerの場合に生成されます。\
### Misskeyディレクトリ ### Misskeyディレクトリ
Misskeyのソースは`/home/ユーザー/ディレクトリ`としてcloneされます。\ Misskeyのソースは`/home/ユーザー/ディレクトリ`としてcloneされます。\
\
（ユーザー、ディレクトリの初期値はともにmisskeyです。） （ユーザー、ディレクトリの初期値はともにmisskeyです。）
Misskeyディレクトリへは、以下のように移動するとよいでしょう。 Misskeyディレクトリへは、以下のように移動するとよいでしょう。
@ -203,7 +195,6 @@ exit
### systemd ### systemd
systemdのプロセス名はexample.comです。\ systemdのプロセス名はexample.comです。\
\
たとえば再起動するには次のようにします。 たとえば再起動するには次のようにします。
``` ```
@ -259,7 +250,6 @@ requirepassとbindを`/etc/redis/misskey.conf`で設定しています。
## Q. アップデート後に502でアクセスできない ## Q. アップデート後に502でアクセスできない
Dockerでは、起動後にマイグレーションをするため、すぐにアクセスできません。\ Dockerでは、起動後にマイグレーションをするため、すぐにアクセスできません。\
\
マイグレーションが終わっているかどうか確認してみてください。 マイグレーションが終わっているかどうか確認してみてください。
systemdの場合では、pnpm installに失敗している可能性があります。 systemdの場合では、pnpm installに失敗している可能性があります。
@ -275,5 +265,4 @@ journalctlでログを確認すると、たいていre2が云々という記述
## Q. 同じサーバーにもう1つMisskeyを建てたい ## Q. 同じサーバーにもう1つMisskeyを建てたい
スクリプトは同じサーバーに追加でMisskeyをインストールすることは想定していません。\ スクリプトは同じサーバーに追加でMisskeyをインストールすることは想定していません。\
\
幾つかの設定が上書きされるか、途中でエラーになってしまうでしょう。 幾つかの設定が上書きされるか、途中でエラーになってしまうでしょう。

Some files were not shown because too many files have changed in this diff Show More