}` to the stream (how to calculate positions will be explained later).
-9. 相手または自分が石を打つと、ストリームから`set`イベントが流れてくる
- * `color`として石の色が含まれている
- * `pos`として位置情報が含まれている
+9. When the opponent or you place a stone, the `set` event is emitted.
+ * Contains the color of the placed stone as `color`
+ * Contains the position the stone was placed at as `pos`
-## 位置の計算法
-8x8のマップを考える場合、各マスの位置(インデックスと呼びます)は次のようになっています:
+## Calculating positions
+In the case of an 8x8 map, the squares on the board are arranged like this (squares are marked with their respective index):
```
+--+--+--+--+--+--+--+--+
| 0| 1| 2| 3| 4| 5| 6| 7|
@@ -38,29 +38,29 @@ Misskeyのリバーシ機能に対応したBotの開発方法をここに記し
...
```
-### X,Y座標 から インデックス に変換する
+### Find indices from X, Y coordinates
```
pos = x + (y * mapWidth)
```
-`mapWidth`は、ゲーム情報の`map`から、次のようにして計算できます:
+`mapWidth` can be acquired from the `map` information as follows:
```
mapWidth = map[0].length
```
-### インデックス から X,Y座標 に変換する
+### Find X, Y coordinates from indices
```
x = pos % mapWidth
y = Math.floor(pos / mapWidth)
```
-## マップ情報
-マップ情報は、ゲーム情報の`map`に入っています。 文字列の配列になっており、ひとつひとつの文字がマス情報を表しています。 それをもとにマップのデザインを知る事が出来ます:
-* `(スペース)` ... マス無し
-* `-` ... マス
-* `b` ... 初期配置される黒石
-* `w` ... 初期配置される白石
+## Map information
+Map data is included within `map` of the game data. As the data is represented as an array of strings, each character represents a piece. Based on this data, you can reconstruct the map state:
+* `(Space)` ... No piece
+* `-` ... Piece
+* `b` ... Piece placed first was black
+* `w` ... Piece placed first was white
-例えば、4*4の次のような単純なマップがあるとします:
+For example, suppose a situation with the following 4*4 board:
```text
+---+---+---+---+
| | | | |
@@ -73,23 +73,23 @@ y = Math.floor(pos / mapWidth)
+---+---+---+---+
```
-この場合、マップデータはこのようになります:
+In this case, the map data look like this:
```javascript
['----', '-wb-', '-bw-', '----']
```
-## ユーザーにフォームを提示して対話可能Botを作成する
-ユーザーとのコミュニケーションを行うため、ゲームの設定画面でユーザーにフォームを提示することができます。 例えば、Botの強さをユーザーが設定できるようにする、といったシナリオが考えられます。
+## Creating an interactive bot showing a form to the user
+To communicate with the user, you can show them a form in the settings screen. For example, to let the user select the strength of the Bot.
-フォームを提示するには、`reversi-game`ストリームに次のメッセージを送信します:
+To display a form, send the following message to the `reversi-game` stream:
```javascript
{
type: 'init-form',
- body: [フォームコントロールの配列]
+ body: [Array of form control fields]
}
```
-フォームコントロールの配列については今から説明します。 フォームコントロールは、次のようなオブジェクトです:
+From here on, the structure of form control elements will be explained. Form controls are objects arranged as follows:
```javascript
{
id: 'switch1',
@@ -98,10 +98,10 @@ y = Math.floor(pos / mapWidth)
value: false
}
```
-`id` ... コントロールのID。 `type` ... コントロールの種類。後述します。 `label` ... コントロールと一緒に表記するテキスト。 `value` ... コントロールのデフォルト値。
+`id` ... The ID of the control element. `type` ... The type of the control element.Explained later. `label` ... Text displayed alongside the control element. `value` ... Default value of the control element.
-### フォームの操作を受け取る
-ユーザーがフォームを操作すると、ストリームから`update-form`イベントが流れてきます。 イベントの中身には、コントロールのIDと、ユーザーが設定した値が含まれています。 例えば、上で示したスイッチをユーザーがオンにしたとすると、次のイベントが流れてきます:
+### Handling form interactions
+When the user interacts with the form, an `update-form` event is emitted. Included in this event is the control element's ID as well as the value of the setting the user changed. For example, if the user flipped the switch from above to on, the following event would be emitted:
```javascript
{
id: 'switch1',
@@ -109,52 +109,52 @@ y = Math.floor(pos / mapWidth)
}
```
-### フォームコントロールの種類
+### Types of form control elements
#### Switch
-type: `switch` スイッチを表示します。何かの機能をオン/オフさせたい場合に有用です。
+type: `switch` Shows a slider.These can be helpful for functions that can be turned either on or off.
-##### プロパティ
-`label` ... スイッチに表記するテキスト。
+##### Properties
+`label` ... The text written on the switch.
-#### ラジオボタン
-type: `radio` ラジオボタンを表示します。選択肢を提示するのに有用です。例えば、Botの強さを設定させるなどです。
+#### Radio button
+type: `radio` Shows a radio button.These can be useful for choices.For example to choose the strength of the Bot.
-##### プロパティ
-`items` ... ラジオボタンの選択肢。例:
+##### Properties
+`items` ... The options of the radio button.E.g.:
```javascript
items: [{
- label: '弱',
+ label: 'Weak',
value: 1
}, {
- label: '中',
+ label: 'Moderate',
value: 2
}, {
- label: '強',
+ label: 'Strong',
value: 3
}]
```
-#### スライダー
-type: `slider` スライダーを表示します。
+#### Slider
+type: `slider` Shows a slider.
-##### プロパティ
-`min` ... スライダーの下限。 `max` ... スライダーの上限。 `step` ... 入力欄で刻むステップ値。
+##### Properties
+`min` ... The minimum value of the slider. `max` ... The maximum value of the slider. `step` ... The step between each value on the slider.
-#### テキストボックス
-type: `textbox` テキストボックスを表示します。ユーザーになにか入力させる一般的な用途に利用できます。
+#### Textbox
+type: `textbox` Shows a textbox.These can be used for all general purposes which require user input.
-## ユーザーにメッセージを表示する
-設定画面でユーザーと対話する、フォーム以外のもうひとつの方法がこれです。ユーザーになにかメッセージを表示することができます。 例えば、ユーザーがBotの対応していないモードやマップを選択したとき、警告を表示するなどです。 メッセージを表示するには、次のメッセージをストリームに送信します:
+## Showing a message to a user
+This is another way to interact with the user from the settings screen, separate from showing them a form.It's possible to display a message to the user. For example, when the user selects a map that the bot does not support, a warning can be displayed. To display a message, send the following message to the stream:
```javascript
{
type: 'message',
body: {
- text: 'メッセージ内容',
- type: 'メッセージの種類'
+ text: 'Message contents',
+ type: 'Message type'
}
}
```
-メッセージの種類: `success`, `info`, `warning`, `error`。
+Message types: `success`, `info`, `warning`, `error`。
-## 投了する
-投了をするには、このエンドポイントにリクエストします。
+## Give up
+To give up, send a request to this endpoint.
diff --git a/src/docs/en-US/stream.md b/src/docs/en-US/stream.md
index 07c4f42cf7..6258a515ca 100644
--- a/src/docs/en-US/stream.md
+++ b/src/docs/en-US/stream.md
@@ -1,25 +1,25 @@
-# ストリーミングAPI
+# Streaming API
-ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、メッセージが届いた、フォローされた、など)を受け取ったり、様々な操作を行ったりすることができます。
+By using the streaming API, you can receive various data (such as new posts arriving on the timeline, receiving direct messages, notifications about being followed, etc) in real-time and perform various different actions based on it.
-## ストリームに接続する
+## Connecting to streams
-ストリーミングAPIを利用するには、まずMisskeyサーバーに**websocket**接続する必要があります。
+To use the streaming API, you must first connect to the **websocket** of the Misskey server.
-以下のURLに、`i`というパラメータ名で認証情報を含めて、websocket接続してください。例:
+Connect to the websocket located at the below URL, including your credentials within the `i` parameter.E.g.:
```
%WS_URL%/streaming?i=xxxxxxxxxxxxxxx
```
-認証情報は、自分のAPIキーや、アプリケーションからストリームに接続する際はユーザーのアクセストークンのことを指します。
+Credentials refer to your own API key or the access token granted to an application by a user.
---
-認証情報は省略することもできますが、その場合非ログインでの利用ということになり、受信できる情報や可能な操作は限られます。例:
+It's possible to omit the credentials and use the Streaming API without logging in, but doing so will limit the data that can be received and the functions that can be used.E.g.:
```
%WS_URL%/streaming
@@ -27,15 +27,15 @@
---
-ストリームに接続すると、後述するAPI操作や、投稿の購読を行ったりすることができます。 しかしまだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。 それを行うには、ストリーム上で、後述する**チャンネル**に接続する必要があります。
+To connect to the stream, using the later-mentioned API or subscribing to individual posts is possible. At this stage however it is not possible to receive timeline information about things such as new posts arriving yet. To do this, connecting to later-mentioned **Channels** is required.
-**ストリームでのやり取りはすべてJSONです。**
+**All interactions of sending to and receiving from the Stream are done in JSON format.**
## Channels
-MisskeyのストリーミングAPIにはチャンネルという概念があります。これは、送受信する情報を分離するための仕組みです。 Misskeyのストリームに接続しただけでは、まだリアルタイムでタイムラインの投稿を受信したりはできません。 ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。
+Within the Misskey Streaming API, a concept called Channels exists.These are used for the purpose of separating which data to receive. When first connecting to the Misskey Stream, you can not receive real-time updates yet. By connecting to channels in the stream, both sending and receiving various information related to said channels becomes possible.
-### チャンネルに接続する
-チャンネルに接続するには、次のようなデータをJSONでストリームに送信します:
+### Connecting to a channel
+To connect to a channel, send a message in JSON format like the following to the stream:
```json
{
@@ -50,19 +50,19 @@ MisskeyのストリーミングAPIにはチャンネルという概念があり
}
```
-ここで、
-* `channel`には接続したいチャンネル名を設定します。チャンネルの種類については後述します。
-* `id`にはそのチャンネルとやり取りするための任意のIDを設定します。ストリームでは様々なメッセージが流れるので、そのメッセージがどのチャンネルからのものなのか識別する必要があるからです。このIDは、UUIDや、乱数のようなもので構いません。
-* `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。
+Here,
+* `channel` specifies the name of the channel to connect to.A list of valid channels will be given later.
+* `id` contains an arbitrary ID for both sending to and receiving from this channel.The stream sends out various different messages, so to differentiate which channel a message came from, such an ID is required.This ID can be something such as an UUID or a simple random number generator output.
+* `params` include the parameters for connecting to the channel.Which parameters are required for connecting varies by channel.For channels which do not require any parameters, this property can be omitted.
-
IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。
+
These IDs should be unique for each individual connection to a channel, not for each channel only.This is for cases in which multiple different connections with different parameters are made to the same channel.
-
APIのエンドポイントやパラメータについてはAPIリファレンスをご確認ください。
+
Please check the API reference for possible API endpoints and parameters.
+
+ | ショートカット | 効果 | 由来 |
|---|
+
+
+ | P, N | 新規投稿 | Post, New, Note |
+ | T | タイムラインの最も新しい投稿にフォーカス | Timeline, Top |
+ | Shift + N | 通知を表示/隠す | Notifications |
+ | S | 検索 | 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/th-TH/mfm.md b/src/docs/th-TH/mfm.md
new file mode 100644
index 0000000000..e237287acc
--- /dev/null
+++ b/src/docs/th-TH/mfm.md
@@ -0,0 +1,2 @@
+# MFM
+MFMは、Misskey Flavored Markdownの略で、Misskeyの様々な場所で使用できる専用のマークアップ言語です。 MFMで使用可能な構文は[MFMチートシート](/mfm-cheat-sheet)で確認できます。
diff --git a/src/docs/th-TH/mute.md b/src/docs/th-TH/mute.md
new file mode 100644
index 0000000000..6a9608662a
--- /dev/null
+++ b/src/docs/th-TH/mute.md
@@ -0,0 +1,13 @@
+# ミュート
+
+ユーザーをミュートすると、そのユーザーに関する次のコンテンツがMisskeyに表示されなくなります:
+
+* タイムラインや投稿の検索結果内の、そのユーザーの投稿(およびそれらの投稿に対する返信やRenote)
+* そのユーザーからの通知
+* メッセージ履歴一覧内の、そのユーザーとのメッセージ履歴
+
+ユーザーをミュートするには、対象のユーザーのユーザーページに表示されている「ミュート」ボタンを押します。
+
+ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。
+
+設定>ミュート から、自分がミュートしているユーザー一覧を確認することができます。
diff --git a/src/docs/th-TH/pages.md b/src/docs/th-TH/pages.md
new file mode 100644
index 0000000000..a7311b95e6
--- /dev/null
+++ b/src/docs/th-TH/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/th-TH/reaction.md b/src/docs/th-TH/reaction.md
new file mode 100644
index 0000000000..c26ead75b3
--- /dev/null
+++ b/src/docs/th-TH/reaction.md
@@ -0,0 +1,11 @@
+# リアクション
+他の人のノートに、絵文字を付けて簡単にあなたの反応を伝えられる機能です。 リアクションするには、ノートの + アイコンをクリックしてピッカーを表示し、絵文字を選択します。 リアクションには[カスタム絵文字](./custom-emoji)も使用できます。
+
+## リアクションピッカーのカスタマイズ
+ピッカーに表示される絵文字を自分好みにカスタマイズすることができます。 設定の「リアクション」で設定します。
+
+## リモート投稿へのリアクションについて
+リアクションはMisskeyオリジナルの機能であるため、リモートインスタンスがMisskeyでない限りは、ほとんどの場合「Like」としてアクティビティが送信されます。一般的にはLikeは「お気に入り」として実装されているようです。 また、相手がMisskeyであったとしても、カスタム絵文字リアクションは伝わらず、自動的に「👍」等にフォールバックされます。
+
+## リモートからのリアクションについて
+リモートから「Like」アクティビティを受信したとき、Misskeyでは「👍」のリアクションとして解釈されます。
diff --git a/src/docs/th-TH/reversi-bot.md b/src/docs/th-TH/reversi-bot.md
new file mode 100644
index 0000000000..7ab2a7212e
--- /dev/null
+++ b/src/docs/th-TH/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/th-TH/stream.md b/src/docs/th-TH/stream.md
new file mode 100644
index 0000000000..9011c37c5b
--- /dev/null
+++ b/src/docs/th-TH/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はチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。
+
+
APIのエンドポイントやパラメータについてはAPIリファレンスをご確認ください。
+
- | ショートカット | 効果 | 由来 |
|---|
+ | 快捷键 | 效果 | 来源 |
|---|
- | P, N | 新規投稿 | Post, New, Note |
- | T | タイムラインの最も新しい投稿にフォーカス | Timeline, Top |
- | Shift + N | 通知を表示/隠す | Notifications |
+ | P, N | 发新帖 | Post, New, Note |
+ | T | 转到时间线最新发布的内容 | Timeline, Top |
+ | Shift + N | 显示/隐藏通知 | Notifications |
| S | 搜索 | Search |
- | H, ? | ヘルプを表示 | Help |
+ | 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 | フォーカスを外す | - |
+ | ↑, K, Shift + Tab | 移动到上一个帖子 | - |
+ | ↓, J, Tab | 移动到下一个帖子 | - |
+ | R | 打开回复框 | Reply |
+ | Q | 打开转发框 | Quote |
+ | Ctrl + Q | 快速转发（不打开转发框） | - |
+ | E, A, + | 打开回应框 | Emote, reAction |
+ | 0~9 | 根据相应数字发表回应（详情请参考相关说明） | - |
+ | F, B | 添加到收藏夹 | Favorite, Bookmark |
+ | Del, Ctrl + D | 删除帖子 | Delete |
+ | M, O | 打开帖子菜单 | More, Other |
+ | S | 显示或隐藏CW隐藏的部分 | Show, See |
+ | Esc | 取消选中 | - |
-## Renoteフォーム
+## 转发框
- | ショートカット | 効果 | 由来 |
|---|
+ | 快捷键 | 效果 | 来源 |
|---|
- | Enter | Renoteする | - |
- | Q | フォームを展開する | Quote |
- | Esc | フォームを閉じる | - |
+ | Enter | 转发 | - |
+ | Q | 打开转发框 | Quote |
+ | Esc | 关闭转发框 | - |
-## リアクションフォーム
-デフォルトで「👍」にフォーカスが当たっている状態です。
+## 回应框
+默认使用“👍”作为回应。
- | ショートカット | 効果 | 由来 |
|---|
+ | 快捷键 | 效果 | 来源 |
|---|
- | ↑, K | 上のリアクションにフォーカスを移動 | - |
- | ↓, J | 下のリアクションにフォーカスを移動 | - |
- | ←, H, Shift + Tab | 左のリアクションにフォーカスを移動 | - |
- | →, L, Tab | 右のリアクションにフォーカスを移動 | - |
- | Enter, Space, + | リアクション確定 | - |
- | 0~9 | 数字に対応したリアクションで確定 | - |
- | Esc | リアクションするのをやめる | - |
+ | ↑, K | 移动到上一个回应 | - |
+ | ↓, J | 移动到下一个回应 | - |
+ | ←, H, Shift + Tab | 移动到左边一个回应 | - |
+ | →, L, Tab | 移动到右边一个回应 | - |
+ | Enter, Space, + | 回应确认 | - |
+ | 0~9 | 根据相应数字发表回应 | - |
+ | Esc | 取消回应 | - |
diff --git a/src/docs/zh-CN/mfm.md b/src/docs/zh-CN/mfm.md
index b72c746e24..39199b5e03 100644
--- a/src/docs/zh-CN/mfm.md
+++ b/src/docs/zh-CN/mfm.md
@@ -1,2 +1,2 @@
# MFM
-MFM是Misskey Flavored Markdown的缩写，是一种专用的标记语言，可以用在Misskey的任何地方。 MFM中可用的语法可以在[MFMチートシート](/mfm-cheat-sheet)中找到。
+MFM是Misskey Flavored Markdown的缩写，是一种专用的标记语言，可以用在Misskey的任何地方。 MFM中可用的语法可以在[MFM代码速查表](/mfm-cheat-sheet)中找到。
diff --git a/src/docs/zh-CN/mute.md b/src/docs/zh-CN/mute.md
index 502e04ea80..43a6c12ff7 100644
--- a/src/docs/zh-CN/mute.md
+++ b/src/docs/zh-CN/mute.md
@@ -1,13 +1,13 @@
# 屏蔽
-ユーザーをミュートすると、そのユーザーに関する次のコンテンツがMisskeyに表示されなくなります:
+当您屏蔽用户时，Misskey不再显示有关该用户的以下内容：
-* タイムラインや投稿の検索結果内の、そのユーザーの投稿(およびそれらの投稿に対する返信やRenote)
-* そのユーザーからの通知
-* メッセージ履歴一覧内の、そのユーザーとのメッセージ履歴
+* 时间线帖子搜索结果中的该用户的帖子（以及对这些帖子的回复和转发）。
+* 该用户的通知
+* 用户在消息历史记录列表中的消息历史记录
-ユーザーをミュートするには、対象のユーザーのユーザーページに表示されている「ミュート」ボタンを押します。
+要屏蔽用户，请在该用户页面上点击该用户的“屏蔽”按钮。
-ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。
+不会通知对方您已将其屏蔽，并且对方也不知道自己被屏蔽。
-設定>ミュート から、自分がミュートしているユーザー一覧を確認することができます。
+您可以在“设置”>“屏蔽”下查看被屏蔽的用户列表。
diff --git a/src/docs/zh-CN/pages.md b/src/docs/zh-CN/pages.md
index d0d20dcbef..07fe2428d7 100644
--- a/src/docs/zh-CN/pages.md
+++ b/src/docs/zh-CN/pages.md
@@ -1,7 +1,7 @@
-# Pages
+# 页面
## 变量
-変数を使うことで動的なページを作成できます。テキスト内で { 変数名 } と書くとそこに変数の値を埋め込めます。例えば Hello { thing } world! というテキストで、変数(thing)の値が ai だった場合、テキストは Hello ai world! になります。
+您可以使用变量创建动态页面。您可以在文本中使用{变量名}的格式来引用变量的值。例えば Hello { thing } world! というテキストで、変数(thing)の値が ai だった場合、テキストは Hello ai world! になります。
変数の評価(値を算出すること)は上から下に行われるので、ある変数の中で自分より下の変数を参照することはできません。例えば上から A、B、C と3つの変数を定義したとき、Cの中でAやBを参照することはできますが、Aの中でBやCを参照することはできません。
diff --git a/src/docs/zh-CN/stream.md b/src/docs/zh-CN/stream.md
index 91d4d0e928..33d45e29cf 100644
--- a/src/docs/zh-CN/stream.md
+++ b/src/docs/zh-CN/stream.md
@@ -300,7 +300,7 @@ Misskeyは投稿のキャプチャと呼ばれる仕組みを提供していま
### 流れてくるイベント一覧
-#### `renote`
+#### `转发`
自分の投稿がRenoteされた時に発生するイベントです。自分自身の投稿をRenoteしたときは発生しません。
#### `mention`
diff --git a/src/docs/zh-CN/timelines.md b/src/docs/zh-CN/timelines.md
index 3ac1e114d0..ee7db7f6be 100644
--- a/src/docs/zh-CN/timelines.md
+++ b/src/docs/zh-CN/timelines.md
@@ -1,15 +1,15 @@
-# タイムラインの比較
+# 时间线的比较
-https://docs.google.com/spreadsheets/d/1lxQ2ugKrhz58Bg96HTDK_2F98BUritkMyIiBkOByjHA/edit?usp=sharing
+https://docs.google.com/spreadsheets/d/1YIfTiY6-XccWLYR8SBnJWcY642Rq_jkTEL06BVlPYlQ/edit?usp=sharing
## 首页
-自分のフォローしているユーザーの投稿
+您关注的用户的帖文
## 本地
-全てのローカルユーザーの「ホーム」指定されていない投稿
+所有非指定为「首页」的本地用户的帖文
## 社交
-自分のフォローしているユーザーの投稿と、全てのローカルユーザーの「ホーム」指定されていない投稿
+您关注的用户的帖文，和所有未指定为「首页」的本地用户的帖文
## 全局
-全てのローカルユーザーの「ホーム」指定されていない投稿と、サーバーに届いた全てのリモートユーザーの「ホーム」指定されていない投稿
+所有本地用户的未指定为「首页」的帖文，和所有到达服务器的远程用户的未指定为「首页」的帖文
diff --git a/src/docs/zh-TW/reaction.md b/src/docs/zh-TW/reaction.md
index f807f9cd21..8640cb70a5 100644
--- a/src/docs/zh-TW/reaction.md
+++ b/src/docs/zh-TW/reaction.md
@@ -1,4 +1,4 @@
-# 反應
+# 情感
他の人のノートに、絵文字を付けて簡単にあなたの反応を伝えられる機能です。 リアクションするには、ノートの + アイコンをクリックしてピッカーを表示し、絵文字を選択します。 リアクションには[カスタム絵文字](./custom-emoji)も使用できます。
## リアクションピッカーのカスタマイズ