Minecraft基岩版开发Wiki:格式指导

此条目旨在提供一份为所有Minecraft Wiki条目遵守的综合的格式指导。 在选择使用哪些格式规则上经常会有争议，而一部官方的格式指导有希望帮助解决这些争议，同时也能帮助大家达成共识。

虽然维基百科已经提供了一份更通用的格式指导，但专用于Minecraft基岩版开发的特殊指导方针是有必要的。同理，只有专用于Minecraft基岩版开发Wiki的指导方针和其基本的格式规则才会被收录在这里。

语法

  关于简短的Wikitext介绍，请见“Minecraft Wiki:Wikitext语法”。

本Wiki首要采用Wikitext语言进行撰写，必要时才可以加入HTML标记。如果滥用HTML语言标记，你的编辑可能会被回退。

关注度

当前本Wiki的内容页面包括主命名空间和Manual命名空间，前者放置常规内容，后者放置开发手册与教程。如果你创建了一个一级页面，但内容过于详细，我们可能会要求你拆分该页面到多个子页面。

只有符合以下准则的条目可以放在内容页面上。不符合准则的条目可能会在未通知的情况下被删除。

常规

1. 主命名空间的介绍主体必须是一个专有名词。Minecraft基岩版开发Wiki命名空间存放本Wiki的政策性内容、计划内容和新闻报内容等以整个Wiki性质运作的内容，Help命名空间存放对本Wiki使用的指导和教程相关内容。Manual存放对非专有名词主体的介绍、非本Wiki使用相关的教程等指导性内容。特别的，除了[[模组]]页面本身，所有模组相关内容皆应存放在Mod命名空间，所有文档性质的内容皆应存放在Documentation命名空间。
2. 条目必须包含足够的信息以支撑一个完整的条目。如果它们没有足够的内容，就会被合并到其他相应的条目。
3. 条目必须在某种程度上直接涉及Minecraft基岩版。
4. 关于人物的条目只允许此人物是与Minecraft基岩版相关的开发者。
5. 可以在Manual命名空间创建关于Minecraft基岩版及其他软件版本的条目，每个版本都应该创建单独的条目。
   1. 可以创建关于未发布版本的条目，前提是有证明未发布版本存在的显著信息来源。
6. 请勿在主命名空间创建关于特定函数、模块、组件等的介绍内容，请把他们放在Manual命名空间中。

社区内容

1. 游戏开发相关的教程等应作为Manual命名空间的子条目，并将链接放置在教程页面中。

Wiki条例

6. 忠于事实——不要在编辑页面时对内容进行恶搞、讽刺、扯淡、二次创作、夹带私货以免误导新玩家。

7. 禁止创建广告页面，用户页除外。

以下条目由于关注度原则，不会被收录：

1. 与Minecraft基岩版无关的内容，比如Java版独占的相关内容。
   1. 他们应该收录于Minecraft官方Wiki。
2. 与开发无关的内容，如“一块原木可以合成4块木板”。
   1. 他们应该收录于Minecraft官方Wiki。

在“User”名字空间的条目是关注度指导的例外。这些条目可以在遵守相关Wiki条例的条件下作任意用途。

重定向

重定向条目有特别的关注度原则，且其必须重定向到一个符合关注度指导的条目。如果重定向到另一个Wiki，必须使用软重定向{{soft redirect}}。原版物品、方块、生物等的名称应该被重定向到Manual命名空间中的Manual:minecraft:xxx条目中。重定向条目在符合以下条件之一时可被创建：

1. 属于替代或缩写的名称，而此名称被广泛使用，例如“栓绳”之于“拴绳”。曾用于游戏中的名称也是允许的。
   1. 也包括其他中文书写系统中的名称。
   2. 错误拼写、笔误、非正规的格式和粗俗内容是被不允许的。
2. 属于曾用的条目标题，包括被移动到其他Wiki的条目，例如“流髑”之于“流浪者”。
3. 属于合并或杂项条目的一部分，例如一种药水、一种提及特性或同一启动器版本在不同平台上的版本号。

一个页面的重定向数量需在合理范围内。重定向条目的目标不能是不存在的条目或另一个重定向条目。

“User”命名空间下的条目可以重定向到任意位置，但仍需遵守上述原则。

条目标题

条目应遵从基于其类型的常规命名格式。

• 关于游戏内方块，物品和实体等特性的条目应使用Java版游戏内译名。目前，这些译名由中文Minecraft Wiki管理团队管理。完整的译名列表可见此处。
  • 基岩版的译名质量差，不值得使用。
  • 如Minecraft官方Wiki中有对应页面，请使用Minecraft官方Wiki使用的译名。
  • 如果某特性尚无确定的中文译名，则使用其英文名称作为占位，其相应条目的编辑应一律在公共沙盒中进行。待中文名称确定后，再将条目移动至相应的中文名称处（不留重定向）。
