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

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


===插入图片===
===插入图片===
第54行: 第57行:
这些横幅都属于模板。
这些横幅都属于模板。


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


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




==对源码编辑器使用者的提示==
==对源码编辑器使用者的提示==
{{inProgress|issect=1}}
{{inProgress|issect=1}}

2021年10月6日 (三) 14:38的版本

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


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

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

开始撰写

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

页面标题

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

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

创建新页面

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

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

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


可视化编辑器的使用

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

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

  • 创建
  • 创建源代码



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

常规文本

可视化编辑器是所见即所得的,和 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相关模板

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

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