模组: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:本模组的转换表