To read about acquiring such credentials, please refer to this document.
@@ -166,7 +166,7 @@ Here,
Misskey provides a structure called Post capturing".This structure makes it possible to receive events about a targeted post from the stream.
-For example, to fetch and display a timeline to a user.Imagine that someone reacts to a post on this timeline.
+For example, assume a situation in which a timeline is displayed to a user.Imagine that someone reacts to a post on this timeline.
Since the client does not have any way of knowing that a certain post has received a reaction, it is not possible to reflect the reaction on this post in real-time.
diff --git a/src/docs/id-ID/aiscript.md b/src/docs/id-ID/aiscript.md
new file mode 100644
index 0000000000..6c28b446e3
--- /dev/null
+++ b/src/docs/id-ID/aiscript.md
@@ -0,0 +1,4 @@
+# AiScript
+
+## 関数
+デフォルトで値渡しです。
diff --git a/src/docs/id-ID/api.md b/src/docs/id-ID/api.md
new file mode 100644
index 0000000000..76019b6145
--- /dev/null
+++ b/src/docs/id-ID/api.md
@@ -0,0 +1,58 @@
+# Misskey API
+
+MisskeyAPIを使ってMisskeyクライアント、Misskey連携Webサービス、Bot等(以下「アプリケーション」と呼びます)を開発できます。 ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。
+
+APIを使い始めるには、まずアクセストークンを取得する必要があります。 このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。
+
+## アクセストークンの取得
+基本的に、APIはリクエストにはアクセストークンが必要となります。 APIにリクエストするのが自分自身なのか、不特定の利用者に使ってもらうアプリケーションなのかによって取得手順は異なります。
+
+* 前者の場合: [「自分自身のアクセストークンを手動発行する」](#自分自身のアクセストークンを手動発行する)に進む
+* 後者の場合: [「アプリケーション利用者にアクセストークンの発行をリクエストする」](#アプリケーション利用者にアクセストークンの発行をリクエストする)に進む
+
+### 自分自身のアクセストークンを手動発行する
+「設定 > API」で、自分のアクセストークンを発行できます。
+
+[「APIの使い方」へ進む](#APIの使い方)
+
+### アプリケーション利用者にアクセストークンの発行をリクエストする
+アプリケーション利用者のアクセストークンを取得するには、以下の手順で発行をリクエストします。
+
+#### Step 1
+
+UUIDを生成する。以後これをセッションIDと呼びます。
+
+> このセッションIDは毎回生成し、使いまわさないようにしてください。
+
+#### Step 2
+
+`{_URL_}/miauth/{session}`をユーザーのブラウザで表示させる。`{session}`の部分は、セッションIDに置き換えてください。
+> 例: `{_URL_}/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f`
+
+表示する際、URLにクエリパラメータとしていくつかのオプションを設定できます:
+* `name` ... アプリケーション名
+ * > 例: `MissDeck`
+* `icon` ... アプリケーションのアイコン画像URL
+ * > 例: `https://missdeck.example.com/icon.png`
+* `callback` ... 認証が終わった後にリダイレクトするURL
+ * > 例: `https://missdeck.example.com/callback`
+ * リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます
+* `permission` ... アプリケーションが要求する権限
+ * > 例: `write:notes,write:following,read:drive`
+ * 要求する権限を`,`で区切って列挙します
+ * どのような権限があるかは[APIリファレンス](/api-doc)で確認できます
+
+#### Step 3
+ユーザーが発行を許可した後、`{_URL_}/api/miauth/{session}/check`にPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。
+
+レスポンスに含まれるプロパティ:
+* `token` ... ユーザーのアクセストークン
+* `user` ... ユーザーの情報
+
+[「APIの使い方」へ進む](#APIの使い方)
+
+## APIの使い方
+**APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です。RESTではありません。** アクセストークンは、`i`というパラメータ名でリクエストに含めます。
+
+* [APIリファレンス](/api-doc)
+* [ストリーミングAPI](./stream)
diff --git a/src/docs/id-ID/create-plugin.md b/src/docs/id-ID/create-plugin.md
new file mode 100644
index 0000000000..0d2fa19178
--- /dev/null
+++ b/src/docs/id-ID/create-plugin.md
@@ -0,0 +1,74 @@
+# プラグインの作成
+Misskey Webクライアントのプラグイン機能を使うと、クライアントを拡張し、様々な機能を追加できます。 ここではプラグインの作成にあたってのメタデータ定義や、AiScript APIリファレンスを掲載します。
+
+## メタデータ
+プラグインは、AiScriptのメタデータ埋め込み機能を使って、デフォルトとしてプラグインのメタデータを定義する必要があります。 メタデータは次のプロパティを含むオブジェクトです。
+
+### name
+プラグイン名
+
+### author
+プラグイン作者
+
+### version
+プラグインバージョン。数値を指定してください。
+
+### description
+プラグインの説明
+
+### permissions
+プラグインが要求する権限。MisskeyAPIにリクエストする際に用いられます。
+
+### config
+プラグインの設定情報を表すオブジェクト。 キーに設定名、値に以下のプロパティを含めます。
+
+#### type
+設定値の種類を表す文字列。以下から選択します。 string number boolean
+
+#### label
+ユーザーに表示する設定名
+
+#### description
+設定の説明
+
+#### default
+設定のデフォルト値
+
+## APIリファレンス
+AiScript標準で組み込まれているAPIは掲載しません。
+
+### Mk:dialog(title text type)
+ダイアログを表示します。typeには以下の値が設定できます。 info success warn error question 省略すると info になります。
+
+### Mk:confirm(title text type)
+確認ダイアログを表示します。typeには以下の値が設定できます。 info success warn error question 省略すると question になります。 ユーザーが"OK"を選択した場合は true を、"キャンセル"を選択した場合は false が返ります。
+
+### Mk:api(endpoint params)
+Misskey APIにリクエストします。第一引数にエンドポイント名、第二引数にパラメータオブジェクトを渡します。
+
+### Mk:save(key value)
+任意の値に任意の名前を付けて永続化します。永続化した値は、AiScriptコンテキストが終了しても残り、Mk:loadで読み取ることができます。
+
+### Mk:load(key)
+Mk:saveで永続化した指定の名前の値を読み取ります。
+
+### Plugin:register_post_form_action(title fn)
+投稿フォームにアクションを追加します。第一引数にアクション名、第二引数にアクションが選択された際のコールバック関数を渡します。 コールバック関数には、第一引数に投稿フォームオブジェクトが渡されます。
+
+### Plugin:register_note_action(title fn)
+ノートメニューに項目を追加します。第一引数に項目名、第二引数に項目が選択された際のコールバック関数を渡します。 コールバック関数には、第一引数に対象のノートオブジェクトが渡されます。
+
+### Plugin:register_user_action(title fn)
+ユーザーメニューに項目を追加します。第一引数に項目名、第二引数に項目が選択された際のコールバック関数を渡します。 コールバック関数には、第一引数に対象のユーザーオブジェクトが渡されます。
+
+### Plugin:register_note_view_interruptor(fn)
+UIに表示されるノート情報を書き換えます。 コールバック関数には、第一引数に対象のノートオブジェクトが渡されます。 コールバック関数の返り値でノートが書き換えられます。
+
+### Plugin:register_note_post_interruptor(fn)
+ノート投稿時にノート情報を書き換えます。 コールバック関数には、第一引数に対象のノートオブジェクトが渡されます。 コールバック関数の返り値でノートが書き換えられます。
+
+### Plugin:open_url(url)
+第一引数に渡されたURLをブラウザの新しいタブで開きます。
+
+### Plugin:config
+プラグインの設定が格納されるオブジェクト。プラグイン定義のconfigで設定したキーで値が入ります。
diff --git a/src/docs/id-ID/custom-emoji.md b/src/docs/id-ID/custom-emoji.md
new file mode 100644
index 0000000000..7a509195e7
--- /dev/null
+++ b/src/docs/id-ID/custom-emoji.md
@@ -0,0 +1,2 @@
+# Emoji kustom
+カスタム絵文字は、インスタンスで用意された画像を絵文字のように使える機能です。 ノート、リアクション、チャット、自己紹介、名前などの場所で使うことができます。 カスタム絵文字をそれらの場所で使うには、絵文字ピッカーボタン(ある場合)を押すか、`:`を入力して絵文字サジェストを表示します。 テキスト内に`:foo:`のような形式の文字列が見つかると、`foo`の部分がカスタム絵文字名と解釈され、表示時には対応したカスタム絵文字に置き換わります。
diff --git a/src/docs/id-ID/deck.md b/src/docs/id-ID/deck.md
new file mode 100644
index 0000000000..8057e262fd
--- /dev/null
+++ b/src/docs/id-ID/deck.md
@@ -0,0 +1,18 @@
+# デッキ
+
+デッキは利用可能なUIのひとつです。「カラム」と呼ばれるビューを複数並べて表示させることで、カスタマイズ性が高く、情報量の多いUIが構築できることが特徴です。
+
+## カラムの追加
+デッキの背景を右クリックし、「カラムを追加」して任意のカラムを追加できます。
+
+## カラムの移動
+カラムは、ドラッグアンドドロップで他のカラムと位置を入れ替えることが出来るほか、カラムメニュー(カラムのヘッダー右クリック)から位置を移動させることもできます。
+
+## カラムの水平分割
+カラムは左右だけでなく、上下に並べることもできます。 カラムメニューを開き、「左に重ねる」を選択すると、左のカラムの下に現在のカラムが移動します。 上下分割を解除するには、カラムメニューの「右に出す」を選択します。
+
+## カラムの設定
+カラムメニューの「編集」を選択するとカラムの設定を編集できます。カラムの名前を変えたり、幅を変えたりできます。
+
+## デッキの設定
+デッキに関する設定は、[settings/deck](/settings/deck)で行えます。
diff --git a/src/docs/id-ID/follow.md b/src/docs/id-ID/follow.md
new file mode 100644
index 0000000000..3c1ea7bbe0
--- /dev/null
+++ b/src/docs/id-ID/follow.md
@@ -0,0 +1,2 @@
+# フォロー
+ユーザーをフォローすると、タイムラインにそのユーザーの投稿が表示されるようになります。ただし、他のユーザーに対する返信は含まれません。 ユーザーをフォローするには、ユーザーページの「フォロー」ボタンをクリックします。フォローを解除するには、もう一度クリックします。
diff --git a/src/docs/id-ID/keyboard-shortcut.md b/src/docs/id-ID/keyboard-shortcut.md
new file mode 100644
index 0000000000..3815862afe
--- /dev/null
+++ b/src/docs/id-ID/keyboard-shortcut.md
@@ -0,0 +1,68 @@
+# キーボードショートカット
+
+## グローバル
+これらのショートカットは基本的にどこでも使えます。
+
+
+ | ショートカット | 効果 | 由来 |
|---|
+
+
+ | P, N | 新規投稿 | Post, New, Note |
+ | T | タイムラインの最も新しい投稿にフォーカス | Timeline, Top |
+ | Shift + N | 通知を表示/隠す | Notifications |
+ | S | Pencarian | Search |
+ | H, ? | ヘルプを表示 | Help |
+
+
+
+## 投稿にフォーカスされた状態
+
+
+
+ | ショートカット | 効果 | 由来 |
|---|
+
+
+ | ↑, K, Shift + Tab | 上の投稿にフォーカスを移動 | - |
+ | ↓, J, Tab | 下の投稿にフォーカスを移動 | - |
+ | R | 返信フォームを開く | Reply |
+ | Q | Renoteフォームを開く | Quote |
+ | Ctrl + Q | 即刻Renoteする(フォームを開かずに) | - |
+ | E, A, + | リアクションフォームを開く | Emote, reAction |
+ | 0~9 | 数字に対応したリアクションをする(対応については後述) | - |
+ | F, B | お気に入りに登録 | Favorite, Bookmark |
+ | Del, Ctrl + D | 投稿を削除 | Delete |
+ | M, O | 投稿に対するメニューを開く | More, Other |
+ | S | CWで隠された部分を表示 or 隠す | Show, See |
+ | Esc | フォーカスを外す | - |
+
+
+
+## Renoteフォーム
+
+
+
+ | ショートカット | 効果 | 由来 |
|---|
+
+
+ | Enter | Renoteする | - |
+ | Q | フォームを展開する | Quote |
+ | Esc | フォームを閉じる | - |
+
+
+
+## リアクションフォーム
+デフォルトで「👍」にフォーカスが当たっている状態です。
+
+
+ | ショートカット | 効果 | 由来 |
|---|
+
+
+ | ↑, K | 上のリアクションにフォーカスを移動 | - |
+ | ↓, J | 下のリアクションにフォーカスを移動 | - |
+ | ←, H, Shift + Tab | 左のリアクションにフォーカスを移動 | - |
+ | →, L, Tab | 右のリアクションにフォーカスを移動 | - |
+ | Enter, Space, + | リアクション確定 | - |
+ | 0~9 | 数字に対応したリアクションで確定 | - |
+ | Esc | リアクションするのをやめる | - |
+
+
diff --git a/src/docs/id-ID/mfm.md b/src/docs/id-ID/mfm.md
new file mode 100644
index 0000000000..e237287acc
--- /dev/null
+++ b/src/docs/id-ID/mfm.md
@@ -0,0 +1,2 @@
+# MFM
+MFMは、Misskey Flavored Markdownの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。 MFMで使用可能な構文は[MFMチートシート](/mfm-cheat-sheet)で確認できます。
diff --git a/src/docs/id-ID/mute.md b/src/docs/id-ID/mute.md
new file mode 100644
index 0000000000..66f717a4f1
--- /dev/null
+++ b/src/docs/id-ID/mute.md
@@ -0,0 +1,13 @@
+# Bisukan
+
+ユーザーをミュートすると、そのユーザーに関する次のコンテンツがMisskeyに表示されなくなります:
+
+* タイムラインや投稿の検索結果内の、そのユーザーの投稿(およびそれらの投稿に対する返信やRenote)
+* そのユーザーからの通知
+* メッセージ履歴一覧内の、そのユーザーとのメッセージ履歴
+
+ユーザーをミュートするには、対象のユーザーのユーザーページに表示されている「ミュート」ボタンを押します。
+
+ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。
+
+設定>ミュート から、自分がミュートしているユーザー一覧を確認することができます。
diff --git a/src/docs/id-ID/pages.md b/src/docs/id-ID/pages.md
new file mode 100644
index 0000000000..a7311b95e6
--- /dev/null
+++ b/src/docs/id-ID/pages.md
@@ -0,0 +1,10 @@
+# Pages
+
+## 変数
+変数を使うことで動的なページを作成できます。テキスト内で
{ 変数名 } と書くとそこに変数の値を埋め込めます。例えば
Hello { thing } world! というテキストで、変数(thing)の値が
ai だった場合、テキストは
Hello ai world! になります。
+
+変数の評価(値を算出すること)は上から下に行われるので、ある変数の中で自分より下の変数を参照することはできません。例えば上から
A、B、C と3つの変数を定義したとき、
Cの中で
Aや
Bを参照することはできますが、
Aの中で
Bや
Cを参照することはできません。
+
+ユーザーからの入力を受け取るには、ページに「ユーザー入力」ブロックを設置し、「変数名」に入力を格納したい変数名を設定します(変数は自動で作成されます)。その変数を使ってユーザー入力に応じた動作を行えます。
+
+関数を使うと、値の算出処理を再利用可能な形にまとめることができます。関数を作るには、「関数」タイプの変数を作成します。関数にはスロット(引数)を設定することができ、スロットの値は関数内で変数として利用可能です。また、関数を引数に取る関数(高階関数と呼ばれます)も存在します。関数は予め定義しておくほかに、このような高階関数のスロットに即席でセットすることもできます。
diff --git a/src/docs/id-ID/reaction.md b/src/docs/id-ID/reaction.md
new file mode 100644
index 0000000000..79952a7b0a
--- /dev/null
+++ b/src/docs/id-ID/reaction.md
@@ -0,0 +1,11 @@
+# Reaksi
+他の人のノートに、絵文字を付けて簡単にあなたの反応を伝えられる機能です。 リアクションするには、ノートの + アイコンをクリックしてピッカーを表示し、絵文字を選択します。 リアクションには[カスタム絵文字](./custom-emoji)も使用できます。
+
+## リアクションピッカーのカスタマイズ
+ピッカーに表示される絵文字を自分好みにカスタマイズすることができます。 設定の「リアクション」で設定します。
+
+## リモート投稿へのリアクションについて
+リアクションはMisskeyオリジナルの機能であるため、リモートインスタンスがMisskeyでない限りは、ほとんどの場合「Like」としてアクティビティが送信されます。一般的にはLikeは「お気に入り」として実装されているようです。 また、相手がMisskeyであったとしても、カスタム絵文字リアクションは伝わらず、自動的に「👍」等にフォールバックされます。
+
+## リモートからのリアクションについて
+リモートから「Like」アクティビティを受信したとき、Misskeyでは「👍」のリアクションとして解釈されます。
diff --git a/src/docs/id-ID/reversi-bot.md b/src/docs/id-ID/reversi-bot.md
new file mode 100644
index 0000000000..7ab2a7212e
--- /dev/null
+++ b/src/docs/id-ID/reversi-bot.md
@@ -0,0 +1,160 @@
+# MisskeyリバーシBotの開発
+Misskeyのリバーシ機能に対応したBotの開発方法をここに記します。
+
+1. `games/reversi`ストリームに以下のパラメータを付けて接続する:
+ * `i`: botアカウントのAPIキー
+
+2. 対局への招待が来たら、ストリームから`invited`イベントが流れてくる
+ * イベントの中身に、`parent`という名前で対局へ誘ってきたユーザーの情報が含まれている
+
+3. `games/reversi/match`へ、`user_id`として`parent`の`id`が含まれたリクエストを送信する
+
+4. 上手くいくとゲーム情報が返ってくるので、`games/reversi-game`ストリームへ、以下のパラメータを付けて接続する:
+ * `i`: botアカウントのAPIキー
+ * `game`: `game`の`id`
+
+5. この間、相手がゲームの設定を変更するとその都度`update-settings`イベントが流れてくるので、必要であれば何かしらの処理を行う
+
+6. 設定に満足したら、`{ type: 'accept' }`メッセージをストリームに送信する
+
+7. ゲームが開始すると、`started`イベントが流れてくる
+ * イベントの中身にはゲーム情報が含まれている
+
+8. 石を打つには、ストリームに`{ type: 'set', pos: <位置> }`を送信する(位置の計算方法は後述)
+
+9. 相手または自分が石を打つと、ストリームから`set`イベントが流れてくる
+ * `color`として石の色が含まれている
+ * `pos`として位置情報が含まれている
+
+## 位置の計算法
+8x8のマップを考える場合、各マスの位置(インデックスと呼びます)は次のようになっています:
+```
++--+--+--+--+--+--+--+--+
+| 0| 1| 2| 3| 4| 5| 6| 7|
++--+--+--+--+--+--+--+--+
+| 8| 9|10|11|12|13|14|15|
++--+--+--+--+--+--+--+--+
+|16|17|18|19|20|21|22|23|
+...
+```
+
+### X,Y座標 から インデックス に変換する
+```
+pos = x + (y * mapWidth)
+```
+`mapWidth`は、ゲーム情報の`map`から、次のようにして計算できます:
+```
+mapWidth = map[0].length
+```
+
+### インデックス から X,Y座標 に変換する
+```
+x = pos % mapWidth
+y = Math.floor(pos / mapWidth)
+```
+
+## マップ情報
+マップ情報は、ゲーム情報の`map`に入っています。 文字列の配列になっており、ひとつひとつの文字がマス情報を表しています。 それをもとにマップのデザインを知る事が出来ます:
+* `(スペース)` ... マス無し
+* `-` ... マス
+* `b` ... 初期配置される黒石
+* `w` ... 初期配置される白石
+
+例えば、4*4の次のような単純なマップがあるとします:
+```text
++---+---+---+---+
+| | | | |
++---+---+---+---+
+| | ○ | ● | |
++---+---+---+---+
+| | ● | ○ | |
++---+---+---+---+
+| | | | |
++---+---+---+---+
+```
+
+この場合、マップデータはこのようになります:
+```javascript
+['----', '-wb-', '-bw-', '----']
+```
+
+## ユーザーにフォームを提示して対話可能Botを作成する
+ユーザーとのコミュニケーションを行うため、ゲームの設定画面でユーザーにフォームを提示することができます。 例えば、Botの強さをユーザーが設定できるようにする、といったシナリオが考えられます。
+
+フォームを提示するには、`reversi-game`ストリームに次のメッセージを送信します:
+```javascript
+{
+ type: 'init-form',
+ body: [フォームコントロールの配列]
+}
+```
+
+フォームコントロールの配列については今から説明します。 フォームコントロールは、次のようなオブジェクトです:
+```javascript
+{
+ id: 'switch1',
+ type: 'switch',
+ label: 'Enable hoge',
+ value: false
+}
+```
+`id` ... コントロールのID。 `type` ... コントロールの種類。後述します。 `label` ... コントロールと一緒に表記するテキスト。 `value` ... コントロールのデフォルト値。
+
+### フォームの操作を受け取る
+ユーザーがフォームを操作すると、ストリームから`update-form`イベントが流れてきます。 イベントの中身には、コントロールのIDと、ユーザーが設定した値が含まれています。 例えば、上で示したスイッチをユーザーがオンにしたとすると、次のイベントが流れてきます:
+```javascript
+{
+ id: 'switch1',
+ value: true
+}
+```
+
+### フォームコントロールの種類
+#### スイッチ
+type: `switch` スイッチを表示します。何かの機能をオン/オフさせたい場合に有用です。
+
+##### プロパティ
+`label` ... スイッチに表記するテキスト。
+
+#### ラジオボタン
+type: `radio` ラジオボタンを表示します。選択肢を提示するのに有用です。例えば、Botの強さを設定させるなどです。
+
+##### プロパティ
+`items` ... ラジオボタンの選択肢。例:
+```javascript
+items: [{
+ label: '弱',
+ value: 1
+}, {
+ label: '中',
+ value: 2
+}, {
+ label: '強',
+ value: 3
+}]
+```
+
+#### スライダー
+type: `slider` スライダーを表示します。
+
+##### プロパティ
+`min` ... スライダーの下限。 `max` ... スライダーの上限。 `step` ... 入力欄で刻むステップ値。
+
+#### テキストボックス
+type: `textbox` テキストボックスを表示します。ユーザーになにか入力させる一般的な用途に利用できます。
+
+## ユーザーにメッセージを表示する
+設定画面でユーザーと対話する、フォーム以外のもうひとつの方法がこれです。ユーザーになにかメッセージを表示することができます。 例えば、ユーザーがBotの対応していないモードやマップを選択したとき、警告を表示するなどです。 メッセージを表示するには、次のメッセージをストリームに送信します:
+```javascript
+{
+ type: 'message',
+ body: {
+ text: 'メッセージ内容',
+ type: 'メッセージの種類'
+ }
+}
+```
+メッセージの種類: `success`, `info`, `warning`, `error`。
+
+## 投了する
+投了をするには、
このエンドポイントにリクエストします。
diff --git a/src/docs/id-ID/stream.md b/src/docs/id-ID/stream.md
new file mode 100644
index 0000000000..9011c37c5b
--- /dev/null
+++ b/src/docs/id-ID/stream.md
@@ -0,0 +1,354 @@
+# ストリーミングAPI
+
+ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、メッセージが届いた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。
+
+## ストリームに接続する
+
+ストリーミングAPIを利用するには、まずMisskeyサーバーに**websocket**接続する必要があります。
+
+以下のURLに、`i`というパラメータ名で認証情報を含めて、websocket接続してください。例:
+```
+%WS_URL%/streaming?i=xxxxxxxxxxxxxxx
+```
+
+認証情報は、自分のAPIキーや、アプリケーションからストリームに接続する際はユーザーのアクセストークンのことを指します。
+
+
+
+---
+
+認証情報は省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。例:
+
+```
+%WS_URL%/streaming
+```
+
+---
+
+ストリームに接続すると、後述するAPI操作や、投稿の購読を行ったりすることができます。 しかしまだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。 それを行うには、ストリーム上で、後述する**チャンネル**に接続する必要があります。
+
+**ストリームでのやり取りはすべてJSONです。**
+
+## チャンネル
+MisskeyのストリーミングAPIにはチャンネルという概念があります。これは、送受信する情報を分離するための仕組みです。 Misskeyのストリームに接続しただけでは、まだリアルタイムでタイムラインの投稿を受信したりはできません。 ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。
+
+### チャンネルに接続する
+チャンネルに接続するには、次のようなデータをJSONでストリームに送信します:
+
+```json
+{
+ type: 'connect',
+ body: {
+ channel: 'xxxxxxxx',
+ id: 'foobar',
+ params: {
+ ...
+ }
+ }
+}
+```
+
+ここで、
+* `channel`には接続したいチャンネル名を設定します。チャンネルの種類については後述します。
+* `id`にはそのチャンネルとやり取りするための任意のIDを設定します。ストリームでは様々なメッセージが流れるので、そのメッセージがどのチャンネルからのものなのか識別する必要があるからです。このIDは、UUIDや、乱数のようなもので構いません。
+* `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。
+
+
+
IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。
+
+
+### チャンネルからのメッセージを受け取る
+例えばタイムラインのチャンネルなら、新しい投稿があった時にメッセージを発します。そのメッセージを受け取ることで、タイムラインに新しい投稿がされたことをリアルタイムで知ることができます。
+
+チャンネルがメッセージを発すると、次のようなデータがJSONでストリームに流れてきます:
+```json
+{
+ type: 'channel',
+ body: {
+ id: 'foobar',
+ type: 'something',
+ body: {
+ some: 'thing'
+ }
+ }
+}
+```
+
+ここで、
+* `id`には前述したそのチャンネルに接続する際に設定したIDが設定されています。これで、このメッセージがどのチャンネルからのものなのか知ることができます。
+* `type`にはメッセージの種類が設定されます。チャンネルによって、どのような種類のメッセージが流れてくるかは異なります。
+* `body`にはメッセージの内容が設定されます。チャンネルによって、どのような内容のメッセージが流れてくるかは異なります。
+
+### チャンネルに向けてメッセージを送信する
+チャンネルによっては、メッセージを受け取るだけでなく、こちらから何かメッセージを送信し、何らかの操作を行える場合があります。
+
+チャンネルにメッセージを送信するには、次のようなデータをJSONでストリームに送信します:
+```json
+{
+ type: 'channel',
+ body: {
+ id: 'foobar',
+ type: 'something',
+ body: {
+ some: 'thing'
+ }
+ }
+}
+```
+
+ここで、
+* `id`には前述したそのチャンネルに接続する際に設定したIDを設定します。これで、このメッセージがどのチャンネルに向けたものなのか識別させることができます。
+* `type`にはメッセージの種類を設定します。チャンネルによって、どのような種類のメッセージを受け付けるかは異なります。
+* `body`にはメッセージの内容を設定します。チャンネルによって、どのような内容のメッセージを受け付けるかは異なります。
+
+### チャンネルから切断する
+チャンネルから切断するには、次のようなデータをJSONでストリームに送信します:
+
+```json
+{
+ type: 'disconnect',
+ body: {
+ id: 'foobar'
+ }
+}
+```
+
+ここで、
+* `id`には前述したそのチャンネルに接続する際に設定したIDを設定します。
+
+## ストリームを経由してAPIリクエストする
+
+ストリームを経由してAPIリクエストすると、HTTPリクエストを発生させずにAPIを利用できます。そのため、コードを簡潔にできたり、パフォーマンスの向上を見込めるかもしれません。
+
+ストリームを経由してAPIリクエストするには、次のようなデータをJSONでストリームに送信します:
+```json
+{
+ type: 'api',
+ body: {
+ id: 'xxxxxxxxxxxxxxxx',
+ endpoint: 'notes/create',
+ data: {
+ text: 'yee haw!'
+ }
+ }
+}
+```
+
+ここで、
+* `id`には、APIのレスポンスを識別するための、APIリクエストごとの一意なIDを設定する必要があります。UUIDや、簡単な乱数のようなもので構いません。
+* `endpoint`には、あなたがリクエストしたいAPIのエンドポイントを指定します。
+* `data`には、エンドポイントのパラメータを含めます。
+
+
+
APIのエンドポイントやパラメータについてはAPIリファレンスをご確認ください。
+
+
+### レスポンスの受信
+
+APIへリクエストすると、レスポンスがストリームから次のような形式で流れてきます。
+
+```json
+{
+ type: 'api:xxxxxxxxxxxxxxxx',
+ body: {
+ ...
+ }
+}
+```
+
+ここで、
+* `xxxxxxxxxxxxxxxx`の部分には、リクエストの際に設定された`id`が含まれています。これにより、どのリクエストに対するレスポンスなのか判別することができます。
+* `body`には、レスポンスが含まれています。
+
+## 投稿のキャプチャ
+
+Misskeyは投稿のキャプチャと呼ばれる仕組みを提供しています。これは、指定した投稿のイベントをストリームで受け取る機能です。
+
+例えばタイムラインを取得してユーザーに表示したとします。ここで誰かがそのタイムラインに含まれるどれかの投稿に対してリアクションしたとします。
+
+しかし、クライアントからするとある投稿にリアクションが付いたことなどは知る由がないため、リアルタイムでリアクションをタイムライン上の投稿に反映して表示するといったことができません。
+
+この問題を解決するために、Misskeyは投稿のキャプチャ機構を用意しています。投稿をキャプチャすると、その投稿に関するイベントを受け取ることができるため、リアルタイムでリアクションを反映させたりすることが可能になります。
+
+### 投稿をキャプチャする
+
+投稿をキャプチャするには、ストリームに次のようなメッセージを送信します:
+
+```json
+{
+ type: 'subNote',
+ body: {
+ id: 'xxxxxxxxxxxxxxxx'
+ }
+}
+```
+
+ここで、
+* `id`にキャプチャしたい投稿の`id`を設定します。
+
+このメッセージを送信すると、Misskeyにキャプチャを要請したことになり、以後、その投稿に関するイベントが流れてくるようになります。
+
+例えば投稿にリアクションが付いたとすると、次のようなメッセージが流れてきます:
+
+```json
+{
+ type: 'noteUpdated',
+ body: {
+ id: 'xxxxxxxxxxxxxxxx',
+ type: 'reacted',
+ body: {
+ reaction: 'like',
+ userId: 'yyyyyyyyyyyyyyyy'
+ }
+ }
+}
+```
+
+ここで、
+* `body`内の`id`に、イベントを発生させた投稿のIDが設定されます。
+* `body`内の`type`に、イベントの種類が設定されます。
+* `body`内の`body`に、イベントの詳細が設定されます。
+
+#### イベントの種類
+
+##### `reacted`
+その投稿にリアクションがされた時に発生します。
+
+* `reaction`に、リアクションの種類が設定されます。
+* `userId`に、リアクションを行ったユーザーのIDが設定されます。
+
+例:
+```json
+{
+ type: 'noteUpdated',
+ body: {
+ id: 'xxxxxxxxxxxxxxxx',
+ type: 'reacted',
+ body: {
+ reaction: 'like',
+ userId: 'yyyyyyyyyyyyyyyy'
+ }
+ }
+}
+```
+
+##### `deleted`
+その投稿が削除された時に発生します。
+
+* `deletedAt`に、削除日時が設定されます。
+
+例:
+```json
+{
+ type: 'noteUpdated',
+ body: {
+ id: 'xxxxxxxxxxxxxxxx',
+ type: 'deleted',
+ body: {
+ deletedAt: '2018-10-22T02:17:09.703Z'
+ }
+ }
+}
+```
+
+##### `pollVoted`
+その投稿に添付されたアンケートに投票された時に発生します。
+
+* `choice`に、選択肢IDが設定されます。
+* `userId`に、投票を行ったユーザーのIDが設定されます。
+
+例:
+```json
+{
+ type: 'noteUpdated',
+ body: {
+ id: 'xxxxxxxxxxxxxxxx',
+ type: 'pollVoted',
+ body: {
+ choice: 2,
+ userId: 'yyyyyyyyyyyyyyyy'
+ }
+ }
+}
+```
+
+### 投稿のキャプチャを解除する
+
+その投稿がもう画面に表示されなくなったりして、その投稿に関するイベントをもう受け取る必要がなくなったときは、キャプチャの解除を申請してください。
+
+次のメッセージを送信します:
+
+```json
+{
+ type: 'unsubNote',
+ body: {
+ id: 'xxxxxxxxxxxxxxxx'
+ }
+}
+```
+
+ここで、
+* `id`にキャプチャを解除したい投稿の`id`を設定します。
+
+このメッセージを送信すると、以後、その投稿に関するイベントは流れてこないようになります。
+
+# チャンネル一覧
+## `main`
+アカウントに関する基本的な情報が流れてきます。このチャンネルにパラメータはありません。
+
+### 流れてくるイベント一覧
+
+#### `renote`
+自分の投稿がRenoteされた時に発生するイベントです。自分自身の投稿をRenoteしたときは発生しません。
+
+#### `mention`
+誰かからメンションされたときに発生するイベントです。
+
+#### `readAllNotifications`
+自分宛ての通知がすべて既読になったことを表すイベントです。このイベントを利用して、「通知があることを示すアイコン」のようなものをオフにしたりする等のケースが想定されます。
+
+#### `meUpdated`
+自分の情報が更新されたことを表すイベントです。
+
+#### `follow`
+自分が誰かをフォローしたときに発生するイベントです。
+
+#### `unfollow`
+自分が誰かのフォローを解除したときに発生するイベントです。
+
+#### `followed`
+自分が誰かにフォローされたときに発生するイベントです。
+
+## `homeTimeline`
+ホームタイムラインの投稿情報が流れてきます。このチャンネルにパラメータはありません。
+
+### 流れてくるイベント一覧
+
+#### `note`
+タイムラインに新しい投稿が流れてきたときに発生するイベントです。
+
+## `localTimeline`
+ローカルタイムラインの投稿情報が流れてきます。このチャンネルにパラメータはありません。
+
+### 流れてくるイベント一覧
+
+#### `note`
+ローカルタイムラインに新しい投稿が流れてきたときに発生するイベントです。
+
+## `hybridTimeline`
+ソーシャルタイムラインの投稿情報が流れてきます。このチャンネルにパラメータはありません。
+
+### 流れてくるイベント一覧
+
+#### `note`
+ソーシャルタイムラインに新しい投稿が流れてきたときに発生するイベントです。
+
+## `globalTimeline`
+グローバルタイムラインの投稿情報が流れてきます。このチャンネルにパラメータはありません。
+
+### 流れてくるイベント一覧
+
+#### `note`
+グローバルタイムラインに新しい投稿が流れてきたときに発生するイベントです。
diff --git a/src/docs/id-ID/theme.md b/src/docs/id-ID/theme.md
new file mode 100644
index 0000000000..4e52ee8cd7
--- /dev/null
+++ b/src/docs/id-ID/theme.md
@@ -0,0 +1,68 @@
+# テーマ
+
+テーマを設定して、Misskeyクライアントの見た目を変更できます。
+
+## テーマの設定
+設定 > テーマ
+
+## テーマを作成する
+テーマコードはJSON5で記述されたテーマオブジェクトです。 テーマは以下のようなオブジェクトです。
+``` js
+{
+ id: '17587283-dd92-4a2c-a22c-be0637c9e22a',
+
+ name: 'Danboard',
+ author: 'syuilo',
+
+ base: 'light',
+
+ props: {
+ accent: 'rgb(218, 141, 49)',
+ bg: 'rgb(218, 212, 190)',
+ fg: 'rgb(115, 108, 92)',
+ panel: 'rgb(236, 232, 220)',
+ renote: 'rgb(100, 152, 106)',
+ link: 'rgb(100, 152, 106)',
+ mention: '@accent',
+ hashtag: 'rgb(100, 152, 106)',
+ header: 'rgba(239, 227, 213, 0.75)',
+ navBg: 'rgb(216, 206, 182)',
+ inputBorder: 'rgba(0, 0, 0, 0.1)',
+ },
+}
+
+```
+
+* `id` ... テーマの一意なID。UUIDをおすすめします。
+* `name` ... テーマ名
+* `author` ... テーマの作者
+* `desc` ... テーマの説明(オプション)
+* `base` ... 明るいテーマか、暗いテーマか
+ * `light`にすると明るいテーマになり、`dark`にすると暗いテーマになります。
+ * テーマはここで設定されたベーステーマを継承します。
+* `props` ... テーマのスタイル定義。これから説明します。
+
+### テーマのスタイル定義
+`props`下にはテーマのスタイルを定義します。 キーがCSSの変数名になり、バリューで中身を指定します。 なお、この`props`オブジェクトはベーステーマから継承されます。 ベーステーマは、このテーマの`base`が`light`なら[_light.json5](https://github.com/syuilo/misskey/blob/develop/src/client/themes/_light.json5)で、`dark`なら[_dark.json5](https://github.com/syuilo/misskey/blob/develop/src/client/themes/_dark.json5)です。 つまり、このテーマ内の`props`に`panel`というキーが無くても、そこにはベーステーマの`panel`があると見なされます。
+
+#### バリューで使える構文
+* 16進数で表された色
+ * 例: `#00ff00`
+* `rgb(r, g, b)`形式で表された色
+ * 例: `rgb(0, 255, 0)`
+* `rgb(r, g, b, a)`形式で表された透明度を含む色
+ * 例: `rgba(0, 255, 0, 0.5)`
+* 他のキーの値の参照
+ * `@{キー名}`と書くと他のキーの値の参照になります。`{キー名}`は参照したいキーの名前に置き換えます。
+ * 例: `@panel`
+* 定数(後述)の参照
+ * `${定数名}`と書くと定数の参照になります。`{定数名}`は参照したい定数の名前に置き換えます。
+ * 例: `$main`
+* 関数(後述)
+ * `:{関数名}<{引数}<{色}`
+
+#### 定数
+「CSS変数として出力はしたくないが、他のCSS変数の値として使いまわしたい」値があるときは、定数を使うと便利です。 キー名を`$`で始めると、そのキーはCSS変数として出力されません。
+
+#### 関数
+wip
diff --git a/src/docs/id-ID/timelines.md b/src/docs/id-ID/timelines.md
new file mode 100644
index 0000000000..36ba61bd2d
--- /dev/null
+++ b/src/docs/id-ID/timelines.md
@@ -0,0 +1,15 @@
+# タイムラインの比較
+
+https://docs.google.com/spreadsheets/d/1lxQ2ugKrhz58Bg96HTDK_2F98BUritkMyIiBkOByjHA/edit?usp=sharing
+
+## ホーム
+自分のフォローしているユーザーの投稿
+
+## ローカル
+全てのローカルユーザーの「ホーム」指定されていない投稿
+
+## ソーシャル
+自分のフォローしているユーザーの投稿と、全てのローカルユーザーの「ホーム」指定されていない投稿
+
+## グローバル
+全てのローカルユーザーの「ホーム」指定されていない投稿と、サーバーに届いた全てのリモートユーザーの「ホーム」指定されていない投稿
diff --git a/src/docs/pl-PL/aiscript.md b/src/docs/pl-PL/aiscript.md
index 6c28b446e3..c8959d5936 100644
--- a/src/docs/pl-PL/aiscript.md
+++ b/src/docs/pl-PL/aiscript.md
@@ -1,4 +1,4 @@
# AiScript
-## 関数
+## Funkcje
デフォルトで値渡しです。
diff --git a/src/docs/pl-PL/create-plugin.md b/src/docs/pl-PL/create-plugin.md
index 0d2fa19178..31d89416de 100644
--- a/src/docs/pl-PL/create-plugin.md
+++ b/src/docs/pl-PL/create-plugin.md
@@ -1,7 +1,7 @@
# プラグインの作成
Misskey Webクライアントのプラグイン機能を使うと、クライアントを拡張し、様々な機能を追加できます。 ここではプラグインの作成にあたってのメタデータ定義や、AiScript APIリファレンスを掲載します。
-## メタデータ
+## Metadane
プラグインは、AiScriptのメタデータ埋め込み機能を使って、デフォルトとしてプラグインのメタデータを定義する必要があります。 メタデータは次のプロパティを含むオブジェクトです。
### name
diff --git a/src/docs/pl-PL/custom-emoji.md b/src/docs/pl-PL/custom-emoji.md
index ed2e92be16..3f71205a67 100644
--- a/src/docs/pl-PL/custom-emoji.md
+++ b/src/docs/pl-PL/custom-emoji.md
@@ -1,2 +1,2 @@
-# カスタム絵文字
+# Niestandardowe emoji
カスタム絵文字は、インスタンスで用意された画像を絵文字のように使える機能です。 ノート、リアクション、チャット、自己紹介、名前などの場所で使うことができます。 カスタム絵文字をそれらの場所で使うには、絵文字ピッカーボタン(ある場合)を押すか、`:`を入力して絵文字サジェストを表示します。 テキスト内に`:foo:`のような形式の文字列が見つかると、`foo`の部分がカスタム絵文字名と解釈され、表示時には対応したカスタム絵文字に置き換わります。
diff --git a/src/docs/pl-PL/deck.md b/src/docs/pl-PL/deck.md
index 8057e262fd..aa879d7dfa 100644
--- a/src/docs/pl-PL/deck.md
+++ b/src/docs/pl-PL/deck.md
@@ -1,4 +1,4 @@
-# デッキ
+# Tablica
デッキは利用可能なUIのひとつです。「カラム」と呼ばれるビューを複数並べて表示させることで、カスタマイズ性が高く、情報量の多いUIが構築できることが特徴です。
diff --git a/src/docs/pl-PL/follow.md b/src/docs/pl-PL/follow.md
index 3c1ea7bbe0..3b5ce84dce 100644
--- a/src/docs/pl-PL/follow.md
+++ b/src/docs/pl-PL/follow.md
@@ -1,2 +1,2 @@
-# フォロー
+# Obserwowani
ユーザーをフォローすると、タイムラインにそのユーザーの投稿が表示されるようになります。ただし、他のユーザーに対する返信は含まれません。 ユーザーをフォローするには、ユーザーページの「フォロー」ボタンをクリックします。フォローを解除するには、もう一度クリックします。
diff --git a/src/docs/pl-PL/keyboard-shortcut.md b/src/docs/pl-PL/keyboard-shortcut.md
index c2c138928b..07aa21506e 100644
--- a/src/docs/pl-PL/keyboard-shortcut.md
+++ b/src/docs/pl-PL/keyboard-shortcut.md
@@ -4,7 +4,7 @@
これらのショートカットは基本的にどこでも使えます。
- | ショートカット | 効果 | 由来 |
|---|
+ | ショートカット | Efekt | Pochodzenie |
|---|
| P, N | 新規投稿 | Post, New, Note |
@@ -19,7 +19,7 @@
- | ショートカット | 効果 | 由来 |
|---|
+ | ショートカット | Efekt | Pochodzenie |
|---|
| ↑, K, Shift + Tab | 上の投稿にフォーカスを移動 | - |
@@ -41,7 +41,7 @@
- | ショートカット | 効果 | 由来 |
|---|
+ | ショートカット | Efekt | Pochodzenie |
|---|
| Enter | Renoteする | - |
@@ -54,7 +54,7 @@
デフォルトで「👍」にフォーカスが当たっている状態です。
- | ショートカット | 効果 | 由来 |
|---|
+ | ショートカット | Efekt | Pochodzenie |
|---|
| ↑, K | 上のリアクションにフォーカスを移動 | - |
diff --git a/src/docs/pl-PL/mute.md b/src/docs/pl-PL/mute.md
index 6a9608662a..8daf9f68ad 100644
--- a/src/docs/pl-PL/mute.md
+++ b/src/docs/pl-PL/mute.md
@@ -1,4 +1,4 @@
-# ミュート
+# Wycisz
ユーザーをミュートすると、そのユーザーに関する次のコンテンツがMisskeyに表示されなくなります:
diff --git a/src/docs/pl-PL/pages.md b/src/docs/pl-PL/pages.md
index a7311b95e6..efa18263f6 100644
--- a/src/docs/pl-PL/pages.md
+++ b/src/docs/pl-PL/pages.md
@@ -1,6 +1,6 @@
# Pages
-## 変数
+## Zmienne
変数を使うことで動的なページを作成できます。テキスト内で { 変数名 } と書くとそこに変数の値を埋め込めます。例えば Hello { thing } world! というテキストで、変数(thing)の値が ai だった場合、テキストは Hello ai world! になります。
変数の評価(値を算出すること)は上から下に行われるので、ある変数の中で自分より下の変数を参照することはできません。例えば上から A、B、C と3つの変数を定義したとき、Cの中でAやBを参照することはできますが、Aの中でBやCを参照することはできません。
diff --git a/src/docs/pl-PL/reaction.md b/src/docs/pl-PL/reaction.md
index c26ead75b3..a471624ce7 100644
--- a/src/docs/pl-PL/reaction.md
+++ b/src/docs/pl-PL/reaction.md
@@ -1,4 +1,4 @@
-# リアクション
+# Reakcja
他の人のノートに、絵文字を付けて簡単にあなたの反応を伝えられる機能です。 リアクションするには、ノートの + アイコンをクリックしてピッカーを表示し、絵文字を選択します。 リアクションには[カスタム絵文字](./custom-emoji)も使用できます。
## リアクションピッカーのカスタマイズ
diff --git a/src/docs/pl-PL/reversi-bot.md b/src/docs/pl-PL/reversi-bot.md
index 7ab2a7212e..f60af55b8c 100644
--- a/src/docs/pl-PL/reversi-bot.md
+++ b/src/docs/pl-PL/reversi-bot.md
@@ -56,7 +56,7 @@ y = Math.floor(pos / mapWidth)
## マップ情報
マップ情報は、ゲーム情報の`map`に入っています。 文字列の配列になっており、ひとつひとつの文字がマス情報を表しています。 それをもとにマップのデザインを知る事が出来ます:
* `(スペース)` ... マス無し
-* `-` ... マス
+* `-` ... Pole
* `b` ... 初期配置される黒石
* `w` ... 初期配置される白石
@@ -120,7 +120,7 @@ type: `switch` スイッチを表示します。何かの機能をオン/オフ
type: `radio` ラジオボタンを表示します。選択肢を提示するのに有用です。例えば、Botの強さを設定させるなどです。
##### プロパティ
-`items` ... ラジオボタンの選択肢。例:
+`items` ... ラジオボタンの選択肢。Przykład:
```javascript
items: [{
label: '弱',
diff --git a/src/docs/pl-PL/stream.md b/src/docs/pl-PL/stream.md
index 9011c37c5b..bffce62d00 100644
--- a/src/docs/pl-PL/stream.md
+++ b/src/docs/pl-PL/stream.md
@@ -6,7 +6,7 @@
ストリーミングAPIを利用するには、まずMisskeyサーバーに**websocket**接続する必要があります。
-以下のURLに、`i`というパラメータ名で認証情報を含めて、websocket接続してください。例:
+以下のURLに、`i`というパラメータ名で認証情報を含めて、websocket接続してください。Przykład:
```
%WS_URL%/streaming?i=xxxxxxxxxxxxxxx
```
@@ -19,7 +19,7 @@
---
-認証情報は省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。例:
+認証情報は省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。Przykład:
```
%WS_URL%/streaming
@@ -219,7 +219,7 @@ Misskeyは投稿のキャプチャと呼ばれる仕組みを提供していま
* `reaction`に、リアクションの種類が設定されます。
* `userId`に、リアクションを行ったユーザーのIDが設定されます。
-例:
+Przykład:
```json
{
type: 'noteUpdated',
@@ -239,7 +239,7 @@ Misskeyは投稿のキャプチャと呼ばれる仕組みを提供していま
* `deletedAt`に、削除日時が設定されます。
-例:
+Przykład:
```json
{
type: 'noteUpdated',
@@ -259,7 +259,7 @@ Misskeyは投稿のキャプチャと呼ばれる仕組みを提供していま
* `choice`に、選択肢IDが設定されます。
* `userId`に、投票を行ったユーザーのIDが設定されます。
-例:
+Przykład:
```json
{
type: 'noteUpdated',
diff --git a/src/docs/pl-PL/theme.md b/src/docs/pl-PL/theme.md
index 4e52ee8cd7..83b96afaff 100644
--- a/src/docs/pl-PL/theme.md
+++ b/src/docs/pl-PL/theme.md
@@ -1,4 +1,4 @@
-# テーマ
+# Motywy
テーマを設定して、Misskeyクライアントの見た目を変更できます。
@@ -61,8 +61,8 @@
* 関数(後述)
* `:{関数名}<{引数}<{色}`
-#### 定数
+#### Stała
「CSS変数として出力はしたくないが、他のCSS変数の値として使いまわしたい」値があるときは、定数を使うと便利です。 キー名を`$`で始めると、そのキーはCSS変数として出力されません。
-#### 関数
+#### Funkcje
wip
diff --git a/src/docs/pl-PL/timelines.md b/src/docs/pl-PL/timelines.md
index 36ba61bd2d..f864ff3bef 100644
--- a/src/docs/pl-PL/timelines.md
+++ b/src/docs/pl-PL/timelines.md
@@ -2,10 +2,10 @@
https://docs.google.com/spreadsheets/d/1lxQ2ugKrhz58Bg96HTDK_2F98BUritkMyIiBkOByjHA/edit?usp=sharing
-## ホーム
+## Strona główna
自分のフォローしているユーザーの投稿
-## ローカル
+## Lokalne
全てのローカルユーザーの「ホーム」指定されていない投稿
## ソーシャル
diff --git a/src/docs/zh-CN/pages.md b/src/docs/zh-CN/pages.md
index 07fe2428d7..2446c183ad 100644
--- a/src/docs/zh-CN/pages.md
+++ b/src/docs/zh-CN/pages.md
@@ -1,10 +1,10 @@
# 页面
## 变量
-您可以使用变量创建动态页面。您可以在文本中使用{变量名}的格式来引用变量的值。例えば Hello { thing } world! というテキストで、変数(thing)の値が ai だった場合、テキストは Hello ai world! になります。
+您可以使用变量创建动态页面。您可以在文本中使用{变量名}的格式来引用变量的值。例如当变量(thing)的值为ai时，字符串Hello { thing } world!的值为Hello ai world!。
-変数の評価(値を算出すること)は上から下に行われるので、ある変数の中で自分より下の変数を参照することはできません。例えば上から A、B、C と3つの変数を定義したとき、Cの中でAやBを参照することはできますが、Aの中でBやCを参照することはできません。
+变量的处理（计算变量的值）是从上到下执行的，因此不能引用未声明的变量。例如，如果您依次定义了 A，B，C 三个变量，则在 C 中可以引用 A 和 B ，但 A 中不能引用 B 或 C 。
-ユーザーからの入力を受け取るには、ページに「ユーザー入力」ブロックを設置し、「変数名」に入力を格納したい変数名を設定します(変数は自動で作成されます)。その変数を使ってユーザー入力に応じた動作を行えます。
+为了接收来自用户的输入，页面上设有“用户输入”块，在“变量名称”中设置要在其中保存输入值的变量名(变量会自动创建)。然后您可以通过该变量使用用户输入的值进行其他操作。
-関数を使うと、値の算出処理を再利用可能な形にまとめることができます。関数を作るには、「関数」タイプの変数を作成します。関数にはスロット(引数)を設定することができ、スロットの値は関数内で変数として利用可能です。また、関数を引数に取る関数(高階関数と呼ばれます)も存在します。関数は予め定義しておくほかに、このような高階関数のスロットに即席でセットすることもできます。
+函数时一种将可重用的计算过程组合起来的形式。要创建函数，请创建“函数”类型的变量。可以为函数设置插槽（参数），并且插槽值可以作为函数内的变量使用。另外，也可以将函数作为函数的参数（称为高阶函数）。除了预定义函数外，您也可以随时将函数定义在这类高阶功能的插槽中。
diff --git a/src/docs/zh-CN/reaction.md b/src/docs/zh-CN/reaction.md
index 89fc8ba8be..779bde238b 100644
--- a/src/docs/zh-CN/reaction.md
+++ b/src/docs/zh-CN/reaction.md
@@ -1,11 +1,11 @@
# 回应
-他の人のノートに、絵文字を付けて簡単にあなたの反応を伝えられる機能です。 リアクションするには、ノートの + アイコンをクリックしてピッカーを表示し、絵文字を選択します。 リアクションには[カスタム絵文字](./custom-emoji)も使用できます。
+通过将表情符号加到其他人的帖子上，您可以快速表达您的反应。 要做出回应，请单击帖子上的 + 图标以打开选择器并选择一个表情符号。 您也可以使用[自定义表情符号](./custom-emoji)来进行回应。
-## リアクションピッカーのカスタマイズ
-ピッカーに表示される絵文字を自分好みにカスタマイズすることができます。 設定の「リアクション」で設定します。
+## 自定义回应选择器
+您可以根据自己的喜好自定义选择器中显示的表情符号。 在设置的“回应”中即可进行设置。
-## リモート投稿へのリアクションについて
-リアクションはMisskeyオリジナルの機能であるため、リモートインスタンスがMisskeyでない限りは、ほとんどの場合「Like」としてアクティビティが送信されます。一般的にはLikeは「お気に入り」として実装されているようです。 また、相手がMisskeyであったとしても、カスタム絵文字リアクションは伝わらず、自動的に「👍」等にフォールバックされます。
+## 关于对外部发帖的回应
+回应是Misskey的原生功能，因此，除非外部实例是Misskey，否则该操作很有可能仅以“Like”的形式发送。通常，Like表现为“点赞”的功能。 另外，即使对方同样是Misskey，自定义表情符号的回应也不会被发送，而是会自动显示为“👍”等表情符号。
-## リモートからのリアクションについて
-リモートから「Like」アクティビティを受信したとき、Misskeyでは「👍」のリアクションとして解釈されます。
+## 关于外部回应
+当从外部接收到“Like”操作时，Misskey会将其解释为“👍”回应。
diff --git a/src/docs/zh-CN/reversi-bot.md b/src/docs/zh-CN/reversi-bot.md
index c89ec0cbe3..8c2d0f2551 100644
--- a/src/docs/zh-CN/reversi-bot.md
+++ b/src/docs/zh-CN/reversi-bot.md
@@ -1,33 +1,33 @@
-# MisskeyリバーシBotの開発
-Misskeyのリバーシ機能に対応したBotの開発方法をここに記します。
+# Misskey的黑白棋Bot开发
+本页会说明如何为Misskey的黑白棋功能开发一个Bot机器人。
-1. `games/reversi`ストリームに以下のパラメータを付けて接続する:
- * `i`: botアカウントのAPIキー
+1. 使用以下参数来连接`games/reversi`流式API：
+ * `i`: bot账号的API key
-2. 対局への招待が来たら、ストリームから`invited`イベントが流れてくる
- * イベントの中身に、`parent`という名前で対局へ誘ってきたユーザーの情報が含まれている
+2. 当出现对局邀请时，流中会触发`invited`事件
+ * 事件内容中包含邀请您参加游戏的用户信息，名字为`parent`。
-3. `games/reversi/match`へ、`user_id`として`parent`の`id`が含まれたリクエストを送信する
+3. 向`games/reversi/match`发送请求，其中`user_id`包含`parent`的`id`
-4. 上手くいくとゲーム情報が返ってくるので、`games/reversi-game`ストリームへ、以下のパラメータを付けて接続する:
- * `i`: botアカウントのAPIキー
- * `game`: `game`の`id`
+4. 请求成功时将返回游戏信息，然后可以使用以下参数连接到`games/reversi-game`流：
+ * `i`: bot账号的API key
+ * `game`: `game`的`id`
-5. この間、相手がゲームの設定を変更するとその都度`update-settings`イベントが流れてくるので、必要であれば何かしらの処理を行う
+5. 与此同时，每次对手更改游戏设置时，都会触发`update-settings`事件，如果有必要的话，需要对其进行处理。
-6. 設定に満足したら、`{ type: 'accept' }`メッセージをストリームに送信する
+6. 一旦符合设置，则向流发送`{ type: 'accept' }`消息
-7. ゲームが開始すると、`started`イベントが流れてくる
- * イベントの中身にはゲーム情報が含まれている
+7. 游戏开始时会触发`started`事件
+ * 游戏状态信息会包含在该事件中
-8. 石を打つには、ストリームに`{ type: 'set', pos: <位置> }`を送信する(位置の計算方法は後述)
+8. 要放置棋子，向流发送`{ type: 'set', pos: <位置> }`(后面会说明位置的计算方法)
-9. 相手または自分が石を打つと、ストリームから`set`イベントが流れてくる
- * `color`として石の色が含まれている
- * `pos`として位置情報が含まれている
+9. 当对方或者您放置棋子时，会触发`set`事件
+ * `color`中包含该棋子的颜色
+ * `pos`中包含该棋子的位置
-## 位置の計算法
-8x8のマップを考える場合、各マスの位置(インデックスと呼びます)は次のようになっています:
+## 位置计算方法
+当棋盘尺寸为8x8时，每个方格的位置（称为索引）如下所示：
```
+--+--+--+--+--+--+--+--+
| 0| 1| 2| 3| 4| 5| 6| 7|
@@ -38,29 +38,29 @@ Misskeyのリバーシ機能に対応したBotの開発方法をここに記し
...
```
-### X,Y座標 から インデックス に変換する
+### 从X,Y坐标转换为索引
```
pos = x + (y * mapWidth)
```
-`mapWidth`は、ゲーム情報の`map`から、次のようにして計算できます:
+`mapWidth`可以根据游戏信息中的`map`，通过如下方法计算出来：
```
mapWidth = map[0].length
```
-### インデックス から X,Y座標 に変換する
+### 从索引转换为X,Y坐标
```
x = pos % mapWidth
y = Math.floor(pos / mapWidth)
```
-## マップ情報
-マップ情報は、ゲーム情報の`map`に入っています。 文字列の配列になっており、ひとつひとつの文字がマス情報を表しています。 それをもとにマップのデザインを知る事が出来ます:
-* `(スペース)` ... マス無し
-* `-` ... マス
-* `b` ... 初期配置される黒石
-* `w` ... 初期配置される白石
+## 棋盘信息
+棋盘信息包含在游戏信息的`map`中。 它是一个字符串数组，每个字符代表一块格子的信息。 您可以根据这些来了解地图如何设计：
+* `(空)` ... 没有格子
+* `-` ... 格子
+* `b` ... 黑子先下
+* `w` ... 白子先下
-例えば、4*4の次のような単純なマップがあるとします:
+以下面这个4*4的简单棋盘为例：
```text
+---+---+---+---+
| | | | |
@@ -73,23 +73,23 @@ y = Math.floor(pos / mapWidth)
+---+---+---+---+
```
-この場合、マップデータはこのようになります:
+这种情况下，棋盘数据是这样的：
```javascript
['----', '-wb-', '-bw-', '----']
```
-## ユーザーにフォームを提示して対話可能Botを作成する
-ユーザーとのコミュニケーションを行うため、ゲームの設定画面でユーザーにフォームを提示することができます。 例えば、Botの強さをユーザーが設定できるようにする、といったシナリオが考えられます。
+## 能和用户互动的交互式Bot机器人的创建
+要和用户交互，您可以在游戏设置屏幕上向用户显示对话框。 例如，可以让用户选择Bot机器人的难度。
-フォームを提示するには、`reversi-game`ストリームに次のメッセージを送信します:
+要显示提示框，需要向`reversi-game`流发送下列消息：
```javascript
{
type: 'init-form',
- body: [フォームコントロールの配列]
+ body: [表单控件数组]
}
```
-フォームコントロールの配列については今から説明します。 フォームコントロールは、次のようなオブジェクトです:
+下面说明表单控件数组的结构。 表单控件指的是如下面所示的对象：
```javascript
{
id: 'switch1',
@@ -98,10 +98,10 @@ y = Math.floor(pos / mapWidth)
value: false
}
```
-`id` ... コントロールのID。 `type` ... コントロールの種類。後述します。 `label` ... コントロールと一緒に表記するテキスト。 `value` ... コントロールのデフォルト値。
+`id` ... 控件ID。 `type` ... 控件类型。说明详见后文。 `label` ... 控件元素上显示的文字。 `value` ... 控件元素的默认值。
-### フォームの操作を受け取る
-ユーザーがフォームを操作すると、ストリームから`update-form`イベントが流れてきます。 イベントの中身には、コントロールのIDと、ユーザーが設定した値が含まれています。 例えば、上で示したスイッチをユーザーがオンにしたとすると、次のイベントが流れてきます:
+### 控件行为的处理
+当用户与对话框交互时将会触发流的`update-form`事件。 事件的内容包含控件的ID和用户设置的值。 例如，如果用户将上面显示的开关控件打开，则将触发以下事件：
```javascript
{
id: 'switch1',
@@ -109,18 +109,18 @@ y = Math.floor(pos / mapWidth)
}
```
-### フォームコントロールの種類
+### 表单控件的类型
#### 开关
-type: `switch` スイッチを表示します。何かの機能をオン/オフさせたい場合に有用です。
+type: `switch` 显示一个开关。当您想要打开/关闭某些功能时非常有用。
-##### プロパティ
-`label` ... スイッチに表記するテキスト。
+##### 属性
+`label` ... 开关上显示的文字。
-#### ラジオボタン
-type: `radio` ラジオボタンを表示します。選択肢を提示するのに有用です。例えば、Botの強さを設定させるなどです。
+#### 单选按钮
+type: `radio` 显示一个单选按钮。用来表示单项选择。例如，可以选择Bot机器人的难度。
-##### プロパティ
-`items` ... ラジオボタンの選択肢。例:
+##### 属性
+`items` ... 单元按钮的选择项。例：
```javascript
items: [{
label: '弱',
@@ -129,32 +129,32 @@ items: [{
label: '中',
value: 2
}, {
- label: '強',
+ label: '强',
value: 3
}]
```
-#### スライダー
-type: `slider` スライダーを表示します。
+#### 滑块
+type: `slider` 显示一个滑块。
-##### プロパティ
-`min` ... スライダーの下限。 `max` ... スライダーの上限。 `step` ... 入力欄で刻むステップ値。
+##### 属性
+`min` ... 滑块最小值。 `max` ... 滑块最大值。 `step` ... 滑块值的步长。
-#### テキストボックス
-type: `textbox` テキストボックスを表示します。ユーザーになにか入力させる一般的な用途に利用できます。
+#### 文本框
+type: `textbox` 显示一个文本框。可以在各种需要用户输入的地方使用。
-## ユーザーにメッセージを表示する
-設定画面でユーザーと対話する、フォーム以外のもうひとつの方法がこれです。ユーザーになにかメッセージを表示することができます。 例えば、ユーザーがBotの対応していないモードやマップを選択したとき、警告を表示するなどです。 メッセージを表示するには、次のメッセージをストリームに送信します:
+## 向用户显示消息
+设置屏幕上与用户交互，是除了对话框外的另一种方法。您可以向用户显示一条消息。 例如，当用户选择Bot机器人不支持的模式或棋盘时显示警告。 要显示消息，请将以下消息发送到流：
```javascript
{
type: 'message',
body: {
- text: 'メッセージ内容',
- type: 'メッセージの種類'
+ text: '消息内容',
+ type: '消息类型'
}
}
```
-メッセージの種類: `success`, `info`, `warning`, `error`。
+消息类型：`success`, `info`, `warning`, `error`。
-## 投了する
-投了をするには、このエンドポイントにリクエストします。
+## 认输
+要认输，请发送请求到这个终端。
diff --git a/src/docs/zh-CN/stream.md b/src/docs/zh-CN/stream.md
index 33d45e29cf..92a7f5b357 100644
--- a/src/docs/zh-CN/stream.md
+++ b/src/docs/zh-CN/stream.md
@@ -1,25 +1,25 @@
# 流式API
-ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、メッセージが届いた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。
+通过流式API，您可以实时接收各种信息（例如，你的时间线中的新帖文，收到的消息，关注等），并进行各种操作。
-## ストリームに接続する
+## 连接到流
-ストリーミングAPIを利用するには、まずMisskeyサーバーに**websocket**接続する必要があります。
+要使用流式API，您需要使用**websocket**连接到Misskey服务器。
-以下のURLに、`i`というパラメータ名で認証情報を含めて、websocket接続してください。例:
+请使用参数`i`连接到以下URL，并在websocket连接中包含认证信息。例如：
```
%WS_URL%/streaming?i=xxxxxxxxxxxxxxx
```
-認証情報は、自分のAPIキーや、アプリケーションからストリームに接続する際はユーザーのアクセストークンのことを指します。
+认证信息是您的API密钥，从应用程序连接到流时需要引用的用户访问令牌
---
-認証情報は省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。例:
+您可以省略身份验证信息。此时无需登录即可使用，但是可以接收的信息和可以执行的操作将受到限制。例：
```
%WS_URL%/streaming
@@ -27,15 +27,15 @@
---
-ストリームに接続すると、後述するAPI操作や、投稿の購読を行ったりすることができます。 しかしまだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。 それを行うには、ストリーム上で、後述する**チャンネル**に接続する必要があります。
+通过连接到流，您可以执行后文所示的API操作并订阅帖子。 但是此时例如时间线上的新帖子等还无法接收到。 要实现此功能，您需要连接到后文所述的流的**频道**。
-**ストリームでのやり取りはすべてJSONです。**
+**所有流交互都是JSON格式。**
## 频道
-MisskeyのストリーミングAPIにはチャンネルという概念があります。これは、送受信する情報を分離するための仕組みです。 Misskeyのストリームに接続しただけでは、まだリアルタイムでタイムラインの投稿を受信したりはできません。 ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。
+频道是Misskey的流API中的概念。这是一种分离发送和接收信息的机制。 您无法仅通过连接到Misskey流来实时接收时间线帖子。 需要通过连接到流中的频道，您才能够接收和发送各种消息。
-### チャンネルに接続する
-チャンネルに接続するには、次のようなデータをJSONでストリームに送信します:
+### 连接到频道
+要连接到频道，请将JSON数据发送到流：
```json
{
@@ -50,19 +50,19 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり
}
```
-ここで、
-* `channel`には接続したいチャンネル名を設定します。チャンネルの種類については後述します。
-* `id`にはそのチャンネルとやり取りするための任意のIDを設定します。ストリームでは様々なメッセージが流れるので、そのメッセージがどのチャンネルからのものなのか識別する必要があるからです。このIDは、UUIDや、乱数のようなもので構いません。
-* `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。
+其中：
+* `channel`中可以设置您要连接的频道名。频道类型将在后面说明。
+* `id`设置用于与频道通信的ID。因为流中有着各种消息，因此需要确定消息来自哪个频道。该ID可以是UUID或随机数。
+* `params`是连接到频道时传的参数。连接不同的频道时需要不同的参数。连接到无需参数的频道时，该属性为可选。
-
IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。
+
ID对应的是“频道的连接”，而不是频道。因为在某些情况下会使用不同的参数对同一频道进行多个连接。