帮助:编辑指南/语法和排版

编辑指南

此条目主要介绍 Wikitext 的相关语法以及在编写 Wiki 时常用的一些排版样式。

对于新的编辑者，可以通过阅读 Wiki 内各个页面的源代码来了解更多的语法和排版格式，这在学习如何编写 Wikitext 方面大有裨益。

空格和标点

中文、英文和数字三者混排并且无空格时视觉感官较差，过于密集的文字会降低可读性，给读者造成压力，一般情况下建议添加空格，减少信息密集度，提高可读性。

中文正文部分的全部内容应当使用全角的标点符号，例如使用中文的省略号 ……（正常可通过 Shift + 6 打出）代替英文省略号 … （三个点），使用“全角引号”而非"半角引号"包裹文字。

对于与中文标点符号相连接的英文单词或数字，无需使用空格分隔，例如：

（阶段 1），而非 （阶段 1 ）
卡米拉：7、22、28 日，而非 卡米拉： 7 、 22 、 28 日

以下是一段文本，体现了空格与文本可读性之间的关系。

无空格	有空格
2019年年初，ConcernedApe组建了一支小型团队继续更新和维护游戏。游戏1.4版本的更新由ConcernedApe、Arthur Lee（又名 Mr. Podunkian）和Alex Erlandson（又名 zillix）共同开发完成。游戏1.5版本的更新由ConcernedApe和Arthur Lee（又名 Mr. Podunkian）共同开发完成。	2019 年年初，ConcernedApe 组建了一支小型团队继续更新和维护游戏。游戏 1.4 版本的更新由 ConcernedApe、Arthur Lee（又名 Mr. Podunkian）和 Alex Erlandson（又名 zillix）共同开发完成。游戏 1.5 版本的更新由 ConcernedApe 和 Arthur Lee（又名 Mr. Podunkian）共同开发完成。

标题

使用等号 = 包裹一段文字来创建标题

示例	效果
=== 三级标题 === ==== 四级标题 ====	三级标题四级标题

注意：

永远不要使用单个等号创建一级标题
文字两边的等号数量必须相同

创建标题后，Wiki 能够自动生成目录，方便读者快速定位内容。

粗体与斜体

使用三个单引号包裹一段文字来创建粗体文本，使用单引号 ' 包裹一段文字来创建斜体文本。

示例	效果
''斜体'' '''粗体''' '''''粗斜体'''''	斜体粗体粗斜体

注意：

中文不存在真正的斜体。中文的斜体实际上只是将正方形强行扭曲为平行四边形的伪斜体，因此应当尽量避免使用斜体。
对于关键信息，一般情况下建议使用加粗进行替代，对于非关键信息，建议直接移除。

换行

使用两个换行符（敲两下回车键）来达到换行的效果，若只使用一个换行符（敲一下回车键），那么它会根据不同的浏览器，变成一个空格或是什么也不会发生。

示例	效果
逸一时误一世逸久逸久罢已龄	逸一时误一世逸久逸久罢已龄

也可以使用 <br/> 进行换行，但一般不建议这么做。

缩进

缩进用于创建层次结构，使内容更有条理。使用冒号 : 来增加缩进级别。

示例	效果
不缩进文本 : 一级缩进 :: 二级缩进	不缩进文本一级缩进二级缩进

列表

列表主要用于组织内容，使其更清晰易读。常用的列表包括无序列表、有序列表和定义列表。

无序列表

使用星号 * 来创建一个无序列表，它会自动变成一个圆点。可以用于表示顺序不敏感的内容。使用多个 * 可以增加缩进以表示层次。

示例	效果
你听我说你听我说： * 你不是这样子的你得先这样然后再这样 ** 最后你再这样 * 听懂没有？	你听我说你听我说：你不是这样子的你得先这样然后再这样最后你再这样听懂没有？

有序列表

使用井号 # 来创建一个有序列表，它会自动变成数字序号。可以用于表示带有明确的顺序属性的内容。

示例	效果
我来鹅城只办三件事： # 公平 # 公平 # 还是 TMD 公平	我来鹅城只办三件事：公平公平还是 TMD 公平

使用多个 # 可以增加缩进以表示层次，但是二级有序列表的数字样式不会变化，因此一般不建议这样做。

定义列表

使用分号 ; 来定义一个名词或提出一个问题，然后在下面另起一行使用冒号 : 进行解释。

