Wiki写作格式规范：修订间差异

2023年1月22日 (日) 02:13的版本

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

基本规范

规范 1：善用标题、善于划定标题层级。

这有助于让文章结构更清晰，且易于读者标记和跳转。

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

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

规范 2：添加注释

注释可以用于注明对外部内容的引用。我们对注释的使用要求如下：

注释的用途只有两个：
- 解释某一词或者某一句话。对于较长的解释内容，我们不建议在该词或者话后面用括号来表达，而是以注释的形式放在文尾。
- 标明引述来源。例如你可以将这句话的来源链接放在注释里。
请对任何从外部引用的内容添加来源注释。

要添加注释，请先将当前光标的位置指在要插入引用的词正后方，然后在可视化编辑器中单击上方的引用，点击「基本（Ctrl+Shift+K）」项，输入内容即可。

若要调整注释的位置，可以直接用鼠标将引用标识（即类似于 [1] 的数字）在文章中四处拖动后放置。

规范 3：在字母、数字和汉字之间留空

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

✘ Sapherise珍奇店
✔ Sapherise 珍奇店

✘ 2023年1月22日
✔ 2023 年 1 月 22 日

规范 4：对文章进行分类

Wiki 上的内容组织大部分情况下均依赖于分类。没有分类的文章难以被读者以一般方式找到。因此，请务必给你的文章进行分类。

要添加分类，在可视化编辑器中点击右上角的三横线标志，单击「分类」项打开分类窗口。在「添加分类」的文本框中输入分类名即可添加。同一篇文章可以属于若干个分类，但应当至少有一个分类。

单击查看所有分类

规范 5：正确使用语言

正确使用语言是指尽量避免用不必要的口语化或不标准的称呼去指代事物。下面是一些举例。

附魔的名称中，数字必须使用罗马数字。例如只能称呼为「耐久 III」，而不是「耐久3」或者「耐久三」。
对于 Minecraft 这一名称，适当情况^[1]下可以使用 MC 的简称。
若要指代 Oasis 的运营团队，可以使用「管理组」、「运营团队」等称呼，但绝对不要用「Oasis 的 op 们」之类的称呼。
若要指代薄荷币，可使用「薄荷币」、「Mint」或者「M」等官方称呼，但是不能使用「薄荷」、「金币」、「游戏币」等称呼。
若要指代时间，请要么用 24 小时制，要么用 12 小时制，切勿混合^[2]。

上面只是不完全的举例，具体有哪些语言需要规范使用，需要在实践中逐渐熟悉。请认真遵守此条内容。

规范 6：正常使用语言

通过各个编者对 Wiki 内容的编纂过程，我们了解到正确使用语言并不够，还需要正常使用语言。正常使用语言是指使用常人所能无障碍阅读的语言去指代事物。下面是一些举例。

a. 重复赘余

✘ 这不会对任何生物造成任何伤害^[3]
✔ 这不会造成伤害
✔ 这不会对生物造成伤害
✔ 这不会对任何生物造成伤害
✔ 这不会对生物造成任何伤害

b. ？？？

✘ 在夜晚 12:00（即当日 24:00，次日 0:00）^[4]
✔ 在 00:00

c. 不必要的论述

✘ 这个物品和另一个物品不一样，这个物品没有「不可破坏」标签而只有「耐久」标签，所以它会因为使用过多而导致损坏。^[5]
✔ 不同于另一个物品，此物品不具有「不可破坏」属性，属于消耗品。

d. 机械语言

✘ 使用神秘空间祭品来提高进入神秘空间的概率，所有神秘空间祭品使用后效果持续 1 小时^[6]
✔ 你可以使用神秘空间祭品来提高进入神秘空间的概率，效果持续 1 小时。
✔ 神秘空间祭品可以提高进入神秘空间的概率，效果持续 1 小时。

规范 7：不做复读机

请尽量避免复制粘贴已有的文本内容，即使这样做是有必要的。

若要引述已经存在的内容，请善用注释和链接等功能。
若确为模式化的句子，例如「提升至 2%」和「提升至 3%」，请尽量减少重复文本的长度。

例如新月花束和满月花束的介绍出现在了三个不同的页面，且内容完全相同。一般对于这样的情况，我们更建议对新月花束和满月花束这样的名词单独^[7]或一起^[8]创建新的页面

