Help:Extension:Translate/Insertables/ja

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

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


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

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

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

FreeCol.yaml:

Suggester.php:

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