Help:Extension:Translate/Insertables/zh

可翻译的字符串通常包含标记，在翻译中应按原样保留. 由于特殊字符是共通的，输入这种标记可能会很慢，而且很困难. 可插入的是一块标记，它作为一个按钮或其他界面元素呈现给翻译者. 点击这个按钮，就可以把这段标记插入到当前光标位置的翻译中.

每个信息组可以有一个. 这个-{zh-hans:类; zh-hant:類別;}-负责生成一个 的列表. 每个 都有三个部分：


 * 1) 要向用户显示的内容
 * 2) 在翻译中，在光标位置之前插入的内容或替换所选内容的内容.
 * 3) 在翻译中光标位置之后插入的内容

翻译内置了. 其他类型内容的Suggesters可以在translatewiki.net git资源库中找到.



-{zh-hans:设置; zh-hant:組態;}-
下面是YAML文件中的一个-{zh-hans:设置; zh-hant:組態;}-变更的样本.



预先提供的/捆绑的可插入物
以下是捆绑的可插入物清单.

HtmlTagInsertablesSuggester
这个可插入项将显示在源字符串中发现的任何HTML标签的建议.

例如：


 * 信息： This linklink takes you to the home page.
 * 建议者显示：

MediaWikiInsertablesSuggester
这个插件将显示与MediaWiki有关的wikitext信息的各种建议. 其中包括对以下方面的建议：


 * 像 这样的参数存在于API帮助信息中.
 * 对HTML标签的建议.
 * 对HTML标签的建议.

NumericalParameterInsertablesSuggester
这种可插入的方式将显示数字参数的建议，如 、 、或

RegexInsertablesSuggester
这个可插入文件是一个通用的可插入文件，可以用来显示基于自定义正则表达式的建议.

例如：

参数描述，


 * regex - 用来识别可插入物的重组词. 强制性的.
 * display - 向用户展示的內容. 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.

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

Here is an example about adding insertables support for existing file based message group: FreeCol. The YAML file has been trimmed for brevity. The newly added lines are highlighted.

FreeCol.yaml:

Suggester.php:

The parameters to Insertable are: