帮助:编辑教程

   ⚠️ 页面正在编辑中

此页面目前正在被 其他人 编辑。 请在编辑前查看最近更改以避免编辑冲突，或稍后再试。

修改页面

• 如果想要编辑一个已经存在的页面，请点击到页面右上角的编辑按钮，或按下按下Alt+Shift+V进入可视化编辑项，也可以按下Alt+Shift+E进入源代码编辑框，在编辑源代码内可按下Ctrl+F，使用编辑框搜索功能定位到你要修改的位置，进行修改。
• 如果想要编辑页面内的某一个章节，可点击子标题旁的[编辑]/[编辑源代码]按钮编辑页面内的指定章节。

创建页面

• 在WIKI页面右上方或上方的搜索HAM知识库内容中输入所要创建的页面名称，此时若不存在页面名称的子页面，在搜索结果页面中会提示“找不到和查询相匹配的结果”的页面！，点击在此wiki上创建页面“***”双引号内文字进行词条创建。
• 也可以在浏览器地址栏输入https://doc.hzham.org/index.php/页面名称，再点击创建此页面按钮创建页面，在新页面右上角可点击[创建]/[创建源代码]按钮切换编辑器。
• 当某个已经存在的页面中，包含指向某个不存在的页面的链接时，你也可以通过点击这个链接来创建页面。

基础编辑

章节

你输入的内容	你看到的显示
==标题== 页面标题是页面名称，所以请从一级标题开始用起。 有四个以上标题的页面会自动生成一个目录。 这个自动生成的目录可以通过书写<code>__NOTOC__</code>来隐藏。 ===一级子标题=== 输入更多的“等于号”(=)可以创建更多下一级标题。 ====二级子标题==== 请不要跳跃标题等级，例如二级标题之下直接就是四级标题，而没有三级标题。 =====三級子标题=====	标题 页面标题是页面名称，所以请从标题开始用起。 有两个以上标题的页面会自动生成一个目录。 这个自动生成的目录可以通过书写__NOTOC__来隐藏。 一级子标题 输入更多的“等于号”(=)可以创建更多下一级标题。 二级子标题 请不要跳跃标题等级，例如二级标题之下直接就是四级标题，而没有三级标题。 三级子标题

行与段落

