萌娘百科自带的帮助看得让人眼花,因此我把自己暂时要学的放在这里。
“ | 解析器函数是由一个MediaWiki扩展zhwp:mw:Extension:ParserFunctions提供,包含多个解析函数解释器。本扩展的典型语法是:
目前有预定义的函数:expr,if,ifeq,ifexpr,switch(rand暂时被废除)。 各函数名都对大小写不敏感。 语句中的空格、换行等空白字符将被省略。 |
” |
——zhwp:Help:解析器函数 |
expr函数,计算数学表达式。语法为:
{{#expr: ''表达式'' }}
表达式支持的运算符有:
运算符 | 名称 | 优先级 | 元数 | 结合性 | 样例 |
---|---|---|---|---|---|
+ | 正 | 9 | 1 | 右 | {{#expr: + 7}} = 7 |
- | 负 | 9 | 1 | 右 | {{#expr: - 7}} = -7 |
not | 逻辑非 | 9 | 1 | 右 | {{#expr: not 7}} = 0 |
* | 乘 | 8 | 2 | 左 | {{#expr: 30 * 7}} = 210 |
/ | 除 | 8 | 2 | 左 | {{#expr: 30 / 7}} = 4.2857142857143 |
div | 除 | 8 | 2 | 左 | {{#expr: 30 div 7}} = 4.2857142857143 |
mod | 模 | 8 | 2 | 左 | {{#expr: 30 mod 7}} = 2 |
+ | 加 | 6 | 2 | 左 | {{#expr: 30 + 7}} = 37 |
- | 减 | 6 | 2 | 左 | {{#expr: 30 - 7}} = 23 |
round | 舍入(最大9) | 5 | 2 | 左 | {{#expr: 30 / 7 round 7}} = 4.2857143 |
= | 等于 | 4 | 2 | 左 | {{#expr: 30 = 7}} = 0 |
< | 小于 | 4 | 2 | 左 | {{#expr: 30 < 7}} = 0 |
> | 大于 | 4 | 2 | 左 | {{#expr: 30 > 7}} = 1 |
<= | 小于等于 | 4 | 2 | 左 | {{#expr: 30 <= 7}} = 0 |
>= | 大于等于 | 4 | 2 | 左 | {{#expr: 30 >= 7}} = 1 |
<> | 不等于 | 4 | 2 | 左 | {{#expr: 30 <> 7}} = 1 |
!= | 不等于 | 4 | 2 | 左 | {{#expr: 30 != 7}} = 1 |
and | 逻辑与 | 3 | 2 | 左 | {{#expr: 30 and 7}} = 1 |
or | 逻辑或 | 2 | 2 | 左 | {{#expr: 30 or 7}} = 1 |
round运算对运算数正负,位数正负都有不同的表现,参见下例。
逻辑运算符把假映射为0,把真映射为非0,且返回值只有0或1。
同一表达式中先计算高优先级运算。括号优先级高于一切。
if函数是一个if-then-else(如果-那么-否则)结构,和Excel的if函数类似。语法是:
{{#if: <判断字符串> | <那么字符串> | <否则字符串> }} {{#if: <判断字符串> | <那么字符串> |}}
若判断字符串为非空字符串(忽略前导或后缀空格),则函数返回那么字符串;若判断字符串不是非空,则返回否则字符串。否则字符可被省略而不会造成错误,但函数在判断字符串为空时便会返回空字符串。
ifeq比较两个字符串,返回比较结果。语法为:
{{#ifeq: <字符串1> | <字符串2> | <相等时返回的字符串> | <不相等时返回的字符串> }}
注意:两个空字符串是相等的。
示例:
假设模板Ifeq test的内容是
{{#ifeq:{{{lang}}}|zh|我使用中文|I don't use Chinese}}
则{{Ifeq test|lang=zh}}的结果是我使用中文;而{{Ifeq test|lang=en|I prefer English}}的结果是I don't use Chinese。
ifexist根据指定名称的页面是否存在,返回两个参数中的一个。用法:
{{#ifexist: <待測頁面標題> | <存在文字> | <不存在文字> }}
注意不能跨维基使用
示例:
首先,我们已经知道test页面不存在,User:Sex不存在,维基百科页面存在,英文维基百科的页面en:Minecraft存在,维基词典里面wikt:fuck存在。
ifexpr计算数学表达式,并根据计算结果返回字符串。
{{ #ifexpr: <表达式> | <表达式不为0的结果> | <表达式为0的结果> }}
表达式语法与expr相同。
switch将一个值与多个预设值比较,若有匹配时则返回指定字符串,即双射。语法是:
{{ #switch: <比较值> | <预设值1> = <结果1> | <预设值2> = <结果2> | ... | <预设值n> = <结果n> | #default = <缺省结果> }}
switch将从左往右逐一尝试,直到出现匹配。函数将返回第一个匹配值对应的结果,而忽略后面的匹配值。如果没有匹配,函数将返回缺省结果。缺省结果是指的#default=后面的内容。其中#default=在结果不包含等号时是可以省略的。如果缺省结果没有设置,函数将返回空串。
注意:“缺省结果”是最后一个没有等号的预设值或“#default”预设值对应的结果;如果期望把一个包含“=”号的字符串作为缺省结果,则必须采用“#default”预设值形式。例如:
#default = <span style="color:red;">red</span>
switch也可用作满射(多对一,避免重复设置结果)。即某预设值后未设置结果,这样如果该预设值与比较值匹配,则函数返回第一个有结果的预设值的结果。例如:
{{ #switch: <比较值> | <预设值1> | <预设值2> | <预设值3> = <结果3> | <缺省结果> }}
如果比较值与预设值1、预设值2或预设值3匹配,都将返回结果3。注意:“#default”后必须有“=”,但其他预设值可以使用“#default”的结果。
time是一个时间日期格式化函数,它的语法为:
{{ #time: 格式参数 }}
或者
{{ #time: 格式参数 | 时间参数 }}
如果时间参数未指定,则使用该条目被转换为HTML的时间(值)。注意到由于缓存的缘故,这与条目被浏览的时间可能会有高达1星期的偏差。因此可能需要手工更新,方法是加上action=purge参数访问页面。
格式参数是一种格式字符,与在PHP的date中的用法相似。
下列格式代码与在PHP中的意义一样。所不同的是...
如果时间未被指定,则显示文章最后一次被转换成HTML的时间。由于缓存的关系,此时间和你浏览文章的时间可能有最长一个星期的差别。所以有时可能需要人工更新数据,方法是编辑文章但不做任何修改即保存。
参数format是表示格式的字符串,类似于PHP的时间格式.
以下格式代码和PHP中date()函数意义相同。除了国际化(主要是语言)造成的差别以外,所有和PHP的不同点都应当作为软件的错误进行报告。其中所有的数字输出都会被替换成当地语言的时间格式,可以使用xn(见下文)恢复成显示原来的数字。
代码 | 描述 | 输出 |
---|---|---|
d | 一个月中的第 n 天,不足两位补充0 | 22 |
D | 星期的缩写,通常不国际化 | 五 |
j | 一个月中的第 n 天,不足两位不补0 | 22 |
l | 星期的全称,通常不国际化 | 星期五 |
F | 月份的的全称,通常需要国际化 | 11月 |
m | 数字表示的月份,不足两位补充0 | 11 |
M | 月份的的缩写,通常需要国际化 | 11月 |
n | 数字表示的月份,不足两位不补0 | 11 |
Y | 四位年份 | 2024 |
y | 二位年份 | 24 |
H | 小时,不足两位补充0 | 13 |
i | 分钟,不足两位补充0 | 15 |
s | 秒,不足两位补充0 | 30 |
以下代码是对PHP作出的扩展:
代码 | 描述 |
---|---|
xn | 将接下来的数字代码恢复成ASCII中的阿拉伯数字例如,在印地语中,{{ #time:H, xnH}}输出०६, 06。 |
xr | 将接下来的数字代码显示成罗马数字 |
xg | 输出月份名字的属格,只针对那些区分主格和属格的语言。 |
xx | 输出"x" |
任何其他字符都将不做处理直接输出。你也可以用引号来输出未经处理的字符串。
{{; #time: "现在是" F}}
→ 现在是 11月{{ #time:i's"}}
→ 15'30"未来可能会增加更多格式代码,可能是完善PHP中已有功能,也可能是增加新功能。
参数time的格式参照PHP的strtotime()函数。它同时支持相对时间,如"+10 hours",用来表示时区转换。更多信息参见the GNU tar manual。
下表以国际协调时间(UTC)2024年11月22日(星期五)13时15分30秒(北京时间2024年11月22日(星期五)21时15分31秒)为例说明各格式参数的作用。
格式参数 | 说明 | 显示结果 |
---|---|---|
A | 显示AM或PM | PM |
a | 显示am或pm | pm |
c | 显示长日期 | 2024-11-22T13:15:30+00:00 |
D | 星期数,以一个汉字显示 | 五 |
d | 日期日数,有0补齐, | 22 |
F或M | 月份 | 11月 |
G或g | 当前UTC时间小时数,1位或2位数字 | 13 |
H或h | 小时数,2位数字 | 13 |
i | 分钟数,2位数字 | 15 |
j | 日数,2位数字 | 22 |
L | 日期星期数,1位数字,星期日为1,星期六为7 | 1 |
l | 日期星期数,3位汉字 | 星期五 |
m | 月份数,2位数字 | 11 |
N | 星期数,星期一为1,星期日为7 | 5 |
n | 月份数,1位或2位数字 | 11 |
r | 英文长日期格式 | Fri, 22 Nov 2024 13:15:30 +0000 |
s | 秒数 | 30 |
t | 该月天数 | 30 |
U |
|
1732281330 |
W | 日期周数,显示日期为当年第几周 | 47 |
w | 星期数,星期日为0,星期六为6 | 5 |
Y | 日期年份,4位数字 | 2024 |
y | 日期年份,2位数字 | 24 |
z | 显示日期为当年第几日 | 326 |
系统默认的时间参数为当前UTC+0时间,可以使用{{#time:参数|+8 hours}}
得到当前北京时间(UTC+8时间)。
时间参数可以使用绝对时间,如“2008-12-31 23:59:59
”,也可以使用相对时间,如“+7 days
”或者“-5 hours
”得到默认时间7日之后或默认时间5小时之前的时间。也可以二者混合使用,比如{{#time:Y-m-d H:i:s|2001-2-3 04:05:06 +1 year +2 months +3 days +4 hours +5 minutes +6 seconds}}
返回
2002-04-06 08:10:12
使用xr
可以在其后显示罗马数字,如{{#time:xrY年xrm月xrd日|2008-12-31}}
显示为MMVIII年XII月XXXI日。
invoke vt. 调用
(调用位于Scribunto中的模块;见维基百科:Lua)什么鬼啊!!!
{{#invoke: module | function | arg1 | arg2 | ... }}
Eg.1
{{#invoke: Math | random | 1 | 10 }}
→
1
Eg.2
{{#invoke: Math | random | 1 | 10 }}
→
6
Eg.3
{{#invoke: Math | random | 1 | 10 }}
→
5
备注1:min value&max value的值可以填写字母和unicode,但还没有搞清楚是怎么转换的。大概是编码之类的
备注2:维基百科的模板:zhwp:分类:基于Lua编程语言的模板,那么萌娘百科有哪些模板?
这是一个“变量”的列表,变量可被用于维基语法。变量的返回值可以根据时间、维基项目、引用页面而变化。
以下的列表中,变量都在左边,右边是它的在此时、此项目、此页面返回值。
变量名是一组所谓的“魔术字”的一部分。
{{ns:-2}} {{ns:Media}}
|
Media Media |
{{ns:-1}} {{ns:Special}}
|
Special Special |
{{ns:0}} (主名字空间)
|
(空字符串) |
{{ns:1}} {{ns:Talk}}
|
Talk Talk |
{{ns:2}} {{ns:User}}
|
User User |
{{ns:3}} {{ns:User_talk}}
|
User talk User talk |
{{ns:4}} {{ns:Project}}
|
萌娘百科 萌娘百科 |
{{ns:5}} {{ns:Project_talk}}
|
萌娘百科 talk 萌娘百科 talk |
{{ns:6}} {{ns:Image}}
|
File File |
{{ns:7}} {{ns:Image_talk}}
|
File talk File talk |
{{ns:8}} {{ns:MediaWiki}}
|
MediaWiki MediaWiki |
{{ns:9}} {{ns:MediaWiki_talk}}
|
MediaWiki talk MediaWiki talk |
{{ns:10}} {{ns:Template}}
|
Template Template |
{{ns:11}} {{ns:Template_talk}}
|
Template talk Template talk |
{{ns:12}} {{ns:Help}}
|
Help Help |
{{ns:13}} {{ns:Help_talk}}
|
Help talk Help talk |
{{ns:14}} {{ns:Category}}
|
Category Category |
{{ns:15}} {{ns:Category_talk}}
|
Category talk Category talk |
{{SITENAME}}
|
萌娘百科 |
{{SERVER}}
|
https://zh.moegirl.org.cn |
{{SERVERNAME}}
|
zh.moegirl.org.cn |
{{localurl:页面完整名}}
|
/%E9%A1%B5%E9%9D%A2%E5%AE%8C%E6%95%B4%E5%90%8D |
{{localurl:a&b!}}
|
/A%26b! /A%26b! |
{{localurl:页面|query=x}}
|
/index.php?title=Page&query=x |
{{fullurl:页面完整名}}
|
https://zh.moegirl.org.cn/%E9%A1%B5%E9%9D%A2%E5%AE%8C%E6%95%B4%E5%90%8D |
{{fullurl:a&b!}}
|
https://zh.moegirl.org.cn/A%26b! https://zh.moegirl.org.cn/A%26b! |
伪模板localurl将空格替换为下划线,对特殊字符进行编码。比如{{localurl:a !}}得到/A_!。
注意到localurl不会将“|”后的“查询”字符串编码。这个问题可以借把查询字符串移至左边解决。比如,Special:Contributions和Special:Recentchangeslinked数据可以在“/”后出现:
{{fullurl:Special:Contributions/墨埜谷|limit=10}}
得到:{{fullurl:Special:Contributions|target=墨埜谷&limit=10}}
会得到不正确的结果:localurle及其副本fullurle可以执行更多字符编码,但只用于Mediawiki内部,而其存在是为了保证向前兼容性。
伪模板{{fullurl}}
是一个新近添加的{{SERVER}}{{localurl}}
的缩略。
{{CURRENTYEAR}} |
2024 | {{CURRENTMONTH}} |
11 |
{{CURRENTMONTHNAME}} |
11月 | {{CURRENTMONTHABBREV}} |
11月 |
{{CURRENTMONTHNAMEGEN}} |
十一月 | {{CURRENTWEEK}} |
47 |
{{CURRENTDAY}} |
22 | {{CURRENTDAY2}} |
22 |
{{CURRENTDAYNAME}} |
星期五 | {{CURRENTDOW}} |
5 |
{{CURRENTTIME}} |
13:15 | {{REVISIONID}} |
6250719 |
{{NUMBEROFARTICLES}} |
138,039 | ||
{{NUMBEROFFILES}} |
0 | ||
{{NUMBEROFUSERS}} |
1,095,987 |
NUMBEROFARTICLES:在主名字空间内的包含至少一个链接且不是重定向的页面,包括小作品及消歧义页面。
返回结果也与系统变量$wgUseCommaCount有关。如果该变量为真,条目统计将仅依据文章是否包含逗号(“,”)来统计,否则就会只统计有内部链接(“[[”)的条目。在DefaultSettings.php的默认设置为假。
时间变量并非随页面的每一次被打开而变化。由于条目的HTML文本有缓存机制,因此时间变量有可能误差达24小时,所以它们并不是可信的。
{{PAGENAME}} |
墨埜谷/储藏室 | {{NAMESPACE}} |
User |
{{PAGENAMEE}} |
%E5%A2%A8%E5%9F%9C%E8%B0%B7/%E5%82%A8%E8%97%8F%E5%AE%A4 | {{NAMESPACEE}} |
User |
{{FULLPAGENAME}} |
User:墨埜谷/储藏室 | {{SUBPAGENAME}} |
储藏室 |
{{FULLPAGENAMEE}} |
User:%E5%A2%A8%E5%9F%9C%E8%B0%B7/%E5%82%A8%E8%97%8F%E5%AE%A4 | {{SUBPAGENAMEE}} |
%E5%82%A8%E8%97%8F%E5%AE%A4 |
{{TALKSPACE}} |
User talk | {{SUBJECTSPACE}} |
User |
{{TALKSPACEE}} |
User_talk | {{SUBJECTSPACEE}} |
User |
{{TALKPAGENAME}} |
User talk:墨埜谷/储藏室 | {{SUBJECTPAGENAME}} |
User:墨埜谷/储藏室 |
{{TALKPAGENAMEE}} |
User_talk:%E5%A2%A8%E5%9F%9C%E8%B0%B7/%E5%82%A8%E8%97%8F%E5%AE%A4 | {{SUBJECTPAGENAMEE}} |
User:%E5%A2%A8%E5%9F%9C%E8%B0%B7/%E5%82%A8%E8%97%8F%E5%AE%A4 |
{{ARTICLESPACE}} |
User | {{ARTICLEPAGENAME}} |
User:墨埜谷/储藏室 |
{{ARTICLESPACEE}} |
User | {{ARTICLEPAGENAMEE}} |
User:%E5%A2%A8%E5%9F%9C%E8%B0%B7/%E5%82%A8%E8%97%8F%E5%AE%A4 |
在主名字空间(条目的名字空间){{NAMESPACE}}和{{NAMESPACEE}}都返回空字符串。
PAGENAMEE显示经编码的页面标题,即空格变为下划线,特殊字符编码,所以可用来组成URL。例如,某页面叫"Grand café",PAGENAMEE会返回"Grand_caf%C3%A9"。不要在localurl系列变量的第一部分使用此变量,都则会造成结果的紊乱。
当被用于模板中时,这些变量返回的都是引用模板的页面相应值,而不是被引用模板的相应值。
{{REVISIONID}}
得到6250719
REVISIONID返回一个特殊的值,以显示当前页面的当前版本在所有页面的所有版本中的编号。在URL中可以采用添加“&oldid=123456”的方法引用此页面的该版本,无论是否为最新版本。这在讨论页、文章引用都十分有用。
{{REVISIONTIMESTAMP}}
得到20220808044330,即最后一次编辑的时间戳(TIMESTAMP)。
{{fullurl:{{FULLPAGENAME}}|action=edit}}
{{fullurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGENAME}}}}
{{fullurl:{{NAMESPACE}}:{{PAGENAME}}|action=edit}}
{{fullurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGENAME}}}}
[[{{NAMESPACE}}:{{PAGENAME}}_1]]
{{fullurl:{{NAMESPACE}}:{{PAGENAME}}_1}}
{{fullurl:{{NAMESPACE}}:{{PAGENAME}}|oldid={{REVISIONID}}}}
{{SERVER}}{{localurl:
页面 }}
与{{fullurl:
页面 }}
等效,不过后者在Mediawiki(1.5以上)版本中才可用。
最后一个样例对页面本身用处不大,但可作为一种“永久链接”在复制件中发挥功用。
2024
11月 22
21:15