View source for Template:NoteTA/doc

{{NoteTA
|G1=IT
|G2=MediaWiki
}}
{{Documentation subpage}}
{{Bot use warning|bot=[[User:cewbot/log/20191129/configuration]]}}
{{High-use|all-pages=yes}}
{{lua|Module:NoteTA}}
{{字詞轉換索引}}
<!-- 在本行下編輯模板說明 -->

本模板用於定義頁面的[[Help:中文维基百科的繁简、地区词处理|地區詞（簡繁）轉換]]規則，一般[[WP:LEADORDER|置於頁面頂端]]。

本模板每調用一次，頁面閱讀介面頂部就會出現一個NoteTA标志（[[File:Zh conversion icon m.svg|x14px|本页使用了标题或全文手工转换|link=]]）。用戶可以點擊該圖示，檢視具體的轉換資訊。

== 使用說明 ==
用法：
-{zh-hans:<syntaxhighlight lang="wikitext">
{{NoteTA
|T=标题转换
|dt=标题转换描述
|G1=公共转换组1
|G2=公共转换组2
...
|1=转换用词1
|2=转换用词2
...
|d1=转换用词1描述
|d2=转换用词2描述
...
}}
</syntaxhighlight>;zh-hant:<syntaxhighlight lang="wikitext">
{{NoteTA
|T=標題轉換
|dt=標題轉換描述
|G1=公共轉換組1
|G2=公共轉換組2
...
|1=轉換用詞1
|2=轉換用詞2
...
|d1=轉換用詞1描述
|d2=轉換用詞2描述
...
}}
</syntaxhighlight>}-
* {{Para|T}}（標題轉換） — 控制頁面標題的轉換。如{{Para|T|zh-cn:雷霆 (最终幻想);zh-hk:雷光;zh-tw:雷光;}}。在各地標題均無消歧義括註，以及均有消歧義括註而且括註（除繁簡外）一致的情況下，正確使用下述的「公共轉換組」和「個別用詞轉換」參數即可正確轉換標題；因此除非各地標題消歧義括註（除繁簡外）不一致，一般不需要填寫本參數。
* {{Para|dt}}（標題轉換描述） — 页面标题转换规则解释文字。
* {{Para|G1}}至{{Para|G30}}（公共转换组） — 导入已定义好的[[Wikipedia:字詞轉換處理/公共轉換組|公共转换组]]，批量載入轉換規則。如{{Para|G1|Physics}}表示載入[[Module:CGroup/Physics|物理学轉換組]]定義的一系列規則。
* {{Para|1}}至{{Para|30}}（個別用詞轉換） — 單獨定義用詞轉換。如{{Para|1|zh-cn:信息;zh-my:资讯;zh-hant:資訊;}}表示爲頁面加入「-{信息}-／-{資訊}-」的轉換。
* {{Para|d1}}至{{Para|d30}}（個別用詞轉換描述） — 对上述單獨定義用詞轉換的解释文字。

== 示例 ==
=== 全文转换 ===
下例爲頁面加入兩條規則「-{量子计算机}-／-{量子電腦}-」和「-{信息}-／-{資訊}-」兩條轉換規則：
<syntaxhighlight lang="wikitext" style="width: 80%; margin: auto;">
{{NoteTA
|1=zh-cn:量子计算机;zh-my:量子电脑;zh-hant:量子電腦;
|2=zh-cn:信息;zh-my:资讯;zh-hant:資訊;
}}
</syntaxhighlight>
爲方便書寫及調整順序，一般也可以省略{{Para|1}}、{{Para|2}}，直接以匿名參數寫成：
<syntaxhighlight lang="wikitext" style="width: 80%; margin: auto;">
{{NoteTA
|zh-cn:量子计算机;zh-my:量子电脑;zh-hant:量子電腦;
|zh-cn:信息;zh-my:资讯;zh-hant:資訊;
}}
</syntaxhighlight>

==== 使用單向轉換規則 ====
維持無歧義的用詞雙向轉換，再將有歧義的用詞單向轉換，而條目內則採無歧義用詞，也就無需都要單向轉換還得一一對應。雖「字詞轉換」方框仍顯示紅字「在手动语言转换规则中检测到错误」，但不影響運作。
<syntaxhighlight lang="wikitext" style="width: 80%; margin: auto;">
{{NoteTA
|1=zh-tw:熊麻吉;zh-hk:賤熊30;zh-sg:熊麻吉;zh-my:熊麻吉;
|2=熊麻吉=>zh-cn:泰迪熊;賤熊30=>zh-cn:泰迪熊;
}}
</syntaxhighlight>
注意，單向轉換規則中含有「<code>=</code>」字元。如果試圖對單向轉換規則使用匿名參數，就會導致模板解讀參數錯誤。如果希望雙向轉換規則使用匿名參數，請爲單向轉換規則編一個數字較大（不大於30）的序號，如：
<syntaxhighlight lang="wikitext" style="width: 80%; margin: auto;">
{{NoteTA
|zh-tw:熊麻吉;zh-hk:賤熊30;zh-sg:熊麻吉;zh-my:熊麻吉;
|25=熊麻吉=>zh-cn:泰迪熊;賤熊30=>zh-cn:泰迪熊;<!-- 給單向轉換規則編一個數字較大的序號，這樣雙向轉換規則就可以繼續使用匿名參數 -->
}}
</syntaxhighlight>

==== 指定不转换 ====
<syntaxhighlight lang="wikitext" style="width: 80%; margin: auto;">
{{NoteTA
|1=种
}}
</syntaxhighlight>
若無設定標的，則指定用詞不轉換。勿加「<code>;</code>」，否則會視為不完整的單向轉換規則而無作用。

=== 公共轉換組轉換 ===
在《[[變形金剛]]》電影導演[[麥可·貝]]的條目中，可透過{{Para|G1|變形金剛}}直接引入[[Template:CGroup/變形金剛]]中定義的規則。
<syntaxhighlight lang="wikitext" style="width: 80%; margin: auto;">
{{NoteTA
|G1=變形金剛
|zh-cn:迈克尔·贝;zh-sg:迈克尔·贝;zh-my:麦可·贝;zh-tw:麥可·貝;zh-hk:米高·比爾;
}}
</syntaxhighlight>
請注意，公共轉換組調用的是對應子頁面[[Template:CGroup/變形金剛]]，所以結尾勿加入「<code>;</code>」，否則會視為調用不存在的{{Redlink|Template:CGroup/變形金剛;}}而無效。

直接調用公共转换组有很多好处，方便在相近领域和主题的条目中共用，方便维护，不限个数。您可在[[Template:CGroup/list]]頁面搜尋可用的公共轉換組，或檢視[[:Category:公共轉換組模板]]分類。關於公共轉換組的詳細說明和創建過程可查閱[[Wikipedia:字詞轉換處理/公共轉換組]]。

當頁面載入多個轉換組時，較後匯入的轉換組優先；因此請先載入較寬泛的轉換組，後載入較專精的轉換組。例如對於遊戲硬體條目，請使用{{xt|<nowiki>{{NoteTA|G1=IT|G2=Games}}</nowiki>}}而非{{!xt|<nowiki>{{NoteTA|G1=Games|G2=IT}}</nowiki>}}。只有將更專門的Games轉換組放在後方，才能覆蓋IT轉換組的過度轉換規則。

=== 標題轉換 ===
[[雷霆 (最终幻想)]]條目，因中國大陸譯名「雷霆」[[雷霆|另有條目]]佔據，標題需加消歧義括註，而臺港譯名「雷光」因沒有同名條目，標題不需要消歧義括註。此時使用標題轉換，即可解決標題消歧義括註不對等的問題。
<syntaxhighlight lang="wikitext" style="width: 80%; margin: auto;">
{{NoteTA
|T=zh-cn:雷霆 (最终幻想);zh-hk:雷光;zh-tw:雷光;
|G1=Games
|zh-cn:雷霆;zh-hk:雷光;zh-tw:雷光;
|zh-cn:最终幻想;zh-tw:Final Fantasy;
}}
</syntaxhighlight>
各地頁面標題如果均無消歧義括註，或是都有消歧義括註而且括註一致（逐字繁簡對應亦屬一致），則可由全文轉換或更上層轉換的相似規則轉換標題，不需另設標題轉換規則。一條標題轉換規則若與全文轉換或更上層轉換規則一致，則屬贅余，可去除。

== 进阶使用说明 ==
* 本模板還有{{Para|dt}}、{{Para|d1}}、{{Para|d2}}等參數。此參數用於給相應序號的轉換規則加註說明。點擊頁面頂部的[[File:Zh conversion icon m.svg|x14px|本页使用了标题或全文手工转换|link=]]圖示，可見註釋內容。
* 本模板規則的實質是模擬<code><nowiki>-{H|...}-</nowiki></code>語法，該語法只能轉換其後方的原始碼，因此{{tl|NoteTA}}必須置於除{{tooltip|標題|無論NoteTA位於何處，標題相應字詞都能被轉換}}外全部需要轉換的字詞之上，一般位於[[Wikipedia:格式手冊/序言章節|序言]]（及[[Wikipedia:格式手册/信息框|資訊框]]）之上，亦可簡單理解為頁面開頭；不過，如欲[[Wikipedia:消歧义#消歧义提示|消歧義]][[Wikipedia:頂註#頂註模板|頂註模板]]中相應字詞免遭轉換，則{{tl|NoteTA}}應當置於消歧義頂註模板之下。[[User:Cewbot/log/20191129/configuration]]會嘗試將<code><nowiki>-{A|...}-</nowiki></code>、<code><nowiki>-{H|...}-</nowiki></code>合併至{{tl|NoteTA}}。

== 其他注意事項 ==
* 如果標題有地區詞差異，請順道為各地區的標題建立重定向頁，因為填寫NoteTA並不會自動建立地區標題重定向。
* 若某條目掛有{{Tlx|TARequired}}，表示需要加入本模板{{Tlx|NoteTA}}。詳見[[Special:链入页面/Template:TARequired|需要NoteTA模板的頁面]]。
* 如果要在模板内使用本模板，请将本模板用<syntaxhighlight lang="wikitext" inline><noinclude>……</noinclude></syntaxhighlight>包圍，避免与包含其的页面的NoteTA模板产生冲突（特点为条目标题栏仍有一个（条目本身没有使用NoteTA）或者不止一个（条目本身有使用NoteTA）NoteTA的标志）。另外[[Help:Noinclude|noinclude组合]]与其后的模板源码之间不要有空格或換行，否则会在嵌入模板的页面插入空行。

== 模板数据 ==
{{NoteTA/TemplateData}}

<includeonly>{{sandbox other||
<!-- 本行下加入模板的分類，跨維基連結加入Wikidata（參見[[Wikipedia:Wikidata]]） -->
[[Category:字詞轉換模板|{{PAGENAME}}]]
[[Category:摺疊模板|{{PAGENAME}}]]
}}</includeonly>