“面向TWR玩家的Wiki编辑指南”的版本间的差异

来自TeamMoeg官方WIKI
跳到导航 跳到搜索
[已复核版本][已复核版本]
(创建页面,内容为“{{inProgress}} 本页面希望为想在本 wiki 上分享经验,但对 MediaWiki 不熟悉的TWR玩家提供最基本的编辑指导。 在此,我们假定需…”)
 
 
(未显示同一用户的11个中间版本)
第1行: 第1行:
{{inProgress}}
本页面希望为想在本 wiki 上分享经验,但对 <abbr title="MediaWiki 源码编辑器使用的标记语言">Wikitext</abbr> 不熟悉的TWR玩家提供最基本的编辑指导。
 
本页面希望为想在本 wiki 上分享经验,但对 MediaWiki 不熟悉的TWR玩家提供最基本的编辑指导。


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


==开始撰写==
==开始撰写==
第19行: 第17行:
<div style="padding: 0.5em; border-radius: 0.3em; border: 1px solid #e0e0e0; background-color: #f8f8f8;"><b>在本Wiki上新建名为“<span style="color: #ba0000;">(您搜索的标题)</span>”的页面!</b><br>找不到和查询相匹配的结果。</div>
<div style="padding: 0.5em; border-radius: 0.3em; border: 1px solid #e0e0e0; background-color: #f8f8f8;"><b>在本Wiki上新建名为“<span style="color: #ba0000;">(您搜索的标题)</span>”的页面!</b><br>找不到和查询相匹配的结果。</div>
点击红色的页面名,就可以进入编辑器创建此页面。
点击红色的页面名,就可以进入编辑器创建此页面。
另一种简单的方法是在[[Special:EditPage|这个页面]]([[Special:EditPage]])输入您起的标题,点击<span style="background-color: #36c; color: white; font-weight: bold; padding: 0.5em; margin: 0.1em;">前往页面</span>。若页面尚未创建,则会显示“正在创建(页面标题)”。




==可视化编辑器的使用==
==可视化编辑器的使用==
{{inProgress|issect=1}}
进入编辑器后,页面顶部的菜单栏一般有两个标签:
进入编辑器后,页面顶部的菜单栏一般有两个标签:
<div>
<div>
第32行: 第31行:
===常规文本===
===常规文本===
可视化编辑器是所见即所得的,和 Word 等排版软件的编辑方式类似。您可以直接输入文字,然后在菜单栏选择样式,并插入标题、列表等。因为容易使用,在此不再赘述。
可视化编辑器是所见即所得的,和 Word 等排版软件的编辑方式类似。您可以直接输入文字,然后在菜单栏选择样式,并插入标题、列表等。因为容易使用,在此不再赘述。
===页面内的各级标题===
可视化编辑器菜单栏的第一个选单可以设置当前行输入的文本类型,具体而言是段落内容还是各级标题。将页面内容以各级标题的层次组织好是很重要的,因为在页面完成时,顶部会根据标题的结构自动生成一个目录,此目录可以方便地跳转到对应标题处,方便读者阅读。


