面向TWR玩家的Wiki编辑指南

本页面希望为想在本 wiki 上分享经验，但对 MediaWiki 不熟悉的TWR玩家提供最基本的编辑指导。

在此，我们假定需要阅读本指南的用户都使用可视化编辑器编辑页面。因此，本指南将不会涉及太多源码相关的问题。不过，如果您已有 MediaWiki 的编辑经验，也可以看看最后一节。

开始撰写

您希望分享的、独立成篇的教程或设计，一般应该以单独页面的形式发布。当前，所有用户均可创建页面。

页面标题

为了方便检索和管理，页面标题应该符合以下要求：

• 应当简明扼要地说明内容的主题，但不宜过短；尤其不要起单个词（比如“第一天”“铜”）的标题。因为本 wiki 目前页面数量有限，还没有区分不同整合包的名称空间，所以过短的标题可能会给不同来源的读者造成误解和麻烦。
  • 如果标题确实很难有区分度，不妨加一些可以让别的玩家看出是什么整合包的信息。例如“第一天”“铜”这样的标题不好，但“在TWR中度过第一天”“TWR中获得铜的方法”这样的标题就可以接受。对于某个系列来说，可以在标题最前方加上系列名。
• 标题不应含有半角冒号（西文冒号）（:）和斜杠（/）；可以含有全角冒号（中文冒号）（：）。前两者在页面名中是有特殊含义的，分别表明名称空间和子页面。
• 至少应该看起来像是教程帖或者文章的标题，不推荐使用疑问句。

创建新页面

起好标题后，在右上角的搜索框搜索此标题。如果显示已有此标题的页面，说明您刚才起好的标题已经被其他用户占用了；否则，会显示如下结果：

在本Wiki上新建名为“（您搜索的标题）”的页面！
找不到和查询相匹配的结果。

点击红色的页面名，就可以进入编辑器创建此页面。

另一种简单的方法是在这里（Special:EditPage）输入您起的标题，点击前往页面。若页面尚未创建，则会显示“正在创建（页面标题）”。

可视化编辑器的使用

进入编辑器后，页面顶部的菜单栏一般有两个标签：

• 创建
• 创建源代码

其中“创建”标签对应可视化编辑器，“创建源代码”标签对应源码编辑器。此处只介绍可视化编辑器。

常规文本

可视化编辑器是所见即所得的，和 Word 等排版软件的编辑方式类似。您可以直接输入文字，然后在菜单栏选择样式，并插入标题、列表等。因为容易使用，在此不再赘述。

页面内的各级标题

可视化编辑器菜单栏的第一个选单可以设置当前行输入的文本类型，具体而言是段落内容还是各级标题。将页面内容以各级标题的层次组织好是很重要的，因为在页面完成时，顶部会根据标题的结构自动生成一个目录，此目录可以方便地跳转到对应标题处，方便读者阅读。

插入图片

一般来说，本 wiki 自然不会有您需要插入页面的图片。这时，您需要先上传本地图片。

在 wiki 的左边栏点击工具/上传文件，即进入文件上传界面。点击选择文件按钮，浏览并选择您要上传的本地文件，点击页面底部的上传文件即可。上传文件时需要注意：

• 单个文件不能超过 50 MB。一般可能用到的图片（如游戏截图）不会达到这个大小。
• 文件名也应当有一定的辨识度，不可起得太过简略，这主要是避免和其他用户上传的文件撞车。如果 wiki 上已有相同文件名的文件，上传页面会出现警告文字，这时最好在目标文件名框中修改当前文件名。
• 当然，您也可以故意上传相同文件名的文件，以覆盖更新旧的同名文件（前提是旧文件也是您自己上传的，不应该未经同意覆盖别人的文件）。
• 请确保上传的文件不侵犯他人的著作权。

此界面中，每次只能上传一个文件。需要用到的图片全部上传完成后，就可以插入页面了。

在可视化编辑器中，点击插入→图片与媒体，搜索刚才上传的图片的文件名，选择并点击使用这个图片，进入媒体文件设置界面。此界面需要注意的点有：

• 高级→使文字内容环绕该对象选项默认是打开的，并且可以通过“左”“中”“右”三个选项决定图片在页面中浮动的位置。然而，在撰写教程或设计时，此选项只会带来麻烦：因为在图片多、文字量少时，过多的图片以浮动体的形式存在，无法与对应的文字对齐，也就无法精准地插入指定位置。因此建议关闭此选项。
• 高级→图像类型默认为缩略图，但对于教程页面来说，读者一般希望直接看到完整图片，而不是点开才能看。因此建议修改为其他类型。
• 如果图像类型有框，可以在常规→说明里设置图片下方显示的说明文本。
• 如果插入的图片太大，应当在高级→图像尺寸→自定义设置图片大小。

插入模板

模板是用于重复使用的代码段，有些可以填入不同的参数。您或许已经在一些页面上方看到过类似这样的横幅：

	此机构或生产设备最初是针对TWR版本 0.4 的内容设计的。
	随着整合包版本更新，可能出现其他同样有效的设计替代此设计。

