Template:NoteTA/doc
 | 此頁面是Template:NoteTA的Template文档。 此頁面可能包含了模板的使用說明、分類和其他内容。 |
 | 有機器人使用本Template文档
如欲移動、刪除或修改此Template文档而無法向下兼容，並會影響機器人運作，請先通知機器人操作者，謝謝您。相關的機器人：User:cewbot/log/20191129/configuration |
 | 此Template文档被引用於約336,000個頁面，佔全部頁面的4%。 為了避免造成大規模的影響，所有對此Template文档的編輯應先於沙盒、測試樣例或您的沙盒上測試。 測試後無誤的版本可以一次性地加入此Template文档中，但是修改前請務必於討論頁發起討論。 模板引用數量會自動更新。 |
 | 此模板使用Lua语言： |
| ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
| ||||||||||||||||
| ||||||||||||||||
| ||||||||||||||||
| ||||||||||||||||
| ||||||||||||||||
| ||||||||||||||||
本模板用於定義頁面的地區詞（簡繁）轉換規則，一般置於頁面頂端。
本模板每調用一次，頁面閱讀介面頂部就會出現一個NoteTA标志（
）。用戶可以點擊該圖示，檢視具體的轉換資訊。
使用說明
[编辑]用法：
{{NoteTA
|T=标题转换
|dt=标题转换描述
|G1=公共转换组1
|G2=公共转换组2
...
|1=转换用词1
|2=转换用词2
...
|d1=转换用词1描述
|d2=转换用词2描述
...
}}
|T=（標題轉換） — 控制頁面標題的轉換。如|T=zh-cn:雷霆 (最终幻想);zh-hk:雷光;zh-tw:雷光;。在各地標題均無消歧義括註，以及均有消歧義括註而且括註（除繁簡外）一致的情況下，正確使用下述的「公共轉換組」和「個別用詞轉換」參數即可正確轉換標題；因此除非各地標題消歧義括註（除繁簡外）不一致，一般不需要填寫本參數。|dt=（標題轉換描述） — 页面标题转换规则解释文字。|G1=至|G30=（公共转换组） — 导入已定义好的公共转换组，批量載入轉換規則。如|G1=Physics表示載入物理学轉換組定義的一系列規則。|1=至|30=（個別用詞轉換） — 單獨定義用詞轉換。如|1=zh-cn:信息;zh-my:资讯;zh-hant:資訊;表示爲頁面加入「信息／資訊」的轉換。|d1=至|d30=（個別用詞轉換描述） — 对上述單獨定義用詞轉換的解释文字。
示例
[编辑]全文转换
[编辑]下例爲頁面加入兩條規則「量子计算机／量子電腦」和「信息／資訊」兩條轉換規則：
{{NoteTA
|1=zh-cn:量子计算机;zh-my:量子电脑;zh-hant:量子電腦;
|2=zh-cn:信息;zh-my:资讯;zh-hant:資訊;
}}
爲方便書寫及調整順序，一般也可以省略|1=、|2=，直接以匿名參數寫成：
{{NoteTA
|zh-cn:量子计算机;zh-my:量子电脑;zh-hant:量子電腦;
|zh-cn:信息;zh-my:资讯;zh-hant:資訊;
}}
使用單向轉換規則
[编辑]維持無歧義的用詞雙向轉換，再將有歧義的用詞單向轉換，而條目內則採無歧義用詞，也就無需都要單向轉換還得一一對應。雖「字詞轉換」方框仍顯示紅字「在手动语言转换规则中检测到错误」，但不影響運作。
{{NoteTA
|1=zh-tw:熊麻吉;zh-hk:賤熊30;zh-sg:熊麻吉;zh-my:熊麻吉;
|2=熊麻吉=>zh-cn:泰迪熊;賤熊30=>zh-cn:泰迪熊;
}}
注意，單向轉換規則中含有「=」字元。如果試圖對單向轉換規則使用匿名參數，就會導致模板解讀參數錯誤。如果希望雙向轉換規則使用匿名參數，請爲單向轉換規則編一個數字較大（不大於30）的序號，如：
{{NoteTA
|zh-tw:熊麻吉;zh-hk:賤熊30;zh-sg:熊麻吉;zh-my:熊麻吉;
|25=熊麻吉=>zh-cn:泰迪熊;賤熊30=>zh-cn:泰迪熊;<!-- 給單向轉換規則編一個數字較大的序號，這樣雙向轉換規則就可以繼續使用匿名參數 -->
}}
指定不转换
[编辑]{{NoteTA
|1=种
}}
若無設定標的，則指定用詞不轉換。勿加「;」，否則會視為不完整的單向轉換規則而無作用。
公共轉換組轉換
[编辑]在《變形金剛》電影導演麥可·貝的條目中，可透過|G1=變形金剛直接引入Template:CGroup/變形金剛中定義的規則。
{{NoteTA
|G1=變形金剛
|zh-cn:迈克尔·贝;zh-sg:迈克尔·贝;zh-my:麦可·贝;zh-tw:麥可·貝;zh-hk:米高·比爾;
}}
請注意，公共轉換組調用的是對應子頁面Template:CGroup/變形金剛，所以結尾勿加入「;」，否則會視為調用不存在的Template:CGroup/變形金剛;而無效。
直接調用公共转换组有很多好处，方便在相近领域和主题的条目中共用，方便维护，不限个数。您可在Template:CGroup/list頁面搜尋可用的公共轉換組，或檢視Category:公共轉換組模板分類。關於公共轉換組的詳細說明和創建過程可查閱Wikipedia:字詞轉換處理/公共轉換組。
當頁面載入多個轉換組時，較後匯入的轉換組優先；因此請先載入較寬泛的轉換組，後載入較專精的轉換組。例如對於遊戲硬體條目，請使用{{NoteTA|G1=IT|G2=Games}}而非{{NoteTA|G1=Games|G2=IT}}。只有將更專門的Games轉換組放在後方，才能覆蓋IT轉換組的過度轉換規則。
標題轉換
[编辑]雷霆 (最终幻想)條目，因中國大陸譯名「雷霆」另有條目佔據，標題需加消歧義括註，而臺港譯名「雷光」因沒有同名條目，標題不需要消歧義括註。此時使用標題轉換，即可解決標題消歧義括註不對等的問題。
{{NoteTA
|T=zh-cn:雷霆 (最终幻想);zh-hk:雷光;zh-tw:雷光;
|G1=Games
|zh-cn:雷霆;zh-hk:雷光;zh-tw:雷光;
|zh-cn:最终幻想;zh-tw:Final Fantasy;
}}
各地頁面標題如果均無消歧義括註，或是都有消歧義括註而且括註一致（逐字繁簡對應亦屬一致），則可由全文轉換或更上層轉換的相似規則轉換標題，不需另設標題轉換規則。一條標題轉換規則若與全文轉換或更上層轉換規則一致，則屬贅余，可去除。
进阶使用说明
[编辑]- 本模板還有
|dt=、|d1=、|d2=等參數。此參數用於給相應序號的轉換規則加註說明。點擊頁面頂部的
圖示，可見註釋內容。 - 本模板規則的實質是模擬
-{H|...}-語法，該語法只能轉換其後方的原始碼，因此{{NoteTA}}必須置於除標題外全部需要轉換的字詞之上，一般位於序言（及資訊框）之上，亦可簡單理解為頁面開頭；不過，如欲消歧義頂註模板中相應字詞免遭轉換，則{{NoteTA}}應當置於消歧義頂註模板之下。User:Cewbot/log/20191129/configuration會嘗試將-{A|...}-、-{H|...}-合併至{{NoteTA}}。
其他注意事項
[编辑]- 如果標題有地區詞差異，請順道為各地區的標題建立重定向頁，因為填寫NoteTA並不會自動建立地區標題重定向。
- 若某條目掛有
{{TARequired}}，表示需要加入本模板{{NoteTA}}。詳見需要NoteTA模板的頁面。 - 如果要在模板内使用本模板，请将本模板用
<noinclude>……</noinclude>包圍，避免与包含其的页面的NoteTA模板产生冲突（特点为条目标题栏仍有一个（条目本身没有使用NoteTA）或者不止一个（条目本身有使用NoteTA）NoteTA的标志）。另外noinclude组合与其后的模板源码之间不要有空格或換行，否则会在嵌入模板的页面插入空行。
模板数据
[编辑]本模板用来在一个页面裡，转换不同地区的翻译用语或指定特定的标题。
| 参数 | 描述 | 类型 | 状态 | |
|---|---|---|---|---|
| T | T | 标题的转换规则
| 字符串 | 可选 |
| dt | dt | 标题转换用词描述
| 字符串 | 可选 |
| G1 | G1 | 第1项公共转换组
| 字符串 | 可选 |
| G2 | G2 | 第2项公共转换组 | 字符串 | 可选 |
| G3 | G3 | 第3项公共转换组 | 字符串 | 可选 |
| G4 | G4 | 第4项公共转换组 | 字符串 | 可选 |
| G5 | G5 | 第5项公共转换组 | 字符串 | 可选 |
| G6 | G6 | 第6项公共转换组 | 字符串 | 可选 |
| G7 | G7 | 第7项公共转换组 | 字符串 | 可选 |
| G8 | G8 | 第8项公共转换组 | 字符串 | 可选 |
| G9 | G9 | 第9项公共转换组 | 字符串 | 可选 |
| G10 | G10 | 第10项公共转换组 | 字符串 | 可选 |
| 1 | 1 | 第1条转换用词
| 字符串 | 可选 |
| d1 | d1 | 第1条转换用词描述
| 字符串 | 可选 |
| 2 | 2 | 第2条转换用词 | 字符串 | 可选 |
| d2 | d2 | 第2条转换用词描述 | 字符串 | 可选 |
| 3 | 3 | 第3条转换用词 | 字符串 | 可选 |
| d3 | d3 | 第3条转换用词描述 | 字符串 | 可选 |
| 4 | 4 | 第4条转换用词 | 字符串 | 可选 |
| d4 | d4 | 第4条转换用词描述 | 字符串 | 可选 |
| 5 | 5 | 第5条转换用词 | 字符串 | 可选 |
| d5 | d5 | 第5条转换用词描述 | 字符串 | 可选 |
| 6 | 6 | 第6条转换用词 | 字符串 | 可选 |
| d6 | d6 | 第6条转换用词描述 | 字符串 | 可选 |
| 7 | 7 | 第7条转换用词 | 字符串 | 可选 |
| d7 | d7 | 第7条转换用词描述 | 字符串 | 可选 |
| 8 | 8 | 第8条转换用词 | 字符串 | 可选 |
| d8 | d8 | 第8条转换用词描述 | 字符串 | 可选 |
| 9 | 9 | 第9条转换用词 | 字符串 | 可选 |
| d9 | d9 | 第9条转换用词描述 | 字符串 | 可选 |
| 10 | 10 | 第10条转换用词 | 字符串 | 可选 |
| d10 | d10 | 第10条转换用词描述 | 字符串 | 可选 |