“帮助:解析器函数的使用帮助”的版本间的差异
(创建页面,内容为“{{帮助导航}} '''解析器函数'''与系统变量非常相似,但与后者相比,前者'''全部'''要求'''至少传入'''一个参数,所有的参数1与...”) |
(没有差异)
|
2017年1月18日 (三) 15:52的版本
帮助导航 |
---|
关于希灵百科 |
入门 |
创建新条目 • 编辑教程 上传图片 • 使用图片 重定向建立&修正 • 消歧义页 制作投票 |
解析器函数与系统变量非常相似,但与后者相比,前者全部要求至少传入一个参数,所有的参数1与函数名之间均用:
而不是|
分割。
解析器函数有时会在函数名前加上#
用以与模板区分。
列表
以下表格详细说明了可用的解析器函数,部分术语未作解释。
解析器函数 | 输入 → 输出 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
URL与标题的数据和解析 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{localurl:页面名称}} {{localurl:页面名称|查询字符串}}
|
{{localurl:Mainpage}} → /index.php?title=Mainpage{{localurl:Mainpage|printable=yes}} → /index.php?title=Mainpage&printable=yes
|
指定页面的相对路径 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{fullurl:页面名称}} {{fullurl:页面名称|查询字符串}} {{fullurl:跨wiki前缀:远程页面名称|查询字符串}}
|
{{fullurl:Category:帮助}} → https://wiki.lstyxl.com/index.php?title=%E5%88%86%E7%B1%BB:%E5%B8%AE%E5%8A%A9{{fullurl:Category:帮助|action=edit}} → https://wiki.lstyxl.com/index.php?title=%E5%88%86%E7%B1%BB:%E5%B8%AE%E5%8A%A9&action=edit{{fullurl:mw:MediaWiki/zh|action=edit}} → https://www.mediawiki.org/wiki/MediaWiki/zh?action=edit{{fullurl:mw:Help:Magic words|action=edit}} → https://www.mediawiki.org/wiki/Help:Magic_words?action=edit
|
指定页面的相对协议路径,该解析器函数也能识别跨wiki前缀。 注意:未被方括号包裹起来的相对协议路径不会自动生成为链接 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{canonicalurl:页面名称}} {{canonicalurl:页面名称|查询字符串}} {{canonicalurl:interwiki:远程页面名称|查询字符串}}
|
{{canonicalurl:Category:帮助}} → https://wiki.lstyxl.com/index.php?title=%E5%88%86%E7%B1%BB:%E5%B8%AE%E5%8A%A9{{canonicalurl:Category:帮助|action=edit}} → https://wiki.lstyxl.com/index.php?title=%E5%88%86%E7%B1%BB:%E5%B8%AE%E5%8A%A9&action=edit{{canonicalurl:mw:Help:Magic words|action=edit}} → https://www.mediawiki.org/wiki/Help:Magic_words?action=edit
|
指定页面的绝对协议路径,该解析器函数也能识别跨wiki前缀。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{filepath:文件名称}} {{filepath:文件名称|nowiki}} {{filepath:文件名称|缩略图大小}}
|
{{filepath:Box-1.png}} → {{filepath:Box-1.png|120}} → {{filepath:Box-1.png|nowiki}} →
|
指定文件的绝对协议路径,可以指定缩略图大小(仅能指定宽度大小,单位为px),也可以指定是否被直接渲染为图片 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{urlencode:字符串}} {{urlencode:字符串|QUERY}} 、{{urlencode:字符串|WIKI}} 、{{urlencode:字符串|PATH}}
|
{{urlencode:a/b c}} 、{{urlencode:a/b c|QUERY}} → a%2Fb+c{{urlencode:a/b c|WIKI}} → a%2Fb+c{{urlencode:a/b c|PATH}} → a%2Fb+c
|
输出指定字符串经编码后的结果。不同的参数指定不同的编码规则,用于解析页面标题到MediaWiki类站点链接时建议使用WIKI,解析字符串到文件名时建议使用PATH,解析字符串到搜索引擎链接时建议使用(空)、QUERY;如果你不清楚如何选择时,你可以到Talk:提问求助区求助 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{anchorencode:字符串}}
|
{{anchorencode:a/b c}} → {{anchorencode:a/b c}}
|
输出指定字符串经MediaWiki页内标题链接编码规则编码后的结果,可用于指定内容的标题的页内导航 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#rel2abs: 路径}} {{#rel2abs: 路径 | 基础路径}}
|
{{#rel2abs: /quok | Help:Foo/bar/baz}} → Help:Foo/bar/baz/quok{{#rel2abs: ../../../../quok | Help:Foo/bar/baz}} → 错误:无效路径深度:“Help:Foo/bar/baz/../../../../quok”(尝试访问根节点以上节点)
|
本函数用于以通用的命令行目录变换格式来变换页面路径:
对于不合法的参数1,函数并不会直接抛出错误,而是尝试剔除错误部分继续工作:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#titleparts: 要解析的标题 | 要返回的层数 | 返回部分的起始点}}
|
{{#titleparts: Talk:Foo/bar/baz/quok | 2}} → 讨论:Foo/bar{{#titleparts: Talk:Foo/bar/baz/quok | 2 | 2}} → bar/baz{{#titleparts: Talk:Foo/bar/baz/quok | -2}} → 讨论:Foo/bar{{#titleparts: Talk:Foo/bar/baz/quok | -1 | -2}} → baz
|
该函数用于输出给定标题的一部分:
注意:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
名字空间 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
名字空间解析器函数{{ns:}} 返回标准名字空间的本地化名称(我们使用标准名称作为本地化名称)或自定义名字空间的名称,参数1可以指定名字空间的ID,标准名字空间的MediaWiki标准名称、本地(语言变种)化名,自定义名字空间的名称:
需要注意的是:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
格式化函数 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{formatnum:未格式化的数字}} {{formatnum:已格式化的数字|R}} {{formatnum:未格式化的数字|NOSEP}}
|
简单例子:
高级例子:
错误的输入会导致无法预测的输出,不论是否有参数2
|
参数1接受任何阿拉伯数字,按照站点默认区域数字格式用分位符号分组,将其本地化后输出。
参数2有两个可接受字符串:
注意:
如果你真的需要输入一个无法保证格式正确的数字的话,你可以使用 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#dateformat:日期}} {{#formatdate:日期}} {{#dateformat:日期|格式规则}} {{#formatdate:日期|格式规则}}
|
{{#dateformat:25 dec 2009}} → 25 dec 2009{{#formatdate:dec 25,2009|dmy}} → dec 25,2009{{#dateformat:2009-12-25|mdy}} → 12月 25, 2009{{#formatdate:2009 dec 25|ISO 8601}} → 2009 dec 25
|
参数1接受一个未格式化的日期,按照设置#显示里的“日期格式”设置将其格式化。对于未登陆的读者和未设置日期格式的用户,可以通过参数2指定格式:mdy 、dmy 、ymd (输出的字母全小写)。如果参数1只给出月日,那么只有mdy 和dmy 才是有效的格式。如果未指定格式或者格式无效,那么参数1的格式将被指定为输出格式。如果参数1的日期格式无效,那么函数输出参数1的原样。
警告:即使ISO 8601格式要求参数1的日期是公历日期,若参数2指定ISO 8601,函数也能对那些超出通常公历范围的日期进行格式化。同样,函数无法正确转换ISO 9601格式负数年份和公园前的年份。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{lc:字符串}}
|
{{lc:DATA CENTER}} → data center
|
将字符串完全小写化 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{lcfirst:字符串}}
|
{{lcfirst:DATA center}} → dATA center
|
将字符串首字母小写化 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{uc:字符串}}
|
{{uc:text transform}} → TEXT TRANSFORM
|
将字符串完全大写化 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{ucfirst:字符串}}
|
{{ucfirst:text TRANSFORM}} → Text TRANSFORM
|
将字符串首字母大写化 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{padleft:原字符串|补足后的字符串长度}} {{padleft:原字符串|补足后的字符串长度|补足用的字符串}}
|
{{padleft:xyz|5}} → 00xyz{{padleft:xyz|5|_}} → __xyz{{padleft:xyz|5|abc}} → abxyz{{padleft:xyz|7|abc}} → abcaxyz{{padleft:xyz|2}} → xyz{{padleft:|4|xyz}} → xyzx
|
将参数1通过在左侧补上参数3指定的字符串(默认为0)补足到参数2指定的长度,参数3指定的字符串可能被截断以保证补足后的字符串长度满足要求 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{padright:原字符串|补足后的字符串长度}} {{padright:原字符串|补足后的字符串长度|补足用的字符串}}
|
{{padright:xyz|5}} → xyz00{{padright:xyz|5|_}} → xyz__{{padright:xyz|5|abc}} → xyzab{{padright:xyz|7|abc}} → xyzabca{{padright:xyz|2}} → xyz{{padright:|4|xyz}} → xyzx
|
与{{padleft:}} 近乎一样,只是在右边补足
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
本地化函数 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{plural:数字|单数形式|复数形式}}
|
{{plural:0|is|are}} → are{{plural:1*1|is|are}} → is{{plural:21 mod 10|is|are}} → are{{plural:{{#expr:21 mod 10}}|is|are}} → is
|
根据参数1是单数还是复数,输出不同的字符串:单数输出参数2,复数输出参数3。判断是否单复数的标准是{{#switch: 1 | {{{1}}} | {{#expr: {{{1}}} }} = true | #defualt = false}} 。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{gender:指定用户名|男性时的文本|女性时的文本|未选择性别时的文本}} {{gender:|男性时的文本|女性时的文本|未选择性别时的文本}} {{gender:.|男性时的文本|女性时的文本|未选择性别时的文本}}
|
(根据指定用户的设置而定) | 根据指定的用户的设置#用户资料的“语言”设置中的性别部分,返回该性别对应的文本。
注意:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{int:信息名称}}
|
{{int:edit}} → 编辑{{int:editsectionhint|MediaWiki}} → 编辑小节:MediaWiki
|
返回指定信息的界面语言变种翻译。可以在MediaWiki:信息标准名(en-US)/界面语言变种 里找到,亦可以修改。
对于部分信息,可以提供参数给它们,它们可以通过$1、$2……获取这些参数,在第二个例子里,MediaWiki替换了$1。 这种用法相较于 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
特殊嵌入 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{:(主)名字空间页面名}}
|
(主名字空间页面) | 通过: 将名字空间强制指定为(主),从而嵌入(主)名字空间的页面
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{msg:与某一魔术字重名的模板名}} {{raw:与某一魔术字重名的模板名}}
|
(模板正常渲染内容) | 与{{Tempate:与某一魔术字重名的模板名}} 一样可以避免魔术字与模板名冲突,而直接嵌入模板
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{msgnw:模板名}}
|
{{msgnw:tl}} → {{{{#ifexist:Template:{{{1}}}|{{#if:{{{3|}}}|{{{3|}}}:|}}[[Template:{{{1}}}|{{{1}}}]]{{#if:{{{2|{{{arg|}}}}}}|{{!}}{{{2|{{{arg}}}}}}}}|[[{{{1}}}|{{{1}}}]]{{#if:{{{2|{{{arg|}}}}}}|{{!}}{{{2|{{{arg}}}}}}}}}}}}<noinclude>
{{Documentation}} <!-- 請在將分类與跨語言連結增加在 /doc 子页面 --> [[Category:内部链接模板]] </noinclude> |
把模板的源码以纯文本形式输出,自带nowiki效果 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{subst:模板名}}
|
(模板的正常渲染内容,而模板源码在替换完参数,删去<noinclude/> 内容后嵌入到页面源码中)
|
把模板的源码嵌入到页面源码中,参见Help:模板#subst | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
运算与逻辑判断 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#expr: 数学表达式 }}
|
{{#expr: 1 and -1 }} → 1
|
本函数计算并返回数学表达式的结果,你可以使用+、-、*、/ 来进行计算。本函数将e (自然对数的底数)、pi (π)作为常数使用。本函数支持的运算符如下所示:
注意:
当表达式有误时函数会返回一个错误信息,此时无法再继续计算,请注意。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#if: X | A | B }}
|
{{#if: X | A | B }} → A{{#if: | A | B }} → B{{#if: | A }} →
|
该函数用于条件逻辑判断:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#ifeq: X | Y | A | B }}
|
{{#ifeq: 1 | 0 | A | B }} → B{{#ifeq: 1 | 1 | A | B }} → A
|
该函数用于条件逻辑判断:
注: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#ifexist: 《页面标题》 | A | B }}
|
{{#ifexist: Main Page | A | B }} → B{{#ifexist: 肯定不存在的标题 | A | B }} → B}{{#ifexist: 肯定不存在的标题 | A }} →
|
该函数用于条件逻辑判断:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#ifexpr: Fx(表达式) | A | B }}
|
{{#ifexpr: 1+1 | A | B }} → A{{#ifexpr: 1-1 | A | B }} → B{{#ifexpr: 1-1 | A }} →
|
该函数用于条件逻辑判断:
注: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#switch: X | Y = A | #default = B}}
|
{{#switch: 1 | 0 = A | 1 = B | #default = C }} → B |
该函数用于条件逻辑判断:
注意:
当一个参数没有带有
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#time: 格式参数 }} {{#time: 格式参数 | 时间参数 }}
|
{{#time: Y/m/d}} → 2024/11/27{{#time: Y/m/d|2017-01-04}} → 2017/01/04{{#time: Y/m/d H:i:s|+1 second}} → 2024/11/27 23:24:16
|
该函数用来输出时间:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
杂项 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#language:语言代码}} {{#language:语言代码|目标语言代码}}
|
{{#language:zh-cn}} → 中文(中国大陆){{#language:zh-cn|en-us}} → 中文(中国大陆)
|
以参数2的语言代码指定的语言(没有则以参数1的)输出参数1的语言代码对应的语言全名 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#special:特殊页面名}}
|
{{#special:watchlist}} → 特殊:监视列表
|
输出指定标准名称的特殊页面的本地化名。
可以在函数名后加e以输出经MediaWiki URL编码规则编码后的页面名:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#tag:标签名称|内容|属性1=属性值1|属性2=属性值2|……}}
|
{{#tag:div|右浮动|style="float: right; clear: both; padding: 1em;"}} → 右浮动
|
输出一个元素的HTML源码,参数1为其标签名,参数2为其内容,参数3及之后为其属性值对。
内容中的wikitext会在tag函数渲染之前完成渲染,并与往常一样阻止不受信任的代码渲染。如果内容需要为空,则参数2必须为空,而不是省略。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#invoke:模块名|函数名|参数1|参数2|……}}
|
(根据指定模块输出) | Lua模块的调用方法 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{DISPLAYTITLE:标题}} {{DISPLAYTITLE:标题|noerror}} {{DISPLAYTITLE:标题|noreplace}}
|
- | 本函数用以改变当前页面的标题的格式做出变换,该函数无法做出修改标题的行为,只能做出例如改变大小写、下划线替代空格等的修改。
参数1为“noerror”或“noreplace”时,会阻止由于使用多个该函数而导致的错误抛出。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{DEFAULTSORT:分类索引}} {{DEFAULTSORTKEY:分类索引}} {{DEFAULTCATEGORYSORT:分类索引}} {{DEFAULTSORT:分类索引|noerror}} {{DEFAULTSORT:分类索引|noreplace}}
|
- | 本函数用以改变当前页面在分类中的索引,比如{{DEFAULTSORT:A}} 会把页面分到A部分下。
参数1为“noerror”或“noreplace”时,会阻止由于使用多个该函数而导致的错误抛出。 |