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 - 向用户展示的內容. 非强制性的，默认为匹配的值.
 * pre - 在选择之前插入的內容，或在 仍为空时替换选择. 非强制性的，默认为匹配的值.
 * post - 在选择之後插入的內容. 非强制性的，默认为匹配的值.

TranslatablePageInsertablesSuggester
主要用于可翻译的页面，为 等变量提供提示器.



添加一个自定义的可插入式
如果现有的可插入物不足以满足你的要求，可以添加自定义可插入物.

下面是一个关于为现有的基于文件的信息组添加可插入信息支持的例子：FreeCol. 该YAML文件已被修剪使其更简洁. 新添加的行被高亮显示.

FreeCol.yaml:

Suggester.php:

給可插入式的参数是：