模組:ZhConversion/doc
外觀
此頁面為 Module:ZhConversion 的說明文件
此頁面是Module:ZhConversion的模組文件。 此頁面可能包含了模板的使用說明、分類和其他內容。 |
此模組文件被引用於約36,000個頁面。 為了避免造成大規模的影響,所有對此模組文件的編輯應先於沙盒或測試樣例上測試。 測試後無誤的版本可以一次性地加入此模組文件中,但是修改前請務必於討論頁發起討論。 模板引用數量會自動更新。 |
本模組可以在Lua階段實現文字的繁簡轉換,但不支援地區詞轉換和轉換組。(ZhConversion.php的Lua實現)
原始文字 本文为测试文字。这段文字用于说明格式,请勿删除。这段文字用于说明格式,请勿删除。海纳百川,有容乃大。维基百科,自由的百科全书。
- 輸入到to_hant()函數變為(轉為繁體):
本文為測試文字。這段文字用於說明格式,請勿刪除。這段文字用於說明格式,請勿刪除。海納百川,有容乃大。維基百科,自由的百科全書。
原始文字 本文為測試文字。這段文字用於說明格式,請勿刪除。這段文字用於說明格式,請勿刪除。海納百川,有容乃大。維基百科,自由的百科全書。
- 輸入到to_hans()函數變為(轉為簡體):
本文为测试文字。这段文字用于说明格式,请勿删除。这段文字用于说明格式,请勿删除。海纳百川,有容乃大。维基百科,自由的百科全书。
原始文字繁體简体
(繁簡混用)
- 輸入到to_hant()函數變為(轉為繁體):
繁體簡體
原始文字繁體简体
(繁簡混用)
- 輸入到to_hans()函數變為(轉為簡體):
繁体简体
用途
[編輯]標題轉換
[編輯]在魔術字和Lua的場合中,頁面標題的繁簡差異是無法被識別的,例如{{PAGESIZE:}}
。以光泽 (矿物)為例,頁面光泽 (矿物)存在而頁面光澤 (礦物)不存在由系統自動轉換標題差異,這時:
{{PAGESIZE:光泽 (矿物)}}
→「9,900」{{PAGESIZE:光澤 (礦物)}}
→「0」
對於輸入的標題同時,-{}-和<langconvert></langconvert>等轉換語法在模板及模組階段是不工作的:
<langconvert from="zh-hans" to="zh-hant">光泽 (矿物)</langconvert>
→「光澤 (礦物)」{{PAGESIZE:<langconvert from="zh-hans" to="zh-hant">光泽 (矿物)</langconvert>}}
→「0」
<langconvert from="zh-hant" to="zh-hans">光澤 (礦物)</langconvert>
→「光泽 (矿物)」{{PAGESIZE:<langconvert from="zh-hant" to="zh-hans">光澤 (礦物)</langconvert>}}
→「0」
這意味着,如果存在的頁面是光泽 (矿物),輸入光澤 (礦物)到模板或模組中有關功能是會失效的。
所以如果輸入的值是光澤 (礦物)就有在Lua運算階段需使用繁簡轉換的需求。
{{PAGESIZE:{{#invoke:ZhConversion|zh_title|光泽 (矿物)}}}}
→「9,900」{{PAGESIZE:{{#invoke:ZhConversion|zh_title|光澤 (礦物)}}}}
→「9,900」
函數說明
[編輯]- to_hant(字串)
- 輸入一個字串,轉換為繁體中文(可模板調用)
- to_hans(字串)
- 輸入一個字串,轉換為簡體中文(可模板調用)
- zh_convert(字串)
- 輸入一個字串,進行繁簡轉換,若輸入是簡體,轉換為繁體;若輸入是繁體,轉換為簡體;若繁簡混用,以繁體優先。(可模板調用)
- zh_title(頁面標題)
- 輸入一個頁面標題,若該頁面標題頁面不存在,但繁簡轉換後存在,則返回存在的標題。(可模板調用)
- equals(字串1,字串2)
- 忽略繁簡差異的文字比對,例如「光泽」與「光澤」視為相同。(可模板調用)
- _language_cvt(字串, 轉換表, 子字串搜尋最大長度)
- 使用指定的轉換表進行轉換。(不支援模板調用)
參見
[編輯]- Module:ZhConversion/data:本模組的轉換表