样式指南

From PZwiki
< Help:Style guideHelp:Style guide/zh-hans
快速上手 导航 创建新页面 如何贡献
图片 表格 样式手册 翻译页面

本页面将提供编辑僵毁 wiki 时遵循的一般样式指南。维基百科有一个很好的通用样式指南,因此本页面只包含特定于僵毁 wiki 的规则和指南。wiki 的目的是记录事实,因此您应避免发表意见和推测性信息。

如果您有任何疑问、建议或投诉,请在讨论页上留言。请不要在没有与他人达成共识的情况下引入或更改本页面的指南。

页面标题

所有页面都需要一个合适的标题。

  • 关于物品地块地点和其他游戏机制的页面应该尽量以游戏中的名称命名。
    • 这包括但不限于大小写、拼写错误和英式英语与美式英语的差异(游戏默认语言为美式英语)。
    • 这不包括指向多个物品的页面,尽管应该尽可能接近游戏中的物品名称,并为每个物品创建合适的重定向。
  • 关于游戏角色的页面应该包含他们的名字和姓氏,而不是他们的昵称。例如,页面名应为 Bob Smith 而不是 BobBaldspot
    • 当然,应该为这些昵称创建合适的重定向。
    • 例外情况是如果不知道全名,那么只需要知道名字或姓氏的其中一个作为页面名,否则采用昵称。
  • 如果出现相同标题的多个物品,可以使用括号来表示其类型,并创建消歧义页面,例如水瓶(无歧义)

重定向

如果满足以下任何一个条件,即可创建重定向页面:

  1. 是以前的游戏名称,例如“Empty Sand Bag”(Sack)。
  2. 是标题的其他拼写,例如“Duffelbag”(Duffel Bag)。
    1. 这包括英式英语和美式英语之间的差异,例如“Tyre”(Tire)。
    2. 这也包括开发人员的名字或昵称,例如“Chris”(Chris Simpson)。
    3. 这也包括游戏角色的名字或昵称,例如“Bob”(Bob Smith)。
  3. 标题的其他大小写或形式,例如“Baseball bat”(Baseball Bat)。
  4. 非英语标题重定向到子页面,例如“Кастрюля”(Cooking Pot/ru)。有关详细信息,请参阅下面的翻译部分。

翻译

  • 默认语言是英语,因此所有页面都应该有一个英语版本,然后从英语翻译到所需的语言。
  • 物品地块地点和其他游戏机制的名称应该根据游戏内的官方翻译进行翻译。
  • 除英语以外的其他语言页面应该是英语版本的子页面,语言代码为 /fr(法语)等,而不是译名,例如 Items/fr 而不是 Objets(后者应该是重定向)。
    • 显示的页面标题可以通过在页面中添加 {{DISPLAYTITLE:Objets}} 来更改。将 Objets 替换为您希望显示的页面标题。

简体中文翻译样式

本wiki的简体中文翻译样式大体遵循中文编写指南。包括:

  • 空格
    • 中英文之间添加空格
    • 中文与数字间添加空格
    • 数字与单位间添加空格
    • 全角标点与非中文字符间不添加空格
  • 全角与半角
    • 使用全角中文标点
    • 完整英文语句或特殊单词中采用英文标点
  • 链接
    • 中文链接与普通文本间不添加空格

编写

我们要求维护一个标准的写作风格,以便保证阅读和页面之间的一致性。

  • 页面外的指南部分应该不直接提到读者。
  • 应避免使用缩写。
  • 应该通过斜体来强调,而不是粗体大写
  • 如果可能的话,请尽量校对自己的文章。
    错误
    不要将发电机放在房子里。发电机会因为排气而迅速降低你的健康。如果你碰巧这样做了,尽快到外面去停止损坏,但是在发电机关闭之前,房子是不安全的。
    正确
    玩家不应该将发电机放在房子里,因为它会因为排气而迅速降低角色的健康。如果玩家碰巧这样做了,那么到外面去就会停止受到伤害,但是在发电机关闭之前,房子是不安全的。
  • 关于修改的信息不应该是文章的一部分,除非文章本身就是关于修改的。
  • 尽可能使用美式英语。虽然核心 The Indie Stone 开发者来自英国,一些旧的或内部的物品名称仍然可以是英式英语,但游戏发生在美国,美式英语被选择为游戏和 wiki 的默认语言。
  • 此 wiki 也有一点偏爱牛津拼写法(-ize 后缀)和牛津(串行)逗号,尽管这并不是严格要求的。

