模板:CGroup/doc

模板頁面

本模塊用於實現公共轉換組(public conversion group)。公共轉換組可用於多個頁面共用同一組繁簡轉換(包括地區詞轉換)規則。本模塊的子頁面將會存放各公共轉換組的數據(及其文檔頁面),這些公共轉換組用於模板連結:{{NoteTA}}。參見Help:字詞轉換處理

公共轉換組模塊格式

公共轉換組模塊是Module:CGroup的子頁面,存儲一系列指定格式的轉換規則(見下)。模板連結:{{NoteTA}}模板用於在頁面中實現這些繁簡轉換規則。

每個公共轉換組模塊返回的值都是一個表,其存在以下字段:

  • name:該轉換組的名稱,通常與模塊名稱相同。例如Module:CGroup/IT的name就是IT。
  • description:簡要描述該轉換組。可以使用維基文本,但是不能包含模板、解析器函數和魔術字(如需使用,請直接在模塊內調用並返回值)。
  • content:該轉換組的內容。是一個列表。列表的每一項都可以是如下的任意一個格式:
    • 普通轉換規則:
    • {type='item', original='原文', rule='轉換規則'},表示一個普通的轉換規則。其中「原文」是指的該詞對應的外文名稱,轉換規則則是類似-{H|转换规则}-中的轉換規則。例如{type='item', original='user', rule='zh-cn:用戶;zh-tw:使用者'}。original的值可以為空。
    • '轉換規則',即上述寫法的簡寫形式,相當於{type='item', rule='轉換規則'},不提供original字段。
    • {'轉換規則'}{'原文', '轉換規則'},同上,是上述寫法的簡寫形式。
      文字註釋:
    • {type='text', text='一段文字'},用於在模塊文檔呈現結果中顯示一段文字,不會應用於公共轉換組。實際應用中,主要用於將不同的轉換規則歸到不同的段落標題下,從而進行分類。
      導入轉換規則:
    • {type='import', import='轉換組名稱'},導入另一個轉換組。該轉換組將包含另一個轉換組中的所有轉換規則。請謹慎使用。
    • {import='轉換組名稱'},上述寫法的簡寫形式。
      增強的普通轉換規則:
    • {type='variants', ['變體名稱']=文字, ...},類似於item,但是所有轉換規則的內容是結構化的,以便於模塊進行解析。例如,{type='variants', cn='用戶', hk='用戶', tw='使用者'}就大致相當於{type='item', rule='zh-cn:用戶;zh-hk:用戶;zh-tw:使用者'}。但這種用法暫時無法實現單向轉換。

子頁面列表