示例	效果
; 原神是什么 : 《原神》是由米哈游自主研发的一款全新开放世界冒险游戏。游戏发生在一个被称作「提瓦特」的幻想世界，在这里，被神选中的人将被授予「神之眼」，导引元素之力。你将扮演一位名为「旅行者」的神秘角色，在自由的旅行中邂逅性格各异、能力独特的同伴们，和他们一起击败强敌，找回失散的亲人——同时，逐步发掘「原神」的真相。	原神是什么《原神》是由米哈游自主研发的一款全新开放世界冒险游戏。游戏发生在一个被称作「提瓦特」的幻想世界，在这里，被神选中的人将被授予「神之眼」，导引元素之力。你将扮演一位名为「旅行者」的神秘角色，在自由的旅行中邂逅性格各异、能力独特的同伴们，和他们一起击败强敌，找回失散的亲人——同时，逐步发掘「原神」的真相。

链接

链接主要用于跳转至其它页面，方便读者在查阅时随时前往其他页面查看相关信息。

内部链接

内部链接可以跳转至当前 Wiki 内的任意其他页面，可以使用两对方括号 [[]] 包裹文字来创建内部链接。

在内部链接内，可以使用竖线 | 来自定义链接的显示文本，也可以使用井号 # 来指定跳转的页面章节。若页面不存在，则会显示红色（断链），俗称“红链”。

示例	效果	说明
`[[草莓]]`	草莓	将会跳转到草莓的页面
`[[农作物#巨大作物\|要价]]`	要价	将会显示“要价”，但是点击却会跳转到农作物页面的“巨大作物”章节
`[[西瓜]]`	西瓜	将会显示红链，因为不存在这个页面

外部链接

外部链接可以跳转至任意的外部网站，可以使用一对方括号 [] 包裹文字来创建外部链接。

在外部链接内，可以使用空格分割网址与文字来自定义链接的显示文本，或者干脆不自定义文字。

示例	效果	说明
`[https://zh.minecraft.wiki]`	[1]	将会跳转到 Minecraft Wiki
`[https://b23.tv/pkvb2wQ ❤️🩷🧡点这里有好康的🧡🩷❤️]`	❤️🩷🧡点这里有好康的🧡🩷❤️	将会显示神秘文字，点击后跳转到某个神秘页面

分类链接

分类链接可以将当前页面划入某一个类别中，可以使用 [[Category:某分类]] 来创建分类链接。

分类链接一般放在页面源代码的最后。

示例	效果
`[[Category:帮助文档]]`	（不会显示任何文字，但是当前页面将会被归类到“帮助文档”中）

HTML 标记

HTML 标记主要用于以更复杂的方式展示内容，通常用于代码块、数学公式等特殊内容。

代码块

代码块用于展示代码或其他需要特殊格式化的文本。可以使用 <code> 标签来展示一行代码，使用 <pre> 标签来展示多行代码。

标签	示例	效果
`<code>`	`<code>print("Hello")</code>`	`print("Hello")`
`<pre>`	<pre> 井include iosteam using namsepace std; int mian{ cout << "Hallo, World!"； return O; } </pre>	井include iosteam using namsepace std; int mian{ cout << "Hallo, World!"； return O; }

文字样式

文字样式可以使用 HTML 标签来实现更复杂的文本格式化。常用的标签包括 <small>、<big>、<sub>、<sup> 等。

标签	示例	效果
`<small>` `<big>`	`<small>小小的</small>也很<big>可爱捏</big>`	小小的也很可爱捏
`<sub>` `<sup>`	`NH<sub>4</sub><sup>+</sup>`	NH₄⁺

数学公式

数学公式使用 [math]\displaystyle{ \LaTeX }[/math] 语法展示一段数学公式，可以使用 <math> 标签来包裹公式内容以显示公式。

本 Wiki 目前更倾向于使用代码块来编写数学公式，故这种样式并不常用。

示例	效果
`<math>x=\frac{-b\pm \sqrt{b^2 - 4ac}}{2a}</math>`	[math]\displaystyle{ x=\frac{-b\pm \sqrt{b^2 - 4ac}}{2a} }[/math]

等宽文本

等宽文本可以使用等宽文字展示内容，通常用于呈现程序代码或方法名，可以使用 <samp> 标签来包裹内容显示等宽文本。

等宽文本主要用于各个页面的参考内容中，引用游戏代码的各种方法、属性与字段。

示例	效果
`<samp>Game1::Initialize</samp>`	`Game1::Initialize`

魔术字

魔术字（Magic words）是 MediaWiki 识别的特定字符串，它们可以返回特定的值或触发其他的功能。在日常编辑中，使用最为广泛的魔术字是 PAGENAME 和 nowiki

PAGENAME

{{PAGENAME}} 能够获取不包含名字空间的完整页面标题。

