Help:Extension:Translate/Insertables/ja

翻訳対象の文字列は、翻訳結果でもそのまま保持されるべきマークアップを含むことがよくあります. マークアップは特殊な文字を多く含むため、タイプするのが低速・困難になる場合があります. Insertable (インサータブル、挿入要素) は、マークアップの断片であり、翻訳者にはボタンやその他のインターフェイス要素として表示されます. ボタンをクリックすることで、翻訳内の現在のカーソルの位置に、マークアップの断片が挿入されます.

各メッセージ群は1つの  を保持できます. このクラスは  の一覧の生成を担当します. 各  は以下の3つの部分で構成されます:


 * 1) 利用者に表示するもの
 * 1) 翻訳内のカーソルの位置の前に何を挿入するか
 * 1) 翻訳内のカーソルの位置の後ろに何を挿入するか

Translate 拡張機能には組み込みの  が同梱されています. 他の種類のコンテンツの Suggester は translatewiki.net の git リポジトリにあります.



Configuration
Here's a sample configuration change in a YAML file,

Pre-provided / Bundled insertables
Following is a list of bundled insertables.

HtmlTagInsertablesSuggester
This insertable will display suggestion for any HTML tags found inside the source string.

For example:


 * Message: This linklink takes you to the home page.
 * Suggester displayed:

MediaWikiInsertablesSuggester
This insertable will display various suggestion for MediaWiki related wikitext messages. These include suggestion for,


 * Parameters like  which are present in API Help messages.
 * Suggestions for HTML tags.

NumericalParameterInsertablesSuggester
This insertable will display suggestions for numerical parameters such as,  , or

RegexInsertablesSuggester
This insertable is a general purpose insertable that can be used to display suggestions based on a custom regular expression.

Example:

Parameter description,


 * regex - The regex to use for identifying insertables. Mandatory.
 * display - What to show to the user. Not mandatory, defaults to matched value.
 * pre - What to insert before selection, or replace selection if  remains empty Not mandatory, defaults to matched value.
 * post - What to insert after selection. Not mandatory, defaults to matched value.

TranslatablePageInsertablesSuggester
Used primarily on translatable pages to provide suggester for variables like.

UrlInsertablesSuggester
This insertable finds URLs (that are normally unchanged in translations) and suggests them for insertion.

Adding a custom insertable
In case existing insertables are not sufficient to meet your requirements, it is possible to add custom insertables.

既存のファイル ベースのメッセージ群である「FreeCol」に Insertable 対応を追加する例を示します. YAML ファイルは簡潔にするため一部省略されています. 新たに追加された行が強調されています.

FreeCol.yaml:

Suggester.php:

Insertable のパラメーターは以下の通りです: