Help:Extension:Translate/Insertables/ja

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

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


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

Translate 拡張機能には組み込みの $MediaWikiInsertableSuggester が同梱されています. 他の種類のコンテンツの 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.
 * 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. 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.

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 のパラメーターは以下の通りです: