用户:JerryHan3/sandbox/编辑帮助

来自Arcaea中文维基
< User:JerryHan3‎ | sandbox
JerryHan3讨论 | 贡献2022年3月8日 (二) 20:46的版本 (为Help:编辑添加样例,并表格化)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)

参见: w:Help:编辑手册


本帮助文档是关于如何在Arcaea中文维基开始你的编辑工作的说明。

格式化文本

维基文本,也称为维基标记或维基代码,可以用来格式化输入的文本。
参见: 格式化文本

链接

在MediaWiki中有多种超文本链接,本维基常用的是内部链接和外部链接。

内部链接

基础使用

内部链接链接到同一wiki中的其他页面,他的基本方法是在页面名的两边添加双重方括号,会出现一个这样的链接,点击他会跳转到对应的页面。

格式 示例代码 示例效果
[[页面名]] [[Help:编辑]] Help:编辑

链接跳转到当前页面的锚点

格式 示例代码 示例效果
[[#锚点]] [[#内部链接]] #内部链接

如果你想要让内部链接显示和链接的页面不同,可以使用管道链接。

格式 示例代码 示例效果
[[链接的页面名|显示的内容]] [[Help:编辑|Wiki编辑手册]] Wiki编辑手册

扩展内容

当链接的最后一个字符是管道字符时,管道技巧将自动生成为该链接显示的文本。其处理将删除链接标题的括号部分,处理标题中的逗号,并删除命名空间前缀。

示例代码 示例效果
[[帮助:编辑|]] 编辑
[[Quon (DJ Noriken)|]] Quon

管道链接还可以链至同一页面或不同页面上某个锚点。

格式 示例代码 示例效果
[[#锚点|显示的内容]] [[#扩展内容|内链的扩展用法]] 内链的扩展用法
[[链接的页面名#对应页面的锚点|显示的内容]] [[Help:格式化文本#文本格式化标记|wikitext文本格式化标记]] wikitext文本格式化标记

一般来说,可以通过这种方式连接到页面的章节标题,但你也可以手动设定某部分文字作为锚点。当然,你也可以把章节标题单独设定锚点名称。

格式 示例代码
<div id="锚点名称">文字</div> <div id="十分重要">这段文字需要一个名为“十分重要”的锚点。</div>
==<span id="锚点名称"></span>章节标题名== ==<span id="Trivia"></span>你知道吗==

对于分类页面,文件页面等会造成歧义的,你可能需要添加:来消歧义。(不保证通用)

示例代码 示例效果
[[:分类:总览]] 分类:总览

外部链接

基础使用

外部链接的基本使用方法是在单个方括号的里面添加”url+空格+显示内容”的格式。

格式 示例代码 示例效果 备注
[链接url 显示的内容] [https://wiki.arcaea.cn Arcaeawiki] Arcaeawiki
[https://wiki.arcaea.cn] [1] 需要注意的是,和内部链接不一样,如果只输入了url,那么会显示数字来表示。
直接输入url https://wiki.arcaea.cn https://wiki.arcaea.cn 如果直接输入url而不使用方括号,那么链接会直接显示。

扩展内容

示例代码 示例效果 备注
[//wiki.arcaea.cn Arcaeawiki] Arcaeawiki 你可以在方括号内省略协议,但是必须添加//
[mailto:contact@lowiro.com 给616发邮件] 给616发邮件 你还可以链接到电子邮件。
[https://wiki.arcaea.cn/index.php?title=帮助:编辑&action=edit 编辑该页] 编辑该页 你还可以通过外部链接来链接到本维基的某些不能使用内部链接的地方,比如编辑页。
<span class="plainlinks">[https://wiki.arcaea.cn Arcaeawiki]</span> Arcaeawiki 如果你想避免外部链接的箭头,可以使用plainlinks类。

跨维基链接

使用这样的格式来链接到其他维基。(需要interwiki表支持)

[[wikipedia:Sunflower]]

讨论与签名

每个页面都有其对应的讨论页,遵循一些规则是好的:

  • 在你的文字后添加你的签名
  • 对于长讨论添加它的标题
  • 使用缩进:文本来回复其他人
功能 代码 显示效果
带时间戳的签名
~~~~
用户名讨论) 2020年6月16日 (二) 16:16 (CST)
只署名
~~~ 
用户名讨论
只签署时间戳
~~~~~
2020年6月16日 (二) 16:16 (CST)
在签名中包含连字符
--~~~~
--用户名讨论) 2020年6月16日 (二) 16:16 (CST)

图像

在页面中显示图像

显示图像的标准语法是:

[[文件:文件名.文件格式|格式|大小|水平对齐|垂直对齐|图片链接|替代文本]]

下面是一个例子:

[[文件:Partner kou.png|border|250px|center|super|link=搭档|红]]

格式

嵌入式

(空):显示图片的原大小。

border:显示一个小边框。如果图片背景不是白色的,那么很难看出来这个边框。

frameless:限制图片的大小。会被自己设定的大小覆盖。忽略图片大小设定

border+frameless:限制图片的大小且显示一个小边框。一般来说,格式只应用填写的第一个,但是这个是例外。

浮动式

frame:默认靠右,可以填写图片标题,忽略图片大小设定

thumb 或 thumbnail:默认靠右,可以填写图片标题,可以缩小不能放大

大小

在参数中加上xxpx即可指定图片的大小,例如250px代表图片高度为250px
仅仅只有border或不指定格式,可以随意调整图片的大小。

水平对齐

(空):嵌入式。
none:同行不出现文字。
center:居中。
left:靠左对齐。
right:靠右对齐。

垂直对齐

大部分时候基本是用不上的,所以我直接抄个例子,看看就好。

top: Play result grade ex+.png Play result grade ex+.png Play result grade ex+.png

text-top: Play result grade ex+.png Play result grade ex+.png Play result grade ex+.png

super: Play result grade ex+.png Play result grade ex+.png Play result grade ex+.png

baseline: Play result grade ex+.png Play result grade ex+.png Play result grade ex+.png

sub: Play result grade ex+.png Play result grade ex+.png Play result grade ex+.png

default: Play result grade ex+.pngPlay result grade ex+.png Play result grade ex+.png

middle: Play result grade ex+.png Play result grade ex+.png Play result grade ex+.png

text-bottom: Play result grade ex+.png Play result grade ex+.png Play result grade ex+.png

'bottom: Play result grade ex+.png Play result grade ex+.png Play result grade ex+.png

图片链接

你可以添加一参数,来使点击图片时候跳转到对应的链接而不是文件页。

link= 目标

他可以添加内部链接,外部链接,或者填空。如果填空,那么该图片不可点击以跳转。
不需要添加[[]],直接写页面名或url即可。

链接到图像页面

如果要链接到文件页面而不是显示图片,在文件:前添加:即可。

[[:文件:文件名.文件格式]]

当然也可以使用|

[[:文件:文件名.文件格式|显示文字]]

使用Media:前缀替换文件:前缀可以直接链接到图片本身的伪页面。

[[:Media:文件名.文件格式]]

模板

模板其实也是wiki中的页面,但是他储存在模板名字空间,可以嵌入到其他页面。模板的页面名都是模板:模板名

使用模板

使用模板非常简单,只要在模板名加上双花括号,那么这个字段就会被替换成模板内的内容。例如下面这个例子:

{{模板名}}

然后{{模板名}}将会被模板:模板名中的内容动态地替换,也就是说当模板页面改动时,此页面也会一起改动。 可以通过这样的方式向模板传递参数:

{{模板名|参数1=111|参数2=222}}

具体的参数使用会在下文说明。同时这样也是允许的:

{{模板名
|参数1=111
|参数2=222}}

特殊的使用方法

通常而言,当你在页面中使用模板,在显示时会显示模板页面的内容,而查看代码时会显示{{模板名}}。但是可以通过添加subst:从而让显示的内容转换为源代码而不是调用模板页面。

这样做可以调整具体的显示效果,但是这个内容不会随着模板页面改动而改动。

{{subst:模板名称}}

还有一种直接转换为模板页面代码的方法是使用safesubst:,这种和上面不同的是允许不打破嵌入包含。

{{safesubst:模板名称}}

使用msgnw的话会直接把模板页面的源代码嵌入到页面,这意味着参数和wiki语法失效。

{{msgnw:模板名称}}

之前已经说了,模板其实也是wiki中的页面。这意味着wiki中普通的页面也可以当作模板嵌入到其他页面中。

实际上,在模板空间的模板仅仅只是在使用过程中可以省略模板:前缀,其他页面加上前缀可以起到一样的效果。

{{帮助:编辑}}

主空间的页面只要添加:即可。

{{:定数表}}

编辑模板

编辑一个模板只需要跳转到模板:模板名页面像普通页面一样编辑,就可以把这个更改应用到所有使用这个模板的页面中。

警告:更改模板可能会造成或大或小的影响,有可能会造成错误特别是涉及到参数的时候。请仔细检查你的更改并且使用下方“预览使用该模板的页面”检查!

参数

你可以在模板中添加参数{{{参数名}}}(注意是3个花括号),在使用模板时向模板传递参数从而改变模板的内容。例如模板页面模板:欢迎的内容是这样:

{{{被欢迎的人}}},欢迎来到Arcaea中文维基!

然后通过传递参数来改变模板的内容。

{{欢迎|被欢迎的人=新用户}}

这样会显示:

新用户,欢迎来到Arcaea中文维基!

隐式赋值

当参数名是数字时,例如{{{1}}} {{{2}}},那么你可以更简单的使用模板。

{{欢迎|参数1|参数2}}

这种情况下,按照顺序参数1会被赋到{{{1}}},参数2会被赋到{{{2}}}。隐式赋值不推荐用于复杂的模板。 当然,你也可以不使用隐式赋值,把数字仅仅当作模板名。

{{欢迎|2=参数2|1=参数1}}

这样也有相同的效果。

缺省值

有的时候想要做出这样一个效果:可以使用参数,但是不适用参数的时候有默认的内容。此时可以使用缺省值。

{{{参数名|参数}}}

在参数中加入管道符,管道符后面的内容会成为当没有使用参数时默认的内容。

顺带一提:有一个好用的用法,可以让隐式赋值和名称赋值同时使用。

{{{参数名|{{{1}}}}}}

使用这种参数时,你可以使用隐式赋值或者名称赋值其中之一,会选择其中有被赋值的参数。(按照参数设定的前后的顺序会决定同时都有赋值时使用哪个参数。)

控制嵌入内容

有时只需要嵌入页面一部分内容,而另外一部分内容只在模板页面内显示,可以使用下面几种方法。 <noinclude></noinclude>在这两个之间包含的内容不会嵌入到页面中,只在模板页面中显示。

<includeonly></<includeonly>在这两个之间包含的内容不会在模板页面中显示,只嵌入到页面中。

<onlyinclude></onlyinclude>使用这个时,只有在这两个之间包含的内容嵌入到页面中。这个标记优先级大于<includeonly>

解析器函数

#expr

使用下面这个函数计算并返回数学表达式的结果。

{{#expr: 表达式 }}

使用布尔代数时,0表示false,其他任何非0数值(无论正负)均表示true。

空表达式返回空值,错误的表达式返回错误信息。

置于数字前的加减号会被视为正负号而不会报错。

以下是支持的运算符。

运算符的说明参见meta-wiki

类型 运算符号
分组 ( )
数字 1234.5   e (2.718)   pi (3.142)
二进制操作者e 一元 +,-
Unary not ceil trunc floor abs exp ln sin cos tan acos asin atan
二进制 ^
* / div mod
+ -
取整 round
逻辑 = != <> > < >= <=
and
or

#if

此函数判断一个字符串是否为空。只包含半角空格的字符串被视为空字符串,这意味着,全角空格( )是不被当做空字符串的。

{{#if: 字符串 | 空值返回 | 非空值返回 }}

当字符串是空值时返回第二个参数,当字符串不是空值时返回第三个参数。 当字符串填写参数来判断是否赋值时,需要添加管道符:

{{#if: {{{参数名|}}} | 空值返回 | 非空值返回 }}

返回值不一定需要填写可以为空,这样就不会返回内容。这对于下面判断类型的解析器函数一致适用。

#ifeq

此函数判断两个输入字符串是否相同,并根据结果输出两个字符串的其中一个。如果需要更多的比较和输出字符串,请考虑使用#switch

{{#ifeq: 字符串1 | 字符串2 | 相同返回 | 不相同返回 }}

注意:区分大小写。

#switch

此函数将一个输入值与多个测试用例进行比较,如果找到匹配项,则返回关联的字符串。

{{#switch: 输入值 
 | 值1 = 输入值是值1时返回的内容 
 | 值2 = 输入值是值2时返回的内容
 | 当找不到一样的值时返回的内容 }}

还有一种高级的用法可以支持更多功能。

{{#switch: 1 
 | {{#ifexpr: 表达式 | 1 | 0 }} =
 | {{#if: 页面 | 1 | 0 }} = 返回值1
 | {{#ifeq: 字符串1 | 字符串2 | 1 | 0 }} = 返回值2 }}

#iferror

此函数以一个字符串为输入,然后在两条预选结果中取其一而返回。

{{#iferror: 字符串 | error返回 | correct返回 }}

这个函数可以认定解释器函数和模板等的错误。

{{#iferror: {{#expr: 表达式 }} | error | correct }}

与其他不同的是,如果不填写correct返回的内容,那么correct返回的内容会是被测字符串本身。

#ifexpr

此函数会判断数学表达式并根据其布尔值结果返回对应的字符串。

{{#ifexpr: 表达式 | true返回 | false返回 }}

#ifexist

此函数将一组字符串作为输入,并翻译成页面标题,然后根据在本地wiki上是否存在该页面而返回对应的值。

{{#ifexist: 页面名 | 存在时返回 | 不存在时返回 }}

#rel2abs

此函数将相对文件路径转换为绝对文件路径。

{{#rel2abs: 转换后的页面路径 | 转换前的页面路径 }}

在前面一个参数中,有两种参数会进行转换。

. 当前级别
.. 上一级

例如:

转换的页面 转换前 转换后
用户:用户名/sandbox/模板:测试 ./style.css 用户:用户名/sandbox/模板:测试/style.css
用户:用户名/sandbox/模板:测试 ../style.css 用户:用户名/sandbox/style.css

#time

此解析器函数需要日期和/或时间,并根据给定的语法设置其格式。可以指定日期/时间对象;默认值是魔法词的值,即页面最后呈现到 HTML 的时间。

#timel

local参数设置为true时,此函数与#time相同,因此它始终使用 wiki 的本地时间。

#titleparts

此函数根据斜杠将页面标题分隔为段,然后返回其中一些段作为输出。

{{#titleparts: 页面路径 | 要返回的段数 | 第一个返回段 }}

表格

表格在本维基的大量场合均有使用,下面给出一些基本表格代码。
参见: 表格

任务 您所输入的 您所看到的
Arcaea中文维基惯用表格格式下最简单的表格样例
{| border="1" cellspacing="1" cellpadding="5" style="text-align:center"
|-
! 标题文字1 !! 标题文字2 !! 标题文字3
|-
| 示例1 || 示例2 || 示例3
|-
| 示例4 || 示例5 || 示例6
|-
| 示例7 || 示例8 || 示例9
|}
标题文字1 标题文字2 标题文字3
示例1 示例2 示例3
示例4 示例5 示例6
示例7 示例8 示例9
设置表格边框、留白、背景、居中对齐、嵌套表格
{| border="1" cellspacing="1" cellpadding="5" align="center"
! 这
! 是
|- 
| 个
| 表格
|-
| colspan=2 |
{| border=3
| 表格嵌套
|-
| style="background:#ff3322" | 见否?
|}
|}
表格
表格嵌套
见否?
使用wikitable样式
{| class="wikitable"
! 也
! 可
|-
| 以
| 这样
|}
这样
折叠表格
{|class="wikitable mw-collapsible mw-collapsed"
!表格
!还可
!以
|-
|这样的格式
|适用于比较长的表格
|而对页面影响不大。
|}
表格 还可
这样的格式 适用于比较长的表格 而对页面影响不大。

列表

分类

重定向

创建重定向

  • 该功能用于把一个页面重定向至另一个页面,源代码为#redirect [[页面名]]当然,你也可以写成#重定向 [[页面名]]
    这样,就能把你所编辑的页面重定向到你所想重定向的目标页面。
  • 使用编辑窗口“高级”分类下的“插入”分类第二个图标可以快速创建重定向。

移动页面

  • 如果你的重定向目标页面不存在,此时就不需要重定向,你可以直接移动页面。
  • 移动页面不需要打开编辑窗口,直接在右上角的菜单中选择即可,按照系统指示即可完成移动。

更改/删除重定向

  • 更改或删除重定向需要在该页面没有重定向的状态下,更改源代码,将#redirect [[页面名]]部分更改或删除即可。
  • 进入还未重定向状态下的重定向页面的方法有:
    • 特殊:重定向页列表中进入;
    • 点击页面名下的小字重定向自页面名中的页面名进入;
    • 在网址中输入https://wiki.arcaea.cn/index.php?title={{{页面名}}}&redirect=no并进入页面。

魔术字

引用