リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 | -| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](./permission.md)で確認できます。 | - -:::tip{label='例'} - -``` -https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive -``` - -::: - -#### Step 3 - -ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 - -``` -https://{host}/api/miauth/{session}/check -``` - -ここで、 - -- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。 -- `{session}`の部分は、セッションIDに置き換えます。 - -レスポンスに含まれるプロパティは以下の通りです: - -| 名前 | 説明 | -| ------- | -------------- | -| `token` | ユーザーのアクセストークン。 | -| `user` | ユーザーの情報。 | - -## APIの利用 - -アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。 - -:::tip - -- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。 -- 要求ヘッダーに`Content-Type: application/json`を指定します。 -- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。 -- ベースURLは`https://{サーバーのドメイン}/api`です。 - -::: - -アクセストークン付きのボディの例（metaの場合）: - -```json -{ - "i": "HogEFugA1341", - "detail": false -} -``` - - - -APIの詳細は、APIリファレンスを参照してください。 - -:::warning - -MisskeyはRESTを採用していません。 - -::: - -また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 diff --git a/content/en/docs/4.for-developers/api/token/3.oauth.md b/content/en/docs/4.for-developers/api/token/3.oauth.md index a29644ab..c93f3af6 100644 --- a/content/en/docs/4.for-developers/api/token/3.oauth.md +++ b/content/en/docs/4.for-developers/api/token/3.oauth.md @@ -14,7 +14,7 @@ OAuth方式は使えるライブラリが多いので、出来ればライブラ 現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。 -- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md) +- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./miauth.md) - [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md) ::: diff --git a/content/en/docs/4.for-developers/api/token/50.app.md b/content/en/docs/4.for-developers/api/token/50.app.md new file mode 100644 index 00000000..edc0ee11 --- /dev/null +++ b/content/en/docs/4.for-developers/api/token/50.app.md @@ -0,0 +1,78 @@ +--- +description: MiAuth導入以前（v12.27.0未満）でのアクセストークン取得方法について説明しています。 +--- + +# アプリ作成方式でのアクセストークン取得方法（旧来型） + +[MiAuth](./miauth.md)導入（12.27.0）や[OAuth](./oauth.md)導入（2023.9.0）より前の、旧来のアクセストークン取得方法について説明します。\ +12.27.0未満のバージョンのサーバーではこの旧来の方式を使用する必要があります。 + +## 1. アプリケーションの作成 + +[`app/create`エンドポイント](endpoints/app/create.html)に情報を送信し、`appSecret`を取得します。 + +```json +{ + // アプリの名前 + "name": "test", + // アプリの説明 + "description": "my test application", + // アプリのパーミッション + "permission": ["write:notes"] +} +``` + +この時、`callbackUrl`でお好きなURLを含めると、次のアクセス許可操作が終了したときに`token`をクエリ文字列に含めながらそこにコールバックするようになります。 + +## 2. ユーザーに認証させる + +[`auth/session/generate`エンドポイント](endpoints/auth/session/generate)に`appSecret`をPOSTします。 + +```json +{ + "appSecret": "fAb12cD34Ef56gH78Ij16kL32Mn64oPf" +} +``` + +`token`（ここでは仮に`798b9f6e-248d-43a7-a919-fabc664027f1`）と`url`を返してくるので、まずはこのurlにウェブブラウザでアクセスし「アクセスを許可」を選択。 + +## 3. accessTokenを問い合わせる + +2が終わったことが確認できたら、[`auth/session/userkey`エンドポイント](endpoints/auth/session/userkey)に`appSecret`と先ほどの`token`をPOSTします。 + +```json +{ + "appSecret": "fAb12cD34Ef56gH78Ij16kL32Mn64oPf", + "token": "798b9f6e-248d-43a7-a919-fabc664027f1" +} +``` + +ここで取得できる文字列は`accessToken`と呼ばれます。`accessToken`は一度限りしか取得できません。 + +## 4. iを生成 + +`i`は、Node.jsであれば以下のようなコードで生成でき、設定画面で取得するものとは違って64桁の16進数となります。 + +```javascript +const crypto = require("crypto") +const i = crypto.createHash("sha256") + .update(accessToken + appSecret, "utf8") + .digest("hex") +console.log(i) +``` + +## 5. 実際にテストする + +```javascript +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + i: "/* ここにiを入力 */", + text: "Hello Misskey API World with My Application!" + }), + headers: { + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` diff --git a/content/en/docs/4.for-developers/bot/1.index.md b/content/en/docs/4.for-developers/bot/1.index.md index 867c72e3..93ef2bce 100644 --- a/content/en/docs/4.for-developers/bot/1.index.md +++ b/content/en/docs/4.for-developers/bot/1.index.md @@ -1,7 +1,6 @@ # Create a bot [Misskey API](/docs/for-developers/api/) can be used to develop a Bot. -In addition, several Bot implementations are publicly available for your reference. - [syuilo/ai](https://github.com/syuilo/ai) ... Made using Node.js, and the bot implementation is written in TypeScript diff --git a/content/en/docs/4.for-developers/plugin/_dir.yml b/content/en/docs/4.for-developers/plugin/_dir.yml new file mode 100644 index 00000000..29adb947 --- /dev/null +++ b/content/en/docs/4.for-developers/plugin/_dir.yml @@ -0,0 +1,2 @@ +title: "Creating a Plugin/Play" +description: "Instructions on how to create Plugins and Plays can be found here." diff --git a/content/en/docs/4.for-developers/plugin/create-plugin.md b/content/en/docs/4.for-developers/plugin/create-plugin.md index c70c6dd2..c60679d9 100644 --- a/content/en/docs/4.for-developers/plugin/create-plugin.md +++ b/content/en/docs/4.for-developers/plugin/create-plugin.md @@ -1,7 +1,6 @@ # Creating Plugins The plugin feature of the Misskey Web Client allows you to extend the client and add various features to it. -This document describes how to create a Plugin. ## AiScript @@ -9,7 +8,7 @@ Plugins are scripts written using AiScript. ## Metadata -Plugins must use AiScript's metadata feature to define the plugin's metadata as the default.Example of some metadata are: +Plugins must use AiScript's metadata feature to define the plugin's metadata as the default.Example of some metadata are:Example of some metadata are: ```AiScript /// @ 0.12.4 @@ -33,7 +32,7 @@ Plugin author ### version -Plugin version.A number must be specified. +Plugin version.A number must be specified.A number must be specified. ### description @@ -41,16 +40,15 @@ Plugin description ### permissions -Permissions required by the plugin.Used when making requests to the Misskey API. +Permissions required by the plugin.Permissions required by the plugin.Used when making requests to the Misskey API. ### config -An object representing the plugin's settings. -Keys are setting names and values are any of the below properties. +An object representing the plugin's settings. Keys are setting names and values are any of the below properties. Please refer to the [Plugin API Reference](./plugin-api-reference/) for information on what APIs are available. #### type -A string representing the setting's value type.Can be either a string, number, or boolean. +A string representing the setting's value type.Can be either a string, number, or boolean.Can be either a string, number, or boolean. #### label @@ -67,10 +65,9 @@ Default value of the setting ## API Misskey Web exposes APIs for Plugins, which can be used to extend client functionality. -Please refer to the [Plugin API Reference](./plugin-api-reference/) for information on what APIs are available. ## Distributing Plugins Starting with v2023.11.0, you can install plugins directly from your website with one click. -If you want to provide plugin installation functionality, you will need to implement an API on your site.For more information, please see [here](./publish-on-your-website.md). +If you want to provide plugin installation functionality, you will need to implement an API on your site.For more information, please see [here](./publish-on-your-website.md).For more information, please see [here](./publish-on-your-website.md). diff --git a/content/en/docs/4.for-developers/plugin/plugin-api-reference.md b/content/en/docs/4.for-developers/plugin/plugin-api-reference.md index d8c75775..c7068f96 100644 --- a/content/en/docs/4.for-developers/plugin/plugin-api-reference.md +++ b/content/en/docs/4.for-developers/plugin/plugin-api-reference.md @@ -10,16 +10,18 @@ If omitted, it will be `info`. Display a confirmation dialog.The following values can be set for type.\ `info` `success` `warn` `error` `question`\ +If omitted, it will be `question`.Display a confirmation dialog.The following values can be set for type.\ +`info` `success` `warn` `error` `question`\ If omitted, it will be `question`.\ Returns `true` if the user selects "OK" or `false` if the user selects "cancel". ## `Mk:api(endpoint params)` -Make a request to the Misskey API.Passes the endpoint name as the first argument and the parameter object as the second argument. +Make a request to the Misskey API.Make a request to the Misskey API.Passes the endpoint name as the first argument and the parameter object as the second argument. ## `Mk:save(key value)` -Persistently saves an arbitrary key with any given value.The saved value will remain after the AiScript context ends and can be loaded with Mk:load. +Persistently saves an arbitrary key with any given value.Persistently saves an arbitrary key with any given value.The saved value will remain after the AiScript context ends and can be loaded with Mk:load. ## `Mk:load(key)` @@ -27,27 +29,31 @@ Reads the value of the specified name saved by Mk:save. ## `Plugin:register_post_form_action(title fn)` -Adds an action in the post form.Passes the name of the action as the first argument and the callback function when the action is selected as the second argument.The post form object is passed to the callback function as the first argument. +Adds an action in the post form.Adds an action in the post form.Passes the name of the action as the first argument and the callback function when the action is selected as the second argument.The post form object is passed to the callback function as the first argument.Display a dialog box.The following values can be set for type.\ +`info` `success` `warn` `error` `question`\ +If omitted, it will be `info`. ## `Plugin:register_note_action(title fn)` -Adds an action in the note menu.Passes the name of the item as the first argument and the callback function when the action is selected as the second argument.\ -The target note object is passed to the callback function as the first argument. +Adds an action in the note menu.Passes the name of the item as the first argument and the callback function when the action is selected as the second argument.Rewrite note information when posting notes.\ +The target note object is passed to the callback function as the first argument.\ +The note will be rewritten with the return value of the callback function. ## `Plugin:register_user_action(title fn)` -Adds an action in the user menu.Passes the name of the item as the first argument and the callback function when the action is selected as the second argument.\ +Adds an action in the user menu.Passes the name of the item as the first argument and the callback function when the action is selected as the second argument.Adds an action in the user menu.Passes the name of the item as the first argument and the callback function when the action is selected as the second argument.\ The target user object is passed to the callback function as the first argument. ## `Plugin:register_note_view_interruptor(fn)` -Rewrites the note information displayed on the UI.\ +Rewrites the note information displayed on the UI.Rewrites the note information displayed on the UI.\ The target note object is passed to the callback function as the first argument.\ +The note will be rewritten with the return value of the callback function.\ The note will be rewritten with the return value of the callback function. ## `Plugin:register_note_post_interruptor(fn)` -Rewrite note information when posting notes.\ +Rewrite note information when posting notes.Adds an action in the note menu.Passes the name of the item as the first argument and the callback function when the action is selected as the second argument.\ The target note object is passed to the callback function as the first argument.\ The note will be rewritten with the return value of the callback function. @@ -57,4 +63,4 @@ Opens the URL given as the first parameter in a new browser tab. ## `Plugin:config` -An object containing the plugin settings.The values set in the plugin definition's config are saved in the object keys. +An object containing the plugin settings.The values set in the plugin definition's config are saved in the object keys.The values set in the plugin definition's config are saved in the object keys. diff --git a/content/en/docs/4.for-developers/publish-on-your-website.md b/content/en/docs/4.for-developers/publish-on-your-website.md index b5778879..701c6954 100644 --- a/content/en/docs/4.for-developers/publish-on-your-website.md +++ b/content/en/docs/4.for-developers/publish-on-your-website.md @@ -1,6 +1,6 @@ # Distributing Plugins and Themes -Starting with Misskey v2023.11.0, you can now install various additional resources directly from your website.This feature is especially useful for those who produce a lot of plugins and themes, and for those who want to create a plugin distribution website. +Starting with Misskey v2023.11.0, you can now install various additional resources directly from your website.This feature is especially useful for those who produce a lot of plugins and themes, and for those who want to create a plugin distribution website.This feature is especially useful for those who produce a lot of plugins and themes, and for those who want to create a plugin distribution website. ## Resources that support external installation diff --git a/content/en/docs/5.releases.md b/content/en/docs/5.releases.md index 17c4324b..59f4524d 100644 --- a/content/en/docs/5.releases.md +++ b/content/en/docs/5.releases.md @@ -6,6 +6,154 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2024.3.1 + +リリース日: 2024/03/02 + +### Client + +- Fix: 絵文字関係の不具合を修正 (#13485) + - 履歴に残っている or ピン留めされた絵文字がコントロールパネルより削除されていた際にリアクションデッキが表示できなくなる + - Unicode絵文字が履歴に残っている or ピン留めされているとリアクションデッキが表示できなくなる +- Fix: カスタム絵文字の画像読み込みに失敗した際はテキストではなくダミー画像を表示 #13487 + +## 2024.3.0 + +リリース日: 2024/03/01 + +### General + +- Enhance: 投稿者のロールに応じて、一つのノートに含むことのできるメンションとダイレクト投稿の宛先の人数に上限を設定できるように + - デフォルトのメンション上限は20アカウントに設定されます。（管理者はベースロールの設定で変更可能です。） + - 連合の問い合わせに応答しないサーバーのリモートユーザーへのメンションは、上限の人数に含めない実装になっています。 +- Enhance: 通知がミュート、凍結を考慮するようになりました +- Enhance: サーバーごとにモデレーションノートを残せるように +- Enhance: コンディショナルロールの条件に「マニュアルロールへのアサイン」を追加 +- Enhance: 通知の受信設定に「フォロー中またはフォロワー」を追加 +- Enhance: 通知の履歴をリセットできるように +- Fix: ダイレクトなノートに対してはダイレクトでしか返信できないように + +### Client + +- Enhance: ノート作成画面のファイル添付メニューの区切り線の位置を調整 +- Fix: syuilo/misskeyの時代からあるインスタンスが改変されたバージョンであると誤認識される問題 +- Fix: MFMのオートコンプリートが出るべき状況で出ないことがある問題を修正 +- Fix: チャートのラベルが消えている問題を修正 +- Fix: 画面表示後最初の音声再生が爆音になることがある問題を修正 +- Fix: 設定のバックアップ作成時に名前を入力しなかった場合、ローカライゼーションがおかしくなる問題を修正 +- Fix: ページ`/admin/emojis`の絵文字編集ダイアログで「リアクションとして使えるロール」を追加する際に何も選択せずOKを押下すると画面が固まる問題を修正 +- Fix: 絵文字サジェストの順位で、絵文字自体の名前が同じものよりもタグで一致しているものが優先されてしまう問題を修正 +- Fix: ユーザの情報のポップアップが消えなくなることがある問題を修正 + +### Server + +- Enhance: エンドポイント`flash/update`の`flashId`以外のパラメータは必須ではなくなりました +- Fix: nodeinfoにenableMcaptchaとenableTurnstileが無いのを修正 +- Fix: 破損した通知をクライアントに送信しないように + - 通知欄が無限にリロードされる問題が改善する可能性があります +- Fix: 禁止キーワードを含むノートがDelayed Queueに追加されて再処理される問題を修正 +- Fix: 自分がフォローしていないアカウントのフォロワー限定ノートが閲覧できることがある問題を修正 +- Fix: タイムラインのオプションで「リノートを表示」を無効にしている際、投票のみの引用リノートが流れてこない問題を修正 +- Fix: エンドポイント`admin/emoji/update`の各種修正 + - 必須パラメータを`id`または`name`のいずれかのみに + - `id`の代わりに`name`で絵文字を指定可能に（`id`・`name`両指定時は従来通り`name`を変更する挙動） + - `category`および`licence`が指定なしの時勝手にnullに上書きされる挙動を修正 +- Fix: 通知の受信設定で「相互フォロー」が正しく動作しない問題を修正 + +## 2024.2.0 + +リリース日: 2024/02/17 + +### Note + +- 外部サイトからプラグインをインストールする場合のパスが`/install-extentions`から`/install-extensions`に変わります。以前のパスからは自動でリダイレクトされるようになっていますが、新しいパスに変更することをお勧めします。 + +### General + +- Feat: [mCaptcha](https://github.com/mCaptcha/mCaptcha)のサポートを追加 +- Feat: Add support for TrueMail +- Feat: AGPLv3ライセンスに誤って違反するのを防止する機能を追加 + - 管理者がrepositoryUrlを変更したり、またはソースコードを直接頒布することを選択できるようになります + - 本体のソースコードに改変を加えた際に、ライセンスに基づく適切な案内を表示します +- Enhance: モデレーターはすべてのユーザーのリアクション一覧を見られるように +- Fix: リストライムラインの「リノートを表示」が正しく機能しない問題を修正 +- Fix: リモートユーザーのリアクション一覧がすべて見えてしまうのを修正 + - すべてのリモートユーザーのリアクション一覧を見えないようにします +- Fix: 特定のキーワード及び正規表現にマッチする文字列を含むノートが投稿された際、エラーに出来るような設定項目を追加 #13207 + - デフォルトは空欄なので適用前と同等の動作になります + +### Client + +- Feat: 新しいゲームを追加 +- Feat: 音声・映像プレイヤーを追加 +- Feat: 絵文字の詳細ダイアログを追加 +- Feat: 枠線をつけるMFM`$[border.width=1,style=solid,color=fff,radius=0 ...]`を追加 + - デフォルトで枠線からはみ出る部分が隠されるようにしました。初期と同じ挙動にするには`$[border.noclip`が必要です +- Feat: スワイプでタブを切り替えられるように +- Enhance: MFM等のコードブロックに全文コピー用のボタンを追加 +- Enhance: ハッシュタグ入力時に、本文の末尾の行に何も書かれていない場合は新たにスペースを追加しないように +- Enhance: チャンネルノートのピン留めをノートのメニューからできるように +- Enhance: 管理者の場合はAPI tokenの発行画面で管理機能に関する権限を付与できるように +- Enhance: AiScriptを0.17.0に更新 [CHANGELOG](https://github.com/aiscript-dev/aiscript/blob/bb89d132b633a622d3cb0eff0d0cc7e476c0cfdd/CHANGELOG.md) + - 配列の範囲外・非整数のインデックスへの代入が完全禁止になるので注意 +- Enhance: 絵文字ピッカー・オートコンプリートで、完全一致した絵文字を優先的に表示するように +- Enhance: Playの説明欄にMFMを使えるように +- Enhance: チャンネルノートの場合は詳細ページからその前後のノートを見れるように +- Enhance: 季節に応じた画面の演出を南半球でも利用できるように +- Enhance: タイムラインフィルターの設定をすべて保持できるように + - 今までの「TLに他の人への返信を含める」設定は一旦リセットされます +- Enhance: タイムラインフィルターに「センシティブなファイルを含むノートを表示」を追加 +- Enhance: ノート作成画面のファイル添付メニューから直接ファイルを削除できるように +- Enhance: MFMの属性でオートコンプリートが使用できるように #12735 +- Enhance: 絵文字編集ダイアログをモーダルではなくウィンドウで表示するように +- Enhance: リモートのユーザーはメニューから直接リモートで表示できるように +- Enhance: リモートへの引用リノートと同一のリンクにはリンクプレビューを表示しないように +- Enhance: コードのシンタックスハイライトにテーマを適用できるように +- Enhance: リアクション権限がない場合、ハートにフォールバックするのではなくリアクションピッカーなどから打てないように + - リモートのユーザーにローカルのみのカスタム絵文字をリアクションしようとした場合 + - センシティブなリアクションを認めていないユーザーにセンシティブなカスタム絵文字をリアクションしようとした場合 + - ロールが必要な絵文字をリアクションしようとした場合 +- Enhance: ページ遷移時にPlayerを閉じるように +- Enhance: 通報ページのユーザをクリックした際にユーザをウィンドウで開くように +- Enhance: ノートの通報時にリモートのノートであっても自インスタンスにおけるノートのリンクを含むように +- Enhance: オフライン表示のデザインを改善・多言語対応 +- Fix: ネイティブモードの絵文字がモノクロにならないように +- Fix: v2023.12.0で追加された「モデレーターがユーザーのアイコンもしくはバナー画像を未設定状態にできる機能」が管理画面上で正しく表示されていない問題を修正 +- Fix: AiScriptの`readline`関数が不正な値を返すことがある問題のv2023.12.0時点での修正がPlay以外に適用されていないのを修正 +- Fix: v2023.12.1で追加された`$[clickable ...]`および`onClickEv`が正しく機能していないのを修正 +- Fix: Renoteのキーボードショートカットが機能していなかった問題を修正 +- Fix: 投稿フォームでアンケートの日時指定をした状態で再読み込みをすると期日が復元されない問題を修正 +- Fix: アンケートを設定したノートを「削除して編集」をするとアンケートの期日が引き継がれず、リセットされてしまう問題を修正 +- Fix: デッキのプロファイル作成時に名前を空にできる問題を修正 +- Fix: テーマ作成時に名称が空欄でも作成できてしまう問題を修正 +- Fix: プラグインで`Plugin:register_note_post_interruptor`を使用すると、ノートが投稿できなくなる問題を修正 +- Fix: iOSで大きな画像を変換してアップロードできない問題を修正 +- Fix: 「アニメーション画像を再生しない」もしくは「データセーバー（アイコン）」を有効にしていても、アイコンデコレーションのアニメーションが停止されない問題を修正 +- Fix: 画像をクロップするとクロップ後の解像度が異様に低くなる問題の修正 +- Fix: 画像をクロップ時、正常に完了できない問題の修正 +- Fix: キャプションが空の画像をクロップするとキャプションにnullという文字列が入ってしまう問題の修正 +- Fix: プロフィールを編集してもリロードするまで反映されない問題を修正 +- Fix: エラー画像URLを設定した後解除すると，デフォルトの画像が表示されない問題の修正 +- Fix: MkCodeEditorで行がずれていってしまう問題の修正 +- Fix: Summaly proxy利用時にプレイヤーが動作しないことがあるのを修正 #13196 + +### Server + +- Enhance: 連合先のレートリミットを超過した際にリトライするようになりました +- Enhance: ActivityPub Deliver queueでBodyを事前処理するように (#12916) +- Enhance: クリップをエクスポートできるように +- Enhance: `/files`のファイルに対してHTTP Rangeリクエストを行えるように +- Enhance: `api.json`のOpenAPI Specificationを3.1.0に更新 +- Enhance: 連合向けのノート配信を軽量化 #13192 +- Fix: `drive/files/update`でファイル名のバリデーションが機能していない問題を修正 +- Fix: `notes/create`で、`text`が空白文字のみで構成されているか`null`であって、かつ`text`だけであるリクエストに対するレスポンスが400になるように変更 +- Fix: `notes/create`で、`text`が空白文字のみで構成されていてかつリノート、ファイルまたは投票を含んでいるリクエストに対するレスポンスの`text`が`""`から`null`になるように変更 +- Fix: ipv4とipv6の両方が利用可能な環境でallowedPrivateNetworksが設定されていた場合プライベートipの検証ができていなかった問題を修正 +- Fix: properly handle cc followers +- Fix: ジョブに関する設定の名前を修正 relashionshipJobPerSec -> relationshipJobPerSec +- Fix: コントロールパネル->モデレーション->「誰でも新規登録できるようにする」の初期値をONからOFFに変更 #13122 +- Fix: リモートユーザーが復活してもキャッシュにより該当ユーザーのActivityが受け入れられないのを修正 #13273 + ## 2023.12.2 リリース日: 2023/12/28 @@ -1999,8 +2147,7 @@ same as 12.112.0 ### NOTE -:::warning - +::: warning このバージョンからNode v16.14.0以降が必要です ::: @@ -2113,14 +2260,12 @@ same as 12.112.0 ### Note -:::warning - +::: warning ビルドする前に`npm run clean`を実行してください。 ::: -:::warning - +::: warning このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 diff --git a/content/fr/docs/2.for-users/4.resources/donate.md b/content/en/docs/6.donate.md similarity index 93% rename from content/fr/docs/2.for-users/4.resources/donate.md rename to content/en/docs/6.donate.md index bbd32212..eb596126 100644 --- a/content/fr/docs/2.for-users/4.resources/donate.md +++ b/content/en/docs/6.donate.md @@ -1,5 +1,9 @@ # プロジェクトへの寄付 +:::tip +法人としてプロジェクトへの支援(スポンサー)をご検討の方は[こちらをご覧ください。](/docs/become-a-sponsor/) +::: + Misskeyはビジネスではなく、利用は無料であるため、収益は皆様からの寄付のみです。(サーバーによっては広告収入を得ているような場合もありますが、それは運営者の収入であり直接開発者への収入にはなりません) 寄付をしていただければ、今後も開発を続けることが可能になり、プロジェクトへの貢献になります。以下の方法で受け付けています。 diff --git a/content/en/docs/7.become-a-sponsor.md b/content/en/docs/7.become-a-sponsor.md new file mode 100644 index 00000000..54f5d338 --- /dev/null +++ b/content/en/docs/7.become-a-sponsor.md @@ -0,0 +1,7 @@ +# スポンサーについて + +Misskey Projectはスポンサーを募集しています。 + +スポンサーになると、MisskeyやMisskey Hubへの会社ロゴ掲載や、技術サポートを受けることができます。 + +[詳細はこちらからお問い合わせください。](/contact/) diff --git a/content/fr/docs/1.about-misskey.md b/content/fr/docs/1.about-misskey.md index 807fadca..78d3b431 100644 --- a/content/fr/docs/1.about-misskey.md +++ b/content/fr/docs/1.about-misskey.md @@ -73,7 +73,7 @@ Misskeyは[Crowdinというサービスを使用して翻訳の管理を行っ ### 寄付をする -[こちらをご覧ください](/docs/donate/) +[こちらをご覧ください](/docs/for-users/resources/donate/) ## よくある質問 diff --git a/content/fr/docs/2.for-users/2.onboarding/1.warning.md b/content/fr/docs/2.for-users/2.onboarding/1.warning.md index 1056b929..db620b9b 100644 --- a/content/fr/docs/2.for-users/2.onboarding/1.warning.md +++ b/content/fr/docs/2.for-users/2.onboarding/1.warning.md @@ -8,6 +8,7 @@ Misskeyを使ったサービスを利用するにあたり、いくつか注意 - 分散型のため、一度アップロードしたデータは削除したとしても他の全てのサーバーから削除されることは保証されません。(ただし、これはインターネット全般に言えることでもあります。) - 非公開で行った投稿でも、相手のサーバーがそれを同じように非公開として扱うかは保証されません。個人情報、機密情報を投稿する際は十分注意してください。(ただし、これはインターネット全般に言えることでもあります。) +- Misskeyに搭載されている「ドライブ」機能は一般的なクラウドストレージではありません。この機能は、アップロードしたファイルを管理したり再利用したりするためのものです。 **アップロードされたデータは、ノートに添付したことがあるかどうかにかかわらず、URLを知っている人ならだれでもアクセスできます。** 機密情報を含むデータのやりとりには専用のサービスをご利用ください。 - アカウントの削除は負荷の高い処理であるため、長い時間がかかることがあります。アップロードしたデータが多いケースではアカウントの削除が不可能なこともあります。 - サーバーによっては、広告収入により運営費を賄っていることがあります。また、アドブロッカーは広告とは全く関係のないコンテンツや機能を誤ってブロックすることがよくあり、クライアントの動作に支障をきたし、正常にMisskeyを使用できなくなるおそれがあります。そのため、Misskeyではアドブロッカーやそれに類する機能はオフにしてご利用ください。 diff --git a/content/fr/docs/2.for-users/3.features/deck.md b/content/fr/docs/2.for-users/3.features/deck.md index 438a833e..5123a8a7 100644 --- a/content/fr/docs/2.for-users/3.features/deck.md +++ b/content/fr/docs/2.for-users/3.features/deck.md @@ -2,6 +2,7 @@ デッキは利用可能なUIのひとつです。「カラム」と呼ばれるビューを複数並べて表示させることで、カスタマイズ性が高く、情報量の多いUIが構築できることが特徴です。\ \ +\ なお、メインカラムを追加しておくと、ノートやプロフィールをページで表示した際、メインカラムに内容が表示されます。 ## カラムの追加 diff --git a/content/fr/docs/2.for-users/3.features/mfm.md b/content/fr/docs/2.for-users/3.features/mfm.md index 6ec1aa36..7dcdd3cd 100644 --- a/content/fr/docs/2.for-users/3.features/mfm.md +++ b/content/fr/docs/2.for-users/3.features/mfm.md @@ -143,6 +143,16 @@ https://example.com
リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 | -| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](./permission.md)で確認できます。 | - -:::tip{label='例'} - -``` -https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive -``` - -::: - -#### Step 3 - -ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 - -``` -https://{host}/api/miauth/{session}/check -``` - -ここで、 - -- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。 -- `{session}`の部分は、セッションIDに置き換えます。 - -レスポンスに含まれるプロパティは以下の通りです: - -| 名前 | 説明 | -| ------- | -------------- | -| `token` | ユーザーのアクセストークン。 | -| `user` | ユーザーの情報。 | - -## APIの利用 - -アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。 - -:::tip - -- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。 -- 要求ヘッダーに`Content-Type: application/json`を指定します。 -- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。 -- ベースURLは`https://{サーバーのドメイン}/api`です。 - -::: - -アクセストークン付きのボディの例（metaの場合）: - -```json -{ - "i": "HogEFugA1341", - "detail": false -} -``` - - - -APIの詳細は、APIリファレンスを参照してください。 - -:::warning - -MisskeyはRESTを採用していません。 - -::: - -また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 diff --git a/content/fr/docs/4.for-developers/api/token/3.oauth.md b/content/fr/docs/4.for-developers/api/token/3.oauth.md index a29644ab..c93f3af6 100644 --- a/content/fr/docs/4.for-developers/api/token/3.oauth.md +++ b/content/fr/docs/4.for-developers/api/token/3.oauth.md @@ -14,7 +14,7 @@ OAuth方式は使えるライブラリが多いので、出来ればライブラ 現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。 -- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md) +- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./miauth.md) - [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md) ::: diff --git a/content/fr/docs/4.for-developers/api/token/50.app.md b/content/fr/docs/4.for-developers/api/token/50.app.md new file mode 100644 index 00000000..edc0ee11 --- /dev/null +++ b/content/fr/docs/4.for-developers/api/token/50.app.md @@ -0,0 +1,78 @@ +--- +description: MiAuth導入以前（v12.27.0未満）でのアクセストークン取得方法について説明しています。 +--- + +# アプリ作成方式でのアクセストークン取得方法（旧来型） + +[MiAuth](./miauth.md)導入（12.27.0）や[OAuth](./oauth.md)導入（2023.9.0）より前の、旧来のアクセストークン取得方法について説明します。\ +12.27.0未満のバージョンのサーバーではこの旧来の方式を使用する必要があります。 + +## 1. アプリケーションの作成 + +[`app/create`エンドポイント](endpoints/app/create.html)に情報を送信し、`appSecret`を取得します。 + +```json +{ + // アプリの名前 + "name": "test", + // アプリの説明 + "description": "my test application", + // アプリのパーミッション + "permission": ["write:notes"] +} +``` + +この時、`callbackUrl`でお好きなURLを含めると、次のアクセス許可操作が終了したときに`token`をクエリ文字列に含めながらそこにコールバックするようになります。 + +## 2. ユーザーに認証させる + +[`auth/session/generate`エンドポイント](endpoints/auth/session/generate)に`appSecret`をPOSTします。 + +```json +{ + "appSecret": "fAb12cD34Ef56gH78Ij16kL32Mn64oPf" +} +``` + +`token`（ここでは仮に`798b9f6e-248d-43a7-a919-fabc664027f1`）と`url`を返してくるので、まずはこのurlにウェブブラウザでアクセスし「アクセスを許可」を選択。 + +## 3. accessTokenを問い合わせる + +2が終わったことが確認できたら、[`auth/session/userkey`エンドポイント](endpoints/auth/session/userkey)に`appSecret`と先ほどの`token`をPOSTします。 + +```json +{ + "appSecret": "fAb12cD34Ef56gH78Ij16kL32Mn64oPf", + "token": "798b9f6e-248d-43a7-a919-fabc664027f1" +} +``` + +ここで取得できる文字列は`accessToken`と呼ばれます。`accessToken`は一度限りしか取得できません。 + +## 4. iを生成 + +`i`は、Node.jsであれば以下のようなコードで生成でき、設定画面で取得するものとは違って64桁の16進数となります。 + +```javascript +const crypto = require("crypto") +const i = crypto.createHash("sha256") + .update(accessToken + appSecret, "utf8") + .digest("hex") +console.log(i) +``` + +## 5. 実際にテストする + +```javascript +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + i: "/* ここにiを入力 */", + text: "Hello Misskey API World with My Application!" + }), + headers: { + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` diff --git a/content/fr/docs/4.for-developers/plugin/_dir.yml b/content/fr/docs/4.for-developers/plugin/_dir.yml new file mode 100644 index 00000000..0be8be5d --- /dev/null +++ b/content/fr/docs/4.for-developers/plugin/_dir.yml @@ -0,0 +1,2 @@ +title: "プラグイン・Playの作成" +description: "プラグインやPlayを作成する方法・各種リファレンスを公開中。" diff --git a/content/fr/docs/5.releases.md b/content/fr/docs/5.releases.md index 17c4324b..59f4524d 100644 --- a/content/fr/docs/5.releases.md +++ b/content/fr/docs/5.releases.md @@ -6,6 +6,154 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2024.3.1 + +リリース日: 2024/03/02 + +### Client + +- Fix: 絵文字関係の不具合を修正 (#13485) + - 履歴に残っている or ピン留めされた絵文字がコントロールパネルより削除されていた際にリアクションデッキが表示できなくなる + - Unicode絵文字が履歴に残っている or ピン留めされているとリアクションデッキが表示できなくなる +- Fix: カスタム絵文字の画像読み込みに失敗した際はテキストではなくダミー画像を表示 #13487 + +## 2024.3.0 + +リリース日: 2024/03/01 + +### General + +- Enhance: 投稿者のロールに応じて、一つのノートに含むことのできるメンションとダイレクト投稿の宛先の人数に上限を設定できるように + - デフォルトのメンション上限は20アカウントに設定されます。（管理者はベースロールの設定で変更可能です。） + - 連合の問い合わせに応答しないサーバーのリモートユーザーへのメンションは、上限の人数に含めない実装になっています。 +- Enhance: 通知がミュート、凍結を考慮するようになりました +- Enhance: サーバーごとにモデレーションノートを残せるように +- Enhance: コンディショナルロールの条件に「マニュアルロールへのアサイン」を追加 +- Enhance: 通知の受信設定に「フォロー中またはフォロワー」を追加 +- Enhance: 通知の履歴をリセットできるように +- Fix: ダイレクトなノートに対してはダイレクトでしか返信できないように + +### Client + +- Enhance: ノート作成画面のファイル添付メニューの区切り線の位置を調整 +- Fix: syuilo/misskeyの時代からあるインスタンスが改変されたバージョンであると誤認識される問題 +- Fix: MFMのオートコンプリートが出るべき状況で出ないことがある問題を修正 +- Fix: チャートのラベルが消えている問題を修正 +- Fix: 画面表示後最初の音声再生が爆音になることがある問題を修正 +- Fix: 設定のバックアップ作成時に名前を入力しなかった場合、ローカライゼーションがおかしくなる問題を修正 +- Fix: ページ`/admin/emojis`の絵文字編集ダイアログで「リアクションとして使えるロール」を追加する際に何も選択せずOKを押下すると画面が固まる問題を修正 +- Fix: 絵文字サジェストの順位で、絵文字自体の名前が同じものよりもタグで一致しているものが優先されてしまう問題を修正 +- Fix: ユーザの情報のポップアップが消えなくなることがある問題を修正 + +### Server + +- Enhance: エンドポイント`flash/update`の`flashId`以外のパラメータは必須ではなくなりました +- Fix: nodeinfoにenableMcaptchaとenableTurnstileが無いのを修正 +- Fix: 破損した通知をクライアントに送信しないように + - 通知欄が無限にリロードされる問題が改善する可能性があります +- Fix: 禁止キーワードを含むノートがDelayed Queueに追加されて再処理される問題を修正 +- Fix: 自分がフォローしていないアカウントのフォロワー限定ノートが閲覧できることがある問題を修正 +- Fix: タイムラインのオプションで「リノートを表示」を無効にしている際、投票のみの引用リノートが流れてこない問題を修正 +- Fix: エンドポイント`admin/emoji/update`の各種修正 + - 必須パラメータを`id`または`name`のいずれかのみに + - `id`の代わりに`name`で絵文字を指定可能に（`id`・`name`両指定時は従来通り`name`を変更する挙動） + - `category`および`licence`が指定なしの時勝手にnullに上書きされる挙動を修正 +- Fix: 通知の受信設定で「相互フォロー」が正しく動作しない問題を修正 + +## 2024.2.0 + +リリース日: 2024/02/17 + +### Note + +- 外部サイトからプラグインをインストールする場合のパスが`/install-extentions`から`/install-extensions`に変わります。以前のパスからは自動でリダイレクトされるようになっていますが、新しいパスに変更することをお勧めします。 + +### General + +- Feat: [mCaptcha](https://github.com/mCaptcha/mCaptcha)のサポートを追加 +- Feat: Add support for TrueMail +- Feat: AGPLv3ライセンスに誤って違反するのを防止する機能を追加 + - 管理者がrepositoryUrlを変更したり、またはソースコードを直接頒布することを選択できるようになります + - 本体のソースコードに改変を加えた際に、ライセンスに基づく適切な案内を表示します +- Enhance: モデレーターはすべてのユーザーのリアクション一覧を見られるように +- Fix: リストライムラインの「リノートを表示」が正しく機能しない問題を修正 +- Fix: リモートユーザーのリアクション一覧がすべて見えてしまうのを修正 + - すべてのリモートユーザーのリアクション一覧を見えないようにします +- Fix: 特定のキーワード及び正規表現にマッチする文字列を含むノートが投稿された際、エラーに出来るような設定項目を追加 #13207 + - デフォルトは空欄なので適用前と同等の動作になります + +### Client + +- Feat: 新しいゲームを追加 +- Feat: 音声・映像プレイヤーを追加 +- Feat: 絵文字の詳細ダイアログを追加 +- Feat: 枠線をつけるMFM`$[border.width=1,style=solid,color=fff,radius=0 ...]`を追加 + - デフォルトで枠線からはみ出る部分が隠されるようにしました。初期と同じ挙動にするには`$[border.noclip`が必要です +- Feat: スワイプでタブを切り替えられるように +- Enhance: MFM等のコードブロックに全文コピー用のボタンを追加 +- Enhance: ハッシュタグ入力時に、本文の末尾の行に何も書かれていない場合は新たにスペースを追加しないように +- Enhance: チャンネルノートのピン留めをノートのメニューからできるように +- Enhance: 管理者の場合はAPI tokenの発行画面で管理機能に関する権限を付与できるように +- Enhance: AiScriptを0.17.0に更新 [CHANGELOG](https://github.com/aiscript-dev/aiscript/blob/bb89d132b633a622d3cb0eff0d0cc7e476c0cfdd/CHANGELOG.md) + - 配列の範囲外・非整数のインデックスへの代入が完全禁止になるので注意 +- Enhance: 絵文字ピッカー・オートコンプリートで、完全一致した絵文字を優先的に表示するように +- Enhance: Playの説明欄にMFMを使えるように +- Enhance: チャンネルノートの場合は詳細ページからその前後のノートを見れるように +- Enhance: 季節に応じた画面の演出を南半球でも利用できるように +- Enhance: タイムラインフィルターの設定をすべて保持できるように + - 今までの「TLに他の人への返信を含める」設定は一旦リセットされます +- Enhance: タイムラインフィルターに「センシティブなファイルを含むノートを表示」を追加 +- Enhance: ノート作成画面のファイル添付メニューから直接ファイルを削除できるように +- Enhance: MFMの属性でオートコンプリートが使用できるように #12735 +- Enhance: 絵文字編集ダイアログをモーダルではなくウィンドウで表示するように +- Enhance: リモートのユーザーはメニューから直接リモートで表示できるように +- Enhance: リモートへの引用リノートと同一のリンクにはリンクプレビューを表示しないように +- Enhance: コードのシンタックスハイライトにテーマを適用できるように +- Enhance: リアクション権限がない場合、ハートにフォールバックするのではなくリアクションピッカーなどから打てないように + - リモートのユーザーにローカルのみのカスタム絵文字をリアクションしようとした場合 + - センシティブなリアクションを認めていないユーザーにセンシティブなカスタム絵文字をリアクションしようとした場合 + - ロールが必要な絵文字をリアクションしようとした場合 +- Enhance: ページ遷移時にPlayerを閉じるように +- Enhance: 通報ページのユーザをクリックした際にユーザをウィンドウで開くように +- Enhance: ノートの通報時にリモートのノートであっても自インスタンスにおけるノートのリンクを含むように +- Enhance: オフライン表示のデザインを改善・多言語対応 +- Fix: ネイティブモードの絵文字がモノクロにならないように +- Fix: v2023.12.0で追加された「モデレーターがユーザーのアイコンもしくはバナー画像を未設定状態にできる機能」が管理画面上で正しく表示されていない問題を修正 +- Fix: AiScriptの`readline`関数が不正な値を返すことがある問題のv2023.12.0時点での修正がPlay以外に適用されていないのを修正 +- Fix: v2023.12.1で追加された`$[clickable ...]`および`onClickEv`が正しく機能していないのを修正 +- Fix: Renoteのキーボードショートカットが機能していなかった問題を修正 +- Fix: 投稿フォームでアンケートの日時指定をした状態で再読み込みをすると期日が復元されない問題を修正 +- Fix: アンケートを設定したノートを「削除して編集」をするとアンケートの期日が引き継がれず、リセットされてしまう問題を修正 +- Fix: デッキのプロファイル作成時に名前を空にできる問題を修正 +- Fix: テーマ作成時に名称が空欄でも作成できてしまう問題を修正 +- Fix: プラグインで`Plugin:register_note_post_interruptor`を使用すると、ノートが投稿できなくなる問題を修正 +- Fix: iOSで大きな画像を変換してアップロードできない問題を修正 +- Fix: 「アニメーション画像を再生しない」もしくは「データセーバー（アイコン）」を有効にしていても、アイコンデコレーションのアニメーションが停止されない問題を修正 +- Fix: 画像をクロップするとクロップ後の解像度が異様に低くなる問題の修正 +- Fix: 画像をクロップ時、正常に完了できない問題の修正 +- Fix: キャプションが空の画像をクロップするとキャプションにnullという文字列が入ってしまう問題の修正 +- Fix: プロフィールを編集してもリロードするまで反映されない問題を修正 +- Fix: エラー画像URLを設定した後解除すると，デフォルトの画像が表示されない問題の修正 +- Fix: MkCodeEditorで行がずれていってしまう問題の修正 +- Fix: Summaly proxy利用時にプレイヤーが動作しないことがあるのを修正 #13196 + +### Server + +- Enhance: 連合先のレートリミットを超過した際にリトライするようになりました +- Enhance: ActivityPub Deliver queueでBodyを事前処理するように (#12916) +- Enhance: クリップをエクスポートできるように +- Enhance: `/files`のファイルに対してHTTP Rangeリクエストを行えるように +- Enhance: `api.json`のOpenAPI Specificationを3.1.0に更新 +- Enhance: 連合向けのノート配信を軽量化 #13192 +- Fix: `drive/files/update`でファイル名のバリデーションが機能していない問題を修正 +- Fix: `notes/create`で、`text`が空白文字のみで構成されているか`null`であって、かつ`text`だけであるリクエストに対するレスポンスが400になるように変更 +- Fix: `notes/create`で、`text`が空白文字のみで構成されていてかつリノート、ファイルまたは投票を含んでいるリクエストに対するレスポンスの`text`が`""`から`null`になるように変更 +- Fix: ipv4とipv6の両方が利用可能な環境でallowedPrivateNetworksが設定されていた場合プライベートipの検証ができていなかった問題を修正 +- Fix: properly handle cc followers +- Fix: ジョブに関する設定の名前を修正 relashionshipJobPerSec -> relationshipJobPerSec +- Fix: コントロールパネル->モデレーション->「誰でも新規登録できるようにする」の初期値をONからOFFに変更 #13122 +- Fix: リモートユーザーが復活してもキャッシュにより該当ユーザーのActivityが受け入れられないのを修正 #13273 + ## 2023.12.2 リリース日: 2023/12/28 @@ -1999,8 +2147,7 @@ same as 12.112.0 ### NOTE -:::warning - +::: warning このバージョンからNode v16.14.0以降が必要です ::: @@ -2113,14 +2260,12 @@ same as 12.112.0 ### Note -:::warning - +::: warning ビルドする前に`npm run clean`を実行してください。 ::: -:::warning - +::: warning このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 diff --git a/content/en/docs/2.for-users/4.resources/donate.md b/content/fr/docs/6.donate.md similarity index 81% rename from content/en/docs/2.for-users/4.resources/donate.md rename to content/fr/docs/6.donate.md index bbd32212..fb912a7d 100644 --- a/content/en/docs/2.for-users/4.resources/donate.md +++ b/content/fr/docs/6.donate.md @@ -1,5 +1,9 @@ # プロジェクトへの寄付 +:::tip +法人としてプロジェクトへの支援(スポンサー)をご検討の方は[こちらをご覧ください。](/docs/become-a-sponsor/) +::: + Misskeyはビジネスではなく、利用は無料であるため、収益は皆様からの寄付のみです。(サーバーによっては広告収入を得ているような場合もありますが、それは運営者の収入であり直接開発者への収入にはなりません) 寄付をしていただければ、今後も開発を続けることが可能になり、プロジェクトへの貢献になります。以下の方法で受け付けています。 @@ -25,12 +29,14 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 - 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載 - 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載 + ::: ::: :::warning -**バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。** +\*\*バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。また、misskey.io以外のサーバーからはメンション届かない場合があります) +::: (メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります) diff --git a/content/fr/docs/7.become-a-sponsor.md b/content/fr/docs/7.become-a-sponsor.md new file mode 100644 index 00000000..54f5d338 --- /dev/null +++ b/content/fr/docs/7.become-a-sponsor.md @@ -0,0 +1,7 @@ +# スポンサーについて + +Misskey Projectはスポンサーを募集しています。 + +スポンサーになると、MisskeyやMisskey Hubへの会社ロゴ掲載や、技術サポートを受けることができます。 + +[詳細はこちらからお問い合わせください。](/contact/) diff --git a/content/id/docs/1.about-misskey.md b/content/id/docs/1.about-misskey.md index b1b469ed..eeec8289 100644 --- a/content/id/docs/1.about-misskey.md +++ b/content/id/docs/1.about-misskey.md @@ -59,7 +59,7 @@ Di samping melaporkan bug, silakan bagikan kesan positif seperti bagian Misskey ### Berdonasi -[Silakan lihat ini](/docs/donate/) +[Silakan lihat ini](/docs/for-users/resources/donate/) ## Pertanyaan Sering Diajukan @@ -118,11 +118,12 @@ Silakan rujuk ke [koleksi aset](/brand-assets/). :::fukidashi{chara="doya_ai" charaName="藍(Ai)"} Kalo mau tau lebih jauh tentang aku, lihat dan kunjungi aku ke [situs ini](https://xn--931a.moe/)! +::: ::: :::fukidashi{chara="syuilo" charaName="しゅいろ(syuilo)" direction="right"} -Dia adalah dewa penjaga Misskey, Ai.(Yooot, mereka menganggap Ai lucu!) +Dia adalah dewa penjaga Misskey, Ai.(Hiyaaaaa, mereka menganggap Ai lucu!) ::: diff --git a/content/id/docs/2.for-users/2.onboarding/1.warning.md b/content/id/docs/2.for-users/2.onboarding/1.warning.md index 1056b929..db620b9b 100644 --- a/content/id/docs/2.for-users/2.onboarding/1.warning.md +++ b/content/id/docs/2.for-users/2.onboarding/1.warning.md @@ -8,6 +8,7 @@ Misskeyを使ったサービスを利用するにあたり、いくつか注意 - 分散型のため、一度アップロードしたデータは削除したとしても他の全てのサーバーから削除されることは保証されません。(ただし、これはインターネット全般に言えることでもあります。) - 非公開で行った投稿でも、相手のサーバーがそれを同じように非公開として扱うかは保証されません。個人情報、機密情報を投稿する際は十分注意してください。(ただし、これはインターネット全般に言えることでもあります。) +- Misskeyに搭載されている「ドライブ」機能は一般的なクラウドストレージではありません。この機能は、アップロードしたファイルを管理したり再利用したりするためのものです。 **アップロードされたデータは、ノートに添付したことがあるかどうかにかかわらず、URLを知っている人ならだれでもアクセスできます。** 機密情報を含むデータのやりとりには専用のサービスをご利用ください。 - アカウントの削除は負荷の高い処理であるため、長い時間がかかることがあります。アップロードしたデータが多いケースではアカウントの削除が不可能なこともあります。 - サーバーによっては、広告収入により運営費を賄っていることがあります。また、アドブロッカーは広告とは全く関係のないコンテンツや機能を誤ってブロックすることがよくあり、クライアントの動作に支障をきたし、正常にMisskeyを使用できなくなるおそれがあります。そのため、Misskeyではアドブロッカーやそれに類する機能はオフにしてご利用ください。 diff --git a/content/id/docs/2.for-users/3.features/mfm.md b/content/id/docs/2.for-users/3.features/mfm.md index 8469e229..44145f81 100644 --- a/content/id/docs/2.for-users/3.features/mfm.md +++ b/content/id/docs/2.for-users/3.features/mfm.md @@ -143,6 +143,16 @@ https://example.com
リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 | -| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](./permission.md)で確認できます。 | - -:::tip{label='例'} - -``` -https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive -``` - -::: - -#### Step 3 - -ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 - -``` -https://{host}/api/miauth/{session}/check -``` - -ここで、 - -- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。 -- `{session}`の部分は、セッションIDに置き換えます。 - -レスポンスに含まれるプロパティは以下の通りです: - -| 名前 | 説明 | -| ------- | -------------- | -| `token` | ユーザーのアクセストークン。 | -| `user` | ユーザーの情報。 | - -## APIの利用 - -アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。 - -:::tip - -- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。 -- 要求ヘッダーに`Content-Type: application/json`を指定します。 -- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。 -- ベースURLは`https://{サーバーのドメイン}/api`です。 - -::: - -アクセストークン付きのボディの例（metaの場合）: - -```json -{ - "i": "HogEFugA1341", - "detail": false -} -``` - - - -APIの詳細は、APIリファレンスを参照してください。 - -:::warning - -MisskeyはRESTを採用していません。 - -::: - -また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 diff --git a/content/id/docs/4.for-developers/api/token/3.oauth.md b/content/id/docs/4.for-developers/api/token/3.oauth.md index a29644ab..c93f3af6 100644 --- a/content/id/docs/4.for-developers/api/token/3.oauth.md +++ b/content/id/docs/4.for-developers/api/token/3.oauth.md @@ -14,7 +14,7 @@ OAuth方式は使えるライブラリが多いので、出来ればライブラ 現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。 -- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md) +- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./miauth.md) - [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md) ::: diff --git a/content/id/docs/4.for-developers/api/token/50.app.md b/content/id/docs/4.for-developers/api/token/50.app.md new file mode 100644 index 00000000..edc0ee11 --- /dev/null +++ b/content/id/docs/4.for-developers/api/token/50.app.md @@ -0,0 +1,78 @@ +--- +description: MiAuth導入以前（v12.27.0未満）でのアクセストークン取得方法について説明しています。 +--- + +# アプリ作成方式でのアクセストークン取得方法（旧来型） + +[MiAuth](./miauth.md)導入（12.27.0）や[OAuth](./oauth.md)導入（2023.9.0）より前の、旧来のアクセストークン取得方法について説明します。\ +12.27.0未満のバージョンのサーバーではこの旧来の方式を使用する必要があります。 + +## 1. アプリケーションの作成 + +[`app/create`エンドポイント](endpoints/app/create.html)に情報を送信し、`appSecret`を取得します。 + +```json +{ + // アプリの名前 + "name": "test", + // アプリの説明 + "description": "my test application", + // アプリのパーミッション + "permission": ["write:notes"] +} +``` + +この時、`callbackUrl`でお好きなURLを含めると、次のアクセス許可操作が終了したときに`token`をクエリ文字列に含めながらそこにコールバックするようになります。 + +## 2. ユーザーに認証させる + +[`auth/session/generate`エンドポイント](endpoints/auth/session/generate)に`appSecret`をPOSTします。 + +```json +{ + "appSecret": "fAb12cD34Ef56gH78Ij16kL32Mn64oPf" +} +``` + +`token`（ここでは仮に`798b9f6e-248d-43a7-a919-fabc664027f1`）と`url`を返してくるので、まずはこのurlにウェブブラウザでアクセスし「アクセスを許可」を選択。 + +## 3. accessTokenを問い合わせる + +2が終わったことが確認できたら、[`auth/session/userkey`エンドポイント](endpoints/auth/session/userkey)に`appSecret`と先ほどの`token`をPOSTします。 + +```json +{ + "appSecret": "fAb12cD34Ef56gH78Ij16kL32Mn64oPf", + "token": "798b9f6e-248d-43a7-a919-fabc664027f1" +} +``` + +ここで取得できる文字列は`accessToken`と呼ばれます。`accessToken`は一度限りしか取得できません。 + +## 4. iを生成 + +`i`は、Node.jsであれば以下のようなコードで生成でき、設定画面で取得するものとは違って64桁の16進数となります。 + +```javascript +const crypto = require("crypto") +const i = crypto.createHash("sha256") + .update(accessToken + appSecret, "utf8") + .digest("hex") +console.log(i) +``` + +## 5. 実際にテストする + +```javascript +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + i: "/* ここにiを入力 */", + text: "Hello Misskey API World with My Application!" + }), + headers: { + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` diff --git a/content/id/docs/4.for-developers/plugin/_dir.yml b/content/id/docs/4.for-developers/plugin/_dir.yml new file mode 100644 index 00000000..0be8be5d --- /dev/null +++ b/content/id/docs/4.for-developers/plugin/_dir.yml @@ -0,0 +1,2 @@ +title: "プラグイン・Playの作成" +description: "プラグインやPlayを作成する方法・各種リファレンスを公開中。" diff --git a/content/id/docs/5.releases.md b/content/id/docs/5.releases.md index 17c4324b..be31787c 100644 --- a/content/id/docs/5.releases.md +++ b/content/id/docs/5.releases.md @@ -2,58 +2,206 @@ maxTocDepth: 2 --- -# リリースノート +# Catatan Rilis -Misskeyのリリースノートを掲載しています。 +Berikut daftar catatan rilis untuk Misskey + +## 2024.3.1 + +リリース日: 2024/03/02 + +### Klien + +- Fix: 絵文字関係の不具合を修正 (#13485) + - 履歴に残っている or ピン留めされた絵文字がコントロールパネルより削除されていた際にリアクションデッキが表示できなくなる + - Unicode絵文字が履歴に残っている or ピン留めされているとリアクションデッキが表示できなくなる +- Fix: カスタム絵文字の画像読み込みに失敗した際はテキストではなくダミー画像を表示 #13487 + +## 2024.3.0 + +リリース日: 2024/03/01 + +### Umum + +- Enhance: 投稿者のロールに応じて、一つのノートに含むことのできるメンションとダイレクト投稿の宛先の人数に上限を設定できるように + - デフォルトのメンション上限は20アカウントに設定されます。（管理者はベースロールの設定で変更可能です。） + - 連合の問い合わせに応答しないサーバーのリモートユーザーへのメンションは、上限の人数に含めない実装になっています。 +- Enhance: 通知がミュート、凍結を考慮するようになりました +- Enhance: サーバーごとにモデレーションノートを残せるように +- Enhance: コンディショナルロールの条件に「マニュアルロールへのアサイン」を追加 +- Enhance: 通知の受信設定に「フォロー中またはフォロワー」を追加 +- Enhance: 通知の履歴をリセットできるように +- Fix: ダイレクトなノートに対してはダイレクトでしか返信できないように + +### Klien + +- Enhance: ノート作成画面のファイル添付メニューの区切り線の位置を調整 +- Fix: syuilo/misskeyの時代からあるインスタンスが改変されたバージョンであると誤認識される問題 +- Fix: MFMのオートコンプリートが出るべき状況で出ないことがある問題を修正 +- Fix: チャートのラベルが消えている問題を修正 +- Fix: 画面表示後最初の音声再生が爆音になることがある問題を修正 +- Fix: 設定のバックアップ作成時に名前を入力しなかった場合、ローカライゼーションがおかしくなる問題を修正 +- Fix: ページ`/admin/emojis`の絵文字編集ダイアログで「リアクションとして使えるロール」を追加する際に何も選択せずOKを押下すると画面が固まる問題を修正 +- Fix: 絵文字サジェストの順位で、絵文字自体の名前が同じものよりもタグで一致しているものが優先されてしまう問題を修正 +- Fix: ユーザの情報のポップアップが消えなくなることがある問題を修正 + +### Peladen + +- Enhance: エンドポイント`flash/update`の`flashId`以外のパラメータは必須ではなくなりました +- Fix: nodeinfoにenableMcaptchaとenableTurnstileが無いのを修正 +- Fix: 破損した通知をクライアントに送信しないように + - 通知欄が無限にリロードされる問題が改善する可能性があります +- Fix: 禁止キーワードを含むノートがDelayed Queueに追加されて再処理される問題を修正 +- Fix: 自分がフォローしていないアカウントのフォロワー限定ノートが閲覧できることがある問題を修正 +- Fix: タイムラインのオプションで「リノートを表示」を無効にしている際、投票のみの引用リノートが流れてこない問題を修正 +- Fix: エンドポイント`admin/emoji/update`の各種修正 + - 必須パラメータを`id`または`name`のいずれかのみに + - `id`の代わりに`name`で絵文字を指定可能に（`id`・`name`両指定時は従来通り`name`を変更する挙動） + - `category`および`licence`が指定なしの時勝手にnullに上書きされる挙動を修正 +- Fix: 通知の受信設定で「相互フォロー」が正しく動作しない問題を修正 + +## 2024.2.0 + +リリース日: 2024/02/17 + +### Penting + +- 外部サイトからプラグインをインストールする場合のパスが`/install-extentions`から`/install-extensions`に変わります。以前のパスからは自動でリダイレクトされるようになっていますが、新しいパスに変更することをお勧めします。 + +### Umum + +- Feat: [mCaptcha](https://github.com/mCaptcha/mCaptcha)のサポートを追加 +- Feat: Add support for TrueMail +- Feat: AGPLv3ライセンスに誤って違反するのを防止する機能を追加 + - 管理者がrepositoryUrlを変更したり、またはソースコードを直接頒布することを選択できるようになります + - 本体のソースコードに改変を加えた際に、ライセンスに基づく適切な案内を表示します +- Enhance: モデレーターはすべてのユーザーのリアクション一覧を見られるように +- Fix: リストライムラインの「リノートを表示」が正しく機能しない問題を修正 +- Fix: リモートユーザーのリアクション一覧がすべて見えてしまうのを修正 + - すべてのリモートユーザーのリアクション一覧を見えないようにします +- Fix: 特定のキーワード及び正規表現にマッチする文字列を含むノートが投稿された際、エラーに出来るような設定項目を追加 #13207 + - デフォルトは空欄なので適用前と同等の動作になります + +### Klien + +- Feat: 新しいゲームを追加 +- Feat: 音声・映像プレイヤーを追加 +- Feat: 絵文字の詳細ダイアログを追加 +- Feat: 枠線をつけるMFM`$[border.width=1,style=solid,color=fff,radius=0 ...]`を追加 + - デフォルトで枠線からはみ出る部分が隠されるようにしました。初期と同じ挙動にするには`$[border.noclip`が必要です +- Feat: スワイプでタブを切り替えられるように +- Enhance: MFM等のコードブロックに全文コピー用のボタンを追加 +- Enhance: ハッシュタグ入力時に、本文の末尾の行に何も書かれていない場合は新たにスペースを追加しないように +- Enhance: チャンネルノートのピン留めをノートのメニューからできるように +- Enhance: 管理者の場合はAPI tokenの発行画面で管理機能に関する権限を付与できるように +- Enhance: AiScriptを0.17.0に更新 [CHANGELOG](https://github.com/aiscript-dev/aiscript/blob/bb89d132b633a622d3cb0eff0d0cc7e476c0cfdd/CHANGELOG.md) + - 配列の範囲外・非整数のインデックスへの代入が完全禁止になるので注意 +- Enhance: 絵文字ピッカー・オートコンプリートで、完全一致した絵文字を優先的に表示するように +- Enhance: Playの説明欄にMFMを使えるように +- Enhance: チャンネルノートの場合は詳細ページからその前後のノートを見れるように +- Enhance: 季節に応じた画面の演出を南半球でも利用できるように +- Enhance: タイムラインフィルターの設定をすべて保持できるように + - 今までの「TLに他の人への返信を含める」設定は一旦リセットされます +- Enhance: タイムラインフィルターに「センシティブなファイルを含むノートを表示」を追加 +- Enhance: ノート作成画面のファイル添付メニューから直接ファイルを削除できるように +- Enhance: MFMの属性でオートコンプリートが使用できるように #12735 +- Enhance: 絵文字編集ダイアログをモーダルではなくウィンドウで表示するように +- Enhance: リモートのユーザーはメニューから直接リモートで表示できるように +- Enhance: リモートへの引用リノートと同一のリンクにはリンクプレビューを表示しないように +- Enhance: コードのシンタックスハイライトにテーマを適用できるように +- Enhance: リアクション権限がない場合、ハートにフォールバックするのではなくリアクションピッカーなどから打てないように + - リモートのユーザーにローカルのみのカスタム絵文字をリアクションしようとした場合 + - センシティブなリアクションを認めていないユーザーにセンシティブなカスタム絵文字をリアクションしようとした場合 + - ロールが必要な絵文字をリアクションしようとした場合 +- Enhance: ページ遷移時にPlayerを閉じるように +- Enhance: 通報ページのユーザをクリックした際にユーザをウィンドウで開くように +- Enhance: ノートの通報時にリモートのノートであっても自インスタンスにおけるノートのリンクを含むように +- Enhance: オフライン表示のデザインを改善・多言語対応 +- Fix: ネイティブモードの絵文字がモノクロにならないように +- Fix: v2023.12.0で追加された「モデレーターがユーザーのアイコンもしくはバナー画像を未設定状態にできる機能」が管理画面上で正しく表示されていない問題を修正 +- Fix: AiScriptの`readline`関数が不正な値を返すことがある問題のv2023.12.0時点での修正がPlay以外に適用されていないのを修正 +- Fix: v2023.12.1で追加された`$[clickable ...]`および`onClickEv`が正しく機能していないのを修正 +- Fix: Renoteのキーボードショートカットが機能していなかった問題を修正 +- Fix: 投稿フォームでアンケートの日時指定をした状態で再読み込みをすると期日が復元されない問題を修正 +- Fix: アンケートを設定したノートを「削除して編集」をするとアンケートの期日が引き継がれず、リセットされてしまう問題を修正 +- Fix: デッキのプロファイル作成時に名前を空にできる問題を修正 +- Fix: テーマ作成時に名称が空欄でも作成できてしまう問題を修正 +- Fix: プラグインで`Plugin:register_note_post_interruptor`を使用すると、ノートが投稿できなくなる問題を修正 +- Fix: iOSで大きな画像を変換してアップロードできない問題を修正 +- Fix: 「アニメーション画像を再生しない」もしくは「データセーバー（アイコン）」を有効にしていても、アイコンデコレーションのアニメーションが停止されない問題を修正 +- Fix: 画像をクロップするとクロップ後の解像度が異様に低くなる問題の修正 +- Fix: 画像をクロップ時、正常に完了できない問題の修正 +- Fix: キャプションが空の画像をクロップするとキャプションにnullという文字列が入ってしまう問題の修正 +- Fix: プロフィールを編集してもリロードするまで反映されない問題を修正 +- Fix: エラー画像URLを設定した後解除すると，デフォルトの画像が表示されない問題の修正 +- Fix: MkCodeEditorで行がずれていってしまう問題の修正 +- Fix: Summaly proxy利用時にプレイヤーが動作しないことがあるのを修正 #13196 + +### Peladen + +- Enhance: 連合先のレートリミットを超過した際にリトライするようになりました +- Enhance: ActivityPub Deliver queueでBodyを事前処理するように (#12916) +- Enhance: クリップをエクスポートできるように +- Enhance: `/files`のファイルに対してHTTP Rangeリクエストを行えるように +- Enhance: `api.json`のOpenAPI Specificationを3.1.0に更新 +- Enhance: 連合向けのノート配信を軽量化 #13192 +- Fix: `drive/files/update`でファイル名のバリデーションが機能していない問題を修正 +- Fix: `notes/create`で、`text`が空白文字のみで構成されているか`null`であって、かつ`text`だけであるリクエストに対するレスポンスが400になるように変更 +- Fix: `notes/create`で、`text`が空白文字のみで構成されていてかつリノート、ファイルまたは投票を含んでいるリクエストに対するレスポンスの`text`が`""`から`null`になるように変更 +- Fix: ipv4とipv6の両方が利用可能な環境でallowedPrivateNetworksが設定されていた場合プライベートipの検証ができていなかった問題を修正 +- Fix: properly handle cc followers +- Fix: ジョブに関する設定の名前を修正 relashionshipJobPerSec -> relationshipJobPerSec +- Fix: コントロールパネル->モデレーション->「誰でも新規登録できるようにする」の初期値をONからOFFに変更 #13122 +- Fix: リモートユーザーが復活してもキャッシュにより該当ユーザーのActivityが受け入れられないのを修正 #13273 ## 2023.12.2 -リリース日: 2023/12/28 +Tanggal Rilis: 28 Desember 2023 -### General +### Umum -- v2023.12.1でDockerを利用してサーバーを起動できない問題を修正 +- Perbaikan pada versi 2023.12.1 dimana tidak dapat memulai peladen dengan menggunakan Docker -### Client +### Klien -- Enhance: 検索画面においてEnterキー押下で検索できるように +- Peningkatan: Dapat melakukan pencarian dengan menekan tombol Enter pada laman pencarian ## 2023.12.1 -リリース日: 2023/12/27 +Tanggal Rilis: 27 Desember 2023 -### Note +### Catatan -- アクセストークンの権限が再整理されたため、一部のAPIが古いAPIトークンでは動作しなくなりました。\ - 権限不足になる場合には権限を再設定して再生成してください。 +- Ijin akses token telah ditata ulang, maka beberapa API tidak dapat bekerja dengan token API lama.\ + Apabila otorisasi telah hilang/tidak memungkinkan, tetapkan kembali dan lakukan regenerasi pada otorisasi tersebut. -### General +### Umum - Enhance: ローカリゼーションの更新 -- Fix: 自分のdirect noteがuser list timelineに追加されない +- Perbaikan: Catatan langsung (DM) milik sendiri tidak ditambahkan pada lini masa daftar pengguna -### Client +### Klien -- Feat: AiScript専用のMFM構文`$[clickable.ev=EVENTNAME ...]`を追加。`Mk:C:mfm`のオプション`onClickEv`に関数を渡すと、クリック時に`EVENTNAME`を引数にして呼び出す -- Enhance: MFM入力補助ボタンを投稿フォームに表示できるように #12787 -- Fix: 一部のモデログ(logYellowでの表示対象)について、表示の色が変わらない問題を修正 -- Fix: `fg`/`bg`MFMに長い単語を指定すると、オーバーフローされずはみ出る問題を修正 +- Fitur: Penambahan sintaks MFM untuk AiScript `$[clickable.ev=EVENTNAME ...]`.Meneruskan opsi `onClickEv` ke fungsi `Mk:C:mfm` dengan memanggil `EVENTNAME` sebagai argumen ketika diklik +- Peningkatan: Tombol asisten masukan MFM dapat ditampilkan pada form submisi #12787 +- Perbaikan: Masalah warna pada beberapa log moderasi (ditampilkan dengan logYellow) tidak berubah +- Perbaikan: Masalah dengan kata panjang pada `fg`/`bg` MFM yang menyebabkan tidak dapat overflow -### Server +### Peladen -- Enhance: センシティブワードの設定がハッシュタグトレンドにも適用されるようになりました -- Enhance: `oauth/token`エンドポイントのCORS対応 -- Fix: 1702718871541-ffVisibility.jsのdownが壊れている -- Fix:「非センシティブのみ（リモートはいいねのみ）」を設定していても、センシティブに設定されたカスタム絵文字をリアクションできる問題を修正 -- Fix: ロールアサイン時の通知で，ロールアイコンが縮小されずに表示される問題を修正 -- Fix: サードパーティアプリケーションがWebsocket APIに無条件にアクセスできる問題を修正 -- Fix: サードパーティアプリケーションがユーザーの許可なしに非公開の情報を見ることができる問題を修正 +- Peningkatan: Pengaturan kata sensitif sekarang juga berlaku pada trend tagar +- Peningkatan: dukungan CORS pada titik akhir `oauth/token` +- Perbaikan: Kerusakan pada down di 1702718871541-ffVisibility.js +- Perbaikan: Masalah dimana emoji kustom diatur ke sensitif dapat direaksi meskipun "hanya non-sensitif (Hanya suka dari instansi luar)" telah diatur +- Perbaikan: Masalah dimana ikon peran ditampilkan tanpa dikecilkan pada notifikasi ketika peran telah ditetapkan +- Perbaikan: Masalah dimana aplikasi pihak ketiga dapat mengakses API Websocket tanpa syarat apapun +- Perbaikan: Masalah dimana aplikasi pihak ketiga diperbolehkan untuk melihat informasi non-publik tanpa izin dari pengguna ## 2023.12.0 -リリース日: 2023/12/23 +Tanggal Rilis: 23 Desember 2023 -### Note +### Catatan - 依存関係の更新に伴い、Node.js 20.10.0が最小要件になりました - 絵文字の追加辞書を既にインストールしている場合は、お手数ですが再インストールのほどお願いします @@ -67,7 +215,7 @@ Misskeyのリリースノートを掲載しています。 2. 「ピン留 (全般)」のタブを選択します。 3. 「リアクション設定から上書きする」ボタンを押すことで、アップデート前の状態に戻すことができます。 -### General +### Umum - Feat: メールアドレスの認証にverifymail.ioを使えるように (cherry-pick from https\://github.com/TeamNijimiss/misskey/commit/971ba07a44550f68d2ba31c62066db2d43a0caed) - Feat: モデレーターがユーザーのアイコンもしくはバナー画像を未設定状態にできる機能を追加 (cherry-pick from https\://github.com/TeamNijimiss/misskey/commit/e0eb5a752f6e5616d6312bb7c9790302f9dbff83) @@ -77,11 +225,11 @@ Misskeyのリリースノートを掲載しています。 - Enhance: アイコンデコレーションを複数設定できるように - Enhance: アイコンデコレーションの位置を微調整できるように - Enhance: つながりの公開範囲をフォロー/フォロワーで個別に設定可能に #12072 -- Enhance: ローカリゼーションの更新 +- Peningkatan: Pembaharuan lokalisasi - Enhance: 依存関係の更新 - Fix: MFM `$[unixtime ]` に不正な値を入力した際に発生する各種エラーを修正 -### Client +### Klien - Feat: 今日誕生日のフォロー中のユーザーを一覧表示できるウィジェットを追加 - Feat: 画面に雪を降らせられるように @@ -137,7 +285,7 @@ Misskeyのリリースノートを掲載しています。 - Fix: ページ一覧ページの表示がモバイル環境において崩れているのを修正 - Fix: MFMでルビの中のテキストがnyaizeされない問題を修正 -### Server +### Peladen - Enhance: MFM `$[ruby ]` が他ソフトウェアと連合されるように - Enhance: Meilisearchを有効にした検索で、ユーザーのミュートやブロックを考慮するように @@ -162,19 +310,19 @@ Misskeyのリリースノートを掲載しています。 ## 2023.11.1 -リリース日: 2023/11/17 +Tanggal Rilis: 17 Desember 2023 -### Note +### Catatan - 悪意のある第三者がリモートユーザーになりすました任意のアクティビティを受け取れてしまう問題を修正しました。詳しくは[GitHub security advisory](https://github.com/misskey-dev/misskey/security/advisories/GHSA-3f39-6537-3cgc)をご覧ください。 -### General +### Umum - Feat: 管理者がコントロールパネルからメールアドレスの照会を行えるようになりました - Enhance: ローカリゼーションの更新 - Enhance: 依存関係の更新 -### Client +### Klien - Enhance: MFMでルビを振れるように - 例: `$[ruby 三須木 みすき]` @@ -191,7 +339,7 @@ Misskeyのリリースノートを掲載しています。 - Fix: 絵文字ピッカーでの検索が更新されない問題を修正 - Fix: 特定の条件下でノートがnyaizeされない問題を修正 -### Server +### Peladen - Enhance: FTTのデータベースへのフォールバック処理を行うかどうかを設定可能に - Fix: トークンのないプラグインをアンインストールするときにエラーが出ないように @@ -204,13 +352,13 @@ Misskeyのリリースノートを掲載しています。 ## 2023.11.0 -リリース日: 2023/11/05 +Tanggal Rilis: 05 Desember 2023 -### Note +### Penting - iOS 16.4未満を使用している場合はiOS 16.4以上にアップデートをお願いします -### General +### Umum - Feat: アイコンデコレーション機能 - サーバーで用意された画像をアイコンに重ねることができます @@ -228,7 +376,7 @@ Misskeyのリリースノートを掲載しています。 - Enhance: 依存関係の更新 - Change: CWを使用する場合、注釈を空にすることは許可されなくなりました -### Client +### Klien - Feat: プラグイン・テーマを外部サイトから直接インストールできるようになりました - 外部サイトでの実装が必要です。詳細は Misskey Hub をご覧ください @@ -262,7 +410,7 @@ Misskeyのリリースノートを掲載しています。 - Fix: アーカイブしたお知らせがコントロールパネルに表示される問題を修正 - Note: アップデート後、サウンドに関する設定が初期化されます -### Server +### Peladen - Feat: Registry APIがサードパーティから利用可能になりました - Enhance: RedisへのTLのキャッシュ(FTT)をオフにできるように @@ -286,9 +434,9 @@ Misskeyのリリースノートを掲載しています。 ## 2023.10.2 -リリース日: 2023/10/21 +Tanggal Rilis: 21 Oktober 2023 -### General +### Umum - Feat: アンテナでローカルの投稿のみ収集できるようになりました - Feat: サーバーサイレンス機能が追加されました @@ -298,12 +446,12 @@ Misskeyのリリースノートを掲載しています。 - Enhance: ローカリゼーションの更新 - Enhance: 依存関係の更新 -### Client +### Klien - Enhance: TLの返信表示オプションを記憶するように - Enhance: 投稿されてから時間が経過しているノートであることを視覚的に分かりやすく -### Server +### Peladen - Enhance: タイムライン取得時のパフォーマンスを向上 - Enhance: ストリーミングAPIのパフォーマンスを向上 @@ -315,36 +463,36 @@ Misskeyのリリースノートを掲載しています。 ## 2023.10.1 -リリース日: 2023/10/12 +Tanggal Rilis: 12 Oktober 2023 -### General +### Umum - Enhance: ローカルタイムライン、ソーシャルタイムラインで返信を含むかどうか設定可能に -### Client +### Klien - Fix: 絵文字ピッカーで横に長いカスタム絵文字が見切れる問題を修正 -### Server +### Peladen - Fix: フォローしているユーザーからの自分の投稿への返信がタイムラインに含まれない問題を修正 - Fix: users/notesでセンシティブチャンネルの投稿が含まれる場合がある問題を修正 ## 2023.10.0 -リリース日: 2023/10/10 +Tanggal Rilis: 10 Oktober 2023 -### NOTE +### PENTING - 2023.9.2で導入されたノート編集機能はクオリティの高い実装が困難であることが判明したため撤回されました - アップデートを行うと、タイムラインが一時的にリセットされます -### Changes +### Perubahan - API: users/notes, notes/local-timeline で fileType 指定はできなくなりました - API: notes/featured でページネーションは他APIと同様 untilId を使って行うようになりました -### General +### Umum - Feat: ユーザーごとに他ユーザーへの返信をタイムラインに含めるか設定可能になりました - Feat: ユーザーリスト内のメンバーごとに他ユーザーへの返信をユーザーリストタイムラインに含めるか設定可能になりました @@ -361,7 +509,7 @@ Misskeyのリリースノートを掲載しています。 - Fix: ダイレクト投稿をリノートできてしまう問題を修正 - Fix: ユーザーリストTLにチャンネル投稿が含まれる問題を修正 -### Client +### Klien - Feat: 「ファイルの詳細」ページを追加 - ドライブのファイルの拡大プレビューができるように @@ -370,7 +518,7 @@ Misskeyのリリースノートを掲載しています。 - Enhance: 動画再生時のデフォルトボリュームを30%に - Fix: リアクションしたユーザ一覧のUIが稀に左上に残ってしまう不具合を修正 -### Server +### Peladen - Enhance: drive/files/attached-notes がページネーションに対応しました - Enhance: タイムライン取得時のパフォーマンスを大幅に向上 @@ -387,13 +535,13 @@ Misskeyのリリースノートを掲載しています。 ## 2023.9.3 -リリース日: 2023/09/30 +Tanggal Rilis: 30 September 2023 -### General +### Umum - Enhance: ノートの翻訳機能の利用可否をロールで設定可能に -### Client +### Klien - Enhance: AiScriptでホストのアドレスを参照する定数`SERVER_URL`を追加 - Enhance: モデレーションログ機能の強化 @@ -406,9 +554,9 @@ Misskeyのリリースノートを掲載しています。 ## 2023.9.2 -リリース日: 2023/09/29 +Tanggal Rilis: 29 September 2023 -### General +### Umum - Feat: ノートの編集をできるように - ロールで編集可否を設定可能 @@ -426,37 +574,37 @@ Misskeyのリリースノートを掲載しています。 - Enhance: admin/ad/listにて掲載中の広告が絞り込めるように - Enhance: AiScriptにリモートサーバーのAPIを叩く用の関数を追加（`Mk:apiExternal`） -### Server +### Peladen - Enhance: MasterプロセスのPIDを書き出せるように - Enhance: admin/ad/createにてレスポンス200、設定した広告情報を返すように ## 2023.9.1 -リリース日: 2023/09/25 +Tanggal Rilis: 25 September 2023 -### General +### Umum - Enhance: モデレーションログ機能の強化 -### Client +### Klien - Fix: ノートのメニューにある「詳細」ボタンの表示がログイン/ログアウト状態で統一されていない問題を修正 -### Server +### Peladen - Fix: お知らせのページネーションが機能しない - Fix: 「ユーザーの新規投稿」の通知設定を切り替えるとサーバー内部エラーが出る ## 2023.9.0 -リリース日: 2023/09/24 +Tanggal Rilis: 24 September 2023 -### Note +### Penting - meilisearchを使用する場合、v1.2以上が必要です -### General +### Umum - Feat: OAuth 2.0のサポート - Feat: お知らせ機能の強化 @@ -482,7 +630,7 @@ Misskeyのリリースノートを掲載しています。 - Enhance: 依存関係の更新 - Enhance: ローカリゼーションの更新 -### Client +### Klien - Feat: 任意のユーザーリストをタイムラインページにピン留めできるように - 設定->クライアント設定->全般 から設定可能です @@ -529,7 +677,7 @@ Misskeyのリリースノートを掲載しています。 - Fix: ドロワーメニューで、親メニュー項目をマウスでホバーすると子メニューが表示されてしまう問題を修正 - Fix: AiScriptでMk:apiが外部と通信できる問題を修正 -### Server +### Peladen - Change: cacheRemoteFilesの初期値はfalseになりました - Enhance: ファイルアップロード時等にファイル名の拡張子を修正する関数(correctFilename)の挙動を改善 @@ -552,9 +700,9 @@ Misskeyのリリースノートを掲載しています。 ## 13.14.2 -リリース日: 2023/07/27 +Tanggal Rilis: 27 Juli 2023 -### Client +### Klien - リストTLで、ユーザーが追加・削除されてもTLを初期化しないように - URL取得変数を関数に変更 CURRENT_URL -> Mk:url() @@ -563,16 +711,16 @@ Misskeyのリリースノートを掲載しています。 - Fix: Selecting all emojis in Custom emoji is impossible - Fix: PhotoSwipeによるメモリリークの修正 -### Server +### Peladen - Fix: APIのオフセットが壊れていたせいで「もっと見る」でもっと見れない問題を修正 - Fix: 外部サーバーの投稿がタイムラインに表示されないことがある問題を修正 ## 13.14.1 -リリース日: 2023/07/21 +Tanggal Rilis: 21 Juli 2023 -### General +### Umum - 招待機能を改善しました - 過去に発行した招待コードを確認できるようになりました @@ -582,7 +730,7 @@ Misskeyのリリースノートを掲載しています。 - identicon生成を無効にしてパフォーマンスを向上させることができるようになりました - サーバーのマシン情報の公開を無効にしてパフォーマンスを向上させることができるようになりました -### Client +### Klien - deck UIのカラムのメニューからアンテナとリストの編集画面を開けるように - ドライブファイルのメニューで画像をクロップできるように @@ -617,7 +765,7 @@ Misskeyのリリースノートを掲載しています。 - Fix: アンケート終了時のプッシュ通知が正しく表示されない問題を修正 - Fix: MasterVolumeが0の時だけでなく各通知音の音量設定が0のときも、HTMLAudioElement.playが実行されないように変更 -### Server +### Peladen - JSON.parse の回数を削減することで、ストリーミングのパフォーマンスを向上しました - nsfwjs のモデルロードを排他することで、重複ロードによってメモリ使用量が増加しないように @@ -639,39 +787,39 @@ Misskeyのリリースノートを掲載しています。 ## 13.13.2 -リリース日: 2023/06/13 +Tanggal Rilis: 13 Juni 2023 -### General +### Umum - エラー時や項目が存在しないときなどのアイコン画像をサーバー管理者が設定できるように - ロールが付与されているユーザーリストを非公開にできるように - サーバーの負荷が非常に高いため、ユーザー統計表示機能を削除しました -### Client +### Klien - Fix: タブがバックグラウンドでもstreamが切断されないように -### Server +### Peladen - Fix: キャッシュが溜まり続けないように ## 13.13.1 -リリース日: 2023/06/06 +Tanggal Rilis: 06 Juni 2023 -### Client +### Klien - Fix: タブがアクティブな間はstreamが切断されないように -### Server +### Peladen - Fix: api/metaで`TypeError: JSON5.parse is not a function`エラーが発生する問題を修正 ## 13.13.0 -リリース日: 2023/06/05 +Tanggal Rilis: 05 Juni 2023 -### General +### Umum - カスタム絵文字ごとにそれをリアクションとして使えるロールを設定できるように - カスタム絵文字ごとに連合するかどうか設定できるように @@ -681,7 +829,7 @@ Misskeyのリリースノートを掲載しています。 - 今後はAPI呼び出し時およびストリーミング接続時に設定するようになります - リストを公開できるようになりました -### Client +### Klien - リアクションの取り消し/変更時に確認ダイアログを出すように - 開発者モードを追加 @@ -701,7 +849,7 @@ Misskeyのリリースノートを掲載しています。 - Fix: フォローボタンがテーマのカラースキームによって視認性が悪くなる問題を修正 - 新しいプロパティ `fgOnWhite` が追加されました -### Server +### Peladen - bullをbull-mqにアップグレードし、ジョブキューのパフォーマンスを改善 - ストリーミングのパフォーマンスを改善 @@ -712,18 +860,18 @@ Misskeyのリリースノートを掲載しています。 ## 13.12.2 -リリース日: 2023/05/12 +Tanggal Rilis: 12 Mei 2023 -## NOTE +## PENTING Meilisearchの設定に`index`が必要になりました。値はMisskeyサーバーのホスト名にすることをお勧めします(アルファベット、ハイフン、アンダーバーのみ使用可能)。例: `misskey-io` 過去に作成された`notes`インデックスは、`
リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 | -| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](./permission.md)で確認できます。 | - -:::tip{label='例'} - -``` -https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive -``` - -::: - -#### Step 3 - -ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 - -``` -https://{host}/api/miauth/{session}/check -``` - -ここで、 - -- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。 -- `{session}`の部分は、セッションIDに置き換えます。 - -レスポンスに含まれるプロパティは以下の通りです: - -| 名前 | 説明 | -| ------- | -------------- | -| `token` | ユーザーのアクセストークン。 | -| `user` | ユーザーの情報。 | - -## APIの利用 - -アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。 - -:::tip - -- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。 -- 要求ヘッダーに`Content-Type: application/json`を指定します。 -- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。 -- ベースURLは`https://{サーバーのドメイン}/api`です。 - -::: - -アクセストークン付きのボディの例（metaの場合）: - -```json -{ - "i": "HogEFugA1341", - "detail": false -} -``` - - - -APIの詳細は、APIリファレンスを参照してください。 - -:::warning - -MisskeyはRESTを採用していません。 - -::: - -また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 diff --git a/content/it/docs/4.for-developers/api/token/3.oauth.md b/content/it/docs/4.for-developers/api/token/3.oauth.md index a29644ab..c93f3af6 100644 --- a/content/it/docs/4.for-developers/api/token/3.oauth.md +++ b/content/it/docs/4.for-developers/api/token/3.oauth.md @@ -14,7 +14,7 @@ OAuth方式は使えるライブラリが多いので、出来ればライブラ 現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。 -- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md) +- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./miauth.md) - [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md) ::: diff --git a/content/it/docs/4.for-developers/api/token/50.app.md b/content/it/docs/4.for-developers/api/token/50.app.md new file mode 100644 index 00000000..edc0ee11 --- /dev/null +++ b/content/it/docs/4.for-developers/api/token/50.app.md @@ -0,0 +1,78 @@ +--- +description: MiAuth導入以前（v12.27.0未満）でのアクセストークン取得方法について説明しています。 +--- + +# アプリ作成方式でのアクセストークン取得方法（旧来型） + +[MiAuth](./miauth.md)導入（12.27.0）や[OAuth](./oauth.md)導入（2023.9.0）より前の、旧来のアクセストークン取得方法について説明します。\ +12.27.0未満のバージョンのサーバーではこの旧来の方式を使用する必要があります。 + +## 1. アプリケーションの作成 + +[`app/create`エンドポイント](endpoints/app/create.html)に情報を送信し、`appSecret`を取得します。 + +```json +{ + // アプリの名前 + "name": "test", + // アプリの説明 + "description": "my test application", + // アプリのパーミッション + "permission": ["write:notes"] +} +``` + +この時、`callbackUrl`でお好きなURLを含めると、次のアクセス許可操作が終了したときに`token`をクエリ文字列に含めながらそこにコールバックするようになります。 + +## 2. ユーザーに認証させる + +[`auth/session/generate`エンドポイント](endpoints/auth/session/generate)に`appSecret`をPOSTします。 + +```json +{ + "appSecret": "fAb12cD34Ef56gH78Ij16kL32Mn64oPf" +} +``` + +`token`（ここでは仮に`798b9f6e-248d-43a7-a919-fabc664027f1`）と`url`を返してくるので、まずはこのurlにウェブブラウザでアクセスし「アクセスを許可」を選択。 + +## 3. accessTokenを問い合わせる + +2が終わったことが確認できたら、[`auth/session/userkey`エンドポイント](endpoints/auth/session/userkey)に`appSecret`と先ほどの`token`をPOSTします。 + +```json +{ + "appSecret": "fAb12cD34Ef56gH78Ij16kL32Mn64oPf", + "token": "798b9f6e-248d-43a7-a919-fabc664027f1" +} +``` + +ここで取得できる文字列は`accessToken`と呼ばれます。`accessToken`は一度限りしか取得できません。 + +## 4. iを生成 + +`i`は、Node.jsであれば以下のようなコードで生成でき、設定画面で取得するものとは違って64桁の16進数となります。 + +```javascript +const crypto = require("crypto") +const i = crypto.createHash("sha256") + .update(accessToken + appSecret, "utf8") + .digest("hex") +console.log(i) +``` + +## 5. 実際にテストする + +```javascript +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + i: "/* ここにiを入力 */", + text: "Hello Misskey API World with My Application!" + }), + headers: { + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` diff --git a/content/it/docs/4.for-developers/plugin/_dir.yml b/content/it/docs/4.for-developers/plugin/_dir.yml new file mode 100644 index 00000000..0be8be5d --- /dev/null +++ b/content/it/docs/4.for-developers/plugin/_dir.yml @@ -0,0 +1,2 @@ +title: "プラグイン・Playの作成" +description: "プラグインやPlayを作成する方法・各種リファレンスを公開中。" diff --git a/content/it/docs/5.releases.md b/content/it/docs/5.releases.md index 17c4324b..59f4524d 100644 --- a/content/it/docs/5.releases.md +++ b/content/it/docs/5.releases.md @@ -6,6 +6,154 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2024.3.1 + +リリース日: 2024/03/02 + +### Client + +- Fix: 絵文字関係の不具合を修正 (#13485) + - 履歴に残っている or ピン留めされた絵文字がコントロールパネルより削除されていた際にリアクションデッキが表示できなくなる + - Unicode絵文字が履歴に残っている or ピン留めされているとリアクションデッキが表示できなくなる +- Fix: カスタム絵文字の画像読み込みに失敗した際はテキストではなくダミー画像を表示 #13487 + +## 2024.3.0 + +リリース日: 2024/03/01 + +### General + +- Enhance: 投稿者のロールに応じて、一つのノートに含むことのできるメンションとダイレクト投稿の宛先の人数に上限を設定できるように + - デフォルトのメンション上限は20アカウントに設定されます。（管理者はベースロールの設定で変更可能です。） + - 連合の問い合わせに応答しないサーバーのリモートユーザーへのメンションは、上限の人数に含めない実装になっています。 +- Enhance: 通知がミュート、凍結を考慮するようになりました +- Enhance: サーバーごとにモデレーションノートを残せるように +- Enhance: コンディショナルロールの条件に「マニュアルロールへのアサイン」を追加 +- Enhance: 通知の受信設定に「フォロー中またはフォロワー」を追加 +- Enhance: 通知の履歴をリセットできるように +- Fix: ダイレクトなノートに対してはダイレクトでしか返信できないように + +### Client + +- Enhance: ノート作成画面のファイル添付メニューの区切り線の位置を調整 +- Fix: syuilo/misskeyの時代からあるインスタンスが改変されたバージョンであると誤認識される問題 +- Fix: MFMのオートコンプリートが出るべき状況で出ないことがある問題を修正 +- Fix: チャートのラベルが消えている問題を修正 +- Fix: 画面表示後最初の音声再生が爆音になることがある問題を修正 +- Fix: 設定のバックアップ作成時に名前を入力しなかった場合、ローカライゼーションがおかしくなる問題を修正 +- Fix: ページ`/admin/emojis`の絵文字編集ダイアログで「リアクションとして使えるロール」を追加する際に何も選択せずOKを押下すると画面が固まる問題を修正 +- Fix: 絵文字サジェストの順位で、絵文字自体の名前が同じものよりもタグで一致しているものが優先されてしまう問題を修正 +- Fix: ユーザの情報のポップアップが消えなくなることがある問題を修正 + +### Server + +- Enhance: エンドポイント`flash/update`の`flashId`以外のパラメータは必須ではなくなりました +- Fix: nodeinfoにenableMcaptchaとenableTurnstileが無いのを修正 +- Fix: 破損した通知をクライアントに送信しないように + - 通知欄が無限にリロードされる問題が改善する可能性があります +- Fix: 禁止キーワードを含むノートがDelayed Queueに追加されて再処理される問題を修正 +- Fix: 自分がフォローしていないアカウントのフォロワー限定ノートが閲覧できることがある問題を修正 +- Fix: タイムラインのオプションで「リノートを表示」を無効にしている際、投票のみの引用リノートが流れてこない問題を修正 +- Fix: エンドポイント`admin/emoji/update`の各種修正 + - 必須パラメータを`id`または`name`のいずれかのみに + - `id`の代わりに`name`で絵文字を指定可能に（`id`・`name`両指定時は従来通り`name`を変更する挙動） + - `category`および`licence`が指定なしの時勝手にnullに上書きされる挙動を修正 +- Fix: 通知の受信設定で「相互フォロー」が正しく動作しない問題を修正 + +## 2024.2.0 + +リリース日: 2024/02/17 + +### Note + +- 外部サイトからプラグインをインストールする場合のパスが`/install-extentions`から`/install-extensions`に変わります。以前のパスからは自動でリダイレクトされるようになっていますが、新しいパスに変更することをお勧めします。 + +### General + +- Feat: [mCaptcha](https://github.com/mCaptcha/mCaptcha)のサポートを追加 +- Feat: Add support for TrueMail +- Feat: AGPLv3ライセンスに誤って違反するのを防止する機能を追加 + - 管理者がrepositoryUrlを変更したり、またはソースコードを直接頒布することを選択できるようになります + - 本体のソースコードに改変を加えた際に、ライセンスに基づく適切な案内を表示します +- Enhance: モデレーターはすべてのユーザーのリアクション一覧を見られるように +- Fix: リストライムラインの「リノートを表示」が正しく機能しない問題を修正 +- Fix: リモートユーザーのリアクション一覧がすべて見えてしまうのを修正 + - すべてのリモートユーザーのリアクション一覧を見えないようにします +- Fix: 特定のキーワード及び正規表現にマッチする文字列を含むノートが投稿された際、エラーに出来るような設定項目を追加 #13207 + - デフォルトは空欄なので適用前と同等の動作になります + +### Client + +- Feat: 新しいゲームを追加 +- Feat: 音声・映像プレイヤーを追加 +- Feat: 絵文字の詳細ダイアログを追加 +- Feat: 枠線をつけるMFM`$[border.width=1,style=solid,color=fff,radius=0 ...]`を追加 + - デフォルトで枠線からはみ出る部分が隠されるようにしました。初期と同じ挙動にするには`$[border.noclip`が必要です +- Feat: スワイプでタブを切り替えられるように +- Enhance: MFM等のコードブロックに全文コピー用のボタンを追加 +- Enhance: ハッシュタグ入力時に、本文の末尾の行に何も書かれていない場合は新たにスペースを追加しないように +- Enhance: チャンネルノートのピン留めをノートのメニューからできるように +- Enhance: 管理者の場合はAPI tokenの発行画面で管理機能に関する権限を付与できるように +- Enhance: AiScriptを0.17.0に更新 [CHANGELOG](https://github.com/aiscript-dev/aiscript/blob/bb89d132b633a622d3cb0eff0d0cc7e476c0cfdd/CHANGELOG.md) + - 配列の範囲外・非整数のインデックスへの代入が完全禁止になるので注意 +- Enhance: 絵文字ピッカー・オートコンプリートで、完全一致した絵文字を優先的に表示するように +- Enhance: Playの説明欄にMFMを使えるように +- Enhance: チャンネルノートの場合は詳細ページからその前後のノートを見れるように +- Enhance: 季節に応じた画面の演出を南半球でも利用できるように +- Enhance: タイムラインフィルターの設定をすべて保持できるように + - 今までの「TLに他の人への返信を含める」設定は一旦リセットされます +- Enhance: タイムラインフィルターに「センシティブなファイルを含むノートを表示」を追加 +- Enhance: ノート作成画面のファイル添付メニューから直接ファイルを削除できるように +- Enhance: MFMの属性でオートコンプリートが使用できるように #12735 +- Enhance: 絵文字編集ダイアログをモーダルではなくウィンドウで表示するように +- Enhance: リモートのユーザーはメニューから直接リモートで表示できるように +- Enhance: リモートへの引用リノートと同一のリンクにはリンクプレビューを表示しないように +- Enhance: コードのシンタックスハイライトにテーマを適用できるように +- Enhance: リアクション権限がない場合、ハートにフォールバックするのではなくリアクションピッカーなどから打てないように + - リモートのユーザーにローカルのみのカスタム絵文字をリアクションしようとした場合 + - センシティブなリアクションを認めていないユーザーにセンシティブなカスタム絵文字をリアクションしようとした場合 + - ロールが必要な絵文字をリアクションしようとした場合 +- Enhance: ページ遷移時にPlayerを閉じるように +- Enhance: 通報ページのユーザをクリックした際にユーザをウィンドウで開くように +- Enhance: ノートの通報時にリモートのノートであっても自インスタンスにおけるノートのリンクを含むように +- Enhance: オフライン表示のデザインを改善・多言語対応 +- Fix: ネイティブモードの絵文字がモノクロにならないように +- Fix: v2023.12.0で追加された「モデレーターがユーザーのアイコンもしくはバナー画像を未設定状態にできる機能」が管理画面上で正しく表示されていない問題を修正 +- Fix: AiScriptの`readline`関数が不正な値を返すことがある問題のv2023.12.0時点での修正がPlay以外に適用されていないのを修正 +- Fix: v2023.12.1で追加された`$[clickable ...]`および`onClickEv`が正しく機能していないのを修正 +- Fix: Renoteのキーボードショートカットが機能していなかった問題を修正 +- Fix: 投稿フォームでアンケートの日時指定をした状態で再読み込みをすると期日が復元されない問題を修正 +- Fix: アンケートを設定したノートを「削除して編集」をするとアンケートの期日が引き継がれず、リセットされてしまう問題を修正 +- Fix: デッキのプロファイル作成時に名前を空にできる問題を修正 +- Fix: テーマ作成時に名称が空欄でも作成できてしまう問題を修正 +- Fix: プラグインで`Plugin:register_note_post_interruptor`を使用すると、ノートが投稿できなくなる問題を修正 +- Fix: iOSで大きな画像を変換してアップロードできない問題を修正 +- Fix: 「アニメーション画像を再生しない」もしくは「データセーバー（アイコン）」を有効にしていても、アイコンデコレーションのアニメーションが停止されない問題を修正 +- Fix: 画像をクロップするとクロップ後の解像度が異様に低くなる問題の修正 +- Fix: 画像をクロップ時、正常に完了できない問題の修正 +- Fix: キャプションが空の画像をクロップするとキャプションにnullという文字列が入ってしまう問題の修正 +- Fix: プロフィールを編集してもリロードするまで反映されない問題を修正 +- Fix: エラー画像URLを設定した後解除すると，デフォルトの画像が表示されない問題の修正 +- Fix: MkCodeEditorで行がずれていってしまう問題の修正 +- Fix: Summaly proxy利用時にプレイヤーが動作しないことがあるのを修正 #13196 + +### Server + +- Enhance: 連合先のレートリミットを超過した際にリトライするようになりました +- Enhance: ActivityPub Deliver queueでBodyを事前処理するように (#12916) +- Enhance: クリップをエクスポートできるように +- Enhance: `/files`のファイルに対してHTTP Rangeリクエストを行えるように +- Enhance: `api.json`のOpenAPI Specificationを3.1.0に更新 +- Enhance: 連合向けのノート配信を軽量化 #13192 +- Fix: `drive/files/update`でファイル名のバリデーションが機能していない問題を修正 +- Fix: `notes/create`で、`text`が空白文字のみで構成されているか`null`であって、かつ`text`だけであるリクエストに対するレスポンスが400になるように変更 +- Fix: `notes/create`で、`text`が空白文字のみで構成されていてかつリノート、ファイルまたは投票を含んでいるリクエストに対するレスポンスの`text`が`""`から`null`になるように変更 +- Fix: ipv4とipv6の両方が利用可能な環境でallowedPrivateNetworksが設定されていた場合プライベートipの検証ができていなかった問題を修正 +- Fix: properly handle cc followers +- Fix: ジョブに関する設定の名前を修正 relashionshipJobPerSec -> relationshipJobPerSec +- Fix: コントロールパネル->モデレーション->「誰でも新規登録できるようにする」の初期値をONからOFFに変更 #13122 +- Fix: リモートユーザーが復活してもキャッシュにより該当ユーザーのActivityが受け入れられないのを修正 #13273 + ## 2023.12.2 リリース日: 2023/12/28 @@ -1999,8 +2147,7 @@ same as 12.112.0 ### NOTE -:::warning - +::: warning このバージョンからNode v16.14.0以降が必要です ::: @@ -2113,14 +2260,12 @@ same as 12.112.0 ### Note -:::warning - +::: warning ビルドする前に`npm run clean`を実行してください。 ::: -:::warning - +::: warning このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 diff --git a/content/it/docs/2.for-users/4.resources/donate.md b/content/it/docs/6.donate.md similarity index 81% rename from content/it/docs/2.for-users/4.resources/donate.md rename to content/it/docs/6.donate.md index bbd32212..fb912a7d 100644 --- a/content/it/docs/2.for-users/4.resources/donate.md +++ b/content/it/docs/6.donate.md @@ -1,5 +1,9 @@ # プロジェクトへの寄付 +:::tip +法人としてプロジェクトへの支援(スポンサー)をご検討の方は[こちらをご覧ください。](/docs/become-a-sponsor/) +::: + Misskeyはビジネスではなく、利用は無料であるため、収益は皆様からの寄付のみです。(サーバーによっては広告収入を得ているような場合もありますが、それは運営者の収入であり直接開発者への収入にはなりません) 寄付をしていただければ、今後も開発を続けることが可能になり、プロジェクトへの貢献になります。以下の方法で受け付けています。 @@ -25,12 +29,14 @@ Misskeyはビジネスではなく、利用は無料であるため、収益は - 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 - 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載 - 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載 + ::: ::: :::warning -**バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。** +\*\*バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。また、misskey.io以外のサーバーからはメンション届かない場合があります) +::: (メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります) diff --git a/content/it/docs/7.become-a-sponsor.md b/content/it/docs/7.become-a-sponsor.md new file mode 100644 index 00000000..54f5d338 --- /dev/null +++ b/content/it/docs/7.become-a-sponsor.md @@ -0,0 +1,7 @@ +# スポンサーについて + +Misskey Projectはスポンサーを募集しています。 + +スポンサーになると、MisskeyやMisskey Hubへの会社ロゴ掲載や、技術サポートを受けることができます。 + +[詳細はこちらからお問い合わせください。](/contact/) diff --git a/content/ja/docs/2.for-users/3.features/share-form.md b/content/ja/docs/2.for-users/3.features/share-form.md index 8b4ae4d2..61d60d86 100644 --- a/content/ja/docs/2.for-users/3.features/share-form.md +++ b/content/ja/docs/2.for-users/3.features/share-form.md @@ -73,7 +73,7 @@ URLにクエリパラメータとして共有内容をはじめとするいく :::warning -共有フォーム中継サービス（以下、「本サービス」という）はWebサイト管理者の便宜のためにMisskey Development Division（以下、「当方」という）が無償・無保証で提供する機能です。本サービスを利用したこと、または何らかの原因によりこれをご利用できなかったことにより生じたいかなる損害について、当方は一切の責任を負いません。 +共有フォーム中継サービス（以下、「本サービス」という）はWebサイト管理者の便宜のためにMisskey Project（以下、「当方」という）が無償・無保証で提供する機能です。本サービスを利用したこと、または何らかの原因によりこれをご利用できなかったことにより生じたいかなる損害について、当方は一切の責任を負いません。 ::: @@ -93,4 +93,4 @@ URLパラメータ `manualInstance` にMisskeyサーバーのドメインを入 「シェア元Webサイトからのおすすめ」から遷移したサーバーを利用・登録したことに起因するいかなる損害・不利益について、当方では責任を負いかねます。 -::: \ No newline at end of file +::: diff --git a/content/ja/docs/6.donate.md b/content/ja/docs/6.donate.md index 67b0c1a7..c8eeda68 100644 --- a/content/ja/docs/6.donate.md +++ b/content/ja/docs/6.donate.md @@ -1,4 +1,9 @@ # プロジェクトへの寄付 + +:::tip +法人としてプロジェクトへの支援(スポンサー)をご検討の方は[こちらをご覧ください。](/docs/become-a-sponsor/) +::: + Misskeyはビジネスではなく、利用は無料であるため、収益は皆様からの寄付のみです。(サーバーによっては広告収入を得ているような場合もありますが、それは運営者の収入であり直接開発者への収入にはなりません) 寄付をしていただければ、今後も開発を続けることが可能になり、プロジェクトへの貢献になります。以下の方法で受け付けています。 diff --git a/content/ja/docs/7.become-a-sponsor.md b/content/ja/docs/7.become-a-sponsor.md new file mode 100644 index 00000000..54f5d338 --- /dev/null +++ b/content/ja/docs/7.become-a-sponsor.md @@ -0,0 +1,7 @@ +# スポンサーについて + +Misskey Projectはスポンサーを募集しています。 + +スポンサーになると、MisskeyやMisskey Hubへの会社ロゴ掲載や、技術サポートを受けることができます。 + +[詳細はこちらからお問い合わせください。](/contact/) diff --git a/content/ko/docs/1.about-misskey.md b/content/ko/docs/1.about-misskey.md index 34d6f50d..9a5ac412 100644 --- a/content/ko/docs/1.about-misskey.md +++ b/content/ko/docs/1.about-misskey.md @@ -6,13 +6,12 @@ description: Misskey를 설명하는 문서입니다. # Misskey에 대하여 Misskey는 오픈소스 분산형 마이크로블로그 플랫폼 프로젝트입니다. -개발은 일본의 syuilo의 주도로 2014년부터 시작되었습니다. -드라이브, 리액션 등의 풍부한 기능과, 다양한 커스터마이즈 기능을 가진 Ui를 가진 것이 특징입니다. +개발은 일본에서 syuilo에 의해 2014년부터 시작되었습니다. +드라이브, 리액션 등의 풍부한 기능이나 높은 커스터마이즈 기능을 가진 UI가 특징입니다. ## 역사 -개발 초기에는 게시판 형태의 서비스였으나, 유저가 글을 작성했을 때, 그 글이 시간 순서대로 흘러가는 타임라인 기능을 추가함으로 인기를 받게 되어, 이후 이를 중심으로 개발이 진행되었습니다. -초기에는 분산형이 아니었지만, 2018년에 ActivityPub 프로토콜을 지원함으로써 분산형 SNS로 발돋움하여 널리 알려지게 되었습니다. +개발 초기에는 게시판 메인의 서비스였으나, 유저가 짧은 글을 올리며, 그 글이 시간 순서대로 흘러가는 타임라인 기능을 추가한 후 인기를 받게 되어, 이후 이를 중심으로 개발이 진행되었습니다. 초기에는 분산형이 아니었지만, 2018년에 ActivityPub 프로토콜을 지원함으로써 분산형 SNS이 되어 더욱 많은 분에게 인지되며 이용되는 서비스가 되었습니다. :::tip @@ -22,54 +21,51 @@ Misskey라는 이름은 syuilo가 당시 듣고 있던 May'n의 노래, Brain Di 누구나 개발에 참가할 수 있으며, 현재도 활발한 개발이 이루어지고 있습니다. -## 분산형은 무엇인가? +## 분산형이란 무엇인가? -분산형(distributed), 또는 탈중앙화(decentralized) 서비스의 특징은, 다양한 커뮤니티에 흩어져 있는 유저들이 서로 교류(연합, federation)하여 서로의 정보를 주고 받는 네트워크(연합우주, Fediverse)를 이루는 것입니다. -서버가 하나밖에 없거나, 여러 서버가 있더라도 교류할 수 없는 경우는 중앙집권 서비스라고 하며, Twitter나 Facebook 등이 이에 속합니다. -분산형 서비스의 장점은 자신에게 맞는 운영자나 테마를 자유롭게 선택할 수 있는 것입니다. 직접 서버를 운영할 수도 있습니다. 다양한 서버가 연합한다는 특성으로, 어떤 서버를 고르더라도 같은 커뮤니티에 접근할 수 있습니다. +분산형(distributed)이란, 탈중앙화(decentralized) 로도 불리며 다양한 커뮤니티에 흩어져 있는 유저들이 서로 통신(연합, federation)하여 서로의 정보를 주고 받는 네트워크(연합우주, Fediverse)를 이루는 것이 특징입니다. 서버가 하나밖에 없거나, 여러 서버가 있더라도 서로 독립되어 있는 경우는 중앙집권 서비스라고 하며, Twitter나 Facebook 등이 이에 속합니다. 분산형의 장점은 자신에게 맞는 운영자나 테마를 자유롭게 선택할 수 있는 것입니다.직접 서버를 운영할 수도 있습니다. 다양한 서버가 연합한다는 특성으로, 어떤 서버를 고르더라도 같은 커뮤니티에 접근할 수 있습니다. -## 이어서 오픈소스는 무엇인가? +## 언제나 오픈소스 -Misskey는 지금까지도 앞으로도 오픈 소스로 운영됩니다.오픈 소스는 간단하게 말하면 소프트웨어의 소스 코드(프로그램)가 공개되어 있는것 입니다.소스 코드를 수정하거나 재배포할 수 있음을 정의에 포함할 수도 있습니다. +Misskey는 지금까지도 앞으로도 오픈 소스로 운영됩니다.오픈 소스란, 간단하게 말하면 소프트웨어의 소스 코드(프로그램)가 공개되어 있는것 입니다.소스코드의 수정이나, 재배포가 가능하다는 것을 정의에 포함하는 경우도 있습니다. Misskey의 모든 소스 코드는 [AGPL](https://github.com/misskey-dev/misskey/blob/develop/LICENSE) 이라는 오픈 소스 라이센스 아래에 [공개](https://github.com/misskey-dev) 되어 누구나 자유롭게 열람, 사용, 수정, 변경, 재배포를 할 수 있습니다. -오픈 소스는 자신이 원하는대로 코드를 변경하거나 유해한 코드가 포함되어 있지 않은지 확인할 수 있으며 누구나 개발에 참여할 수 있는 등 다양한 이점이 있습니다. -상술한 분산형을 실현하기 위해서도, 오픈 소스라는 것은 필수 불가결한 요소입니다. -다시 말씀 드리지만, X(Twitter)나 Facebook등의 이익을 얻고 있는 대부분의 서비스는 오픈 소스가 아닙니다. +오픈소스는, 당신이 좋아하는 대로 바꾸거나, 유해한 처리가 포함되어 있지 않은지 확인할 수도 있고, 누구나 개발에 참여할 수 있다는 등의 여러 메리트가 있습니다. +앞서 언급한 분산형을 실현하기 위해서도 오픈소스인 것은 필수 불가결한 요소입니다. +다시 비교하자면, Twitter나 Facebook등의 이익을 얻고 있는 대부분의 서비스는 오픈소스가 아닙니다. :::tip -자세히 말씀드리자면, Misskey의 소스 코드는 Git으로 관리되고 저장소는 [GitHub에서 호스팅됩니다.](https://github.com/misskey-dev) +기술적으로는, Misskey의 소스 코드는 Git으로 관리되며 저장소는 [GitHub에서 호스팅됩니다. ::: -## 개발에 참가 및 프로젝트를 지원하기 +## 개발에 참가하기, 프로젝트를 지원하기 -Misskey가 마음에 드신다면 꼭 프로젝트를 지원해주세요.프로젝트에 기여하기 위해서는, 아래에서 소개하는 것과 같은 여러가지 방법이 있습니다.방법에 따라 개발 기술이 필요 없을 수도 있기 때문에 누구나 부담 없이 참여하고 기여할 수 있습니다.여러분의 기여를 기다리고 있겠습니다. +Misskey가 마음에 드신다면 꼭 프로젝트를 지원해주세요. 프로젝트에 기여하기 위해서는, 아래에서 소개하는 것과 같은 여러가지 방법이 있습니다.방법에 따라 개발 기술이 필요 없을 수도 있기 때문에 누구나 부담 없이 참여하고 기여할 수 있습니다.여러분의 기여를 언제나 기다리고 있습니다. ### 기능을 추가하거나 버그를 수정하기 -소프트웨어 엔지니어 기술을 가지고 계신 분이라면 소스 코드를 편집하는 형태로 프로젝트에 기여할 수 있습니다. +소프트웨어 개발의 기술을 가지고 있는 분이라면, 소스코드를 편집하는 형태로 프로젝트에 기여하실 수 있습니다. 기여에 대한 가이드는 [여기](https://github.com/misskey-dev/misskey/blob/develop/CONTRIBUTING.md) 입니다. ### 논의에 참여하기 새로운 기능 또는 기존 기능에 대해 의견을 내거나 버그를 보고하는 데도 기여할 수 있습니다. -그러한 토론은 [GitHub](https://github.com/misskey-dev) 또는 [포럼](https://forum.misskey.io/) 등으로 진행됩니다. +그러한 토론은 [GitHub](https://github.com/misskey-dev)이나, [포럼](https://forum.misskey.io/)등에서 이루어집니다. ### 문장 번역하기 -Misskey는 다양한 언어를 지원하고 있습니다. (i18n-internationalization의 약자라고 불립니다).원래 언어는 기본적으로 일본어이지만 기여자에 의해 다른 언어로 번역되고 있습니다. +Misskey는 다양한 언어를 지원하고 있습니다.(i18n -internationalization의 줄임말- 이라고 불립니다)원 언어는 기본적으로 일본어이지만, 기여자에 의해서 다른 언어로 번역되고 있습니다. 그 번역 작업에 참여해 주시는 것으로도 Misskey에 기여할 수 있습니다. -Misskey는 [Crowdin](https://crowdin.com/project/misskey) 이라는 서비스를 사용하여 번역 관리를 하고 있습니다. +Misskey는 [Crowdin이라는 서비스를 이용하여 번역의 관리를 하고 있습니다.](https://crowdin.com/project/misskey) ### Misskey에 대해 의견 쓰기 -버그 제보 뿐만 아니라 Misskey의 좋은 점, 즐거운 점 등 긍정적인 의견도 꼭 공유해 주세요.개발에 힘이 되고, 간접적이지만 그것 또한 프로젝트에 대한 기여입니다. +버그 제보 뿐만 아니라 Misskey의 좋은 점, 즐거운 점 등 긍정적인 의견도 꼭 공유해 주세요. 개발에 힘이 되고, 간접적이지만 그것 또한 프로젝트에 대한 기여가 됩니다. ### 미스키스트 늘리기 -미스키스트(Misskist) 란 Misskey를 사용하는 사람을 말합니다. -지인에게 소개하는 등 Misskey를 퍼뜨려주시면 미스키스트가 늘어나 개발 의욕이 높아집니다. +미스키스트(Misskist) 란 Misskey를 사용하는 사람을 말합니다. 지인에게 소개하는 등 Misskey를 퍼뜨려주시면 미스키스트가 늘어나 개발 의욕이 높아집니다. ### 기부하기 @@ -79,42 +75,41 @@ Misskey는 [Crowdin](https://crowdin.com/project/misskey) 이라는 서비스를 ### 프로젝트의 목표는 무엇인가요? -굳이 말하자면 막연하지만 널리 쓰이는 범용적인 플랫폼이 되는 것을 목표로 하고 있습니다. -Misskey는 다른 프로젝트와는 달리 어떠한 사상(예를 들면 반중앙집권)이나 비전에 근거하여 개발이 이루어지고 있는 것이 아니며, 그런 점에서는 플랫합니다. -그것이 반대로 특정 방향성에 얽매이지 않는 유연함을 만들어내는 것으로 이어지고 있다고 느끼고 있습니다. +Misskey는 다른 프로젝트와는 달리 어떠한 사상(예를 들면 반중앙집권)이나 이상에 근거하여 개발이 이루어지고 있는 것이 아니며, 그런 점에서는 평탄합니다. +그것이 반대로, 특정한 방향으로 묶이지 않는 유연함으로 이어진다고 느끼고 있습니다. ### 기업에서 개발하나요? 아닙니다.Misskey의 개발은 개인적으로 이루어지고 상업적이지도 않기 때문에 특정 기업의 관계는 없습니다. -개발 멤버도 기본적으로는 자원봉사자입니다. -또한 개발에 대해 기업의 스폰서가 붙기도 하는데, 그 경우에도 역시 개발은 개인 커뮤니티가 주체입니다. +개발 멤버도 기본적으로 자원봉사입니다. +또한, 개발에 대해 후원이 붙는 경우도 있지만, 그 경우에도 역시 개발은 개인의 커뮤니티가 주체입니다. ### 누가 운영하나요? -Misskey는 분산형이기 때문에 각 서버마다 각기 다른 운영자가 있습니다.따라서 특정 개인이나 기업에 의해 Misskey가 모두 운영되는 것은 아닙니다. -또한 개발팀이 운영하는 것도 아니므로 운영에 관한 연락은 사용하시는 서버 운영자에게 해주시기 바랍니다. -서버 운영자는 서버 정보 페이지에서 확인할 수 있습니다. -여러분이 서버를 구축하면 여러분이 운영자가 됩니다. +Misskey는 분산형이기 때문에 각 서버마다 각기 다른 운영자가 있습니다. 따라서, 특정 개인이나 기업에 의해 Misskey의 모든 것이 운영되는 것은 아닙니다. +또한, 개발 팀이 운영을 하는 것도 아니므로 운영에 관한 연락은 사용하시는 운영자에게 해 주시기 바랍니다. +서버의 운영자는 서버의 정보 페이지에서 확인할 수 있습니다. +당신이 서버를 만들면, 당신이 운영자가 됩니다. ### 어떤 서버를 골라야 하나요? -[서버 목록이 공개되어 있습니다.](/servers/)서버에 따라 커뮤니티의 테마(특정한 것, 사물을 좋아함 등)가 정해져 있는 경우가 있기 때문에 자신에게 맞는 테마의 서버가 있으면, 그곳을 선택하는 것이 좋을지도 모릅니다. -이외에도 서버의 규모, 사용자층, 국가 및 언어, 운영자가 신뢰할 수 있는지 여부 등의 관점을 적용 할 수도 있습니다. -덧붙여 Misskey 공식 서버라고 하는 것은 없습니다.자신이 직접 새로운 서버를 만드는 선택지도 있습니다. +[서버 목록이 공개되어 있습니다.](/servers/)서버에 따라 커뮤니티의 주제(특정한 것을 좋아함 등)가 정해져 있는 경우가 있기 때문에 자신에게 맞는 주제의 서버가 있다면, 그곳을 선택하는 것이 좋을지도 모릅니다. +그 외에도 서버의 규모, 유저 층, 나라 및 언어, 운영자를 신뢰할 수 있느냐 등의 관점이 있습니다. +또한, Misskey공식 서버같은 것은 없습니다.당신 스스로 직접 새로운 서버를 만드는 선택지도 있습니다. -기본적으로 어떤 서버를 선택하든 다른 모든 서버의 사용자와 연결할 수 있습니다. +기본적으로 어떤 서버를 선택하든 다른 모든 서버의 사용자와 이어질 수 있습니다. ### 서버는 어떻게 만드나요? Misskey 서버 구축에 관심 가져주셔서 감사합니다. -2024년 현재 Misskey 호스팅 서비스는 존재하지 않기 때문에 서버 작성에는 어느 정도의 서버 관련 기술이 필요합니다. -서버 작성 방법에 대해서는 [여기](/docs/for-admin/install/)를 참조해 주세요. +2022년 현재, Misskey의 호스팅 서비스는 존재하지 않으므로, 서버를 만드는데에는 어느 정도의 지식이 필요합니다. +서버를 만드는 법에 대해서는 [여기](/docs/for-admin/install/)를 참조해 주세요. ### 어떤 기술을 쓰나요? -Misskey는 개발이 진행되면서 사용하는 기술도 크게 달라졌습니다.개발 초기에는 MySQL + PHP + jQuery와 같은 구성이었으나 현재는 다음과 같습니다. +Misskey는 개발이 진행되면서 사용하는 기술도 크게 바뀌어 갔습니다.개발 초기에는 MySQL + PHP + jQuery와 같은 구성이었으나 현재는 다음과 같습니다. - 서버 사이드: Node.js - 데이터베이스: PostgreSQL, Redis @@ -126,15 +121,14 @@ Misskey는 개발이 진행되면서 사용하는 기술도 크게 달라졌습 ### Mastodon의 한 갈래인가요? 아닙니다.Misskey는 Mastodon이나 다른 프로젝트와는 전혀 다른 프로젝트입니다. -개발 자체도 Misskey 쪽이 Mastodon보다 더 옛날에 개발되었습니다.다만 분산형 서비스로 바뀐것은 Mastodon의 등장보다 나중의 일입니다. +개발도 Misskey가 더 오랫동안 개발되어왔습니다.하지만, 분산형이 된 것은 Mastodon의 등장보다 나중의 일입니다. 같은 ActivityPub이라는 분산형 프로토콜을 사용하고 있다는 점 이외에는 Mastodon과의 다른 특별한 관련이 있는 것도 아닙니다. ### iOS/Android용 어플리케이션이 있나요? -공식적으로는 그런 OS의 네이티브 앱을 개발하지 않았지만, 서드파티 앱이 몇 개 있습니다. -자세한 내용은 [여기](/docs/for-users/resources/apps/)를 참조하십시오. +공식적으로는 그런 OS의 네이티브 앱을 개발하지 않았지만, 서드파티 앱이 몇 개 있습니다. 자세한 내용은 [여기](/docs/for-users/resources/apps/)를 참조하시기 바랍니다. -다만, 서드파티 앱은 아무래도 새로운 기능 또는 기존 기능에 대한 대응이 늦거나 없기 때문에, 특별한 이유가 없다면 공식 웹 클라이언트의 이용을 추천합니다. +또한, 서드파티 앱은 아무래도 기능 변경에 대한 대응이 늦어지므로, 특별한 이유가 없다면 공식 Web 클라이언트의 이용을 추천합니다. 덧붙여 Misskey의 Web 클라이언트는 PWA를 지원하고 있기 때문에, 네이티브 앱처럼 동작시키는 것도 가능합니다. ### Misskey의 로고, 아이콘은 어디서 구할 수 있나요? @@ -151,6 +145,6 @@ Misskey는 개발이 진행되면서 사용하는 기술도 크게 달라졌습 :::fukidashi{chara="syuilo" charaName="しゅいろ(슈이로)" direction="right"} -Misskey의 수호신 아이짱입니다.아이쨩 귀여워 야호\~! +Misskey의 수호신, 藍(아이) 입니다.아이쨩! 아이쨩! ::: diff --git a/content/ko/docs/2.for-users/2.onboarding/0.index.md b/content/ko/docs/2.for-users/2.onboarding/0.index.md index a8ca3f3d..3dcf26ae 100644 --- a/content/ko/docs/2.for-users/2.onboarding/0.index.md +++ b/content/ko/docs/2.for-users/2.onboarding/0.index.md @@ -5,7 +5,7 @@ 주로, - 분산형 플랫폼의 주의 사항 -- 서버는?서버는 어떻게 고르나요? +- 서버는?서버는 어떻게 고르나요?서버는 어떻게 고르나요? - 가입 방법 - 최소한의 기초 지식 diff --git a/content/ko/docs/2.for-users/2.onboarding/1.warning.md b/content/ko/docs/2.for-users/2.onboarding/1.warning.md index 295562d9..379e9711 100644 --- a/content/ko/docs/2.for-users/2.onboarding/1.warning.md +++ b/content/ko/docs/2.for-users/2.onboarding/1.warning.md @@ -7,8 +7,9 @@ description: Misskey 서버에서 계정을 만들려면 알아야 하는 기본 Misskey를 쓰는 서비스를 이용할 때에는 몇 가지를 유의해야 합니다. - Misskey는 분산형 서비스입니다.(하지만 이는 대부분의 인터넷이 그렇습니다.) -- 비공개로 올린 노트도, 다른 서버에서도 동일하게 비공개로 취급할지는 보증할 수 없습니다.개인 정보, 기밀 정보를 올리실 때는 특별히 주의하시길 바랍니다.(하지만, 이 내용은 다른 인터넷 서비스들도 이렇다고 할 수 있습니다.)개인 정보, 기밀 정보를 올리실 때는 특별히 주의하시길 바랍니다.(하지만, 이 내용은 다른 인터넷 서비스들도 이렇다고 할 수 있습니다.) -- 계정 삭제는 서버에 부하가 많이 가므로, 긴 시간이 걸리는 경우가 있습니다.업로드하신 데이터가 많은 경우에는 계정 삭제가 되지 않는 경우가 있습니다.한 번 업로드를 하신 데이터는 삭제하셔도 다른 서버에서도 꼭 삭제되었다고는 할 수는 없습니다.(하지만, 이 내용은 다른 인터넷 서비스들도 이렇다고 할 수 있습니다.) -- 서버에 따라선, 광고비 수입으로 운영되어지는 경우가 있습니다.또한 광고 차단은 광고와 전혀 관련 없는 콘텐츠나 기능을 잘못 차단하기도 하므로 클라이언트 작동에 지장이 가거나 정상적으로 Misskey를 사용할 수 없을 수도 있습니다.이 경우 정상적으로 Misskey를 사용하실 수 없는 경우가 있습니다.그러므로, Misskey에는 광고 차단기나 그에 준하는 기능은 끄고 사용하시길 바랍니다. +- 비공개로 올린 노트도, 다른 서버에서도 동일하게 비공개로 취급할지는 보증할 수 없습니다.개인 정보, 기밀 정보를 올리실 때는 특별히 주의하시길 바랍니다.(하지만, 이 내용은 다른 인터넷 서비스들도 이렇다고 할 수 있습니다.)개인 정보, 기밀 정보를 올리실 때는 특별히 주의하시길 바랍니다.(하지만, 이 내용은 다른 인터넷 서비스들도 이렇다고 할 수 있습니다.)개인 정보, 기밀 정보를 올리실 때는 특별히 주의하시길 바랍니다.(하지만, 이 내용은 다른 인터넷 서비스들도 이렇다고 할 수 있습니다.) +- Misskeyに搭載されている「ドライブ」機能は一般的なクラウドストレージではありません。この機能は、アップロードしたファイルを管理したり再利用したりするためのものです。 **アップロードされたデータは、ノートに添付したことがあるかどうかにかかわらず、URLを知っている人ならだれでもアクセスできます。** 機密情報を含むデータのやりとりには専用のサービスをご利用ください。 +- 계정 삭제는 서버에 부하가 많이 가므로, 긴 시간이 걸리는 경우가 있습니다.업로드하신 데이터가 많은 경우에는 계정 삭제가 되지 않는 경우가 있습니다.계정 삭제는 서버에 부하가 많이 가므로, 긴 시간이 걸리는 경우가 있습니다.업로드하신 데이터가 많은 경우에는 계정 삭제가 되지 않는 경우가 있습니다.한 번 업로드를 하신 데이터는 삭제하셔도 다른 서버에서도 꼭 삭제되었다고는 할 수는 없습니다.(하지만, 이 내용은 다른 인터넷 서비스들도 이렇다고 할 수 있습니다.) +- 서버에 따라선, 광고비 수입으로 운영되어지는 경우가 있습니다.서버에 따라선, 광고비 수입으로 운영되어지는 경우가 있습니다.또한 광고 차단은 광고와 전혀 관련 없는 콘텐츠나 기능을 잘못 차단하기도 하므로 클라이언트 작동에 지장이 가거나 정상적으로 Misskey를 사용할 수 없을 수도 있습니다.이 경우 정상적으로 Misskey를 사용하실 수 없는 경우가 있습니다.그러므로, Misskey에는 광고 차단기나 그에 준하는 기능은 끄고 사용하시길 바랍니다.Misskey는 분산형 서비스입니다.(하지만 이는 대부분의 인터넷이 그렇습니다.) 이 내용들을 숙지하신 후, 편리한 서비스를 사용하시길 바랍니다. diff --git a/content/ko/docs/2.for-users/2.onboarding/2.get-started.md b/content/ko/docs/2.for-users/2.onboarding/2.get-started.md index e162209b..845487f0 100644 --- a/content/ko/docs/2.for-users/2.onboarding/2.get-started.md +++ b/content/ko/docs/2.for-users/2.onboarding/2.get-started.md @@ -23,6 +23,8 @@ Misskey가 탑재하고 있는 ActivityPub이라는 개방된 공통 규격을 ::: +::: + ## 서버를 고르는 방법 ### 서버의 주제 diff --git a/content/ko/docs/2.for-users/2.onboarding/3.join-server.md b/content/ko/docs/2.for-users/2.onboarding/3.join-server.md index 1959e107..9dae0a16 100644 --- a/content/ko/docs/2.for-users/2.onboarding/3.join-server.md +++ b/content/ko/docs/2.for-users/2.onboarding/3.join-server.md @@ -7,6 +7,7 @@ 여기서는 Misskey.io를 예로 들었지만, 다른 서버에서도 등록 방법은 대체로 동일합니다. 다만, 가입하실 때 필요한 정보는 서버에 따라 다른 경우가 있습니다.자세한 내용은, 서버 관리자에게 확인해보시길 바랍니다. +::: ::: @@ -16,23 +17,21 @@  -다음, 화면의 내용에 따라 이용 약관의 확인과 필요한 정보를 입력해주세요. - 대부분 입력하게 되는 내용들은 아래와 같습니다. -- 초대 코드 (초대제 서버인 경우.코드가 없으신 분은 가입할 수 없습니다.)코드가 없으신 분은 가입할 수 없습니다.) -- 유저명 (**가입 후에는 바꾸실 수 없습니다.한 번 탈퇴하신 후에는 같은 유저명으로 가입하실 수 없습니다.**)한 번 탈퇴하신 후에는 같은 유저명으로 가입하실 수 없습니다.\*\*) +主に記入すべき事項は、以下の通りです。 + +- 招待コード（登録が招待制の場合のみ。お持ちでない場合は登録できません。:::tip +- ユーザー名（\*\*後から変更はできません。一度退会すると同じユーザー名を取得することはできません。유저명 (**가입 후에는 바꾸실 수 없습니다.한 번 탈퇴하신 후에는 같은 유저명으로 가입하실 수 없습니다.**)한 번 탈퇴하신 후에는 같은 유저명으로 가입하실 수 없습니다.\*\*) - 이메일 주소 (필요하지 않은 서버도 있습니다) - 비밀번호  -대부분 입력하게 되는 내용들은 아래와 같습니다. 필요한 정보를 모두 기입하시면, 이메일 주소를 입력해야하는 서버의 경우, 확인 메일이 와있으므로, 가급적 빠르게 메일 안에 있는 링크를 클릭해주세요. +대부분 입력하게 되는 내용들은 아래와 같습니다. 필요한 정보를 모두 기입하시면, 이메일 주소를 입력해야하는 서버의 경우, 확인 메일이 와있으므로, 가급적 빠르게 메일 안에 있는 링크를 클릭해주세요. 이것으로 당신도 [미스키스트](../resources/glossary/#미스키스트)!즐거운 커뮤니케이션을 보내시길 바랍니다.  -:::tip +여기서는 Misskey.io를 예로 들었지만, 다른 서버에서도 등록 방법은 대체로 동일합니다. 다만, 가입하실 때 필요한 정보는 서버에 따라 다른 경우가 있습니다.자세한 내용은, 서버 관리자에게 확인해보시길 바랍니다. 다음, 화면의 내용에 따라 이용 약관의 확인과 필요한 정보를 입력해주세요. 대부분 입력하게 되는 내용들은 아래와 같습니다. -ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 - -이것으로 당신도 [미스키스트](../resources/glossary/#미스키스트)!즐거운 커뮤니케이션을 보내시길 바랍니다. +これであなたも[ミスキスト](../resources/glossary/#ミスキスト)！楽しいコミュニケーションをお楽しみください。 diff --git a/content/ko/docs/2.for-users/2.onboarding/4.things-to-know.md b/content/ko/docs/2.for-users/2.onboarding/4.things-to-know.md index e32ad972..ec6866bd 100644 --- a/content/ko/docs/2.for-users/2.onboarding/4.things-to-know.md +++ b/content/ko/docs/2.for-users/2.onboarding/4.things-to-know.md @@ -14,7 +14,7 @@ Misskey에 올리는 것은 일반적으로 "노트"라고 부릅니다.Twitter ## 타임라인 -Misskey는 여러 개의 타임라인을 가지고 있습니다.이름만으로는 다소 이해하기 어려울 수 있으니, 각각 어떤 역할을 하는지 알아둡시다. +Misskey는 여러 개의 타임라인을 가지고 있습니다.이름만으로는 다소 이해하기 어려울 수 있으니, 각각 어떤 역할을 하는지 알아둡시다.이름만으로는 다소 이해하기 어려울 수 있으니, 각각 어떤 역할을 하는지 알아둡시다. :::tip @@ -24,4 +24,4 @@ Misskey는 여러 개의 타임라인을 가지고 있습니다.이름만으로 ## 그 외 -이 밖에도 Misskey에는 다양한 기능들이 있습니다!모든 기능에 대한 설명은 [여기](/docs/for-users/features/)에서 확인할 수 있으니 꼭 확인해보세요! +Misskey에 올리는 것은 일반적으로 "노트"라고 부릅니다.Twitter 등의 일반적인 SNS와 비교해 더 많은 기능들이 있으니, 첫 노트를 올리시기 전에 꼭 확인해보시길 바랍니다.이 밖에도 Misskey에는 다양한 기능들이 있습니다!모든 기능에 대한 설명은 [여기](/docs/for-users/features/)에서 확인할 수 있으니 꼭 확인해보세요! diff --git a/content/ko/docs/2.for-users/3.features/1.index.md b/content/ko/docs/2.for-users/3.features/1.index.md index 58d0a4ac..8fe8b4d6 100644 --- a/content/ko/docs/2.for-users/3.features/1.index.md +++ b/content/ko/docs/2.for-users/3.features/1.index.md @@ -4,6 +4,6 @@ description: Misskey의 큰 특징인, 다양한 기능에 대해 설명하고 # 여러가지 기능 -Misskey의 큰 특징은, 다른 마이크로 블로그 시스템에서는 볼 수 없는 다양한 기능이 있는 것 입니다.여기에서는, 그 내용들에 대해 설명을 합니다.여기에서는, 그 내용들에 대해 설명을 합니다. +Misskey의 큰 특징은, 다른 마이크로 블로그 시스템에서는 볼 수 없는 다양한 기능이 있는 것 입니다.여기에서는, 그 내용들에 대해 설명을 합니다.여기에서는, 그 내용들에 대해 설명을 합니다.여기에서는, 그 내용들에 대해 설명을 합니다.
+Misskey를 이용할 때 자주 묻는 질문에 대한 내용을 담고 있습니다.Misskey 이용시 자주 묻는 질문에 대해 안내해 드립니다.
Misskey 프로젝트 자체에 대한 자주 묻는 질문은 [여기](../../about-misskey#자주 묻는 질문)을 참고하세요. ## Android/iOS용 앱이 있나요? -미스키 프로젝트에서는 이러한 모바일 OS를 위한 네이티브 앱을 개발하지 않고 있지만, 서드파티에서 만든 앱이 몇 가지 존재합니다.자세한 내용은 [여기](./apps)에서 확인하실 수 있습니다.
+미스키 프로젝트에서는 이러한 모바일 OS를 위한 네이티브 앱을 개발하지 않고 있지만, 서드파티에서 만든 앱이 몇 가지 존재합니다.자세한 내용은 [여기](./apps)에서 확인하실 수 있습니다.
자세한 내용은 [여기](./apps)에서 확인하실 수 있습니다.
-다만, 서드파티 앱은 Misskey의 최신 기능에 대한 대응이 늦어질 수밖에 없으므로, 특별한 이유가 없다면 Misskey 공식 웹 클라이언트인 Misskey Web을 사용하는 것을 추천합니다.또한, 미스키 웹은 PWA를 지원하기 때문에 네이티브 앱처럼 동작하는 것도 가능합니다.자세한 내용은 [여기](todo)에서 확인할 수 있습니다. +다만, 서드파티 앱은 Misskey의 최신 기능에 대한 대응이 늦어질 수밖에 없으므로, 특별한 이유가 없다면 Misskey 공식 웹 클라이언트인 Misskey Web을 사용하는 것을 추천합니다.또한, 미스키 웹은 PWA를 지원하기 때문에 네이티브 앱처럼 동작하는 것도 가능합니다.자세한 내용은 [여기](todo)에서 확인할 수 있습니다.또한, 이 경우에도 사용료를 징수할 계획은 없습니다.자세한 내용은 [여기](todo)에서 확인할 수 있습니다. ## Mastodon용 앱으로 로그인할 수 있나요? Misskey는 Mastodon의 API와 호환되지 않기 때문에, 일부를 제외한 타사 Mastodon용 앱이나 웹 클라이언트 등에서는 Misskey를 사용할 수 없습니다.
+Misskey 공식 웹 클라이언트인 Misskey Web을 이용하세요.
Misskey 공식 웹 클라이언트인 Misskey Web을 이용하세요. ## misskey.io는 Misskey 프로젝트의 공식 서버인가요? -misskey.io는 Misskey 공식 서버가 아니며, Misskey 프로젝트에도 포함되지 않습니다.misskey.io는 특정 테마 없이 범용적이며, 쉽게 등록할 수 있는 Misskey에서 가장 큰 규모의 서버입니다. +misskey.io는 Misskey 공식 서버가 아니며, Misskey 프로젝트에도 포함되지 않습니다.misskey.io는 특정 테마 없이 범용적이며, 쉽게 등록할 수 있는 Misskey에서 가장 큰 규모의 서버입니다.메뉴에서 검색을 선택하고 사용자 계정을 아래 형식으로 입력합니다.사용자 계정은 사용자 이름과 사용자가 속한 서버 또는 서버의 호스트 이름을 포함합니다.미스키뿐만 아니라 Mastodon, Pleroma 등 많은 분산형 소프트웨어에서 다음과 같은 사용자 계정 형태가 일반적입니다.
## 주식회사 미스키HQ와의 관계는? -주식회사 MisskeyHQ는 misskey.io의 운영을 목적으로 하는 회사입니다.따라서 Misskey 개발 프로젝트와 직접적인 관계는 없습니다. -다만 미스키 프로젝트 리더인 슈이로(suuilo)도 임원으로 참여하고 있으며, 함께 미스키를 발전시켜 나가는 관계입니다. +주식회사 MisskeyHQ는 misskey.io의 운영을 목적으로 하는 회사입니다.따라서 Misskey 개발 프로젝트와 직접적인 관계는 없습니다.다만 미스키 프로젝트 리더인 슈이로(suuilo)도 임원으로 참여하고 있으며, 함께 미스키를 발전시켜 나가는 관계입니다. ## '미스키'라는 이름의 유래는 무엇인가요? @@ -42,20 +42,20 @@ misskey.io는 Misskey 공식 서버가 아니며, Misskey 프로젝트에도 포 ## 리노트를 삭제하려면 어떻게 해야 하나요? -리노트의 시간 표시 옆에 있는 "..." 를 누르고 '리노트 해제'를 선택합니다.
+리노트의 시간 표시 옆에 있는 "..." 를 누르고 '리노트 해제'를 선택합니다.를 누르고 '리노트 해제'를 선택합니다.
Renote에 대한 자세한 내용은 [여기](../features/note/#renote)에서 확인하실 수 있습니다. ## 노트 내 URL의 미리보기를 표시하고 싶지 않습니다. -MFM(Markup language For Misskey)이라는 Misskey의 자체 마크업 언어에는 URL의 미리보기를 비활성화하는 구문이 있습니다.자세한 내용은 MFM 치트시트를 참고하세요.MFM 치트시트는 여러분이 속한 서버에서 다음 주소를 입력하면 볼 수 있습니다.`https://서버 호스트 이름/mfm-cheat-sheet` +MFM(Markup language For Misskey)이라는 Misskey의 자체 마크업 언어에는 URL의 미리보기를 비활성화하는 구문이 있습니다.자세한 내용은 MFM 치트시트를 참고하세요.MFM 치트시트는 여러분이 속한 서버에서 다음 주소를 입력하면 볼 수 있습니다.`https://서버 호스트 이름/mfm-cheat-sheet`자세한 내용은 MFM 치트시트를 참고하세요.MFM 치트시트는 여러분이 속한 서버에서 다음 주소를 입력하면 볼 수 있습니다.`https://서버 호스트 이름/mfm-cheat-sheet` ## 사용자 지정 이모티콘을 추가, 편집, 삭제하고 싶습니다. -사용자 지정 이모티콘을 추가, 편집, 삭제할 수 있는 권한은 해당 서버의 관리자만 가질 수 있습니다.이를 원할 경우, 서버 관리자에게 직접 문의하시기 바랍니다. +사용자 지정 이모티콘을 추가, 편집, 삭제할 수 있는 권한은 해당 서버의 관리자만 가질 수 있습니다.이를 원할 경우, 서버 관리자에게 직접 문의하시기 바랍니다.이를 원할 경우, 서버 관리자에게 직접 문의하시기 바랍니다. ## Bot을 개발하고 싶어요 -Misskey API를 이용한 Bot 개발이 가능합니다.자세한 내용은 [여기](../../for-developers/api/)에서 확인할 수 있습니다. +Misskey API를 이용한 Bot 개발이 가능합니다.자세한 내용은 [여기](../../for-developers/api/)에서 확인할 수 있습니다.자세한 내용은 [여기](../../for-developers/api/)에서 확인할 수 있습니다. ## 노트의 번역 기능은 어떤 서비스를 사용하나요? @@ -65,14 +65,14 @@ Misskey API를 이용한 Bot 개발이 가능합니다.자세한 내용은 [여 ### 짧은 답변 -**비즈니스 목적**으로 운영한다면 **예**입니다.그렇지 않으면 **아니요**. +**비즈니스 목적**으로 운영한다면 **예**입니다.그렇지 않으면 **아니요**.그렇지 않으면 **아니요**. ### 긴 답변 '사업자'의 정의는 [총무성 문서](https://www.soumu.go.jp/main_content/000477428.pdf)에 따르면 '서비스를 제공하고 그 대가로 요금을 징수하여 수익을 얻으려는 자'로 되어 있습니다.따라서 사업적으로 수익을 창출할 목적으로 서버를 운영하지 않는 한 신고가 필요하지 않습니다.따라서 기부금이나 광고 등으로 수익이 발생하더라도 서버 운영비 등을 충당하기 위한 수익이라면 신고대상 사업자에 해당하지 않습니다.(총무성에 확인)
+자세한 내용은 총무성의 [전기통신사업 진출 매뉴얼](https://www.soumu.go.jp/main_content/000477428.pdf) 등의 자료를 참고하시거나 총무성에 문의하시기 바랍니다.따라서 사업적으로 수익을 창출할 목적으로 서버를 운영하지 않는 한 신고가 필요하지 않습니다.따라서 기부금이나 광고 등으로 수익이 발생하더라도 서버 운영비 등을 충당하기 위한 수익이라면 신고대상 사업자에 해당하지 않습니다.(총무성에 확인)
자세한 내용은 총무성의 [전기통신사업 진출 매뉴얼](https://www.soumu.go.jp/main_content/000477428.pdf) 등의 자료를 참고하시거나 총무성에 문의하시기 바랍니다. ## 이름에 'Misskey'가 포함된 서비스를 공개해도 되나요? 'Misskey'는 Misskey 프로젝트의 등록상표(일본)이지만, 이름에 'Misskey'가 포함된(예: Misskey Tools 등) 서비스를 공개해도 문제가 되지 않습니다. -또한, 이 경우에도 사용료를 징수할 계획은 없습니다. diff --git a/content/ko/docs/2.for-users/4.resources/glossary.md b/content/ko/docs/2.for-users/4.resources/glossary.md index dfa833e1..1ada09da 100644 --- a/content/ko/docs/2.for-users/4.resources/glossary.md +++ b/content/ko/docs/2.for-users/4.resources/glossary.md @@ -8,7 +8,7 @@ Misskey 관련 용어집입니다. ## Acct -특정 사용자를 나타내는 `@username@host` 형식의 문자열.멘션을 할 때 등에 사용된다. +특정 사용자를 나타내는 `@username@host` 형식의 문자열.멘션을 할 때 등에 사용된다.멘션을 할 때 등에 사용된다. ## ActivityPub @@ -18,12 +18,12 @@ Misskey 관련 용어집입니다. ## AiScript ( 읽기: 아이 스크립트 )
-Misskey에서 사용할 수 있는 자바스크립트 기반의 프로그래밍 언어이다.자세한 내용은 [여기.](https://github.com/aiscript-dev/aiscript/blob/master/README.md) +Misskey에서 사용할 수 있는 자바스크립트 기반의 프로그래밍 언어이다.자세한 내용은 [여기.](https://github.com/aiscript-dev/aiscript/blob/master/README.md)자세한 내용은 [여기.](https://github.com/aiscript-dev/aiscript/blob/master/README.md) ## API (읽기: 에이피아이)
-Misskey의 서버가 공개하고 있는, 프로그램에서 Misskey를 다루기 위한 인터페이스.자세한 내용은 [여기.](../../for-developers/api) +Misskey의 서버가 공개하고 있는, 프로그램에서 Misskey를 다루기 위한 인터페이스.자세한 내용은 [여기.](../../for-developers/api)자세한 내용은 [여기.](../../for-developers/api) ## Bot @@ -42,7 +42,7 @@ Contents Warning의 약자.노트의 내용을 조작하지 않으면 표시되 ## GTL -글로벌 타임라인(Global Timeline)의 약자.타임라인에 대한 자세한 내용은 [여기.](../features/timeline) +글로벌 타임라인(Global Timeline)의 약자.타임라인에 대한 자세한 내용은 [여기.](../features/timeline)타임라인에 대한 자세한 내용은 [여기.](../features/timeline) ## HTL @@ -55,22 +55,23 @@ Contents Warning의 약자.노트의 내용을 조작하지 않으면 표시되 ## MFM (읽기: 엠에프엠)
-Markup language For Misskey의 약자로, Misskey에서 사용할 수 있는 마크업 언어이다.자세한 내용은 [여기.](../features/mfm) +Markup language For Misskey의 약자로, Misskey에서 사용할 수 있는 마크업 언어이다.자세한 내용은 [여기.](../features/mfm)자세한 내용은 [여기.](../features/mfm) ## Misskey Web (읽기: 미스키 웹)
。 +Misskey 공식 웹 클라이언트(인터페이스).(읽기: 미스키 웹)
。 Misskey 공식 웹 클라이언트(인터페이스).Misskey 서버에 PC, 스마트폰 등의 웹브라우저로 접속하면 자동으로 표시된다. ## NSFW (읽기: 낫 세이프 포 워크)
-Not Safe For Work의 약자.이미지를 '민감'하게 처리하여 조작이 없으면 표시되지 않도록 할 수 있는 기능이다. +Not Safe For Work의 약자.이미지를 '민감'하게 처리하여 조작이 없으면 표시되지 않도록 할 수 있는 기능이다.이미지를 '민감'하게 처리하여 조작이 없으면 표시되지 않도록 할 수 있는 기능이다. ## Renote (읽기: 리노트)
-이미 있는 노트를 인용하거나 그 노트를 새로운 노트로 공유하는 행위, 또는 그로 인해 생성된 노트.자세한 내용은 [여기.](../features/note/#renote) +이미 있는 노트를 인용하거나 그 노트를 새로운 노트로 공유하는 행위, 또는 그로 인해 생성된 노트.자세한 내용은 [여기.](../features/note/#renote)자세한 내용은 [여기.](../features/note/#renote) ## STL @@ -87,7 +88,7 @@ todo ## 커스텀 이모티콘 -각 Misskey 서버의 관리자와 사용자가 자체적으로 만든 이모티콘.커스텀 이모티콘이 아닌 일반 이모티콘은 '유니코드 이모티콘'이라고 부른다.자세한 내용은 [여기.](../features/custom-emoji) +각 Misskey 서버의 관리자와 사용자가 자체적으로 만든 이모티콘.커스텀 이모티콘이 아닌 일반 이모티콘은 '유니코드 이모티콘'이라고 부른다.자세한 내용은 [여기.](../features/custom-emoji)커스텀 이모티콘이 아닌 일반 이모티콘은 '유니코드 이모티콘'이라고 부른다.자세한 내용은 [여기.](../features/custom-emoji) ## 제어판 @@ -100,15 +101,15 @@ Misskey 서버의 설정 화면을 말한다. ## 드라이브 -Misskey의 서버에서 사용자가 업로드한 이미지, 음악 등의 파일을 관리할 수 있는 기능이다.자세한 내용은 [여기.](../features/drive) +Misskey의 서버에서 사용자가 업로드한 이미지, 음악 등의 파일을 관리할 수 있는 기능이다.자세한 내용은 [여기.](../features/drive)자세한 내용은 [여기.](../features/drive) ## 노트 -Misskey의 서버에 사용자가 올린 글을 말한다.이미지, 음악 등의 파일, 설문조사 등 미스키만의 다양한 콘텐츠를 담을 수 있다.자세한 내용은 [여기.](../features/note) +스팸 동결 및 뮤트, 부적절한 게시물 삭제 등 서버 운영과 관련된 권한을 가진 사용자.서버 관리자가 서버 내에서 중재자를 모집하고 채용하는 경우가 많다.Misskey의 서버에 사용자가 올린 글을 말한다.이미지, 음악 등의 파일, 설문조사 등 미스키만의 다양한 콘텐츠를 담을 수 있다.자세한 내용은 [여기.](../features/note)자세한 내용은 [여기.](../features/note) ## 미스키스트 -Misskey의 서버에 계정을 가진 사용자.또는 그 중에서도 헤비유저를 지칭하는 말. +Misskey의 서버에 계정을 가진 사용자.또는 그 중에서도 헤비유저를 지칭하는 말.또는 그 중에서도 헤비유저를 지칭하는 말. ## 모더레이터 diff --git a/content/ko/docs/2.for-users/4.resources/misskey-hub.md b/content/ko/docs/2.for-users/4.resources/misskey-hub.md index 1efb6ff9..a19b674b 100644 --- a/content/ko/docs/2.for-users/4.resources/misskey-hub.md +++ b/content/ko/docs/2.for-users/4.resources/misskey-hub.md @@ -1,9 +1,8 @@ # Misskey에 대하여 Misskey Hub는 Misskey에 대한 지식 등의 문서, 개발 블로그, 플러그인 스토어 등을 제공하는 Misskey의 공식 사이트입니다. -'Misskey의 모든 것이 여기에 있다'를 지향합니다. -Misskey Hub도 [오픈소스로 공개되어 있습니다.](https://github.com/misskey-dev/misskey-hub) +Misskey Hub도 [오픈소스로 공개되어 있습니다.](https://github.com/misskey-dev/misskey-hub)'Misskey의 모든 것이 여기에 있다'를 지향합니다. :::tip diff --git a/content/ko/docs/2.for-users/_dir.yml b/content/ko/docs/2.for-users/_dir.yml new file mode 100644 index 00000000..cf03de43 --- /dev/null +++ b/content/ko/docs/2.for-users/_dir.yml @@ -0,0 +1 @@ +title: "Misskey 유저용" diff --git a/content/ko/docs/3.for-admin/_dir.yml b/content/ko/docs/3.for-admin/_dir.yml new file mode 100644 index 00000000..ace8a88f --- /dev/null +++ b/content/ko/docs/3.for-admin/_dir.yml @@ -0,0 +1,2 @@ +title: "서버 운영자를 위한" +description: "서버 생성 방법 및 운영 시 유용한 정보를 공개 중입니다." diff --git a/content/ko/docs/3.for-admin/features/announcement.md b/content/ko/docs/3.for-admin/features/announcement.md index 4108e802..1f5b09e4 100644 --- a/content/ko/docs/3.for-admin/features/announcement.md +++ b/content/ko/docs/3.for-admin/features/announcement.md @@ -6,11 +6,12 @@ :::warning -활성화된 공지사항의 수가 많으면 특히 새 사용자의 확인 활동이 늘어나 사용자 경험이 줄어들 가능성이 있습니다.이 경우, 아래와 같이 검토할 수 있습니다. +활성화된 공지사항의 수가 많으면 특히 새 사용자의 확인 활동이 늘어나 사용자 경험이 줄어들 가능성이 있습니다.이 경우, 아래와 같이 검토할 수 있습니다.이 경우, 아래와 같이 검토할 수 있습니다. - "기존 유저만" 옵션을 켜고 공지사항을 작성하기 - "알림 없음" 옵션을 켜고 공지사항을 작성하기 - 이전의 공지사항을 저장하기 + ::: ::: @@ -21,8 +22,7 @@ - **일반** ... 공지사항 목록 페이지에 공지사항이 등록됩니다. - **배너** ... 공지사항 목록 페이지에 올린 글에 더해서, 클라이언트 화면 위에 배너로도 표시할 수 있습니다. - **다이얼로그** ... 공지사항 목록 페이지에 올린 글에 더해서, 클라이언트를 켰을 때 모달 다이얼로그로도 표시할 수 있습니다. - - 다이얼로그 형식의 공지사항이 동시에 2개 이상 있는 경우, UX에 악영향을 끼칠 가능성이 매우 높습니다. 이렇게 하실 땐 신중하게 적용하시길 바랍니다. + - 다이얼로그 형식의 공지사항이 동시에 2개 이상 있는 경우, UX에 악영향을 끼칠 가능성이 매우 높습니다. ## 공지사항 작성 -TODO diff --git a/content/ko/docs/3.for-admin/features/role.md b/content/ko/docs/3.for-admin/features/role.md index b329f77f..9f1010a4 100644 --- a/content/ko/docs/3.for-admin/features/role.md +++ b/content/ko/docs/3.for-admin/features/role.md @@ -16,9 +16,9 @@ 할당 방법은 매뉴얼 또는 조건부 설정에서 선택할 수 있습니다. -- **수동** ... 수동으로 유저에게 할당시키거나 해제할 수 있습니다.(수동 역할) - - 할당 되어지는 기간을 따로 설정할 수 있습니다. -- **조건부 역할** ... 조건을 설정하여 이에 맞는 유저가 자동으로 역할을 부여받게 됩니다.(조건부 역할) +- **수동** ... 수동으로 유저에게 할당시키거나 해제할 수 있습니다.(수동 역할)(수동 역할) + - 부여할 때 부여되는 기간에 대해서도 설정할 수 있습니다. +- **조건부 역할** ... 조건을 설정하여 이에 맞는 유저가 자동으로 역할을 부여받게 됩니다.(조건부 역할)(조건부 역할) :::warning @@ -34,7 +34,7 @@ 역할의 기본적인 권한은 아래에서 선택하실 수 있습니다. - **일반 유저** ... 특별한 권한은 없습니다. -- **모더레이터** ... 일반적인 모더레이션 조작을 할 수 있습니다. +- **모더레이터** ... 일반적인 관리에 대한 조작을 할 수 있습니다. - **관리자** ... 서버에 있는 모든 권한을 변경할 수 있습니다. 좀 더 자세한 권한은 정책 설정에서 할 수 있습니다. @@ -48,11 +48,10 @@ ### 우선 순위 여러 개의 역할이 할당되어 하나의 정책이 서로 다른 값으로 설정되어져 있는 경우에, 이러한 것들을 얼마나 우선할건지 설정할 수 있습니다. -물론, 우선도를 높게 설정한 정책이 우선 되어집니다. -우선도는 각각의 정책에 할 수 있는 설정이지, 각 역할에 대한 설정이 아닙니다.또한, 기본 역할에서는 이를 설정할 수 없습니다. +우선도는 각각의 정책에 할 수 있는 설정이지, 각 역할에 대한 설정이 아닙니다.또한, 기본 역할에서는 이를 설정할 수 없습니다.\*\* -**우선도가 같은 경우, 기본적으로 제일 크거나 제일 권한이 넓은 값이 자동으로 선택됩니다.** +**우선도가 같은 경우, 기본적으로 제일 크거나 제일 권한이 넓은 값이 자동으로 선택됩니다.**::: :::tip @@ -65,11 +64,10 @@ - 우선도가 같거나 또는 역할 D의 공개 노트 가능 정책의 우선도가 높은 경우 "예" 값이 적용됩니다. - 역할 C의 공개 노트 가능 정책 우선도가 높은 경우 "아니오" 값이 적용됩니다. -::: ::: -### 기본 정책 값을 사용 +### 기본 역할 값을 사용 이 설정을 활성화하면, 정책 값을 기본 역할에서 받아올 수 있습니다. @@ -79,19 +77,19 @@ ## 역할 정보의 확인, 편집 및 삭제 -제어판의 "역할" 메뉴에서 할 수 있습니다. +기본 역할 설정은 제어판의 "역할→기본 역할"에서 할 수 있습니다. ## 유저에게 역할 부여하기, 해제하기 -유저의 "모더레이션→역할"에서 하실 수 있습니다. +또한, 유저의 메뉴에서 직접 부여할 수도 있습니다. 또한, 유저의 메뉴에서 직접 부여할 수도 있습니다. -부여할 때 부여되는 기간에 대해서도 설정할 수 있습니다. +할당 되어지는 기간을 따로 설정할 수 있습니다. :::tip -역할의 부여하기/해제하기가 반영될 떄까지 시간이 걸리는 경우가 있습니다. +역할의 부여/해제가 반영되기까지 시간이 걸릴 수 있습니다. ::: diff --git a/content/ko/docs/3.for-admin/install/_dir.yml b/content/ko/docs/3.for-admin/install/_dir.yml new file mode 100644 index 00000000..fb216df5 --- /dev/null +++ b/content/ko/docs/3.for-admin/install/_dir.yml @@ -0,0 +1,2 @@ +title: "Misskey 설치 및 유지관리" +description: "Misskey의 설치 방법 및 이후 유지관리 작업에 도움이 되는 정보를 제공합니다." diff --git a/content/ko/docs/3.for-admin/install/guides/1.index.md b/content/ko/docs/3.for-admin/install/guides/1.index.md index 53ee2ccf..3e672a77 100644 --- a/content/ko/docs/3.for-admin/install/guides/1.index.md +++ b/content/ko/docs/3.for-admin/install/guides/1.index.md @@ -4,7 +4,7 @@ description: Misskey 서버를 만드는 방법에 대해서 안내합니다. # Misskey 서버 만들기 -Misskey 서버 구축에 관심을 가져주셔서 감사합니다.서버를 만드는 방법은 여러가지가 있으므로, 아래 중에서 가이드를 골라서 읽어주세요. +Misskey 서버 구축에 관심을 가져주셔서 감사합니다.서버를 만드는 방법은 여러가지가 있으므로, 아래 중에서 가이드를 골라서 읽어주세요.서버를 만드는 방법은 여러가지가 있으므로, 아래 중에서 가이드를 골라서 읽어주세요. :::danger @@ -20,6 +20,8 @@ Misskey의 소스 코드는 이미 Minify되어져 있으므로, 의미가 없 자세한 것은 [misskey-dev/misskey #9791](https://github.com/misskey-dev/misskey/issues/9791) 를 확인하세요. +::: + ## Xserver VPS에서 설치하기 [Xserver VPS](https://vps.xserver.ne.jp/)에서는 Misskey의 애플리케이션 이미지가 기본적으로 구비되어 있으므로, 간단하게 Misskey 서버를 만들 수 있습니다. diff --git a/content/ko/docs/3.for-admin/install/guides/bash.md b/content/ko/docs/3.for-admin/install/guides/bash.md index 546f11ba..0e863329 100644 --- a/content/ko/docs/3.for-admin/install/guides/bash.md +++ b/content/ko/docs/3.for-admin/install/guides/bash.md @@ -31,6 +31,8 @@ Let's Encrypt 인증을 할 수 있는 횟수가 적으므로, 서버의 네트 Cloudflare를 사용하는 경우, Cloudflare에서 도메인 설정을 끝낸 뒤에 설치를 하시길 바랍니다.\ \ +네임 서버 설정이 각 DNS에 전파될 때까지 최대 3일 정도 걸리는 경우가 있습니다.\ +\ 네임 서버 설정이 각 DNS에 전파될 때까지 최대 3일 정도 걸리는 경우가 있습니다. 또한, nginx와 Cloudflare를 설정하는 경우, Cloudflare의 설정 화면에서, @@ -40,11 +42,13 @@ Cloudflare를 사용하는 경우, Cloudflare에서 도메인 설정을 끝낸 ## 조작 -### 1. SSH +### 1. 최신 환경으로 하기 서버에 SSH로 연결합니다.\ \ -(서버 화면을 직접 보고 계신 분은 터미널을 열어주세요.) +(서버 화면을 직접 보고 계신 분은 터미널을 열어주세요.)\ +\ +(서버 화면을 직접 보고 계신 분은 터미널을 열어주세요.） ### 2. 최신 환경으로 하기 @@ -70,7 +74,7 @@ example.com은 자신의 도메인으로 바꿔주세요. 업데이트를 위한 스크립트도 있습니다. -업데이트 스크립트는, 서버 환경의 업데이트와는 관계가 없습니다.CHANGELOG(일본어) 및 [GitHub 릴리즈 목록 (영어)](https://github.com/joinmisskey/bash-install/releases)를 참고하여, 필요에 따라 마이그레이션을 해주세요. +업데이트 스크립트는, 서버 환경의 업데이트와는 관계가 없습니다.CHANGELOG(일본어) 및 [GitHub 릴리즈 목록 (영어)](https://github.com/joinmisskey/bash-install/releases)를 참고하여, 필요에 따라 마이그레이션을 해주세요.위의 환경에서 정상적으로 움직이지 않는 경우, 버그인 경우가 있습니다.설치 했을 때 사용했던 조건들을 적고, GitHub의 Issue에서 알려주시길 바랍니다. 모든 다운로드부터 시작합니다. @@ -106,7 +110,7 @@ iptables를 쓸 수 있게 설정하세요. 기능 제안에 대해서도 환영하고 있습니다. -# Tips +# Systemd or Docker? 선택지를 고르는 방법이나 사양에 대해서 등. @@ -116,12 +120,21 @@ v1부터 설치 메소드에 systemd와 Docker 등을 고를 수 있게 되었 Docker라고 했지만, **Misskey만 Docker에서 실행**하고, Redis나 Postgres 등은 호스트에서 직접 실행합니다.\ \ -[docker-compose에서 모든 기능을 움직이는 방법에 대해선, mamemononga님이 작성하긴 이 포스트를 추천합니다.](https://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0) +[docker-compose에서 모든 기능을 움직이는 방법에 대해선, mamemononga님이 작성하긴 이 포스트를 추천합니다.](https://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0)\ +Docker인 경우에 만들어집니다.\ +\ +실행되고 있는 컨테이너와 이미지 번호를 저장하고 있습니다.\ +\ +컨테이너 번호는 업데이트 할 때 바뀌어집니다.오래된 이미지는 삭제됩니다.](https\://gist.github.com/mamemomonga/5549bb69cad8e5618e5527593d4890e0) Docker Hub 이미지를 사용하는 설정이라면, Misskey를 빌드할 필요가 없으므로, **제일 추천하고 있습니다**.\ \ 하지만, 마이그레이션 작업이 필요하므로, 업데이트 할 때 Misskey를 쓰지 못하는 시간이 사라지는 것은 아닙니다.\ \ +또한 Misskey의 빌드 환경을 준비하지 않으므로(git pull을 안함), 포크해서 움직이게 하고 싶을 땐 설정이 많이 어려워집니다.\ +\ +하지만, 마이그레이션 작업이 필요하므로, 업데이트 할 때 Misskey를 쓰지 못하는 시간이 사라지는 것은 아닙니다.\ +\ 또한 Misskey의 빌드 환경을 준비하지 않으므로(git pull을 안함), 포크해서 움직이게 하고 싶을 땐 설정이 많이 어려워집니다. 로컬에서 Docker를 빌드하는 방식은, 퍼포먼스적으로는 권장하지 않고 있습니다. @@ -140,7 +153,7 @@ systemd는, Docker Hub에 이미지를 올리지는 않지만, 포크를 사용 로드 밸런서를 설치한 경우엔 nginx를 설치하지 말고, [Misskey의 nginx 설정](../resources/nginx/)을 참고하여 로드 밸런서를 설정하는 편이 나을거라고 생각합니다. -## Add more swaps! +## 한 번 실패한 뒤에 다시 스크립트를 실행하는 경우 스왑을 설정하고 있는 경우, 메모리가 합쳐서 3GB 이상이지 않으면 스크립트가 움직이지 않게 되어져 있습니다. @@ -149,6 +162,8 @@ systemd는, Docker Hub에 이미지를 올리지는 않지만, 포크를 사용 혹시라도 한 번 실패한 상태로 다시 한 번 스크립트를 실행한 경우, 다음 내용에 주의하시길 바랍니다. - Redis나 Postgres의 설치가 끝난 경우, "install locally"는 No로 해야합니다.\ + \ + host・port 설정은 그대로 Enter를 누릅니다.\ \ host・port 설정은 그대로 Enter를 누릅니다. 유저명이나 비밀번호는 전에 실행했을 때 정했던 것을 입력합니다. @@ -157,14 +172,17 @@ systemd는, Docker Hub에 이미지를 올리지는 않지만, 포크를 사용 인스톨 스크립트는, 2개의 .env 파일을 만듭니다.\ \ +업데이트 할 때 사용합니다.\ +\ 업데이트 할 때 사용합니다. -### /root/.misskey.env +### /home/(misskey 유저)/.misskey.env misskey를 실행할 유저를 기억하기 위해 필요합니다. ### /home/(misskey 유저)/.misskey.env +Docker인 경우에 만들어집니다.\ systemd인 경우에 만들어집니다.\ \ 주로 디렉토리를 기억하는데 사용합니다. @@ -187,7 +205,8 @@ Docker인 경우에 만들어집니다.\ Misskey 소스는 `/home/유저명/디렉토리`로 clone 되어집니다.\ \ -(유저, 디렉토리의 초기 값은 둘 다 misskey 입니다.) +(유저, 디렉토리의 초기 값은 둘 다 misskey 입니다.)\ +유저명이나 비밀번호는 전에 실행했을 때 정했던 것을 입력합니다.） Misskey 디렉토리는, 아래와 같이 이동하는 것을 추천합니다. @@ -206,10 +225,11 @@ exit systemd의 프로세스명은 example.com 입니다.\ \ -예를 들어서 다시 시작하려면 다음과 같이하면 됩니다. +예를 들어서 다시 시작하려면 다음과 같이하면 됩니다.\ +한 줄로 하고 싶을 땐 아래와 같이 하시면 됩니다. ``` -sudo systemctl restart example.com +journalctl -t example.com ``` journalctl에서 로그를 확인할 수 있습니다. @@ -250,7 +270,7 @@ docker logs --tail 50 -f 컨테이너ID sudo -u 유저명 XDG_RUNTIME_DIR=/run/user/$(id -u 유저명) DOCKER_HOST=unix:///run/user/$(id -u 유저명)/docker.sock docker ps ``` -### nginx +### Redis nginx 설정은 `/etc/nginx/conf.d/example.com.conf`에 저장되어져 있습니다. @@ -262,6 +282,8 @@ requirepass와 bind를 `/etc/redis/misskey.conf`로 설정하고 있습니다. Docker에서는, 부팅 후 마이그레이션 작업을 하기 위해 바로 접속할 수 없습니다.\ \ +마이그레이션이 끝나있는지 확인해보시길 바랍니다.\ +\ 마이그레이션이 끝나있는지 확인해보시길 바랍니다. systemd인 경우, pnpm install에서 실패되어져 있는 경우가 있습니다. @@ -272,10 +294,12 @@ Misskey 디렉토리에서 다음의 내용을 실행해서, 한 번 더 업데 pnpm run clean-all ``` -journalctl으로 로그를 확인해보면, 대부분 re2... 로 시작하는 내용이 보입니다. +journalctl으로 로그를 확인해보면, 대부분 re2... ## Q. 같은 서버에 Misskey 인스턴스를 하나 더 열고 싶어요. 스크립트가 같은 서버에 추가로 Misskey를 설치하는 것을 상정하고 만들어져 있진 않습니다.\ \ +여러가지 설정이 덮어 씌여지거나, 도중에 에러가 날 수도 있습니다.\ +\ 여러가지 설정이 덮어 씌여지거나, 도중에 에러가 날 수도 있습니다. diff --git a/content/ko/docs/3.for-admin/install/guides/docker.md b/content/ko/docs/3.for-admin/install/guides/docker.md index 093f54b2..1865dbc0 100644 --- a/content/ko/docs/3.for-admin/install/guides/docker.md +++ b/content/ko/docs/3.for-admin/install/guides/docker.md @@ -16,14 +16,11 @@ description: 이 가이드는 Docker를 사용하여 Misskey를 설정하는 방 - Docker 및 Docker Compose가 설치되어 있어야 합니다. -:::. +::: -## 설정 +## 리포지토리 가져오기 ```sh -git clone -b master https://github.com/misskey-dev/misskey.git -cd misskey -git checkout master ``` ## 설정 @@ -31,23 +28,16 @@ git checkout master 아래 명령어로 각종 설정 파일 샘플을 복사합니다. ```sh -cp .config/docker_example.yml .config/default.yml -cp .config/docker_example.env .config/docker.env -cp ./docker-compose_example.yml ./docker-compose.yml ``` `default.yml`과 `docker.env`를 파일 내 설명에 따라 편집합니다.\ -\ -또한 필요에 따라 `docker-compose.yml`을 편집합니다.(포트를 변경하고 싶은 경우 등) +또한, 필요에 의해서 `docker-compose.yml`을 편집합니다.(포트를 변경하고 싶은 경우 등) ## 빌드 및 초기화 다음 명령어로 Misskey를 빌드하고 데이터베이스를 초기화합니다. -이 작업은 시간이 좀 걸립니다. ```shell -sudo docker compose build -sudo docker compose run --rm web pnpm run init ``` ## 실행 @@ -55,10 +45,9 @@ sudo docker compose run --rm web pnpm run init 수고하셨습니다.아래 명령어로 Misskey를 실행할 수 있습니다. ```sh -sudo docker compose up -d ``` -GLHF✨ + ## Misskey 업데이트 방법 @@ -69,13 +58,6 @@ GLHF✨ ::: ```sh -git stash -git checkout master -git pull -git submodule update --init -git stash pop -sudo docker compose build -sudo docker compose stop && sudo docker compose up -d ``` 업데이트 내용 및 데이터베이스 규모에 따라 시간이 걸릴 수 있습니다. @@ -83,5 +65,4 @@ sudo docker compose stop && sudo docker compose up -d ## cli 명령을 실행하는 방법 ```sh -sudo docker compose run --rm web node packages/backend/built/tools/foo bar ``` diff --git a/content/ko/docs/3.for-admin/install/guides/kubernetes.md b/content/ko/docs/3.for-admin/install/guides/kubernetes.md index 053a0ccb..2a1917aa 100644 --- a/content/ko/docs/3.for-admin/install/guides/kubernetes.md +++ b/content/ko/docs/3.for-admin/install/guides/kubernetes.md @@ -18,7 +18,7 @@ Misskey의 HelmCharts는 TrueNAS Scale에서 사용할 수 있도록 TrueCharts 현재 Misskey는 _incubator_ train을 진행 중입니다. -:::tip{label='前提条件'} +:::前提条件 - TrueNAS Scale 또는 diff --git a/content/ko/docs/3.for-admin/install/guides/manual.md b/content/ko/docs/3.for-admin/install/guides/manual.md index 768d2989..49f4be80 100644 --- a/content/ko/docs/3.for-admin/install/guides/manual.md +++ b/content/ko/docs/3.for-admin/install/guides/manual.md @@ -34,7 +34,6 @@ sudo corepack enable ## 사용자 생성 Misskey는 루트 사용자로 실행하지 않는 것이 좋으므로, 대신 사용자를 생성합니다. -데비안 예시: ```sh sudo -iu misskey @@ -45,7 +44,7 @@ git submodule update --init NODE_ENV=production pnpm install --frozen-lockfile ``` -## 설정 +## misskey 서비스 시작 ```sh sudo -iu misskey @@ -64,13 +63,11 @@ NODE_ENV=production pnpm install --frozen-lockfile cp .config/example.yml .config/default.yml ``` -다음 명령어로 Misskey를 빌드하고 데이터베이스를 초기화합니다. -이 작업은 시간이 좀 걸립니다. +파일 내 지침에 따라 `default.yml`을 편집합니다. ## 빌드 및 초기화 다음 명령어로 Misskey를 빌드하고 데이터베이스를 초기화합니다. -이 작업은 시간이 좀 걸립니다. ```sh NODE_ENV=production pnpm run build @@ -79,7 +76,7 @@ pnpm run init ## 실행 -수고하셨습니다.아래 명령어로 Misskey를 실행할 수 있습니다. +수고하셨습니다.수고하셨습니다.아래 명령어로 Misskey를 실행할 수 있습니다. ```sh NODE_ENV=production pnpm run start @@ -89,7 +86,7 @@ systemd 서비스 파일 생성하기 `/etc/systemd/system/misskey.service` -편집기에서 열어, 다음 코드를 붙여넣고 저장합니다. +systemd 서비스 파일 생성하기 `/etc/systemd/system/misskey.service` @@ -175,5 +172,6 @@ sudo systemctl restart misskey - `pnpm run clean` 또는 `pnpm run clean-all`을 실행합니다. - `pnpm rebuild` + ::: ::: diff --git a/content/ko/docs/3.for-admin/install/guides/ubuntu-manual.md b/content/ko/docs/3.for-admin/install/guides/ubuntu-manual.md index 25c63ec0..2528fbd7 100644 --- a/content/ko/docs/3.for-admin/install/guides/ubuntu-manual.md +++ b/content/ko/docs/3.for-admin/install/guides/ubuntu-manual.md @@ -2,7 +2,7 @@ ## 기타 Misskey 설치 방법 -- [기본 버전 Misskey 구축 가이드 (manual)](. /manual/) +- [기본 버전 Misskey 구축 가이드 (manual)](. - [기타 설치 방법 목록](/docs/for-admin/install/guides/#설치 방법 목록) ## 쉘 스크립트 안내 @@ -36,11 +36,11 @@ ::: -## 소개 +## 환경 및 조건 이 글에서는 [Misskey 구축 가이드 (manual)](./manual/)을 바탕으로 일반적인 우분투 서버에 Misskey를 설치하고 공개하는 방법을 하나하나 설명합니다. -Bash 명령어 입력과 몇 가지 설정 파일 편집, 그리고 브라우저 조작만으로 설정이 완료될 수 있도록 했습니다.설치해야 할 소프트웨어에 대해 간략하게 설명하고 있지만, 크게 신경 쓸 필요는 없습니다. +Bash 명령어 입력과 몇 가지 설정 파일 편집, 그리고 브라우저 조작만으로 설정이 완료될 수 있도록 했습니다.설치해야 할 소프트웨어에 대해 간략하게 설명하고 있지만, 크게 신경 쓸 필요는 없습니다.설치해야 할 소프트웨어에 대해 간략하게 설명하고 있지만, 크게 신경 쓸 필요는 없습니다. 이 글에서는 구체성을 중시하여 특정 환경에 특화된 설명을 하고 있습니다. @@ -51,11 +51,12 @@ OS의 차이, Misskey 본체나 의존하는 소프트웨어의 버전업으로 ## 환경 및 조건 - OS는 **Ubuntu 22.04.1 LTS**를 사용합니다. -- 하드웨어 요구 사항으로 CPU는 최신 제품이라면 최소사양으로도 작동합니다.아키텍처는 amd64 및 arm64를 가정합니다. -- 메모리는 1.5GB 정도면 충분합니다.(Vite 도입 등으로 1.5GB 정도도 빌드 가능해짐) +- 클라우드의 경우에도 네트워크 설정에서 포트 개방이 필요한 경우가 많습니다.하드웨어 요구 사항으로 CPU는 최신 제품이라면 최소사양으로도 작동합니다.아키텍처는 amd64 및 arm64를 가정합니다. +- メモリは4GB程度あると良い。 + - （従来Viteの導入により1.5GB程度でもビルド可能と説明していたが、最近またフロントエンドのビルドで要件が厳しくなってきた。） - 자체 도메인을 구입하고 CloudFlare를 사용하세요. - 도메인은 [Google Domains](https://domains.google/intl/ja_jp/) 등에서 미리 준비해야 합니다. -- 여기서는 도메인을 example.tld로 설명할 것이므로, 자신이 구입한 도메인으로 적절히 대체하여 읽도록 합니다.개발 환경의 경우 localhost로 대체합니다(설정 파일 항목에서 별도 설명). +- 여기서는 도메인을 example.tld로 설명할 것이므로, 자신이 구입한 도메인으로 적절히 대체하여 읽도록 합니다.개발 환경의 경우 localhost로 대체합니다(설정 파일 항목에서 별도 설명).개발 환경의 경우 localhost로 대체합니다(설정 파일 항목에서 별도 설명). :::danger @@ -65,7 +66,7 @@ OS의 차이, Misskey 본체나 의존하는 소프트웨어의 버전업으로 ## nano 사용법 -이번에는 텍스트 편집기로 nano를 사용합니다.다음과 같이 실행합니다. +이번에는 텍스트 편집기로 nano를 사용합니다.다음과 같이 실행합니다.다음과 같이 실행합니다. ```sh nano /path/to/file @@ -95,7 +96,7 @@ sudo adduser --disabled-password --disabled-login misskey 기본적인 소프트웨어를 설치합니다. -### Node.js +### 사용자 및 데이터베이스 생성 Node.js는 서버사이드 자바스크립트 환경으로 Misskey의 기본 실행 환경입니다. @@ -113,7 +114,7 @@ node -v sudo corepack enable ``` -v20.x.x 등으로 표시되면 OK.v8.x.x와 같이 낮은 버전이 표시되면 제대로 설치가 되지 않은 것이므로 서버를 재부팅하고 다시 설치하는 등 다시 한 번 시도해 봅니다. +Misskey에서 사용할 사용자를 생성합니다.v20.x.x 등으로 표시되면 OK.v8.x.x와 같이 낮은 버전이 표시되면 제대로 설치가 되지 않은 것이므로 서버를 재부팅하고 다시 설치하는 등 다시 한 번 시도해 봅니다. ### PostgreSQL @@ -132,7 +133,7 @@ sudo sh /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh -i -v 15; systemctl status postgresql ``` -active라면 OK. +active라면 OK.그렇지 않은 경우 다음 명령을 실행합니다. #### 사용자 및 데이터베이스 생성 @@ -144,13 +145,15 @@ sudo -u postgres psql Misskey에서 사용할 사용자를 생성합니다.\ 사용자 이름을 misskey, 비밀번호를 hoge로 설정하면 다음과 같습니다.\ +(리눅스 사용자와 PostgreSQL 사용자는 별개이므로 혼동하지 않도록 주의.）\ +사용자 이름을 misskey, 비밀번호를 hoge로 설정하면 다음과 같습니다.\ (리눅스 사용자와 PostgreSQL 사용자는 별개이므로 혼동하지 않도록 주의.） ```sql CREATE ROLE misskey LOGIN PASSWORD 'hoge'; ``` -데이터베이스를 생성합니다.데이터베이스 이름을 mk1이라고 합니다. +소개데이터베이스를 생성합니다.데이터베이스 이름을 mk1이라고 합니다. ```sql CREATE DATABASE mk1 OWNER misskey; @@ -159,32 +162,27 @@ CREATE DATABASE mk1 OWNER misskey; ### Redis -Redis는 NoSQL의 인메모리 데이터베이스 소프트웨어로, 데이터베이스 및 연합과의 통신 관리 등을 위해 필요합니다. -redis.io의 문서에 따라 설치합니다. https\://redis.io/docs/getting-started/installation/install-redis-on-linux/ +Redis는 NoSQL의 인메모리 데이터베이스 소프트웨어로, 데이터베이스 및 연합과의 통신 관리 등을 위해 필요합니다.\ +redis.ioのドキュメントに従い、snapでインストールする。 + +https\://redis.io/docs/getting-started/installation/install-redis-on-linux/ ```sh -sudo apt install -y curl ca-certificates gnupg2 lsb-release - -curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg - -echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list - -sudo apt update - -sudo apt install -y redis +sudo snap install redis ``` -systemctl로 데몬의 상태를 확인합니다. +systemctl로 데몬 상태 확인. ```sh -systemctl status redis-server +systemctl status nginx ``` -active라면 OK. +active이면 OK. ### nginx -nginx는 주로 리버스 프록시에 사용되는 웹 서버 소프트웨어입니다.Misskey에 필수적인 것은 아니지만, 캐시 등을 하면 성능이 향상되고 http에서 https로 전송하는 등의 작업을 위해 설치해 둡니다. +nginx는 주로 리버스 프록시에 사용되는 웹 서버 소프트웨어입니다.Misskey에 필수적인 것은 아니지만, 캐시 등을 하면 성능이 향상되고 http에서 https로 전송하는 등의 작업을 위해 설치해 둡니다.\ +curl에서 확인하는 것도 좋은 방법입니다. :::tip @@ -195,7 +193,7 @@ nginx는 주로 리버스 프록시에 사용되는 웹 서버 소프트웨어 nginx.org의 문서 http\://nginx.org/en/linux_packages.html#Ubuntu 에 따라 설치합니다. ```sh -sudo apt install ubuntu-keyring +sudo apt install -y curl ca-certificates gnupg2 lsb-release ubuntu-keyring curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null @@ -214,25 +212,33 @@ sudo apt update sudo apt install -y nginx ``` -systemctl로 데몬 상태 확인. +systemctl로 데몬 상태를 확인합니다.실행에 시간이 조금 걸리므로 15초 정도 기다렸다가 시작하는 것이 좋습니다. ```sh systemctl status nginx ``` -active라면 OK.그렇지 않은 경우 다음 명령을 실행합니다. +active라면 OK.복사, 붙여넣기만 하면 쉘 스크립트로 하면 되지 않겠느냐는 생각으로 **쉘 스크립트로 거의 모든 것을 해주는 방법을 만들어 보았습니다!**\ +[**쉘 스크립트에 대한 자세한 내용과 사용법은 여기에서 확인하세요!**](./bash/) ```sh -sudo systemctl start nginx +sudo ufw enable -sudo systemctl enable nginx +sudo ufw default deny + +sudo ufw limit 22 + +sudo ufw allow 80 + +sudo ufw allow 443 ``` http\://localhost에 접속하여 \*Welcome to nginx!\*라고 표시되면 OK.\ +curl에서 확인하는 것도 좋은 방법입니다.\ curl에서 확인하는 것도 좋은 방법입니다. ```sh -curl http://localhost +sudo ufw status ``` ### 기타 @@ -257,20 +263,12 @@ sudo apt install -y git build-essential ### 방화벽 -이번에는 방화벽으로 ufw를 사용합니다. +HTTPS･WSS 통신에 사용할 인증서를 CloudFlare를 사용하는 방식으로 Let's Encrypt에서 발급받습니다. 다음은 접속 허용을 화이트리스트 형식으로 하여 22번 SSH 포트를 접속 횟수 제한을 두어 개방하고, 80번 HTTP 포트와 443번 HTTPS 포트를 개방했습니다. ```sh -sudo ufw enable - -sudo ufw default deny - -sudo ufw limit 22 - -sudo ufw allow 80 - -sudo ufw allow 443 +sudo apt install -y certbot python3-certbot-dns-cloudflare ``` ufw의 상태를 확인합니다. @@ -282,20 +280,20 @@ sudo ufw status systemctl로 영구화합니다. ```sh -sudo systemctl enable ufw +mkdir /etc/cloudflare +nano /etc/cloudflare/cloudflare.ini ``` :::tip -ufw는 넷필터(iptables)를 사람이 쉽게 조작할 수 있도록 하는 앱입니다.설치 스크립트는 OCI 환경에서는 netfilter를 직접 조작합니다. +이번에는 방화벽으로 ufw를 사용합니다.ufw는 넷필터(iptables)를 사람이 쉽게 조작할 수 있도록 하는 앱입니다.설치 스크립트는 OCI 환경에서는 netfilter를 직접 조작합니다. ::: ### CloudFlare CloudFlare는 자신의 도메인에 대해 DNS 서버, 리버스 프록시, CDN을 한 번에 제공해 주는 매우 편리한 서비스입니다.\ -CloudFlare를 경유하지 않고 서버를 공개하는 것도 가능하지만, 매우 편리하기 때문에 도입하는 것이 좋습니다. -[**→ CDN 설정**](../resources/cdn/) +CloudFlare를 경유하지 않고 서버를 공개하는 것도 가능하지만, 매우 편리하기 때문에 도입하는 것이 좋습니다.[**→ CDN 설정**](../resources/cdn/) [CloudFlare에 가입(https\://dash.cloudflare.com/sign-up)하고, 구매한 도메인을 안내에 따라 등록합니다. @@ -310,10 +308,10 @@ HTTPS･WSS 통신에 사용할 인증서를 CloudFlare를 사용하는 방식 certbot과 CloudFlare 플러그인 설치하기 ```sh -sudo apt install -y certbot python3-certbot-dns-cloudflare +sudo su - misskey ``` -Cloudflare의 API 키를 얻습니다.아래 절차에 따라 취득합니다. +Cloudflare의 API 키를 얻습니다.아래 절차에 따라 취득합니다.아래 절차에 따라 취득합니다. 1. https\://dash.cloudflare.com/profile/api-tokens에 접속 2. Global API Key의 View 선택 @@ -322,8 +320,7 @@ Cloudflare의 API 키를 얻습니다.아래 절차에 따라 취득합니다. CloudFlare의 정보를 담은 설정 파일 /etc/cloudflare/cloudflare.ini를 생성합니다. ```sh -mkdir /etc/cloudflare -nano /etc/cloudflare/cloudflare.ini +NODE_ENV=production pnpm install --frozen-lockfile ``` dns_cloudflare_email(아래 예에서는 bar\@fuga.foo)에는 CloudFlare에 등록한 이메일 주소를 설정합니다. @@ -336,22 +333,22 @@ dns_cloudflare_api_key = xxxxxxxxxxxxxxxxxxxxxxxxxx 이를 저장하고 권한을 600으로 설정합니다. ```sh -sudo chmod 600 /etc/cloudflare/cloudflare.ini +nano .config/default.yml ``` -준비가 되었으니 명령을 실행합니다.**중간에 있는 2곳의 example.tld는 자신의 것으로 교체**. +다음 내용을 붙여넣고 적절하게 바꿉니다.준비가 되었으니 명령을 실행합니다.**중간에 있는 2곳의 example.tld는 자신의 것으로 교체**. ```sh sudo certbot certonly --dns-cloudflare --dns-cloudflare-credentials /etc/cloudflare/cloudflare.ini --dns-cloudflare-propagation-seconds 60 --server https://acme-v02.api.letsencrypt.org/directory -d example.tld -d *.example.tld ``` -\*Congratulations!\*라고 표시되면 OK.생성된 .pem 파일의 경로는 나중에 사용할 것이므로 기록해 두어야 합니다. +\*Congratulations!\*라고 표시되면 OK.\*Congratulations!\*라고 표시되면 OK.생성된 .pem 파일의 경로는 나중에 사용할 것이므로 기록해 두어야 합니다. 자동 업데이트 설정은 설치와 동시에 이루어지기 때문에 불필요합니다. ## Misskey 설치하기 -이제 사전 준비는 어느 정도 끝났으니 미스키를 준비할 차례입니다. +지정이 완료되면 저장합니다. misskey 사용자로 변경. @@ -362,17 +359,13 @@ sudo su - misskey Git으로 파일들을 전개. ```sh -git clone -b master https://github.com/misskey-dev/misskey.git --recurse-submodules - -cd misskey - -git checkout master +exit ``` 필요한 npm 패키지를 설치합니다. ```sh -NODE_ENV=production pnpm install --frozen-lockfile +sudo nano /etc/nginx/conf.d/misskey.conf ``` ## Misskey 구성하기 @@ -385,7 +378,7 @@ NODE_ENV=production pnpm install --frozen-lockfile nano .config/default.yml ``` -다음 내용을 붙여넣고 적절하게 바꿉니다.설정값의 변경이 필요한 부분은 ●, 지금까지의 흐름에서 설정된 값을 사용하는 부분은 ○으로 표시하였습니다. +다음 내용을 붙여넣고 적절하게 바꿉니다.다음 내용을 붙여넣고 적절하게 바꿉니다.설정값의 변경이 필요한 부분은 ●, 지금까지의 흐름에서 설정된 값을 사용하는 부분은 ○으로 표시하였습니다. 이 설정 파일은 YAML 형식으로 작성되어 있으며, 줄의 시작 부분의 띄어쓰기 등을 잘못하면 Misskey가 동작하지 않으므로 특히 주의해야 합니다. @@ -398,26 +391,26 @@ nano .config/default.yml ::: ```yml -# ● Misskey를 공개할 URL +# ● Misskeyを公開するURL url: https://example.tld/ -# 포트를 3000으로 설정한다. +# ポートを3000とする。 port: 3000 -# ● PostgreSQL 설정。 +# ● PostgreSQLの設定。 db: host: localhost port: 5432 - db : mk1 # 〇 PostgreSQL의 데이터베이스 이름 - user: misskey # 〇 PostgreSQL 사용자 이름 - pass: hoge # ● PostgreSQL 패스워드 + db : mk1 # 〇 PostgreSQLのデータベース名 + user: misskey # 〇 PostgreSQLのユーザー名 + pass: hoge # ● PostgreSQLのパスワード -# Redis 설정. +# Redisの設定。 redis: host: localhost port: 6379 -# ID 유형 설정. -id: 'aid' +# IDタイプの設定。 +id: 'aidx' # syslog syslog: @@ -469,7 +462,7 @@ sudo systemctl restart nginx sudo systemctl status nginx ``` -active이면 OK. +active라면 OK. ## Misskey 빌드 @@ -479,7 +472,7 @@ misskey 사용자로 다시 로그인합니다. sudo su - misskey ``` -빌드합니다.네, 할 수 있습니다... +빌드합니다.네, 할 수 있습니다...네, 할 수 있습니다... ```sh cd misskey @@ -488,7 +481,7 @@ NODE_ENV=production pnpm run build :::tip -개발 환경의 경우 `NODE_ENV=production`은 필요하지 않습니다.이후 명령어에서도 마찬가지로 삭제해 주세요. +개발 환경의 경우 `NODE_ENV=production`은 필요하지 않습니다.이후 명령어에서도 마찬가지로 삭제해 주세요.이후 명령어에서도 마찬가지로 삭제해 주세요. ::: @@ -497,6 +490,7 @@ NODE_ENV=production pnpm run build RAM 부족이 원인일 수 있습니다. 미스키의 빌드 및 데이터베이스 마이그레이션(초기화 포함)을 위해서는 2GB 이상의 RAM이 필요합니다.\ +RAM이 부족한 경우 다음과 같은 해결책을 생각해 볼 수 있습니다.\ RAM이 부족한 경우 다음과 같은 해결책을 생각해 볼 수 있습니다. - 서버에 스왑 추가하기 @@ -505,13 +499,33 @@ RAM이 부족한 경우 다음과 같은 해결책을 생각해 볼 수 있습 ## 데이터베이스 초기화 ```sh -pnpm run init +[Unit] +Description=Misskey daemon + +[Service] +Type=simple +User=misskey +ExecStart=/usr/bin/npm start +WorkingDirectory=/home/misskey/misskey +Environment="NODE_ENV=production" +TimeoutSec=60 +StandardOutput=journal +StandardError=journal +SyslogIdentifier=misskey +Restart=always + +[Install] +WantedBy=multi-user.target ``` ## Misskey 실행하기 ```sh -NODE_ENV=production pnpm run start +sudo systemctl daemon-reload + +sudo systemctl enable misskey + +sudo systemctl start misskey ``` **Now listening on port 3000 on** [**http://example.tld**](http://example.tld) 라고 표시되면 설정한 URL에 접속합니다. @@ -530,7 +544,7 @@ CloudFlare의 DNS 설정이 올바른 IP 주소로 설정되어 있는지 다시 홈 서버의 경우, 라우터가 서버와 외부와의 80포트, 443포트 통신을 허용하도록 설정되어 있는지 확인합니다. -클라우드의 경우에도 네트워크 설정에서 포트 개방이 필요한 경우가 많습니다. +[Misskey 업데이트 방법](./manual/#misskey 업데이트 방법) ## Misskey의 데몬 생성 @@ -545,7 +559,7 @@ CloudFlare의 DNS 설정이 올바른 IP 주소로 설정되어 있는지 다시 루트 권한으로 변경합니다. ```sh -exit +sudo systemctl start misskey ``` /etc/systemd/system/misskey.service를 만듭니다. @@ -586,7 +600,7 @@ sudo systemctl enable misskey sudo systemctl start misskey ``` -systemctl로 데몬 상태를 확인합니다.실행에 시간이 조금 걸리므로 15초 정도 기다렸다가 시작하는 것이 좋습니다. +systemctl로 데몬의 상태를 확인합니다.실행에 시간이 조금 걸리므로 15초 정도 기다렸다가 시작하는 것이 좋습니다. ```sh sudo systemctl status misskey @@ -594,7 +608,7 @@ sudo systemctl status misskey active라면 OK. -**이것으로 Misskey 설치가 거의 완료되었습니다.** +**이것으로 Misskey 설치가 거의 완료되었습니다.**\*\* Misskey 서버에 자신의 계정을 등록하고 로그인하여 설정을 진행합니다. @@ -606,7 +620,7 @@ Misskey 서버에 자신의 계정을 등록하고 로그인하여 설정을 진 ## Misskey 업데이트 -[Misskey 업데이트 방법](. /manual/#misskey 업데이트 방법) +/manual/#misskey 업데이트 방법) 작업 중에는 Misskey를 사용할 수 없습니다. diff --git a/content/ko/docs/3.for-admin/install/resources/_dir.yml b/content/ko/docs/3.for-admin/install/resources/_dir.yml new file mode 100644 index 00000000..4ac76440 --- /dev/null +++ b/content/ko/docs/3.for-admin/install/resources/_dir.yml @@ -0,0 +1,2 @@ +title: "Misskey 유지관리 및 문제 해결" +description: "Misskey 서버 운영에는 정기적인 유지보수가 필수적입니다. 유용한 정보와 문제 발생 시 대처 방법을 소개합니다." diff --git a/content/ko/docs/3.for-admin/install/resources/cdn.md b/content/ko/docs/3.for-admin/install/resources/cdn.md index 526ba9b7..33bad94e 100644 --- a/content/ko/docs/3.for-admin/install/resources/cdn.md +++ b/content/ko/docs/3.for-admin/install/resources/cdn.md @@ -9,8 +9,7 @@ CDN을 사용하면 다음과 같은 장점이 있습니다. ## 캐시 -Misskey Web은 완전히 정적이며, 작동을 위해 서버가 필요하지 않습니다.따라서 Misskey 웹 전체를 CDN에서 캐싱할 수 있습니다. -Misskey API는 캐싱할 수 없습니다. +Misskey Web은 완전히 정적이며, 작동을 위해 서버가 필요하지 않습니다.따라서 Misskey 웹 전체를 CDN에서 캐싱할 수 있습니다.Misskey API는 캐싱할 수 없습니다. CDN에서 다음과 같이 설정해 주세요. diff --git a/content/ko/docs/3.for-admin/install/resources/nginx.md b/content/ko/docs/3.for-admin/install/resources/nginx.md index 746044bc..b13e3a41 100644 --- a/content/ko/docs/3.for-admin/install/resources/nginx.md +++ b/content/ko/docs/3.for-admin/install/resources/nginx.md @@ -1,12 +1,12 @@ # Nginx 설정 -1. `/etc/nginx/conf.d/misskey.conf` 또는 `/etc/nginx/sites-available/misskey.conf`를 생성하고 아래 설정 예시를 복사합니다.. +1. `/etc/nginx/conf.d/misskey.conf` 또는 `/etc/nginx/sites-available/misskey.conf`를 생성하고 아래 설정 예시를 복사합니다... (파일명은 misskey가 아니어도 상관없습니다.)） 2. 다음과 같이 편집합니다. - 1. example.tld를 자신이 준비한 도메인으로 대체합니다.\ + 1. example.tld를 자신이 준비한 도메인으로 대체합니다.example.tld를 자신이 준비한 도메인으로 대체합니다.\ `ssl_certificate`와 `ssl_certificate_key`는 Let's Encrypt에서 발급받은 인증서의 경로가 되도록 합니다. - 2. Cloudflare 등의 CDN을 사용하는 경우 'If it's behind another reverse proxy or CDN, remove the following.’ 부터 4행을 제거합니다. -3. `/etc/nginx/sites-available/misskey.conf`를 만들었다면 `/etc/nginx/sites-enabled/misskey.conf`로 심볼릭 링크를 생성합니다.\ + 2. Cloudflare 등의 CDN을 사용하는 경우 'If it's behind another reverse proxy or CDN, remove the following.’ +3. (파일명은 misskey가 아니어도 상관없습니다.)）`/etc/nginx/sites-available/misskey.conf`를 만들었다면 `/etc/nginx/sites-enabled/misskey.conf`로 심볼릭 링크를 생성합니다.\ `sudo ln -s /etc/nginx/sites-available/misskey.conf /etc/nginx/sites-enabled/misskey.conf` 4. `sudo nginx -t`로 설정 파일이 정상적으로 로드되는지 확인합니다. 5. `sudo systemctl restart nginx`로 nginx를 리로드 합니다. diff --git a/content/ko/docs/3.for-admin/install/resources/push-docker-hub.md b/content/ko/docs/3.for-admin/install/resources/push-docker-hub.md index 058d55d4..409df046 100644 --- a/content/ko/docs/3.for-admin/install/resources/push-docker-hub.md +++ b/content/ko/docs/3.for-admin/install/resources/push-docker-hub.md @@ -4,6 +4,7 @@ GitHub Action을 통해 Docker Hub에 푸시하는 워크플로우가 설명되어 있습니다. 원본 저장소에서는 릴리스된 시점에 `latest`, `<릴리즈명>` 각각의 태그와 함께 Docker Hub에 푸시됩니다.\ +※ Docker Hub에 `<브랜치명>`과 같은 태그가 있을 수 있지만, 이 태그는 자동 푸시 대상이 아닙니다.\ ※ Docker Hub에 `<브랜치명>`과 같은 태그가 있을 수 있지만, 이 태그는 자동 푸시 대상이 아닙니다. Fork에서 이 워크플로우를 실행하면 실패합니다. @@ -13,15 +14,19 @@ Fork에서 이 워크플로우를 실행하면 실패합니다. ## 자신의 Docker Hub 리포지토리에 푸시하도록 설정하는 방법 1. Docker Hub에서 리포지토리를 생성합니다. -2. 워크플로우 파일의 [images](https\://github.com/misskey-dev/misskey/blob/53f3b779bf16abcda4f6e026c51384f3b8fbcc62/.github/workflows/docker. yml#L20)을 생성한 저장소로 대체합니다. -3. GitHub에서 [암호화된 시크릿](https://docs.github.com/ja/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)을 생성합니다.\ +2. 워크플로우 파일의 [images](https\://github.com/misskey-dev/misskey/blob/53f3b779bf16abcda4f6e026c51384f3b8fbcc62/.github/workflows/docker. +3. yml#L20)을 생성한 저장소로 대체합니다.\ + GitHub에서 [암호화된 시크릿](https://docs.github.com/ja/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)을 생성합니다.\ 생성해야 하는 것은 `DOCKER_USERNAME`과 `DOCKER_PASSWORD`로, 각각 Docker Hub의 사용자와 비밀번호가 됩니다. ## push하는 방법 +위 설정을 통해 릴리스 시 자동으로 Docker Hub에 푸시되도록 설정합니다.\ 위 설정을 통해 릴리스 시 자동으로 Docker Hub에 푸시되도록 설정합니다.\ 구체적으로는 GitHub의 릴리즈 기능으로 릴리즈한 시점에 `latest`, `<릴리즈명>` 각각의 태그와 함께 Docker Hub에 푸시됩니다. +또한 GitHub에서 수동으로 푸시할 수도 있습니다.\ 또한 GitHub에서 수동으로 푸시할 수도 있습니다.\ 이를 위해 Actions => Publish Docker image => Run workflow에서 branch를 선택하여 워크플로우를 실행합니다.\ +단, 이 경우 생성되는 태그는 `<브랜치명>`이 됩니다.\ 단, 이 경우 생성되는 태그는 `<브랜치명>`이 됩니다. diff --git a/content/ko/docs/3.for-admin/install/resources/scale-out.md b/content/ko/docs/3.for-admin/install/resources/scale-out.md index e70c3e8e..434306b3 100644 --- a/content/ko/docs/3.for-admin/install/resources/scale-out.md +++ b/content/ko/docs/3.for-admin/install/resources/scale-out.md @@ -1,12 +1,10 @@ # Misskey 서버의 스케일아웃 -서버 이용자가 늘어남에 따라 서버 머신의 사양을 강화하거나 대수를 늘려 부하를 감당해야 하는 상황이 발생합니다.이 글에서는 Misskey 서버의 스케일아웃에 대한 팁을 소개합니다. +PostgreSQL의 복제를 통해 데이터베이스의 부하를 여러 서버 머신에 분산시킬 수 있습니다.서버 이용자가 늘어남에 따라 서버 머신의 사양을 강화하거나 대수를 늘려 부하를 감당해야 하는 상황이 발생합니다.이 글에서는 Misskey 서버의 스케일아웃에 대한 팁을 소개합니다. ## PostgreSQL 리플리케이션 -PostgreSQL의 복제를 통해 데이터베이스의 부하를 여러 서버 머신에 분산시킬 수 있습니다. -복제에 대한 자세한 내용은 PostgreSQL 문서를 참고하시기 바랍니다. -Misskey에서는 PostgreSQL의 복제를 지원하며, config 파일에서 다음과 같이 설정합니다.(일부 발췌) +Misskey에서는 PostgreSQL의 복제를 지원하며, config 파일에서 다음과 같이 설정합니다.(일부 발췌)(일부 발췌) ```yml # 복제를 사용하는 경우 true로 설정합니다. @@ -40,8 +38,7 @@ Misskey는 다음과 같이 다양한 용도로 Redis를 사용합니다. - 알림 등의 정보 저장 - 글로벌 이벤트의 Pub/Sub -Misskey에서는 이러한 용도별로 다른 Redis 서버를 사용하도록 설정할 수 있으며, 여러 서버 머신에 부하를 분산시킬 수 있습니다. -config 파일에서 다음과 같이 설정합니다.(일부 발췌) +Misskey에서는 이러한 용도별로 다른 Redis 서버를 사용하도록 설정할 수 있으며, 여러 서버 머신에 부하를 분산시킬 수 있습니다.(일부 발췌) ```yml redisForPubsub: @@ -66,4 +63,3 @@ redisForJobQueue: ## 원격 차트 비활성화 개별 원격 사용자 활동과 같은 차트나 개별 원격 서버의 차트가 필요하지 않은 경우, 해당 차트의 생성을 비활성화하면 성능이 향상됩니다. -제어판에서 '원격 사용자 차트 생성' 및 '원격 서버 차트 생성'을 끄면 비활성화할 수 있습니다. diff --git a/content/ko/docs/3.for-admin/moderation-tips/_dir.yml b/content/ko/docs/3.for-admin/moderation-tips/_dir.yml new file mode 100644 index 00000000..8de52018 --- /dev/null +++ b/content/ko/docs/3.for-admin/moderation-tips/_dir.yml @@ -0,0 +1,2 @@ +title: "모더레이션 관련 유용한 정보" +description: "실제로 서버를 운영할 때 도움이 되는 정보를 정리했습니다." diff --git a/content/ko/docs/3.for-admin/moderation-tips/disable-timelines.md b/content/ko/docs/3.for-admin/moderation-tips/disable-timelines.md index f4066c0a..5af24b1f 100644 --- a/content/ko/docs/3.for-admin/moderation-tips/disable-timelines.md +++ b/content/ko/docs/3.for-admin/moderation-tips/disable-timelines.md @@ -1,15 +1,12 @@ # LTL/STL/GTL 비활성화 -Misskey에서는 LTL/STL/GTL을 각각 비활성화할 수 있습니다.활성화/비활성화를 전환하려면 서버 제어판에서 설정합니다. +Misskey에서는 LTL/STL/GTL을 각각 비활성화할 수 있습니다.활성화/비활성화를 전환하려면 서버 제어판에서 설정합니다.활성화/비활성화를 전환하려면 서버 제어판에서 설정합니다. LTL이나 STL은 해당 서버에 있는 모든 사용자의 게시물을 볼 수 있기 때문에 신규 사용자 입장에서는 사용자를 찾을 필요가 없고, 관심 있는 사용자를 쉽게 찾을 수 있다는 장점이 있다. -하지만 동시에 팔로우 기능이 활용되지 않거나 부적절한 게시물이 눈에 잘 띄고, 채팅처럼 되어 내밀한 분위기가 형성되어 신규 유저가 참여하기 어렵다는 단점도 있습니다. -서버에 따라 장점과 단점이 어느 쪽이 더 우세한지는 서버마다 다르므로, 옵션으로 비활성화할 수 있도록 되어 있습니다. -만약 단점이 더 크다고 느낀다면, 해당 타임라인을 비활성화하는 것도 고려해볼 수 있습니다. :::warning -비활성화를 하면 사용자가 혼란스러워하고 단기적으로 사용자가 감소할 수 있습니다.따라서 비활성화 시에는 그 영향을 신중하게 검토하고, 사전에 설명하고 후속 조치를 마련할 수 있는 기간을 어느 정도 두는 것이 좋습니다. +비활성화를 하면 사용자가 혼란스러워하고 단기적으로 사용자가 감소할 수 있습니다.비활성화를 하면 사용자가 혼란스러워하고 단기적으로 사용자가 감소할 수 있습니다.따라서 비활성화 시에는 그 영향을 신중하게 검토하고, 사전에 설명하고 후속 조치를 마련할 수 있는 기간을 어느 정도 두는 것이 좋습니다. ::: diff --git a/content/ko/docs/4.for-developers/_dir.yml b/content/ko/docs/4.for-developers/_dir.yml new file mode 100644 index 00000000..4bc98c49 --- /dev/null +++ b/content/ko/docs/4.for-developers/_dir.yml @@ -0,0 +1,2 @@ +title: "개발자 대상" +description: "플러그인 및 Play 개발자와 API를 이용한 외부 애플리케이션 개발자를 위한 리소스입니다." diff --git a/content/ko/docs/4.for-developers/aiscript.md b/content/ko/docs/4.for-developers/aiscript.md index 6e03e329..e44a3d2d 100644 --- a/content/ko/docs/4.for-developers/aiscript.md +++ b/content/ko/docs/4.for-developers/aiscript.md @@ -23,7 +23,7 @@ AiScript 표준 구문과 내장 함수 등을 사용할 수 있습니다. :::tip 문서는 [여기](https://github.com/aiscript-dev/aiscript/tree/master/docs)에서 확인할 수 있습니다.\ -Misskey 본체 버전에 따라 사용할 수 있는 AiScript 버전이 다를 수 있습니다.버전 확인은 `<: Core:v`를 Scratchpad 등에서 실행해 보세요. +Misskey 본체 버전에 따라 사용할 수 있는 AiScript 버전이 다를 수 있습니다.버전 확인은 `<: Core:v`를 Scratchpad 등에서 실행해 보세요.버전 확인은 `<: Core:v`를 Scratchpad 등에서 실행해 보세요. ::: @@ -33,19 +33,16 @@ Misskey 본체 버전에 따라 사용할 수 있는 AiScript 버전이 다를 접두사: `Mk:`\ Misskey 내의 모든 AiScript 환경에서 사용할 수 있는 상수 함수군입니다. -자세한 내용은 [플러그인 API 레퍼런스](./plugin/plugin/plugin-api-reference/)의 `Mk:` 부분을 참고해 주세요. ### Plugin API 접두사: `Plugin:`\ [플러그인](./plugin/)에서만 사용할 수 있는 상수 함수군입니다. -자세한 내용은 [플러그인 API 레퍼런스](./plugin/plugin/plugin-api-reference/)의 `Plugin:` 부분을 참고합니다. ### UI API 접두사: `Ui:`\ [위젯](/docs/for-users/features/widgets/)(AiScript App), Misskey Play, Scratchpad에서 사용할 수 있습니다. -문서는 미정비(TODO)이지만, 인터넷에 자원봉사자가 작성한 설명글이 있습니다. ### 표준입출력 @@ -56,6 +53,7 @@ AiScript 표준에서 정의된 `readline` 함수와 `print` 함수(및 `<:` 구 `message`: `str`\ 반환값: `str`\ Misskey 내 모든 AiScript 환경에서 사용할 수 있습니다.\ +문자열 입력을 요청하는 팝업을 표시합니다.\ 문자열 입력을 요청하는 팝업을 표시합니다. #### print(message) @@ -64,4 +62,6 @@ Misskey 내 모든 AiScript 환경에서 사용할 수 있습니다.\ 반환값: `null`\ [위젯](/docs/for-users/features/widgets/) (AiScript 콘솔), Scratchpad에서 사용할 수 있습니다.\ 콘솔에 문자열을 출력합니다.\ +`<:`구문도 비슷한 역할을 합니다.\ +콘솔에 문자열을 출력합니다.\ `<:`구문도 비슷한 역할을 합니다. diff --git a/content/ko/docs/4.for-developers/api/1.index.md b/content/ko/docs/4.for-developers/api/1.index.md index 11cdba1c..240f7c2c 100644 --- a/content/ko/docs/4.for-developers/api/1.index.md +++ b/content/ko/docs/4.for-developers/api/1.index.md @@ -1,15 +1,14 @@ --- -description: Misskey는 API를 공개하고 있습니다.API를 사용하여 Misskey 클라이언트, Misskey 연동 웹서비스, Bot 등(이하 '애플리케이션'이라 함)을 개발할 수 있습니다. +description: Misskey는 API를 공개하고 있습니다.API를 사용하여 Misskey 클라이언트, Misskey 연동 웹서비스, Bot 등(이하 '애플리케이션'이라 함)을 개발할 수 있습니다.Misskey는 API를 공개하고 있습니다.API를 사용하여 Misskey 클라이언트, Misskey 연동 웹 서비스, Bot 등(이하 '애플리케이션'이라 함)을 개발할 수 있습니다. --- # Misskey API -Misskey는 API를 공개하고 있습니다.API를 사용하여 Misskey 클라이언트, Misskey 연동 웹 서비스, Bot 등(이하 '애플리케이션'이라 함)을 개발할 수 있습니다. -스트리밍 API도 있어 실시간 애플리케이션을 만들 수도 있습니다. +Misskey는 API를 공개하고 있습니다.스트리밍 API도 있어 실시간 애플리케이션을 만들 수도 있습니다. :::tip -Misskey 공식 SDK나 서드파티 라이브러리를 사용하면 이 문서에서 설명하는 몇 가지 단계를 간소화할 수 있는 등 보다 편리하게 API를 사용할 수 있습니다.\\ +Misskey 공식 SDK나 서드파티 라이브러리를 사용하면 이 문서에서 설명하는 몇 가지 단계를 간소화할 수 있는 등 보다 편리하게 API를 사용할 수 있습니다.\\\\ ::: diff --git a/content/ko/docs/4.for-developers/api/libraries.md b/content/ko/docs/4.for-developers/api/libraries.md index b929f963..8a79cd94 100644 --- a/content/ko/docs/4.for-developers/api/libraries.md +++ b/content/ko/docs/4.for-developers/api/libraries.md @@ -25,6 +25,7 @@ description: Misskey API 관련 라이브러리 목록 ## Dart / Flutter - [misskey](https://github.com/misskey-dart/misskey) +- [misskey_dart](https://github.com/shiosyakeyakini-info/misskey_dart) ## Go diff --git a/content/ko/docs/4.for-developers/api/streaming/1.index.md b/content/ko/docs/4.for-developers/api/streaming/1.index.md index 638ebe26..15c85052 100644 --- a/content/ko/docs/4.for-developers/api/streaming/1.index.md +++ b/content/ko/docs/4.for-developers/api/streaming/1.index.md @@ -10,7 +10,7 @@ description: 스트리밍 API를 사용하면, 실시간으로 다양한 정보( ::: -스트리밍 API를 이용하려면, 먼저 Misskey 서버에 **websocket**으로 접속이 필요합니다. +스트리밍 API를 사용하면, 실시간으로 다양한 정보(예를 들어 타임라인에 새로운 노트가 올라왔다거나, 리액션을 받았거나 팔로우 되었다거나 등)를 받거나, 다양한 작업을 할 수 있습니다. ## 스트림에 접속하기 @@ -33,14 +33,13 @@ wss://{host}/streaming?i={token} ::: -스트림에 접속하면, 후술할 노트의 구독을 하는 것이 가능합니다. 그러나, 아직 이 단계에서는 타임라인의 새로운 노트를 확인하는 등의 행동을 할 수 없습니다. 이러한 이벤트를 수신하기 위해서는, 스트림 상에 후술할 **채널**에 접속해야 합니다. \*\*스트림상에서 주고 받는 정보는 모두 JSON입니다.어떠한 채널이 있는 지는, [채널 목록](./channel/index.md)를 참조해 주세요. ## 채널에 접속하기 -Misskey의 스트리밍 API에는 채널이라는 개념이 있습니다.이것은 송수신하는 정보를 분리하기 위한 구조입니다. 스트림 상에서 채널에 접속함으로써, 다양한 정보를 받거나 보낼 수 있게 됩니다. +Misskey의 스트리밍 API에는 채널이라는 개념이 있습니다.이것은 송수신하는 정보를 분리하기 위한 구조입니다.이것은 송수신하는 정보를 분리하기 위한 구조입니다. 스트림 상에서 채널에 접속함으로써, 다양한 정보를 받거나 보낼 수 있게 됩니다. :::tip @@ -48,7 +47,7 @@ Misskey의 스트리밍 API에는 채널이라는 개념이 있습니다.이것 ::: -아래에서 채널의 사용 방법을 설명합니다.어떠한 채널이 있는 지는, [채널 목록](./channel/index.md)를 참조해 주세요. +아래에서 채널의 사용 방법을 설명합니다.어떠한 채널이 있는 지는, [채널 목록](./channel/index.md)를 참조해 주세요.\*\*스트림상에서 주고 받는 정보는 모두 JSON입니다.어떠한 채널이 있는 지는, [채널 목록](./channel/index.md)를 참조해 주세요. ### 채널에 접속하기 @@ -69,19 +68,19 @@ Misskey의 스트리밍 API에는 채널이라는 개념이 있습니다.이것 여기서, -- `channel`에는 접속하고자 하는 채널명을 입력합니다.[채널 목록](./channel/index.md)를 참고하세요. -- `id`에는 해당 채널과 상호작용할 수 있는 임의의 ID를 설정합니다.스트림에는 다양한 메시지가 흘러나오기 때문에 어떤 채널에서 온 메시지인지 식별해야 하기 때문입니다.이 ID는 UUID나 난수 같은 것이 될 수 있습니다. -- `params`는 채널에 연결할 때의 파라미터입니다.채널에 따라 연결 시 필요한 파라미터가 다릅니다.파라미터가 필요 없는 채널에 연결할 때는 이 속성을 생략할 수 있습니다. +- 스트림에 접속하면, 후술할 노트의 구독을 하는 것이 가능합니다.`channel`에는 접속하고자 하는 채널명을 입력합니다.[채널 목록](./channel/index.md)를 참고하세요. +- `id`에는 해당 채널과 상호작용할 수 있는 임의의 ID를 설정합니다.스트림에는 다양한 메시지가 흘러나오기 때문에 어떤 채널에서 온 메시지인지 식별해야 하기 때문입니다.이 ID는 UUID나 난수 같은 것이 될 수 있습니다.이 문제를 해결하기 위해 Misskey는 게시물 캡처 기능을 제공하고 있습니다.게시물을 캡처하면 해당 게시물에 대한 이벤트를 수신할 수 있기 때문에 실시간으로 반응을 반영할 수 있습니다.이 ID는 UUID나 난수 같은 것이 될 수 있습니다. +- `params`는 채널에 연결할 때의 파라미터입니다.스트리밍 API를 이용하려면, 먼저 Misskey 서버에 **websocket**으로 접속이 필요합니다.`params`는 채널에 연결할 때의 파라미터입니다.채널에 따라 연결 시 필요한 파라미터가 다릅니다.파라미터가 필요 없는 채널에 연결할 때는 이 속성을 생략할 수 있습니다. :::tip -ID는 채널 단위가 아니라 '채널 연결 단위'입니다.왜냐하면 같은 채널에 서로 다른 파라미터로 다중접속 하는 경우도 있기 때문입니다. +ID는 채널 단위가 아니라 '채널 연결 단위'입니다.왜냐하면 같은 채널에 서로 다른 파라미터로 다중접속 하는 경우도 있기 때문입니다.그러나, 아직 이 단계에서는 타임라인의 새로운 노트를 확인하는 등의 행동을 할 수 없습니다. ::: ### 채널에서 메시지 받기 -예를 들어, 타임라인 채널의 경우 새로운 게시물이 올라오면 메시지를 발신합니다.해당 메시지를 받으면 타임라인에 새로운 게시물이 올라왔다는 것을 실시간으로 알 수 있습니다. +예를 들어, 타임라인 채널의 경우 새로운 게시물이 올라오면 메시지를 발신합니다.해당 메시지를 받으면 타임라인에 새로운 게시물이 올라왔다는 것을 실시간으로 알 수 있습니다.해당 메시지를 받으면 타임라인에 새로운 게시물이 올라왔다는 것을 실시간으로 알 수 있습니다. 채널이 메시지를 보내면 다음과 같은 데이터가 JSON으로 스트림에 유입됩니다. @@ -100,9 +99,9 @@ ID는 채널 단위가 아니라 '채널 연결 단위'입니다.왜냐하면 여기서, -- `id`에는 앞서 언급한 해당 채널에 접속할 때 설정한 ID가 설정되어 있습니다.이제 이 메시지가 어느 채널에서 온 것인지 알 수 있습니다. -- `type`에는 메시지 종류가 설정됩니다.채널에 따라 어떤 종류의 메시지가 흘러나오는지는 달라질 수 있습니다. -- `body`에는 메시지 내용이 설정됩니다.채널에 따라 어떤 내용의 메시지가 흘러나오는지는 달라질 수 있습니다. +- `id`에는 앞서 언급한 해당 채널에 접속할 때 설정한 ID가 설정되어 있습니다.이제 이 메시지가 어느 채널에서 온 것인지 알 수 있습니다.이제 이 메시지가 어느 채널에서 온 것인지 알 수 있습니다. +- `type`에는 메시지 종류가 설정됩니다.채널에 따라 어떤 종류의 메시지가 흘러나오는지는 달라질 수 있습니다.스트림 상에서 채널에 접속함으로써, 다양한 정보를 받거나 보낼 수 있게 됩니다. +- `body`에는 메시지 내용이 설정됩니다.채널에 따라 어떤 내용의 메시지가 흘러나오는지는 달라질 수 있습니다.예를 들어 타임라인을 가져와서 사용자에게 보여줬다고 가정해 봅시다.여기서 누군가가 해당 타임라인에 포함된 어떤 게시물에 리액션을 했다고 가정해봅시다. ### 채널에 메시지 보내기 @@ -125,9 +124,9 @@ ID는 채널 단위가 아니라 '채널 연결 단위'입니다.왜냐하면 여기서, -- `id`에는 앞서 설명한 해당 채널에 접속할 때 설정한 ID를 설정합니다.이제 이 메시지가 어떤 채널을 대상으로 하는 메시지인지 식별할 수 있습니다. -- `type`에는 메시지 종류를 설정합니다.채널에 따라 어떤 종류의 메시지를 받을 수 있는지는 달라질 수 있습니다. -- `body`에는 메시지 내용을 설정합니다.채널에 따라 어떤 내용의 메시지를 받아들이는지는 달라질 수 있습니다. +- `id`에는 앞서 설명한 해당 채널에 접속할 때 설정한 ID를 설정합니다.이제 이 메시지가 어떤 채널을 대상으로 하는 메시지인지 식별할 수 있습니다.이제 이 메시지가 어떤 채널을 대상으로 하는 메시지인지 식별할 수 있습니다. +- `type`에는 메시지 종류를 설정합니다.채널에 따라 어떤 종류의 메시지를 받을 수 있는지는 달라질 수 있습니다.이 메시지를 보내면 이후 해당 게시물에 대한 이벤트가 발생하지 않습니다. +- `body`에는 메시지 내용을 설정합니다.채널에 따라 어떤 내용의 메시지를 받아들이는지는 달라질 수 있습니다.해당 게시물이 더 이상 화면에 표시되지 않거나, 해당 게시물에 대한 이벤트를 더 이상 받을 필요가 없을 때는 캡처 해제를 신청하세요. ### 채널 연결 끊기 @@ -148,14 +147,13 @@ ID는 채널 단위가 아니라 '채널 연결 단위'입니다.왜냐하면 ## 게시물 캡처 -Misskey는 게시물 캡쳐라는 메커니즘을 제공하고 있습니다.지정한 게시물의 이벤트를 스트림으로 받아볼 수 있는 기능입니다. +Misskey는 게시물 캡쳐라는 메커니즘을 제공하고 있습니다.지정한 게시물의 이벤트를 스트림으로 받아볼 수 있는 기능입니다.지정한 게시물의 이벤트를 스트림으로 받아볼 수 있는 기능입니다. -예를 들어 타임라인을 가져와서 사용자에게 보여줬다고 가정해 봅시다.여기서 누군가가 해당 타임라인에 포함된 어떤 게시물에 리액션을 했다고 가정해봅시다. -하지만 클라이언트 입장에서는 어떤 게시물에 리액션이 붙었다는 것을 알 길이 없기 때문에 실시간으로 리액션을 타임라인의 게시물에 반영하여 표시하는 등의 작업을 할 수 없습니다. +예를 들어 타임라인을 가져와서 사용자에게 보여줬다고 가정해 봅시다.하지만 클라이언트 입장에서는 어떤 게시물에 리액션이 붙었다는 것을 알 길이 없기 때문에 실시간으로 리액션을 타임라인의 게시물에 반영하여 표시하는 등의 작업을 할 수 없습니다. 이 문제를 해결하기 위해 Misskey는 게시물 캡처 기능을 제공하고 있습니다.게시물을 캡처하면 해당 게시물에 대한 이벤트를 수신할 수 있기 때문에 실시간으로 반응을 반영할 수 있습니다. -아래에서는 게시물 캡처 기능을 사용하는 방법을 설명합니다.어떤 캡처 이벤트가 있는지는 [캡처 이벤트 목록](./note-capture-events.md)에서 확인할 수 있습니다. +아래에서는 게시물 캡처 기능을 사용하는 방법을 설명합니다.아래에서는 게시물 캡처 기능을 사용하는 방법을 설명합니다.어떤 캡처 이벤트가 있는지는 [캡처 이벤트 목록](./note-capture-events.md)에서 확인할 수 있습니다. ### 게시물 캡처하기 @@ -170,7 +168,7 @@ Misskey는 게시물 캡쳐라는 메커니즘을 제공하고 있습니다.지 } ``` -해당 게시물이 더 이상 화면에 표시되지 않거나, 해당 게시물에 대한 이벤트를 더 이상 받을 필요가 없을 때는 캡처 해제를 신청하세요. +여기서, - `id`에 캡처하고자 하는 게시물의 `id`를 설정합니다. diff --git a/content/ko/docs/4.for-developers/api/streaming/channel/main.md b/content/ko/docs/4.for-developers/api/streaming/channel/main.md index e6e241ce..b26757aa 100644 --- a/content/ko/docs/4.for-developers/api/streaming/channel/main.md +++ b/content/ko/docs/4.for-developers/api/streaming/channel/main.md @@ -50,7 +50,7 @@ Renote 될 때 발생합니다. $ref: 'misskey://User' }"/> -자신이 다른 사용자를 팔로우했을 때 발생합니다. +다른 사용자가 나를 팔로우했을 때 발생합니다. ### `followed` @@ -58,7 +58,7 @@ Renote 될 때 발생합니다. $ref: 'misskey://User' }"/> -다른 사용자가 나를 팔로우했을 때 발생합니다. +자신이 다른 사용자를 팔로우했을 때 발생합니다. ### `unfollow` diff --git a/content/ko/docs/4.for-developers/api/token.md b/content/ko/docs/4.for-developers/api/token.md deleted file mode 100644 index f546afd2..00000000 --- a/content/ko/docs/4.for-developers/api/token.md +++ /dev/null @@ -1,134 +0,0 @@ -# 액세스 토큰 획득하기 - -API를 사용하기 위해서는 API를 사용할 계정에 연결된 **액세스 토큰**을 발급받아야 합니다. -이 문서에서는 액세스 토큰을 획득하는 방법을 설명한 후, 기본적인 API 사용법을 설명합니다. - -기본적으로 API는 요청 시 액세스 토큰이 필요합니다. -액세스 토큰은 사용자에 연결된 인증 정보로, API를 이용하는 사용자를 식별하는 동시에 액세스 토큰별로 어떤 작업 권한을 가지고 있는지 관리합니다. - -:::tip - -사용자와 그 사용자와 연결된 액세스 토큰은 일대다 관계이며, 한 사용자에게 여러 개의 액세스 토큰이 발급될 수 있습니다. - -::: - -자신의 액세스 토큰을 쉽게 획득할 수 있을 뿐만 아니라, 자신의 애플리케이션을 사용하게 될 불특정 사용자의 액세스 토큰을 획득할 수도 있습니다. - -- 전자의 경우: \*\*"자신의 액세스 토큰을 수동으로 발행하기"\*\*로 이동합니다. -- 후자의 경우: \*\*"애플리케이션 사용자에게 액세스 토큰 발급 요청하기"\*\*로 이동합니다. - -### 자신의 액세스 토큰을 수동으로 발행하기 - -Misskey Web의 '설정 > API'에서 자신의 액세스 토큰을 발행할 수 있습니다. - -:::danger - -액세스 토큰은 다른 사람이 알 수 없도록 해야 합니다. - -::: - -### 애플리케이션 사용자에게 액세스 토큰 발급 요청하기 - -애플리케이션을 이용하는 사용자(이하 단순히 '사용자'라 칭함)의 액세스 토큰을 발급받으려면 아래 절차에 따라 발급을 요청합니다. - -:::tip - -아래 설명할 방법은 앱을 만들지 않고 즉시 액세스 토큰을 발급하는 MiAuth라는 방법입니다. - -[앱 생성 방식으로 액세스 토큰을 획득하는 방법도 있습니다(구식).](./app) - -::: - -#### Step 1 - -UUID를 생성합니다.이후 이를 **세션 ID**라고 부릅니다. - -:::danger - -이 세션 ID는 매번 생성해야 하며, 반복해서 사용하지 않도록 해야 합니다. - -::: - -#### Step 2 - -애플리케이션 인증 양식을 사용자의 브라우저에 표시하도록 합니다.인증 양식은 다음 형식의 URL로 열 수 있습니다. - -``` -https://{host}/miauth/{session} -``` - -여기서, - -- `{host}`부분은 사용자 서버의 호스트로 대체합니다.보통 호스트는 사용자가 입력합니다. -- `{session}`부분은 세션 ID로 대체합니다. - -또한 URL에 몇 가지 옵션을 쿼리 파라미터로 설정할 수 있습니다. - -| 이름 | 설명 | -| ------------ | ---------------------------------------------------------------------------------------- | -| `name` | 애플리케이션 이름。 | -| `icon` | 애플리케이션 아이콘의 이미지 URL。 | -| `callback` | 인증이 끝난 후 리디렉션되는 URL。
리디렉션 시에는 `session`이라는 쿼리 파라미터로 세션 ID가 붙습니다. | -| `permission` | 애플리케이션이 요구하는 권한.
요청하는 권한을 `,`로 구분하여 열거합니다.권한 목록은 [여기](./permission.md)에서 확인할 수 있습니다. | - -:::tip{label='例'} - -``` -https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive -``` - -::: - -#### Step 3 - -사용자가 애플리케이션 접근을 허용한 후 다음 형식의 URL에 POST 요청하면 응답으로 액세스 토큰이 포함된 JSON이 반환됩니다. - -``` -https://{host}/api/miauth/{session}/check -``` - -여기서, - -- `{host}`부분은 사용자 서버의 호스트로 대체합니다. -- `{session}`부분은 세션 ID로 대체합니다. - -응답에 포함된 속성은 다음과 같습니다. - -| 이름 | 설명 | -| ------- | ----------- | -| `token` | 사용자 액세스 토큰. | -| `user` | 사용자 정보. | - -## API 이용 - -액세스 토큰을 획득하면 각종 엔드포인트에 요청하여 API를 사용할 수 있습니다. - -:::tip - -- HTTP API는 모두 POST이며, 요청/응답 모두 JSON 형식입니다(drive/files/create 제외). -- 요청 헤더에 `Content-Type: application/json`을 지정합니다. -- 액세스 토큰은 `i`라는 파라미터 이름으로 요청 본문 JSON에 포함합니다. -- 기본 URL은 `https://{서버의 도메인}/api`입니다. - -::: - -액세스 토큰이 있는 바디의 예시 (meta의 경우):. - -```json -{ - "i": "HogEFugA1341", - "detail": false -} -``` - - - -API에 대한 자세한 내용은 API 레퍼런스를 참조하세요. - -:::warning - -Misskey는 REST를 채택하고 있지 않습니다. - -::: - -또한 Misskey는 HTTP API뿐만 아니라 스트리밍 API도 제공하고 있습니다.스트리밍 API에 대한 자세한 내용은 [이 문서](./streaming/index.md)를 참고하세요. diff --git a/content/ko/docs/4.for-developers/api/token/1.index.md b/content/ko/docs/4.for-developers/api/token/1.index.md index 280e5228..47382d29 100644 --- a/content/ko/docs/4.for-developers/api/token/1.index.md +++ b/content/ko/docs/4.for-developers/api/token/1.index.md @@ -1,10 +1,8 @@ # 액세스 토큰 획득하기 API를 사용하기 위해서는 API를 사용할 계정에 연결된 **액세스 토큰**을 발급받아야 합니다. -이 문서에서는 액세스 토큰을 획득하는 방법을 설명한 후, 기본적인 API 사용법을 설명합니다. 기본적으로 API는 요청 시 액세스 토큰이 필요합니다. -액세스 토큰은 사용자에 연결된 인증 정보로, API를 이용하는 사용자를 식별하는 동시에 액세스 토큰별로 어떤 작업 권한을 가지고 있는지 관리합니다. :::tip @@ -85,4 +83,4 @@ Misskey는 REST를 채택하고 있지 않습니다. ::: -또한 Misskey는 HTTP API뿐만 아니라 스트리밍 API도 제공하고 있습니다.스트리밍 API에 대한 자세한 내용은 [이 문서](./streaming/)를 참고하세요. +또한 Misskey는 HTTP API뿐만 아니라 스트리밍 API도 제공하고 있습니다.스트리밍 API에 대한 자세한 내용은 [이 문서](./streaming/)를 참고하세요.이 문서에서는 액세스 토큰을 획득하는 방법을 설명한 후, 기본적인 API 사용법을 설명합니다. diff --git a/content/ko/docs/4.for-developers/api/token/2.miauth.md b/content/ko/docs/4.for-developers/api/token/2.miauth.md index a0a2681f..6e13124e 100644 --- a/content/ko/docs/4.for-developers/api/token/2.miauth.md +++ b/content/ko/docs/4.for-developers/api/token/2.miauth.md @@ -10,8 +10,9 @@ description: v12.27.0 이상에서 사용할 수 있는 Misskey만의 간단한 아래 설명할 방법은 앱을 만들지 않고 즉시 액세스 토큰을 발급하는 MiAuth라는 방법입니다. -- [더 많이 사용되는 OAuth 방식으로 액세스 토큰을 획득하는 방법도 있습니다.](./oauth.md) -- [앱 생성 방식으로 액세스 토큰을 획득하는 방법도 있습니다(구식).](./app.md) +- [더 많이 사용되는 OAuth 방식으로 액세스 토큰을 획득하는 방법도 있습니다.](./oauth.md)](./oauth.md) +- [앱 생성 방식으로 액세스 토큰을 획득하는 방법도 있습니다(구식).](./app.md)](./app.md) + ::: ::: @@ -27,25 +28,25 @@ UUID를 생성합니다.이후 이를 **세션 ID**라고 부릅니다. ## Step 2 -애플리케이션 인증 양식을 사용자의 브라우저에 표시하도록 합니다.인증 양식은 다음 형식의 URL로 열 수 있습니다. +사용자가 애플리케이션 접근을 허용한 후 다음 형식의 URL에 POST 요청하면 응답으로 액세스 토큰이 포함된 JSON이 반환됩니다.애플리케이션 인증 양식을 사용자의 브라우저에 표시하도록 합니다.인증 양식은 다음 형식의 URL로 열 수 있습니다. ``` -https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive +https://{host}/miauth/{session} ``` 여기서, -- `{host}`부분은 사용자 서버의 호스트로 대체합니다.보통 호스트는 사용자가 입력합니다. +- HTTP API는 모두 POST이며, 요청/응답 모두 JSON 형식입니다(drive/files/create 제외).보통 호스트는 사용자가 입력합니다. - `{session}`부분은 세션 ID로 대체합니다. -사용자가 애플리케이션 접근을 허용한 후 다음 형식의 URL에 POST 요청하면 응답으로 액세스 토큰이 포함된 JSON이 반환됩니다. +또한 URL에 몇가지 옵션을 쿼리 파라미터로 설정할 수 있습니다: -| 이름 | 설명 | -| ------------ | ---------------------------------------------------------------------------------------- | -| `name` | 애플리케이션 이름. | -| `icon` | 애플리케이션 아이콘의 이미지 URL. | -| `callback` | 인증이 끝난 후 리디렉션되는 URL.
리디렉션 시에는 `session`이라는 쿼리 파라미터로 세션 ID가 붙습니다. | -| `permission` | 애플리케이션이 요구하는 권한.
요청하는 권한을 `,`로 구분하여 열거합니다.권한 목록은 [여기](./permission.md)에서 확인할 수 있습니다. | +| 이름 | 설명 | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------- | +| `name` | 애플리케이션 이름. | +| `icon` | 애플리케이션 아이콘의 이미지 URL. | +| `callback` | 認証が終わった後にリダイレクトするURL。인증이 끝난 후 리디렉션되는 URL.
리디렉션 시에는 `session`이라는 쿼리 파라미터로 세션 ID가 붙습니다. | +| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。애플리케이션이 요구하는 권한.
요청하는 권한을 `,`로 구분하여 열거합니다.권한 목록은 [여기](./permission.md)에서 확인할 수 있습니다. | :::tip{label='例'} @@ -65,7 +66,7 @@ https://{host}/api/miauth/{session}/check 여기서, -- HTTP API는 모두 POST이며, 요청/응답 모두 JSON 형식입니다(drive/files/create 제외). +- `{host}`부분은 사용자 서버의 호스트로 대체합니다.보통 호스트는 사용자가 입력합니다. - 요청 헤더에 `Content-Type: application/json`을 지정합니다. 응답에 포함된 속성은 다음과 같습니다. diff --git a/content/ko/docs/4.for-developers/api/token/3.oauth.md b/content/ko/docs/4.for-developers/api/token/3.oauth.md index 11f21376..789fded1 100644 --- a/content/ko/docs/4.for-developers/api/token/3.oauth.md +++ b/content/ko/docs/4.for-developers/api/token/3.oauth.md @@ -8,20 +8,21 @@ description: v2023.9.0 이상에서 사용할 수 있는 OAuth2.0 방식의 인 :::tip -아래 설명할 방법은 [OAuth 2.0](https://datatracker.ietf.org/doc/html/rfc6749.html)이라는 방법입니다.일반 OAuth는 앱을 만들어야 하지만, [IndieAuth](https://indieauth.spec.indieweb.org/)의 확장으로 앱을 만들지 않고도 사용할 수 있도록 되어 있습니다. +아래 설명할 방법은 [OAuth 2.0](https://datatracker.ietf.org/doc/html/rfc6749.html)이라는 방법입니다.일반 OAuth는 앱을 만들어야 하지만, [IndieAuth](https://indieauth.spec.indieweb.org/)의 확장으로 앱을 만들지 않고도 사용할 수 있도록 되어 있습니다.앱 소개를 위한 웹페이지를 만듭니다.페이지가 HTTPS 주소로 접속할 수 있어야 합니다.페이지 어딘가에 아래와 같은 HTML 코드를 작성합니다. OAuth 방식은 사용할 수 있는 라이브러리가 많기 때문에 가능하면 라이브러리를 사용하는 것을 추천합니다. -현재 이 방식을 사용하려면 웹페이지가 필요합니다.웹페이지를 준비할 수 없거나 Misskey 2023.9.0 이전 버전을 지원하고자 하는 경우, 아래의 방법을 사용하시기 바랍니다. +현재 이 방식을 사용하려면 웹페이지가 필요합니다.현재 이 방식을 사용하려면 웹페이지가 필요합니다.웹페이지를 준비할 수 없거나 Misskey 2023.9.0 이전 버전을 지원하고자 하는 경우, 아래의 방법을 사용하시기 바랍니다. - [Misskey 전용 MiAuth 방식으로 액세스 토큰을 얻는 방법](./oauth.md) -- [앱 생성 방식으로 액세스 토큰을 획득하는 방법(구식).](./app.md) +- [앱 생성 방식으로 액세스 토큰을 획득하는 방법(구식).](./app.md)](./app.md) + ::: ::: ## Step 1 -앱 소개를 위한 웹페이지를 만듭니다.페이지가 HTTPS 주소로 접속할 수 있어야 합니다.페이지 어딘가에 아래와 같은 HTML 코드를 작성합니다. +앱 소개를 위한 웹페이지를 만듭니다.페이지가 HTTPS 주소로 접속할 수 있도록 해 주세요.페이지 어딘가에 아래와 같은 HTML 코드를 적습니다. ```html @@ -39,9 +40,9 @@ OAuth 방식은 사용할 수 있는 라이브러리가 많기 때문에 가능 PKCE `code_verifier`와 `code_challenge` 문자열, 그리고 `state` 문자열을 생성합니다. -- code_verifier`의 경우 최소 43자, 최대 128자로 알파벳 대/소문자 및 `-. _\~\` 안에 있는 문자로 제한됩니다. +- code_verifier`의 경우 최소 43자, 최대 128자로 알파벳 대/소문자 및 `-. - code_challenge`문자열은`code_verifier\` 문자열을 SHA256 알고리즘으로 해시하여 base64url로 인코딩한 결과를 사용합니다. -- `state` 문자열에는 특별한 제한이 없습니다. 임의의 문자열을 사용합니다. +- `state` 문자열에는 특별한 제한이 없습니다.임의의 문자열을 사용합니다. :::danger @@ -81,13 +82,13 @@ console.log('state', state); ## Step 3 -상대 서버의 OAuth 정보를 가져옵니다. 데이터는 JSON 형식으로 되어 있습니다. +상대 서버의 OAuth 정보를 가져옵니다.데이터는 JSON 형식으로 되어 있습니다. ``` https://{host}/.well-known/oauth-authorization-server ``` -`{host}`부분은 사용자 서버의 호스트로 대체합니다.보통 호스트는 사용자가 입력합니다. +`{host}`부분은 사용자 서버의 호스트로 대체합니다.보통 호스트는 사용자가 입력합니다._\~\` 안에 있는 문자로 제한됩니다. 여기서는 `authorization_endpoint`와 `token_endpoint`를 사용합니다. @@ -99,7 +100,7 @@ https://{host}/.well-known/oauth-authorization-server ## Step 4 -애플리케이션 인증 양식을 사용자의 브라우저에 표시합니다.인증 양식은 다음 형식의 URL로 열 수 있습니다. +애플리케이션 인증 양식을 사용자의 브라우저에 표시합니다.애플리케이션 인증 양식을 사용자의 브라우저에 표시합니다.인증 양식은 다음 형식의 URL로 열 수 있습니다. ``` {authorization_endpoint}?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&scope={scope}&code_challenge={code_challenge}&code_challenge_method=S256&state={state} @@ -112,7 +113,7 @@ https://{host}/.well-known/oauth-authorization-server - `{code_challenge}`부분은 앞서 생성한 `code_challenge` 문자열로 대체합니다. - `code_challenge_method`부분은 항상 `S256`으로 합니다. - `{redirect_uri}`부분은 소개 페이지에서 사용하고 있는 전송처 주소로 대체합니다. -- `{scope}`부분은 애플리케이션이 요청하는 권한으로 대체합니다.요청하는 권한을 \`\`로 구분하여 열거합니다.권한 목록은 [여기](../permission.md)에서 확인할 수 있습니다. +- `{scope}`부분은 애플리케이션이 요청하는 권한으로 대체합니다.요청하는 권한을 \`\`로 구분하여 열거합니다.권한 목록은 [여기](../permission.md)에서 확인할 수 있습니다.요청할 권한을 ` `로 구분지어 열거합니다.권한 목록은 [여기](../permission.md)에서 확인할 수 있어요. - `{state}`부분은 앞서 생성한 `state` 문자열로 대체합니다. :::tip{label='例'} @@ -144,7 +145,7 @@ https://example.com/redirect?code=...&state=87c11f05-86eb-4eb2-9057-f6a98fc5e9ab ## Step 6 -전송된 인증 코드를 사용하여 POST로 액세스 토큰을 요청합니다.요청 대상은 `token_endpoint`가 됩니다.데이터 형식은 `application/json`과 `application/x-wwww-form-urlencoded`를 사용할 수 있습니다.각 매개변수는 다음과 같습니다. +転送された認証コードを使ってアクセストークンをPOSTでリクエストします。リクエスト先は`token_endpoint`になります。전송된 인증 코드를 사용하여 POST로 액세스 토큰을 요청합니다.요청 대상은 `token_endpoint`가 됩니다.데이터 형식은 `application/json`과 `application/x-wwww-form-urlencoded`를 사용할 수 있습니다.각 매개변수는 다음과 같습니다.각 매개변수는 다음과 같습니다. | 이름 | 설명 | | --------------- | ------------------------------- | diff --git a/content/ko/docs/4.for-developers/api/token/50.app.md b/content/ko/docs/4.for-developers/api/token/50.app.md new file mode 100644 index 00000000..edc0ee11 --- /dev/null +++ b/content/ko/docs/4.for-developers/api/token/50.app.md @@ -0,0 +1,78 @@ +--- +description: MiAuth導入以前（v12.27.0未満）でのアクセストークン取得方法について説明しています。 +--- + +# アプリ作成方式でのアクセストークン取得方法（旧来型） + +[MiAuth](./miauth.md)導入（12.27.0）や[OAuth](./oauth.md)導入（2023.9.0）より前の、旧来のアクセストークン取得方法について説明します。\ +12.27.0未満のバージョンのサーバーではこの旧来の方式を使用する必要があります。 + +## 1. アプリケーションの作成 + +[`app/create`エンドポイント](endpoints/app/create.html)に情報を送信し、`appSecret`を取得します。 + +```json +{ + // アプリの名前 + "name": "test", + // アプリの説明 + "description": "my test application", + // アプリのパーミッション + "permission": ["write:notes"] +} +``` + +この時、`callbackUrl`でお好きなURLを含めると、次のアクセス許可操作が終了したときに`token`をクエリ文字列に含めながらそこにコールバックするようになります。 + +## 2. ユーザーに認証させる + +[`auth/session/generate`エンドポイント](endpoints/auth/session/generate)に`appSecret`をPOSTします。 + +```json +{ + "appSecret": "fAb12cD34Ef56gH78Ij16kL32Mn64oPf" +} +``` + +`token`（ここでは仮に`798b9f6e-248d-43a7-a919-fabc664027f1`）と`url`を返してくるので、まずはこのurlにウェブブラウザでアクセスし「アクセスを許可」を選択。 + +## 3. accessTokenを問い合わせる + +2が終わったことが確認できたら、[`auth/session/userkey`エンドポイント](endpoints/auth/session/userkey)に`appSecret`と先ほどの`token`をPOSTします。 + +```json +{ + "appSecret": "fAb12cD34Ef56gH78Ij16kL32Mn64oPf", + "token": "798b9f6e-248d-43a7-a919-fabc664027f1" +} +``` + +ここで取得できる文字列は`accessToken`と呼ばれます。`accessToken`は一度限りしか取得できません。 + +## 4. iを生成 + +`i`は、Node.jsであれば以下のようなコードで生成でき、設定画面で取得するものとは違って64桁の16進数となります。 + +```javascript +const crypto = require("crypto") +const i = crypto.createHash("sha256") + .update(accessToken + appSecret, "utf8") + .digest("hex") +console.log(i) +``` + +## 5. 実際にテストする + +```javascript +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + i: "/* ここにiを入力 */", + text: "Hello Misskey API World with My Application!" + }), + headers: { + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` diff --git a/content/ko/docs/4.for-developers/bot/1.index.md b/content/ko/docs/4.for-developers/bot/1.index.md index 7d121c55..f8afdb45 100644 --- a/content/ko/docs/4.for-developers/bot/1.index.md +++ b/content/ko/docs/4.for-developers/bot/1.index.md @@ -1,7 +1,6 @@ # Bot 만들기 [Misskey API](/docs/for-developers/api/)를 이용하여 Bot을 개발할 수 있습니다. -또한, 몇 가지 Bot 구현이 공개되어 있으니 참고하시기 바랍니다. - [syuilo/ai](https://github.com/syuilo/ai) ... Node.js에서 동작하는 TypeScript로 만든 Bot 구현 diff --git a/content/ko/docs/4.for-developers/plugin/_dir.yml b/content/ko/docs/4.for-developers/plugin/_dir.yml new file mode 100644 index 00000000..253561bf --- /dev/null +++ b/content/ko/docs/4.for-developers/plugin/_dir.yml @@ -0,0 +1,2 @@ +title: "플러그인 및 Play 생성" +description: "플러그인과 Play를 만드는 방법 및 각종 레퍼런스를 공개 중입니다." diff --git a/content/ko/docs/4.for-developers/plugin/create-plugin.md b/content/ko/docs/4.for-developers/plugin/create-plugin.md index f662fa65..56adc8e7 100644 --- a/content/ko/docs/4.for-developers/plugin/create-plugin.md +++ b/content/ko/docs/4.for-developers/plugin/create-plugin.md @@ -1,7 +1,6 @@ # 플러그인 만들기 Misskey 웹 클라이언트의 플러그인 기능을 사용하면 클라이언트를 확장하고 다양한 기능을 추가할 수 있습니다. -이 문서에서는 플러그인을 만드는 방법을 설명합니다. ## AiScript @@ -9,7 +8,7 @@ Misskey 웹 클라이언트의 플러그인 기능을 사용하면 클라이언 ## 메타데이터 -플러그인은 AiScript의 메타데이터 임베딩 기능을 사용하여 기본적으로 플러그인의 메타데이터를 정의해야 합니다.메타데이터의 예는 다음과 같습니다. +플러그인은 AiScript의 메타데이터 임베딩 기능을 사용하여 기본적으로 플러그인의 메타데이터를 정의해야 합니다.메타데이터의 예는 다음과 같습니다.메타데이터의 예는 다음과 같습니다. ```AiScript /// @ 0.12.4 @@ -33,7 +32,7 @@ Misskey 웹 클라이언트의 플러그인 기능을 사용하면 클라이언 ### version -플러그인 버전.숫자를 지정해 주세요. +플러그인 버전.숫자를 지정해 주세요.숫자를 지정해 주세요. ### description @@ -41,17 +40,15 @@ Misskey 웹 클라이언트의 플러그인 기능을 사용하면 클라이언 ### permissions -플러그인이 요구하는 권한.MisskeyAPI에 요청할 때 사용됩니다. +플러그인이 요구하는 권한.플러그인이 요구하는 권한.MisskeyAPI에 요청할 때 사용됩니다. ### config -플러그인의 설정 정보를 나타내는 객체. -키에 설정명, 값에 다음 속성을 포함합니다. +플러그인의 설정 정보를 나타내는 객체. 키에 설정명, 값에 다음 속성을 포함합니다. 어떤 API가 있는지 [플러그인 API 레퍼런스](./plugin-api-reference/)를 참고하시기 바랍니다. #### type -설정값의 종류를 나타내는 문자열.아래에서 선택하세요. -string number boolean +설정값의 종류를 나타내는 문자열.아래에서 선택하세요.string number boolean #### label @@ -68,10 +65,9 @@ string number boolean ## API Misskey Web은 플러그인에 대해 API를 공개하고 있으며, 이를 이용하여 클라이언트의 기능을 확장할 수 있습니다. -어떤 API가 있는지 [플러그인 API 레퍼런스](./plugin-api-reference/)를 참고하시기 바랍니다. ## 플러그인 배포하기 v2023.11.0 이상에서는 웹 사이트에서 한 번의 클릭으로 플러그인을 직접 설치할 수 있습니다. -플러그인 설치 기능을 제공하는 경우, 사이트에 API를 구현해야 합니다.자세한 내용은 [여기](./publish-on-your-website.md)에서 확인할 수 있습니다. +플러그인 설치 기능을 제공하는 경우, 사이트에 API를 구현해야 합니다.자세한 내용은 [여기](./publish-on-your-website.md)에서 확인할 수 있습니다.자세한 내용은 [여기](./publish-on-your-website.md)에서 확인할 수 있습니다. diff --git a/content/ko/docs/4.for-developers/plugin/plugin-api-reference.md b/content/ko/docs/4.for-developers/plugin/plugin-api-reference.md index 92482930..0ee95662 100644 --- a/content/ko/docs/4.for-developers/plugin/plugin-api-reference.md +++ b/content/ko/docs/4.for-developers/plugin/plugin-api-reference.md @@ -10,16 +10,18 @@ 확인 대화상자를 표시합니다.type에는 다음과 같은 값을 설정할 수 있습니다.\ `info` `success` `warn` `error` `question`\ +생략하면 `question`이 됩니다.확인 대화상자를 표시합니다.type에는 다음과 같은 값을 설정할 수 있습니다.\ +`info` `success` `warn` `error` `question`\ 생략하면 `question`이 됩니다.\ 사용자가 "OK"를 선택하면 `true`를, "취소"를 선택하면 `false`를 반환합니다. ## `Mk:api(endpoint params)` -Misskey API에 요청합니다.첫 번째 인수로 엔드포인트 이름, 두 번째 인수로 매개변수 객체를 전달합니다. +Misskey API에 요청합니다.Misskey API에 요청합니다.첫 번째 인수로 엔드포인트 이름, 두 번째 인수로 매개변수 객체를 전달합니다. ## `Mk:save(key value)` -임의의 값에 임의의 이름을 붙여서 영속화합니다.영속화된 값은 AiScript 컨텍스트가 종료된 후에도 남아서 Mk:load에서 읽을 수 있습니다. +임의의 값에 임의의 이름을 붙여서 영속화합니다.임의의 값에 임의의 이름을 붙여서 영속화합니다.영속화된 값은 AiScript 컨텍스트가 종료된 후에도 남아서 Mk:load에서 읽을 수 있습니다. ## `Mk:load(key)` @@ -27,29 +29,33 @@ Mk:save에서 영속화한 지정된 이름의 값을 읽습니다. ## `Plugin:register_post_form_action(title fn)` -게시 양식에 액션을 추가합니다.첫 번째 인수로 액션 이름, 두 번째 인수로 액션이 선택되었을 때의 콜백 함수를 전달합니다.\ -콜백 함수에는 첫 번째 인수로 게시 양식 객체가 전달됩니다. +게시 양식에 액션을 추가합니다.게시 양식에 액션을 추가합니다.첫 번째 인수로 액션 이름, 두 번째 인수로 액션이 선택되었을 때의 콜백 함수를 전달합니다.\ +콜백 함수에는 첫 번째 인수로 게시 양식 객체가 전달됩니다.대화 상자를 표시합니다.type에는 다음과 같은 값을 설정할 수 있습니다.\ +`info` `success` `warn` `error` `question`\ +생략하면 `info`가 됩니다. ## `Plugin:register_note_action(title fn)` -노트 메뉴에 항목을 추가합니다.첫 번째 인수로 항목 이름, 두 번째 인수로 항목이 선택되었을 때의 콜백 함수를 전달합니다.\ +노트 메뉴에 항목을 추가합니다.첫 번째 인수로 항목 이름, 두 번째 인수로 항목이 선택되었을 때의 콜백 함수를 전달합니다.노트 메뉴에 항목을 추가합니다.첫 번째 인수로 항목 이름, 두 번째 인수로 항목이 선택되었을 때의 콜백 함수를 전달합니다.\ 콜백 함수에는 첫 번째 인수로 대상 노트 객체가 전달됩니다. ## `Plugin:register_user_action(title fn)` -사용자 메뉴에 항목을 추가합니다.첫 번째 인수로 항목 이름, 두 번째 인수로 항목이 선택되었을 때의 콜백 함수를 전달합니다.\ +사용자 메뉴에 항목을 추가합니다.첫 번째 인수로 항목 이름, 두 번째 인수로 항목이 선택되었을 때의 콜백 함수를 전달합니다.사용자 메뉴에 항목을 추가합니다.첫 번째 인수로 항목 이름, 두 번째 인수로 항목이 선택되었을 때의 콜백 함수를 전달합니다.\ 콜백 함수에는 첫 번째 인수로 대상 사용자 객체가 전달됩니다. ## `Plugin:register_note_view_interruptor(fn)` -UI에 표시되는 노트 정보를 다시 작성합니다.\ +UI에 표시되는 노트 정보를 다시 작성합니다.노트 게시시 노트 정보를 다시 작성합니다.\ 콜백 함수에는 첫 번째 인수로 대상 노트 객체가 전달됩니다.\ +콜백 함수의 반환값으로 노트를 다시 작성합니다.\ 콜백 함수의 반환값으로 노트를 다시 작성합니다. ## `Plugin:register_note_post_interruptor(fn)` -노트 게시시 노트 정보를 다시 작성합니다.\ +노트 게시시 노트 정보를 다시 작성합니다.UI에 표시되는 노트 정보를 다시 작성합니다.\ 콜백 함수에는 첫 번째 인수로 대상 노트 객체가 전달됩니다.\ +콜백 함수의 반환값으로 노트를 다시 작성합니다.\ 콜백 함수의 반환값으로 노트를 다시 작성합니다. ## `Plugin:open_url(url)` @@ -58,4 +64,4 @@ UI에 표시되는 노트 정보를 다시 작성합니다.\ ## `Plugin:config` -플러그인 설정이 저장되는 오브젝트입니다.플러그인 정의의 config에서 설정한 키로 값이 들어갑니다. +플러그인 설정이 저장되는 오브젝트입니다.플러그인 정의의 config에서 설정한 키로 값이 들어갑니다.플러그인 정의의 config에서 설정한 키로 값이 들어갑니다. diff --git a/content/ko/docs/4.for-developers/publish-on-your-website.md b/content/ko/docs/4.for-developers/publish-on-your-website.md index 0da287a3..4d8a6816 100644 --- a/content/ko/docs/4.for-developers/publish-on-your-website.md +++ b/content/ko/docs/4.for-developers/publish-on-your-website.md @@ -1,6 +1,6 @@ # 플러그인 테마 배포하기 -Misskey v2023.11.0 이상에서는 다양한 추가 리소스를 웹 사이트에서 직접 설치할 수 있습니다.특히 플러그인이나 테마 등을 많이 제작하는 분이나 플러그인 배포 사이트를 만들고 싶은 분들에게 유용한 기능입니다. +Misskey v2023.11.0 이상에서는 다양한 추가 리소스를 웹 사이트에서 직접 설치할 수 있습니다.특히 플러그인이나 테마 등을 많이 제작하는 분이나 플러그인 배포 사이트를 만들고 싶은 분들에게 유용한 기능입니다.특히 플러그인이나 테마 등을 많이 제작하는 분이나 플러그인 배포 사이트를 만들고 싶은 분들에게 유용한 기능입니다. ## 외부에서 설치할 수 있는 리소스 @@ -23,9 +23,9 @@ Misskey v2023.11.0 이상에서는 다양한 추가 리소스를 웹 사이트 https://{HOST}/install-extentions?url={API_URL}&hash={HASH} ``` -- `{HOST}`: 사용자 서버의 호스트로 대체합니다.호스트는 일반적으로 사용자가 입력할 수 있도록 하는 것이 일반적입니다. -- `{API_URL}`: 리소스 배포용 API(후술)의 URL로 대체합니다.상대 경로 불가 -- `{HASH}`: 배포할 리소스의 SHA-512 해시로 대체합니다.**리소스 내 줄바꿈 코드는 LF로 통일해 주세요.** +- `{HOST}`: 사용자 서버의 호스트로 대체합니다.호스트는 일반적으로 사용자가 입력할 수 있도록 하는 것이 일반적입니다.호스트는 일반적으로 사용자가 입력할 수 있도록 하는 것이 일반적입니다. +- `{API_URL}`: 리소스 배포용 API(후술)의 URL로 대체합니다.상대 경로 불가상대 경로 불가 +- `{HASH}`: 배포할 리소스의 SHA-512 해시로 대체합니다.\*\*리소스 내 줄바꿈 코드는 LF로 통일해 주세요.**구조** ### 리소스 배포용 API 측 diff --git a/content/ko/docs/5.releases.md b/content/ko/docs/5.releases.md index b03eb3bb..a218863d 100644 --- a/content/ko/docs/5.releases.md +++ b/content/ko/docs/5.releases.md @@ -6,6 +6,154 @@ maxTocDepth: 2 Misskey의 릴리즈 노트를 표시합니다. +## 2024.3.1 + +릴리즈 날짜: 2024/03/02 + +### 클라이언트 + +- Fix: 이모지 관련 버그를 수정 (#13485) + - 履歴に残っている or ピン留めされた絵文字がコントロールパネルより削除されていた際にリアクションデッキが表示できなくなる + - Unicode絵文字が履歴に残っている or ピン留めされているとリアクションデッキが表示できなくなる +- Fix: 커스텀 이모지를 불러오는 데에 실패했을 때 텍스트가 아니라 더미 이미지를 표시 #13487 + +## 2024.3.0 + +릴리즈 날짜: 2024/03/01 + +### 일반 + +- Enhance: 投稿者のロールに応じて、一つのノートに含むことのできるメンションとダイレクト投稿の宛先の人数に上限を設定できるように + - デフォルトのメンション上限は20アカウントに設定されます。（管理者はベースロールの設定で変更可能です。） + - 連合の問い合わせに応答しないサーバーのリモートユーザーへのメンションは、上限の人数に含めない実装になっています。 +- Enhance: 通知がミュート、凍結を考慮するようになりました +- Enhance: サーバーごとにモデレーションノートを残せるように +- Enhance: コンディショナルロールの条件に「マニュアルロールへのアサイン」を追加 +- Enhance: 通知の受信設定に「フォロー中またはフォロワー」を追加 +- Enhance: 通知の履歴をリセットできるように +- Fix: ダイレクトなノートに対してはダイレクトでしか返信できないように + +### 클라이언트 + +- Enhance: ノート作成画面のファイル添付メニューの区切り線の位置を調整 +- Fix: syuilo/misskeyの時代からあるインスタンスが改変されたバージョンであると誤認識される問題 +- Fix: MFMのオートコンプリートが出るべき状況で出ないことがある問題を修正 +- Fix: チャートのラベルが消えている問題を修正 +- Fix: 画面表示後最初の音声再生が爆音になることがある問題を修正 +- Fix: 設定のバックアップ作成時に名前を入力しなかった場合、ローカライゼーションがおかしくなる問題を修正 +- Fix: ページ`/admin/emojis`の絵文字編集ダイアログで「リアクションとして使えるロール」を追加する際に何も選択せずOKを押下すると画面が固まる問題を修正 +- Fix: 絵文字サジェストの順位で、絵文字自体の名前が同じものよりもタグで一致しているものが優先されてしまう問題を修正 +- Fix: ユーザの情報のポップアップが消えなくなることがある問題を修正 + +### 서버 + +- Enhance: エンドポイント`flash/update`の`flashId`以外のパラメータは必須ではなくなりました +- Fix: nodeinfoにenableMcaptchaとenableTurnstileが無いのを修正 +- Fix: 破損した通知をクライアントに送信しないように + - 通知欄が無限にリロードされる問題が改善する可能性があります +- Fix: 禁止キーワードを含むノートがDelayed Queueに追加されて再処理される問題を修正 +- Fix: 自分がフォローしていないアカウントのフォロワー限定ノートが閲覧できることがある問題を修正 +- Fix: タイムラインのオプションで「リノートを表示」を無効にしている際、投票のみの引用リノートが流れてこない問題を修正 +- Fix: エンドポイント`admin/emoji/update`の各種修正 + - 必須パラメータを`id`または`name`のいずれかのみに + - `id`の代わりに`name`で絵文字を指定可能に（`id`・`name`両指定時は従来通り`name`を変更する挙動） + - `category`および`licence`が指定なしの時勝手にnullに上書きされる挙動を修正 +- Fix: 通知の受信設定で「相互フォロー」が正しく動作しない問題を修正 + +## 2024.2.0 + +릴리스 날짜: 2024/02/17 + +### 안내 + +- 외부 사이트에서 플러그인을 설치할 때 경로가 `/install-extentions`에서 `/install-extensions`로 변경됩니다.이전 경로에서 자동으로 리디렉션되도록 되어 있지만, 새로운 경로로 변경하는 것이 좋습니다. + +### 일반 + +- Feat: [mCaptcha](https://github.com/mCaptcha/mCaptcha) 지원 추가 +- Feat: TrueMail 지원 추가 +- Feat: AGPLv3 라이선스 실수로 인한 라이선스 위반 방지 기능 추가 + - 관리자가 repositoryUrl을 변경하거나 소스 코드를 직접 배포하도록 선택할 수 있습니다. + - 본체 소스코드 수정 시 라이선스에 따른 적절한 안내를 표시합니다. +- Enhance: 중재자가 모든 사용자들의 반응 목록을 볼 수 있도록 +- Fix: 리스트 라임라인의 '리노트 표시'가 제대로 작동하지 않는 문제 수정 +- Fix: 원격 사용자의 반응 목록이 모두 표시되는 문제 수정 + - 모든 원격 사용자의 반응 목록을 보이지 않게 합니다. +- Fix: 특정 키워드 및 정규식에 일치하는 문자열이 포함된 노트가 게시될 때 오류를 발생시킬 수 있는 설정 항목 추가 #13207 + - 기본값은 비어있기 때문에 적용 전과 동일하게 동작합니다. + +### 클라이언트 + +- Feat: 신규 게임 추가 +- Feat: 음성 및 영상 플레이어 추가 +- Feat: 이모티콘 상세 대화상자 추가 +- Feat: 테두리 넣기 MFM`$[border.width=1,style=solid,color=fff,radius=0 ...]. ` 추가 + - 기본적으로 테두리 밖으로 튀어나온 부분이 숨겨지도록 했습니다.초기 동작과 동일한 동작을 하려면 `$[border.noclip`이 필요합니다. +- Feat: 스와이프로 탭을 전환할 수 있도록 +- Enhance: MFM 등의 코드 블록에 전체 텍스트 복사 버튼 추가 +- Enhance: 해시태그 입력 시 본문 마지막 줄에 아무것도 적혀있지 않을 경우 공백을 새로 추가하지 않도록 +- Enhance: 채널 노트를 노트 메뉴에서 핀으로 고정할 수 있도록 지원 +- Enhance: 관리자의 경우 API token 발급 화면에서 관리 기능에 대한 권한을 부여할 수 있도록 개선. +- Enhance: AiScript를 0.17.0으로 업데이트 [CHANGELOG](https\://github.com/aiscript-dev/aiscript/blob/bb89d132b633a622d3cb0eff0d0cc7e476c0cfdd/ CHANGELOG.md) + - 배열의 범위를 벗어나거나 정수가 아닌 인덱스에 대한 대입이 완전히 금지되므로 주의하세요. +- Enhance: 이모티콘 선택기 자동완성 기능으로 완벽하게 일치하는 이모티콘을 우선적으로 표시합니다. +- Enhance: Play 설명란에 MFM 사용 가능 +- Enhance: 채널 노트의 경우 상세 페이지에서 앞뒤의 노트를 볼 수 있게 함. +- Enhance: 남반구에서도 계절에 따른 화면 연출을 이용할 수 있도록 +- Enhance: 타임라인 필터의 모든 설정이 유지될 수 있도록 + - 지금까지의 'TL에 다른 사람에 대한 답장 포함' 설정은 일단 초기화됩니다. +- Enhance: 타임라인 필터에 '민감한 파일이 포함된 노트 표시'를 추가했습니다. +- Enhance: 노트 작성 화면의 파일 첨부 메뉴에서 직접 파일 삭제 가능 +- Enhance: MFM 속성에서 자동완성 사용 가능 #12735 +- Enhance: 이모티콘 편집 대화창을 모달이 아닌 창으로 표시하도록 개선 +- Enhance: 원격 사용자가 메뉴에서 직접 원격으로 볼 수 있는 기능 제공 +- Enhance: 원격 인용 리노트와 동일한 링크에 대해 링크 미리보기를 표시하지 않도록 설정합니다. +- Enhance: 코드의 구문 하이라이트에 테마를 적용할 수 있도록 +- Enhance: 다음과 같은 이유로 사용할 수 없는 리액션에 대해, 사용 시 하트로 대체하는 대신 리액션 선택기에서 선택할 수 없도록 함. + - 리모트 게시물에 로컬 전용 이모지로 리액션하려는 경우 + - 민감한 이모지를 거부한 노트에 민감한 이모지로 리액션하려는 경우 + - 리액션으로 사용 시 특정 역할만 사용 가능한 이모지로 리액션하려는 경우 +- Enhance: 페이지 전환 시 Player를 닫을 수 있도록 +- Enhance: 신고 페이지의 사용자를 클릭했을 때 사용자가 창을 열 수 있도록 +- Enhance: 노트 신고 시 원격 노트일지라도 자체 인스턴스의 노트 링크가 포함되도록 개선 +- Enhance: 오프라인 디스플레이 디자인 개선 및 다국어 지원 +- Fix: 네이티브 모드에서 이모티콘이 흑백으로 표시되지 않도록 수정 +- Fix: v2023.12.0에서 추가된 '중재자가 사용자의 아이콘 또는 배너 이미지를 미설정 상태로 설정할 수 있는 기능'이 관리자 화면에서 제대로 표시되지 않는 문제 수정 +- Fix: AiScript의 `readline` 함수가 잘못된 값을 반환할 수 있는 문제의 v2023.12.0 시점 수정이 Play 외에는 적용되지 않는 문제를 수정했습니다. +- Fix: v2023.12.1에서 추가된 `$[clickable ...]? ' 및 `onClickEv\`가 제대로 작동하지 않는 문제 수정 +- Fix: Renote의 키보드 단축키가 작동하지 않는 문제 해결 +- Fix: 설문지 제출 양식에서 설문지 날짜 및 시간을 지정한 상태에서 다시 불러오면 날짜가 복원되지 않는 문제 수정 +- Fix: 설문조사를 설정한 노트를 '삭제 후 편집'하면 설문조사의 기일이 이어지지 않고 초기화되는 문제 수정 +- Fix: 덱 프로필 생성 시 이름이 비어있는 문제 수정 +- Fix: 테마 생성 시 이름이 비어있는 상태에서도 생성되는 문제 수정 +- Fix: 플러그인에서 `Plugin:register_note_post_interruptor`를 사용하면 메모를 게시할 수 없는 문제 수정 +- Fix: iOS에서 큰 이미지를 변환하여 업로드할 수 없는 문제 해결 +- Fix: '애니메이션 이미지 재생 안 함' 또는 '데이터 절약(아이콘)'을 활성화해도 아이콘 꾸미기 애니메이션이 멈추지 않는 문제 수정 +- Fix: 이미지 자르기 시 자른 후 해상도가 비정상적으로 낮아지는 문제 수정 +- Fix: 이미지 자르기 시, 이미지 자르기가 정상적으로 완료되지 않는 문제 수정 +- Fix: 캡션이 비어있는 이미지를 자르면 캡션에 null이라는 문자열이 들어가는 문제 수정 +- Fix: 프로필을 편집해도 다시 로드할 때까지 반영되지 않는 문제 수정 +- Fix: 오류 이미지 URL을 설정한 후 해제하면 기본 이미지가 표시되지 않는 문제 수정 +- Fix: MkCodeEditor에서 줄이 어긋나는 문제 해결 +- Fix: Summaly proxy 이용 시 플레이어가 작동하지 않는 현상 수정 #13196 + +### 서버 + +- Enhance: 연합 대상의 속도 제한을 초과했을 때 재시도하도록 개선되었습니다. +- Enhance: ActivityPub Deliver queue에서 Body를 사전 처리하도록 (#12916) +- Enhance: 클립을 내보낼 수 있도록 +- Enhance: `/files`의 파일에 대해 HTTP Range 요청을 할 수 있도록 +- Enhance: `api.json`의 OpenAPI Specification 3.1.0으로 업데이트 +- Enhance: 연합을 위한 노트 배포 경량화 #13192 +- Fix: `drive/files/update`에서 파일명 유효성 검사가 작동하지 않는 문제를 수정했습니다. +- Fix: `notes/create`에서 `text`가 공백으로만 구성되어 있거나 `null`이고 `text`만 있는 요청에 대한 응답이 400이 되도록 변경 +- Fix: `notes/create`에서 `text`가 공백으로만 구성되고 리노트, 파일 또는 투표를 포함하는 요청에 대한 응답의 `text`가 `""`에서 `null`로 변경 +- Fix: ipv4와 ipv6를 모두 사용할 수 있는 환경에서 allowedPrivateNetworks가 설정된 경우 사설 IP를 검증할 수 없는 문제 수정 +- Fix: CC 팔로워를 올바르게 처리 +- Fix: 작업 관련 설정 이름 수정 relashionshipJobPerSec -> relationshipJobPerSec으로 변경 +- Fix: 제어판->조정->'누구나 신규 등록할 수 있도록 허용'의 초기값을 ON에서 OFF로 변경 #13122 +- Fix: 원격 사용자가 부활해도 캐시로 인해 해당 사용자의 Activity가 허용되지 않는 문제 수정 #13273 + ## 2023.12.2 릴리즈 일시: 2023/12/28 @@ -22,14 +170,14 @@ Misskey의 릴리즈 노트를 표시합니다. 릴리스 날짜: 2023/12/27 -### 안내 +### Note - 액세스 토큰의 권한이 재정비되어 일부 API가 이전 API 토큰으로는 작동하지 않습니다.\ 권한이 부족할 경우 권한을 재설정하여 다시 생성해 주세요. ### 일반 -- Enhance: 현지화 갱신 +- Enhance: ローカリゼーションの更新 - Fix: 자신의 direct note가 user list timeline에 추가되지 않음 ### 클라이언트 @@ -228,7 +376,7 @@ Misskey의 릴리즈 노트를 표시합니다. - Enhance: 종속성 업데이트 - Change: CW를 사용할 때 주석을 비우는 것이 더 이상 허용되지 않습니다. -### 클라이언트 +### Client - Feat: 플러그인 테마를 외부 사이트에서 직접 설치할 수 있게 되었습니다. - 외부 사이트에서 구현이 필요합니다.자세한 내용은 Misskey Hub에서 확인할 수 있습니다. @@ -296,14 +444,14 @@ Misskey의 릴리즈 노트를 표시합니다. - Enhance: HTL/LTL/STL을 2023.10.0 업데이트 이전의 내용까지 되짚어 볼 수 있음 - Enhance: 팔로우/팔로우 해제 했을 때 과거의 HTL에도 포함되는 노트가 반영 될 수 있도록 함 - Enhance: 현지화 업데이트 -- Enhance: 종속성 업데이트 +- Enhance: 依存関係の更新 -### 클라이언트 +### Client - Enhance: TL 멘션 표시 옵션을 기억할 수 있도록 함 - Enhance: 시간이 오래 지난 노트를 시각적으로 알기 쉽도록 함 -### 서버 +### Server - Enhance: 타임라인 로딩 시의 퍼포먼스를 향상 - Enhance: 스트리밍 API 퍼포먼스를 향상 @@ -317,15 +465,15 @@ Misskey의 릴리즈 노트를 표시합니다. 릴리스 날짜: 2023/10/12 -### 일반 +### General - Enhance: 로컬 타임라인, 소셜 타임라인에서 멘션을 할지 안할지 설정할 수 있도록 함 -### 클라이언트 +### Client - Fix: 이모지 선택기에서 옆으로 길은 커스텀 이모지가 잘려 보이는 문제를 수정 -### 서버 +### Server - Fix: 본인의 노트에 팔로우 유저로부터 멘션을 해도 타임라인에서 보이지 않는 문제를 수정 - Fix: users/notes에서 열람 주의 채널에 올라온 노트가 포함되는 문제를 수정 @@ -344,7 +492,7 @@ Misskey의 릴리즈 노트를 표시합니다. - API: 더 이상 users/notes, notes/local-timeline에서 fileType 지정을 할 수 없습니다. - API: 앞으로 notes/featured에서 페이지네이션은 다른 API와 같이 untilId로 처리합니다. -### 일반 +### General - Feat: 다른 유저에 멘션한 노트를 타임라인에 표시할지 말지의 설정을 각 유저마다 설정할 수 있습니다. - Feat: 유저 리스트 안에 있는 멤버가 다른 유저에게 보낸 노트를 유저 리스트 타임라인에 보이게 하는지의 여부를 각 유저마다 설정할 수 있습니다. @@ -417,7 +565,7 @@ Misskey의 릴리즈 노트를 표시합니다. - Enhance: ユーザーページのノート一覧でRenoteを除外できるように - Enhance: タイムラインでファイルが添付されたノートのみ表示するオプションを追加 - Enhance: モデレーションログ機能の強化 -- Enhance: 依存関係の更新 +- Enhance: 종속성 업데이트 - Enhance: ローカリゼーションの更新 ### Client @@ -1999,8 +2147,7 @@ same as 12.112.0 ### NOTE -:::warning - +::: warning このバージョンからNode v16.14.0以降が必要です ::: @@ -2113,14 +2260,12 @@ same as 12.112.0 ### Note -:::warning - +::: warning ビルドする前に`npm run clean`を実行してください。 ::: -:::warning - +::: warning このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 @@ -2631,20 +2776,20 @@ same as 12.112.0 ## 12.87.0 -リリース日: 2021/08/12 +릴리스 날짜: 2021/08/12 ### Improvements -- 絵文字オートコンプリートで一文字目は最近使った絵文字をサジェストするように -- 絵文字オートコンプリートのパフォーマンスを改善 -- about-misskeyページにドキュメントへのリンクを追加 -- Docker: Node.jsを16.6.2に -- 依存関係の更新 -- 翻訳の更新 +- 이모지 자동완성에서 첫번쨰 문자에서는 최근 사용한 이모지를 추천하도록 +- 이모지 자동완성의 성능 개선 +- about-misskey페이지에 문서 링크 추가 +- Docker: Node.js를 16.6.2로 +- 의존하는 라이브러리 업데이트 +- 번역 업데이트 ### Bugfixes -- Misskey更新時、テーマキャッシュの影響でスタイルがおかしくなる問題を修正 +- Misskey 업데이트시 테마 캐시 영향으로 스타일이 이상해지는 문제 수정 ## 12.86.0 diff --git a/content/ko/docs/2.for-users/4.resources/donate.md b/content/ko/docs/6.donate.md similarity index 51% rename from content/ko/docs/2.for-users/4.resources/donate.md rename to content/ko/docs/6.donate.md index ae839bc7..0a5fee9b 100644 --- a/content/ko/docs/2.for-users/4.resources/donate.md +++ b/content/ko/docs/6.donate.md @@ -1,6 +1,10 @@ # 프로젝트 기부하기 -Misskey는 비즈니스가 아니며, 이용은 무료이기 때문에 수익은 오직 여러분의 기부금으로만 이루어집니다.(서버에 따라서는 광고 수익을 얻는 경우도 있지만, 이는 운영자의 수익이며 개발자에게 직접적으로 돌아가는 수익은 아닙니다) +:::tip +法人としてプロジェクトへの支援(スポンサー)をご検討の方は[こちらをご覧ください。](/docs/become-a-sponsor/) +::: + +Misskey는 사업이 아니며, 무료로 이용할 수 있기 때문에 수익은 오직 여러분의 기부금 뿐입니다.(서버에 따라서는 광고 수익을 얻는 경우도 있지만, 이는 운영자의 수익이며 개발자에게 직접적으로 돌아가는 수익은 아닙니다) 기부를 해주신다면, 앞으로도 계속 개발할 수 있고, 프로젝트에 기여할 수 있습니다.다음과 같은 방법으로 접수하고 있습니다. - 지속적인 지원 @@ -14,7 +18,7 @@ Misskey는 비즈니스가 아니며, 이용은 무료이기 때문에 수익은 :::tip -고액 기부(예: 5만엔 이상)를 하실 경우, PayPal 등에서는 수수료가 비싸기 때문에 Kyash를 고려하시거나, 연락 주시면 은행 계좌를 알려드리겠습니다. +PayPal 등에서는 수수료가 비싸기 때문에 고액 기부(예: 5만엔 이상)를 하실 경우 Kyash를 고려하시거나, 연락 주신다면 은행 계좌를 알려드리겠습니다. ::: @@ -22,19 +26,19 @@ Misskey는 비즈니스가 아니며, 이용은 무료이기 때문에 수익은 금액에 따라 다음과 같은 보답을 준비했습니다. -- 1,000엔 이상: misskey.io 계정에 mi 배지를 부여합니다. +- 1,000엔 이상: 사용하시는 misskey.io 계정에 mi 배지를 부여 - 3,000엔 이상: ↑ + Misskey의 크레딧에 이름 기재 - 10,000엔 이상: ↑ + Misskey의 크레딧에 이름 + 임의의 아이콘 게재 -::::: +::: :::warning -**배지 부여 및 크레딧에 자동으로 기재되지 않으므로, 원하시는 분은 기부 사실을 알 수 있는 정보를 첨부하여 @syuilo\@misskey.io로 보내주시기 바랍니다.** +**배지 부여 및 크레딧에 자동으로 기재되지 않으므로, 원하시는 분은 기부 사실을 알 수 있는 정보를 첨부하여 @syuilo\@misskey.io로 보내주시기 바랍니다.**::::: -\*\*(멘션을 못 알아볼 수 있으니 답글이 없으면 여러번 멘션 부탁드립니다.또한 misskey.io 외의 서버에서는 멘션이 오지 않을 수 있습니다) +\*\*(멘션을 못 알아볼 수 있으니 답글이 없으면 여러번 멘션 부탁드립니다.또한 misskey.io 외의 서버로부터는 멘션이 도착하지 않는 경우가 있습니다) ::: -또한 서버 운영자도 기본적으로 수익을 얻지 못하고 있습니다.서버 운영에는 비용이 많이 들기 때문에 운영자 지원도 고려해보시기 바랍니다. -개발과는 직접적인 관련이 없지만, 서버가 있어야 프로젝트가 가능하기 때문에 운영이 유지되는 것은 개발 못지않게 중요한 일입니다. +또한 서버 운영자도 기본적으로 수익을 얻지 못하고 있습니다.서버 운영에는 비용이 들기에 운영자에게 지원을 하시는 것도 고려해 주시기 바랍니다. +개발과는 직접적인 관련이 없지만 서버가 없으면 프로젝트도 무용지물이기에, 운영이 유지되는 것은 개발 못지않게 중요한 일입니다. diff --git a/content/ko/docs/7.become-a-sponsor.md b/content/ko/docs/7.become-a-sponsor.md new file mode 100644 index 00000000..54f5d338 --- /dev/null +++ b/content/ko/docs/7.become-a-sponsor.md @@ -0,0 +1,7 @@ +# スポンサーについて + +Misskey Projectはスポンサーを募集しています。 + +スポンサーになると、MisskeyやMisskey Hubへの会社ロゴ掲載や、技術サポートを受けることができます。 + +[詳細はこちらからお問い合わせください。](/contact/) diff --git a/content/pl/docs/2.for-users/2.onboarding/1.warning.md b/content/pl/docs/2.for-users/2.onboarding/1.warning.md index 1056b929..db620b9b 100644 --- a/content/pl/docs/2.for-users/2.onboarding/1.warning.md +++ b/content/pl/docs/2.for-users/2.onboarding/1.warning.md @@ -8,6 +8,7 @@ Misskeyを使ったサービスを利用するにあたり、いくつか注意 - 分散型のため、一度アップロードしたデータは削除したとしても他の全てのサーバーから削除されることは保証されません。(ただし、これはインターネット全般に言えることでもあります。) - 非公開で行った投稿でも、相手のサーバーがそれを同じように非公開として扱うかは保証されません。個人情報、機密情報を投稿する際は十分注意してください。(ただし、これはインターネット全般に言えることでもあります。) +- Misskeyに搭載されている「ドライブ」機能は一般的なクラウドストレージではありません。この機能は、アップロードしたファイルを管理したり再利用したりするためのものです。 **アップロードされたデータは、ノートに添付したことがあるかどうかにかかわらず、URLを知っている人ならだれでもアクセスできます。** 機密情報を含むデータのやりとりには専用のサービスをご利用ください。 - アカウントの削除は負荷の高い処理であるため、長い時間がかかることがあります。アップロードしたデータが多いケースではアカウントの削除が不可能なこともあります。 - サーバーによっては、広告収入により運営費を賄っていることがあります。また、アドブロッカーは広告とは全く関係のないコンテンツや機能を誤ってブロックすることがよくあり、クライアントの動作に支障をきたし、正常にMisskeyを使用できなくなるおそれがあります。そのため、Misskeyではアドブロッカーやそれに類する機能はオフにしてご利用ください。 diff --git a/content/pl/docs/2.for-users/3.features/deck.md b/content/pl/docs/2.for-users/3.features/deck.md index 438a833e..5123a8a7 100644 --- a/content/pl/docs/2.for-users/3.features/deck.md +++ b/content/pl/docs/2.for-users/3.features/deck.md @@ -2,6 +2,7 @@ デッキは利用可能なUIのひとつです。「カラム」と呼ばれるビューを複数並べて表示させることで、カスタマイズ性が高く、情報量の多いUIが構築できることが特徴です。\ \ +\ なお、メインカラムを追加しておくと、ノートやプロフィールをページで表示した際、メインカラムに内容が表示されます。 ## カラムの追加 diff --git a/content/pl/docs/2.for-users/3.features/mfm.md b/content/pl/docs/2.for-users/3.features/mfm.md index 6ec1aa36..7dcdd3cd 100644 --- a/content/pl/docs/2.for-users/3.features/mfm.md +++ b/content/pl/docs/2.for-users/3.features/mfm.md @@ -143,6 +143,16 @@ https://example.com
リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます。 | -| `permission` | アプリケーションが要求する権限。
要求する権限を`,`で区切って列挙します。権限の一覧は[こちら](./permission.md)で確認できます。 | - -:::tip{label='例'} - -``` -https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive -``` - -::: - -#### Step 3 - -ユーザーがアプリケーションアクセスを許可した後、次の形式のURLにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 - -``` -https://{host}/api/miauth/{session}/check -``` - -ここで、 - -- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。 -- `{session}`の部分は、セッションIDに置き換えます。 - -レスポンスに含まれるプロパティは以下の通りです: - -| 名前 | 説明 | -| ------- | -------------- | -| `token` | ユーザーのアクセストークン。 | -| `user` | ユーザーの情報。 | - -## APIの利用 - -アクセストークンが取得できたら、各種エンドポイントにリクエストすることでAPIの利用が行えます。 - -:::tip - -- HTTP APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です（drive/files/createを除く）。 -- 要求ヘッダーに`Content-Type: application/json`を指定します。 -- アクセストークンは、`i`というパラメータ名でリクエストボディJSONに含めます。 -- ベースURLは`https://{サーバーのドメイン}/api`です。 - -::: - -アクセストークン付きのボディの例（metaの場合）: - -```json -{ - "i": "HogEFugA1341", - "detail": false -} -``` - - - -APIの詳細は、APIリファレンスを参照してください。 - -:::warning - -MisskeyはRESTを採用していません。 - -::: - -また、MisskeyはHTTP APIだけでなく、ストリーミングAPIも提供しています。ストリーミングAPIの詳細は[こちらのドキュメント](./streaming/index.md)を参照してください。 diff --git a/content/pl/docs/4.for-developers/api/token/3.oauth.md b/content/pl/docs/4.for-developers/api/token/3.oauth.md index a29644ab..c93f3af6 100644 --- a/content/pl/docs/4.for-developers/api/token/3.oauth.md +++ b/content/pl/docs/4.for-developers/api/token/3.oauth.md @@ -14,7 +14,7 @@ OAuth方式は使えるライブラリが多いので、出来ればライブラ 現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。 -- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md) +- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./miauth.md) - [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md) ::: diff --git a/content/pl/docs/4.for-developers/api/token/50.app.md b/content/pl/docs/4.for-developers/api/token/50.app.md new file mode 100644 index 00000000..edc0ee11 --- /dev/null +++ b/content/pl/docs/4.for-developers/api/token/50.app.md @@ -0,0 +1,78 @@ +--- +description: MiAuth導入以前（v12.27.0未満）でのアクセストークン取得方法について説明しています。 +--- + +# アプリ作成方式でのアクセストークン取得方法（旧来型） + +[MiAuth](./miauth.md)導入（12.27.0）や[OAuth](./oauth.md)導入（2023.9.0）より前の、旧来のアクセストークン取得方法について説明します。\ +12.27.0未満のバージョンのサーバーではこの旧来の方式を使用する必要があります。 + +## 1. アプリケーションの作成 + +[`app/create`エンドポイント](endpoints/app/create.html)に情報を送信し、`appSecret`を取得します。 + +```json +{ + // アプリの名前 + "name": "test", + // アプリの説明 + "description": "my test application", + // アプリのパーミッション + "permission": ["write:notes"] +} +``` + +この時、`callbackUrl`でお好きなURLを含めると、次のアクセス許可操作が終了したときに`token`をクエリ文字列に含めながらそこにコールバックするようになります。 + +## 2. ユーザーに認証させる + +[`auth/session/generate`エンドポイント](endpoints/auth/session/generate)に`appSecret`をPOSTします。 + +```json +{ + "appSecret": "fAb12cD34Ef56gH78Ij16kL32Mn64oPf" +} +``` + +`token`（ここでは仮に`798b9f6e-248d-43a7-a919-fabc664027f1`）と`url`を返してくるので、まずはこのurlにウェブブラウザでアクセスし「アクセスを許可」を選択。 + +## 3. accessTokenを問い合わせる + +2が終わったことが確認できたら、[`auth/session/userkey`エンドポイント](endpoints/auth/session/userkey)に`appSecret`と先ほどの`token`をPOSTします。 + +```json +{ + "appSecret": "fAb12cD34Ef56gH78Ij16kL32Mn64oPf", + "token": "798b9f6e-248d-43a7-a919-fabc664027f1" +} +``` + +ここで取得できる文字列は`accessToken`と呼ばれます。`accessToken`は一度限りしか取得できません。 + +## 4. iを生成 + +`i`は、Node.jsであれば以下のようなコードで生成でき、設定画面で取得するものとは違って64桁の16進数となります。 + +```javascript +const crypto = require("crypto") +const i = crypto.createHash("sha256") + .update(accessToken + appSecret, "utf8") + .digest("hex") +console.log(i) +``` + +## 5. 実際にテストする + +```javascript +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + i: "/* ここにiを入力 */", + text: "Hello Misskey API World with My Application!" + }), + headers: { + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` diff --git a/content/pl/docs/4.for-developers/plugin/_dir.yml b/content/pl/docs/4.for-developers/plugin/_dir.yml new file mode 100644 index 00000000..0be8be5d --- /dev/null +++ b/content/pl/docs/4.for-developers/plugin/_dir.yml @@ -0,0 +1,2 @@ +title: "プラグイン・Playの作成" +description: "プラグインやPlayを作成する方法・各種リファレンスを公開中。" diff --git a/content/pl/docs/5.releases.md b/content/pl/docs/5.releases.md index 17c4324b..59f4524d 100644 --- a/content/pl/docs/5.releases.md +++ b/content/pl/docs/5.releases.md @@ -6,6 +6,154 @@ maxTocDepth: 2 Misskeyのリリースノートを掲載しています。 +## 2024.3.1 + +リリース日: 2024/03/02 + +### Client + +- Fix: 絵文字関係の不具合を修正 (#13485) + - 履歴に残っている or ピン留めされた絵文字がコントロールパネルより削除されていた際にリアクションデッキが表示できなくなる + - Unicode絵文字が履歴に残っている or ピン留めされているとリアクションデッキが表示できなくなる +- Fix: カスタム絵文字の画像読み込みに失敗した際はテキストではなくダミー画像を表示 #13487 + +## 2024.3.0 + +リリース日: 2024/03/01 + +### General + +- Enhance: 投稿者のロールに応じて、一つのノートに含むことのできるメンションとダイレクト投稿の宛先の人数に上限を設定できるように + - デフォルトのメンション上限は20アカウントに設定されます。（管理者はベースロールの設定で変更可能です。） + - 連合の問い合わせに応答しないサーバーのリモートユーザーへのメンションは、上限の人数に含めない実装になっています。 +- Enhance: 通知がミュート、凍結を考慮するようになりました +- Enhance: サーバーごとにモデレーションノートを残せるように +- Enhance: コンディショナルロールの条件に「マニュアルロールへのアサイン」を追加 +- Enhance: 通知の受信設定に「フォロー中またはフォロワー」を追加 +- Enhance: 通知の履歴をリセットできるように +- Fix: ダイレクトなノートに対してはダイレクトでしか返信できないように + +### Client + +- Enhance: ノート作成画面のファイル添付メニューの区切り線の位置を調整 +- Fix: syuilo/misskeyの時代からあるインスタンスが改変されたバージョンであると誤認識される問題 +- Fix: MFMのオートコンプリートが出るべき状況で出ないことがある問題を修正 +- Fix: チャートのラベルが消えている問題を修正 +- Fix: 画面表示後最初の音声再生が爆音になることがある問題を修正 +- Fix: 設定のバックアップ作成時に名前を入力しなかった場合、ローカライゼーションがおかしくなる問題を修正 +- Fix: ページ`/admin/emojis`の絵文字編集ダイアログで「リアクションとして使えるロール」を追加する際に何も選択せずOKを押下すると画面が固まる問題を修正 +- Fix: 絵文字サジェストの順位で、絵文字自体の名前が同じものよりもタグで一致しているものが優先されてしまう問題を修正 +- Fix: ユーザの情報のポップアップが消えなくなることがある問題を修正 + +### Server + +- Enhance: エンドポイント`flash/update`の`flashId`以外のパラメータは必須ではなくなりました +- Fix: nodeinfoにenableMcaptchaとenableTurnstileが無いのを修正 +- Fix: 破損した通知をクライアントに送信しないように + - 通知欄が無限にリロードされる問題が改善する可能性があります +- Fix: 禁止キーワードを含むノートがDelayed Queueに追加されて再処理される問題を修正 +- Fix: 自分がフォローしていないアカウントのフォロワー限定ノートが閲覧できることがある問題を修正 +- Fix: タイムラインのオプションで「リノートを表示」を無効にしている際、投票のみの引用リノートが流れてこない問題を修正 +- Fix: エンドポイント`admin/emoji/update`の各種修正 + - 必須パラメータを`id`または`name`のいずれかのみに + - `id`の代わりに`name`で絵文字を指定可能に（`id`・`name`両指定時は従来通り`name`を変更する挙動） + - `category`および`licence`が指定なしの時勝手にnullに上書きされる挙動を修正 +- Fix: 通知の受信設定で「相互フォロー」が正しく動作しない問題を修正 + +## 2024.2.0 + +リリース日: 2024/02/17 + +### Note + +- 外部サイトからプラグインをインストールする場合のパスが`/install-extentions`から`/install-extensions`に変わります。以前のパスからは自動でリダイレクトされるようになっていますが、新しいパスに変更することをお勧めします。 + +### General + +- Feat: [mCaptcha](https://github.com/mCaptcha/mCaptcha)のサポートを追加 +- Feat: Add support for TrueMail +- Feat: AGPLv3ライセンスに誤って違反するのを防止する機能を追加 + - 管理者がrepositoryUrlを変更したり、またはソースコードを直接頒布することを選択できるようになります + - 本体のソースコードに改変を加えた際に、ライセンスに基づく適切な案内を表示します +- Enhance: モデレーターはすべてのユーザーのリアクション一覧を見られるように +- Fix: リストライムラインの「リノートを表示」が正しく機能しない問題を修正 +- Fix: リモートユーザーのリアクション一覧がすべて見えてしまうのを修正 + - すべてのリモートユーザーのリアクション一覧を見えないようにします +- Fix: 特定のキーワード及び正規表現にマッチする文字列を含むノートが投稿された際、エラーに出来るような設定項目を追加 #13207 + - デフォルトは空欄なので適用前と同等の動作になります + +### Client + +- Feat: 新しいゲームを追加 +- Feat: 音声・映像プレイヤーを追加 +- Feat: 絵文字の詳細ダイアログを追加 +- Feat: 枠線をつけるMFM`$[border.width=1,style=solid,color=fff,radius=0 ...]`を追加 + - デフォルトで枠線からはみ出る部分が隠されるようにしました。初期と同じ挙動にするには`$[border.noclip`が必要です +- Feat: スワイプでタブを切り替えられるように +- Enhance: MFM等のコードブロックに全文コピー用のボタンを追加 +- Enhance: ハッシュタグ入力時に、本文の末尾の行に何も書かれていない場合は新たにスペースを追加しないように +- Enhance: チャンネルノートのピン留めをノートのメニューからできるように +- Enhance: 管理者の場合はAPI tokenの発行画面で管理機能に関する権限を付与できるように +- Enhance: AiScriptを0.17.0に更新 [CHANGELOG](https://github.com/aiscript-dev/aiscript/blob/bb89d132b633a622d3cb0eff0d0cc7e476c0cfdd/CHANGELOG.md) + - 配列の範囲外・非整数のインデックスへの代入が完全禁止になるので注意 +- Enhance: 絵文字ピッカー・オートコンプリートで、完全一致した絵文字を優先的に表示するように +- Enhance: Playの説明欄にMFMを使えるように +- Enhance: チャンネルノートの場合は詳細ページからその前後のノートを見れるように +- Enhance: 季節に応じた画面の演出を南半球でも利用できるように +- Enhance: タイムラインフィルターの設定をすべて保持できるように + - 今までの「TLに他の人への返信を含める」設定は一旦リセットされます +- Enhance: タイムラインフィルターに「センシティブなファイルを含むノートを表示」を追加 +- Enhance: ノート作成画面のファイル添付メニューから直接ファイルを削除できるように +- Enhance: MFMの属性でオートコンプリートが使用できるように #12735 +- Enhance: 絵文字編集ダイアログをモーダルではなくウィンドウで表示するように +- Enhance: リモートのユーザーはメニューから直接リモートで表示できるように +- Enhance: リモートへの引用リノートと同一のリンクにはリンクプレビューを表示しないように +- Enhance: コードのシンタックスハイライトにテーマを適用できるように +- Enhance: リアクション権限がない場合、ハートにフォールバックするのではなくリアクションピッカーなどから打てないように + - リモートのユーザーにローカルのみのカスタム絵文字をリアクションしようとした場合 + - センシティブなリアクションを認めていないユーザーにセンシティブなカスタム絵文字をリアクションしようとした場合 + - ロールが必要な絵文字をリアクションしようとした場合 +- Enhance: ページ遷移時にPlayerを閉じるように +- Enhance: 通報ページのユーザをクリックした際にユーザをウィンドウで開くように +- Enhance: ノートの通報時にリモートのノートであっても自インスタンスにおけるノートのリンクを含むように +- Enhance: オフライン表示のデザインを改善・多言語対応 +- Fix: ネイティブモードの絵文字がモノクロにならないように +- Fix: v2023.12.0で追加された「モデレーターがユーザーのアイコンもしくはバナー画像を未設定状態にできる機能」が管理画面上で正しく表示されていない問題を修正 +- Fix: AiScriptの`readline`関数が不正な値を返すことがある問題のv2023.12.0時点での修正がPlay以外に適用されていないのを修正 +- Fix: v2023.12.1で追加された`$[clickable ...]`および`onClickEv`が正しく機能していないのを修正 +- Fix: Renoteのキーボードショートカットが機能していなかった問題を修正 +- Fix: 投稿フォームでアンケートの日時指定をした状態で再読み込みをすると期日が復元されない問題を修正 +- Fix: アンケートを設定したノートを「削除して編集」をするとアンケートの期日が引き継がれず、リセットされてしまう問題を修正 +- Fix: デッキのプロファイル作成時に名前を空にできる問題を修正 +- Fix: テーマ作成時に名称が空欄でも作成できてしまう問題を修正 +- Fix: プラグインで`Plugin:register_note_post_interruptor`を使用すると、ノートが投稿できなくなる問題を修正 +- Fix: iOSで大きな画像を変換してアップロードできない問題を修正 +- Fix: 「アニメーション画像を再生しない」もしくは「データセーバー（アイコン）」を有効にしていても、アイコンデコレーションのアニメーションが停止されない問題を修正 +- Fix: 画像をクロップするとクロップ後の解像度が異様に低くなる問題の修正 +- Fix: 画像をクロップ時、正常に完了できない問題の修正 +- Fix: キャプションが空の画像をクロップするとキャプションにnullという文字列が入ってしまう問題の修正 +- Fix: プロフィールを編集してもリロードするまで反映されない問題を修正 +- Fix: エラー画像URLを設定した後解除すると，デフォルトの画像が表示されない問題の修正 +- Fix: MkCodeEditorで行がずれていってしまう問題の修正 +- Fix: Summaly proxy利用時にプレイヤーが動作しないことがあるのを修正 #13196 + +### Server + +- Enhance: 連合先のレートリミットを超過した際にリトライするようになりました +- Enhance: ActivityPub Deliver queueでBodyを事前処理するように (#12916) +- Enhance: クリップをエクスポートできるように +- Enhance: `/files`のファイルに対してHTTP Rangeリクエストを行えるように +- Enhance: `api.json`のOpenAPI Specificationを3.1.0に更新 +- Enhance: 連合向けのノート配信を軽量化 #13192 +- Fix: `drive/files/update`でファイル名のバリデーションが機能していない問題を修正 +- Fix: `notes/create`で、`text`が空白文字のみで構成されているか`null`であって、かつ`text`だけであるリクエストに対するレスポンスが400になるように変更 +- Fix: `notes/create`で、`text`が空白文字のみで構成されていてかつリノート、ファイルまたは投票を含んでいるリクエストに対するレスポンスの`text`が`""`から`null`になるように変更 +- Fix: ipv4とipv6の両方が利用可能な環境でallowedPrivateNetworksが設定されていた場合プライベートipの検証ができていなかった問題を修正 +- Fix: properly handle cc followers +- Fix: ジョブに関する設定の名前を修正 relashionshipJobPerSec -> relationshipJobPerSec +- Fix: コントロールパネル->モデレーション->「誰でも新規登録できるようにする」の初期値をONからOFFに変更 #13122 +- Fix: リモートユーザーが復活してもキャッシュにより該当ユーザーのActivityが受け入れられないのを修正 #13273 + ## 2023.12.2 リリース日: 2023/12/28 @@ -1999,8 +2147,7 @@ same as 12.112.0 ### NOTE -:::warning - +::: warning このバージョンからNode v16.14.0以降が必要です ::: @@ -2113,14 +2260,12 @@ same as 12.112.0 ### Note -:::warning - +::: warning ビルドする前に`npm run clean`を実行してください。 ::: -:::warning - +::: warning このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 diff --git a/content/pl/docs/6.donate.md b/content/pl/docs/6.donate.md new file mode 100644 index 00000000..fb912a7d --- /dev/null +++ b/content/pl/docs/6.donate.md @@ -0,0 +1,46 @@ +# プロジェクトへの寄付 + +:::tip +法人としてプロジェクトへの支援(スポンサー)をご検討の方は[こちらをご覧ください。](/docs/become-a-sponsor/) +::: + +Misskeyはビジネスではなく、利用は無料であるため、収益は皆様からの寄付のみです。(サーバーによっては広告収入を得ているような場合もありますが、それは運営者の収入であり直接開発者への収入にはなりません) +寄付をしていただければ、今後も開発を続けることが可能になり、プロジェクトへの貢献になります。以下の方法で受け付けています。 + +- 継続支援 + - [Fanbox](https://syuilo.fanbox.cc/) + - [Patreon](https://www.patreon.com/syuilo) +- 単発支援 + - Kyash: @syuilo + - [PayPal](https://paypal.me/syuilo) + - 仮想通貨: `0xF1121108E21C92aAC7814137DD67e0d48eAC7Fdc` + - [Amazonの欲しいものリスト](https://www.amazon.jp/hz/wishlist/ls/4JG4P6XKX9KD?ref_=wl_share) + +:::tip + +高額の寄付(例えば5万円以上)をされる場合は、PayPal等ですと手数料が高額になってしまいますので、Kyashをご検討いただくか、ご連絡いただければ銀行口座をお伝えいたします。 + +::: + +:::tip + +額に応じて以下の返礼を用意しています。 + +- 1,000円以上: お使いのmisskey.ioアカウントにmiバッジ付与 +- 3,000円以上: ↑ + Misskeyのクレジットへのお名前の記載 +- 10,000円以上: ↑ + Misskeyのクレジットへのお名前+任意のアイコンの掲載 + ::: + +::: + +:::warning + +\*\*バッジ付与やクレジットへの記載は自動で行われないため、ご希望の方は寄付されたことが分かる情報を添えて@syuilo\@misskey.ioまでお申し付けください。また、misskey.io以外のサーバーからはメンション届かない場合があります) +::: + +(メンション気づかない場合があるので返信がなければ複数回メンションお願いします。また、misskey.io以外のサーバーからはメンション届かない場合があります) + +::: + +また、サーバーの運営者も、基本的には収益を得ていません。サーバーの運営にはコストがかかるので、運営者の支援をすることもご検討ください。 +開発には直接関係しませんが、サーバーがあってこそのプロジェクトなので、運営が維持されるというのは開発と同じくらい重要なことです。 diff --git a/content/pl/docs/7.become-a-sponsor.md b/content/pl/docs/7.become-a-sponsor.md new file mode 100644 index 00000000..54f5d338 --- /dev/null +++ b/content/pl/docs/7.become-a-sponsor.md @@ -0,0 +1,7 @@ +# スポンサーについて + +Misskey Projectはスポンサーを募集しています。 + +スポンサーになると、MisskeyやMisskey Hubへの会社ロゴ掲載や、技術サポートを受けることができます。 + +[詳細はこちらからお問い合わせください。](/contact/) diff --git a/content/tw/docs/1.about-misskey.md b/content/tw/docs/1.about-misskey.md index ac4f676c..6420aa44 100644 --- a/content/tw/docs/1.about-misskey.md +++ b/content/tw/docs/1.about-misskey.md @@ -44,11 +44,12 @@ Misskey 的所有原始碼均在開放原始碼許可證[AGPL](https://github.co ## 參與開發和支援專案 -如果您喜歡 Misskey，請支持此專案。如下所述，有多種方式可以為專案做出貢獻。 我們期待您的參與。有些方法不需要任何開發技能，因此任何人都可以輕鬆加入並做出貢獻。我們期待您的參與。 +如果您喜歡 Misskey，請支持此專案。如下所述，有多種方式可以為專案做出貢獻。有些方法不需要任何開發技能，因此任何人都可以輕鬆加入並做出貢獻。我們期待您的參與。 ### 新增功能或修復錯誤 -其他可以幫助您更好地享受 Misskey 的資源。 +如果您具有軟體工程技能，您可以透過編輯原始碼為專案做出貢獻。 +可以在[此處](https://github.com/misskey-dev/misskey/blob/develop/CONTRIBUTING.md)找到貢獻指南。 ### 加入討論 @@ -71,7 +72,7 @@ Miskist 是指使用Misskey的人。 如果您透過向朋友和熟人介紹來 ### 捐款 -[請查看這裡](/docs/donate/) +[請查看這裡](/docs/for-users/resources/donate/) ## 常見問題 @@ -98,8 +99,7 @@ Miskist 是指使用Misskey的人。 如果您透過向朋友和熟人介紹來 ### 應該選擇哪個伺服器？ -[請參考伺服器清單。](/servers/) -有時候，伺服器會設定社群的主題（例如特定的事物或喜好）。因此，如果能找到符合自己興趣的伺服器，可能是個不錯的選擇。 +[請參考伺服器清單。因此，如果能找到符合自己興趣的伺服器，可能是個不錯的選擇。 此外，還有其他考慮因素，如伺服器的規模、使用者層、國家和語言，以及運營者是否可信賴等。 需要注意的是，Misskey沒有官方的伺服器。您也可以選擇自己建立新伺服器。 diff --git a/content/tw/docs/2.for-users/2.onboarding/1.warning.md b/content/tw/docs/2.for-users/2.onboarding/1.warning.md index 5831d206..96131f00 100644 --- a/content/tw/docs/2.for-users/2.onboarding/1.warning.md +++ b/content/tw/docs/2.for-users/2.onboarding/1.warning.md @@ -8,6 +8,7 @@ description: 這些是在 Misskey 伺服器上建立帳戶之前的一些基本 - 由於它是分散式的，即使您上傳資料後將其刪除，也不能保證它會從所有其他伺服器上刪除。(不過一般來說網際網路也是如此。) - 即使您以不公開設置發布貼文，也不能保證其他伺服器會以同樣的方式將其視為不公開貼文。發布個人資訊和機密資訊時要小心謹慎。(不過一般來說網際網路也是如此。) +- Misskeyに搭載されている「ドライブ」機能は一般的なクラウドストレージではありません。この機能は、アップロードしたファイルを管理したり再利用したりするためのものです。 **アップロードされたデータは、ノートに添付したことがあるかどうかにかかわらず、URLを知っている人ならだれでもアクセスできます。** 機密情報を含むデータのやりとりには専用のサービスをご利用ください。 - 帳戶刪除是一個負擔重的處理，可能需要很長時間。如果上傳了大量數據，則可能無法刪除該帳戶。 - 有些伺服器可能透過廣告收入來支付營運成本。此外，廣告攔截器經常會無意中攔截與廣告無關的內容和功能，這可能會干擾客戶端的操作，使他們無法正常使用 Misskey。因此，在使用Misskey時，請關閉廣告攔截器和類似功能。 diff --git a/content/tw/docs/2.for-users/2.onboarding/2.get-started.md b/content/tw/docs/2.for-users/2.onboarding/2.get-started.md index deff9106..17737560 100644 --- a/content/tw/docs/2.for-users/2.onboarding/2.get-started.md +++ b/content/tw/docs/2.for-users/2.onboarding/2.get-started.md @@ -12,9 +12,9 @@ Misskey 是一款軟體及其專案。 :::tip -どのサーバーを選んでも、他のサーバーのユーザーとやり取りすることができます。 +無論您選擇哪個伺服器，您都可以與其他伺服器的使用者互動。 -:::g-details{summary='詳細'} +:::g-details{summary='詳情'} Misskey 具有聯邦功能。 diff --git a/content/tw/docs/2.for-users/2.onboarding/3.join-server.md b/content/tw/docs/2.for-users/2.onboarding/3.join-server.md index 6fea7507..3dfeb49e 100644 --- a/content/tw/docs/2.for-users/2.onboarding/3.join-server.md +++ b/content/tw/docs/2.for-users/2.onboarding/3.join-server.md @@ -4,7 +4,7 @@ :::tip -ここでは、Misskey.ioを例にとって紹介していますが、他のサーバーでも登録方法はおおむね同じです。 +這裡以Misskey.io為例，但其他伺服器的註冊方法大致相同。 但是，您需要輸入的資訊可能會因伺服器而異。請聯絡您的伺服器管理員以取得更多資訊。 diff --git a/content/tw/docs/2.for-users/3.features/mfm.md b/content/tw/docs/2.for-users/3.features/mfm.md index b335d9dc..72f1784b 100644 --- a/content/tw/docs/2.for-users/3.features/mfm.md +++ b/content/tw/docs/2.for-users/3.features/mfm.md @@ -44,7 +44,7 @@ MFM 代表 Markup language For Misskey，是一種專有的標記語言，可以 ### 主題標籤 -「# + 標籤」來表示主題標籤。 +可以使用"#"符號後加文字表示主題標籤。 :::tip 有關主題標籤的更多資訊，請參閱[此處](./hashtag.md)。 @@ -77,7 +77,7 @@ https://example.com :::tip -リンクテキストの前に`?`をつけると、リンクプレビューを非表示にすることができます。 +您可以透過在連結文字前面加上 `?` 來隱藏連結預覽。 ``` ?[example link](https://example.com) @@ -90,9 +90,10 @@ https://example.com ### 自訂表情符號 您可以透過用冒號包圍自訂表情符號名稱來顯示自訂表情符號。 + :::tip -有關自訂表情符號的更多信息，請參閱[此處](./custom-emoji.md)。 +有關自訂表情符號的更多資訊，請參閱[此處](./custom-emoji.md)。 ::: @@ -104,7 +105,7 @@ https://example.com ### 粗體 -可以將文字顯示为粗體来強調。 +您可以將文字加粗以強調它。 ``` **粗體** @@ -142,6 +143,16 @@ https://example.com
重導向時，工作階段 ID 會附加到查詢參數 `session`。 | -| `permission` | 應用程式所需的權限。
列舉所請求的授權，以半形逗號 `,` 分隔。可以在[此處](./permission.md)查看權限清單。 | - -:::tip{label='例'} - -``` -https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive -``` - -::: - -#### 步驟3 - -使用者授予應用程式存取權限後，向下列格式的網址傳送 POST 請求，將傳回一個包含存取權杖的 JSON 作為回應。 - -``` -https://{host}/api/miauth/{session}/check -``` - -需要變更的部份 - -- 將 `{host}` 替換為使用者伺服器的主機。 -- 將 `{session}` 替換為工作階段 ID。 - -回應中包含的屬性有： - -| 名稱 | 說明 | -| ------- | --------- | -| `token` | 使用者的存取權杖。 | -| `user` | 使用者資料。 | - -## 使用API - -取得存取權杖後，就可以透過向各種端點發出請求來使用API。 - -:::tip - -- 所有 HTTP API 均為 POST，請求和回應均為 JSON 格式（drive/files/create 除外）。 -- 在請求標頭中指定 `Content-Type: application/json`。 -- 存取權杖包含在請求內文 JSON 中，參數名為 `i`。 -- 基礎網址是 `https://{伺服器網域}/api`。 - -::: - -帶有存取權杖（中介資訊）的正文範例： - -```json -{ - "i": "HogEFugA1341", - "detail": false -} -``` - - - -有關 API 的更多資訊，請參閱 API 參考。 - -:::warning - -Misskey 不使用 REST。 - -::: - -此外，Misskey 不僅提供 HTTP API，還提供資料流 API。有關資料流 API 的詳細資訊，請參閱[此文件](./streaming/index.md)。 diff --git a/content/tw/docs/4.for-developers/api/token/2.miauth.md b/content/tw/docs/4.for-developers/api/token/2.miauth.md index 9cfe21cb..1100db0d 100644 --- a/content/tw/docs/4.for-developers/api/token/2.miauth.md +++ b/content/tw/docs/4.for-developers/api/token/2.miauth.md @@ -30,7 +30,7 @@ UUIDを生成する。以後これを**セッションID**と呼びます。 アプリケーション認証フォームをユーザーのブラウザで表示させる。認証フォームは、以下の形式のURLで開くことができます: ``` -https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive +https://{host}/miauth/{session} ``` ここで、 @@ -38,7 +38,7 @@ https://misskey.io/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callba - `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。通常ホストはユーザーが入力します。 - `{session}`の部分は、セッションIDに置き換えます。 -使用者授予應用程式存取權限後，向下列格式的網址傳送 POST 請求，將傳回一個包含存取權杖的 JSON 作為回應。 +また、URLにクエリパラメータとしていくつかのオプションを設定できます: | 名前 | 説明 | | ------------ | ------------------------------------------------------------------------------ | @@ -65,8 +65,8 @@ https://{host}/api/miauth/{session}/check ここで、 -- 所有 HTTP API 均為 POST，請求和回應均為 JSON 格式（drive/files/create 除外）。 -- 在請求標頭中指定 `Content-Type: application/json`。 +- `{host}`の部分は、ユーザーのサーバーのホストに置き換えます。 +- `{session}`の部分は、セッションIDに置き換えます。 レスポンスに含まれるプロパティは以下の通りです: diff --git a/content/tw/docs/4.for-developers/api/token/3.oauth.md b/content/tw/docs/4.for-developers/api/token/3.oauth.md index a29644ab..c93f3af6 100644 --- a/content/tw/docs/4.for-developers/api/token/3.oauth.md +++ b/content/tw/docs/4.for-developers/api/token/3.oauth.md @@ -14,7 +14,7 @@ OAuth方式は使えるライブラリが多いので、出来ればライブラ 現在、この方式を使うためにはウェブページが必要になります。どうしてもウェブページを用意できない場合、もしくはMisskey 2023.9.0以前のバージョンをサポートしたい場合、以下の方式を使ってください。 -- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./oauth.md) +- [Misskey専用のMiAuth方式でのアクセストークン取得方法](./miauth.md) - [アプリ作成方式でのアクセストークン取得方法（旧来型）。](./app.md) ::: diff --git a/content/tw/docs/4.for-developers/api/token/50.app.md b/content/tw/docs/4.for-developers/api/token/50.app.md new file mode 100644 index 00000000..edc0ee11 --- /dev/null +++ b/content/tw/docs/4.for-developers/api/token/50.app.md @@ -0,0 +1,78 @@ +--- +description: MiAuth導入以前（v12.27.0未満）でのアクセストークン取得方法について説明しています。 +--- + +# アプリ作成方式でのアクセストークン取得方法（旧来型） + +[MiAuth](./miauth.md)導入（12.27.0）や[OAuth](./oauth.md)導入（2023.9.0）より前の、旧来のアクセストークン取得方法について説明します。\ +12.27.0未満のバージョンのサーバーではこの旧来の方式を使用する必要があります。 + +## 1. アプリケーションの作成 + +[`app/create`エンドポイント](endpoints/app/create.html)に情報を送信し、`appSecret`を取得します。 + +```json +{ + // アプリの名前 + "name": "test", + // アプリの説明 + "description": "my test application", + // アプリのパーミッション + "permission": ["write:notes"] +} +``` + +この時、`callbackUrl`でお好きなURLを含めると、次のアクセス許可操作が終了したときに`token`をクエリ文字列に含めながらそこにコールバックするようになります。 + +## 2. ユーザーに認証させる + +[`auth/session/generate`エンドポイント](endpoints/auth/session/generate)に`appSecret`をPOSTします。 + +```json +{ + "appSecret": "fAb12cD34Ef56gH78Ij16kL32Mn64oPf" +} +``` + +`token`（ここでは仮に`798b9f6e-248d-43a7-a919-fabc664027f1`）と`url`を返してくるので、まずはこのurlにウェブブラウザでアクセスし「アクセスを許可」を選択。 + +## 3. accessTokenを問い合わせる + +2が終わったことが確認できたら、[`auth/session/userkey`エンドポイント](endpoints/auth/session/userkey)に`appSecret`と先ほどの`token`をPOSTします。 + +```json +{ + "appSecret": "fAb12cD34Ef56gH78Ij16kL32Mn64oPf", + "token": "798b9f6e-248d-43a7-a919-fabc664027f1" +} +``` + +ここで取得できる文字列は`accessToken`と呼ばれます。`accessToken`は一度限りしか取得できません。 + +## 4. iを生成 + +`i`は、Node.jsであれば以下のようなコードで生成でき、設定画面で取得するものとは違って64桁の16進数となります。 + +```javascript +const crypto = require("crypto") +const i = crypto.createHash("sha256") + .update(accessToken + appSecret, "utf8") + .digest("hex") +console.log(i) +``` + +## 5. 実際にテストする + +```javascript +fetch("https://misskey.io/api/notes/create", { + method: 'POST', + body: JSON.stringify({ + i: "/* ここにiを入力 */", + text: "Hello Misskey API World with My Application!" + }), + headers: { + 'Content-Type': 'application/json', + }, + credentials: 'omit', +}); +``` diff --git a/content/tw/docs/4.for-developers/bot/1.index.md b/content/tw/docs/4.for-developers/bot/1.index.md index 27d76983..32598a6c 100644 --- a/content/tw/docs/4.for-developers/bot/1.index.md +++ b/content/tw/docs/4.for-developers/bot/1.index.md @@ -1,6 +1,6 @@ # 創建機器人（Bot） -利用 [Misskey API](/docs/for-developers/api/) 可以開發機器人。此外，已經公開了一些機器人實現，請務必參考。 +利用 [Misskey API](/docs/for-developers/api/) 可以開發機器人。 - [syuilo/ai](https://github.com/syuilo/ai) ... 使用 TypeScript 實作的機器人，在 Node.js 上運行 diff --git a/content/tw/docs/4.for-developers/plugin/_dir.yml b/content/tw/docs/4.for-developers/plugin/_dir.yml new file mode 100644 index 00000000..f253d5ca --- /dev/null +++ b/content/tw/docs/4.for-developers/plugin/_dir.yml @@ -0,0 +1,2 @@ +title: "創建插件/Play" +description: "如何建立插件和 Play 以及各種參考資料。" diff --git a/content/tw/docs/5.releases.md b/content/tw/docs/5.releases.md index d276b28c..1a6795fc 100644 --- a/content/tw/docs/5.releases.md +++ b/content/tw/docs/5.releases.md @@ -6,15 +6,163 @@ maxTocDepth: 2 Misskey 的版本資訊被發布在此。 +## 2024.3.1 + +リリース日: 2024/03/02 + +### 客戶端 + +- Fix: 絵文字関係の不具合を修正 (#13485) + - 履歴に残っている or ピン留めされた絵文字がコントロールパネルより削除されていた際にリアクションデッキが表示できなくなる + - Unicode絵文字が履歴に残っている or ピン留めされているとリアクションデッキが表示できなくなる +- Fix: カスタム絵文字の画像読み込みに失敗した際はテキストではなくダミー画像を表示 #13487 + +## 2024.3.0 + +リリース日: 2024/03/01 + +### 一般 + +- Enhance: 投稿者のロールに応じて、一つのノートに含むことのできるメンションとダイレクト投稿の宛先の人数に上限を設定できるように + - デフォルトのメンション上限は20アカウントに設定されます。（管理者はベースロールの設定で変更可能です。） + - 連合の問い合わせに応答しないサーバーのリモートユーザーへのメンションは、上限の人数に含めない実装になっています。 +- Enhance: 通知がミュート、凍結を考慮するようになりました +- Enhance: サーバーごとにモデレーションノートを残せるように +- Enhance: コンディショナルロールの条件に「マニュアルロールへのアサイン」を追加 +- Enhance: 通知の受信設定に「フォロー中またはフォロワー」を追加 +- Enhance: 通知の履歴をリセットできるように +- Fix: ダイレクトなノートに対してはダイレクトでしか返信できないように + +### Client + +- Enhance: ノート作成画面のファイル添付メニューの区切り線の位置を調整 +- Fix: syuilo/misskeyの時代からあるインスタンスが改変されたバージョンであると誤認識される問題 +- Fix: MFMのオートコンプリートが出るべき状況で出ないことがある問題を修正 +- Fix: チャートのラベルが消えている問題を修正 +- Fix: 画面表示後最初の音声再生が爆音になることがある問題を修正 +- Fix: 設定のバックアップ作成時に名前を入力しなかった場合、ローカライゼーションがおかしくなる問題を修正 +- Fix: ページ`/admin/emojis`の絵文字編集ダイアログで「リアクションとして使えるロール」を追加する際に何も選択せずOKを押下すると画面が固まる問題を修正 +- Fix: 絵文字サジェストの順位で、絵文字自体の名前が同じものよりもタグで一致しているものが優先されてしまう問題を修正 +- Fix: ユーザの情報のポップアップが消えなくなることがある問題を修正 + +### 伺服器 + +- Enhance: エンドポイント`flash/update`の`flashId`以外のパラメータは必須ではなくなりました +- Fix: nodeinfoにenableMcaptchaとenableTurnstileが無いのを修正 +- Fix: 破損した通知をクライアントに送信しないように + - 通知欄が無限にリロードされる問題が改善する可能性があります +- Fix: 禁止キーワードを含むノートがDelayed Queueに追加されて再処理される問題を修正 +- Fix: 自分がフォローしていないアカウントのフォロワー限定ノートが閲覧できることがある問題を修正 +- Fix: タイムラインのオプションで「リノートを表示」を無効にしている際、投票のみの引用リノートが流れてこない問題を修正 +- Fix: エンドポイント`admin/emoji/update`の各種修正 + - 必須パラメータを`id`または`name`のいずれかのみに + - `id`の代わりに`name`で絵文字を指定可能に（`id`・`name`両指定時は従来通り`name`を変更する挙動） + - `category`および`licence`が指定なしの時勝手にnullに上書きされる挙動を修正 +- Fix: 通知の受信設定で「相互フォロー」が正しく動作しない問題を修正 + +## 2024.2.0 + +リリース日: 2024/02/17 + +### 註記 + +- 外部サイトからプラグインをインストールする場合のパスが`/install-extentions`から`/install-extensions`に変わります。以前のパスからは自動でリダイレクトされるようになっていますが、新しいパスに変更することをお勧めします。 + +### General + +- Feat: [mCaptcha](https://github.com/mCaptcha/mCaptcha)のサポートを追加 +- Feat: Add support for TrueMail +- Feat: AGPLv3ライセンスに誤って違反するのを防止する機能を追加 + - 管理者がrepositoryUrlを変更したり、またはソースコードを直接頒布することを選択できるようになります + - 本体のソースコードに改変を加えた際に、ライセンスに基づく適切な案内を表示します +- Enhance: モデレーターはすべてのユーザーのリアクション一覧を見られるように +- Fix: リストライムラインの「リノートを表示」が正しく機能しない問題を修正 +- Fix: リモートユーザーのリアクション一覧がすべて見えてしまうのを修正 + - すべてのリモートユーザーのリアクション一覧を見えないようにします +- Fix: 特定のキーワード及び正規表現にマッチする文字列を含むノートが投稿された際、エラーに出来るような設定項目を追加 #13207 + - デフォルトは空欄なので適用前と同等の動作になります + +### Client + +- Feat: 新しいゲームを追加 +- Feat: 音声・映像プレイヤーを追加 +- Feat: 絵文字の詳細ダイアログを追加 +- Feat: 枠線をつけるMFM`$[border.width=1,style=solid,color=fff,radius=0 ...]`を追加 + - デフォルトで枠線からはみ出る部分が隠されるようにしました。初期と同じ挙動にするには`$[border.noclip`が必要です +- Feat: スワイプでタブを切り替えられるように +- Enhance: MFM等のコードブロックに全文コピー用のボタンを追加 +- Enhance: ハッシュタグ入力時に、本文の末尾の行に何も書かれていない場合は新たにスペースを追加しないように +- Enhance: チャンネルノートのピン留めをノートのメニューからできるように +- Enhance: 管理者の場合はAPI tokenの発行画面で管理機能に関する権限を付与できるように +- Enhance: AiScriptを0.17.0に更新 [CHANGELOG](https://github.com/aiscript-dev/aiscript/blob/bb89d132b633a622d3cb0eff0d0cc7e476c0cfdd/CHANGELOG.md) + - 配列の範囲外・非整数のインデックスへの代入が完全禁止になるので注意 +- Enhance: 絵文字ピッカー・オートコンプリートで、完全一致した絵文字を優先的に表示するように +- Enhance: Playの説明欄にMFMを使えるように +- Enhance: チャンネルノートの場合は詳細ページからその前後のノートを見れるように +- Enhance: 季節に応じた画面の演出を南半球でも利用できるように +- Enhance: タイムラインフィルターの設定をすべて保持できるように + - 今までの「TLに他の人への返信を含める」設定は一旦リセットされます +- Enhance: タイムラインフィルターに「センシティブなファイルを含むノートを表示」を追加 +- Enhance: ノート作成画面のファイル添付メニューから直接ファイルを削除できるように +- Enhance: MFMの属性でオートコンプリートが使用できるように #12735 +- Enhance: 絵文字編集ダイアログをモーダルではなくウィンドウで表示するように +- Enhance: リモートのユーザーはメニューから直接リモートで表示できるように +- Enhance: リモートへの引用リノートと同一のリンクにはリンクプレビューを表示しないように +- Enhance: コードのシンタックスハイライトにテーマを適用できるように +- Enhance: リアクション権限がない場合、ハートにフォールバックするのではなくリアクションピッカーなどから打てないように + - リモートのユーザーにローカルのみのカスタム絵文字をリアクションしようとした場合 + - センシティブなリアクションを認めていないユーザーにセンシティブなカスタム絵文字をリアクションしようとした場合 + - ロールが必要な絵文字をリアクションしようとした場合 +- Enhance: ページ遷移時にPlayerを閉じるように +- Enhance: 通報ページのユーザをクリックした際にユーザをウィンドウで開くように +- Enhance: ノートの通報時にリモートのノートであっても自インスタンスにおけるノートのリンクを含むように +- Enhance: オフライン表示のデザインを改善・多言語対応 +- Fix: ネイティブモードの絵文字がモノクロにならないように +- Fix: v2023.12.0で追加された「モデレーターがユーザーのアイコンもしくはバナー画像を未設定状態にできる機能」が管理画面上で正しく表示されていない問題を修正 +- Fix: AiScriptの`readline`関数が不正な値を返すことがある問題のv2023.12.0時点での修正がPlay以外に適用されていないのを修正 +- Fix: v2023.12.1で追加された`$[clickable ...]`および`onClickEv`が正しく機能していないのを修正 +- Fix: Renoteのキーボードショートカットが機能していなかった問題を修正 +- Fix: 投稿フォームでアンケートの日時指定をした状態で再読み込みをすると期日が復元されない問題を修正 +- Fix: アンケートを設定したノートを「削除して編集」をするとアンケートの期日が引き継がれず、リセットされてしまう問題を修正 +- Fix: デッキのプロファイル作成時に名前を空にできる問題を修正 +- Fix: テーマ作成時に名称が空欄でも作成できてしまう問題を修正 +- Fix: プラグインで`Plugin:register_note_post_interruptor`を使用すると、ノートが投稿できなくなる問題を修正 +- Fix: iOSで大きな画像を変換してアップロードできない問題を修正 +- Fix: 「アニメーション画像を再生しない」もしくは「データセーバー（アイコン）」を有効にしていても、アイコンデコレーションのアニメーションが停止されない問題を修正 +- Fix: 画像をクロップするとクロップ後の解像度が異様に低くなる問題の修正 +- Fix: 画像をクロップ時、正常に完了できない問題の修正 +- Fix: キャプションが空の画像をクロップするとキャプションにnullという文字列が入ってしまう問題の修正 +- Fix: プロフィールを編集してもリロードするまで反映されない問題を修正 +- Fix: エラー画像URLを設定した後解除すると，デフォルトの画像が表示されない問題の修正 +- Fix: MkCodeEditorで行がずれていってしまう問題の修正 +- Fix: Summaly proxy利用時にプレイヤーが動作しないことがあるのを修正 #13196 + +### Server + +- Enhance: 連合先のレートリミットを超過した際にリトライするようになりました +- Enhance: ActivityPub Deliver queueでBodyを事前処理するように (#12916) +- Enhance: クリップをエクスポートできるように +- Enhance: `/files`のファイルに対してHTTP Rangeリクエストを行えるように +- Enhance: `api.json`のOpenAPI Specificationを3.1.0に更新 +- Enhance: 連合向けのノート配信を軽量化 #13192 +- Fix: `drive/files/update`でファイル名のバリデーションが機能していない問題を修正 +- Fix: `notes/create`で、`text`が空白文字のみで構成されているか`null`であって、かつ`text`だけであるリクエストに対するレスポンスが400になるように変更 +- Fix: `notes/create`で、`text`が空白文字のみで構成されていてかつリノート、ファイルまたは投票を含んでいるリクエストに対するレスポンスの`text`が`""`から`null`になるように変更 +- Fix: ipv4とipv6の両方が利用可能な環境でallowedPrivateNetworksが設定されていた場合プライベートipの検証ができていなかった問題を修正 +- Fix: properly handle cc followers +- Fix: ジョブに関する設定の名前を修正 relashionshipJobPerSec -> relationshipJobPerSec +- Fix: コントロールパネル->モデレーション->「誰でも新規登録できるようにする」の初期値をONからOFFに変更 #13122 +- Fix: リモートユーザーが復活してもキャッシュにより該当ユーザーのActivityが受け入れられないのを修正 #13273 + ## 2023.12.2 リリース日: 2023/12/28 -### 一般 +### General - v2023.12.1でDockerを利用してサーバーを起動できない問題を修正 -### 客戶端 +### Client - Enhance: 検索画面においてEnterキー押下で検索できるように @@ -22,14 +170,14 @@ Misskey 的版本資訊被發布在此。 リリース日: 2023/12/27 -### 註記 +### Note - アクセストークンの権限が再整理されたため、一部のAPIが古いAPIトークンでは動作しなくなりました。\ 権限不足になる場合には権限を再設定して再生成してください。 ### General -- Enhance: 在地化更新 +- Enhance: ローカリゼーションの更新 - Fix: 自分のdirect noteがuser list timelineに追加されない ### Client @@ -39,7 +187,7 @@ Misskey 的版本資訊被發布在此。 - Fix: 一部のモデログ(logYellowでの表示対象)について、表示の色が変わらない問題を修正 - Fix: `fg`/`bg`MFMに長い単語を指定すると、オーバーフローされずはみ出る問題を修正 -### 伺服器 +### Server - Enhance: センシティブワードの設定がハッシュタグトレンドにも適用されるようになりました - Enhance: `oauth/token`エンドポイントのCORS対応 @@ -77,7 +225,7 @@ Misskey 的版本資訊被發布在此。 - Enhance: アイコンデコレーションを複数設定できるように - Enhance: アイコンデコレーションの位置を微調整できるように - Enhance: つながりの公開範囲をフォロー/フォロワーで個別に設定可能に #12072 -- Enhance: ローカリゼーションの更新 +- Enhance: 在地化更新 - Enhance: 依賴關係更新 - Fix: MFM `$[unixtime ]` に不正な値を入力した際に発生する各種エラーを修正 @@ -1999,8 +2147,7 @@ same as 12.112.0 ### NOTE -:::warning - +::: warning このバージョンからNode v16.14.0以降が必要です ::: @@ -2113,14 +2260,12 @@ same as 12.112.0 ### Note -:::warning - +::: warning ビルドする前に`npm run clean`を実行してください。 ::: -:::warning - +::: warning このリリースはマイグレーションの規模が大きいため、インスタンスによってはマイグレーションに時間がかかる可能性があります。 マイグレーションが終わらない場合は、チャートの情報はリセットされてしまいますが`__chart__`で始まるテーブルの**レコード**を全て削除(テーブル自体は消さないでください)してから再度試す方法もあります。 diff --git a/content/tw/docs/2.for-users/4.resources/donate.md b/content/tw/docs/6.donate.md similarity index 84% rename from content/tw/docs/2.for-users/4.resources/donate.md rename to content/tw/docs/6.donate.md index 2cdb8c28..9ba4ff8e 100644 --- a/content/tw/docs/2.for-users/4.resources/donate.md +++ b/content/tw/docs/6.donate.md @@ -1,5 +1,9 @@ # 贊助此專案 +:::tip +法人としてプロジェクトへの支援(スポンサー)をご検討の方は[こちらをご覧ください。](/docs/become-a-sponsor/) +::: + Misskey不是一家企業，由於它是免費使用的，開發者所能獲得的收入來自各位的捐款。（某些伺服器可能會有廣告收入，但那是運營者的收入而不是直接給開發人員的收入） 您的捐款讓開發能夠持續下去並為本專案做出貢獻。我們接受以下的捐款方式： @@ -20,17 +24,17 @@ Misskey不是一家企業，由於它是免費使用的，開發者所能獲得 :::tip -額に応じて以下の返礼を用意しています。 +根據金額提供以下回饋。 - 1,000日圓以上: 將mi徽章附加到您的misskey.io帳戶上 - 3,000日圓以上: ↑ + 在Misskey的捐款芳名錄上記載您的名字 -- 10,000日圓以上: ↑ + 在Misskey的捐款芳名錄上記載您的名字 + 任意圖示 +- 10,000日圓以上: ↑ + 在Misskey的捐款芳名錄上記載您的名字 + 任意圖示 ) ::: :::warning -**由於徽章的分配和列入捐款芳名錄不是自動的，請將您的申請發送至 @syuilo\@misskey.io ，並提供您已捐款的資訊。** +**由於徽章的分配和列入捐款芳名錄不是自動的，請將您的申請發送至@syuilo\@misskey.io ，並提供您已捐款的資訊。** (如果您沒有收到回覆，請多次提及我，因為我可能沒有注意到您的提及。此外，您可能無法從 misskey.io 以外的伺服器收到訊息。) diff --git a/content/tw/docs/7.become-a-sponsor.md b/content/tw/docs/7.become-a-sponsor.md new file mode 100644 index 00000000..54f5d338 --- /dev/null +++ b/content/tw/docs/7.become-a-sponsor.md @@ -0,0 +1,7 @@ +# スポンサーについて + +Misskey Projectはスポンサーを募集しています。 + +スポンサーになると、MisskeyやMisskey Hubへの会社ロゴ掲載や、技術サポートを受けることができます。 + +[詳細はこちらからお問い合わせください。](/contact/) diff --git a/crowdin.yml b/crowdin.yml index a17d47df..4fb748b1 100644 --- a/crowdin.yml +++ b/crowdin.yml @@ -8,7 +8,7 @@ files: update_option: update_as_unapproved skip_untranslated_files: true ignore: - - "/content/ja/docs/**/_*.*" + - "/content/ja/docs/**/_*.md" languages_mapping: two_letters_code: zh-TW: tw diff --git a/locales/en-US.yml b/locales/en-US.yml index e8e0f3a4..3197fd7b 100644 --- a/locales/en-US.yml +++ b/locales/en-US.yml @@ -7,9 +7,12 @@ share: "Share" note: "Note" other: "Other" add: "Add" -browse: "参照" -settings: "設定" +generate: "Generate" +download: "Download" +browse: "Browse" +settings: "Settings" goToLegacyHub: "Legacy Misskey Hub" +contactUs: "Contact" _error: notFound: "Page not found" notFoundDesc: "The page you are looking for could not be found. Please check the URL." @@ -145,10 +148,13 @@ _docs: _changelog: title: "Release Notes" description: "View the version history of Misskey. Find out what's new in the latest version!" + _donate: + title: "Donating to the project" + description: "Misskey is free and open source software. If you like it, please consider donating so that we can continue to develop it." _forUsers: title: "For Misskey Users" _forAdmin: - title: "For Server Operators" + title: "For Server Administrators" _forDevelopers: title: "For Developers" _prevNext: @@ -171,13 +177,19 @@ _other: description: "Introducing more enjoyable resources for Misskey!" _brandAssets: title: "Brand Assets" - description: "A collection of Misskey's logo, icons, and other assets. Feel free to use for literally anything under the CC BY-SA License!" - license: "Assets are available under the CC BY-SA license 🎉" + description: "A collection of Misskey's logo, icons, and other assets. Feel free to use for literally anything under the CC BY-NC-SA License!" + license: "Assets are available under the CC BY-NC-SA license 🎉" assetsDirectory: "All assets are managed on {0}." logo: "Logo" icon: "Icon" banner: "Banner" avatarDecorationTemplate: "Avatar Decoration Template" +_contact: + title: "Contact" + description: "Get in touch with the Misskey Project" + form: "To send us an inquiry, please fill out this form." + formGoogleAccountRequired: "Currently, we ask you to have a Google Account to submit your inquiry in order to deal with serious spam.\nWe apologize for the inconvenience and thank you for your understanding." + formLink: "Go to the form" _links: title: "Links" _github: @@ -200,7 +212,7 @@ _tools: _forUsers: title: "For Misskey Users" _forAdmin: - title: "サーバー運営者向け" + title: "For Server Administrators" _mfmPlayground: title: "MFM Playground" description: "Practice MFM freely!" @@ -270,8 +282,8 @@ _shareLinkGenerator: url: "URL" urlCaption: "Optional. Inserted after the body." settings: "Advanced Settings" - manualInstance: "おすすめサーバー ドメイン" - manualInstanceDescription: "ここに指定したサーバー（ひとつ）をシェアボタン中継ページのトップに表示できます。ご自身のサーバーに誘導する際などにお使いいただけます。" + manualInstance: "Recommended Server" + manualInstanceDescription: "The server specified here can be displayed at the top of the Share button relay page. You can use this to direct people to your own server, for example." visibility: "Visibility" recipents: "Acct of the person receiving the direct (enter on a new line separator)" resultLink: "Generated results of shared links" @@ -284,32 +296,37 @@ _goToMisskey: heading: "Select the server you want to open the page and continue" _avatarDecorationPreview: title: "Avatar Decoration Previewer" - description: "アバターデコレーションがきれいに反映できるかをチェックできます。" + description: "You can check whether the avatar decoration fits properly." preview: "Preview" settings: "Settings" decoration: "Decoration #{number}" - placeholder: "「追加」から、アバターデコレーションを追加してプレビューできます。" + placeholder: "Through the 'Add' button you can add and preview the avatar decorations." _options: - offsetX: "横位置調整" - offsetY: "縦位置調整" + offsetX: "Horizontal Offset" + offsetY: "Vertical Offset" angle: "Angle" flip: "Flip Horizontally" - overlayTemplate: "テンプレートを重ねる" + overlayTemplate: "Overlay template" _placeholder: username: "Ai" noteText: "Just had a chocolate-glazed donut 🍩😋" - profileDescription: "Misskey常駐AIの藍です！よろしくお願いします♪" + profileDescription: "I am AI, Misskey resident AI! Pleased to meet you... ♪" _customEmojiPreview: - title: "カスタム絵文字 プレビュー" - description: "カスタム絵文字の視認性をチェックできます。" - preview: "プレビュー" - emoji: "絵文字 #{number}" - placeholder: "「追加」から、カスタム絵文字を追加してプレビューできます。" + title: "Custom Emoji Preview" + description: "The usability of custom emojis can be checked here." + preview: "Preview" + emoji: "Emoji #{number}" + placeholder: "Under 'Add', you can add and preview custom emojis." _options: - text: "ノート文面" - textDescription: "追加したカスタム絵文字は{emoji_id}で参照できます。" + text: "Note text" + textDescription: "The custom emoji you have added can be referenced by {emoji_id}" _placeholder: - noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" + noteText: "Custom emoji will appear like this → :emoji_preview_1:\nYou can rewrite the text and test its usability✨." +_identiconGenerator: + title: "Identicon Generator" + description: "You can generate an initial icon that will be specified by default when you register with Misskey." + userName: "Username" + includeDomain: "Specify the full user name, including the server's domain name." _api: _permissions: title: "Permissions" @@ -351,52 +368,52 @@ _api: "write:flash": "Edit Plays" "read:flash-likes": "View list of liked Plays" "write:flash-likes": "Edit list of liked Plays" - "read:admin:abuse-user-reports": "ユーザーからの通報を見る" - "write:admin:delete-account": "ユーザーアカウントを削除する" - "write:admin:delete-all-files-of-a-user": "ユーザーのすべてのファイルを削除する" - "read:admin:index-stats": "データベースインデックスに関する情報を見る" - "read:admin:table-stats": "データベーステーブルに関する情報を見る" - "read:admin:user-ips": "ユーザーのIPアドレスを見る" - "read:admin:meta": "インスタンスのメタデータを見る" - "write:admin:reset-password": "ユーザーのパスワードをリセットする" - "write:admin:resolve-abuse-user-report": "ユーザーからの通報を解決する" - "write:admin:send-email": "メールを送る" - "read:admin:server-info": "サーバーの情報を見る" - "read:admin:show-moderation-log": "モデレーションログを見る" - "read:admin:show-user": "ユーザーのプライベートな情報を見る" - "read:admin:show-users": "ユーザーのプライベートな情報を見る" - "write:admin:suspend-user": "ユーザーを凍結する" - "write:admin:unset-user-avatar": "ユーザーのアバターを削除する" - "write:admin:unset-user-banner": "ユーザーのバーナーを削除する" - "write:admin:unsuspend-user": "ユーザーの凍結を解除する" - "write:admin:meta": "インスタンスのメタデータを操作する" - "write:admin:user-note": "モデレーションノートを操作する" - "write:admin:roles": "ロールを操作する" - "read:admin:roles": "ロールを見る" - "write:admin:relays": "リレーを操作する" - "read:admin:relays": "リレーを見る" - "write:admin:invite-codes": "招待コードを操作する" - "read:admin:invite-codes": "招待コードを見る" - "write:admin:announcements": "お知らせを操作する" - "read:admin:announcements": "お知らせを見る" - "write:admin:avatar-decorations": "アバターデコレーションを操作する" - "read:admin:avatar-decorations": "アバターデコレーションを見る" - "write:admin:federation": "連合に関する情報を操作する" - "write:admin:account": "ユーザーアカウントを操作する" - "read:admin:account": "ユーザーに関する情報を見る" - "write:admin:emoji": "絵文字を操作する" - "read:admin:emoji": "絵文字を見る" - "write:admin:queue": "ジョブキューを操作する" - "read:admin:queue": "ジョブキューに関する情報を見る" - "write:admin:promo": "プロモーションノートを操作する" - "write:admin:drive": "ユーザーのドライブを操作する" - "read:admin:drive": "ユーザーのドライブの関する情報を見る" - "read:admin:stream": "管理者用のWebsocket APIを使う" - "write:admin:ad": "広告を操作する" - "read:admin:ad": "広告を見る" - "write:invite-codes": "招待コードを作成する" - "read:invite-codes": "招待コードを取得する" - "write:clip-favorite": "クリップのいいねを操作する" - "read:clip-favorite": "クリップのいいねを見る" - "read:federation": "連合に関する情報を取得する" - "write:report-abuse": "違反を報告する" + "read:admin:abuse-user-reports": "View user reports" + "write:admin:delete-account": "Delete user account" + "write:admin:delete-all-files-of-a-user": "Delete all files of a user" + "read:admin:index-stats": "View database index stats" + "read:admin:table-stats": "View database table stats" + "read:admin:user-ips": "View user IP addresses" + "read:admin:meta": "View instance metadata" + "write:admin:reset-password": "Reset user password" + "write:admin:resolve-abuse-user-report": "Resolve user report" + "write:admin:send-email": "Send email" + "read:admin:server-info": "View server info" + "read:admin:show-moderation-log": "View moderation log" + "read:admin:show-user": "View private user info" + "read:admin:show-users": "View private user info" + "write:admin:suspend-user": "Suspend user" + "write:admin:unset-user-avatar": "Remove user avatar" + "write:admin:unset-user-banner": "Remove user banner" + "write:admin:unsuspend-user": "Unsuspend user" + "write:admin:meta": "Manage instance metadata" + "write:admin:user-note": "Manage moderation note" + "write:admin:roles": "Manage roles" + "read:admin:roles": "View roles" + "write:admin:relays": "Manage relays" + "read:admin:relays": "View relays" + "write:admin:invite-codes": "Manage invite codes" + "read:admin:invite-codes": "View invite codes" + "write:admin:announcements": "Manage announcements" + "read:admin:announcements": "View announcements" + "write:admin:avatar-decorations": "Manage avatar decorations" + "read:admin:avatar-decorations": "View avatar decorations" + "write:admin:federation": "Manage federation" + "write:admin:account": "Manage user account" + "read:admin:account": "View user account" + "write:admin:emoji": "Manage emoji" + "read:admin:emoji": "View emoji" + "write:admin:queue": "Manage job queue" + "read:admin:queue": "View job queue info" + "write:admin:promo": "Manage promoted notes" + "write:admin:drive": "Manage user drive" + "read:admin:drive": "View user drive info" + "read:admin:stream": "Use admin WebSocket API" + "write:admin:ad": "Manage ads" + "read:admin:ad": "View ads" + "write:invite-codes": "Create invite codes" + "read:invite-codes": "Get invite codes" + "write:clip-favorite": "Manage favorited clips" + "read:clip-favorite": "View favorited clips" + "read:federation": "Get federation info" + "write:report-abuse": "Report violation" diff --git a/locales/fr-FR.yml b/locales/fr-FR.yml index d9147681..e4f74a14 100644 --- a/locales/fr-FR.yml +++ b/locales/fr-FR.yml @@ -7,9 +7,12 @@ share: "Partager" note: "Note" other: "Autres" add: "Ajouter" +generate: "生成" +download: "ダウンロード" browse: "参照" settings: "設定" goToLegacyHub: "L'ancien Misskey Hub" +contactUs: "お問い合わせ" _error: notFound: "La page demandée est introuvable !" notFoundDesc: "La page que vous cherchiez n'a pas pu être trouvée. Veuillez vérifier l'URL." @@ -145,6 +148,9 @@ _docs: _changelog: title: "Journal des modifications" description: "Voir l'historique des mises à jour de Misskey. Découvrez les nouveautés de la dernière version !" + _donate: + title: "Dons au projet" + description: "Misskey est un logiciel gratuit à code source ouvert. Si vous l'appréciez, veuillez faire un don pour que nous puissions continuer à le développer." _forUsers: title: "Pour les utilisateurs de Misskey" _forAdmin: @@ -172,12 +178,18 @@ _other: _brandAssets: title: "Collection de ressources" description: "Une collection de logos, d'icônes et d'autres actifs de Misskey. Vous êtes libre de les utiliser sous certaines licences." - license: "Les ressources sont libres d'être utilisées sous la licence CC BY-SA 🎉" + license: "Les ressources sont libres d'être utilisées sous la licence CC BY-NC-SA 🎉" assetsDirectory: "Toutes les ressources sont gérées sur {0}." logo: "Logo" icon: "Icône" banner: "Bannière" avatarDecorationTemplate: "Modèle de décoration d'avatar" +_contact: + title: "お問い合わせ" + description: "Misskey Projectへのお問い合わせはこちらから" + form: "こちらのフォームからご回答ください。" + formGoogleAccountRequired: "現在、スパム対策のため、お問い合わせの送信にはGoogleアカウントが必要となっております。\nお手数をおかけしますが、ご理解のほどよろしくお願い致します。" + formLink: "フォームへ進む" _links: title: "Liens" _github: @@ -310,6 +322,11 @@ _customEmojiPreview: textDescription: "追加したカスタム絵文字は{emoji_id}で参照できます。" _placeholder: noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" +_identiconGenerator: + title: "初期アイコンジェネレーター" + description: "Misskeyに登録した際にデフォルトで指定される初期アイコンを生成できます。" + userName: "ユーザー名" + includeDomain: "サーバーのドメイン名を含む完全なユーザー名を指定してください。" _api: _permissions: title: "Permissions" diff --git a/locales/id-ID.yml b/locales/id-ID.yml index fc1e92ce..48eac173 100644 --- a/locales/id-ID.yml +++ b/locales/id-ID.yml @@ -7,9 +7,12 @@ share: "Bagikan" note: "Catatan" other: "Lainnya" add: "Tambahkan" -browse: "参照" -settings: "設定" +generate: "生成" +download: "ダウンロード" +browse: "Jelajahi" +settings: "Pengaturan" goToLegacyHub: "Misskey Hub Jadul" +contactUs: "お問い合わせ" _error: notFound: "Halaman Tidak Ditemukan" notFoundDesc: "Halaman yang kamu cari tidak dapat ditemukan. Mohon cek kembali URL yang kamu tuju." @@ -97,7 +100,7 @@ _landing: _servers: title: "Daftar Peladen" description: "Misskey bukanlah layanan satuan namun jejaring terdesentralisasi dimana para individu menyediakan banyak layanan. Untuk menggunakan Misskey, kamu perlu membuat akun di peladen yang menawarkan layanan tersebut." - addYourServer: "Apakah peladenmu tidak terdaftar? Daftarkan segera di {0}!" + addYourServer: "Apakah peladenmu tidak terdaftar? Daftarkan segera {0}!" addYourServerLink: "di sini" _system: fetchError: "Gagal untuk mengambil data. Mohon coba lagi nanti." @@ -106,7 +109,7 @@ _servers: description: "Presentasikan statistik peladen Misskey ke dalam Bagan." viewFullStats: "Lihat statistik lengkap" lang: "Bahasa Utama" - registerAcceptance: "Menerima pendaftaran" + registerAcceptance: "Kebijakan pendaftaran" version: "Versi" notes: "Jumlah catatan" users: "Jumlah pengguna" @@ -116,15 +119,15 @@ _servers: all: "Semua" query: "Pencarian dengan kata kunci" lang: "Bahasa" - orderBy: "Tata ulang" + orderBy: "Urutkan" recomendded: "Bawaan" - notesCount: "Jumlah catatan" - notesPer15Days: "Jumlah catatan per hari (rata-rata 15 hari terakhir)" - usersCount: "Jumlah pengguna" + notesCount: "Catatan" + notesPer15Days: "Catatan/hari (rata-rata 15 hari terakhir)" + usersCount: "Pengguna" _registerAcceptance: title: "Kebijakan Pendaftaran" public: "Publik" - inviteOnly: "Hanya Undangan" + inviteOnly: "Undangan" _list: notFound: "Tidak ada peladen yang cocok ditemukan dengan kriteria yang dimaksud." showMore: "Selebihnya" @@ -145,6 +148,9 @@ _docs: _changelog: title: "Catatan Rilis" description: "Lihat riwayat versi Misskey. Cari tahu apa yang terbaru di versi terakhir!" + _donate: + title: "Berdonasi ke proyek" + description: "Misskey merupakan perangkat lunak bebas dan bersumber terbuka. Apabila kamu menyukai Misskey, mohon pertimbangkan untuk berdonasi agak kami dapat terus lanjut mengembangkan perangkat lunak ini." _forUsers: title: "Untuk Pengguna Misskey" _forAdmin: @@ -171,13 +177,19 @@ _other: description: "Memperkenalkan sumber daya yang menyenangkan untuk Misskey!" _brandAssets: title: "Aset Brand" - description: "Koleksi dari logo, ikon serta aset Misskey lainnya. Gunakan secara bebas untuk apapun selama dalam lisensi CC BY-SA!" - license: "Aset tersedia dalam lisensi CC BY-SA🎉." + description: "Koleksi dari logo, ikon serta aset Misskey lainnya. Gunakan secara bebas untuk apapun selama dalam lisensi CC BY-NC-SA!" + license: "Aset tersedia dalam lisensi CC BY-NC-SA🎉." assetsDirectory: "Semua aset dikelola di {0}." logo: "Logo" icon: "Ikon" banner: "Banner" avatarDecorationTemplate: "Templat Dekorasi Avatar" +_contact: + title: "お問い合わせ" + description: "Misskey Projectへのお問い合わせはこちらから" + form: "こちらのフォームからご回答ください。" + formGoogleAccountRequired: "現在、スパム対策のため、お問い合わせの送信にはGoogleアカウントが必要となっております。\nお手数をおかけしますが、ご理解のほどよろしくお願い致します。" + formLink: "フォームへ進む" _links: title: "Tautan" _github: @@ -200,7 +212,7 @@ _tools: _forUsers: title: "Untuk Pengguna Misskey" _forAdmin: - title: "サーバー運営者向け" + title: "Untuk Pengelola Peladen" _mfmPlayground: title: "Taman bermain MFM" description: "Berlatih MFM sebebasnya!" @@ -247,7 +259,7 @@ _aboutUs: _i18n: _missing: title: "Bantu kami menerjemahkan" - description: "Dokumen ini diterjemahkan oleh komunitas. Kamu dapat berkontribusi di {link}. Kami sangat mengapresiasi atas kerjasamamu terhadap proyek ini 🙏." + description: "Dokumen ini diterjemahkan oleh komunitas. Kamu dapat ikut berkontribusi menyempurnakan terjemahan ini melalui {link}. Kami sangat mengapresiasi atas kerjasama yang telah kamu berikan dengan ikut berkontribusi dalam proyek ini 🙏." linkLabel: "Crowdin" _share: title: "Catat ke Misskey" @@ -300,16 +312,21 @@ _avatarDecorationPreview: noteText: "Baru aja makan donat berlapis coklat 🍩😋" profileDescription: "Aku Ai bertugas sebagai AI Misskey! Senang berkenalan denganmu♪" _customEmojiPreview: - title: "カスタム絵文字 プレビュー" - description: "カスタム絵文字の視認性をチェックできます。" - preview: "プレビュー" - emoji: "絵文字 #{number}" - placeholder: "「追加」から、カスタム絵文字を追加してプレビューできます。" + title: "Pratinjau Emoji Kustom" + description: "Kamu dapat mengecek untuk melihat pratinjau kustom emoji." + preview: "Pratinjau" + emoji: "Emoji #{number}" + placeholder: "Kamu dapat menambahkan dan melihat emoji kustom melalui menu \"Tambahkan\"." _options: - text: "ノート文面" - textDescription: "追加したカスタム絵文字は{emoji_id}で参照できます。" + text: "Teks catatan" + textDescription: "Kustom emoji yang ditambahkan dapat direferensikan dengan {emoji_id}" _placeholder: - noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" + noteText: "Emoji kustom akan muncul seperti ini → :emoji_preview_1:\nKamu dapat menulis ulang teks dan mencoba kegunaannya ✨." +_identiconGenerator: + title: "初期アイコンジェネレーター" + description: "Misskeyに登録した際にデフォルトで指定される初期アイコンを生成できます。" + userName: "ユーザー名" + includeDomain: "サーバーのドメイン名を含む完全なユーザー名を指定してください。" _api: _permissions: title: "Hak akses" @@ -351,52 +368,52 @@ _api: "write:flash": "Menyunting Play" "read:flash-likes": "Melihat daftar Play yang disukai" "write:flash-likes": "Menyunting daftar Play yang disukai" - "read:admin:abuse-user-reports": "ユーザーからの通報を見る" - "write:admin:delete-account": "ユーザーアカウントを削除する" - "write:admin:delete-all-files-of-a-user": "ユーザーのすべてのファイルを削除する" - "read:admin:index-stats": "データベースインデックスに関する情報を見る" - "read:admin:table-stats": "データベーステーブルに関する情報を見る" - "read:admin:user-ips": "ユーザーのIPアドレスを見る" - "read:admin:meta": "インスタンスのメタデータを見る" - "write:admin:reset-password": "ユーザーのパスワードをリセットする" - "write:admin:resolve-abuse-user-report": "ユーザーからの通報を解決する" - "write:admin:send-email": "メールを送る" - "read:admin:server-info": "サーバーの情報を見る" - "read:admin:show-moderation-log": "モデレーションログを見る" - "read:admin:show-user": "ユーザーのプライベートな情報を見る" - "read:admin:show-users": "ユーザーのプライベートな情報を見る" - "write:admin:suspend-user": "ユーザーを凍結する" - "write:admin:unset-user-avatar": "ユーザーのアバターを削除する" - "write:admin:unset-user-banner": "ユーザーのバーナーを削除する" - "write:admin:unsuspend-user": "ユーザーの凍結を解除する" - "write:admin:meta": "インスタンスのメタデータを操作する" - "write:admin:user-note": "モデレーションノートを操作する" - "write:admin:roles": "ロールを操作する" - "read:admin:roles": "ロールを見る" - "write:admin:relays": "リレーを操作する" - "read:admin:relays": "リレーを見る" - "write:admin:invite-codes": "招待コードを操作する" - "read:admin:invite-codes": "招待コードを見る" - "write:admin:announcements": "お知らせを操作する" - "read:admin:announcements": "お知らせを見る" - "write:admin:avatar-decorations": "アバターデコレーションを操作する" - "read:admin:avatar-decorations": "アバターデコレーションを見る" - "write:admin:federation": "連合に関する情報を操作する" - "write:admin:account": "ユーザーアカウントを操作する" - "read:admin:account": "ユーザーに関する情報を見る" - "write:admin:emoji": "絵文字を操作する" - "read:admin:emoji": "絵文字を見る" - "write:admin:queue": "ジョブキューを操作する" - "read:admin:queue": "ジョブキューに関する情報を見る" - "write:admin:promo": "プロモーションノートを操作する" - "write:admin:drive": "ユーザーのドライブを操作する" - "read:admin:drive": "ユーザーのドライブの関する情報を見る" - "read:admin:stream": "管理者用のWebsocket APIを使う" - "write:admin:ad": "広告を操作する" - "read:admin:ad": "広告を見る" - "write:invite-codes": "招待コードを作成する" - "read:invite-codes": "招待コードを取得する" - "write:clip-favorite": "クリップのいいねを操作する" - "read:clip-favorite": "クリップのいいねを見る" - "read:federation": "連合に関する情報を取得する" - "write:report-abuse": "違反を報告する" + "read:admin:abuse-user-reports": "Lihat laporan pengguna" + "write:admin:delete-account": "Hapus akun pengguna" + "write:admin:delete-all-files-of-a-user": "Hapus semua berkas dari seorang pengguna" + "read:admin:index-stats": "Lihat statistik indeks basis data" + "read:admin:table-stats": "Lihat statistik tabel basis data" + "read:admin:user-ips": "Lihat alamat IP pengguna" + "read:admin:meta": "Lihat metadata instansi" + "write:admin:reset-password": "Atur ulang kata sandi pengguna" + "write:admin:resolve-abuse-user-report": "Selesaikan laporan pengguna" + "write:admin:send-email": "Mengirim surel" + "read:admin:server-info": "Lihat informasi peladen" + "read:admin:show-moderation-log": "Lihat log moderasi" + "read:admin:show-user": "Lihat informasi privat milik pengguna" + "read:admin:show-users": "Lihat informasi privat milik pengguna" + "write:admin:suspend-user": "Tangguhkan pengguna" + "write:admin:unset-user-avatar": "Hapus avatar pengguna" + "write:admin:unset-user-banner": "Hapus banner pengguna" + "write:admin:unsuspend-user": "Batalkan penangguhan pengguna" + "write:admin:meta": "Kelola metadata instansi" + "write:admin:user-note": "Kelola moderasi catatan" + "write:admin:roles": "Kelola peran" + "read:admin:roles": "Lihat peran" + "write:admin:relays": "Kelola relay" + "read:admin:relays": "Lihat relay" + "write:admin:invite-codes": "Kelola kode undangan" + "read:admin:invite-codes": "Lihat kode undangan" + "write:admin:announcements": "Kelola pengumuman" + "read:admin:announcements": "Lihat Pengumuman" + "write:admin:avatar-decorations": "Kelola dekorasi avatar" + "read:admin:avatar-decorations": "Lihat dekorasi avatar" + "write:admin:federation": "Kelola federasi" + "write:admin:account": "Kelola akun pengguna" + "read:admin:account": "Lihat akun pengguna" + "write:admin:emoji": "Kelola emoji" + "read:admin:emoji": "Lihat emoji" + "write:admin:queue": "Kelola antrian kerja" + "read:admin:queue": "Lihat informasi antrian kerja" + "write:admin:promo": "Kelola catatan yang dipromosikan" + "write:admin:drive": "Kelola drive pengguna" + "read:admin:drive": "Kelola informasi drive pengguna" + "read:admin:stream": "Gunakan API WebSocket untuk Admin" + "write:admin:ad": "Kelola iklan" + "read:admin:ad": "Lihat iklan" + "write:invite-codes": "Membuat kode undangan" + "read:invite-codes": "Mendapatkan kode undangan" + "write:clip-favorite": "Kelola klip yang difavoritkan" + "read:clip-favorite": "Lihat klip yang difavoritkan" + "read:federation": "Mendapatkan informasi federasi" + "write:report-abuse": "Melaporkan pelanggaran" diff --git a/locales/it-IT.yml b/locales/it-IT.yml index 31b9ee10..67d33051 100644 --- a/locales/it-IT.yml +++ b/locales/it-IT.yml @@ -2,20 +2,23 @@ noScript: "Javascript sembra essere disabilitato. Per visualizzare il sito è ne learnMore: "Per saperne di più" loading: "Caricamento" clickToExpand: "Clicca per espandere" -copy: "コピー" -share: "共有する" -note: "ノート" +copy: "Copia" +share: "Condividi" +note: "Nota" other: "その他" -add: "追加" -browse: "参照" -settings: "設定" -goToLegacyHub: "従来のMisskey Hub" +add: "Aggiungi" +generate: "生成" +download: "ダウンロード" +browse: "Sfoglia" +settings: "Impostazioni" +goToLegacyHub: "Versione precedente" +contactUs: "お問い合わせ" _error: - notFound: "ページが見つかりませんでした" + notFound: "Pagina non trovata" notFoundDesc: "お探しのページは見つかりませんでした。URLをお確かめください。" - generalError: "エラーが発生しました" + generalError: "Si è verificato un errore" generalErrorDesc: "これが意図した操作でない場合は、以下から不具合報告をお願いします。" - reportProblem: "問題を報告する" + reportProblem: "Segnala un problema" goToTop: "トップページにもどる" _seo: siteName: "Misskey Hub" @@ -145,6 +148,9 @@ _docs: _changelog: title: "リリースノート" description: "Misskeyのバージョンアップ履歴をご覧いただけます。最新のバージョンで何が変わったのかを確認しましょう！" + _donate: + title: "プロジェクトへの寄付" + description: "Misskeyは無料で使えるオープンソースのソフトウェアです。気に入っていただけたら、今後も開発を続けられるようにぜひ寄付をご検討ください。" _forUsers: title: "Per utilizzare" _forAdmin: @@ -178,11 +184,17 @@ _brandAssets: icon: "アイコン" banner: "バナー" avatarDecorationTemplate: "アバターデコレーション テンプレート" +_contact: + title: "お問い合わせ" + description: "Misskey Projectへのお問い合わせはこちらから" + form: "こちらのフォームからご回答ください。" + formGoogleAccountRequired: "現在、スパム対策のため、お問い合わせの送信にはGoogleアカウントが必要となっております。\nお手数をおかけしますが、ご理解のほどよろしくお願い致します。" + formLink: "フォームへ進む" _links: title: "リンク" _github: - title: "Github" - description: "Misskeyの開発はGithub上で行われています。機能リクエストやバグ報告などはこちらから行えます。" + title: "GitHub" + description: "Misskeyの開発はGitHub上で行われています。機能リクエストやバグ報告などはこちらから行えます。" _crowdin: title: "Crowdin" description: "Misskey本体、およびドキュメントの翻訳はこちらで管理されています。皆さんのご協力をお願いします。" @@ -220,8 +232,8 @@ _aidConverter: mode: "作成するid" date: "日付時刻" _aboutUs: - title: "Misskey Development Divisionについて" - description: "Misskey開発チームについての情報を掲載しています。" + title: "Misskey Projectについて" + description: "Misskey Projectについての情報を掲載しています。" _team: title: "開発メンバー" description: "Misskeyの開発に関わっている方を紹介しています。" @@ -310,6 +322,11 @@ _customEmojiPreview: textDescription: "追加したカスタム絵文字は{emoji_id}で参照できます。" _placeholder: noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" +_identiconGenerator: + title: "初期アイコンジェネレーター" + description: "Misskeyに登録した際にデフォルトで指定される初期アイコンを生成できます。" + userName: "ユーザー名" + includeDomain: "サーバーのドメイン名を含む完全なユーザー名を指定してください。" _api: _permissions: title: "権限" diff --git a/locales/ja-JP.yml b/locales/ja-JP.yml index 2146c0fa..9bbb5f04 100644 --- a/locales/ja-JP.yml +++ b/locales/ja-JP.yml @@ -12,6 +12,7 @@ download: "ダウンロード" browse: "参照" settings: "設定" goToLegacyHub: "従来のMisskey Hub" +contactUs: "お問い合わせ" _error: notFound: "ページが見つかりませんでした" @@ -194,6 +195,13 @@ _brandAssets: banner: "バナー" avatarDecorationTemplate: "アバターデコレーション テンプレート" +_contact: + title: "お問い合わせ" + description: "Misskey Projectへのお問い合わせはこちらから" + form: "こちらのフォームからご回答ください。" + formGoogleAccountRequired: "現在、スパム対策のため、お問い合わせの送信にはGoogleアカウントが必要となっております。\nお手数をおかけしますが、ご理解のほどよろしくお願い致します。" + formLink: "フォームへ進む" + _links: title: "リンク" _github: @@ -240,8 +248,8 @@ _aidConverter: date: "日付時刻" _aboutUs: - title: "Misskey Development Divisionについて" - description: "Misskey開発チームについての情報を掲載しています。" + title: "Misskey Projectについて" + description: "Misskey Projectについての情報を掲載しています。" _team: title: "開発メンバー" description: "Misskeyの開発に関わっている方を紹介しています。" diff --git a/locales/ja-KS.yml b/locales/ja-KS.yml index da148652..c29c0992 100644 --- a/locales/ja-KS.yml +++ b/locales/ja-KS.yml @@ -7,9 +7,12 @@ share: "共有する" note: "ノート" other: "ほか" add: "追加" +generate: "つくる" +download: "落とす" browse: "参照" settings: "設定" goToLegacyHub: "前のMisskey Hub" +contactUs: "お問い合わせ" _error: notFound: "ページ食べた" @@ -189,6 +192,13 @@ _brandAssets: banner: "バナー" avatarDecorationTemplate: "アバターデコレーション テンプレート" +_contact: + title: "お問い合わせ" + description: "Misskey Projectになんか言いたいときはここから" + form: "このフォームから回答してな" + formGoogleAccountRequired: "今、スパムっちゅう厄介なのがおって、問い合わせを送ってもらうためにGoogleアカウントが要ることになっとんねん。\nめんどくさいかもしれんけど、よろしゅうおねがいします～" + formLink: "フォームへ進む" + _links: title: "リンク" _github: @@ -333,6 +343,12 @@ _customEmojiPreview: _placeholder: noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" +_identiconGenerator: + title: "初期アイコンジェネレーター" + description: "Misskeyに登録したときにはじめっからついてある初期アイコンを作れるで。" + userName: "ユーザー名" + includeDomain: "サーバーのドメイン名を含む完全なユーザー名を入れてな。" + _api: _permissions: title: "権限" diff --git a/locales/ko-KR.yml b/locales/ko-KR.yml index ea0557c6..c18b7495 100644 --- a/locales/ko-KR.yml +++ b/locales/ko-KR.yml @@ -7,9 +7,12 @@ share: "공유" note: "노트" other: "기타" add: "추가" +generate: "生成" +download: "ダウンロード" browse: "참고자료" settings: "설정" goToLegacyHub: "이전 Misskey Hub" +contactUs: "お問い合わせ" _error: notFound: "페이지를 찾을 수 없습니다" notFoundDesc: "요청하신 페이지를 찾을 수 없습니다. URL을 확인하여 주십시오." @@ -145,6 +148,9 @@ _docs: _changelog: title: "릴리즈 노트" description: "Misskey의 업데이트 이력을 확인하실 수 있습니다. 최신 버전에서 무엇이 바뀌었는지 확인하세요." + _donate: + title: "프로젝트 기부" + description: "Misskey는 무료로 사용할 수 있는 오픈소스 소프트웨어입니다. 마음에 드신다면, 앞으로도 계속 개발할 수 있도록 기부를 고려해 주시기 바랍니다." _forUsers: title: "Misskey 유저용" _forAdmin: @@ -172,12 +178,18 @@ _other: _brandAssets: title: "자료집" description: "Misskey의 로고, 아이콘 등의 자료들입니다. 일정한 라이센스를 따르시면 자유롭게 이용하실 수 있습니다." - license: "자료는 CC BY-SA 라이센스로 자유롭게 사용하실 수 있습니다🎉" + license: "자료는 CC BY-NC-SA 라이센스로 자유롭게 사용하실 수 있습니다🎉" assetsDirectory: "모든 자료는 {0}를 통해 관리되고 있습니다." logo: "로고" icon: "아이콘" banner: "배너" avatarDecorationTemplate: "아바타 장식 도구" +_contact: + title: "お問い合わせ" + description: "Misskey Projectへのお問い合わせはこちらから" + form: "こちらのフォームからご回答ください。" + formGoogleAccountRequired: "現在、スパム対策のため、お問い合わせの送信にはGoogleアカウントが必要となっております。\nお手数をおかけしますが、ご理解のほどよろしくお願い致します。" + formLink: "フォームへ進む" _links: title: "링크" _github: @@ -310,6 +322,11 @@ _customEmojiPreview: textDescription: "추가한 사용자 지정 이모티콘은 {emoji_id}로 참조할 수 있습니다." _placeholder: noteText: "커스텀 이모티콘은 다음과 같이 표시됩니다 → :emoji_preview_1:.\n문장을 다시 써서 사용성을 시험해 보세요✨." +_identiconGenerator: + title: "初期アイコンジェネレーター" + description: "Misskeyに登録した際にデフォルトで指定される初期アイコンを生成できます。" + userName: "ユーザー名" + includeDomain: "サーバーのドメイン名を含む完全なユーザー名を指定してください。" _api: _permissions: title: "권한" @@ -351,52 +368,52 @@ _api: "write:flash": "Play를 조작합니다" "read:flash-likes": "Play의 좋아요를 봅니다" "write:flash-likes": "Play의 좋아요를 조작합니다" - "read:admin:abuse-user-reports": "ユーザーからの通報を見る" - "write:admin:delete-account": "ユーザーアカウントを削除する" - "write:admin:delete-all-files-of-a-user": "ユーザーのすべてのファイルを削除する" - "read:admin:index-stats": "データベースインデックスに関する情報を見る" - "read:admin:table-stats": "データベーステーブルに関する情報を見る" - "read:admin:user-ips": "ユーザーのIPアドレスを見る" - "read:admin:meta": "インスタンスのメタデータを見る" - "write:admin:reset-password": "ユーザーのパスワードをリセットする" - "write:admin:resolve-abuse-user-report": "ユーザーからの通報を解決する" - "write:admin:send-email": "メールを送る" - "read:admin:server-info": "サーバーの情報を見る" - "read:admin:show-moderation-log": "モデレーションログを見る" - "read:admin:show-user": "ユーザーのプライベートな情報を見る" - "read:admin:show-users": "ユーザーのプライベートな情報を見る" - "write:admin:suspend-user": "ユーザーを凍結する" - "write:admin:unset-user-avatar": "ユーザーのアバターを削除する" - "write:admin:unset-user-banner": "ユーザーのバーナーを削除する" - "write:admin:unsuspend-user": "ユーザーの凍結を解除する" - "write:admin:meta": "インスタンスのメタデータを操作する" - "write:admin:user-note": "モデレーションノートを操作する" - "write:admin:roles": "ロールを操作する" - "read:admin:roles": "ロールを見る" - "write:admin:relays": "リレーを操作する" - "read:admin:relays": "リレーを見る" - "write:admin:invite-codes": "招待コードを操作する" - "read:admin:invite-codes": "招待コードを見る" - "write:admin:announcements": "お知らせを操作する" - "read:admin:announcements": "お知らせを見る" - "write:admin:avatar-decorations": "アバターデコレーションを操作する" - "read:admin:avatar-decorations": "アバターデコレーションを見る" - "write:admin:federation": "連合に関する情報を操作する" - "write:admin:account": "ユーザーアカウントを操作する" - "read:admin:account": "ユーザーに関する情報を見る" - "write:admin:emoji": "絵文字を操作する" - "read:admin:emoji": "絵文字を見る" - "write:admin:queue": "ジョブキューを操作する" - "read:admin:queue": "ジョブキューに関する情報を見る" - "write:admin:promo": "プロモーションノートを操作する" - "write:admin:drive": "ユーザーのドライブを操作する" - "read:admin:drive": "ユーザーのドライブの関する情報を見る" - "read:admin:stream": "管理者用のWebsocket APIを使う" - "write:admin:ad": "広告を操作する" - "read:admin:ad": "広告を見る" - "write:invite-codes": "招待コードを作成する" - "read:invite-codes": "招待コードを取得する" - "write:clip-favorite": "クリップのいいねを操作する" - "read:clip-favorite": "クリップのいいねを見る" - "read:federation": "連合に関する情報を取得する" - "write:report-abuse": "違反を報告する" + "read:admin:abuse-user-reports": "사용자 신고 보기" + "write:admin:delete-account": "사용자 계정 삭제하기" + "write:admin:delete-all-files-of-a-user": "사용자의 모든 파일 삭제하기" + "read:admin:index-stats": "데이터베이스 인덱스 정보 보기" + "read:admin:table-stats": "데이터베이스 테이블 정보 보기" + "read:admin:user-ips": "사용자 IP 주소 보기" + "read:admin:meta": "인스턴스 메타데이터 보기" + "write:admin:reset-password": "사용자 비밀번호 재설정하기" + "write:admin:resolve-abuse-user-report": "사용자 신고 해결하기" + "write:admin:send-email": "이메일 보내기" + "read:admin:server-info": "서버 정보 보기" + "read:admin:show-moderation-log": "조정 기록 보기" + "read:admin:show-user": "사용자 개인정보 보기" + "read:admin:show-users": "사용자 개인정보 보기" + "write:admin:suspend-user": "사용자 정지하기" + "write:admin:unset-user-avatar": "사용자 아바타 삭제하기" + "write:admin:unset-user-banner": "사용자 배너 삭제하기" + "write:admin:unsuspend-user": "사용자 정지 해제하기" + "write:admin:meta": "인스턴스 메타데이터 수정하기" + "write:admin:user-note": "조정 기록 수정하기" + "write:admin:roles": "역할 수정하기" + "read:admin:roles": "역할 보기" + "write:admin:relays": "릴레이 수정하기" + "read:admin:relays": "릴레이 보기" + "write:admin:invite-codes": "초대 코드 수정하기" + "read:admin:invite-codes": "초대 코드 보기" + "write:admin:announcements": "공지사항 수정하기" + "read:admin:announcements": "공지사항 보기" + "write:admin:avatar-decorations": "아바타 꾸미기 수정하기" + "read:admin:avatar-decorations": "아바타 꾸미기 보기" + "write:admin:federation": "연합 정보 수정하기" + "write:admin:account": "사용자 계정 수정하기" + "read:admin:account": "사용자 정보 보기" + "write:admin:emoji": "이모지 수정하기" + "read:admin:emoji": "이모지 보기" + "write:admin:queue": "작업 대기열 수정하기" + "read:admin:queue": "작업 대기열 정보 보기" + "write:admin:promo": "프로모션 기록 수정하기" + "write:admin:drive": "사용자 드라이브 수정하기" + "read:admin:drive": "사용자 드라이브 정보 보기" + "read:admin:stream": "관리자용 Websocket API 사용하기" + "write:admin:ad": "광고 수정하기" + "read:admin:ad": "광고 보기" + "write:invite-codes": "초대 코드 만들기" + "read:invite-codes": "초대 코드 받기" + "write:clip-favorite": "클립의 좋아요 수정하기" + "read:clip-favorite": "클립의 좋아요 보기" + "read:federation": "연합 정보 불러오기" + "write:report-abuse": "위반 신고하기" diff --git a/locales/pl-PL.yml b/locales/pl-PL.yml index d04f0e00..a52c301d 100644 --- a/locales/pl-PL.yml +++ b/locales/pl-PL.yml @@ -2,14 +2,17 @@ noScript: "現在Javascriptが無効になっています。サイトの表示 learnMore: "詳しく知る" loading: "読み込み中…" clickToExpand: "（クリックして展開）" -copy: "コピー" +copy: "Kopiuj" share: "共有する" -note: "ノート" +note: "Notka" other: "その他" add: "追加" +generate: "生成" +download: "ダウンロード" browse: "参照" settings: "設定" goToLegacyHub: "従来のMisskey Hub" +contactUs: "お問い合わせ" _error: notFound: "ページが見つかりませんでした" notFoundDesc: "お探しのページは見つかりませんでした。URLをお確かめください。" @@ -23,18 +26,18 @@ _seo: defaultTitleTagline: "ノートでひろがるネットワーク" defaultDescription: "【ノートでひろがるネットワーク】分散型SNS Misskeyの公式サイト。Misskeyのはじめかたやサーバー一覧など、Misskeyに関する情報が満載！" _nav: - servers: "サーバー" - docs: "ドキュメント" - blog: "ブログ" + servers: "Serwery" + docs: "Dokumentacja" + blog: "Blog" other: "もっと！" switchLang: "言語の設定" _landing: _hero: - description: "Misskey（ミスキー）はオープンソースの分散型ソーシャルネットワーキングプラットフォームです。" - gettingStarted: "はじめる" + description: "Misskey jest otwarto-źródłową i zdecentralizowaną siecią społecznościową" + gettingStarted: "Zaczynamy" _keyFeatures: _open: - title: "オープン" + title: "Otwarte" description: "Misskeyはオープンソースのソフトウェアで、誰でも自由にMisskeyを利用できます。" _federated: title: "分散" @@ -145,6 +148,9 @@ _docs: _changelog: title: "リリースノート" description: "Misskeyのバージョンアップ履歴をご覧いただけます。最新のバージョンで何が変わったのかを確認しましょう！" + _donate: + title: "プロジェクトへの寄付" + description: "Misskeyは無料で使えるオープンソースのソフトウェアです。気に入っていただけたら、今後も開発を続けられるようにぜひ寄付をご検討ください。" _forUsers: title: "Misskeyユーザー向け" _forAdmin: @@ -178,11 +184,17 @@ _brandAssets: icon: "アイコン" banner: "バナー" avatarDecorationTemplate: "アバターデコレーション テンプレート" +_contact: + title: "お問い合わせ" + description: "Misskey Projectへのお問い合わせはこちらから" + form: "こちらのフォームからご回答ください。" + formGoogleAccountRequired: "現在、スパム対策のため、お問い合わせの送信にはGoogleアカウントが必要となっております。\nお手数をおかけしますが、ご理解のほどよろしくお願い致します。" + formLink: "フォームへ進む" _links: title: "リンク" _github: - title: "Github" - description: "Misskeyの開発はGithub上で行われています。機能リクエストやバグ報告などはこちらから行えます。" + title: "GitHub" + description: "Misskeyの開発はGitHub上で行われています。機能リクエストやバグ報告などはこちらから行えます。" _crowdin: title: "Crowdin" description: "Misskey本体、およびドキュメントの翻訳はこちらで管理されています。皆さんのご協力をお願いします。" @@ -220,8 +232,8 @@ _aidConverter: mode: "作成するid" date: "日付時刻" _aboutUs: - title: "Misskey Development Divisionについて" - description: "Misskey開発チームについての情報を掲載しています。" + title: "Misskey Projectについて" + description: "Misskey Projectについての情報を掲載しています。" _team: title: "開発メンバー" description: "Misskeyの開発に関わっている方を紹介しています。" @@ -310,6 +322,11 @@ _customEmojiPreview: textDescription: "追加したカスタム絵文字は{emoji_id}で参照できます。" _placeholder: noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" +_identiconGenerator: + title: "初期アイコンジェネレーター" + description: "Misskeyに登録した際にデフォルトで指定される初期アイコンを生成できます。" + userName: "ユーザー名" + includeDomain: "サーバーのドメイン名を含む完全なユーザー名を指定してください。" _api: _permissions: title: "権限" diff --git a/locales/zh-CN.yml b/locales/zh-CN.yml index 4556667a..058f1660 100644 --- a/locales/zh-CN.yml +++ b/locales/zh-CN.yml @@ -1,25 +1,28 @@ noScript: "JavaScript 目前处于禁用状态。必须启用 JavaScript 才能浏览网站。" -learnMore: "詳しく知る" +learnMore: "了解更多" loading: "加载中…" clickToExpand: "（点击以展开）" copy: "复制" share: "分享" -note: "ノート" +note: "帖子" other: "其他" -add: "追加" -browse: "参照" -settings: "設定" -goToLegacyHub: "従来のMisskey Hub" +add: "添加" +generate: "生成" +download: "ダウンロード" +browse: "查看" +settings: "设置" +goToLegacyHub: "Misskey Hub的历史" +contactUs: "お問い合わせ" _error: notFound: "找不到页面" notFoundDesc: "找不到您要查找的页面，请检查 URL。" generalError: "发生了错误" - generalErrorDesc: "これが意図した操作でない場合は、以下から不具合報告をお願いします。" + generalErrorDesc: "如果此操作并非出于您本意，请根据指引将问题报告给我们。" reportProblem: "报告问题" - goToTop: "トップページにもどる" + goToTop: "返回主页" _seo: siteName: "Misskey Hub" - siteNameLong: "Misskey Hub – Misskeyプロジェクト 公式サイト" + siteNameLong: "Misskey Hub – Misskey项目官方网站" defaultTitleTagline: "ノートでひろがるネットワーク" defaultDescription: "【ノートでひろがるネットワーク】分散型SNS Misskeyの公式サイト。Misskeyのはじめかたやサーバー一覧など、Misskeyに関する情報が満載！" _nav: @@ -27,124 +30,127 @@ _nav: docs: "文档" blog: "博客" other: "更多！" - switchLang: "语音设定" + switchLang: "语言设定" _landing: _hero: - description: "Misskey（ミスキー）はオープンソースの分散型ソーシャルネットワーキングプラットフォームです。" - gettingStarted: "はじめる" + description: "Misskey是一个去中心化开源社交平台。" + gettingStarted: "开始" _keyFeatures: _open: - title: "オープン" - description: "Misskeyはオープンソースのソフトウェアで、誰でも自由にMisskeyを利用できます。" + title: "开放" + description: "Misskey是一款开源的软件，任何人都可以自由地使用Misskey。" _federated: - title: "分散" - description: "Misskeyは分散型のプロトコルを実装しているため、異なるサーバーのコミュニティ同士が繋がります。" + title: "去中心化" + description: "Misskey 采用去中心化协议，将不同服务器上的社区连接起来。" _multifunction: - title: "高機能" - description: "Misskeyは他にはない様々な機能を備えていて、プロのようにmicro-blogging可能です。" + title: "功能丰富" + description: "Misskey 拥有多种独特的功能，让您可更专业地发帖。" _customizable: - title: "高カスタマイズ性" - description: "Misskeyの柔軟なWebインターフェイスにより、自分好みのUIを作れます。" + title: "高度可定制" + description: "Misskey 有灵活的 Web 界面，你可以按喜好自己定制页面的样式。" _decenterized: - title: "Misskeyは{0}" - decenterizedPlatform: "分散型プラットフォーム" - description: "Misskeyはフリーかつオープンなプロジェクトで、誰でも自由にMisskeyを使ったサーバーを作成できるため、既に様々なサーバーがインターネット上に公開されています。また重要な特徴として、Misskeyは{0}と呼ばれる分散通信プロトコルを実装しているので、どのサーバーを選んでも他のサーバーのユーザーとやりとりすることができます。これが分散型と言われる所以で、単一の運営者によって単一のURLで公開されるような、Twitterなどの他サービスとは根本的に異なっています。サーバーによって主な話題のテーマやユーザー層、言語などは異なり、自分にあったサーバーを探すのも楽しみのひとつです(もちろん自分のサーバーを作るのも一興です)。" + title: "Misskey 是{0}" + decenterizedPlatform: "去中心化平台" + description: "Misskey 是一个自由开放的项目，任何人都可以自由地使用 Misskey 创建服务器，因此互联网上已经诞生了各种各样的服务器。 此外，Misskey 实现了一个名叫{0}的分布式通信协议。因此，无论您选择哪台服务器，都可以与其他服务器上的用户交互。 这就是它被称为去中心化的原因，也是它与 Twitter 等其他服务的根本不同之处。 不同服务器的主要话题、用户群和语言各不相同，找到适合自己的服务器也是乐趣之一（当然，创建自己的服务器也很有趣哦）。" activityPub: "ActivityPub" _features: _root: - title: "主な機能" - description: "Misskeyは一般的なものから特別なものまで、様々な機能を持っています。その一部を紹介します。" + title: "主要功能" + description: "Misskey 有丰富的功能，从各家都有的功能到 Misskey 独有的功能。这里来介绍一些。" _note: - title: "ノート" - description: "Misskeyでは、ユーザーの投稿は「ノート」と呼ばれます。他のノートを引用したり、画像、動画、オーディオ、その他の任意のファイルを添付することもできます。" + title: "帖子" + description: "在 Misskey 中，您可以引用其他帖子并附加图片、视频、音频或任何其他文件。" _federation: - title: "連合" - description: "オープンな分散プロトコルであるActivityPubを実装しているため、他のMisskeyサーバーだけでなく、ActivityPubをサポートする他のソフトウェアともやりとりできます。" + title: "联合" + description: "Misskey 实现了 ActivityPub 这一分布式协议，因此可以与其他支持 ActivityPub 的软件以及其他 Misskey 服务器交互。" _reaction: - title: "リアクション" - description: "ノートには「リアクション」を付けることができ、簡単・気軽に自分のフィーリングを表現して伝えることが出来ます。" + title: "回应" + description: "您可以在帖子中添加 \"回应\"，轻松传达和交流您的感受。" _drive: - title: "ドライブ" - description: "アップロードしたファイルを管理するインターフェイスがあります。そのため、お気に入りの画像をフォルダにまとめたり、再度共有することも簡単に行えます。" + title: "网盘" + description: "Misskey 的网盘功能可以让你轻松地将收藏收藏的图片上传到网盘、整理到文件夹中，以供分享。" _theme: - title: "テーマ" - description: "自分の好きなデザインでMisskeyを使えます。もちろんダークモードも完全サポート。自分で高度にテーマを作ることも可能です。" + title: "主题" + description: "您可以将 Misskey 定制为喜欢的主题。 Misskey 完全支持深色模式，此外，您还可以创建自己的高级主题。" _thread: - title: "スレッド" - description: "もちろんノートはスレッドにすることができ、気が済むまで会話を続けられます。" + title: "帖文串" + description: "您可以将帖子串起来，形成一个长长的串，持续交流，直到满意为止。" _charts: - title: "チャート" - description: "Misskeyは組み込みのチャートエンジンを備えていて、サーバーの利用状況などが簡単に可視化できます。" + title: "图标" + description: "Misskey 内置图表引擎，可轻松实现服务器的使用情况和其他信息的可视化。" _widgets: - title: "ウィジェット" - description: "様々な種類のウィジェットを配置し、UIを好みにカスタマイズできます。" + title: "小组件" + description: "你可以放置各种类型的小部件，根据喜好定制界面。" _getStarted: - title: "Misskeyをはじめよう" + title: "开始使用 Misskey" _find: - title: "サーバーを見つける" - list: "サーバーのリスト" + title: "寻找服务器" + list: "服务器列表" _create: - title: "サーバーを作成" - guide: "セットアップガイド" + title: "创建服务器" + guide: "配置指南" _docs: - title: "さらに詳しく知る" - docs: "ドキュメントを見る" + title: "了解更多信息" + docs: "阅读文档" _donation: - title: "寄付のお願い" - description: "Misskeyは非営利なため、開発資金は皆様からの寄付に頼っています。Misskeyを気に入られたら、今後も開発を続けられるようにぜひ支援をお願いします。" + title: "请捐赠" + description: "Misskey 是非营利的，我们依靠您的捐款来资助它的发展。所以如果您喜欢 Misskey，请支持我们，以便我们能够继续开发它。" _sponsors: title: "赞助者" _servers: title: "服务器列表" - description: "Misskeyは単一のサービスではなく、各々がサービスを提供する分散型ネットワークとなっています。Misskeyを利用するには、サービスを提供しているサーバーでアカウントを作成する必要があります。" + description: "Misskey 不是一个单一的服务，而是由一个个服务组成的分布式网络。欲使用 Misskey，您需要在提供服务的服务器上注册一个账户。" addYourServer: "あなたのサーバーが表示されませんか？{0}から登録してください！" - addYourServerLink: "こちら" + addYourServerLink: "这里" _system: - fetchError: "データの読み込みに失敗しました。後でもう一度お試しください。" + fetchError: "无法加载。请稍后重试。" _statistics: title: "服务器统计数据" - description: "Misskeyサーバーの統計データをグラフでご紹介。" - viewFullStats: "詳しい統計を見る" - lang: "プライマリ言語" - registerAcceptance: "新規登録受付方式" + description: "下面是 Misskey 服务器的统计数据图表。" + viewFullStats: "查看详细数据" + lang: "主要语言" + registerAcceptance: "注册模式" version: "版本" - notes: "ノート数" + notes: "帖子数量" users: "用户数量" servers: "服务器数量" _search: - title: "絞り込み検索" - all: "すべて" + title: "精确搜索" + all: "全部" query: "キーワードで検索" - lang: "言語" - orderBy: "並び替え" - recomendded: "デフォルト" - notesCount: "ノート数" - notesPer15Days: "1日あたりのノート数（15日平均）" - usersCount: "ユーザー数" + lang: "语言" + orderBy: "排序方式" + recomendded: "默认" + notesCount: "帖子数量" + notesPer15Days: "每日帖子数（15 天平均值）" + usersCount: "用户数" _registerAcceptance: - title: "新規登録" - public: "開放" - inviteOnly: "招待のみ" + title: "注册模式" + public: "开放注册" + inviteOnly: "邀请制" _list: - notFound: "指定された条件に合致するサーバーは見つかりませんでした。" - showMore: "もっと見る" + notFound: "未找到符合指定条件的服务器。" + showMore: "浏览更多" _view: - title: "表示形式" - list: "リスト" - grid: "グリッド" + title: "展示模式" + list: "列表" + grid: "网格" _docs: - title: "ドキュメント" - description: "Misskeyはオープンソースの分散型ソーシャルネットワーキングプラットフォームです。Misskeyの上手な使い方から、サーバーの運営者・プログラムの開発者向けの情報まで網羅しています。" - indexTitle: "目次ページ" + title: "文档" + description: "Misskey 是一个开源的去中心化社交网络。本文档涵盖从如何很好地使用 Misskey 到面向服务器管理员和程序员的各种信息。" + indexTitle: "目录" _contribute: editThis: "编辑本页面" translateThis: "翻译本页面" _aboutMisskey: - title: "Misskeyについて" - description: "Misskeyをはじめて知ったかたや、これから使うかた向け！基本的なしくみや機能を見ていきましょう。" + title: "关于 Misskey" + description: "对于刚接触 Misskey 的人和将来要使用它的人，让我们来了解一下它的基本机制和功能。" _changelog: title: "发布日志" - description: "Misskeyのバージョンアップ履歴をご覧いただけます。最新のバージョンで何が変わったのかを確認しましょう！" + description: "查看 Misskey 的历史版本，了解最新版本有哪些变化！" + _donate: + title: "プロジェクトへの寄付" + description: "Misskeyは無料で使えるオープンソースのソフトウェアです。気に入っていただけたら、今後も開発を続けられるようにぜひ寄付をご検討ください。" _forUsers: title: "Misskeyユーザー向け" _forAdmin: @@ -178,11 +184,17 @@ _brandAssets: icon: "アイコン" banner: "バナー" avatarDecorationTemplate: "アバターデコレーション テンプレート" +_contact: + title: "お問い合わせ" + description: "Misskey Projectへのお問い合わせはこちらから" + form: "こちらのフォームからご回答ください。" + formGoogleAccountRequired: "現在、スパム対策のため、お問い合わせの送信にはGoogleアカウントが必要となっております。\nお手数をおかけしますが、ご理解のほどよろしくお願い致します。" + formLink: "フォームへ進む" _links: title: "リンク" _github: title: "GitHub" - description: "Misskeyの開発はGithub上で行われています。機能リクエストやバグ報告などはこちらから行えます。" + description: "Misskeyの開発はGitHub上で行われています。機能リクエストやバグ報告などはこちらから行えます。" _crowdin: title: "Crowdin" description: "Misskey本体、およびドキュメントの翻訳はこちらで管理されています。皆さんのご協力をお願いします。" @@ -220,8 +232,8 @@ _aidConverter: mode: "作成するid" date: "日付時刻" _aboutUs: - title: "Misskey Development Divisionについて" - description: "Misskey開発チームについての情報を掲載しています。" + title: "Misskey Projectについて" + description: "Misskey Projectについての情報を掲載しています。" _team: title: "開発メンバー" description: "Misskeyの開発に関わっている方を紹介しています。" @@ -310,6 +322,11 @@ _customEmojiPreview: textDescription: "追加したカスタム絵文字は{emoji_id}で参照できます。" _placeholder: noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" +_identiconGenerator: + title: "初期アイコンジェネレーター" + description: "Misskeyに登録した際にデフォルトで指定される初期アイコンを生成できます。" + userName: "ユーザー名" + includeDomain: "サーバーのドメイン名を含む完全なユーザー名を指定してください。" _api: _permissions: title: "権限" diff --git a/locales/zh-TW.yml b/locales/zh-TW.yml index 0171962e..ee9b5572 100644 --- a/locales/zh-TW.yml +++ b/locales/zh-TW.yml @@ -7,9 +7,12 @@ share: "分享" note: "貼文" other: "其他" add: "新增" -browse: "参照" +generate: "生成" +download: "ダウンロード" +browse: "瀏覽" settings: "設定" goToLegacyHub: "舊版的 Misskey Hub" +contactUs: "お問い合わせ" _error: notFound: "找不到此頁面" notFoundDesc: "找不到此頁面，請確認網址是否正確。" @@ -145,6 +148,9 @@ _docs: _changelog: title: "版本資訊" description: "您可以查看 Misskey 的版本更新歷史。看看最新版本有哪些變化！" + _donate: + title: "プロジェクトへの寄付" + description: "Misskeyは無料で使えるオープンソースのソフトウェアです。気に入っていただけたら、今後も開発を続けられるようにぜひ寄付をご検討ください。" _forUsers: title: "針對 Misskey 的使用者" _forAdmin: @@ -172,12 +178,18 @@ _other: _brandAssets: title: "資源集" description: "Misskey 標誌、圖標和其他資產的集合。您可以在一定的許可下自由使用它。" - license: "資產可在 CC BY-SA 授權下免費使用🎉" + license: "資產可在 CC BY-NC-SA 授權下免費使用🎉" assetsDirectory: "所有資產均由 {0} 管理。" logo: "標誌" icon: "圖標" banner: "橫幅" avatarDecorationTemplate: "頭像裝飾模板" +_contact: + title: "お問い合わせ" + description: "Misskey Projectへのお問い合わせはこちらから" + form: "こちらのフォームからご回答ください。" + formGoogleAccountRequired: "現在、スパム対策のため、お問い合わせの送信にはGoogleアカウントが必要となっております。\nお手数をおかけしますが、ご理解のほどよろしくお願い致します。" + formLink: "フォームへ進む" _links: title: "連結" _github: @@ -200,7 +212,7 @@ _tools: _forUsers: title: "針對 Misskey 的使用者" _forAdmin: - title: "サーバー運営者向け" + title: "針對伺服器營運者" _mfmPlayground: title: "MFM 試用區" description: "您可以自由練習MFM！下面重現了 Misskey 的發文畫面/貼文畫面！" @@ -300,16 +312,21 @@ _avatarDecorationPreview: noteText: "我吃了一個巧克力甜甜圈🍩😋" profileDescription: "我是 Misskey 的常駐人工智慧小藍！很高興見到你♪" _customEmojiPreview: - title: "カスタム絵文字 プレビュー" - description: "カスタム絵文字の視認性をチェックできます。" - preview: "プレビュー" - emoji: "絵文字 #{number}" - placeholder: "「追加」から、カスタム絵文字を追加してプレビューできます。" + title: "預覽自訂表情符號" + description: "可以檢查自訂表情符號的可見性。" + preview: "預覽" + emoji: "表情符號 #{number}" + placeholder: "從「新增」中，您可以新增和預覽自訂表情符號。" _options: - text: "ノート文面" - textDescription: "追加したカスタム絵文字は{emoji_id}で参照できます。" + text: "貼文內容" + textDescription: "您可以透過 {emoji_id} 引用新增的自訂表情符號。" _placeholder: - noteText: "カスタム絵文字はこんな感じで表示されます→ :emoji_preview_1:\n文章を書き換えて、使い勝手を試してみてくださいね✨" + noteText: "自訂表情符號將顯示如下 → :emoji_preview_1:\n請重寫句子並嘗試可用性✨" +_identiconGenerator: + title: "初期アイコンジェネレーター" + description: "Misskeyに登録した際にデフォルトで指定される初期アイコンを生成できます。" + userName: "ユーザー名" + includeDomain: "サーバーのドメイン名を含む完全なユーザー名を指定してください。" _api: _permissions: title: "權限" diff --git a/package.json b/package.json index 3b8a742b..56e751ea 100644 --- a/package.json +++ b/package.json @@ -39,7 +39,7 @@ "ufo": "^1.5.1", "vite-svg-loader": "^5.1.0" }, - "packageManager": "pnpm@8.10.2", + "packageManager": "pnpm@8.15.5", "dependencies": { "nanoid": "^5.0.6" } diff --git a/pages/contact.vue b/pages/contact.vue new file mode 100644 index 00000000..cdbf8ac1 --- /dev/null +++ b/pages/contact.vue @@ -0,0 +1,46 @@ + +
+
+ {{ $t('_contact.title') }}
+
+ {{ $t('_contact.description') }}
+
+
+
+
+
+
+
+
+
diff --git a/pages/learn-more.vue b/pages/learn-more.vue
index 806b27d2..b8def928 100644
--- a/pages/learn-more.vue
+++ b/pages/learn-more.vue
@@ -61,6 +61,12 @@
title: $t('_aboutUs.title'),
description: $t('_aboutUs.description'),
img: '/img/misc/midev.png',
+ },
+ {
+ to: localePath('/contact/'),
+ title: $t('_contact.title'),
+ description: $t('_contact.description'),
+ img: '/img/emojis/envelope_3d.png',
},
]" />
diff --git a/public/img/emojis/envelope_3d.png b/public/img/emojis/envelope_3d.png
new file mode 100644
index 00000000..25a90b68
Binary files /dev/null and b/public/img/emojis/envelope_3d.png differ
+
+
+
+ 
+
+
+
+
+
+
+
+
+ {{ $t('_contact.form') }}
+{{ $t('_contact.formGoogleAccountRequired') }}
+
+
+ {{ $t('_contact.formLink') }}
+
+