此条目旨在提供一份为所有Minecraft Wiki条目遵守的综合的格式指导。在选择使用哪些格式规则上经常会有争议,而一部官方的格式指导有希望帮助解决这些争议,同时也能帮助大家达成共识。
虽然维基百科已经提供了一份更通用的格式指导,但专用于Minecraft的特殊指导方针是有必要的。同理,只有专用于Minecraft Wiki的指导方针和其基本的格式规则才会被收录在这里。如果有任何冲突,本页面的优先级永远高于本页面的子页面和维基百科的格式手册。
条目标题[]
条目应遵从基于其类型的常规命名格式。
- 关于游戏内方块,物品和实体等特性的条目应使用Java版游戏内译名。目前,这些译名由中文Minecraft Wiki管理团队管理。完整的译名列表可见此处。
- 关于人物的条目应该包含姓氏与名字,而不是他们的Minecraft或Twitter昵称。
- 消歧义条目在标题已被某条目使用时才应该包含“(消歧义)”。
- 若是以英文命名的条目,且条目类型未在此列出,则应选用句子型大写(第一个单词首字母大写)的最确切的标题,而不应用标题型大写(各单词首字母大写),除非其为一个特定的名词。
关于游戏版本条目标题的命名格式,请见版本#标题。
编写[]
由于本Wiki的目的是记录事实,您应该始终避免推测的与无来源的信息。一般来说,如果可以直接地在游戏或其他明显的地方被看到,这些信息就不需要来源。对于一些具体的游戏数据(例如某掉落物的掉落概率),请尽量从游戏代码中得到结论,而不是通过在游戏中进行实验测得。然而其他的信息,比如来自Mojang员工的引言和并不广为人知的信息,必须以适当的参考标明来源。{{citation needed}}
模板应被放置在任何需要来源的信息之后。不要在条目中加入你无法找到来源的内容。
在主命名空间的条目应该保持第三人称的口吻且不使用对读者来说需要参考的术语,但教程页面除外。也尽量尝试不使用缩略语。举例来说,“你不该靠近苦力怕,因为他们会爆炸然后把你杀掉。”应该写成“玩家不应该与苦力怕靠的太近,因为它们会爆炸,并有杀死玩家的可能。”
强调重点时应该用粗体,而不能用斜体。
教程信息,包括对方块或纹理的延伸特性,应只写在教程条目。如果有重要关系,教程条目被主要条目链接。
Mod信息不应包含在与Mod无关的条目。Mod条目也不能从与Mod无关的条目链接。
通常情况下,中国版独有特性应该只收录于中国版页面中。中国版的原版游戏与国际版相比可能会有微小的差异,但这类微小的差异不应写入页面。
译名[]
在编写条目过程中使用标准译名时应当遵循此原则。
保持条目的简明与更新[]
- 快捷方式
- MCW:更新
简单来说,条目应该只包含最新的信息,即在最新的“完整”游戏版本所呈现的内容。任何的过期内容应该移动到条目的历史段落。当有更改时,应在历史段落中记录并移除条目其他段落中的过期信息。提及某一特定的特性在何时实现并不必要;这个特性也应当保留于条目的历史段落。例如这样的句子:“交易,实现于1.3.1,是一种允许玩家通过交换绿宝石(此前是红宝石)来获取其他物品的特性。”应当写成“交易是一种允许玩家通过交换绿宝石来获取其他物品的特性。”
这里有一个不好的条目编写的示范,使用的是原木条目之前的版本。这段是完整的介绍内容。用黄色高亮的是多余内容,而红色的是历史内容。
原木(Log)(旧称木头(Wood)),是一种首次出现于Minecraft创造模式0.0.14a的方块。它们的四个侧面有类似树皮的外表,顶面和底面则是横切面。在Beta 1.2与所有之前的版本中,只有普通橡树原木能在区块中生成,而松树与白桦将生成于更新一些的区块中。作为树的组成,原木在自然生成的地图中非常丰富。原木可以用手挖下,但使用斧会更快。原木也是可燃的。
在现有的原木中,白桦是最稀有的品种。原木、木头常用于组成植物,树和木屋。在生存测试中,原木挖掘后掉落3 - 5个木板。而在Indev、Infdev、Alpha和Beta挖掘原木会则掉落一个原木。这使得原木可以作为建筑材料,也能合成出木板。
原木唯一的合成用途是制作成4个木板。另外,原木可以在熔炉中烧制来制作煤炭的替代品木炭。
自2011年1月13日更新的Beta 1.2以来,总共有四种原木。一种是普通的原木(橡木),另一种像白桦,还有一种像普通原木,但更黑且出现在生长于寒冷生物群系的松/针叶树,第四种与橡木相似,但颜色稍有不同且斜向一边。这些原木方块依旧可以通过合成制作4个木板。不同种类的原木在物品栏里不会堆叠,但是木板可以。由不同种类的原木做成的木板完全相同。白桦的叶子比一般的叶子略微暗淡,松树有松针,丛林木树叶茂密且有水果样的花纹。
第四种原木加入于快照12w03a,只生长在丛林生物群系,组成它们专属类型的树。最高的树使用这种类型的原木,尺寸为2x2而不是通常的1x1。这部分的问题是陈旧信息散布于新信息中。介绍应该陈述方块在最新发布版本的当前内容。历史信息是好的,但为清晰起见,这些信息应该按时间顺序写在单独的地方:条目的历史段落。
未来[]
- 快捷方式
- MCW:未来
在未来更新中加入的内容应加入到条目的主内容中,被写入的特性要用{{upcoming}}
标记且是在预览版本中出现过的。如果更新包含相关条目的巨大更改,那么这些内容应在主段落中作为一个子段落提及,或是放在一个名为“即将到来”的专有段落。即将到来的特性必须同时在“历史”段落,使用特定的“即将到来”的标头提及。
更新发布后,所有过期的内容都需要移动到历史段落或移除,且所有使用的{{upcoming}}
模板都应被移除。
引用[]
所有引用的内容应当和原文完全一致。引文中需要额外添加的内容应当以方括号[]标出。如果原文存在错误,则引用时应当在出错处用{{sic}}
标注。
段落等级[]
页面主段落应以二级标题开始(两个等号),每一子段落增加一级。永远不要使用一级标题(一个等号)。
段落之间应有一个空格,等号与段落名称也应有一个空格以方便编辑。如果使用了“主条目”链接或缩略图,将其直接放在段落标题之下,然后在开始段落内容之前,接着输入一个空格。
关于段落次序的信息,参见本格式指导的页面布局段落。
斜体[]
中文和英文的斜体使用方式有所差异。在本Wiki中,斜体的使用规范如下:
- 一般情况下,任何中文内容都不应使用斜体。
- 强调内容时可以适当使用粗体;包含中文的书籍、电影等作品名称应使用书名号“《》”标记。
- 只包含英文的作品名可以使用斜体,如Minecraft: The Voyage。在英文句子中强调内容时,也可以使用斜体。
- 正文中的Minecraft及其衍生作品是仅有的例外,不应使用斜体。
- 其他情况下,英文内容都不应使用斜体。
- 在计算公式等特殊内容中,可以适当使用斜体标记参数。
另外,有时为了防止机器人在批量替换文本时破坏模板参数,部分正文内容也会使用斜体标记。这类标记会在文本替换完成后由机器人自动去除。
英文内容[]
条目正文内除开头的关键词外,一般不应出现英文。关键词的英文应当遵循游戏内美式英语名称(如有)或常规的美式英语拼写。含有大段英文内容的条目应当移动至沙盒或直接在沙盒创建,翻译为中文后再移动到主命名空间下。
图像[]
- 快捷方式
- MCW:图像
往页面中加入的图像应展现页面主题的一种属性。图像介绍应精简到一句话以内,但图像内容足够复杂、说明清楚需要超过一句话的除外。即使图像介绍的说明文字较长,其中靠前的语句已出现句号,介绍末尾也不应有句号。
一般情况下,图像应展示包含描述内容的最新版本Minecraft,如果过期则建议上传新版本,或将其移除。
不应上传单纯的游戏纹理图像,除非图像具有其他作用。
二次上传英文Wiki的图像时应当使用原图,而不是低分辨率的版本。
尽管不是必须的,但是为了方便查证,建议上传截图时在文件说明中注明游戏版本、地图种子、坐标等必要信息。
{{BlockLink}}
、{{ItemLink}}
等含“精灵图”的链接模板用于向读者展示游戏中某种物品、生物等的具体特征。正文的文本段落内通常不应使用各种含精灵图的模板,但教程页面除外,因为查看教程的新手不一定知悉提及的物品在游戏中的样貌。精灵图的前面不需要添加空格。
当往页面加入屏幕截图时,确保截图用的是原版纹理与UI。使用定制纹理包、UI模组与其他定制内容的屏幕截图是不被允许的,但关于资源包和模组的页面除外。
为清楚显示截图内容,除非目的是展示平视显示器(HUD)相关内容,否则需要隐藏HUD(可通过按F1切换隐藏)。
对于首页每周页面所用到的图像而言,请使用游戏内截图而不是标准视图,且应当注意该图像内容与介绍内容的相关性。
链接[]
- 快捷方式
- MCW:链接
链接缺失会使读者困惑,因为可能会出现一些只能通过搜索选项或其他说明来源的关于页面内容的问题,这些问题会打断并干扰读者。
链接过多可能会干扰读者,因为链接常使用不同颜色来吸引眼球。此外,如果同一个词在同一个段落被多次使用链接,会使读者产生这些链接是否指向不同页面的疑问。
链接的指导方针如下:
- 单个页面用于链接的词不能超过10%。
- 链接的文本应当描述其链向的页面或这个链接的具体功能,而不能使用“此”“这里”或“点击此处”等完全不包含链接目标内容的文本。
- 除非对句子的词语组成或可读性产生不利影响,两个链接不能紧挨在一起,以致看起来像单个链接。
- 任何单一术语的链接不能在同一页面多余地重复创建。多余链接的定义是在某行或某自然段对同一术语创建多次,使其在读者屏幕上总会不必要地出现。记住,链接的目的是在读者需要更多信息,而要临时绕道时,引导他们到一个新的地方。
- 在页面中离上一次出现有一定距离的地方重复创建重要链接应是很合适的。如果一个重要术语在一个长页面中多次出现,但只在页面最开头的地方用了链接,就应当用下划线标明。也就是说,带着兴趣直接跳转到一个子段落的读者必须依然能找到一个链接。需要注意的是,重复链接的距离实际上取决于编辑者的喜好,在认定和处理这类问题时需要注意;不过如果存疑,那就在更远的地方重复。
要链接到一个页面,链接到重定向页一般比使用管道链接更好(例如使用[[白桦原木]]
而非[[原木|白桦原木]]
),下列情形除外:
- 链接位于模板或其他可能会被嵌入的页面,如使用重定向页会导致链接正常显示且实际指向自身的;
- 指向只记载单一版本的版本页面的链接:
- 如果目标页面是带有版本前缀的页面,即便有重定向页指向此页面,也不应链接到此重定向页,而应使用管道链接链接到原始页面。
- 如果目标页面不带有任何版本前缀,则直接链接到此页面。
无论何种情况,只要使用管道链接,其目标页面就不应为重定向页,而应为重定向页面所指向的页面。
坐标[]
游戏内的单个坐标应当大写,并且不需要添加空格(即“Y=1”而不是“y=1”或“y = 1”)。体积标识应当按照X、Y、Z的顺序写出,中间使用乘号(“×”,×
)隔开;例如,“4×3×2”表示一个沿X轴4格、Y轴(竖直方向)3格、Z轴2格的区域。更深入的坐标表示正在讨论中。
命令[]
命令格式应当严格遵循游戏内的提示。
Java版[]
需要按原样输入的内容(字面量)没有其他任何修饰(如/data merge
)。需要以合适的值替换输入的内容(变量)使用尖括号标注(如<target>
)。可选的内容以方括号标注,但方括号不能取代其他标注(例如,[<size>]
是可选的变量,而[size]
是可选的字面量)。必须从一组字面量中选择一个输入的内容用圆括号标注,以管道符分隔(如(eyes|feet)
)。可选的从一组字面量中选择一个输入的内容用方括号标注,以管道符分隔(如[destroy|replace|keep]
)。
以/advancement (grant|revoke) <targets> only <advancement> [<criterion>]
为例,/advancement
和only
是需要原样输入的字面量,(grant|revoke)
是需要从grant
和revoke
中选择一个输入的字面量,<targets>
和<advancement>
是必需的以合适值替换的变量,[<criterion>]
是可选的以合适值替换的变量。
基岩版[]
你可以帮助我们加入信息。
文件[]
- 快捷方式
- MCW:文件
命名[]
文件的名称应当简洁,且能表明文件的内容。需要注意:
- 不应该只用日期来给文件命名(这经常发生在截图上,请修改文件名)。
- 文件名不应该包含中文字符。
- 全角符号也被视为中文字符,请在上传时改为半角。
- 文件名不能是无意义的字母、数字和符号的组合,或者是
image
、picture
和photo
等无具体含义的单词。 - 文件名也不应该包含“px”之类的尺寸说明。
- 除了一些特殊文件另有用途外,请勿上传Grid开头的图标,这些图像统一收集在“小精灵”图像中。
- 确保文件名中没有多余的空格。
- 文件后缀名一律小写。
Infobox内的图像名称必须和游戏内英文名称一致,且应当是等轴视图。随着游戏的更新,这类图像往往会产生多个修订版本,为方便起见及保持名称的一致性,这类文件的各纹理版本命名格式及使用要求如下:
- 以
<特性名称> JEm BEn.png
为格式统一命名。- “m”和“n”是此纹理在对应Java版或基岩版中更新的次数(从1开始),随纹理的更新而递增。
- 将
<特性名称>.png
作为重定向指向游戏最新正式版中使用的修订版本,并应用在Infobox中。- 例如,
File:Grass Block.png
是一个重定向,指向最新正式版中使用的纹理File:Grass Block JEm BEn.png
。 - 若游戏开发版本使用了原有游戏内容的新纹理,应待其所属的正式版本发布后再将该重定向指向新纹理。
- 对于游戏开发版本加入的新内容,该重定向应指向最新开发版本当中使用的纹理。
- 例如,
- 需要额外注明其他特征的,文件名应当遵循
<特性名称> (<特征>) JEm BEn.png
的形式。- 其中
<特征>
部分一般应小写,例如Oak Door (item) JEm BEn.png
。
- 其中
繁简字词转换[]
如图像含有大量需要繁简字词转换的内容,应当单独上传适用于各自地区的版本,文件描述内通过{{Other translation files}}
相互注明其他地区,并加入分类Category:汉化图像。为方便起见及保持名称的一致性,这类文件的各地区版本命名格式为<图像原名称> Simplified.png
、<图像原名称> Traditional.png
和<图像原名称> Traditional HK.png
,其中Simplified
代表内含大陆简体的图像、Traditional
代表内含台灣正體的图像、Traditional HK
代表内含香港繁體的图像,并建立<图像原名称>.png
到<图像原名称> Simplified.png
的重定向。
格式[]
不应上传webp格式的文件,因为这类文件通常是被浏览器自动转换得到的,原始格式即为webp的除外。
页面布局[]
出于一致性的目的,特定类型的所有页面都应遵循此常规布局。一般条目从上往下分别是:
- Hatnote(顶注);
- Message box(消息框);
- Infobox(信息框);
- 关于条目的简要介绍;
- 条目主体部分;
- 另见/另请参阅;
- 注释和参考;
- 合适的底部导航;
- 分类;
- 跨语言链接。
条目顶部内不应有过多的消息框。必要的时候,请将消息框移动至与其最相关的段落顶部。
特定类型的布局[]
如果页面目前尚未拥有布局,可以在讨论页中提出;否则,就尝试使用与已存在的布局格式相近的布局。目前页面的布局包括:
Wiki帮助 | |
---|---|
页面规范 | |
常用页面 | |
社交媒体 |
语言