面向TWR玩家的Wiki编辑指南
|
本页面正在施工 |
| 存在一些内容尚未完成。请期待作者的进一步完善。 |
本页面希望为想在本 wiki 上分享经验，但对 MediaWiki 不熟悉的TWR玩家提供最基本的编辑指导。
在此，我们假定需要阅读本指南的用户都使用可视化编辑器编辑页面。因此，本指南将不会涉及太多源码相关的问题。不过，如果您已有 MediaWiki 的编辑经验，也可以看看最后一节。
开始撰写
您希望分享的、独立成篇的教程或设计，一般应该以单独页面的形式发布。当前，所有用户均可创建页面。
页面标题
为了方便检索和管理，页面标题应该符合以下要求：
- 应当简明扼要地说明内容的主题，但不宜过短；尤其不要起单个词（比如“第一天”“铜”）的标题。因为本 wiki 目前页面数量有限，还没有区分不同整合包的名称空间，所以过短的标题可能会给不同来源的读者造成误解和麻烦。
- 如果标题确实很难有区分度，不妨加一些可以让别的玩家看出是什么整合包的信息。例如“第一天”“铜”这样的标题不好，但“在TWR中度过第一天”“TWR中获得铜的方法”这样的标题就可以接受。对于某个系列来说，可以在标题最前方加上系列名。
- 标题不应含有半角冒号（西文冒号）（:）和斜杠（/）；可以含有全角冒号（中文冒号）（：）。前两者在页面名中是有特殊含义的，分别表明名称空间和子页面。
- 至少应该看起来像是教程帖或者文章的标题，不推荐使用疑问句。
创建新页面
起好标题后，在右上角的搜索框搜索此标题。如果显示已有此标题的页面，说明您刚才起好的标题已经被其他用户占用了；否则，会显示如下结果：
找不到和查询相匹配的结果。
点击红色的页面名，就可以进入编辑器创建此页面。
可视化编辑器的使用
进入编辑器后，页面顶部的菜单栏一般有两个标签：
- 创建
- 创建源代码
其中“创建”标签对应可视化编辑器，“创建源代码”标签对应源码编辑器。此处只介绍可视化编辑器。
常规文本
可视化编辑器是所见即所得的，和 Word 等排版软件的编辑方式类似。您可以直接输入文字，然后在菜单栏选择样式，并插入标题、列表等。因为容易使用，在此不再赘述。
页面内的各级标题
可视化编辑器菜单栏的第一个选单可以设置当前行输入的文本类型，具体而言是段落内容还是各级标题。将页面内容以各级标题的层次组织好是很重要的，因为在页面完成时，顶部会根据标题的结构自动生成一个目录，此目录可以方便地跳转到对应标题处，方便读者阅读。
插入图片
一般来说，本 wiki 自然不会有您需要插入页面的图片。这时，您需要先上传本地图片。
在 wiki 的左边栏点击工具/上传文件，即进入文件上传界面。点击选择文件按钮，浏览并选择您要上传的本地文件，点击页面底部的上传文件即可。上传文件时需要注意：
- 单个文件不能超过 50 MB。一般可能用到的图片（如游戏截图）不会达到这个大小。
- 文件名也应当有一定的辨识度，不可起得太过简略，这主要是避免和其他用户上传的文件撞车。如果 wiki 上已有相同文件名的文件，上传页面会出现警告文字，这时最好在
目标文件名框中修改当前文件名。 - 当然，您也可以故意上传相同文件名的文件，以覆盖更新旧的同名文件（前提是旧文件也是您自己上传的，不应该未经同意覆盖别人的文件）。
- 请确保上传的文件不侵犯他人的著作权。
此界面中，每次只能上传一个文件。需要用到的图片全部上传完成后，就可以插入页面了。
在可视化编辑器中，点击插入→图片与媒体，搜索刚才上传的图片的文件名，选择并点击使用这个图片，进入媒体文件设置界面。此界面需要注意的点有：
高级→使文字内容环绕该对象选项默认是打开的，并且可以通过“左”“中”“右”三个选项决定图片在页面中浮动的位置。然而，在撰写教程或设计时，此选项只会带来麻烦：因为在图片多、文字量少时，过多的图片以浮动体的形式存在，无法与对应的文字对齐，也就无法精准地插入指定位置。因此建议关闭此选项。高级→图像类型默认为缩略图，但对于教程页面来说，读者一般希望直接看到完整图片，而不是点开才能看。因此建议修改为其他类型。- 如果图像类型有框，可以在
常规→说明里设置图片下方显示的说明文本。 - 如果插入的图片太大，应当在
高级→图像尺寸→自定义设置图片大小。
插入模板
模板是用于重复使用的代码段，有些可以填入不同的参数。您或许已经在一些页面上方看到过类似这样的横幅：
|
此机构或生产设备最初是针对TWR版本 0.4 的内容设计的。 |
| 随着整合包版本更新，可能出现其他同样有效的设计替代此设计。 |
这些横幅都属于模板。
可视化编辑器中，在页面中插入模板自然是直接使用插入→模板。和插入图片类似，在界面中输入模板名称并选中，就可以进入下一个页面。如果该模板有参数（字段），则需要在这个界面输入参数的键值对。例如，上面这个横幅中，您需要声明撰写时的整合包版本（这里给了 0.4）。这个版本号的信息在模板中对应的参数是1，所以需要在界面的字段名称框输入“1”；选择之后会出现另一个框，在里面输入“0.4”。所有必须填写的参数（可能还有选填参数）填写完毕后，点击插入即可。
如何确认一个模板总共有哪些参数、每个参数可以填哪些值？可以搜索一下模板的文档页，一般会有参数列表和一些使用的例子。模板的文档页标题为Template:（模板名）/doc。例如，上面的TWRMachineValidity模板，其文档页就是Template:TWRMachineValidity/doc（点进去看看！）。下一节将列出常用的TWR相关模板。
可用的TWR相关模板
领域
TWRBanner
式样：
相关此模板无参数，用于告知读者该页面与TWR（而不是其他整合包）相关。
共享
CCBanner 和 CC0Banner
式样：
|
|
本页面的图文内容适用于 CC BY 4.0 协议 | ||
| 您可以在遵循上述协议的情况下转载此部分内容。 请在转载时注明本页面的链接。 |
若页面或小节遵循特殊的 Creative Commons 协议，可用这两个模板声明。若未经说明，本 wiki 所有页面默认遵循 CC BY-NC-SA，所以一般而言，页面并不需要特意插入这两个模板，除非您希望遵循更加开放的CC协议。
详见：
完成度
inProgressBanner
式样：
|
|
本页面正在施工 |
| 存在一些内容尚未完成。请期待作者的进一步完善。 |
用于告知读者部分内容未完成，以及作者是否有意愿和其他人合作。
详见：
有效性
有效性模板用于告知读者内容是否已经（或可能已经）过时。
TWRTutorValidity
式样：
|
此教程最初是针对TWR版本 {{{1}}} 的内容撰写的。 |
| 随着整合包版本更新，一些内容可能已经过时或需要补充。 |
详见：
TWRMachineValidity
式样：
|
|
此机构或生产设备最初是针对TWR版本 {{{1}}} 的内容设计的。 |
| 随着整合包版本更新，可能出现其他同样有效的设计替代此设计。 |
详见：
功能性模板
与温度相关的 tmpr、deltaT、TRange
式样：🌡️ 0 ℃ Δ🌡️ 1 ℃ /分钟 [🌡️] 0~20 ℃
带有温标转换功能的温度值、温度差、温度区间模板（鼠标悬浮即可看到另一温标的值，℃→℉、℉→℃、K→℃）。
详见：
buff
式样：
力量 V 3:00
带图片的药水效果框，目前支持所有原版效果及 Frosted Heart 添加的两个效果（失温、中暑）。
详见：
对源码编辑器使用者的提示
- Wiki 编辑支持HTML语法，但因为 MediaWiki 的解析方式，不可能像正常的HTML文件那样有合适的换行和缩进（因为会被转换为空格）。
- 一些HTML标签（如
<img>、<a>）不可用，必须用 MediaWiki 封装好的形式。 - Scribunto 插件暂时不可用。
- 暂时未开放编辑全站的 CSS 和 JavaScript 文件。