为了使 Wiki 的文章在整体上呈现出整齐且易于阅读的特征,本写作规范应运而生。在 Oasis Wiki 上开始编写时,请务必遵守基本规范,至于拓展规范则可由本人喜好决定。
基本规范
规范 1:善用标题、善于划定标题层级。
这有助于让文章结构更清晰,且易于读者标记和跳转。
- 每一段内容都应有一个明确的指向
- 每若干段内容都应有一个明确的主题,这一主题由这部分的标题指定。
- 标题一共有六级,最常用到的是前三级。
- 这些标题以树状的形式划定了整篇文章的内容结构。具体转化关系见右图(单击放大)。
浏览页面时,右侧随滚动变化的目录结构被称为 TOC(Table of Content,目录)它标记了读者当前所处的位置,并且可以让读者通过点选标题跳转到相应的位置,而这一功能优点的完整体现则需要依靠标题层级划分。
规范 2:添加注释
注释可以用于注明对外部内容的引用。我们对注释的使用要求如下:
- 注释的用途只有两个:
- 解释某一词或者某一句话。对于较长的解释内容,我们不建议在该词或者话后面用括号来表达,而是以注释的形式放在文尾。
- 标明引述来源。例如你可以将这句话的来源链接放在注释里。
- 请对任何从外部引用的内容添加来源注释。
以下操作不适用于移动设备。
要添加注释,请先将当前光标的位置指在要插入引用的词正后方,然后在可视化编辑器中单击上方的引用,点击「基本(Ctrl+Shift+K)」项,输入内容即可。
若要调整注释的位置,可以直接用鼠标将引用标识(即类似于 [1] 的数字)在文章中四处拖动后放置。
规范 3:在字母、数字和汉字之间留空
中西文混排时,为了使文章内容美观易读,字母数字和中文之间应该有一定的间隙。为了编写方便,这一空隙可以由空格来代替。对于一些名词,尤其是英文名词,请务必使用标准称呼,以便读者查阅相关信息。
- ✘ Sapherise珍奇店
- ✔ Sapherise 珍奇店
- ✘ 2023年1月22日
- ✔ 2023 年 1 月 22 日
规范 4:对文章进行分类
Wiki 上的内容组织大部分情况下均依赖于分类。没有分类的文章难以被读者以一般方式找到。因此,请务必给你的文章进行分类。
要添加分类,在可视化编辑器中点击右上角的三横线标志,单击「分类」项打开分类窗口。在「添加分类」的文本框中输入分类名即可添加。同一篇文章可以属于若干个分类,但应当至少有一个分类。
Wiki 上分类的种数是固定的,除非认为实在有必要,请不要在分类页面输入不存在的分类,导致创建不必要的新分类。创建新分类时,请务必在讨论群内向管理员沟通。
规范 5:正确使用语言
正确使用语言是指尽量避免用不必要的口语化或不标准的称呼去指代事物。下面是一些举例。
- 附魔的名称中,数字必须使用罗马数字。例如只能称呼为「耐久 III」,而不是「耐久3」或者「耐久三」。
- 对于 Minecraft 这一名称,适当情况[1]下可以使用 MC 的简称。
- 若要指代 Oasis 的运营团队,可以使用「管理组」、「运营团队」等称呼,但绝对不要用「Oasis 的 op 们」之类的称呼。
- 若要指代薄荷币,可使用「薄荷币」、「Mint」或者「M」等官方称呼,但是不能使用「薄荷」、「金币」、「游戏币」等称呼。
- 若要指代时间,请要么用 24 小时制,要么用 12 小时制,切勿混合[2]。
上面只是不完全的举例,具体有哪些语言需要规范使用,需要在实践中逐渐熟悉。请认真遵守此条内容。
规范 6:正常使用语言
下面的内容包含对部分玩家所提交内容的评价,请理性对待。无论质量如何,我们都应当给所有参与编写 Wiki 的玩家送上掌声!
通过各个编者对 Wiki 内容的编纂过程,我们了解到正确使用语言并不够,还需要正常使用语言。正常使用语言是指使用常人所能无障碍阅读的语言去指代事物。下面是一些举例。
a. 重复赘余
- ✘ 这不会对任何生物造成任何伤害[3]
- ✔ 这不会造成伤害
- ✔ 这不会对生物造成伤害
- ✔ 这不会对任何生物造成伤害
- ✔ 这不会对生物造成任何伤害
b. ???
- ✘ 在夜晚 12:00(即当日 24:00,次日 0:00)[4]
- ✔ 在 00:00
c. 不必要的论述
- ✘ 这个物品和另一个物品不一样,这个物品没有「不可破坏」标签而只有「耐久」标签,所以它会因为使用过多而导致损坏。[3]
- ✔ 不同于另一个物品,此物品不具有「不可破坏」属性,属于消耗品。
d. 机械语言
- ✘ 使用神秘空间祭品来提高进入神秘空间的概率,所有神秘空间祭品使用后效果持续 1 小时[5]
- ✔ 你可以使用神秘空间祭品来提高进入神秘空间的概率,效果持续 1 小时。
- ✔ 神秘空间祭品可以提高进入神秘空间的概率,效果持续 1 小时。
规范 7:不做复读机
请尽量避免复制粘贴已有的文本内容,即使这样做是有必要的。
- 若要引述已经存在的内容,请善用注释和链接等功能。
- 若确为模式化的句子,例如「提升至 2%」和「提升至 3%」,请尽量减少重复文本的长度。
例如新月花束和满月花束的介绍出现在了三个不同的页面,且内容完全相同。一般对于这样的情况,我们更建议对新月花束和满月花束这样的名词单独[6]或一起[7]创建新的页面
注释
- ↑ 例如前文已经提到了「Minecraft」,后文则可以使用 MC 这一简略的写法。
- ↑ 一个混合的例子「每天的 13:00 到晚上 9:00」。
- ↑ 3.0 3.1 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=%E7%A5%9E%E7%A7%98%E7%A9%BA%E9%97%B4&curid=129&diff=596&oldid=423
- ↑ 当各有各的特征且重叠度不高时。
- ↑ 符合某一共有特征,例如都是祭品等。只是举个例子。