大小写

  • 单词只应该在句子开头或单词是专有名词时才大写。物品和地块不应该大写,因为它们是普通名词
    • 这包括章节标题,例如“See Also”,应该是“See also”。
    • 这条规则的例外是页面标题

首选代码样式

虽然不是强制要求的,但是有一个首选的代码样式,用于 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 将保留其不均匀的尺寸:

此要求也适用于一些界面图标,例如时间按钮。

物品模型图像应该以 400×400 像素的分辨率上传,然后缩放到 200 像素的宽度。

请不要裁剪图标和模型的空白区域,这样图像的对齐方式会更好。

单个地块图标(地面)应该是 128×64 像素的分辨率,用于 2 倍纹理,或者 64×32 用于 1 倍纹理或这些的倍数。这条规则的一个例外是上传某些家具地块,因为保留它们的标准分辨率可能会导致大量的空白区域。

关于其他图片,除了主页面之外,尽量上传最高的非缩放分辨率,因为缩放是由 MediaWiki 处理的。

命名约定

  • 物品图标应该与游戏代码中的名称相同,可以在 ProjectZomboid > media > scripts 中的脚本文件中找到,或者通过 TileZed 导出时找到。
    • 尽管物品在技术上是以“Item_…”的形式存储的,但是目前大多数文件省略了“Item_”前缀,将来可能有所变化。
    • 这些文本文件中没有命名的物品,例如熟食,可以在图像文件中的 UI1.xmlUI2.xml 文件中找到。
  • 物品模型可以使用模型文件名或模型纹理文件名命名,末尾添加 _Model。例如:File:BaseballBat Model.png
  • 地块/家具应该以地块 ID 命名,占用多个地块的物品应该与 + 结合,如果地块使用相同的 ID,则可以省略开头。例如:File:Appliances cooking 01 25.pngFile: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’)开头,后面是粗体和小写的主题的单数形式。
    • 例外情况是,如果物品/对象/机制的游戏名称是复数形式或包含专有冠词,则应删除‘a/an’。
    • 如果物品/对象/机制是专有名词,则应该用大写字母写出来。
  • 应该在适当的地方添加指向 wiki 中其他页面的链接。

目录

目录(TOC)会自动添加到至少有 4 个章节的文章中。默认情况下,它位于左侧,位于第一节的上方。

  • 如果不需要目录,可以使用:__NOTOC__ 来删除。
  • 或者也可以使用 __TOC__ 来手动定位目录。
  • 也可以使用 {{toc|right}}{{toc}} 来强制将目录定位到左侧或右侧。

文章章节

每个章节都应该按照以下顺序来编写:

  • 概述机制:只有在需要涵盖大量细节且不能放在简介中时,才应该包含此部分。
  • 用法:此部分应包含物品的所有用途。如果需要,可以将主题分成其他章节,无论信息有多少。
  • 制作:此部分应包含物品涉及的所有制作配方。
  • 分布:应该在此部分中包含物品/对象的分布方式/位置。如果需要,可以进一步分为“建筑”和“车辆”。
  • 画廊:相关图像的一组,组织在 <gallery></gallery> 容器中。
  • 趣闻:与文章主题直接相关的有趣事实的列表。尽量不要重复文章其他部分中已经包含的信息,并避免可能被认为是常识的观点。
  • 代码:直接与主题相关的代码,应该放在这里。
  • 参见:与文章主题相关的任何文章的链接,如果在文章中没有提到,应该在这里列出。
  • 参考:列出用于支持文章中任何声明的任何参考资料。阅读更多关于引用来源

导航页脚

许多文章都需要有一个导航页脚,通常是一个导航框,它列出了所有类似的物品/对象。