===插入图片===
===插入图片===
一般来说,本 wiki 自然不会有您需要插入页面的图片。这时,您需要先上传本地图片。
在 wiki 的左边栏点击<code>工具/上传文件</code>,即进入文件上传界面。点击<span style="border: 1px solid #707070; background-image: linear-gradient(to top, #d7d7d7, #e9e9e9); padding: 0.3em; margin: 0.1em;">选择文件</span>按钮,浏览并选择您要上传的本地文件,点击页面底部的<span style="border: 1px solid #707070; background-image: linear-gradient(to top, #d7d7d7, #e9e9e9); padding: 0.3em; margin: 0.1em;">上传文件</span>即可。上传文件时需要注意:
* 单个文件不能超过 50 MB。一般可能用到的图片(如游戏截图)不会达到这个大小。
* <u>文件名也应当有一定的辨识度,不可起得太过简略</u>,这主要是避免和其他用户上传的文件撞车。如果 wiki 上已有相同文件名的文件,上传页面会出现警告文字,这时最好在<code>目标文件名</code>框中修改当前文件名。
* 当然,您也可以故意上传相同文件名的文件,以覆盖更新旧的同名文件(前提是旧文件也是您自己上传的,不应该未经同意覆盖别人的文件)。
* 请确保上传的文件不侵犯他人的著作权。
此界面中,每次只能上传一个文件。需要用到的图片全部上传完成后,就可以插入页面了。
在可视化编辑器中,点击<code>插入→图片与媒体</code>,搜索刚才上传的图片的文件名,选择并点击<span style="background-color: #36c; color: white; font-weight: bold; padding: 0.5em; margin: 0.1em;">使用这个图片</span>,进入<code>媒体文件设置</code>界面。此界面需要注意的点有:
* <code>高级→使文字内容环绕该对象</code>选项默认是打开的,并且可以通过“左”“中”“右”三个选项决定图片在页面中浮动的位置。然而,在撰写教程或设计时,此选项只会带来麻烦:因为在图片多、文字量少时,过多的图片以浮动体的形式存在,无法与对应的文字对齐,也就无法精准地插入指定位置。因此建议关闭此选项。
* <code>高级→图像类型</code>默认为<code>缩略图</code>,但对于教程页面来说,读者一般希望直接看到完整图片,而不是点开才能看。因此建议修改为其他类型。
* 如果图像类型有框,可以在<code>常规→说明</code>里设置图片下方显示的说明文本。
* 如果插入的图片太大,应当在<code>高级→图像尺寸→自定义</code>设置图片大小。


