Help:维基文本

来自滚动的天空Wiki

维基文本(wikitext)是指通过代码来呈现格式以及复杂内容的文本。绝大多数页面的源代码都是维基文本。当您编辑页面源代码时,您编辑的就是维基文本。注意:滚动的天空Wiki不开启可视化编辑器功能,您只能编辑页面源代码,也就是维基文本。

维基文本与Markdown格式有些类似,但又有区别。本页将简要列举一些维基文本格式。

请注意:在滚动的天空Wiki,使用任何格式都应该符合格式要求。格式不能任意使用,否则导致页面不美观、不整洁。

简单的行内格式[编辑源代码]

源代码 效果
''斜体'' 斜体
'''加粗''' 加粗
'''''粗斜体''''' 粗斜体
<nowiki>''忽略[[格式]]的文本''</nowiki> ''忽略[[格式]]的文本''

上述几种是最基本的格式。如需添加下划线、删除线、文本颜色等其他格式,请参考#HTML标记

请注意:nowiki内的文字会忽略繁简转换

段落格式[编辑源代码]

一般来说,自然段换行在代码中应当空行,否则在不会呈现换行。

源代码 效果
直接在源代码中换行
不会在结果中呈现

直接在源代码中换行 不会在结果中呈现

在源代码中空行

结果中才会呈现换行

在源代码中空行

结果中才会呈现换行

列表[编辑源代码]

无序列表的格式如下:

* 第一项
* 第二项
* 第三项
** 第三项的第一个子项
** 第三项的第二个子项
*** 第二个子项的子项
* 第四项

效果如下:

  • 第一项
  • 第二项
  • 第三项
    • 第三项的第一个子项
    • 第三项的第二个子项
      • 第二个子项的子项
  • 第四项

类似地,无序列表的格式如下:

# 第一项
# 第二项
# 第三项
## 第三项的第一个子项
## 第三项的第二个子项
### 第二个子项的子项
# 第四项

效果如下:

  1. 第一项
  2. 第二项
  3. 第三项
    1. 第三项的第一个子项
    2. 第三项的第二个子项
      1. 第二个子项的子项
  4. 第四项

从上面可以看出,无序列表和有序列表可以有不同缩进级别。列表不可越级缩进,否则会出现异常。

在代码内,项内不能换行,各项之间也不能换行,这与常规的段落格式不同。各项内如果确实需要换行,可以使用<br>强制折行。

定义[编辑源代码]

“定义”形式文本的格式如下:

; 第一项
: 第一项的定义
; 第二项
: 第二项的定义
: 第二项的第二个定义

效果如下:

第一项
第一项的定义
第二项
第二项的定义
第二项的第二个定义

注意:分号和冒号应当使用半角符号。此外,分号和冒号可以并在一行,但通常不建议使用,例如:

; 第一项 : 第一项的定义
; 第二项 : 第二项的定义

也可以直接使用冒号来缩进文本。这种情况下,代码中也不需要空行。例如:

未缩进的文本
: 缩进文本
: 缩进文本
未缩进的文本

效果如下:

未缩进的文本

缩进文本
缩进文本

未缩进的文本

预格式化[编辑源代码]

在文本前面加一个空格可以对文本进行预格式化。所有的格式、模板、魔术字、解析器函数等都可以使用,并且可以在代码中直接折行。例如:

预格式化文本示例:
 在行首使用空格。
 文本被'''预格式化'''并且
 '''''可以'''''使用''wiki标记''。

效果如下:

预格式化文本示例:

在行首使用空格。
文本被预格式化并且
可以使用wiki标记

链接[编辑源代码]

链接(link)是指点击之后能够跳转至站内或站外的另一个页面的文字。

内链[编辑源代码]

指向站内页面的链接称为内部链接(internal link)。内链的基本语法是:[[页面标题]]使用竖线(管道符)可以为链接指定不同的文字。一般情况下,链接文字是蓝色的,但如果链接至的页面不存在,则可能显示为红色。

源代码 效果
[[山丘]] 山丘
[[山丘|旧版第一关]] 旧版第一关

如果管道后面没有文字,则会自动补充不带前缀和后缀的文字(这种情况称为管道技巧(pipe trick))。例如:

源代码 效果
去除命名空间前缀:[[模块:Nowiki|]] Nowiki
去除结尾括号:[[关卡(消歧义)|]] 关卡
去除前缀和结尾括号:[[w:人民广场站 (消歧义)|]] 人民广场站
注意只会去除第一个前缀:[[mw:Help:Links|]] Help:Links
折断逗号:[[wikipedia:Il Buono, il Brutto, il Cattivo|]] Il Buono

