样式指南
快速上手 | 导航 | 创建新页面 | 如何贡献 |
图片 | 表格 | 样式手册 | 翻译页面 |
本页面将提供编辑僵毁 wiki 时遵循的一般样式指南。维基百科有一个很好的通用样式指南,因此本页面只包含特定于僵毁 wiki 的规则和指南。wiki 的目的是记录事实,因此您应避免发表意见和推测性信息。
如果您有任何疑问、建议或投诉,请在讨论页上留言。请不要在没有与他人达成共识的情况下引入或更改本页面的指南。
页面标题
所有页面都需要一个合适的标题。
- 关于物品、地块、地点和其他游戏机制的页面应该尽量以游戏中的名称命名。
- 这包括但不限于大小写、拼写错误和英式英语与美式英语的差异(游戏默认语言为美式英语)。
- 这不包括指向多个物品的页面,尽管应该尽可能接近游戏中的物品名称,并为每个物品创建合适的重定向。
- 关于游戏角色的页面应该包含他们的名字和姓氏,而不是他们的昵称。例如,页面名应为 Bob Smith 而不是 Bob 或 Baldspot。
- 当然,应该为这些昵称创建合适的重定向。
- 例外情况是如果不知道全名,那么只需要知道名字或姓氏的其中一个作为页面名,否则采用昵称。
- 如果出现相同标题的多个物品,可以使用括号来表示其类型,并创建消歧义页面,例如水瓶(无歧义)。
重定向
如果满足以下任何一个条件,即可创建重定向页面:
- 是以前的游戏名称,例如“Empty Sand Bag”(Sack)。
- 是标题的其他拼写,例如“Duffelbag”(Duffel Bag)。
- 标题的其他大小写或形式,例如“Baseball bat”(Baseball Bat)。
- 非英语标题重定向到子页面,例如“Кастрюля”(Cooking Pot/ru)。有关详细信息,请参阅下面的翻译部分。
翻译
- 默认语言是英语,因此所有页面都应该有一个英语版本,然后从英语翻译到所需的语言。
- 物品、地块、地点和其他游戏机制的名称应该根据游戏内的官方翻译进行翻译。
- 除英语以外的其他语言页面应该是英语版本的子页面,语言代码为
/fr
(法语)等,而不是译名,例如 Items/fr 而不是 Objets(后者应该是重定向)。- 显示的页面标题可以通过在页面中添加
{{DISPLAYTITLE:Objets}}
来更改。将Objets
替换为您希望显示的页面标题。
- 显示的页面标题可以通过在页面中添加
简体中文翻译样式
本wiki的简体中文翻译样式大体遵循中文编写指南。包括:
- 空格
- 中英文之间添加空格
- 中文与数字间添加空格
- 数字与单位间添加空格
- 全角标点与非中文字符间不添加空格
- 全角与半角
- 使用全角中文标点
- 完整英文语句或特殊单词中采用英文标点
- 链接
- 中文链接与普通文本间不添加空格
编写
我们要求维护一个标准的写作风格,以便保证阅读和页面之间的一致性。
- 页面外的指南部分应该不直接提到读者。
- 应避免使用缩写。
- 应该通过斜体来强调,而不是
粗体或大写。 - 如果可能的话,请尽量校对自己的文章。
- 错误
不要将发电机放在房子里。发电机会因为排气而迅速降低你的健康。如果你碰巧这样做了,尽快到外面去停止损坏,但是在发电机关闭之前,房子是不安全的。- 正确
- 玩家不应该将发电机放在房子里,因为它会因为排气而迅速降低角色的健康。如果玩家碰巧这样做了,那么到外面去就会停止受到伤害,但是在发电机关闭之前,房子是不安全的。
- 关于修改的信息不应该是文章的一部分,除非文章本身就是关于修改的。
- 尽可能使用美式英语。虽然核心 The Indie Stone 开发者来自英国,一些旧的或内部的物品名称仍然可以是英式英语,但游戏发生在美国,美式英语被选择为游戏和 wiki 的默认语言。
- 此 wiki 也有一点偏爱牛津拼写法(-ize 后缀)和牛津(串行)逗号,尽管这并不是严格要求的。
大小写
首选代码样式
虽然不是强制要求的,但是有一个首选的代码样式,用于 wikitext 和一些 HTML/CSS 元素,这些元素在其他 wiki 中可能不同。
这些偏好还没有最终确定,可能会在未来发生变化,但是在这里列出,以避免不必要的更改和可能的编辑战争。如果您认为有什么不对,或者想讨论,可以在讨论页上自由讨论,或者在官方 The Indie Stone Discord 服务器的 #pzwiki_editing 频道与管理员和其他编辑者交谈。
以下是关于 wikitext 的当前偏好列表——这些更改有时可能会单独进行,也可能会与其他更改一起进行,或者由一些机器人自动完成。
- 等号(
=
)和标题之间,以及列表符号(例如*
或#
)之间的空格目前被省略,但是默认工具(文件上传的摘要和目前的编辑工具栏)会添加它们。 - 在下一个标题之前,每个段落后面都会添加一个额外的新行,但是在标题正下方不会添加额外的新行。
- 如果两个标题直接在彼此下方,则它们之间不会添加新行。
- 大写字母应该用于模板(
{{Templates}}
)和链接([[Links]]
)中,包括外部链接([[Interwiki:]]
),例如[[Wikipedia:]]
,除非它是像[[Mw:]]
这样的缩写形式或在文本中可见的链接,参见大小写部分。 - 每个模板都应添加在新行中,这对于页面的标题显示最明显。
- 当信息框结束时,信息框的模板闭合标签
}}
应单独一行,然后文本在下一行中显示。 - 要特别小心避免在转换的模板中出现两个换行符,因为这可能会导致创建额外的新段落!
- 当信息框结束时,信息框的模板闭合标签
- 一般情况下,在行首省略额外的制表符和空格,尽管有些模板为了可读性而使用它们。
- 代码部分中的 <pre> 和 </pre> 标签应放置在单独的行中。
- 在画廊中应省略 File: 前缀。
- 下划线通常应换成空格,除非它是物品名称的一部分(参见命名约定部分)。
- 导航底栏和分类链接之间应该有一个空行。
以下是关于 CSS/HTML 的非强制性偏好,其中包括:
- 每个 CSS 属性末尾添加
;
符号。 - 属性和属性之间添加空格。
- 尽量使用 6 个字母的小写十六进制颜色。
- 尽量使用 CSS 的
style="width"
,而不是 HTML 的width
属性。
上传文件
任何人都可以自由上传新文件,只要它符合 wiki 守则。但是,为了在用户页面之外使用图像,一些指南可以确保质量并避免不必要的重复。
文件尺寸
物品图标、地块图像和界面元素应该以它们在游戏中出现的分辨率上传,例如物品的 32×32 像素。除了由于游戏差异而造成的小的例外情况,所有物品都应该是 32×32 像素的分辨率。不要上传缩放版本,通过“pixelart”类可以将图标在信息框中自动缩放到所需的大小,目前图标的宽度为 128 像素,保持其像素化的外观。
在版本 41.78.16 中,目前有 6 个物品图标的尺寸不正确,这些图标在原始游戏文件中是这样的,可能是一个错误,但是 wiki 将保留其不均匀的尺寸:
- File:AliceBag.png – 31 × 32 像素
- File:DrawstringBag.png – 31 × 32 像素
- File:HelmetCrash.png – 31 × 32 像素
- File:BagOfCarrotsSeeds.png – 32 × 31 像素
- File:CarrotsSeeds.png – 32 × 31 像素
- File:HandShovel.png – 32 × 31 像素
此要求也适用于一些界面图标,例如时间按钮。
物品模型图像应该以 400×400 像素的分辨率上传,然后缩放到 200 像素的宽度。
请不要裁剪图标和模型的空白区域,这样图像的对齐方式会更好。
单个地块图标(地面)应该是 128×64 像素的分辨率,用于 2 倍纹理,或者 64×32 用于 1 倍纹理或这些的倍数。这条规则的一个例外是上传某些家具地块,因为保留它们的标准分辨率可能会导致大量的空白区域。
关于其他图片,除了主页面之外,尽量上传最高的非缩放分辨率,因为缩放是由 MediaWiki 处理的。
命名约定
- 物品图标应该与游戏代码中的名称相同,可以在 ProjectZomboid > media > scripts 中的脚本文件中找到,或者通过 TileZed 导出时找到。
- 尽管物品在技术上是以“
Item_…
”的形式存储的,但是目前大多数文件省略了“Item_”前缀,将来可能有所变化。 - 这些文本文件中没有命名的物品,例如熟食,可以在图像文件中的 UI1.xml 或 UI2.xml 文件中找到。
- 尽管物品在技术上是以“
- 物品模型可以使用模型文件名或模型纹理文件名命名,末尾添加
_Model
。例如:File:BaseballBat Model.png。 - 地块/家具应该以地块 ID 命名,占用多个地块的物品应该与
+
结合,如果地块使用相同的 ID,则可以省略开头。例如:File:Appliances cooking 01 25.png或File:Location shop generic 01 80+81+82.png。 - 界面图标通常应该与 TileZed 导出时在游戏文件中显示的名称相同。
- 动画图像,无论是 GIF 还是 PNG 文件,都应该在末尾添加
_Anim
,以便轻松识别动画图像。而不是依赖于文件扩展名本身。例如:File:BottleOfGasoline Anim.png。 - 如果要上传旧版本或替代版本的图像,或者名称与其他名称冲突,用户可以自由使用自己选择的后缀,因为目前没有严格的命名约定。目前,一些旧图标使用
-old
后缀上传。- 由于 MediaWiki 软件的限制,下划线会被转换为空格,并且文件的第一个字母总是转换为大写,这应该在上传图像时牢记在心。
分类
文章布局
语言栏
此部分是语言栏的相关说明。语言栏用于链接所有不同语言的文章。例如:Nails 的 显示了一个链接,该链接与
/##
结尾的每个页面都有关联(例如 Clous),即使文章包含重定向。
- 不需要添加页面名称——只需添加
{{Languages}}
即可。
导航栏
导航栏显示了一个导航栏,当文章最后更新时,以及文章的背景。由于当前的 wiki 政策,关于游戏物品或机制的文章必须包含基于它们在 wiki 中最后更新的版本分类。这使我们能够跟踪哪些文章可能已经过时了。
通知和通知框
通知可以是通知框中的任何一种,它可以提醒读者和编辑者关于文章的一些重要信息。对于消歧义链接,它用于向读者呈现一个链接,表明读者可能正在搜索的是另一个东西。
信息框
此部分是用于信息框,它将位于页面的右侧。信息框提供了重要要点的快速摘要,易于阅读。
简介
- 此部分应该包含对所讨论主题的简要介绍。
- 它应该以一个不定冠词(‘a/an’)开头,后面是粗体和小写的主题的单数形式。
- 应该在适当的地方添加指向 wiki 中其他页面的链接。
目录
目录(TOC)会自动添加到至少有 4 个章节的文章中。默认情况下,它位于左侧,位于第一节的上方。
文章章节
每个章节都应该按照以下顺序来编写:
- 概述或机制:只有在需要涵盖大量细节且不能放在简介中时,才应该包含此部分。
- 用法:此部分应包含物品的所有用途。如果需要,可以将主题分成其他章节,无论信息有多少。
- 制作:此部分应包含物品涉及的所有制作配方。
- 分布:应该在此部分中包含物品/对象的分布方式/位置。如果需要,可以进一步分为“建筑”和“车辆”。
- 画廊:相关图像的一组,组织在
<gallery></gallery>
容器中。 - 趣闻:与文章主题直接相关的有趣事实的列表。尽量不要重复文章其他部分中已经包含的信息,并避免可能被认为是常识的观点。
- 代码:直接与主题相关的代码,应该放在这里。
- 参见:与文章主题相关的任何文章的链接,如果在文章中没有提到,应该在这里列出。
- 参考:列出用于支持文章中任何声明的任何参考资料。阅读更多关于引用来源。
导航页脚
许多文章都需要有一个导航页脚,通常是一个导航框,它列出了所有类似的物品/对象。