diff options
| author | syuilo <Syuilotan@yahoo.co.jp> | 2021-11-13 12:23:49 +0900 |
|---|---|---|
| committer | syuilo <Syuilotan@yahoo.co.jp> | 2021-11-13 12:23:49 +0900 |
| commit | 2795fe457909c687f668d020ef65d52abc3182fb (patch) | |
| tree | 0a52e4e4d854333496fcc487560c93c3de5d5eb5 /src/docs/zh-CN | |
| parent | Merge branch 'develop' (diff) | |
| parent | 12.96.0 (diff) | |
| download | misskey-2795fe457909c687f668d020ef65d52abc3182fb.tar.gz misskey-2795fe457909c687f668d020ef65d52abc3182fb.tar.bz2 misskey-2795fe457909c687f668d020ef65d52abc3182fb.zip | |
Merge branch 'develop'
Diffstat (limited to 'src/docs/zh-CN')
50 files changed, 0 insertions, 2242 deletions
diff --git a/src/docs/zh-CN/admin/disable-timelines.md b/src/docs/zh-CN/admin/disable-timelines.md deleted file mode 100644 index fdc66a6898..0000000000 --- a/src/docs/zh-CN/admin/disable-timelines.md +++ /dev/null @@ -1,8 +0,0 @@ -# 禁用 LTL/STL/GTL -Misskey 允许您禁用 LTL/STL/GTL。如果需要启用/禁用，请在实例控制面板中进行设置。 - -LTL 和 STL 的优点是新用户不必寻找用户，因为他们可以查看来自所有实例的帖子，从而更容易找到感兴趣的用户。 但同时它也存在着诸多缺点，例如无法使用关注，容易看到不适宜的帖子，感觉像小圈子内部对话一样而使新用户难以参与等等。 不同的服务器会有不同的优缺点，因此可以选择禁用它们。 如果您认为弊大于利，请考虑禁用这些时间线。 - -<div class="warn">⚠️ 禁用后可能会使用户感到困惑，并导致短期内的用户数量减少。因此，建议在禁用时慎重考虑影响。建议事先发布声明并留出一定时间作为过渡。</div> - -请注意，这些时间线的禁用状态不适用于管理员/版主，这些用户可以继续使用。 diff --git a/src/docs/zh-CN/admin/faq.md b/src/docs/zh-CN/admin/faq.md deleted file mode 100644 index 00d0b5e8c1..0000000000 --- a/src/docs/zh-CN/admin/faq.md +++ /dev/null @@ -1,5 +0,0 @@ -# 常见问题 -这里会列出对于服务器管理员的一些常见问题。 - -## 希望设置默认主题 -目前尚未实现默认主题设置功能。 diff --git a/src/docs/zh-CN/advanced/aiscript.md b/src/docs/zh-CN/advanced/aiscript.md deleted file mode 100644 index 5622a82320..0000000000 --- a/src/docs/zh-CN/advanced/aiscript.md +++ /dev/null @@ -1,7 +0,0 @@ -# AiScript -AiScript是Misskey所使用的脚本语言。 - -<div class="info">AiScript 的实现独立于 Misskey 的存储库，并且是 <a href="https://github.com/syuilo/aiscript" target="_blank"> 开源的。 </a></div> - -## 用法 -AiScript 语法和内置函数等文档会在 [ 这里 ](https://github.com/syuilo/aiscript/tree/master/docs) 发布。 diff --git a/src/docs/zh-CN/advanced/api.md b/src/docs/zh-CN/advanced/api.md deleted file mode 100644 index a1ca2f470b..0000000000 --- a/src/docs/zh-CN/advanced/api.md +++ /dev/null @@ -1,58 +0,0 @@ -# Misskey API - -您可以使用Misskey API来开发Misskey客户端、与Misskey链接的Web服务、Bot等应用（以下称为“应用程序”）。 另外还有一个流式API，因此还可以用来创建实时性的应用程序。 - -开始使用API前，您首先需要获取访问令牌。 本文档将向您介绍获取访问令牌所需的步骤，以及API的基本使用方法。 - -## 访问令牌的获取 -总的来说，API请求需要访问令牌。 获取方式则根据请求的API或者非特定用户所使用的应用程序而有所不同。 - -* 对于前者：请转到[“手动发放自己的访问令牌”](#自分自身のアクセストークンを手動発行する) -* 对于后者：请转到[“请求应用程序用户发放访问令牌”](#アプリケーション利用者にアクセストークンの発行をリクエストする) - -### 手动发放自己的访问令牌 -您可以在“设置 > API”中发放自己的访问令牌。 - -[请转到“API使用方法”](#APIの使い方) - -### 请求应用程序用户发放访问令牌 -要获取应用程序用户的访问令牌，请按照以下步骤请求发放。 - -#### 步骤 1 - -生成UUID。以下将其称为会话ID。 - -> 此会话ID需要每次重新生成，请勿重复使用。 - -#### 步骤 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` - * 重定向时，会话ID将添加查询参数`session` -* `permission` ... 应用程序要求的权限 - * > 例: `write:notes,write:following,read:drive` - * 要求的权限需要以`,`分隔 - * 您可以在[API参考](/api-doc)中确认您所拥有的权限。 - -#### 步骤 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/zh-CN/advanced/create-plugin.md b/src/docs/zh-CN/advanced/create-plugin.md deleted file mode 100644 index a32d36fa8e..0000000000 --- a/src/docs/zh-CN/advanced/create-plugin.md +++ /dev/null @@ -1,74 +0,0 @@ -# 插件开发 -Misskey Web客户端插件功能使您可以扩展客户端并添加各种功能。 我们在这里给出用于创建插件的元数据定义和AiScript API参考。 - -## 元数据 -插件必须使用AiScript的元数据嵌入功能将插件的元数据定义为默认值。 元数据是一个包含以下属性的对象： - -### name -插件名称 - -### author -插件作者 - -### version -插件版本。请使用数字。 - -### description -插件说明 - -### permissions -插件要求的权限。需要在发送Misskey API请求时使用。 - -### 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 -存储插件设置的对象。该值是通过插件定义的配置中设置的键值来传入的。 diff --git a/src/docs/zh-CN/advanced/develop-bot.md b/src/docs/zh-CN/advanced/develop-bot.md deleted file mode 100644 index 593c61891e..0000000000 --- a/src/docs/zh-CN/advanced/develop-bot.md +++ /dev/null @@ -1,6 +0,0 @@ -# 新建 Bot -您可以使用 [Misskey API](./api)来开发Bot机器人。此外，一些机器人已经公开发布，您可以把它们作为参考。 - -- [syuilo/ai](https://github.com/syuilo/ai) ... 运行在Node.js上的TypeScript实现的Bot - -创建机器人时，我们强烈建议您在个人资料设置中启用Bot机器人标志。 diff --git a/src/docs/zh-CN/advanced/reversi-bot.md b/src/docs/zh-CN/advanced/reversi-bot.md deleted file mode 100644 index 96a252b382..0000000000 --- a/src/docs/zh-CN/advanced/reversi-bot.md +++ /dev/null @@ -1,160 +0,0 @@ -# Misskey黑白棋机器人开发 -下面列出的是为 Misskey 黑白棋功能开发一个Bot机器人的方法。 - -1. 使用以下参数来连接到`games/reversi`流： - * `i`: bot账号的API Key - -2. 当出现对局邀请时，流中会触发`invited`事件 - * 事件内容中包含邀请您参加游戏的用户信息，用户名字为`parent`。 - -3. 向`games/reversi/match`发送请求，其中`user_id`包含`parent`的`id` - -4. 请求成功时将返回游戏信息，可以使用以下参数连接到`games/reversi-game`流： - * `i`: bot账号的API Key - * `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`。 - -## 认输 -要认输，请发送请求到<a href="./api/endpoints/games/reversi/games/surrender">这个终端</a>。 diff --git a/src/docs/zh-CN/advanced/share-page.md b/src/docs/zh-CN/advanced/share-page.md deleted file mode 100644 index 56f6d5ec19..0000000000 --- a/src/docs/zh-CN/advanced/share-page.md +++ /dev/null @@ -1,54 +0,0 @@ -# 分享页面 -`/share`を開くと、共有用の投稿フォームを開くことができます。 ここではシェアページで利用できるクエリ文字列の一覧を示します。 - -## 查询文本列表 -### 文本 - -<dl> -<dt>title</dt> -<dd>标题。[ … ]将被插入到文本开头。</dd> -<dt>text</dt> -<dd>正文。</dd> -<dt>url</dt> -<dd>URL。它将被插入到末尾。</dd> -</dl> - -### リプライ情報 -以下のいずれか - -<dl> -<dt>replyId</dt> -<dd>リプライ先のノートid</dd> -<dt>replyUri</dt> -<dd>リプライ先のUrl（リモートのノートオブジェクトを指定）</dd> -</dl> - -### Renote情報 -以下のいずれか - -<dl> -<dt>renoteId</dt> -<dd>Renote先のノートid</dd> -<dt>renoteUri</dt> -<dd>Renote先のUrl（リモートのノートオブジェクトを指定）</dd> -</dl> - -### 可见性 -※specifiedに相当する値はvisibility=specifiedとvisibleAccts/visibleUserIdsで指定する - -<dl> -<dt>visibility</dt> -<dd>公開範囲 ['public' | 'home' | 'followers' | 'specified']</dd> -<dt>localOnly</dt> -<dd>0(false) or 1(true)</dd> -<dt>visibleUserIds</dt> -<dd>specified時のダイレクト先のユーザーid カンマ区切りで</dd> -<dt>visibleAccts</dt> -<dd>specified時のダイレクト先のacct（＠?username[＠host]） カンマ区切りで</dd> -</dl> - -### 文件 -<dl> -<dt>fileIds</dt> -<dd>添付したいファイルのid（カンマ区切りで）</dd> -</dl> diff --git a/src/docs/zh-CN/advanced/stream.md b/src/docs/zh-CN/advanced/stream.md deleted file mode 100644 index 16093e0b96..0000000000 --- a/src/docs/zh-CN/advanced/stream.md +++ /dev/null @@ -1,350 +0,0 @@ -# 流式API - -通过流式API，您可以实时接收各种信息（例如，你的时间线中的新帖文，收到的消息，关注等），并进行各种操作。 - -## 连接到流 - -要使用流式API，您需要使用**websocket**连接到Misskey服务器。 - -请使用参数`i`连接到以下URL，并在websocket连接中包含认证信息。例如： -``` -%WS_URL%/streaming?i=xxxxxxxxxxxxxxx -``` - -认证信息是您的API密钥，从应用程序连接到流时需要引用的用户访问令牌 - -<div class="info">ℹ️ 关于如何获取认证信息，请参考<a href="./api">此文档</a>。</div> - ---- - -您可以省略身份验证信息。此时无需登录即可使用，但是可以接收的信息和可以执行的操作将受到限制。例： - -``` -%WS_URL%/streaming -``` - ---- - -ストリームに接続すると、後述するAPI操作や、投稿の購読を行ったりすることができます。 しかしまだこの段階では、例えばタイムラインへの新しい投稿を受信したりすることはできません。 それを行うには、ストリーム上で、後述する**チャンネル**に接続する必要があります。 - -**ストリームでのやり取りはすべてJSONです。** - -## 频道 -MisskeyのストリーミングAPIにはチャンネルという概念があります。これは、送受信する情報を分離するための仕組みです。 Misskeyのストリームに接続しただけでは、まだリアルタイムでタイムラインの投稿を受信したりはできません。 ストリーム上でチャンネルに接続することで、様々な情報を受け取ったり情報を送信したりすることができるようになります。 - -ひとつのストリーム上で、同時に複数のチャンネルに接続することができます。 - -### 连接到频道 -要连接到频道，请将JSON数据发送到流： - -```json -{ - type: 'connect', - body: { - channel: 'xxxxxxxx', - id: 'foobar', - params: { - ... - } - } -} -``` - -其中： -* `channel`には接続したいチャンネル名を設定します。频道类型将在后面说明。 -* `id`にはそのチャンネルとやり取りするための任意のIDを設定します。ストリームでは様々なメッセージが流れるので、そのメッセージがどのチャンネルからのものなのか識別する必要があるからです。このIDは、UUIDや、乱数のようなもので構いません。 -* `params`はチャンネルに接続する際のパラメータです。チャンネルによって接続時に必要とされるパラメータは異なります。パラメータ不要のチャンネルに接続する際は、このプロパティは省略可能です。 - -<div class="info">ℹ️ IDはチャンネルごとではなく「チャンネルの接続ごと」です。なぜなら、同じチャンネルに異なるパラメータで複数接続するケースもあるからです。</div> - -### 从频道接收消息 -例えばタイムラインのチャンネルなら、新しい投稿があった時にメッセージを発します。そのメッセージを受け取ることで、タイムラインに新しい投稿がされたことをリアルタイムで知ることができます。 - -当频道发送消息时，以下数据将以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`には、エンドポイントのパラメータを含めます。 - -<div class="info">ℹ️ APIのエンドポイントやパラメータについてはAPIリファレンスをご確認ください。</div> - -### レスポンスの受信 - -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/zh-CN/aiscript.md b/src/docs/zh-CN/aiscript.md deleted file mode 100644 index 0747cf8751..0000000000 --- a/src/docs/zh-CN/aiscript.md +++ /dev/null @@ -1,4 +0,0 @@ -# AiScript - -## 函数 -传递默认值。 diff --git a/src/docs/zh-CN/api.md b/src/docs/zh-CN/api.md deleted file mode 100644 index 4a67622e30..0000000000 --- a/src/docs/zh-CN/api.md +++ /dev/null @@ -1,58 +0,0 @@ -# Misskey API - -您可以使用Misskey API来开发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` - * 重定向时，会话ID将添加查询参数`session` -* `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/zh-CN/create-plugin.md b/src/docs/zh-CN/create-plugin.md deleted file mode 100644 index beda1c0423..0000000000 --- a/src/docs/zh-CN/create-plugin.md +++ /dev/null @@ -1,74 +0,0 @@ -# 插件开发 -Misskey Web客户端插件功能使您可以扩展客户端并添加各种功能。 我们在这里给出用于创建插件的元数据定义和AiScript API参考。 - -## 元数据 -插件必须使用AiScript的元数据嵌入功能将插件的元数据定义为默认值。 元数据是一个包含以下属性的对象： - -### name -插件名称 - -### author -插件作者 - -### version -插件版本。请使用数字。 - -### description -插件说明 - -### permissions -插件要求的权限。在发送Misskey API请求时需要使用。 - -### 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 -存储插件设置的对象。该值是通过插件定义的配置中设置的键值来传入的。 diff --git a/src/docs/zh-CN/custom-emoji.md b/src/docs/zh-CN/custom-emoji.md deleted file mode 100644 index 7c55a6b409..0000000000 --- a/src/docs/zh-CN/custom-emoji.md +++ /dev/null @@ -1,2 +0,0 @@ -# 自定义表情符号 -表情符号功能可以让您在各个地方使用预置的图像表情。 它可以用于发帖，回应，聊天，自我介绍和姓名等地方。 要在这些位置使用自定义表情符号，请按表情符号选择按钮（如果有）或键入`:`以显示表情符号建议。 如果在文本中找到格式为`:foo:`的字符串，则将`foo`部分解释为自定义表情符号名称，并在显示时替换为相应的自定义表情符号。 diff --git a/src/docs/zh-CN/deck.md b/src/docs/zh-CN/deck.md deleted file mode 100644 index b1f114e714..0000000000 --- a/src/docs/zh-CN/deck.md +++ /dev/null @@ -1,18 +0,0 @@ -# Deck - -卡片是一种可用的用户界面。它的特点是能够通过并排显示多个视图（称为 "列"）来构建高度可定制和信息丰富的用户界面。 - -## 添加列 -您可以在卡牌背景上点击右键单击「添加列」来新增任意的列。 - -## 移动列 -可以通过拖放列来与其他列互换位置，也可以从列菜单中移动列（右键单击列标题）。 - -## 水平拆分列 -列不仅可以从左到右排列，还可以垂直叠加。 如果打开列菜单，选择「向左折叠」，当前列将被移到左列下方。 要取消垂直折叠，请选择列菜单中的「向右弹出」。 - -## 列的设置 -选择列菜单的「编辑」时，可编辑当前列的设置。您可以重新命名列，或是改变列的宽度。 - -## Deck的设置 -您可以在[settings/deck](/settings/deck)行中配置您Deck相关的设置。 diff --git a/src/docs/zh-CN/features/antenna.md b/src/docs/zh-CN/features/antenna.md deleted file mode 100644 index 4645df2d6e..0000000000 --- a/src/docs/zh-CN/features/antenna.md +++ /dev/null @@ -1,4 +0,0 @@ -# 天线 -アンテナは、自由に条件を設定して、合致するノートを自動で収集することができる機能です。 - -条件を設定したアンテナが作成された状態で、条件に合致するノートが投稿されると、リアルタイムでそのアンテナのタイムラインにノートが追加されます。 diff --git a/src/docs/zh-CN/features/custom-emoji.md b/src/docs/zh-CN/features/custom-emoji.md deleted file mode 100644 index 9fc18a70fc..0000000000 --- a/src/docs/zh-CN/features/custom-emoji.md +++ /dev/null @@ -1,2 +0,0 @@ -# 自定义表情符号 -カスタム絵文字は、インスタンスで用意された画像を絵文字のように使える機能です。 ノート、リアクション、チャット、自己紹介、名前などの場所で使うことができます。 カスタム絵文字をそれらの場所で使うには、絵文字ピッカーボタン(ある場合)を押すか、`:`を入力して絵文字サジェストを表示します。 テキスト内に`:foo:`のような形式の文字列が見つかると、`foo`の部分がカスタム絵文字名と解釈され、表示時には対応したカスタム絵文字に置き換わります。 diff --git a/src/docs/zh-CN/features/deck.md b/src/docs/zh-CN/features/deck.md deleted file mode 100644 index 73e9efdaaf..0000000000 --- a/src/docs/zh-CN/features/deck.md +++ /dev/null @@ -1,18 +0,0 @@ -# Deck - -デッキは利用可能なUIのひとつです。「カラム」と呼ばれるビューを複数並べて表示させることで、カスタマイズ性が高く、情報量の多いUIが構築できることが特徴です。 - -## カラムの追加 -デッキの背景を右クリックし、「カラムを追加」して任意のカラムを追加できます。 - -## カラムの移動 -カラムは、ドラッグアンドドロップで他のカラムと位置を入れ替えることが出来るほか、カラムメニュー(カラムのヘッダー右クリック)から位置を移動させることもできます。 - -## カラムの水平分割 -カラムは左右だけでなく、上下に並べることもできます。 カラムメニューを開き、「左に重ねる」を選択すると、左のカラムの下に現在のカラムが移動します。 上下分割を解除するには、カラムメニューの「右に出す」を選択します。 - -## カラムの設定 -カラムメニューの「編集」を選択するとカラムの設定を編集できます。カラムの名前を変えたり、幅を変えたりできます。 - -## デッキの設定 -デッキに関する設定は、[settings/deck](/settings/deck)で行えます。 diff --git a/src/docs/zh-CN/features/drive.md b/src/docs/zh-CN/features/drive.md deleted file mode 100644 index 4728ccf659..0000000000 --- a/src/docs/zh-CN/features/drive.md +++ /dev/null @@ -1,17 +0,0 @@ -# 网盘 -ドライブは、Misskey上でファイルを管理できる機能です。 - -[ドライブのページ](/my/drive)から任意のファイルをアップロードできるほか、アバターに設定した画像や、ノートに添付したファイルなどもすべてドライブにアップロードされます。 - -<div class="warn">⚠️ ドライブからファイルを削除すると、そのファイルが添付されたノートも消えます。</div> - -ドライブにアップロードされたファイルは、いつでもダウンロードすることができるほか、ノート作成時に「ドライブからファイルを添付」することでファイルを再利用することもできます。 - -ドライブ内にフォルダを作り、複数のファイルをまとめて整理することもできます。 - -## 閲覧注意 (NSFW) -<div class="info">ℹ️ この項目が閲覧注意なわけではありません</div> - -閲覧注意またはNSFW (Not safe for work) は、ドライブのファイルに設定することができるフラグです。 閲覧注意フラグを設定されたファイルは、表示される際に閲覧者の操作なしには表示されなくなります。 このフラグは、例えば職場や公共の場で閲覧するのに適切でないと思われる画像などに設定し、そのような画像が突然表示されてしまうことを防ぐ目的で使われます。 - -このフラグは手動でオンオフを切り替えられるほか、モデレーターの判断で設定される場合もあります。 diff --git a/src/docs/zh-CN/features/favorite.md b/src/docs/zh-CN/features/favorite.md deleted file mode 100644 index 587687f77d..0000000000 --- a/src/docs/zh-CN/features/favorite.md +++ /dev/null @@ -1,4 +0,0 @@ -# 收藏 -[ノート](./node)をお気に入りとして登録できる機能です。 お気に入り登録したノートは、[お気に入りページ](./my/favorites)で一覧することができます。 お気に入りに登録したことは相手に通知されず、お気に入りは自分しか見ることができません。 - -ノートをお気に入り登録するには、ノートメニューの「お気に入り」を押します。お気に入り解除するには、ノートメニューの「お気に入り解除」を押します。 diff --git a/src/docs/zh-CN/features/follow.md b/src/docs/zh-CN/features/follow.md deleted file mode 100644 index 2a95aa6dc4..0000000000 --- a/src/docs/zh-CN/features/follow.md +++ /dev/null @@ -1,2 +0,0 @@ -# 关注 -当您关注一名用户时，您可以在您的时间线上看到该用户的发帖。但是不包含该用户对其他用户的回复。 要关注一名用户，请点击该用户页面上的“关注”按钮。如果需要取消关注，请再次点击该按钮。 diff --git a/src/docs/zh-CN/features/keyboard-shortcut.md b/src/docs/zh-CN/features/keyboard-shortcut.md deleted file mode 100644 index b555e34f40..0000000000 --- a/src/docs/zh-CN/features/keyboard-shortcut.md +++ /dev/null @@ -1,66 +0,0 @@ -# キーボードショートカット - -## 全局 -これらのショートカットは基本的にどこでも使えます。 -<table> - <thead> - <tr><th>ショートカット</th><th>効果</th><th>由来</th></tr> - </thead> - <tbody> - <tr><td><kbd class="key">P</kbd>, <kbd class="key">N</kbd></td><td>新規投稿</td><td><b>P</b>ost, <b>N</b>ew, <b>N</b>ote</td></tr> - <tr><td><kbd class="key">T</kbd></td><td>タイムラインの最も新しい投稿にフォーカス</td><td><b>T</b>imeline, <b>T</b>op</td></tr> - <tr><td><kbd class="group"><kbd class="key">Shift</kbd> + <kbd class="key">N</kbd></kbd></td><td>通知を表示/隠す</td><td><b>N</b>otifications</td></tr> - <tr><td><kbd class="key">S</kbd></td><td>搜索</td><td><b>S</b>earch</td></tr> - <tr><td><kbd class="key">H</kbd>, <kbd class="key">?</kbd></td><td>ヘルプを表示</td><td><b>H</b>elp</td></tr> - </tbody> -</table> - -## 投稿にフォーカスされた状態 -<table> - <thead> - <tr><th>ショートカット</th><th>効果</th><th>由来</th></tr> - </thead> - <tbody> - <tr><td><kbd class="key">↑</kbd>, <kbd class="key">K</kbd>, <kbd class="group"><kbd class="key">Shift</kbd> + <kbd class="key">Tab</kbd></kbd></td><td>上の投稿にフォーカスを移動</td><td>-</td></tr> - <tr><td><kbd class="key">↓</kbd>, <kbd class="key">J</kbd>, <kbd class="key">Tab</kbd></td><td>下の投稿にフォーカスを移動</td><td>-</td></tr> - <tr><td><kbd class="key">R</kbd></td><td>返信フォームを開く</td><td><b>R</b>eply</td></tr> - <tr><td><kbd class="key">Q</kbd></td><td>Renoteフォームを開く</td><td><b>Q</b>uote</td></tr> - <tr><td><kbd class="group"><kbd class="key">Ctrl</kbd> + <kbd class="key">Q</kbd></kbd></td><td>即刻Renoteする(フォームを開かずに)</td><td>-</td></tr> - <tr><td><kbd class="key">E</kbd>, <kbd class="key">A</kbd>, <kbd class="key">+</kbd></td><td>リアクションフォームを開く</td><td><b>E</b>mote, re<b>A</b>ction</td></tr> - <tr><td><kbd class="key">0</kbd>~<kbd class="key">9</kbd></td><td>数字に対応したリアクションをする(対応については後述)</td><td>-</td></tr> - <tr><td><kbd class="key">F</kbd>, <kbd class="key">B</kbd></td><td>お気に入りに登録</td><td><b>F</b>avorite, <b>B</b>ookmark</td></tr> - <tr><td><kbd class="key">Del</kbd>, <kbd class="group"><kbd class="key">Ctrl</kbd> + <kbd class="key">D</kbd></kbd></td><td>投稿を削除</td><td><b>D</b>elete</tr> - <tr><td><kbd class="key">M</kbd>, <kbd class="key">O</kbd></td><td>投稿に対するメニューを開く</td><td><b>M</b>ore, <b>O</b>ther</td></tr> - <tr><td><kbd class="key">S</kbd></td><td>显示或隐藏CW的隐藏部分</td><td><b>S</b>how, <b>S</b>ee</td></tr> - <tr><td><kbd class="key">Esc</kbd></td><td>フォーカスを外す</td><td>-</td></tr> - </tbody> -</table> - -## Renoteフォーム -<table> - <thead> - <tr><th>ショートカット</th><th>効果</th><th>由来</th></tr> - </thead> - <tbody> - <tr><td><kbd class="key">Enter</kbd></td><td>Renoteする</td><td>-</td></tr> - <tr><td><kbd class="key">Q</kbd></td><td>フォームを展開する</td><td><b>Q</b>uote</td></tr> - <tr><td><kbd class="key">Esc</kbd></td><td>フォームを閉じる</td><td>-</td></tr> - </tbody> -</table> - -## リアクションフォーム -デフォルトで「👍」にフォーカスが当たっている状態です。 -<table> - <thead> - <tr><th>ショートカット</th><th>効果</th><th>由来</th></tr> - </thead> - <tbody> - <tr><td><kbd class="key">↑</kbd>, <kbd class="key">K</kbd></td><td>上のリアクションにフォーカスを移動</td><td>-</td></tr> - <tr><td><kbd class="key">↓</kbd>, <kbd class="key">J</kbd></td><td>下のリアクションにフォーカスを移動</td><td>-</td></tr> - <tr><td><kbd class="key">←</kbd>, <kbd class="key">H</kbd>, <kbd class="group"><kbd class="key">Shift</kbd> + <kbd class="key">Tab</kbd></kbd></td><td>左のリアクションにフォーカスを移動</td><td>-</td></tr> - <tr><td><kbd class="key">→</kbd>, <kbd class="key">L</kbd>, <kbd class="key">Tab</kbd></td><td>右のリアクションにフォーカスを移動</td><td>-</td></tr> - <tr><td><kbd class="key">Enter</kbd>, <kbd class="key">Space</kbd>, <kbd class="key">+</kbd></td><td>リアクション確定</td><td>-</td></tr> - <tr><td><kbd class="key">0</kbd>~<kbd class="key">9</kbd></td><td>数字に対応したリアクションで確定</td><td>-</td></tr> - <tr><td><kbd class="key">Esc</kbd></td><td>リアクションするのをやめる</td><td>-</td></tr> - </tbody> -</table> diff --git a/src/docs/zh-CN/features/mfm.md b/src/docs/zh-CN/features/mfm.md deleted file mode 100644 index 8bcaacbed7..0000000000 --- a/src/docs/zh-CN/features/mfm.md +++ /dev/null @@ -1,12 +0,0 @@ -# MFM -MFM是Misskey Flavored Markdown的缩写，是一种专用的标记语言，可以用在Misskey的任何地方。 MFM中可用的语法可以在[MFM代码速查表](/mfm-cheat-sheet)中找到。 - -## 使用 MFM 的位置示例 -- 帖子正文 -- CW注释 -- 用户姓名 -- 用户自我介绍 - -## 面向开发者的信息 -MFM 的解析器实现作为库发布，可以轻松地将 MFM 嵌入到客户端中。 -- [misskey-dev/mfm.js](https://github.com/misskey-dev/mfm.js) - JavaScript的解析器实现 diff --git a/src/docs/zh-CN/features/mute-and-block.md b/src/docs/zh-CN/features/mute-and-block.md deleted file mode 100644 index 39ed8459d0..0000000000 --- a/src/docs/zh-CN/features/mute-and-block.md +++ /dev/null @@ -1,41 +0,0 @@ -# 屏蔽/拉黑 -好みではないユーザーがいる場合は、ミュートを行うことでそのユーザーが自分から見えないようにすることができます。 また、より強力な措置として、ブロックを行うことでそのユーザーから自分のコンテンツが見えないようになるほか、自分に対して関わることができないようにすることができます。 ミュートされていることは相手は分かりませんが、ブロックされていることは相手に分かります。どちらを選ぶかはご自身の判断で行ってください。 - -<div class="info">ℹ️ ミュートとブロックは併用できます。</div> - -<div class="warn">⚠️ 利用規約に違反するような、迷惑なユーザーがいる場合は運営者に報告することも検討してください。</div> - -設定>ミュートとブロック から、自分がミュートまたはブロックしているユーザー一覧を確認することができます。 - -## 屏蔽 -ユーザーをミュートすると、そのユーザーに関する次のコンテンツがMisskeyに表示されなくなります: - -- タイムラインや投稿の検索結果内の、そのユーザーの投稿(およびそれらの投稿に対する返信やRenote) -- そのユーザーからの通知 -- メッセージ履歴一覧内の、そのユーザーとのメッセージ履歴 -- など - -ユーザーをミュートするには、対象のユーザーのユーザーページのメニューを開き、「ミュート」ボタンを押します。 - -<div class="info">ℹ️ ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。</div> - -## 拉黑 -ユーザーをブロックすると、そのユーザーからあなたのコンテンツが見えないようになり、またあなたに対して以下のようなアクションをすることができなくなります。 - -- フォローする -- ユーザーリストに追加する -- 返信する、Renoteする -- リアクションする、アンケートに投票する -- メッセージを送信する -- など - -また、 - -- ブロックする際に既にそのユーザーからフォローされていた場合はフォローが解除されます。 -- ブロックする際に既にそのユーザーがあなたをユーザーリストに入れていた場合はそのリストからあなたが削除されます。 - -ユーザーをブロックするには、対象のユーザーのユーザーページのメニューを開き、「ブロック」ボタンを押します。 - -<div class="warn">⚠️ ブロックを行ったこと自体は相手に通知されませんが、フォローを行ったりなどの上記のアクションが行えなくなるので間接的にブロックされていることは分かります。</div> - -<div class="warn">⚠️ 相手から自分のコンテンツが見えなくなりますが、相手がアカウントを切り替えたりログアウト状態になれば見ることができます。あくまで簡易的、補助的なものとしてお考えください。</div> diff --git a/src/docs/zh-CN/features/mute.md b/src/docs/zh-CN/features/mute.md deleted file mode 100644 index 502e04ea80..0000000000 --- a/src/docs/zh-CN/features/mute.md +++ /dev/null @@ -1,13 +0,0 @@ -# 屏蔽 - -ユーザーをミュートすると、そのユーザーに関する次のコンテンツがMisskeyに表示されなくなります: - -* タイムラインや投稿の検索結果内の、そのユーザーの投稿(およびそれらの投稿に対する返信やRenote) -* そのユーザーからの通知 -* メッセージ履歴一覧内の、そのユーザーとのメッセージ履歴 - -ユーザーをミュートするには、対象のユーザーのユーザーページに表示されている「ミュート」ボタンを押します。 - -ミュートを行ったことは相手に通知されず、ミュートされていることを知ることもできません。 - -設定>ミュート から、自分がミュートしているユーザー一覧を確認することができます。 diff --git a/src/docs/zh-CN/features/note.md b/src/docs/zh-CN/features/note.md deleted file mode 100644 index b3ed79c8ea..0000000000 --- a/src/docs/zh-CN/features/note.md +++ /dev/null @@ -1,54 +0,0 @@ -# 帖子 -ノートは、Misskeyに投稿される、文章、ファイル、アンケートなどを含むコンテンツで、Misskeyの中心的概念です。また、そのノートを作成する行為自体もノートと呼ばれます。 - -ノートが作成されると、[タイムライン](./timeline)に追加され、自分の[フォロワー](./follow)やサーバーのユーザーが見れるようになります。 - -ノートには、[リアクション](./reaction)を行うことができます。また、返信や引用もできます。 - -ノートを[お気に入り](./favorite)登録することで、後で簡単に見返すことができます。 - -## ノートを作成する -ノートを作成するには、画面上にある鉛筆マークのボタンを押して、作成フォームを開きます。作成フォームに内容を入力し、「ノート」ボタンを押すことでノートが作成されます。 ノートには、画像、動画など任意のファイルや、[アンケート](./poll)を添付することができます。您还可以通过在文本中使用[MFM](./mfm)来将[提及](./mention)和[Hash标签](./hashtag)包含在内。 另外还可以设置CW的可见范围等(详细说明见后文)。 -<div class="info">ℹ️ コンピューターのクリップボードに画像データがある状態で、フォーム内のテキストボックスにペーストするとその画像を添付することができます。</div> -<div class="info">ℹ️ テキストボックス内で<kbd class="key">Ctrl + Enter</kbd>を押すことでも投稿できます。</div> - -## 转发 -既にあるノートを引用、もしくはそのノートを新しいノートとして共有する行為、またそれによって作成されたノートをRenoteと呼びます。 自分がフォローしているユーザーの、気に入ったノートを自分のフォロワーに共有したい場合や、過去の自分のノートを再度共有したい場合に使います。 同じノートに対して無制限にRenoteを行うことができますが、あまり連続して使用すると迷惑になる場合もあるので、注意しましょう。 -<div class="warn">⚠️ 公開範囲がフォロワーやダイレクトのノートはRenoteできません</div> - -Renoteを削除するには、Renoteの時刻表示の隣にある「...」を押し、「Renote解除」を選択します。 - -## CW -Contents Warningの略で、ノートの内容を、閲覧者の操作なしには表示しないようにできる機能です。主に長大な内容を隠すためや、ネタバレ防止などに使うことができます。 設定するには、フォームの「内容を隠す」ボタン(目のアイコン)を押します。すると新しい入力エリアが表れるので、そこに内容の要約を記入します。 - -## 可见性 -ノートごとに、そのノートが公開される範囲を設定することができます。フォームの「ノート」ボタンの左にあるアイコンを押すと公開範囲を以下から選択できます。 - -### 公开 -全ての人に対してノートが公開されるほか、サーバーの全てのタイムライン(ホームタイムライン、ローカルタイムライン、ソーシャルタイムライン、グローバルタイムライン)にノートが流れます。 -<div class="warn">⚠️ アカウントが<a href="./silence">サイレンス</a>状態の時は、この公開範囲は使用できません。</div> - -### 首页 -全ての人に対してノートが公開されますが、フォロワー以外のローカルタイムライン、ソーシャルタイムライン、グローバルタイムラインにはノートは流れません。 - -### 关注者 -自分のフォロワーに対してのみノートを公開します。フォロワーの全てのタイムラインに流れます。 - -### 指定用户 -指定したユーザーに対してのみノートを公開します。指定したユーザーの全てのタイムラインに流れます。 - -### 「ローカルのみ」オプション -このオプションを有効にすると、リモートにノートを連合しなくなります。 - -### 公開範囲の比較 -<table> - <tr><th></th><th>公开</th><th>首页</th><th>关注者</th><th>指定用户</th></tr> - <tr><th>フォロワーのLTL/STL/GTL</th><td>✔</td><td>✔</td><td>✔</td><td></td></tr> - <tr><th>非フォロワーのLTL/STL/GTL</th><td>✔</td><td></td><td></td><td></td></tr> -</table> - -## 置顶 -ノートをピン留めすると、ユーザーページに常にそのノートを表示しておくことができます。 ノートのメニューを開き、「ピン留め」を選択してピン留めできます。 複数のノートをピン留めできます。 - -## 关注 -ノートをウォッチすると、自分以外のノートへのリアクションや返信などの通知を受け取ることができます。 ノートのメニューを開き、「ウォッチ」を選択してウォッチできます。 diff --git a/src/docs/zh-CN/features/pages.md b/src/docs/zh-CN/features/pages.md deleted file mode 100644 index d0d20dcbef..0000000000 --- a/src/docs/zh-CN/features/pages.md +++ /dev/null @@ -1,10 +0,0 @@ -# Pages - -## 变量 -変数を使うことで動的なページを作成できます。テキスト内で <b>{ 変数名 }</b> と書くとそこに変数の値を埋め込めます。例えば <b>Hello { thing } world!</b> というテキストで、変数(thing)の値が <b>ai</b> だった場合、テキストは <b>Hello ai world!</b> になります。 - -変数の評価(値を算出すること)は上から下に行われるので、ある変数の中で自分より下の変数を参照することはできません。例えば上から <b>A、B、C</b> と3つの変数を定義したとき、<b>C</b>の中で<b>A</b>や<b>B</b>を参照することはできますが、<b>A</b>の中で<b>B</b>や<b>C</b>を参照することはできません。 - -ユーザーからの入力を受け取るには、ページに「ユーザー入力」ブロックを設置し、「変数名」に入力を格納したい変数名を設定します(変数は自動で作成されます)。その変数を使ってユーザー入力に応じた動作を行えます。 - -関数を使うと、値の算出処理を再利用可能な形にまとめることができます。関数を作るには、「関数」タイプの変数を作成します。関数にはスロット(引数)を設定することができ、スロットの値は関数内で変数として利用可能です。また、関数を引数に取る関数(高階関数と呼ばれます)も存在します。関数は予め定義しておくほかに、このような高階関数のスロットに即席でセットすることもできます。 diff --git a/src/docs/zh-CN/features/reaction.md b/src/docs/zh-CN/features/reaction.md deleted file mode 100644 index 61e7cabaf1..0000000000 --- a/src/docs/zh-CN/features/reaction.md +++ /dev/null @@ -1,11 +0,0 @@ -# 回应 -他の人のノートに、絵文字を付けて簡単にあなたの反応を伝えられる機能です。 リアクションするには、ノートの + アイコンをクリックしてピッカーを表示し、絵文字を選択します。 リアクションには[カスタム絵文字](./custom-emoji)も使用できます。 - -## リアクションピッカーのカスタマイズ -ピッカーに表示される絵文字を自分好みにカスタマイズすることができます。 設定の「リアクション」で設定します。 - -## リモート投稿へのリアクションについて -リアクションはMisskeyオリジナルの機能であるため、リモートインスタンスがMisskeyでない限りは、ほとんどの場合「Like」としてアクティビティが送信されます。一般的にはLikeは「お気に入り」として実装されているようです。 - -## リモートからのリアクションについて -リモートから「Like」アクティビティを受信したとき、Misskeyでは「👍」のリアクションとして解釈されます。 diff --git a/src/docs/zh-CN/features/silence.md b/src/docs/zh-CN/features/silence.md deleted file mode 100644 index 8469784990..0000000000 --- a/src/docs/zh-CN/features/silence.md +++ /dev/null @@ -1,6 +0,0 @@ -# 禁言 -サイレンスは、アカウントに設定される状態のひとつです。 - -アカウントがサイレンス状態になると、ノートの公開範囲をパブリックにできなくなります。 ホーム、フォロワー、ダイレクトは選択可能なため、サイレンスを受けた場合でもフォロワーやあなたのユーザーページを直接訪れた場合は投稿を閲覧できますが、GTL(連合タイムライン)やLTL(ローカルタイムライン)には投稿が流れません。 - -アカウントのサイレンス状態は、サーバーのモデレーターによって有効化/無効化されます。 diff --git a/src/docs/zh-CN/features/theme.md b/src/docs/zh-CN/features/theme.md deleted file mode 100644 index 62769e5c30..0000000000 --- a/src/docs/zh-CN/features/theme.md +++ /dev/null @@ -1,68 +0,0 @@ -# 主题 - -テーマを設定して、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/misskey-dev/misskey/blob/develop/src/client/themes/_light.json5)で、`dark`なら[_dark.json5](https://github.com/misskey-dev/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/zh-CN/features/timeline.md b/src/docs/zh-CN/features/timeline.md deleted file mode 100644 index 6aa4e8b358..0000000000 --- a/src/docs/zh-CN/features/timeline.md +++ /dev/null @@ -1,31 +0,0 @@ -# 时间线 -タイムラインは、[ノート](./note)が時系列で表示される機能です。 タイムラインには以下で示す種類があり、種類によって表示されるノートも異なります。 なお、タイムラインの種類によってはサーバーにより無効になっている場合があります。 - -## 首页 -自分のフォローしているユーザーの投稿が流れます。HTLと略されます。 - -## 本地 -全てのローカルユーザーの「ホーム」指定されていない投稿が流れます。LTLと略されます。 - -## 社交 -自分のフォローしているユーザーの投稿と、全てのローカルユーザーの「ホーム」指定されていない投稿が流れます。STLと略されます。 - -## 全局 -全てのローカルユーザーの「ホーム」指定されていない投稿と、サーバーに届いた全てのリモートユーザーの「ホーム」指定されていない投稿が流れます。GTLと略されます。 - -## 比较 -| 来源 | | | 时间线 | | | -| ------- | --- | -- | --- | -- | -- | -| 用户 | 可见性 | 首页 | 本地 | 社交 | 全局 | -| 本地（关注） | 发布 | ✔ | ✔ | ✔ | ✔ | -| | 首页 | ✔ | | ✔ | | -| | 关注者 | ✔ | ✔ | ✔ | ✔ | -| 跨站（关注） | 发布 | ✔ | | ✔ | ✔ | -| | 首页 | ✔ | | ✔ | | -| | 关注者 | ✔ | | ✔ | ✔ | -| 本地（未关注） | 发布 | | ✔ | ✔ | ✔ | -| | 首页 | | | | | -| | 关注者 | | | | | -| 跨站（未关注） | 发布 | | | | ✔ | -| | 首页 | | | | | -| | 关注者 | | | | | diff --git a/src/docs/zh-CN/features/widgets.md b/src/docs/zh-CN/features/widgets.md deleted file mode 100644 index 015cfc768e..0000000000 --- a/src/docs/zh-CN/features/widgets.md +++ /dev/null @@ -1,7 +0,0 @@ -# 小工具 -ウィジェットは、MisskeyのUI上に設置できる小型の情報表示、操作が行えるパーツです。 - -ウィジェットを編集するには、ウィジェット編集モードに切り替えます。切り替え方法はUIによって異なります。 ウィジェット編集モードでは、ウィジェットの追加、削除、並び替え、およびそれぞれのウィジェットの設定を行えます。 - -## 利用可能なウィジェット一覧 -todo diff --git a/src/docs/zh-CN/features/word-mute.md b/src/docs/zh-CN/features/word-mute.md deleted file mode 100644 index a1bd1918c9..0000000000 --- a/src/docs/zh-CN/features/word-mute.md +++ /dev/null @@ -1,20 +0,0 @@ -# 文字屏蔽 -ワードミュートの設定をすると、条件に合致したノートが表示されなくなります。 - -ワードミュートには、ソフトワードミュートとハードワードミュートの2種類があります。それぞれについて設定の方法と挙動を説明します。 - -## ソフトワードミュート -ソフトワードミュートは、クライアント（アプリ）側でミュートを判断するワードミュートです。 - -ノートが設定した条件に合致すると、「（ユーザー名）が何かを言いました」という表示で隠れます。 -クリックすると元の通りに表示されます。 - -## ハードワードミュート -ハードワードミュートは、アンテナのようにサーバーが新しいノートの本文に対して条件に合致するかどうか判断し、タイムラインから対象となったノートを除外します。 - -つまり、ハードワードミュートには、以下のような特徴があります。 - -* 条件設定後、新しい投稿のみがミュートの対象になります。 -* 条件を変更しても、過去にハードミュートされたノートはミュートされたままになります。 -* 「○○が何かを言いました」でタイムラインが埋まることがありません。 -* ソフトミュートに非対応のアプリでも、ハードミュートは適用されます。 diff --git a/src/docs/zh-CN/follow.md b/src/docs/zh-CN/follow.md deleted file mode 100644 index ff042baff2..0000000000 --- a/src/docs/zh-CN/follow.md +++ /dev/null @@ -1,2 +0,0 @@ -# 关注中 -当您关注一名用户时，您可以在您的时间线上看到该用户的帖子。但是不包含该用户对其他用户的回复。 要关注一名用户，请点击该用户页面上的“关注”按钮。如果需要取消关注，请再次点击该按钮。 diff --git a/src/docs/zh-CN/general/apps.md b/src/docs/zh-CN/general/apps.md deleted file mode 100644 index 3bd88df19b..0000000000 --- a/src/docs/zh-CN/general/apps.md +++ /dev/null @@ -1,6 +0,0 @@ -# 第三方应用程序列表 -## 客户端 -todo - -## 链接服务 -todo diff --git a/src/docs/zh-CN/general/changelog.md b/src/docs/zh-CN/general/changelog.md deleted file mode 100644 index 53dfae95c3..0000000000 --- a/src/docs/zh-CN/general/changelog.md +++ /dev/null @@ -1,5 +0,0 @@ -# 更新日志 -<div class="info">ℹ️ 这是该服务器的更新日志。请在 <a href="https://github.com/misskey-dev/misskey/blob/master/CHANGELOG.md" target="_blank">GitHub</a> 上检查 Misskey 的最新发布版本。</div> - -<!-- For translators: Do not edit these comments. --> -<!--[CHANGELOG]--> diff --git a/src/docs/zh-CN/general/faq.md b/src/docs/zh-CN/general/faq.md deleted file mode 100644 index b7f159c374..0000000000 --- a/src/docs/zh-CN/general/faq.md +++ /dev/null @@ -1,28 +0,0 @@ -# 常见问题 -ここでは利用上のよくある質問について掲載しています。 Misskeyのプロジェクト自体についてのよくある質問は[こちら](./misskey)に掲載されています。 - -## iOS/Androidのアプリはありますか？ -公式にはそういったOSのネイティブアプリを開発していませんが、サードパーティ製のアプリがいくつかあります。 詳しくは[こちら](./apps)をご覧ください。 - -ただ、サードパーティ製アプリはどうしても機能への対応が遅れてしまうため、とくに拘りがなければ公式のWebクライアントの利用をおすすめします。 なお、MisskeyのWebクライアントはPWAに対応しているので、ネイティブアプリのように動作させることも可能です。 詳しくは[こちら](todo)をご覧ください。 - -## Mastodonクライアントでログインできないのですが？ -MisskeyはMastodonのAPIと互換性がないため、一部を除きMastodonクライアントでMisskeyを利用することはできません。 - -## 他のサーバーのユーザーをフォローするときは？ -メニューから検索を選び、ユーザー名をホスト込みで入力します。例: `@syuilo@misskey.io` - -## Renoteを削除するには？ -Renoteの時刻表示の隣にある「...」を押し、「Renote解除」を選択します。 Renoteについては[こちら](../features/note)をご確認ください。 - -## URLのプレビューを表示させたくない -MFMには、そのURLのプレビューを無効にする構文があります。詳細は[MFMチートシート](/mfm-cheat-sheet)をご確認ください。 - -## 想要添加自定义表情符号 -運営者のみがカスタム絵文字を追加、編集、削除できます。それらを希望する場合は運営者に依頼してください。 - -## 想要开发一个Bot机器人 -您可以使用 Misskey API 开发Bot机器人。[こちら](../advanced/develop-bot)をご確認ください。 - -## ノートの翻訳機能はどのサービスを使用していますか？ -[DeepL](https://www.deepl.com/)を使用しています。 diff --git a/src/docs/zh-CN/general/glossary.md b/src/docs/zh-CN/general/glossary.md deleted file mode 100644 index 58cb1a9eeb..0000000000 --- a/src/docs/zh-CN/general/glossary.md +++ /dev/null @@ -1,89 +0,0 @@ -# 术语表 -Misskey相关术语的词汇表。 - -## ActivityPub -(読み: あくてぃびてぃぱぶ) 分散型を実現するために用いられるプロトコル(仕様)。このプロトコルに則ってサーバー同士通信を行うことで、連合が行われ、Fediverseを形成しています。 - -## AiScript -(読み: あいすくりぷと) Misskey上で使用できるプログラミング言語です。詳細は[こちら。](../advanced/aiscript) - -## API -(読み: えーぴーあい) Misskeyのサーバーが公開している、プログラムからMisskeyを扱うためのインターフェース。詳細は[こちら。](../advanced/api) - -## Bot -(読み: ぼっと) プログラムによって動作しているアカウント。 - -## CW -(読み: こんてんつわーにんぐ) Contents Warningの略。ノートの内容を、操作なしには表示しないようにできる機能。主に長大な内容を隠すためや、ネタバレ防止などに使われます。 - -## Fediverse -(読み: ふぇでぃばーす) Misskeyを含む様々な分散型ソフトウェアのサーバーで構成されたネットワーク。 - -## GTL -グローバルタイムライン(Global TimeLine)の略。タイムラインの詳細は[こちら。](../features/timeline) - -## HTL -ホームタイムライン(Home TimeLine)の略。タイムラインの詳細は[こちら。](../features/timeline) - -## LTL -ローカルタイムライン(Local TimeLine)の略。タイムラインの詳細は[こちら。](../features/timeline) - -## MFM -(読み: えむえふえむ) Misskey Flavored Markdownの略で、Misskey上で使用できるマークアップ言語です。詳細は[こちら。](../features/mfm) - -## NSFW -(読み: のっとせーふふぉーわーく) Not Safe For Workの略。画像を「閲覧注意」扱いにし、操作なしには表示しないようにすることができる機能。 - -## 转发 -(読み: りのーと) 既にあるノートを引用、もしくはそのノートを新しいノートとして共有する行為、またそれによって作成されたノート。詳細は[こちら。](../features/note) - -## STL -ソーシャルタイムライン(Social TimeLine)の略。タイムラインの詳細は[こちら。](../features/timeline) - -## 蓝 -(読み: あい) Misskeyの看板娘(公式キャラクター)です。 - -## アクティブユーザー -インスタンスにアカウントを作っているユーザーのうち、現在も実際にサービスを利用しているユーザーのこと。 - -## 实例 -todo - -## 自定义表情符号 -サーバーで用意された絵文字。カスタム絵文字ではない通常の絵文字は「Unicode絵文字」と区別して呼ばれる。 - -## コントロールパネル -インスタンスの設定画面のこと。 - -## 服务器 -todo - -## 禁言 -ノートをパブリックな公開範囲で投稿できなくされている状態。モデレーターの判断でユーザーごとに設定されます。详情请看[这里。](../features/silence) - -## 作业队列 -アクティビティ配送などを順番に行うためのシステム。 - -## 冻结 -アカウントが使用不可に設定されている状態。 - -## 网盘 -Misskeyにアップロードしたファイルを管理する機能。详情请看[这里。](../features/drive) - -## 帖子 -Misskeyに投稿される、文章、ファイル、アンケートなどを含めることができるコンテンツ。詳細は[こちら。](../features/note) - -## ミスキスト -Misskeyを使う人のこと。 - -## 监察员 -スパムの凍結およびサイレンスや不適切な投稿の削除など、コミュニティ運営に関する権限を持つユーザー。 - -## 远程 -他サーバーのことを指します。リモートユーザーといったように接頭辞としても使われます。ローカルの逆です。 - -## 联合 -サーバー上で作成された情報が他のサーバーに伝わること。 - -## 本地 -自サーバーのことを指します。ローカルユーザー、ローカルタイムラインといったように接頭辞としても使われます。リモートの逆です。 diff --git a/src/docs/zh-CN/general/links.md b/src/docs/zh-CN/general/links.md deleted file mode 100644 index d234511768..0000000000 --- a/src/docs/zh-CN/general/links.md +++ /dev/null @@ -1,12 +0,0 @@ -# 相关链接 - -## 网站 -- [Official Discord](https://discord.gg/Wp8gVStHW3) - Misskey官方Discord服务器 -- [Misskey Forum](https://forum.misskey.io/) - Misskey相关主题的论坛 - -## 账户 -- [@repo@misskey.io](https://misskey.io/@repo) - 发布Misskey的存储库更新的机器人 - -## 库 -- [misskey-dev/misskey.js](https://github.com/misskey-dev/misskey.js) - JavaScript的Misskey SDK -- [misskey-dev/mfm.js](https://github.com/misskey-dev/mfm.js) - JavaScript的MFM解析器实现 diff --git a/src/docs/zh-CN/general/misskey.md b/src/docs/zh-CN/general/misskey.md deleted file mode 100644 index e6376839e0..0000000000 --- a/src/docs/zh-CN/general/misskey.md +++ /dev/null @@ -1,87 +0,0 @@ -# 关于 Misskey - -Misskeyはオープンソースの分散型マイクロブログプラットフォームプロジェクトです。 開発は日本でsyuiloによって2014年から開始されました。 ドライブ、リアクションなどの豊富な機能や、高いカスタマイズ性を備えたUIを持つことが特徴です。 - -## 歴史 -開発当初は掲示板がメインのサービスでしたが、ユーザーが短文を投稿し、それを時系列で流れるタイムライン機能を追加したところ人気が高まり、徐々にそれがメインとして開発が進むようになりました。 当初は分散型ではありませんでしたが、2018年にActivityPubを実装し分散型になったことで、より多くの方に認知され利用されるサービスになり、現在に至ります。 -<div class="info">ℹ️ Misskeyという名前は、syuiloが当時聴いていたMay'nというアーティストの楽曲、Brain Diverの歌詞に由来します。</div> - -誰でも開発に参加することができ、現在でも活発に開発が続いています。 - -## 分散型とは何か？ - -<b>分散(distributed)型</b>とは、<b>非中央集権(decentralized)</b>とも呼ばれ、コミュニティが多数のサーバーに分散して存在し、それらが相互に<b>通信(連合、federation)</b>することでコンテンツ共有<b>ネットワーク(Fediverse)</b>を形成していることが特徴のサービスです。 単一のサーバーしか存在しない、もしくは複数存在しても互いに独立している場合は中央集権なサービスと言われ、例えばTwitterやFacebookなどほとんどのサービスがそれに該当します。 分散型のメリットは、自分に合った運営者やテーマのサーバーを選択できることです。自分でサーバーを作成することもできます。連合するおかげで、どのサーバーを選んでも、同じコミュニティにアクセスできます。 - -## 常にオープンソース -Misskeyはこれまでもこれからも、オープンソースであり続けます。オープンソースとは、簡単に言うと<b>ソフトウェアのソースコード(プログラム)が公開されている</b>ことです。ソースコードの修正や再配布が可能であることを定義に含めることもあります。 Misskeyのすべてのソースコードは[AGPL](https://github.com/misskey-dev/misskey/blob/develop/LICENSE)というオープンソースライセンスの下に[公開](https://github.com/misskey-dev)されていて、誰でも自由に閲覧、使用、修正、改変、再配布をすることができます。 オープンソースは、自分で好きなように変えたり、有害な処理が含まれていないことを確認することができたり、誰でも開発に参加できるなどの、様々なメリットがあります。 上述の分散型を実現するためにも、オープンソースであるということは必要不可欠な要素です。 再び引き合いに出しますが、TwitterやFacebookなどの利益を得ているほとんどのサービスはオープンソースではありません。 - -<div class="info">ℹ️ 技術的に言うと、MisskeyのソースコードはGitで管理されていて、リポジトリは<a href="https://github.com/misskey-dev" target="_blank">GitHub上でホスティングされています。</a></div> - -## 開発に参加する、プロジェクトを支援する -Misskeyを気に入っていただけたら、ぜひプロジェクトを支援してください。プロジェクトに貢献するには、以下で紹介するようにいろいろな方法があります。方法によっては開発のスキルは不要なので、誰でも気軽に参加し貢献することができます。いつでもお待ちしています。 - -### 機能を追加したり、バグを修正する -ソフトウェアエンジニアのスキルをお持ちの方であれば、ソースコードを編集する形でプロジェクトに貢献することができます。 貢献についてのガイドは[こちら](https://github.com/misskey-dev/misskey/blob/develop/CONTRIBUTING.md)です。 - -### 議論に参加する -新しい機能、または既存の機能について意見を述べたり、不具合を報告したりすることでも貢献できます。 そのようなディスカッションは[GitHub](https://github.com/misskey-dev)上か、[フォーラム](https://forum.misskey.io/)等で行われます。 - -### テキストを翻訳する -Misskeyは様々な言語に対応しています(i18n -internationalizationの略- と呼ばれます)。元の言語は基本的に日本語ですが、有志によって他の言語へと翻訳されています。 その翻訳作業に加わっていただくことでもMisskeyに貢献できます。 Misskeyは[Crowdinというサービスを使用して翻訳の管理を行っています。](https://crowdin.com/project/misskey) - -### 感想を投稿する -不具合報告等だけではなく、Misskeyの良い点、楽しい点といったポジティブな意見もぜひ共有してください。開発の励みになり、それは間接的ですがプロジェクトへの貢献です。 - -### ミスキストを増やす -ミスキストとは、Misskeyを使用する人のことです。 知り合いに紹介するなどしてMisskeyを広めていただければ、ミスキストが増え開発のモチベーションが上がります。 - -### 寄付をする -Misskeyはビジネスではなく、利用は無料であるため、収益は皆様からの寄付のみです。(インスタンスによっては広告収入を得ているような場合もありますが、それは運営者の収入であり直接開発者への収入にはなりません) 寄付をしていただければ、今後も開発を続けることが可能になり、プロジェクトへの貢献になります。 寄付は基本的には[Patreon](https://www.patreon.com/syuilo)で受け付けています。 一定額寄付していただけると、Misskeyの[情報ページ](/about-misskey)に名前を記載することができます。 - -また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。 開発には直接関係しませんが、サーバーがあってこそのプロジェクトなので、運営が維持されるというのは開発と同じくらい重要なことです。 - -## クレジット -Misskeyの開発者や、Misskeyに寄付をしてくださった方の一覧は[こちら](/about-misskey)で見ることができます。 - -## 常见问题 -### プロジェクトは何を目指していますか？ -強いて言うと、漠然的になりますが広く使われる汎用的なプラットフォームになることを目指しています。 Misskeyは他のプロジェクトとは違い、何らかの思想(例えば、反中央集権)やビジョンに基づいて開発が行われているわけではなく、その点ではフラットです。 それが逆に、特定の方向性に縛られないフレキシブルさを生み出すことに繋がっていると感じています。 -<!-- TODO: ここにロードマップへのリンク --> - -### 企業によって開発されていますか？ -いいえ。Misskeyの開発は個人で行われており、商業的でもないため、特定の企業の関りはありません。 開発メンバーも基本的にはボランティアです。 また、開発に対し企業のスポンサーがつくこともありますが、その場合でもやはり開発は個人のコミュニティが主体です。 - -### 誰が運営していますか？ -Misskeyは分散型なため、各サーバーにそれぞれ異なった運営者がいます。従って、特定の個人や企業によって、Misskeyの全てが運営されているわけではありません。 また、開発チームが運営を行うわけでもないため、運営に関する連絡は、お使いのサーバーの運営者に行ってください。 サーバーの運営者は、[このページ](/about)で確認することができます。 あなたがサーバーを作成すれば、あなたが運営者になります。 - -### どのサーバーを選べばいいですか？ -[サーバー一覧が公開されています。](https://join.misskey.page/ja-JP/instances) サーバーによってコミュニティのテーマ(特定のこと、ものが好き 等)が決められている場合があるので、自分に合ったテーマのサーバーがあれば、そこを選ぶと良いかもしれません。 他にも、サーバーの規模、ユーザー層、国および言語、運営者が信頼できるかどうか、などの観点があります。 なお、Misskey公式のサーバーというものはありません。自身で新しくサーバーを作成するという選択肢もあります。 - -基本的にどのサーバーを選んだとしても、他の全てのサーバーのユーザーと繋がることができます。 - -### サーバーを建てるにはどうしたらいいですか？ -Misskeyサーバーの作成に興味を持っていただきありがとうございます。 2021年現在、Misskeyのホスティングサービスは存在しないため、サーバーの作成にはある程度の知識が必要です。 サーバーの作成方法については[こちら](todo)をご覧ください。 - -### どのような技術を使用していますか？ -Misskeyは開発が進むにつれ使用する技術も大きく変わってきました。開発当初はMySQL + PHP + jQueryといった構成でしたが、現在は以下のようになっています。 -- サーバーサイド: Node.js -- データベース: PostgreSQL、Redis -- UIフレームワーク: Vue.js -- プログラミング言語: TypeScript - -また、MFMやAiScriptなどの、Misskeyから派生して独自の技術も開発しています。 - -### Mastodonのフォークですか？ -いいえ。MisskeyはMastodonやその他のプロジェクトとは全く別のプロジェクトです。 開発に関しても、Misskeyの方が昔から開発されています。ただし、分散型になったのはMastodonの登場より後です。 同じActivityPubという分散のためのプロトコルを実装しているという点以外、両者に特に関りがあるわけでもありません。 - -### iOS/Androidのアプリはありますか？ -公式にはそういったOSのネイティブアプリを開発していませんが、サードパーティ製のアプリがいくつかあります。 詳しくは[こちら](./apps)をご覧ください。 - -ただ、サードパーティ製アプリはどうしても機能への対応が遅れてしまうため、とくに拘りがなければ公式のWebクライアントの利用をおすすめします。 なお、MisskeyのWebクライアントはPWAに対応しているので、ネイティブアプリのように動作させることも可能です。 詳しくは[こちら](todo)をご覧ください。 - -### Misskeyのロゴ、アイコンはどこで入手できますか？ -(準備中) - -### 時折目にする猫耳の可愛い女の子は？ -Misskeyの守り神、藍ちゃんです。ｱｲﾁｬﾝｶﾜｲｲﾔｯﾀｰ! -<div class="info">ℹ️ 藍ちゃんについては<a href="https://xn--931a.moe/" target="_blank">こちら</a>です。</div> diff --git a/src/docs/zh-CN/general/report-issue.md b/src/docs/zh-CN/general/report-issue.md deleted file mode 100644 index 22d97ff3d5..0000000000 --- a/src/docs/zh-CN/general/report-issue.md +++ /dev/null @@ -1,8 +0,0 @@ -# bug报告 -不具合と思われる状況に遭遇したときは、まず[トラブルシューティング](./troubleshooting)をご一読ください。 それでも問題が解決しないときは、以下の情報を含めて[フォーラム](https://forum.misskey.io/)に投稿してください。 投稿することで、解決策が見つかったり、不具合と判断されれば開発チームによって修正が行われます。 - -## 含める情報 -- Misskeyのバージョン([情報ページ](/about)で確認できます) -- お使いのブラウザの種類とバージョン -- お使いのOSの種類とバージョン -- 問題の再現手順 diff --git a/src/docs/zh-CN/general/troubleshooting.md b/src/docs/zh-CN/general/troubleshooting.md deleted file mode 100644 index 43ce835b1e..0000000000 --- a/src/docs/zh-CN/general/troubleshooting.md +++ /dev/null @@ -1,40 +0,0 @@ -# 故障排除 -<div class="info">ℹ️ <a href="./faq">よくある質問</a>も合わせてお役立てください。</div> - -問題が発生したときは、まずこちらをご確認ください。 該当する項目が無い、もしくは手順を試しても効果がない場合は、サーバーの管理者に連絡するか[不具合を報告](./report-issue)してください。 - -## クライアントが起動しない -ほとんどの場合、お使いのブラウザまたはOSのバージョンが古いことが原因です。 ブラウザおよびOSのバージョンを最新のものに更新してから、再度試してみてください。 - -これは稀ですが、それでも起動しない場合は、キャッシュが原因の場合があります。ブラウザのキャッシュをクリアして、再度試してみてください。 - -## ページが読み込めない -クライアントが起動するもののページが読み込めないというエラーが出る場合は、ネットワークに問題がないか確認してください。また、サーバーがダウンしていないか確認してください。 - -これは稀ですが、キャッシュが原因の場合があります。ブラウザのキャッシュをクリアして、再度試してみてください。 - -まだ問題がある場合は、サーバーの問題と思われるのでサーバーの管理者に連絡してください。 - -## クライアントの動作が遅い -以下を試してみてください: - -- クライアント設定で「UIのアニメーションを減らす」を有効にする -- クライアント設定で「モーダルにぼかし効果を使用」を無効にする -- お使いのブラウザの設定でハードウェアアクセラレーションを有効にする -- お使いのデバイスのスペックを上げる - -## UIの一部の表示がおかしい(背景が透明になっている等) -アップデートによりUIの改修が行われたときに、テーマのキャッシュシステムの影響でそのような表示になることがあります。 クライアントの設定の「キャッシュをクリア」すると直ります。 -<div class="warn">⚠️ 「クライアントの」キャッシュクリアです。「ブラウザの」キャッシュクリアは行わないでください。</div> - -## 通知やアンテナ等の点滅が消えない -点滅は、未読のコンテンツがあることを示しています。通常点滅が消えない場合は、コンテンツを遡ると未読なコンテンツが残っています。 すべて既読にしたと思われるのに、それでもなお点滅が続く場合(おそらく不具合と思われます)は設定から強制的にすべて既読扱いにすることができます。 - -## Renoteができない -フォロワー限定のノートはRenoteすることはできません。 - -## UI上で特定の要素が表示されない -広告ブロッカーを使用しているとそのような不具合が発生することがあります。Misskeyではオフにしてご利用ください。 - -## UI上で未翻訳の部分がある -ほとんどの場合、単に翻訳が間に合っていないだけで、不具合ではありません。翻訳が終わるまでお待ちください。 [翻訳に参加](./misskey)していただくことも可能です。 diff --git a/src/docs/zh-CN/keyboard-shortcut.md b/src/docs/zh-CN/keyboard-shortcut.md deleted file mode 100644 index 42b8188c06..0000000000 --- a/src/docs/zh-CN/keyboard-shortcut.md +++ /dev/null @@ -1,68 +0,0 @@ -# 键盘快捷键 - -## 全局 -这些快捷键基本上可以在任何地方使用 -<table> - <thead> - <tr><th>快捷键</th><th>效果</th><th>来源</th></tr> - </thead> - <tbody> - <tr><td><kbd class="key">P</kbd>, <kbd class="key">N</kbd></td><td>发新帖</td><td><b>P</b>ost, <b>N</b>ew, <b>N</b>ote</td></tr> - <tr><td><kbd class="key">T</kbd></td><td>转到时间线最新发布的内容</td><td><b>T</b>imeline, <b>T</b>op</td></tr> - <tr><td><kbd class="group"><kbd class="key">Shift</kbd> + <kbd class="key">N</kbd></kbd></td><td>显示/隐藏通知</td><td><b>N</b>otifications</td></tr> - <tr><td><kbd class="key">S</kbd></td><td>搜索</td><td><b>S</b>earch</td></tr> - <tr><td><kbd class="key">H</kbd>, <kbd class="key">?</kbd></td><td>显示帮助</td><td><b>H</b>elp</td></tr> - </tbody> -</table> - -## 帖子相关操作 - -<table> - <thead> - <tr><th>快捷键</th><th>效果</th><th>来源</th></tr> - </thead> - <tbody> - <tr><td><kbd class="key">↑</kbd>, <kbd class="key">K</kbd>, <kbd class="group"><kbd class="key">Shift</kbd> + <kbd class="key">Tab</kbd></kbd></td><td>移动到上一个帖子</td><td>-</td></tr> - <tr><td><kbd class="key">↓</kbd>, <kbd class="key">J</kbd>, <kbd class="key">Tab</kbd></td><td>移动到下一个帖子</td><td>-</td></tr> - <tr><td><kbd class="key">R</kbd></td><td>打开回复框</td><td><b>R</b>eply</td></tr> - <tr><td><kbd class="key">Q</kbd></td><td>打开转发框</td><td><b>Q</b>uote</td></tr> - <tr><td><kbd class="group"><kbd class="key">Ctrl</kbd> + <kbd class="key">Q</kbd></kbd></td><td>快速转发（不打开转发框）</td><td>-</td></tr> - <tr><td><kbd class="key">E</kbd>, <kbd class="key">A</kbd>, <kbd class="key">+</kbd></td><td>打开回应框</td><td><b>E</b>mote, re<b>A</b>ction</td></tr> - <tr><td><kbd class="key">0</kbd>~<kbd class="key">9</kbd></td><td>根据相应数字发表回应（详情请参考相关说明）</td><td>-</td></tr> - <tr><td><kbd class="key">F</kbd>, <kbd class="key">B</kbd></td><td>添加到收藏夹</td><td><b>F</b>avorite, <b>B</b>ookmark</td></tr> - <tr><td><kbd class="key">Del</kbd>, <kbd class="group"><kbd class="key">Ctrl</kbd> + <kbd class="key">D</kbd></kbd></td><td>删除帖子</td><td><b>D</b>elete</tr> - <tr><td><kbd class="key">M</kbd>, <kbd class="key">O</kbd></td><td>打开帖子菜单</td><td><b>M</b>ore, <b>O</b>ther</td></tr> - <tr><td><kbd class="key">S</kbd></td><td>显示或隐藏CW隐藏的部分</td><td><b>S</b>how, <b>S</b>ee</td></tr> - <tr><td><kbd class="key">Esc</kbd></td><td>取消选中</td><td>-</td></tr> - </tbody> -</table> - -## 转发框 - -<table> - <thead> - <tr><th>快捷键</th><th>效果</th><th>来源</th></tr> - </thead> - <tbody> - <tr><td><kbd class="key">Enter</kbd></td><td>转发</td><td>-</td></tr> - <tr><td><kbd class="key">Q</kbd></td><td>打开转发框</td><td><b>Q</b>uote</td></tr> - <tr><td><kbd class="key">Esc</kbd></td><td>关闭转发框</td><td>-</td></tr> - </tbody> -</table> - -## 回应框 -默认使用“👍”作为回应。 -<table> - <thead> - <tr><th>快捷键</th><th>效果</th><th>来源</th></tr> - </thead> - <tbody> - <tr><td><kbd class="key">↑</kbd>, <kbd class="key">K</kbd></td><td>移动到上一个回应</td><td>-</td></tr> - <tr><td><kbd class="key">↓</kbd>, <kbd class="key">J</kbd></td><td>移动到下一个回应</td><td>-</td></tr> - <tr><td><kbd class="key">←</kbd>, <kbd class="key">H</kbd>, <kbd class="group"><kbd class="key">Shift</kbd> + <kbd class="key">Tab</kbd></kbd></td><td>移动到左边一个回应</td><td>-</td></tr> - <tr><td><kbd class="key">→</kbd>, <kbd class="key">L</kbd>, <kbd class="key">Tab</kbd></td><td>移动到右边一个回应</td><td>-</td></tr> - <tr><td><kbd class="key">Enter</kbd>, <kbd class="key">Space</kbd>, <kbd class="key">+</kbd></td><td>回应确认</td><td>-</td></tr> - <tr><td><kbd class="key">0</kbd>~<kbd class="key">9</kbd></td><td>根据相应数字发表回应</td><td>-</td></tr> - <tr><td><kbd class="key">Esc</kbd></td><td>取消回应</td><td>-</td></tr> - </tbody> -</table> diff --git a/src/docs/zh-CN/mfm.md b/src/docs/zh-CN/mfm.md deleted file mode 100644 index 39199b5e03..0000000000 --- a/src/docs/zh-CN/mfm.md +++ /dev/null @@ -1,2 +0,0 @@ -# MFM -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 deleted file mode 100644 index 43a6c12ff7..0000000000 --- a/src/docs/zh-CN/mute.md +++ /dev/null @@ -1,13 +0,0 @@ -# 屏蔽 - -当您屏蔽用户时，Misskey不再显示有关该用户的以下内容： - -* 时间线帖子搜索结果中的该用户的帖子（以及对这些帖子的回复和转发）。 -* 该用户的通知 -* 用户在消息历史记录列表中的消息历史记录 - -要屏蔽用户，请在该用户页面上点击该用户的“屏蔽”按钮。 - -不会通知对方您已将其屏蔽，并且对方也不知道自己被屏蔽。 - -您可以在“设置”>“屏蔽”下查看被屏蔽的用户列表。 diff --git a/src/docs/zh-CN/pages.md b/src/docs/zh-CN/pages.md deleted file mode 100644 index 2446c183ad..0000000000 --- a/src/docs/zh-CN/pages.md +++ /dev/null @@ -1,10 +0,0 @@ -# 页面 - -## 变量 -您可以使用变量创建动态页面。您可以在文本中使用<b>{变量名}</b>的格式来引用变量的值。例如当变量(thing)的值为<b>ai</b>时，字符串<b>Hello { thing } world!</b>的值为<b>Hello ai world!</b>。 - -变量的处理（计算变量的值）是从上到下执行的，因此不能引用未声明的变量。例如，如果您依次定义了<b> A，B，C </b>三个变量，则在<b> C </b>中可以引用<b> A </b>和<b> B </b>，但<b> A </b>中不能引用<b> B </b>或<b> C </b>。 - -为了接收来自用户的输入，页面上设有“用户输入”块，在“变量名称”中设置要在其中保存输入值的变量名(变量会自动创建)。然后您可以通过该变量使用用户输入的值进行其他操作。 - -函数时一种将可重用的计算过程组合起来的形式。要创建函数，请创建“函数”类型的变量。可以为函数设置插槽（参数），并且插槽值可以作为函数内的变量使用。另外，也可以将函数作为函数的参数（称为高阶函数）。除了预定义函数外，您也可以随时将函数定义在这类高阶功能的插槽中。 diff --git a/src/docs/zh-CN/reaction.md b/src/docs/zh-CN/reaction.md deleted file mode 100644 index 779bde238b..0000000000 --- a/src/docs/zh-CN/reaction.md +++ /dev/null @@ -1,11 +0,0 @@ -# 回应 -通过将表情符号加到其他人的帖子上，您可以快速表达您的反应。 要做出回应，请单击帖子上的 + 图标以打开选择器并选择一个表情符号。 您也可以使用[自定义表情符号](./custom-emoji)来进行回应。 - -## 自定义回应选择器 -您可以根据自己的喜好自定义选择器中显示的表情符号。 在设置的“回应”中即可进行设置。 - -## 关于对外部发帖的回应 -回应是Misskey的原生功能，因此，除非外部实例是Misskey，否则该操作很有可能仅以“Like”的形式发送。通常，Like表现为“点赞”的功能。 另外，即使对方同样是Misskey，自定义表情符号的回应也不会被发送，而是会自动显示为“👍”等表情符号。 - -## 关于外部回应 -当从外部接收到“Like”操作时，Misskey会将其解释为“👍”回应。 diff --git a/src/docs/zh-CN/reversi-bot.md b/src/docs/zh-CN/reversi-bot.md deleted file mode 100644 index 8c2d0f2551..0000000000 --- a/src/docs/zh-CN/reversi-bot.md +++ /dev/null @@ -1,160 +0,0 @@ -# Misskey的黑白棋Bot开发 -本页会说明如何为Misskey的黑白棋功能开发一个Bot机器人。 - -1. 使用以下参数来连接`games/reversi`流式API： - * `i`: bot账号的API key - -2. 当出现对局邀请时，流中会触发`invited`事件 - * 事件内容中包含邀请您参加游戏的用户信息，名字为`parent`。 - -3. 向`games/reversi/match`发送请求，其中`user_id`包含`parent`的`id` - -4. 请求成功时将返回游戏信息，然后可以使用以下参数连接到`games/reversi-game`流： - * `i`: bot账号的API key - * `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/zh-CN/stream.md b/src/docs/zh-CN/stream.md deleted file mode 100644 index 8735a05f5a..0000000000 --- a/src/docs/zh-CN/stream.md +++ /dev/null @@ -1,354 +0,0 @@ -# 流式API - -通过流式API，您可以实时接收各种信息（例如，你的时间线中的新帖文，收到的消息，关注等），并进行各种操作。 - -## 连接到流 - -要使用流式API，您需要使用**websocket**连接到Misskey服务器。 - -请使用参数`i`连接到以下URL，并在websocket连接中包含认证信息。例如： -``` -%WS_URL%/streaming?i=xxxxxxxxxxxxxxx -``` - -认证信息是您的API密钥，从应用程序连接到流时需要引用的用户访问令牌 - -<div class="ui info"> - <p><i class="fas fa-info-circle"></i> 关于如何获取认证信息，请参考<a href="./api">此文档</a>。</p> -</div> - ---- - -您可以省略身份验证信息。此时无需登录即可使用，但是可以接收的信息和可以执行的操作将受到限制。例： - -``` -%WS_URL%/streaming -``` - ---- - -通过连接到流，您可以执行后文所示的API操作并订阅帖子。 但是此时例如时间线上的新帖子等还无法接收到。 要实现此功能，您需要连接到后文所述的流的**频道**。 - -**所有流交互都是JSON格式。** - -## 频道 -频道是Misskey的流API中的概念。这是一种分离发送和接收信息的机制。 您无法仅通过连接到Misskey流来实时接收时间线帖子。 需要通过连接到流中的频道，您才能够接收和发送各种消息。 - -### 连接到频道 -要连接到频道，请将JSON数据发送到流： - -```json -{ - type: 'connect', - body: { - channel: 'xxxxxxxx', - id: 'foobar', - params: { - ... - } - } -} -``` - -其中： -* `channel`中可以设置您要连接的频道名。频道类型将在后面说明。 -* `id`设置用于与频道通信的ID。因为流中有着各种消息，因此需要确定消息来自哪个频道。该ID可以是UUID或随机数。 -* `params`是连接到频道时传的参数。连接不同的频道时需要不同的参数。连接到无需参数的频道时，该属性为可选。 - -<div class="ui info"> - <p><i class="fas fa-info-circle"></i> ID对应的是“频道的连接”，而不是频道。因为在某些情况下会使用不同的参数对同一频道进行多个连接。</p> -</div> - -### 从频道接收消息 -例如，当有新帖子时，时间线的频道将发送一条消息。通过接收此消息，您可以实时知道时间线上有新帖子。 - -当频道发出消息时，以下数据将以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请求 - -使用流的方式可以在不使用http请求的条件下来发送API请求。因此，您可以使用更简洁的代码来提高效率。 - -要通过流发送API请求，请将如下所示的JSON格式数据发送到流： -```json -{ - type: 'api', - body: { - id: 'xxxxxxxxxxxxxxxx', - endpoint: 'notes/create', - data: { - text: 'yee haw!' - } - } -} -``` - -其中： -* `id`是一个唯一的ID，用来识别不同请求所对应的回应。可以使用UUID或者简单的随机数生成方法。 -* `endpoint`包含请求要指定发送的API终端。 -* `data`包含需要发送的终端参数。 - -<div class="ui info"> - <p><i class="fas fa-info-circle"></i> 详见API参考中的API终端和参数。</p> -</div> - -### 接收回应 - -当你向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` -当您的帖子被转发时会触发该事件。转发自己的帖子不会触发。 - -#### `mention` -有人提及您时会触发该事件。 - -#### `readAllNotifications` -这个事件表示您的所有通知都被设为已读。此事件可用于关闭“未读通知图标”等情况。 - -#### `meUpdated` -该事件表示您的个人信息已更新。 - -#### `follow` -当您关注某人时会触发该事件。 - -#### `unfollow` -当您取消关注某人时会触发该事件。 - -#### `followed` -当您被某人关注时会触发该事件。 - -## `homeTimeline` -首页的时间线上发布的信息将会传到这里。该频道没有参数。 - -### 发送的事件列表 - -#### `note` -当时间线有新帖子时触发此事件。 - -## `localTimeline` -本地的时间线上发布的信息将会传到这里。该频道没有参数。 - -### 发送的事件列表 - -#### `note` -当本地的时间线有新帖子时触发此事件。 - -## `hybridTimeline` -社交时间线上发布的信息将会传到这里。该频道没有参数。 - -### 发送的事件列表 - -#### `note` -当社交时间线有新帖子时触发此事件。 - -## `globalTimeline` -全局时间线上发布的信息将会传到这里。该频道没有参数。 - -### 发送的事件列表 - -#### `note` -全局时间线有新帖子时触发此事件。 diff --git a/src/docs/zh-CN/theme.md b/src/docs/zh-CN/theme.md deleted file mode 100644 index a0d0c10bcd..0000000000 --- a/src/docs/zh-CN/theme.md +++ /dev/null @@ -1,68 +0,0 @@ -# 主题 - -您可以设置主题来改变您的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`。 - -#### 可以在值中使用的语法 -* 以十六进制表示的颜色 - * 例: `#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/zh-CN/timelines.md b/src/docs/zh-CN/timelines.md deleted file mode 100644 index ee7db7f6be..0000000000 --- a/src/docs/zh-CN/timelines.md +++ /dev/null @@ -1,15 +0,0 @@ -# 时间线的比较 - -https://docs.google.com/spreadsheets/d/1YIfTiY6-XccWLYR8SBnJWcY642Rq_jkTEL06BVlPYlQ/edit?usp=sharing - -## 首页 -您关注的用户的帖文 - -## 本地 -所有非指定为「首页」的本地用户的帖文 - -## 社交 -您关注的用户的帖文，和所有未指定为「首页」的本地用户的帖文 - -## 全局 -所有本地用户的未指定为「首页」的帖文，和所有到达服务器的远程用户的未指定为「首页」的帖文 |