• 消歧义条目在标题已被某条目使用时才应该包含“(消歧义)”，“(消歧义)”与条目中心词之间要加一个空格“ ”。
• 若是以英文命名的条目，且条目类型未在此列出，则应选用句子型大写（第一个单词首字母大写）的最确切的标题，而不应用标题型大写（各单词首字母大写），除非其为一个特定的专有名词。

命名语言

• 内容页面（目前包括主命名空间、Manual、Help、Mineprogramming、Minecraft基岩版开发Wiki、Mod和Documentation命名空间）及其讨论页请以正确的中文名命名。
• 其余页面请务必以英文名命名，这包括但不限于模板、模块、消息、小工具、小部件、文件（媒体）的名字以及他们内容中的所有参数的名字。这是由于本站是一个中文Wiki而非简体中文或繁体中文或任何一个变种的单一语言Wiki，如此命名有助于所有使用中文的用户能够更加方便地编辑。

编写

参见：MCWZH:Help:官方资源

由于本Wiki的目的是记录事实，您应该始终避免推测的与无来源的信息。一般来说，如果可以直接地在游戏或其他明显的地方被看到，这些信息就不需要来源。然而其他的信息，比如来自Mojang员工的引言和并不广为人知的信息，必须以适当的参考标明来源。{{citation needed}}模板应被放置在任何需要来源的信息之后。不要在条目中加入你无法找到来源的内容。

在主名字空间的条目应该保持第三人称的口吻且不使用对读者来说需要参考的术语，但教程页面除外。也尽量尝试不使用缩略语。举例来说，“你不该靠近苦力怕，因为他们会爆炸然后把你杀掉。”应该写成“玩家不应该与苦力怕靠的太近，因为它们会爆炸，并有杀死玩家的可能。”

强调重点时应该用粗体，而不能用斜体。

教程信息，包括对方块或材质的延伸特性，应只写在Manual命名空间下。如果有重要关系，教程条目被主要条目链接。

未来

在未来更新中加入的内容应加入到条目的主内容中，被写入的特性要用{{upcoming}}标记且是在测试版中出现过的。如果更新包含相关条目的巨大更改，那么这些内容应在主段落中作为一个子段落提及，或是放在一个名为“即将到来”的专有段落。即将到来的特性必须同时在“历史”段落，使用特定的“即将到来”的标头提及。

更新发布后，所有过期的内容都需要移动到历史段落或移除，且所有使用的{{upcoming}}模板都应被移除。

英语语法

Wiki上的条目应使用美式英语，除非游戏中名称是英式英语。例如，“colour”应为“color”，而“centre”应为“center”。

英文使用

中文Wiki仅在一个条目的核心词第一次出现时在括号给出其英文名称。如果某特性更改了其英文名称，而中文名称不变，则在相应的历史段落内说明。

段落等级

页面主段落应以二级标题开始（两个等号==），每一子段落增加一级，除非使用了__NOTITLE__。

段落之间应有一个空格，等号与段落名称也应有一个空格以方便编辑。如果使用了“主条目”链接或缩略图，将其直接放在段落标题之下，然后在开始段落内容之前，接着输入一个空格。

关于段落次序的信息，参见本格式指导的页面布局段落。

斜体

中文和英文的斜体使用方式有所差异。在本Wiki中，斜体的使用规范如下：

• 一般情况下，任何中文内容都不应使用斜体标记。
  • 强调内容时可以适当使用粗体标记，包含中文的书籍、电影等作品名称应使用书名号“《》”标记。
• 只包含英文的书籍、音乐等作品名可以使用斜体标记，如Minecraft: The Voyage。在英文句子中强调内容时，也可以使用斜体标记。
  • 软件、模组等名称为例外，不应使用斜体标记。
  • 其他情况下，英文内容都不应使用斜体。
• 在计算公式和命令等特殊内容中，可以适当使用斜体标记参数。

另外，有时为了防止机器人在批量替换文本时破坏模板参数，部分正文内容也会使用斜体标记。这类标记会在文本替换完成后由机器人自动去除。

图像

当往页面加入屏幕截图时，确保截图用的是软件原版材质与UI。

图像介绍末尾不应有句号，除非语句是一个完整的句子。

往页面中加入的图像应符合以下指导方针：

• 图像应展现页面主题的一种属性。
  • 图像不应出现无意的怪异或搞笑之类的行为，例如生物“坐在”楼梯上。
  • 图像不应只有展示漏洞的目的，而漏洞应到官方追踪器报告。
  • 图像应避免展示具体特性的装饰用途。
