diff --git a/content/cn/docs/4.for-developers/plugin/create-plugin.md b/content/cn/docs/4.for-developers/plugin/create-plugin.md index 5587cfc1d..2d4dc79eb 100644 --- a/content/cn/docs/4.for-developers/plugin/create-plugin.md +++ b/content/cn/docs/4.for-developers/plugin/create-plugin.md @@ -3,6 +3,33 @@ Misskey Web 客户端的插件功能将允许您扩展客户端并添加各种功能。\ 本文档介绍如何创建插件 +## プラグインの例 + +以下に完全なプラグインの例を示します。このプラグインは、[`Plugin:register_post_form_action`](/docs/for-developers/plugin/plugin-api-reference/#pluginregister_post_form_actiontitle-fn)を使用して、投稿フォームに「フグパンチボタン」を追加するものです。 + +このプラグインをインストールすると、投稿フォーム上のプラグインメニューに「フグパンチ」の項目が追加されます。クリックすると、投稿フォーム上のテキストに `ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )` が追加されます。 + +```ais +/// @ 0.12.4 +### { + name: "フグパンチボタン" + version: "0.0.1" + author: "Misskey Project" +} + +Plugin:register_post_form_action('フグパンチ', @(note, rewrite) { + let fugu = "ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )" + + if (note.text.trim() == '') { + // ノートの中身がない場合はフグパンチに置き換え + rewrite('text', fugu) + } else { + // ノートの中身がある場合は冒頭にフグパンチを追加して改行 + rewrite('text', `{fugu}{Str:lf}{note.text}`) + } +}) +``` + ## 插件是指使用 AiScript 编写的脚本。 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 c837a93c6..d68ed907d 100644 --- a/content/en/docs/4.for-developers/plugin/create-plugin.md +++ b/content/en/docs/4.for-developers/plugin/create-plugin.md @@ -2,6 +2,33 @@ The plugin feature of the Misskey Web Client allows you to extend the client and add various features to it. +## Example + +This is a complete example of plugin.This plugin adds a "Fugu Punch Button" to the post form by utilizing [`Plugin:register_post_form_action`](/docs/for-developers/plugin/plugin-api-reference/#pluginregister_post_form_actiontitle-fn). + +By installing this plugin, you will find additional item named "Fugu Punch" in plugin section of the post form.And if you click the button, `ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )` will be appended in the body text. + +```ais +/// @ 0.12.4 +### { + name: "Fugu Punch Button" + version: "0.0.1" + author: "Misskey Project" +} + +Plugin:register_post_form_action('Fugu Punch', @(note, rewrite) { + let fugu = "ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )" + + if (note.text.trim() == '') { + // Replace with Fugu Punch when no body text is present + rewrite('text', fugu) + } else { + // If body has some content, append Fugu Punch and line break + rewrite('text', `{fugu}{Str:lf}{note.text}`) + } +}) +``` + ## AiScript Plugins are scripts written using AiScript. diff --git a/content/fr/docs/4.for-developers/plugin/create-plugin.md b/content/fr/docs/4.for-developers/plugin/create-plugin.md index 59654b985..9a0db914f 100644 --- a/content/fr/docs/4.for-developers/plugin/create-plugin.md +++ b/content/fr/docs/4.for-developers/plugin/create-plugin.md @@ -3,6 +3,33 @@ Misskey Webクライアントのプラグイン機能を使うと、クライアントを拡張し、様々な機能を追加できます。 このドキュメントではプラグインの作成方法について説明します。 +## プラグインの例 + +以下に完全なプラグインの例を示します。このプラグインは、[`Plugin:register_post_form_action`](/docs/for-developers/plugin/plugin-api-reference/#pluginregister_post_form_actiontitle-fn)を使用して、投稿フォームに「フグパンチボタン」を追加するものです。 + +このプラグインをインストールすると、投稿フォーム上のプラグインメニューに「フグパンチ」の項目が追加されます。クリックすると、投稿フォーム上のテキストに `ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )` が追加されます。 + +```ais +/// @ 0.12.4 +### { + name: "フグパンチボタン" + version: "0.0.1" + author: "Misskey Project" +} + +Plugin:register_post_form_action('フグパンチ', @(note, rewrite) { + let fugu = "ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )" + + if (note.text.trim() == '') { + // ノートの中身がない場合はフグパンチに置き換え + rewrite('text', fugu) + } else { + // ノートの中身がある場合は冒頭にフグパンチを追加して改行 + rewrite('text', `{fugu}{Str:lf}{note.text}`) + } +}) +``` + ## AiScript プラグインはAiScriptを使って記述されるスクリプトです。 diff --git a/content/id/docs/4.for-developers/plugin/create-plugin.md b/content/id/docs/4.for-developers/plugin/create-plugin.md index a82601314..2006bfa8e 100644 --- a/content/id/docs/4.for-developers/plugin/create-plugin.md +++ b/content/id/docs/4.for-developers/plugin/create-plugin.md @@ -3,6 +3,33 @@ Fitur plugin dalam klien Misskey Web memperbolehkan kamu untuk memperluas fungsionalitas klien dan menambah fitur lain. Dokumen ini akan menjelaskan bagaimana cara membuat plugin Misskey. +## プラグインの例 + +以下に完全なプラグインの例を示します。このプラグインは、[`Plugin:register_post_form_action`](/docs/for-developers/plugin/plugin-api-reference/#pluginregister_post_form_actiontitle-fn)を使用して、投稿フォームに「フグパンチボタン」を追加するものです。 + +このプラグインをインストールすると、投稿フォーム上のプラグインメニューに「フグパンチ」の項目が追加されます。クリックすると、投稿フォーム上のテキストに `ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )` が追加されます。 + +```ais +/// @ 0.12.4 +### { + name: "フグパンチボタン" + version: "0.0.1" + author: "Misskey Project" +} + +Plugin:register_post_form_action('フグパンチ', @(note, rewrite) { + let fugu = "ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )" + + if (note.text.trim() == '') { + // ノートの中身がない場合はフグパンチに置き換え + rewrite('text', fugu) + } else { + // ノートの中身がある場合は冒頭にフグパンチを追加して改行 + rewrite('text', `{fugu}{Str:lf}{note.text}`) + } +}) +``` + ## AiScript Plugin merupakan script yang dituliskan menggunakan bahasa pemrograman AiScript. diff --git a/content/it/docs/4.for-developers/plugin/create-plugin.md b/content/it/docs/4.for-developers/plugin/create-plugin.md index 59654b985..9a0db914f 100644 --- a/content/it/docs/4.for-developers/plugin/create-plugin.md +++ b/content/it/docs/4.for-developers/plugin/create-plugin.md @@ -3,6 +3,33 @@ Misskey Webクライアントのプラグイン機能を使うと、クライアントを拡張し、様々な機能を追加できます。 このドキュメントではプラグインの作成方法について説明します。 +## プラグインの例 + +以下に完全なプラグインの例を示します。このプラグインは、[`Plugin:register_post_form_action`](/docs/for-developers/plugin/plugin-api-reference/#pluginregister_post_form_actiontitle-fn)を使用して、投稿フォームに「フグパンチボタン」を追加するものです。 + +このプラグインをインストールすると、投稿フォーム上のプラグインメニューに「フグパンチ」の項目が追加されます。クリックすると、投稿フォーム上のテキストに `ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )` が追加されます。 + +```ais +/// @ 0.12.4 +### { + name: "フグパンチボタン" + version: "0.0.1" + author: "Misskey Project" +} + +Plugin:register_post_form_action('フグパンチ', @(note, rewrite) { + let fugu = "ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )" + + if (note.text.trim() == '') { + // ノートの中身がない場合はフグパンチに置き換え + rewrite('text', fugu) + } else { + // ノートの中身がある場合は冒頭にフグパンチを追加して改行 + rewrite('text', `{fugu}{Str:lf}{note.text}`) + } +}) +``` + ## AiScript プラグインはAiScriptを使って記述されるスクリプトです。 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 0e40dd281..197c72a93 100644 --- a/content/ko/docs/4.for-developers/plugin/create-plugin.md +++ b/content/ko/docs/4.for-developers/plugin/create-plugin.md @@ -2,6 +2,33 @@ Misskey 웹 클라이언트의 플러그인 기능을 사용하면 클라이언트를 확장하고 다양한 기능을 추가할 수 있습니다. +## プラグインの例 + +以下に完全なプラグインの例を示します。このプラグインは、[`Plugin:register_post_form_action`](/docs/for-developers/plugin/plugin-api-reference/#pluginregister_post_form_actiontitle-fn)を使用して、投稿フォームに「フグパンチボタン」を追加するものです。 + +このプラグインをインストールすると、投稿フォーム上のプラグインメニューに「フグパンチ」の項目が追加されます。クリックすると、投稿フォーム上のテキストに `ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )` が追加されます。 + +```ais +/// @ 0.12.4 +### { + name: "フグパンチボタン" + version: "0.0.1" + author: "Misskey Project" +} + +Plugin:register_post_form_action('フグパンチ', @(note, rewrite) { + let fugu = "ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )" + + if (note.text.trim() == '') { + // ノートの中身がない場合はフグパンチに置き換え + rewrite('text', fugu) + } else { + // ノートの中身がある場合は冒頭にフグパンチを追加して改行 + rewrite('text', `{fugu}{Str:lf}{note.text}`) + } +}) +``` + ## AiScript 플러그인은 AiScript로 작성되는 스크립트입니다. diff --git a/content/pl/docs/4.for-developers/plugin/create-plugin.md b/content/pl/docs/4.for-developers/plugin/create-plugin.md index 59654b985..9a0db914f 100644 --- a/content/pl/docs/4.for-developers/plugin/create-plugin.md +++ b/content/pl/docs/4.for-developers/plugin/create-plugin.md @@ -3,6 +3,33 @@ Misskey Webクライアントのプラグイン機能を使うと、クライアントを拡張し、様々な機能を追加できます。 このドキュメントではプラグインの作成方法について説明します。 +## プラグインの例 + +以下に完全なプラグインの例を示します。このプラグインは、[`Plugin:register_post_form_action`](/docs/for-developers/plugin/plugin-api-reference/#pluginregister_post_form_actiontitle-fn)を使用して、投稿フォームに「フグパンチボタン」を追加するものです。 + +このプラグインをインストールすると、投稿フォーム上のプラグインメニューに「フグパンチ」の項目が追加されます。クリックすると、投稿フォーム上のテキストに `ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )` が追加されます。 + +```ais +/// @ 0.12.4 +### { + name: "フグパンチボタン" + version: "0.0.1" + author: "Misskey Project" +} + +Plugin:register_post_form_action('フグパンチ', @(note, rewrite) { + let fugu = "ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )" + + if (note.text.trim() == '') { + // ノートの中身がない場合はフグパンチに置き換え + rewrite('text', fugu) + } else { + // ノートの中身がある場合は冒頭にフグパンチを追加して改行 + rewrite('text', `{fugu}{Str:lf}{note.text}`) + } +}) +``` + ## AiScript プラグインはAiScriptを使って記述されるスクリプトです。 diff --git a/content/th/docs/4.for-developers/plugin/create-plugin.md b/content/th/docs/4.for-developers/plugin/create-plugin.md index 59654b985..9a0db914f 100644 --- a/content/th/docs/4.for-developers/plugin/create-plugin.md +++ b/content/th/docs/4.for-developers/plugin/create-plugin.md @@ -3,6 +3,33 @@ Misskey Webクライアントのプラグイン機能を使うと、クライアントを拡張し、様々な機能を追加できます。 このドキュメントではプラグインの作成方法について説明します。 +## プラグインの例 + +以下に完全なプラグインの例を示します。このプラグインは、[`Plugin:register_post_form_action`](/docs/for-developers/plugin/plugin-api-reference/#pluginregister_post_form_actiontitle-fn)を使用して、投稿フォームに「フグパンチボタン」を追加するものです。 + +このプラグインをインストールすると、投稿フォーム上のプラグインメニューに「フグパンチ」の項目が追加されます。クリックすると、投稿フォーム上のテキストに `ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )` が追加されます。 + +```ais +/// @ 0.12.4 +### { + name: "フグパンチボタン" + version: "0.0.1" + author: "Misskey Project" +} + +Plugin:register_post_form_action('フグパンチ', @(note, rewrite) { + let fugu = "ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )" + + if (note.text.trim() == '') { + // ノートの中身がない場合はフグパンチに置き換え + rewrite('text', fugu) + } else { + // ノートの中身がある場合は冒頭にフグパンチを追加して改行 + rewrite('text', `{fugu}{Str:lf}{note.text}`) + } +}) +``` + ## AiScript プラグインはAiScriptを使って記述されるスクリプトです。 diff --git a/content/tw/docs/4.for-developers/plugin/create-plugin.md b/content/tw/docs/4.for-developers/plugin/create-plugin.md index 59654b985..9a0db914f 100644 --- a/content/tw/docs/4.for-developers/plugin/create-plugin.md +++ b/content/tw/docs/4.for-developers/plugin/create-plugin.md @@ -3,6 +3,33 @@ Misskey Webクライアントのプラグイン機能を使うと、クライアントを拡張し、様々な機能を追加できます。 このドキュメントではプラグインの作成方法について説明します。 +## プラグインの例 + +以下に完全なプラグインの例を示します。このプラグインは、[`Plugin:register_post_form_action`](/docs/for-developers/plugin/plugin-api-reference/#pluginregister_post_form_actiontitle-fn)を使用して、投稿フォームに「フグパンチボタン」を追加するものです。 + +このプラグインをインストールすると、投稿フォーム上のプラグインメニューに「フグパンチ」の項目が追加されます。クリックすると、投稿フォーム上のテキストに `ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )` が追加されます。 + +```ais +/// @ 0.12.4 +### { + name: "フグパンチボタン" + version: "0.0.1" + author: "Misskey Project" +} + +Plugin:register_post_form_action('フグパンチ', @(note, rewrite) { + let fugu = "ﾌｸﾞﾊﾟﾝﾁ!!!!🐡( '-' 🐡 )" + + if (note.text.trim() == '') { + // ノートの中身がない場合はフグパンチに置き換え + rewrite('text', fugu) + } else { + // ノートの中身がある場合は冒頭にフグパンチを追加して改行 + rewrite('text', `{fugu}{Str:lf}{note.text}`) + } +}) +``` + ## AiScript プラグインはAiScriptを使って記述されるスクリプトです。