这些横幅都属于模板。

可视化编辑器中，在页面中插入模板自然是直接使用插入→模板。和插入图片类似，在界面中输入模板名称并选中，就可以进入下一个页面。如果该模板有参数（字段），则需要在这个界面输入参数的键值对。例如，上面这个横幅中，您需要声明撰写时的整合包版本（这里给了 0.4）。这个版本号的信息在模板中对应的参数是1，所以需要在界面的字段名称框输入“1”；选择之后会出现另一个框，在里面输入“0.4”。所有必须填写的参数（可能还有选填参数）填写完毕后，点击插入即可。

如何确认一个模板总共有哪些参数、每个参数可以填哪些值？可以搜索一下模板的文档页，一般会有参数列表和一些使用的例子。模板的文档页标题为Template:（模板名）/doc。例如，上面的TWRMachineValidity模板，其文档页就是Template:TWRMachineValidity/doc（点进去看看！）。下一节将列出常用的TWR相关模板。

链接到导航页面

现在您的页面写完了，但仍存在一个问题：读者很难找到这个页面，因为它既不在显眼的位置、也不一定有便于搜索的关键词。因此，应该在显眼的地方留下您的页面的入口，好让其他玩家看见。

对于TWR来说，Talk:冬季救援就是这样一个集中的攻略和信息入口，目前我们鼓励所有的TWR创作者在此处挂上自己撰写的页面。不过，因为这是一个讨论页（以“Talk:”亦即“讨论:”为前缀的页面），所以暂不支持可视化编辑器。但您要做的事很简单：将您撰写的页面标题用两对半角中括号括起来，然后粘贴到某个标题下方就行。例如，如果您的标题是“蒸汽瓶的使用方法”，则只要在上述讨论页源码的某一行加上[[蒸汽瓶的使用方法]]，即可创建一个内链。您不必对这个讨论页的其他部分关心太多，因为此页面会由官方人员（和其他用户）打理。

可用的TWR相关模板

领域

TWRBanner

式样：

本页面与相关

此模板无参数，用于告知读者该页面与TWR（而不是其他整合包）相关。

共享

CCBanner 和 CC0Banner

式样：

若页面或小节遵循特殊的 Creative Commons 协议，可用这两个模板声明。若未经说明，本 wiki 所有页面默认遵循 CC BY-NC-SA，所以一般而言，页面并不需要特意插入这两个模板，除非您希望遵循更加开放的CC协议。

详见：

• Template:CCBanner/doc
• Template:CC0Banner/doc

完成度

inProgressBanner

式样：

	本页面正在施工
	存在一些内容尚未完成。请期待作者的进一步完善。

用于告知读者部分内容未完成，以及作者是否有意愿和其他人合作。

详见：

• Template:inProgressBanner/doc

有效性

有效性模板用于告知读者内容是否已经（或可能已经）过时。

TWRTutorValidity

式样：

	此教程最初是针对TWR版本 {{{1}}} 的内容撰写的。
	随着整合包版本更新，一些内容可能已经过时或需要补充。

详见：

• Template:TWRTutorValidity/doc

TWRMachineValidity

式样：

	此机构或生产设备最初是针对TWR版本 {{{1}}} 的内容设计的。
	随着整合包版本更新，可能出现其他同样有效的设计替代此设计。

详见：

• Template:TWRMachineValidity/doc

认证

devInvolved

式样：

	本页面内容经过TWR开发人员认证。
	在声明有效的版本区间内，您可以放心采信本页面的内容。

用于告知内容是否由TWR开发人员参与或认证。此模板只说明开发人员认可了内容的正确性，但不一定表示内容提供了足够详尽的信息；反过来，没有此模板的内容也完全不一定缺少正确性，很可能只是因为未有开发人员专门认证。如果您认为自己的页面需要此认证，可通过玩家群等渠道提出申请。此模板只应由官方人员添加。

详见：

• Template:devInvolved/doc

功能性模板

与温度相关的 tmpr、deltaT、TRange

式样：🌡️ 0 ℃ Δ🌡️ 1 ℃ /分钟 [🌡️] 0~20 ℃

带有温标转换功能的温度值、温度差、温度区间模板（鼠标悬浮即可看到另一温标的值，℃→℉、℉→℃、K→℃）。

详见：

• Template:tmpr/doc
• Template:deltaT/doc
• Template:TRange/doc

buff

式样： 力量 V 3:00

带图片的药水效果框，目前支持所有原版效果及 Frosted Heart 添加的两个效果（失温、中暑）。

详见：

• Template:buff/doc

对源码编辑器使用者的提示

• Wiki 编辑支持HTML语法，但因为 MediaWiki 的解析方式，不可能像正常的HTML文件那样有合适的换行和缩进（因为会被转换为空格）。
• 一些HTML标签（如<img>、<a>）不可用，必须用 MediaWiki 封装好的形式。
• Scribunto 插件暂时不可用。
• 暂时未开放编辑全站的 CSS 和 JavaScript 文件。