===插入模板===
===插入模板===
模板是用于重复使用的代码段,有些可以填入不同的'''参数'''。您或许已经在一些页面上方看到过类似这样的横幅:
{{TWRMachineValidity|0.4.7}}
这些横幅都属于模板。
可视化编辑器中,在页面中插入模板自然是直接使用<code>插入→模板</code>。和插入图片类似,在界面中输入模板名称并选中,就可以进入下一个页面。如果该模板有参数(字段),则需要在这个界面输入参数的键值对。例如,上面这个横幅中,您需要声明撰写时的整合包版本(这里给了 0.4.7)。这个版本号的信息在模板中对应的参数是<code>1</code>,所以需要在界面的<code>字段名称</code>框输入“1”;选择之后会出现另一个框,在里面输入“0.4.7”。所有必须填写的参数(可能还有选填参数)填写完毕后,点击<span style="background-color: #36c; color: white; font-weight: bold; padding: 0.5em; margin: 0.1em;">插入</span>即可。
如何确认一个模板总共有哪些参数、每个参数可以填哪些值?可以搜索一下模板的'''文档页''',一般会有参数列表和一些使用的例子。模板的文档页标题为<code>Template:(模板名)/doc</code>。例如,上面的<code>TWRMachineValidity</code>模板,其文档页就是<code>[[Template:TWRMachineValidity/doc]]</code>(点进去看看!)。下一节将列出常用的TWR相关模板。
===链接到导航页面===
现在您的页面写完了,但仍存在一个问题:读者很难找到这个页面,因为它既不在显眼的位置、也不一定有便于搜索的关键词。因此,应该在显眼的地方留下您的页面的入口,好让其他玩家看见。
对于TWR来说,[[Talk:冬季救援]]就是这样一个集中的攻略和信息入口,目前我们鼓励所有的TWR创作者在此处挂上自己撰写的页面。不过,因为这是一个讨论页(以“Talk:”亦即“讨论:”为前缀的页面),所以<u>暂不支持可视化编辑器</u>。但您要做的事很简单:将您撰写的页面标题用两对半角中括号括起来,然后粘贴到某个标题下方就行。例如,如果您的标题是“蒸汽瓶的使用方法”,则只要在上述讨论页源码的某一行加上<code><nowiki>[[蒸汽瓶的使用方法]]</nowiki></code>,即可创建一个内链。您不必对这个讨论页的其他部分关心太多,因为此页面会由官方人员(和其他用户)打理。
==可用的TWR相关模板==
===领域===
====TWRBanner====
式样:
{{TWRBanner}}
此模板无参数,用于告知读者该页面与TWR(而不是 TeamMoeg 的其他作品)相关。
===共享===
====CCBanner 和 CC0Banner====
式样:
{{CCBanner}}
若页面或小节遵循特殊的 Creative Commons 协议,可用这两个模板声明。若未经说明,本 wiki 所有页面默认遵循 CC BY-NC-SA,所以一般而言,页面并不需要特意插入这两个模板,除非您希望遵循更加开放的CC协议。
详见:
* [[Template:CCBanner/doc]]
* [[Template:CC0Banner/doc]]
===完成度===
====inProgressBanner====
式样:
{{inProgress}}
用于告知读者部分内容未完成,以及作者是否有意愿和其他人合作。
详见:
* [[Template:inProgressBanner/doc]]
===有效性===
有效性模板用于告知读者内容是否已经(或可能已经)过时。
====TWRTutorValidity====
式样:
{{TWRTutorValidity}}
详见:
* [[Template:TWRTutorValidity/doc]]
====TWRMachineValidity====
式样:
{{TWRMachineValidity}}
详见:
* [[Template:TWRMachineValidity/doc]]
===认证===
====devInvolved====
式样:{{devInvolved}}
用于告知内容是否由TWR开发人员参与或认证。此模板只说明开发人员认可了内容的正确性,但不一定表示内容提供了足够详尽的信息;反过来,没有此模板的内容也完全不一定缺少正确性,很可能只是因为未有开发人员专门认证。如果您认为自己的页面需要此认证,可通过玩家群等渠道提出申请。'''此模板只应由官方人员添加'''。
详见:
* [[Template:devInvolved/doc]]
===功能性模板===
====与温度相关的 tmpr、deltaT、TRange====
式样:{{tmpr}} {{deltaT}} {{TRange}}
带有温标转换功能的温度值、温度差、温度区间模板(鼠标悬浮即可看到另一温标的值,℃→℉、℉→℃、K→℃)。
详见:
* [[Template:tmpr/doc]]
* [[Template:deltaT/doc]]
* [[Template:TRange/doc]]
====buff====
式样:{{buff|力量|5|3|00}}
带图片的药水效果框,目前支持所有原版效果及 Frosted Heart 添加的两个效果(失温、中暑)。
详见:
* [[Template:buff/doc]]




==对源码编辑器使用者的提示==
==对源码编辑器使用者的提示==
{{inProgress|issect=1}}
* Wikitext 编辑支持HTML语法,但因为其解析方式,不可能像正常的HTML文件那样有合适的换行和缩进(因为会被转换为空格)。
* 一些HTML标签(如<code><nowiki><img></nowiki></code>、<code><nowiki><a></nowiki></code>)不可用,必须用 Wikitext 封装好的形式。
* 暂时未开放编辑全站的 CSS 和 JavaScript 文件。

2022年1月4日 (二) 22:37的最新版本

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

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

开始撰写

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

页面标题

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

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

创建新页面

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

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

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

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


可视化编辑器的使用

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

  • 创建
  • 创建源代码



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

常规文本

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

页面内的各级标题

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

插入图片

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

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

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

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

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

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

插入模板

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

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

这些横幅都属于模板。

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

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

链接到导航页面

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

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


可用的TWR相关模板

领域

TWRBanner

式样:

本页面与Icon banner TWR.png相关

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

共享

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}}} 的内容设计的。
随着整合包版本更新,可能出现其他同样有效的设计替代此设计。

详见:

认证

devInvolved

式样:

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

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

详见:

功能性模板

与温度相关的 tmpr、deltaT、TRange

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

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

详见:

buff

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

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

详见:


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

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