用法	效果
`{{PAGENAME}}`	编辑指南/语法和排版

nowiki

nowiki 能够禁用 wiki 格式解析，它的使用场景主要有两种：

使用一对标签包裹某段文字，禁用 wiki 格式解析以获取原始字符串
单独使用一个 nowiki 放在句末以消除异常的换行问题

用法效果说明

<nowiki>{{PAGENAME}}</nowiki> {{PAGENAME}} 若不使用 nowiki 包裹，则会显示当前页面，也就是：编辑指南/语法和排版

{{#lsth:南瓜|生长阶段}}<nowiki/>

这段文本应该紧贴在表格下方

南瓜可以长成巨大作物。

阶段 1	阶段 2	阶段 3	阶段 4	阶段 5	收成

1 天	2 天	3 天	4 天	3 天	共：13 天

这段文本应该紧贴在表格下方

若不在前面添加 <nowiki/>，那么会出现一个异常的空行：

甜瓜可以长成巨大作物。

阶段 1	阶段 2	阶段 3	阶段 4	阶段 5	收成

1 天	2 天	3 天	3 天	3 天	共：12 天

因为没有使用 <nowiki/>，所以这段文本并没有紧贴在表格下方

本页面就使用了大量的魔术字，可以通过查看本页面的源代码来更深入地了解 nowiki 的详细用法。在查看源代码时，请思考每一处 nowiki 为何要出现在那个位置。

高级用法

高级用法主要包括表格和图片，其格式非常丰富，在这里仅介绍其最基本的使用方法。

表格

示例效果

{| class="wikitable"
|+ 表格标题
! 使用半角感叹号表示一个表头 !! 两个感叹号 <code>!!</code> 用于在同一行中另起一列
! 一个感叹号 <code>!</code> 用于在新的一行中另起一列
|-
| colspan="2" | 使用 colspan 可以合并横向的单元格
| rowspan="2" | 使用 rowspan 可以合并<br/>竖向的单元格
|-
| colspan="2" | 使用 <code>|-</code> 来另起一行
|-
| 使用半角竖线表示表格主体 || 两条竖线 <code>||</code> 用于在同一行中另起一列
| 一条竖线 <code>|</code> 用于在新的一行中另起一列
|}

表格标题
使用半角感叹号表示一个表头	两个感叹号 `!!` 用于在同一行中另起一列	一个感叹号 `!` 用于在新的一行中另起一列
使用 colspan 可以合并横向的单元格		使用 rowspan 可以合并竖向的单元格
使用 `\|-` 来另起一行		使用 rowspan 可以合并竖向的单元格
使用半角竖线表示表格主体	两条竖线 `\|\|` 用于在同一行中另起一列	一条竖线 `\|` 用于在新的一行中另起一列

其中表头默认使用粗体文本，文字居中；表格主体则使用常规文本，文字左对齐。

图片

图片用于在正文中插入图像，增强内容表现力。基本语法为：[[File:图片名.扩展名|参数]]。

图片参数控制显示样式，多个参数用竖线 | 分隔：

参数类型	语法	说明
尺寸控制	`200px` `x150px` `200x150px`	宽度/高度/宽高限定
缩略图	`thumb`	添加边框+标题+右浮动
浮动定位	`right` `none`	右浮动/无浮动，其他浮动样式不建议使用
说明文字	`沉船遗迹`	图片标题/悬停提示
链接控制	`link=页面名`	点击图片跳转页面，设置 `link=` 为空可以禁用点击图片跳转

例如，输入：[[File:Shipwreck.png|300px|thumb|none|沉船]]，将会显示：

沉船

多图排版

目前本 Wiki 常用的多图排版方法主要为表格法和画廊法两种：

表格法

{| style="border:0; padding:0; margin:0;"
|[[File:Island Beach East.png|250px|thumb|none|西侧沙滩和蚌矿]]
|[[File:Island Beach West.png|250px|thumb|none|东侧沙滩和潮汐池]]
|[[File:Shipwreck.png|250px|thumb|none|沉船和隐藏的小路]]
|}

效果为：

西侧沙滩和蚌矿

东侧沙滩和潮汐池

沉船和隐藏的小路

画廊法

<gallery mode="packed" widths=80px heights=80px>
File:Abigail.png|[[阿比盖尔]]|link=阿比盖尔
File:Emily.png|[[艾米丽]]|link=艾米丽
File:Haley.png|[[海莉]]|link=海莉
File:Leah.png|[[莉亚]]|link=莉亚
File:Maru.png|[[玛鲁]]|link=玛鲁
File:Penny.png|[[潘妮]]|link=潘妮
</gallery>