模组:Utilities/doc
这是Module:Utilities的文档页面
该模块导出各种通用功能,可供其他模块使用。
pattern_escape
编辑pattern_escape(text)
跳脱匹配模式(Lua的正则表达式版本)中使用的魔法字符。比如,"^$()%.[]*+-?"
变成 "<strong class="error"><span class="scribunto-error mw-scribunto-error-0e5118e6">脚本错误:函数“pattern_escape”不存在。</span></strong>"
。
format_categories
编辑format_categories(categories, lang, sort_key, sort_base, force_output)
形成一个分类名称的列表(表格)。输出是一个由所有类别组成的字符串,每个类别都使用了[[Category:...]]
,并添加了给定的排序键。如果命名空间不是主命名空间、附录命名空间或重构命名空间,输出将是一个空字符串,除非给出force_output
。如果没有给定排序键:
- 默认的排序键是通过使用
sort_base
(如果有给定的话)或当前的子页面名称,以及去除开头的连字符(以便后缀可以在没有键的情况下进行排序)而生成的。 - 如果给定的语言有排序键,则其将会被用来创建一个遵循该语言规则的排序键。
template_categorize
编辑{{#invoke:utilities|template_categorize}}
这个函数使用于 {{categorize}}
、{{catlangname}}
和 {{catlangcode}}
等模板。
catfix
编辑这个函数添加了一个“catfix”,它被用于特定语言的分类页面,为所有条目名称添加语言属性,通常是文字类(script classes)。语言属性和文字类的添加使条目名称显示得更好(使用MediaWiki:Common.css中指定的特定语言或脚本样式),这对于在浏览器中没有一致字体支持的非英语语言尤其重要。
语言属性是为所有语言添加的,但脚本类只为在其数据文件中列出文字的语言添加,或者为在Module:utilities/data的catfix_script
列表中列出一个默认脚本的语言添加。有些语言显然有一个默认文字,但在他们的数据文件中仍有其他文字,因此需要指定他们的默认文字。其他语言则没有默认文字。
- 塞尔维亚-克罗地亚语经常以拉丁字母和西里尔字母两种文字书写。因为使用两种文字,所以塞尔维亚-克罗地亚语不能在其分类页面的条目中使用文字类别,因为一次只能指定一种文字类别。
- 俄语通常用西里尔文字(
Cyrl
)书写,但盲文(Brai
)也列于其数据文件中。因此,俄语需要在catfix_script
列表中加入一个条目,这样Cyrl
(西里尔字母)文字类就会被应用于其分类页面中的条目。
要查看一种语言所列出的文字,请见Module:languages,并使用搜索框找到该语言的数据文件。要想知道一个文字代码的含义,请在Module:scripts/data中搜索该文字代码。