注释

↑ 例如前文已经提到了「Minecraft」，后文则可以使用 MC 这一简略的写法。
↑ 一个混合的例子「每天的 13:00 到晚上 9:00」。
↑ https://wiki.oases.red/index.php?title=%E5%84%BF%E6%97%B6%E4%B9%90%E8%B6%A3&curid=87&diff=605&oldid=491
↑ https://wiki.oases.red/index.php?title=%E7%AD%BE%E5%88%B0%E7%B3%BB%E7%BB%9F&curid=92&diff=592&oldid=420
↑ https://wiki.oases.red/index.php?title=%E5%84%BF%E6%97%B6%E4%B9%90%E8%B6%A3&curid=87&diff=605&oldid=491
↑ https://wiki.oases.red/index.php?title=%E7%A5%9E%E7%A7%98%E7%A9%BA%E9%97%B4&curid=129&diff=596&oldid=423
↑ 当各有各的特征且重叠度不高时。
↑ 符合某一共有特征，例如都是祭品等。只是举个例子。

[1] 例如前文已经提到了「Minecraft」，后文则可以使用 MC 这一简略的写法。

[2] 一个混合的例子「每天的 13:00 到晚上 9:00」。

[3] ttps://wiki.oases.red/index.php?title=%E5%84%BF%E6%97%B6%E4%B9%90%E8%B6%A3&curid=87&diff=605&oldid=491

[4] ttps://wiki.oases.red/index.php?title=%E7%AD%BE%E5%88%B0%E7%B3%BB%E7%BB%9F&curid=92&diff=592&oldid=420

[5] ttps://wiki.oases.red/index.php?title=%E5%84%BF%E6%97%B6%E4%B9%90%E8%B6%A3&curid=87&diff=605&oldid=491

[6] ttps://wiki.oases.red/index.php?title=%E7%A5%9E%E7%A7%98%E7%A9%BA%E9%97%B4&curid=129&diff=596&oldid=423

[7] 当各有各的特征且重叠度不高时。

[8] 符合某一共有特征，例如都是祭品等。只是举个例子。

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

@@ 第15行： / 第15行： @@
 === 规范 2：添加注释 ===
