面向TWR玩家的Wiki编辑指南

来自TeamMoeg官方WIKI
Lyuuke讨论 | 贡献2021年10月6日 (三) 15:04的版本
跳到导航 跳到搜索
Icon banner in progress.png 本页面正在施工
存在一些内容尚未完成。请期待作者的进一步完善。


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

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

开始撰写

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

页面标题

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

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

创建新页面

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

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

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


可视化编辑器的使用

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

  • 创建
  • 创建源代码



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

常规文本

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

页面内的各级标题

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

插入图片

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

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

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

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

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

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

插入模板

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

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

这些横幅都属于模板。

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

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


可用的TWR相关模板

领域

TWRBanner

式样:

本页面与Icon banner TWR.png相关

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

共享

CCBanner 和 CC0Banner

式样:

Cc icon white.png Attribution icon white.png 本页面的图文内容适用于 CC BY 4.0 协议
您可以在遵循上述协议的情况下转载此部分内容。
请在转载时注明本页面的链接。

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

详见:

完成度

inProgressBanner

式样:

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

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

详见:

有效性

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

TWRTutorValidity

式样:

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

详见:

TWRMachineValidity

式样:

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

详见:

功能性模板

与温度相关的 tmpr、deltaT、TRange

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

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

详见:

buff

式样:Buff vanilla 85.png 力量 V3:00

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

详见:


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

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