• 页面应只用一张图片展示页面内容的某一项独立属性。例如，一只僵尸穿着盔甲。
• 图像应展示包含描述内容的最新版本的Minecraft。
  • 图像如果过期则应被移除。

链接

  关于完整的链接指导，请见“Wikipedia:链接格式守则”。

对链接的使用是在为读者提供使其能流畅阅读页面的足够实用链接与干扰到阅读流的多余连接之间的艰难平衡。

链接缺失会使读者困惑，因为可能会出现一些只能通过搜索选项或其他说明来源的关于页面内容的问题，这些问题会打断并干扰读者。

链接过多可能会干扰读者，因为链接常使用不同颜色来吸引眼球。此外，如果同一个词在同一个段落被多次使用链接，会使读者产生这些链接是否指向不同页面的疑问。

链接的指导方针如下：

• 单个页面用于链接的词不能超过10%。

• 除非对句子的词语组成或可读性产生不利影响，两个链接不能紧挨在一起，以致看起来像单个链接。

• 任何单一术语的链接不能在同一页面多余地重复创建。多余链接的定义是在某行或某自然段对同一术语创建多次，使其在读者屏幕上总会不必要地出现。记住，链接的目的是在读者需要更多信息，而要临时绕道时，引导他们到一个新的地方。

• 在页面中离上一次出现有一定距离的地方重复创建重要链接应是很合适的。如果一个重要术语在一个长页面中多次出现，但只在页面最开头的地方用了链接，就应当用下划线标明。确实，带着兴趣直接跳转到一个子段落的读者必须依然能找到一个链接。但对于这种问题要小心对待，重复链接的距离关乎编辑者的喜好，然而如果存疑那就在更远的地方重复。

链接到重定向页比用管道链接更好，除非是在模板和其他可能会被引用的页面。如果无法避免使用管道链接，就不应将其指向重定向页。举例：请用[[白桦原木]]而不是[[原木|白桦原木]]。

样式与代码

如果需要对一段文本使用等宽字体，请使用{{code}}或{{samp}}。二者的使用上下文有所不同。

• 一个函数名、变量名、文件名、域名等作为一个物体或概念的名称引用时，请使用{{samp}}，例如query.any_tag或options.txt。
• 对应的，一段代码、文件路径、URL等在需要强调的同时包含一定逻辑或模式的文本，请使用{{code}}，例如query.any_tag();或minecraftpe/options.txt。

特别地

用户需要注意有些容易混淆的情况。以一个物品定义JSON文件中的路径为例，当需要强调在minecraft:item对象下的description对象下的identifier字段时，如果需要强调路径本身，请使用{{code}}，即minecraft:item/description/identifier，如果需要强调“identifier字段是一个位于minecraft:item对象下的description对象下的字段”这一件事，即主强调对象依旧是identifier时，请使用{{samp}}，即minecraft:item/description/identifier。例句：minecraft:item/description/identifier字段的路径是minecraft:item/description/identifier。

文件

文件的名称应当简洁，且能表明文件的内容。需要注意：

• 不应该只用日期来给文件命名（这经常发生在截图上，请修改文件名）。
• 文件名不应该包含中文字符。
  • 全角符号也被视为中文字符，请在上传时改为半角。
• 文件名不能是无意义的字母、数字和符号的组合。
• 文件名也不应该包含“px”之类的尺寸说明。
• 确保文件名中没有多余的空格。
• 文件后缀名一律小写。

Infobox内的图像名称必须和游戏内英文名称一致，且应当是等轴视图。

页面布局

出于一致性的目的，特定类型的所有页面都应遵循此常规布局。一般条目从上往下分别是：

1. Pagenav（导航）；
2. Hatnote（顶注）；
3. Message box（消息框）；
4. Infobox（信息框）；
5. 关于条目的简要介绍；
6. 条目主体部分；
7. 另见/另请参阅；
8. 注释和参考；
9. 合适的底部导航；
10. 分类；
11. 跨语言链接。

条目顶部内不应有过多的消息框。必要的时候，请将消息框移动至与其最相关的段落顶部。

如果页面目前尚未拥有布局，可以在讨论页中提出；否则，就尝试使用与已存在的布局格式相近的布局。目前页面的布局包括：

• 软件类
• 手册类
• 版本类

删除页面

为了防止出现孤立页面，请勿直接清空一个页面，而应当在页面顶部使用{{delete}}模板提示管理员或巡查员删除此页面。使用了此模板的页面会加入到Category:等待删除分类中。