-注释可以用于注明对外部内容的引用，即来源注释：
+'''注释'''可以用于注明对外部内容的引用。我们对注释的使用要求如下：
-* 对于文章中引用的外部内容，无需像从前那样以「引用块」的形式呈现。
+* 注释的用途只有两个：
-* 请对'''任何'''引用的内容添加来源注释，具体操作见可视化编辑器 -> 引用 -> 基本（Ctrl+Shift+K）。
+** 解释某一词或者某一句话。对于较长的解释内容，我们不建议在该词或者话后面用括号来表达，而是以注释的形式放在文尾。
-** 在源代码编辑器中，请在引用文字的'''最后'''添加 <code><nowiki><ref>注释内容</ref></nowiki></code> 的标签，并确保在文章最后有 <code><nowiki><references/></nowiki></code> 标签。
+** 标明引述来源。例如你可以将这句话的来源链接放在注释里。
+* 请对'''任何从外部引用的内容'''添加来源注释。
+{{helper-alert|text=以下操作不适用于移动设备。}}
-亦可用于一般的解释性注释：
+要添加注释，'''请先将当前光标的位置指在要插入引用的词正后方'''，然后在可视化编辑器中单击上方的'''引用'''，点击「基本（Ctrl+Shift+K）」项，输入内容即可。
-* 解释性注释的使用操作与来源注释相同。
+若要调整注释的位置，可以直接用鼠标将引用标识（即类似于 [1] 的数字）在文章中四处拖动后放置。
-一个引用的例子：这是一句被引用的话，它来自 https://wiki.oases.red<nowiki/>。<ref>这句话来自 https://wiki.oases.red 。</ref>
+=== 规范 3：在字母、数字和汉字之间留空 ===
+中西文混排时，为了使文章内容美观易读，字母数字和中文之间应该有一定的间隙。为了编写方便，这一空隙可以由空格来代替。对于一些名词，尤其是英文名词，请务必使用标准称呼，以便读者查阅相关信息。
+* ✘ Sapherise珍奇店
+* ✔ Sapherise 珍奇店
+* ✘ 2023年1月22日
+* ✔ 2023 年 1 月 22 日
+=== 规范 4：对文章进行分类 ===
+Wiki 上的内容组织'''大部分情况下均依赖于分类'''。没有分类的文章难以被读者以一般方式找到。因此，请务必给你的文章进行分类。
-添加注释以后，再'''在页面底部添加以注释为标题的部分，并插入「参考文献列表」'''（在可视化编辑器中，单击插入 -> 更多 -> 参考文件列表）'''，这一步在创建新页面添加注释时不能遗漏。'''
+要添加分类，在可视化编辑器中点击右上角的'''三横线'''标志，单击「分类」项打开分类窗口。在「添加分类」的文本框中输入分类名即可添加。同一篇文章可以属于若干个分类，但应当至少有一个分类。
-=== 规范 3：添加空格 & 标准称呼 & 标准格式 ===
+[https://wiki.oases.red/%E7%89%B9%E6%AE%8A:%E6%89%80%E6%9C%89%E9%A1%B5%E9%9D%A2?from=&to=&namespace=14 单击查看所有分类]
-中西文混排时，为了使文章内容美观易读，字母数字和中文之间应该有一定的间隙。为了编写方便，这一空隙可以由空格来代替。对于一些名词，尤其是英文名词，请务必使用标准称呼，以便读者查阅相关信息。
+{{helper-alert|text=Wiki 上分类的种数是固定的，除非认为实在有必要，请<b>不要</b>在分类页面输入不存在的分类，导致创建不必要的新分类。<u><b>创建新分类时，请务必在讨论群内向管理员沟通。</b></u>}}
+=== 规范 5：正确使用语言 ===
+正确使用语言是指尽量避免用''不必要的''口语化或不标准的称呼去指代事物。下面是一些举例。
+* 附魔的名称中，数字必须使用'''罗马数字'''。例如只能称呼为「耐久 III」，而不是「耐久3」或者「耐久三」。
+* 对于 Minecraft 这一名称，适当情况<ref>例如前文已经提到了「Minecraft」，后文则可以使用 MC 这一简略的写法。</ref>下可以使用 MC 的简称。
+* 若要指代 Oasis 的运营团队，可以使用「管理组」、「运营团队」等称呼，但'''绝对不要用「Oasis 的 op 们」之类的称呼。'''
+* 若要指代薄荷币，可使用「薄荷币」、「Mint」或者「M」等官方称呼，但是不能使用「薄荷」、「金币」、「游戏币」等称呼。
+* 若要指代时间，请要么用 24 小时制，要么用 12 小时制，切勿混合<ref>一个混合的例子「每天的 13:00 到晚上 9:00」。</ref>。
+上面只是'''不完全'''的举例，具体有哪些语言需要规范使用，需要在实践中逐渐熟悉。请认真遵守此条内容。
+=== 规范 6：正常使用语言 ===
+{{helper-info|text=下面的内容包含对部分玩家所提交内容的评价，请理性对待。无论质量如何，我们都应当给所有参与编写 Wiki 的玩家送上掌声！}}
+通过各个编者对 Wiki 内容的编纂过程，我们了解到正确使用语言并不够，还需要正常使用语言。正常使用语言是指使用常人所能无障碍阅读的语言去指代事物。下面是一些举例。
+'''a. 重复赘余'''
-以下是一些正误对比，请务必做到使用正确示例里的格式，这将对文章整体观感、行文水平评价和读者体验大有裨益。若一篇文章的不规范内容过多，且文章内容并非主要内容，此文章可能被管理员暂时隐藏（但不会被删除）。
+* ✘ 这不会对'''任何'''生物造成'''任何'''伤害<ref>https://wiki.oases.red/index.php?title=%E5%84%BF%E6%97%B6%E4%B9%90%E8%B6%A3&curid=87&diff=605&oldid=491</ref>
+* ✔ 这不会造成伤害
+* ✔ 这不会对生物造成伤害
+* ✔ 这不会对任何生物造成伤害
+* ✔ 这不会对生物造成任何伤害
-* '''错误示例：'''在mc中一般每64.16个物品为1组，有些物品不能叠加
+'''b. ？？？'''
-* '''正确示例：'''在 Minecraft 中，一般以每 64 个或者 16 个物品为一组，有些物品不能叠加。
-* '''错误示例：'''遇到问题了?输入指令/help可以查看帮助，或者联系管理员寻求帮助
+* ✘ 在夜晚 12:00（即当日 24:00，次日 0:00）<ref>https://wiki.oases.red/index.php?title=%E7%AD%BE%E5%88%B0%E7%B3%BB%E7%BB%9F&curid=92&diff=592&oldid=420</ref>
-* '''正确示例：'''遇到了问题？可输入指令 <code>/help</code> 查看帮助，或者联系管理员寻求帮助。
+* ✔ 在 00:00
-* '''错误示例：'''请确保你的电脑有至少4g的内存和1g的储存空间，windows版本在7及以上。
+'''c. 不必要的论述'''
-* '''正确示例'''（使用列表形式）'''：'''
-** 请确保你的电脑满足如下要求：
-*** 物理内存：至少 4G（''或者表述为 >=4G 等''）
-*** Windows 版本：7 及以上（''或者表述为 >=7 等''）
-* '''错误示例：'''服务器的官网是www.oases.red，单击[https://oases.red 此处]打开。
+* ✘ 这个物品和另一个物品不一样，这个物品没有「不可破坏」标签而只有「耐久」标签，所以它会因为使用过多而导致损坏。<ref>https://wiki.oases.red/index.php?title=%E5%84%BF%E6%97%B6%E4%B9%90%E8%B6%A3&curid=87&diff=605&oldid=491</ref>
-* '''正确示例：'''服务器的官网是 https://oases.red 。
+* ✔ 不同于另一个物品，此物品不具有「不可破坏」属性，属于消耗品。
-* '''错误示例：'''遇到这类问题时,请不要直接在群内提问.在提问的时候请带上相关的截图,配以详细的说明,因为只有这样大家才能更快更有效地解答你的问题.
+'''d. 机械语言'''
-* '''正确示例'''（不要把输入法设置为中文+半角符号的模式）'''：'''遇到这类问题时，请不要直接在群内模糊地提问——请带上相关的截图，配以详细的说明。只有这样，大家才能更快、更有效地解答你的问题。
-* '''错误示例：'''在这个链接：https://baidu.com 下载你所需要的文件，解压即可。
+* ✘ 使用神秘空间祭品来提高进入神秘空间的概率，所有神秘空间祭品使用后效果持续 1 小时<ref>https://wiki.oases.red/index.php?title=%E7%A5%9E%E7%A7%98%E7%A9%BA%E9%97%B4&curid=129&diff=596&oldid=423</ref>
-* '''正确示例：'''在[https://baidu.com 此处]下载你所需要的文件，解压即可。
+* ✔ '''你可以'''使用神秘空间祭品来提高进入神秘空间的概率，效果持续 1 小时。
+* ✔ '''神秘空间祭品可以'''提高进入神秘空间的概率，效果持续 1 小时。
-更多示例欢迎补充在此。
+=== 规范 7：不做复读机 ===
+请尽量避免复制粘贴已有的文本内容，即使这样做是有必要的。
-=== 规范 4：勿矫枉过正 ===
+* 若要引述已经存在的内容，请善用'''注释'''和'''链接'''等功能。
-在编写 Wiki 的时候，首要需要注重的应该是内容的质量。至于上述格式方面的要求，可以在日常写作中逐渐锻炼，后期也可以进行修改和完善——而完全不需要在写文章时当作重心。
+* 若确为模式化的句子，例如「提升至 2%」和「提升至 3%」，请尽量减少重复文本的长度。
-这是为了避免所谓的“规范”造成了许多阅读理解、排版方面的不便或者怪异。
+例如'''新月花束'''和'''满月花束'''的介绍出现在了三个不同的页面，且内容完全相同。一般对于这样的情况，我们更建议对新月花束和满月花束这样的名词单独<ref>当各有各的特征且重叠度不高时。</ref>或一起<ref>符合某一共有特征，例如都是祭品等。只是举个例子。</ref>创建新的页面
-=== 规范 5：善用分类系统 ===
-分类系统可以帮助信息聚合，使得读者能够对特定类别的内容定向浏览，从而节省寻找的时间。分类时，应当按其用途、特点、内容等方面在可选分类中主观划分。
-添加标签时，请先查阅'''目前支持的所有分类'''列表，再对照分类名添加分类。
 == 注释 ==
 <references />