注意:管道技巧无法用于<ref>标签、编辑摘要中,也无法用于段落标题。例如,[[#链接|]]会直接产生:[[#链接|]]。

在页面名称加上斜杠可以表示当前页面的子页面。斜杠前面可以加..表示退回一级。此外,在名称后面也加上斜杠可以避免斜杠出现。这是非常方便的语法。这种情况下,链接语法在保存时不会自动扩展。例如:

源代码 效果
[[/子页面]](链接至“Help:维基文本/子页面”) /子页面
[[/子页面/]](链接至“Help:维基文本/子页面”) 子页面
(位于“Help:维基文本/子页面1”中创建如下内容)

[[../子页面2]](链接至“Help:维基文本/子页面2”)

子页面2

此外,还有反管道技巧。在名称带有括号或逗号的页面中,如管道符前面没有文本,则会自动补充上完整的文本。

使用井号可以链接至页面的某个锚点(可以是章节标题,也可以是手动设置的锚点)。如果井号前面没有页面名称,则默认为当前页面,点击链接(除非是“在新窗口打开链接”)会直接跳转至相应位置,而不是加载页面。例如:

源代码 效果
[[#外链]](跳转到当前页面的“外链”这一段) #外链
[[Help:Lua#元表]] Help:Lua#元表

此外,部分语言页面具有词尾链接功能,会将链接自动应用至词尾。比如:

源代码 效果
[[wikipedia:Apple]]s(仅限英文页面) wikipedia:Apples
[[wikipedia:Apple]]trees(仅限英文页面) wikipedia:Appletrees
[[wikipedia:Apple]]Trees(仅限英文页面) wikipedia:AppleTrees

外链[编辑源代码]

外部链接(external link)是指链接至其他网站的链接。您可直接在文本中插入完整链接,亦可指定链接的显示文字。

源代码 效果
裸露完整链接:https://semver.org https://semver.org
指定显示:[https://semver.org SemVer网站] SemVer网站
显示为数字:[https://semver.org] [1]
省略协议:[//semver.org SemVer网站]
仅限在方括号中使用
SemVer网站
电邮:[mailto:info@example.org 示例电邮] 示例电邮
强制不产生链接:<nowiki>https://semver.org</nowiki> https://semver.org

可以为链接自定义URL,参见mw:Manual:$wgUrlProtocols

链接至站内页面[编辑源代码]

有时候你可能需要链接至站内页面,但需要设置URL参数,因此设置外部链接形式。可以使用{{fullurl:}}魔术字。例如:

源代码 效果
[{{fullurl:山丘|action=edit}} 编辑“山丘”] 编辑“山丘”

<span class="plainlinks">[{{fullurl:山丘|action=edit}} 编辑“山丘”]</span>[1]

编辑“山丘”
  1. 本站提供了{{fullurl}}模板,可以方便实现上述效果。此外,亦可使用特殊页面,如:[[Special:EditPage/山丘|编辑“山丘”]]

HTML标记[编辑源代码]

MediaWiki允许使用一部分HTML编辑。一些示例如下:

源代码 效果
<u>下划线</u><ins>下划线</ins> 下划线
<s>删除线</s><del>删除线</del> 删除线
<code>源代码格式的文本</code>[1] 源代码格式的文本
<blockquote>引用内容(会缩进)</blockquote>
引用内容(会缩进)
<q>带有引号(一般不使用)</q> 带有引号(一般不使用)
<tt>代码格式文本但不带背景</tt> 代码格式文本但不带背景
被注释掉的内容<!-- 比如这样 -->不会显示 被注释掉的内容不会显示
<pre>预格式化的多行文本</pre>[2]
预格式化的多行文本
<span style="color:orange">这是橙色的文字</span>[3] 这是橙色的文字
  1. 注意:这种情况默认会禁用繁简转换,如需启用繁简转换,可手动加入-{}-,例如:
    源代码 效果
    <code>简体繁體都会轉換-{}-</code>
    
    简体繁體都会轉換

    此外,本站亦提供{{code}}模板,更加方便。

  2. 注意:这种情况默认会禁用繁简转换,如需启用繁简转换,可手动加入-{}-,例如:
    源代码 效果
    <pre>简体繁體都会轉換-{}-</pre>
    
    简体繁體都会轉換
  3. 不推荐写成<font color="orange">这是橙色的文字</font>。此外,本站亦有{{color}}模板,可以更方便使用。