查看“Wiki写作格式规范”的源代码

为了使 Wiki 的文章在整体上呈现出整齐且易于阅读的特征，本写作规范应运而生。在 Oasis Wiki 上开始编写时，请务必遵守'''基本规范'''，至于'''拓展规范'''则可由本人喜好决定。

=== 基本规范 ===

==== 规范 1：善用标题、善于划定标题层级。 ====
[[文件:title-tree-structure-example.png|缩略图|356x356像素]]
这有助于让文章结构更清晰，且易于读者标记和跳转。

* '''每一段'''内容都应有一个明确的指向
* '''每若干段'''内容都应有一个明确的主题，这一主题由这部分的标题指定。
** 标题一共有六级，最常用到的是前三级。
** 这些标题以树状的形式划定了整篇文章的内容结构。具体转化关系见右图（单击放大）。

浏览页面时，右侧随滚动变化的目录结构被称为 '''TOC（Table of Content，目录）'''它标记了读者当前所处的位置，并且可以让读者通过点选标题跳转到相应的位置，而这一功能优点的完整体现则需要依靠标题层级划分。

==== 规范 2：添加注释 ====
注释可以用于注明对外部内容的引用，即来源注释：

* 对于文章中引用的外部内容，无需像从前那样以「引用块」的形式呈现。
* 请对'''任何'''引用的内容添加来源注释，具体操作见可视化编辑器 -> 引用 -> 基本（Ctrl+Shift+K）。
** 在源代码编辑器中，请在引用文字的'''最后'''添加 <code><nowiki><ref>注释内容</ref></nowiki></code> 的标签，并确保在文章最后有 <code><nowiki><references/></nowiki></code> 标签。

亦可用于一般的解释性注释：

* 解释性注释的使用操作与来源注释相同。

一个引用的例子：这是一句被引用的话，它来自 https://wiki.oases.red<nowiki/>。<ref>这句话来自 https://wiki.oases.red 。</ref>

添加注释以后，再'''在页面底部添加以注释为标题的部分，并插入「参考文献列表」'''（在可视化编辑器中，单击插入 -> 更多 -> 参考文件列表）'''，这一步在创建新页面添加注释时不能遗漏。'''

==== 规范 3：添加空格 & 标准称呼 & 标准格式 ====
中西文混排时，为了使文章内容美观易读，字母数字和中文之间应该有一定的间隙。为了编写方便，这一空隙可以由空格来代替。对于一些名词，尤其是英文名词，请务必使用标准称呼，以便读者查阅相关信息。

以下是一些正误对比，请务必做到使用正确示例里的格式，这将对文章整体观感、行文水平评价和读者体验大有裨益。若一篇文章的不规范内容过多，且文章内容并非主要内容，此文章可能被管理员暂时隐藏（但不会被删除）。

* '''错误示例：'''在mc中一般每64.16个物品为1组，有些物品不能叠加
* '''正确示例：'''在 Minecraft 中，一般以每 64 个或者 16 个物品为一组，有些物品不能叠加。

* '''错误示例：'''遇到问题了?输入指令/help可以查看帮助，或者联系管理员寻求帮助
* '''正确示例：'''遇到了问题？可输入指令 <code>/help</code> 查看帮助，或者联系管理员寻求帮助。

* '''错误示例：'''请确保你的电脑有至少4g的内存和1g的储存空间，windows版本在7及以上。
* '''正确示例'''（使用列表形式）'''：'''
** 请确保你的电脑满足如下要求：
*** 物理内存：至少 4G（''或者表述为 >=4G 等''）
*** Windows 版本：7 及以上（''或者表述为 >=7 等''）

* '''错误示例：'''服务器的官网是www.oases.red，单击[https://oases.red 此处]打开。
* '''正确示例：'''服务器的官网是 https://oases.red 。

* '''错误示例：'''遇到这类问题时,请不要直接在群内提问.在提问的时候请带上相关的截图,配以详细的说明,因为只有这样大家才能更快更有效地解答你的问题.
* '''正确示例'''（不要把输入法设置为中文+半角符号的模式）'''：'''遇到这类问题时，请不要直接在群内模糊地提问——请带上相关的截图，配以详细的说明。只有这样，大家才能更快、更有效地解答你的问题。

* '''错误示例：'''在这个链接：https://baidu.com 下载你所需要的文件，解压即可。
* '''正确示例：'''在[https://baidu.com 此处]下载你所需要的文件，解压即可。

更多示例欢迎补充在此。

==== 规范 4：勿矫枉过正 ====
在编写 Wiki 的时候，首要需要注重的应该是内容的质量。至于上述格式方面的要求，可以在日常写作中逐渐锻炼，后期也可以进行修改和完善——而完全不需要在写文章时当作重心。

这是为了避免所谓的“规范”造成了许多阅读理解、排版方面的不便或者怪异。

=== 注释 ===
<references />