你输入的内容	你看到的显示
另起一行并不会导致换行， 而只是会增加一个空格。 空一个空行虽然可以换行， 但其实是开始了一个新的段落。 如果你对空一个空行产生的行间距不满， 你可以空两个空行<del>，或者空更多行</del>。	另起一行并不会导致换行， 而只是会增加一个空格。 空一个空行虽然可以换行， 但其实是开始了一个新的段落。 如果你对空一个空行产生的行间距不满， 你可以空两个空行，或者空更多行。
另一种换行方式是使用<code><br/></code>标记来换行。<br/> 这样换行后的内容仍在'''同一段落'''内。	另一种换行方式是使用<br/>标记来换行。 这样换行后的内容仍在同一段落内。
* 星号(*)其实是符号列表。 ** 星号(*)会在文章内容前生成●， *** 下级星号(*)会生成缩进后的●。 **** 这很好用。 *但糟糕的是一些人通过符号列表来对文章换行。 ** '''请务必不要这么做！'''	星号(*)其实是符号列表。 星号(*)会在文章内容前生成●， 下级星号(*)会生成缩进后的●。 这很好用。 但糟糕的是一些人通过符号列表来对文章换行。 请务必不要这么做！
# 井号(#)是数字列表。 ## <del>曾经</del>每一行前面都有一个数字序号。 ##* 甚至可以将数字列表与符号列表混用。 ##*# <del>然并卵。</del> 同样，'''请勿用数字列表来换行和缩进！'''	井号(#)是数字列表。 曾经每一行前面都有一个数字序号。 甚至可以将数字列表与符号列表混用。 然并卵。 同样，请勿用数字列表来换行和缩进！
: 冒号(:)最大的贡献是 :: 缩进！ ::: 可以缩进到让你满意。 '''请用冒号(:)来缩进'''，而不是用星号(*)或井号(#)！	冒号(:)最大的贡献是 缩进！ 可以缩进到让你满意。 请用冒号(:)来缩进，而不是用星号(*)或井号(#)！
如果一些行的开始是空格， 那么这些行将被'''预格式化'''， 不会被换行。 通常是用来显示一段代码之类的东西。 也可以使用<pre>...</pre>。	如果一些行的开始是空格， 那么这些行将被预格式化， 不会被换行。 通常是用来显示一段代码之类的东西。 也可以使用<pre>...</pre>。
我以前和你一样也是个Ham ---- 直到我遇到了摩托车	我以前和你一样也是个Ham 直到我遇到了摩托车

文字样式

你输入的内容	你看到的显示
''斜体'' '''粗体''' '''''粗斜体'''''	斜体 粗体 粗斜体
<b>粗体</b> <i>斜体</i> <strong>强调</strong> <s>划掉</s> <del>删除线</del> <kbd>键盘输入</kbd> <code>代码</code> <big>大字号</big> <small>小字号</small>	粗体 斜体 强调 划掉 删除线 键盘输入 代码 大字号 小字号
<nowiki>不进行''wiki''解析</nowiki>	不进行''wiki''解析
<font color="red">应用CSS样式</font>	应用CSS样式
<div style="text-align:left">居左</div> <div style="text-align:right">居右</div> <div style="text-align:center">居中</div>	居左 居右 居中

文字修饰

文字颜色

你输入的内容	你看到的显示
<font color="red">大家都是火腿...</font> <font color="#FFFF00">大家都是火腿...</font>	大家都是火腿... 大家都是火腿...

链接

你输入的内容	你看到的显示
[[业余无线电]]是一个站内链接。 也可以修改链接的显示文字，比如[[业余无线电|业余无线电！]]。	业余无线电是一个站内链接。 也可以修改链接的显示文字，比如业余无线电！。
[[杭州丫丫名录]]是一个指向不存在页面的链接。	杭州丫丫名录是一个指向不存在页面的链接。
其他命名空间的页面的链接，比如[[特殊:上传文件]]或[[文件:Mylogo1.png]]	其他命名空间的页面的链接，比如特殊:上传文件或
站外链接： * https://bg5adn.notion.site/373b70ebd9e54bb5833e2aa73eca931a * [https://bg5adn.notion.site/373b70ebd9e54bb5833e2aa73eca931a] * [https://bg5adn.notion.site/373b70ebd9e54bb5833e2aa73eca931a BG5ADN的业余无线电资料]	站外链接： https://bg5adn.notion.site/373b70ebd9e54bb5833e2aa73eca931a [1] BG5ADN的业余无线电资料

引用

• 说明：文章引用内容，对应内容外链。
• 用途：适用于页面部分内容引用外部内容（如一段话，引用了一篇文章），使你的文章有参考资料可查，内容更具可信度。
• 写法：<ref>[链接 链接页面名]</ref>
  • 需要在页面最底部添加标题栏==外链与注释==。

插入图片

你输入的内容	你看到的显示
[[文件:Mylogo1.png]]

• 效果说明：普通插入

你输入的内容	你看到的显示
[[文件:Mylogo1.png|50px]]

• 效果说明：限制宽度插入

你输入的内容	你看到的显示
[[文件:Mylogo1.png|50px|center|link=Mylogo1]] [[文件:Mylogo1.png|50px|居中|link=Mylogo1]]

• 效果说明：居中、链接到页面

你输入的内容	你看到的显示
[[文件:Mylogo1.png|frame|50px|right]] [[文件:Mylogo1.png|边框|50px|右]]

• 效果说明：加边框、居右

你输入的内容	你看到的显示
[[文件:Mylogo1.png|thumb|right|Mylogo1]] [[文件:Mylogo1.png|缩略图|右|Mylogo1]]	Mylogo1

• 效果说明：加边框、居右、加入说明文字“Mylogo1”

---

• 你可以在源代码编辑器中蓝框区域拖入图片上传，也可在上传文件中上传文件，或者点击文件列表来查看已有的图片。
• 详细可以参考维基百科-帮助:图像和MediaWiki-帮助:图像

表格编辑

{| class="wikitable"
|-
! 杭
! 州
! 业
|-
| 余
| 无
| 线
|-
| 电
| LO
| GO
|}

提交编辑后，表格显示为：

杭	州	业
余	无	线
电	LO	GO

• 其中{|开头，|}结尾，!为表头，|为单元格，|-表示表格行的开始。

---

合并单元格

• 合并行（colspan="行数"|）

{| class="wikitable"
|-
! colspan="4"|试问频点哪个热闹
|-
| 1
| 4
| 5
| 1
|}

提交编辑后，表格显示为：

试问频点哪个热闹
1	4	5	1

• 合并列（rowspan="列数"|）

{| class="wikitable"
|-
! rowspan="4"|试问频点哪个热闹
| 1
|-
| 4
|-
| 5
|-
| 1
|}

提交编辑后，表格显示为：

试问频点哪个热闹	1
	4
	5
	1

可折叠表格

表格折叠使用方法
说明：使内容折叠。 用途：一般用于页面过长，将部分可选择性观看的内容折叠。 写法：在表格class=后加 mw-collapsible（此时为默认展开，可折叠）。 在表格class=后再追加 mw-collapsed（此时为默认折叠，可展开）。 表格第一行为默认展示的内容，第二行开始到表格结尾可以折叠。

添加表格样式

{| class="wikitable" style="color:brown"
|-
! 杭
! 州
! 业
|-
| 余
| 无
| 线
|-
| 电
| LO
| GO
|}

提交编辑后，表格显示为：（更改了全体表格字体颜色）

杭	州	业
余	无	线
电	LO	GO

{| class="wikitable"
|-
! style="color:brown"|杭
! 州
! 业
|-
| 余
| 无
| 线
|-
| 电
| LO
| GO
|}

提交编辑后，表格显示为：（更改了单格字体颜色）

杭	州	业
余	无	线
电	LO	GO

• style内可填写更多CSS样式，例如background（背景色）、margin、padding（内外边距）等

引用

你输入的内容	你看到的显示
<blockquote>我朋友想看看<br/>——我朋友</blockquote>	我朋友想看看 ——我朋友

变量

前言

变量可以返回关于当前页面、W站点或日期的信息。变量的语法与模板类似。其中标记为“[高开销]”的变量会被软件记录，且在一个页面中可使用的总数会被限制。

如果某一模板名与变量名重复，软件会自动将其解释为变量（因此若要包含Template:PAGENAME，页面中需要写作{{Template:PAGENAME}}）。在某些情况下，加入参数会强制软件将变量视作一个模板，如{{CURRENTDAYNAME|x}}将会包含Template:CURRENTDAYNAME，而不是变量。

语法：字符被两个大括号括起来，所有字母大写，例如{{FOO}}。用法与模板类似。

日期和时间

变量	输出	描述	版本
年
{{CURRENTYEAR}}	2026	年
月
{{CURRENTMONTH}}	01	月(补足前导的0)
{{CURRENTMONTH1}}	1	月(无前导的0)
{{CURRENTMONTHNAME}}	1月	月份名称
{{CURRENTMONTHNAMEGEN}}	1月	月份(属格)
{{CURRENTMONTHABBREV}}	1月	月份(缩写)	≥1.5
日
{{CURRENTDAY}}	15	今天是几日（不补齐）
{{CURRENTDAY2}}	15	今天是几日（以0补齐）	≥1.6
{{CURRENTDOW}}	4	周内一日（无填充），0（即星期日）到6（即星期六）
{{CURRENTDAYNAME}}	星期四	周内一日（名称）
时间
{{CURRENTTIME}}	11:34	时间（24小时制HH:mm的格式）
{{CURRENTHOUR}}	11	时间（24小时制含前导0的数字）
其他
{{CURRENTWEEK}}	3	第几周（数字）
{{CURRENTTIMESTAMP}}	20260115113442	YYYYMMDDHHmmss时间戳	≥1.7

• 如下变量和上列变量功能相同，但是使用的是所在服务器的时间或者$wgLocaltimezone。
  • {{LOCALYEAR}}
  • {{LOCALMONTH}}
  • {{LOCALMONTH1}}
  • {{LOCALMONTHNAME}}
  • {{LOCALMONTHNAMEGEN}}
  • {{LOCALMONTHABBREV}}
  • {{LOCALDAY}}
  • {{LOCALDAY2}}
  • {{LOCALDOW}}
  • {{LOCALDAYNAME}}
  • {{LOCALTIME}}
  • {{LOCALHOUR}}
  • {{LOCALWEEK}}
  • {{LOCALTIMESTAMP}}

统计

这些变量返回的数字往往包含分隔符（根据本地语言参数设置而可能是逗号或空格）。可以通过“:R”来返回无分隔号的数字（例如{{NUMBEROFPAGES}} → 908,684和{{NUMBEROFPAGES:R}} → 908684）。

变量	输出	描述	版本
{{NUMBEROFPAGES}}	163	维基页面数量
{{NUMBEROFARTICLES}}	6	在内容名字空间中，作为条目的页面个数。
{{NUMBEROFFILES}}	56	上传文件的个数。
{{NUMBEROFVIEWS}}		页面浏览次数。通常对使用缓存的wiki无效。在当前版本无效	1.14 – 1.24
{{NUMBEROFUSERS}}	54	注册用户数量
{{NUMBEROFADMINS}}	13	管理员组用户数量
{{NUMBEROFACTIVEUSERS}}	1	活跃用户总数，其标准与特殊:统计信息中的标准相同。

技术元数据

变量	输出	描述	版本
站点
{{SITENAME}}	HAM知识库	维基网站的名称（$wgSitename）
{{SERVER}}	https://doc.hzham.org	域名URL（$wgServer）
{{SERVERNAME}}	doc.hzham.org	子域名和域名（自版本1.17后不再取决于$wgServerName）。
{{STYLEPATH}}	/skins	样式相对路径（$wgStylePath）	≥1.16
{{CURRENTVERSION}}	1.43.1	此维基站点的MediaWiki版本	≥1.7
{{CONTENTLANGUAGE}} {{CONTENTLANG}}	zh-cn zh-cn	默认界面语言（$wgLanguageCode）	≥1.7
页面
{{PAGEID}}	55	返回页面编号	≥1.20
{{PAGELANGUAGE}} {{#language:{{PAGELANGUAGE}}}}	zh-cn 中文（中国大陆）	返回当前页面的语言。此变量返回的语言代码可使用{{#language:...}}转换为语言名。	≥1.29
最近一次编辑版本号
{{REVISIONDAY}}	10	最近一次编辑的日期（无前导0）	≥1.8
{{REVISIONDAY2}}	10	最近一次编辑的日期（前导0）	≥1.8
{{REVISIONMONTH}}	06	最近一次编辑的月份（1.17+有前导0，较早版本没有前导0）	≥1.8
{{REVISIONMONTH1}}	6	最近一次编辑的月份（没有前导0）	≥1.17
{{REVISIONYEAR}}	2025	最近一次编辑的年份	≥1.8
{{REVISIONTIMESTAMP}}	20250610002547	最近一次编辑的时间戳	≥1.8
{{REVISIONSIZE}}	48927	当前版本页面的大小（维基文本）。	≥1.22

页面名称

变量	对于当前页面	描述	版本
{{FULLPAGENAME}}	帮助:编辑教程	名字空间与完整页面标题（包括子页面级别）。
{{PAGENAME}}	编辑教程	不包含名字空间的完整页面标题（包括子页面级别）。
{{BASEPAGENAME}}	编辑教程	页面标题，不包括当前子页面标题及命名空间。
{{ROOTPAGENAME}}	编辑教程	获得当前页面的根页名。 在 Help:Title/Foo/Bar 页面返回 Title。
{{SUBPAGENAME}}	编辑教程	子页面标题。 在Help:Title/Foo/Bar页面返回Bar。 如果子页面不存在将会回传{{PAGENAME}}的值。
{{SUBJECTPAGENAME}} {{ARTICLEPAGENAME}}	帮助:编辑教程 帮助:编辑教程	获得该页面的完整页面名。对讨论页十分有用。
{{TALKPAGENAME}}	帮助讨论:编辑教程	关联讨论页的完整页面名称

• 以上魔术字可以接受一个参数，用于指定特定页面，来代替要处理的当前页面设定：
  • {{PAGENAME:Template:Main Page}} → Main Page
  • {{PAGENAME:模板:点名简报}} → 点名简报

名字空间

变量	输出	描述	版本
{{NAMESPACENUMBER}}	12	页面所在名字空间的ID
{{TALKSPACE}}	帮助讨论	相关联的讨论名字空间的名称

• 关于名字空间详见:帮助:名字空间

其他

变量	输出	描述	版本
{{!}}	|	用于在模板或者是表格内插入管道符号。

状态开关

前言

• 状态开关：通常写成以两个下划线“__”为前后缀的大写单词，例如__FOO__。
• 状态开关可以控制页面（只要受皮肤支持）的显示方式或其他行为。它往往用于排除或加入特定的页面内容。

文字	描述	版本
目录
__NOTOC__	隐藏目录（TOC）。
__FORCETOC__	强制于默认位置（第一个章节标题上方，忽略的设置）显示目录。
__TOC__	在魔术字的位置插入目录（忽略的设置）。如果这个魔术字在一个页面内被多次使用，目录将出现在第一个词的位置。
编辑
__NOEDITSECTION__	隐藏章节标题旁的编辑链接。这个特别有用，当章节标题在模板中被创建时，普通的编辑链接将会把用户带到编辑模板代码界面，这与用户的直觉不符。 在模板中使用它将扩充对模板嵌入页面的影响，以及任何包含在同一页面的其他模板。
__NEWSECTIONLINK__	在非讨论页顶端“编辑”标签右侧加入一个按钮，用于在页面结尾加入新的章节（参见在页面末尾加入新章节）。
__NONEWSECTIONLINK__	移除讨论页顶端“编辑”右侧的加入新章节链接。
分类
__NOGALLERY__	用于分类页面。不显示分类中所包含文件的缩略图，而以普通链接代替。
__HIDDENCAT__	用于分类页面。加入后此分类成为隐藏分类，将不会显示在上级分类其及成员页面的分类列表中（可以通过参数设置中的选项强制显示）。
__EXPECTUNUSEDCATEGORY__	在分类页面上使用，从Special:UnusedCategories中删除分类。

解析函数

所有函数均适用的注意事项

以下是一个解析函数的基本格式：

{{#函数名: 参数1 | 参数2 | ... | 参数n }}

在页面中写上如此一般的代码后，后台解析页面是就会呼叫解析函数“函数名”，并传入相应的参数。如果输入的参数内同样的含有函数（或模板等需要展开运算的代码），解析器将会先运算和展开参数里的代码。这种先后次序与数学公式中的括号是同等效果，由内至外逐一展开运算。

其他注意事项：

• 某些函数对“该参数的值为空白”及“缺少该参数”的理解会有差异，导致运算处理和最终输出出现差错，需要留意该函数有没有这种设定。例如regex就有这种设定。
• 字符本身和对应的HTML实体（HTML Entity）不一定会受到一致的处理，甚至不会相互等于，需要留意函数是否会将输入解码或将输出编码。
• 如果函数突然出现不符合预期的输出，那很有可能是你忘记了对某些特殊字符转义。
• 参数内容的前后可以随意添加空格和换行，可以适当使用让排版更整齐易懂。

expr

类型	运算符
组合（括号）	( )
数字	1234.5 、 e (2.718) 、 pi (3.142)
	科学计数法（二元） e 、 正负号（一元） +,-
一元运算符	not ceil trunc floor abs exp ln sin cos tan acos asin atan
二元运算符	^
	* / div mod
	+ -
四舍五入	round
逻辑运算符	= != <> > < >= <=
	and
	or

来自ParserFunctions。
用于验证一个数学表达式，并返回它的计算值。
此函数在Scribunto扩展中也可用，函数名为mw.ext.ParserFunctions.expr。

格式

{{#expr: 表达式 }}

支持的运算符如右方表格所示，表格从上到下按运算符的计算优先顺序排列。

每个运算符的详细功能见Help:Calculation。

计算结果的精度和格式取决于wiki服务器的操作系统，和网站语言的数字格式。

例子

当用于计算布尔代数值（Boolean algebra）时，零值表示false（假），任何非零值，无论正负，都表示ture（真）：

{{#expr: 1 and -1 }} → 1

{{#expr: 1 and 0 }} → 0

{{#expr: 1 or -1 }} → 1

{{#expr: -1 or 0 }} → 1

{{#expr: 0 or 0 }} → 0

输入空的表达式会返回一个空字串。输入不正确的表达式会返回其中一个错误消息，错误可以被解析函数#iferror|iferror]]函数捕捉到：

{{#expr: }} →

{{#expr: 1+ }} →

{{#expr: 1 = }} →

{{#expr: 1 foo 2 }} →

加减运算符在数字之前与之后的意义不同，它们有可能被当作正负号，而不会被当作不正确的表达式：

{{#expr: +1 }} → 1

{{#expr: -1 }} → -1

{{#expr: + 1 }} → 1

{{#expr: - 1 }} → -1

注意

如果使用魔术字的输出值，必须使用其原始格式，如：移除所有分割逗号，转换为数字。

比如{{NUMBEROFUSERS}}输出的是54，但是实际需要的是54，原始格式可以用{{formatnum:{{NUMBEROFUSERS}}|R}}来得到，详见formatnum。例子如下：

{{#expr:{{NUMBEROFUSERS}}+100}} → 154

{{#expr:{{formatnum:{{NUMBEROFUSERS}}|R}}+100}} → 154

注意

运算符mod会在某些除数值下给出错误的结果：

{{#expr: 123 mod (2^64-1)}} → （返回空字串，结果本应是123）

补充

若想要进行关于日期的计算（比如：将当前日期与某日期进行比较），首先应将时间转化为“1970年1月1日之后多少秒”的结构，可以使用{{#time: xNU }}来转换（详见time），然后就可以把日期当作数字来进行计算和比较了。

关于四舍五入

将运算符round左边的数四舍五入，使其小数位数为round右边的数。

如需进一取整（向上舍入），使用ceil；如需舍去取整（向下舍入），使用floor。

例子	结果	舍入方法
{{#expr: 1/3 round 5 }}	0.33333	保留5位小数。舍去的部分首位数值<5，则不会进一。
{{#expr: 1/6 round 5 }}	0.16667	保留5位小数。舍去的部分首位数值≥5，则进一。
{{#expr: 8.99999/9 round 5 }}	1	同上方法，结果是进一得到的。
{{#expr: 1234.5678 round -2 }}	1200	此处保留到百位。要保留到小数点左侧，应使用负的位数。
{{#expr: 1234.5678 round 2 }}	1234.57	此处保留到百分位。要保留到小数点右侧，应使用正的位数。
{{#expr: 1234.5678 round 2.3 }}	1234.57	位数值如果输入了带小数的数值，小数部分不起作用。
{{#expr: trunc 1234.5678 }}	1234	保留到整数可以使用trunc。
保留到整数的舍入规则：
{{#expr: 1/3 round 0 }}	0	保留到最近的整数，向下舍入至零。
{{#expr: 1/2 round 0 }}	1	保留到最近的整数，向上舍入至一。
{{#expr: 3/4 round 0 }}	1	保留到最近的整数，向上舍入至一。
{{#expr: -1/3 round 0 }}	-0	保留到最近的整数，向上舍入至零。
{{#expr: -1/2 round 0 }}	-1	保留到最近的整数，向下舍入至负一。
{{#expr: -3/4 round 0 }}	-1	保留到最近的整数，向下舍入至负一。
使用ceil和floor时的舍入规则：
{{#expr: ceil(1/3) }}	1	向上舍入至一。
{{#expr: floor(1/3) }}	0	向下舍入至零。
{{#expr: ceil(-1/3) }}	-0	向上舍入至零。
{{#expr: floor(-1/3) }}	-1	向下舍入至负一。
{{#expr: ceil 1/3 }}	0.33333333333333	没有被舍入处理，因为1就是整数 注意：上述表达式含义为(ceil 1)/3，而不是ceil(1/3)，应注意。

关于字符串

表达式只能用于数字值，不能比较字串或者字符。如需比较字串和字符，请使用ifeq。例子：

{{#expr: "a" = "a" }} →

{{#expr: a = a }} →

{{#ifeq: a | a | 1 | 0 }} → 1

lc

MediaWiki原生函数。
把输入的字串中所有字母变成小写。

格式

{{lc: 字串 }}

例子

{{lc: A字串 BC }}→ a字串 bc

lcfirst

MediaWiki原生函数。
把输入的字串中第一个字母变成小写。

格式

{{lcfirst: 字串 }}

例子

{{lcfirst: A字串 BC }}→ a字串 BC

{{lcfirst: 字串 BC }}→字串 BC

if

来自ParserFunctions。
用于鉴别一个测试字串是否为空。一个只含有空白字符的字串会被判定为空。

格式

{{#if: 测试字串 | 字串非空输出值 | 字串空（或只有空白字符）输出值 }}

{{#if: 参数1 | 参数2 | 参数3 }}

说明

这个函数首先检查'参数1'是否为空。如果'参数1'不为空，则显示'参数2'。如果'参数1'为空或只含有空白字符（如空格，换行符等），则显示'参数3'。

例子

{{#if: | yes | no}} → no

{{#if: string | yes | no}} → yes

{{#if:     | yes | no}} → no

{{#if:


| yes | no}} → no

测试字串总是被解释为纯文本，所以数学表达式不会被鉴别。

{{#if: 1==2 | yes | no }} → yes

{{#if: 0 | yes | no }} → yes

最后一个参数（字串空输出值）可以省略。

{{#if: foo | yes }} → yes

{{#if: | yes }} →

{{#if: foo | | no}} →

这个函数可以被嵌套。嵌套时，需用完整格式的#if函数，替代外层#if函数的某个参数。最大可以嵌套七层，具体取决于网站和存储限制。

{{#if: 测试字串1 | 字串1非空输出值 | {{#if: 测试字串2 | 字串2非空输出值 | 字串2空（或只有空白字符）输出值 }} }}

可以用一个参数当作#if函数的测试字串。必须在变量名的后面加上管道符|。

{{#if:{{{1|}}}| 变量1中输入了文本 | 变量1中没有文本 }}

对于在模板中的应用，更多例子可参照：Help:Parser functions in templates

ifeq

来自ParserFunctions。
用于比较两个字串是否相同。

格式

{{#ifeq: 测试字串1 | 测试字串2 | 相同时输出值 | 不相同时输出值 }}

例子

如果两个字串都是有效的数值，则会按照数值进行比较。

{{#ifeq: 01 | 1 | equal | not equal}} → equal

{{#ifeq: 0 | -0 | equal | not equal}} → equal

{{#ifeq: 1e3 | 1000 | equal | not equal}} → equal

{{#ifeq: {{#expr:10^3}} | 1000 | equal | not equal}} → equal

否则会按照文本进行比较，区分大小写。

{{#ifeq: foo | bar | equal | not equal}} → not equal

{{#ifeq: foo | Foo | equal | not equal}} → not equal

{{#ifeq: "01" | "1" | equal | not equal}} → not equal （注意与上方不带引号的区别）

{{#ifeq: 10^3 | 1000 | equal | not equal}} → not equal （注意与上方使用了#expr函数的区别）

注意

#ifeq和#switch的数值比较与使用#expr进行比较不同：

{{#ifeq: 12345678901234567 | 12345678901234568 | equal | not equal}} → not equal

{{#switch: 12345678901234567 | 12345678901234568 = equal | not equal}} → not equal

因为PHP以整数型比较两个数字，然而：

{{#ifexpr: 12345678901234567 = 12345678901234568 | equal | not equal}} → equal

因为MediaWiki转换文本数字为浮点型，对于比较大的整数，会导致末尾被舍去。

注意

在解析函数内部的标签和解析函数（如<nowiki>）会被暂时替换为一个唯一的代码。这会影响到比较结果：

{{#ifeq: <nowiki>foo</nowiki> | <nowiki>foo</nowiki> | equal | not equal}} → not equal

{{#ifeq: <math>foo</math> | <math>foo</math> | equal | not equal}} → not equal

{{#ifeq: {{#tag:math|foo}} | {{#tag:math|foo}} | equal | not equal}} → not equal

{{#ifeq: [[foo]] | [[foo]] | equal | not equal}} → equal

如果被比较的字串 是由等价调用 含有这类标签的 同一模板 得到的，则值为真；但如果为 含有相同的这类标签的 两个模板，则值为假。

注意

在用页面名变量（如：{{FULLPAGENAME}}）比较当前页面标题时，应小心。这些变量会将特殊字符转换为数字HTML实体。这会造成具有误导性的结果。比如，在一个标题为“L'Aquila”的页面上：

{{#ifeq: L'Aquila | {{FULLPAGENAME}} | equal | not equal}} → not equal

上面的结果实际是错误的。经过改进之后，现在它会返回“equal”。但是对于其他情况可能不会如此。如{{FULLPAGENAME}}，在部分网站，可能会将第一个字母替换为大写，可能会将所有下划线替换为空格。

为了解决这个问题，可以在两个参数上都应用变量：

{{#ifeq: {{FULLPAGENAME: L'Aquila}} | {{FULLPAGENAME}} | equal | not equal}} → equal

padleft

将参数1通过在左侧补上参数3指定的字符串（默认为0）补足到参数2指定的长度，例如 044 生成 044。参数3指定的字符串可能被截断以保证补足后的字符串长度满足要求。

例子&输出

{{padleft:xyz|5}} → 00xyz

{{padleft:xyz|5|_}} → __xyz

{{padleft:xyz|5|abc}} → abxyz

{{padleft:xyz|2}} → xyz

{{padleft:|1|xyz}} → x

switch

来自ParserFunctions。
这个函数将一个输入值与若干个情况值对比，如果找到了相符的情况，则返回该情况下的输出字串。

格式

{{#switch: 比较字串
 | 情况字串1 = 返回结果1
 | 情况字串2 = 返回结果2
 | ...
 | 情况字串n = 返回结果n
 | 默认结果
}}

例子

{{#switch: baz | foo = Foo | baz = Baz | Bar }} → Baz

{{#switch: foo | foo = Foo | baz = Baz | Bar }} → Foo

{{#switch: zzz | foo = Foo | baz = Baz | Bar }} → Bar

#switch和部分转换标签可以作用于配置文件，从而可以使不熟悉模板代码的编辑者编辑可配置元素。

关于默认结果

在当没有'情况字串'与'比较字串'相符时，会返回'默认结果'：

{{#switch: test | foo = Foo | baz = Baz | Bar }} → Bar

按这个函数的句法，'默认结果'必须是最后一个参数，并且不能包含原始等号符。

{{#switch: test | Bar | foo = Foo | baz = Baz }} →

{{#switch: test | foo = Foo | baz = Baz | B=ar }} →

或者'默认结果'可以用'情况字串'#default来特别声明。

{{#switch: 比较字串
 | 情况字串1 = 返回结果1
 | 情况字串2 = 返回结果2
 | ...
 | 情况字串n = 返回结果n
 | #default = 默认结果
}}

用这种方式声明的'默认结果'可以放在函数内的任何位置：

{{#switch: test | foo = Foo | #default = Bar | baz = Baz }} → Bar

如果'默认结果'被省略，当没有相符情况时，不会返回结果：

{{#switch: test | foo = Foo | baz = Baz }} →

一组情况的结果

可以使用“fallthrough”值，即若干'情况字串'返回相同的'返回结果'。这能减少重复。

{{#switch: 比较字串
 | 情况字串1 = 返回结果1
 | 情况字串2 
 | 情况字串3 
 | 情况字串4 = 返回结果234
 | 情况字串5 = 返回结果5
 | 情况字串6 
 | 情况字串7 = 返回结果67
 | #default = 默认结果
}}

在这里情况2、3、4都会返回'返回结果234'，情况6、7都会返回'返回结果67'。

关于比较

与#ifeq相同，如果'比较字串'和'情况字串'都为数值，则会按照数值进行比较。以上情况外，区分大小写：

{{#switch: 0 + 1 | 1 = one | 2 = two | three}} → three

{{#switch: {{#expr: 0 + 1}} | 1 = one | 2 = two | three}} → one

{{#switch: a | a = A | b = B | C}} → A

{{#switch: A | a = A | b = B | C}} → C

'情况字串'可以是空：

{{#switch: | = Nothing | foo = Foo | Something }} → Nothing

当出现一个相符情况后，之后的'情况字串'会被忽略：

{{#switch: b | f = Foo | b = Bar | b = Baz | }} → Bar

注意

#switch和#ifeq的数值比较方法与表达式比较不同：

{{#switch: 12345678901234567 | 12345678901234568 = A | B}} → B

{{#ifexpr: 12345678901234567 = 12345678901234568 | A | B}} → A

具体见ifeq处的第一条“注意”。

关于原始等号符

'情况字串'不能包含原始等号符。为了解决这个问题，创建了一个只包含一个等号符=的模板{{=}}。

应用的例子：

{{#switch: 1=2
 | 1=2 = raw
 | 1=2 = nowiki
 | 1=2 = html
 | 1{{=}}2 = template
 | default
}}

→ html

关于替换#ifeq

#switch可以用来减少扩展深度。

比如：

{{#switch:{{{1}}} |情况1=分支1 |情况2=分支2 |情况3=分支3 |分支4}}

等价于：

{{#ifeq:{{{1}}}|情况1 |分支1 |{{#ifeq:{{{1}}}|情况2 |分支2 |{{#ifeq:{{{1}}}|情况3 |分支3 |分支4}}}}}}

写成便于阅读的格式即为：

{{#ifeq:{{{1}}}|情况1 
  |<!--then-->分支1 
  |<!--else-->{{#ifeq:{{{1}}}|情况2 
                |<!--then-->分支2 
                |<!--else-->{{#ifeq:{{{1}}}|情况3 
                              |<!--then-->分支3 
                              |<!--else-->分支4}}}}}}

uc

MediaWiki原生函数。
把输入的字串中所有字母变成大写。

格式

{{uc: 字串 }}

例子

{{uc: a字串 bc }}→ A字串 BC

ucfirst

MediaWiki原生函数。
把输入的字串中第一个字母变成大写。

格式

{{ucfirst: 字串 }}

例子

{{ucfirst: a字串 bc }}→ A字串 bc 

{{ucfirst: 字串 bc }}→字串 bc 

参考资料