关于我
哔哩哔哩 @靠墙的钴-60
挖坑
皇室战争 进展:
|
Wiki语法入门(维护中):
欢迎参与语音维基的编辑!在开始编辑前,请务必学习Wiki语法。本文是Voicewiki的语法入门教程。
初步了解wiki语法并不难。点击一个页面的“查看源代码”或“编辑”按钮,再对照它们的显示效果,就可以看出Wiki语法的大致样貌。
Voicewiki使用Mediawiki引擎,因此语法与Mediawiki大同小异。Mediawiki支持部分HTML,因此Voicewiki也可以使用部分HTML。
这个页面是众多Wiki帮助文档之一。要查看所有的Wiki帮助文档,参见帮助:索引。
接下来就正式开始吧!
文本样式
什么是文本样式呢?这样,这样,这样都是文本样式。这是wiki最基本的功能。
这里只列出常用的。
字形
代码 | → | 效果 |
''这是斜体'' |
→ | 这是斜体 |
'''这是加粗''' |
→ | 这是加粗 |
'''''这是加粗斜体''''' |
→ | 这是加粗斜体 |
<b>这是加粗</b> |
→ | 这是加粗 |
<u>这是下划线</u> |
→ | 这是下划线 |
<s>这是删除线</s> |
→ |
可以看出,下划线和删除线用到了HTML中的标签和标签。
颜色
可以使用{{color}}<nowiki><code>改变文字前景色,<code><nowiki>{{bgcolor}}<nowiki><code>改变文字背景色。使用方法参见[[模板:Color]]、[[模板:Bgcolor]]。
(这不是Mediawiki原有的实现方法,因此在其他Wiki上可能并不适用。)
也可以使用HTML的<code><nowiki><font>
或<div style="xxxxx">
。
换行、换段
在编辑页面显示的换行,不一定真的会换行(不是bug,是特性)。
在Voicewiki中,“换行”有两种不同的方法。分别是“另起一行”和“另起一段”。它们有略微的区别:
这是一行文字 <br> 另起了一行 另起了一段
这是一行文字
另起了一行
另起了一段
标题、目录
<h2>二级标题</h2> |
或 | ==二级标题== |
→ | 二级标题 |
<h3>三级标题</h3> |
或 | ===三级标题=== |
→ | 三级标题 |
<h4>四级标题</h4> |
或 | ====四级标题==== |
→ | 四级标题 |
<h5>五级标题</h5> |
或 | =====五级标题===== |
→ | 五级标题 |
<h6>六级标题</h6> |
或 | ======六级标题====== |
→ | 六级标题 |
标题最多六级。
需要特别注意的是,一级标题(=这是一级标题=
)是给条目大标题使用的,不要随意使用。
当正文内容与标题足够多的情况下,系统会自动在第一个标题之前生成目录。
链接
参见帮助:插入链接。
内链
[[首页]] |
→ | 首页 |
[[首页|这里链接到首页]] |
→ | 这里链接到首页 |
外链
[http://mediawiki.org Mediawiki] |
→ | Mediawiki |
http://mediawiki.org |
→ | http://mediawiki.org |
[http://mediawiki.org] |
→ | [1] |
如果不给加了方括号的外链命名,会自动编号。
不要把外链当内链用。
代码注释
代码注释不会显示在页面中,只会显示在代码中:
括号里是代码注释(<!--注释内容-->) |
→ | 括号里是代码注释() |
评论区
<comments /> |
→ | (总之就是个评论区) |
评论区应加在代码的末尾,这样它就会显示在页面的末尾。
文本注释
参见帮助:插入注释。
此处“注释”不是指HTML注释,而是指Wiki文章注释。
插入注释:
这是一段文字<ref>这是注释内容</ref> |
→ | 这是一段文字[1] |
注释内容可以是一段话,也可以是一个链接:
这是一段文字<ref>这条注释包含了一个链接:http://mediawiki.org</ref> |
→ | 这是一段文字[2] |
点击注释符号,可以跳转到注释列表。在注释列表,点击某个注释带有的“↑”符号,也可以回到这个注释在文章中的位置。
注释列表会在页面底部会自动形成,包含该页面所有的注释。
也可以用<references />
改变注释列表的位置:
<references /> |
→ |
|
引用模板
模板是其他编辑者建立的模块化的代码。模板建立后,通过引用这个模板(并填写一些参数),可以减少页面间的重复代码,并减少代码维护的工作量。
参见帮助:模板。
{{模板名称}}
。对于需要附带参数的模板,用{{模板名称|参数...}}<nowiki><code>。
所有的模板(包括Mediawiki自带的和其他编辑者创建的)都可以在[[:分类:模板]]找到。
一些常用的模板:
{| align=center
|- align=center
|[[模板:Chief]]
|- align=center
|[[模板:Constructing]]
|- align=center
|[[模板:W]]
|- align=center
|[[模板:Info]]
|- align=center
|[[模板:AudioButton]]
|- align=center
|[[模板:Mask]]
|- align=center
|[[模板:需要补充]]
|- align=center
|[[模板:需要翻译]]
|- align=center
|[[模板:Navbox]]
|- align=center
|[[模板:Documentation]]
|}
如何使用这些模板呢?请参考模板的说明文档。也可以观察其他页面下已经存在的使用方法。
注意:一些模板不能在所有页面间随意引用,因为它们可能是给某个游戏的页面定制的。如[[模板:CREmote]]是给[[皇室战争]]的页面定制的。
==分类==
为了让整个wiki的结构更清晰{{Mask|Content=同时满足自己的强迫症}},需要给页面分类。
所有的分类可以在[http://voicewiki.cn/wiki/分类:索引 分类:索引]找到。
分类页面本身也可以被分类。一个页面可以同时处于多个分类。
{| align=center
|-
|<pre>[[分类:按游戏分类]]</pre>
|→
|(总之就是会显示在页面的最后)
|}
分类建议:
{| align=center
|- align=center
|游戏的首页
|→
|分类:按游戏分类
|- align=center
|游戏的其他页面
|→
|分类:xxxx(游戏名)
|- align=center
|游戏所用的的模板
|→
|分类:xxxx模板
|- align=center
|游戏的大家族模板:
|→
|分类:xxxx(游戏名)|大家族模板
|}
==图片、音频==
==表格==
==HTML、HTML样式==
Voicewiki支持部分HTML和HTML样式,例如:
{| align=center
|-
|<pre><div width=50vw style="background: pink;">一段文字</div></pre>
|→
|<div width=50vw style="background: pink;">一段文字</div>
|}
参见[https://m.mediawiki.org/wiki/HTML_restriction/zh HTML限制-MediaWiki]。
<!--[[分类:Wiki帮助]]-->
</div>
格式速成班(维护中):
<div align="center" style="border-radius: 3px; background: #333; width: 100%; padding: 20px; font-size:5px;">
==写在前面==
''欢迎参与语音维基的编辑!在开始编辑前,请务必学习Wiki语法。本文是Voicewiki的语法入门教程。''
''如果有HTML语法基础,接下来的学习会轻松很多,因为Voicewiki支持主要的HTML脚本。''
这个栏目是按照要点编写的{{Mask|Content=二轮复习}},无法涵盖所有的Voicewiki格式。请先通过目录了解一下这里都写了什么。
''学会了语法并不意味着可以任意进行编辑。格式规范也是Wiki生态的重要部分。''
==官方文档==
[[语音维基:用户手册]]
[[语音维基:格式规范]]
[[帮助:索引]]
Voicewiki采用Mediawiki作为引擎,可以参考[http://mediawiki.org Mediawiki的文档]。
==格式化文本==
''这是wiki最基本的功能{{Mask|Content=其中一些格式不常用的,忘了吧(doge)}}。''
参见Mediawiki官方文档 [http://mediawiki.org/wiki/Help:Formatting/zh 帮助:格式化文本 - Mediawiki]。
''这里只列出常用的。''
{| align=center
|-
|<pre>右边是html注释 <!--注释内容--> 左边是html注释</pre>
|→
|右边是html注释 <!--注释内容--> 左边是html注释
|-
|<pre><nowiki>写在nowiki里的<div>代码</div>
|→
|写在nowiki里的<font color=pink>代码</font>
|-
|<pre>写在pre里的<font color=pink>代码</font></pre>
|→
|写在pre里的<font color=pink>代码</color>
|-
|<code>写在code里的<font color=pink>代码</font></code>
|→
|写在code里的代码
|-
|''这是斜体''
|→
|这是斜体
|-
|'''这是加粗'''
|→
|这是加粗
|-
|'''''这是加粗斜体'''''
|→
|这是加粗斜体
|}
也可用HTML的文字样式代码:
<b>这是加粗</b>
→
这是加粗
<u>这是下划线</u>
→
这是下划线
<s>这是删除线</s>
→
这是删除线
颜色
可以使用模板:color改变文字前景色,模板:bgcolor改变文字背景色,使用方法参见模板页面。
这不是Wiki原有的实现方法,因此在其他Wiki上可能并不适用。
当然,也可以使用HTML的<font>
或<div style="xxxxx">
。
换行、换段
在编辑页面显示的换行,不一定真的会换行(不是bug,是特性)。
在Voicewiki中,“换行”有两种不同的方法。分别是“另起一行”和“另起一段”。它们有略微的区别:
这是一行文字
<br>
另起了一行
另起了一段
↓
这是一行文字
另起了一行
另起了一段
标题、目录
<h2>二级标题</h2>
或
==二级标题==
→
二级标题
<h3>三级标题</h3>
或
===三级标题===
→
三级标题
<h4>四级标题</h4>
或
====四级标题====
→
四级标题
<h5>五级标题</h5>
或
=====五级标题=====
→
五级标题
<h6>六级标题</h6>
或
======六级标题======
→
六级标题
标题最多六级。
需要特别注意的是,一级标题(=这是一级标题=
)是给条目大标题使用的,不要随意使用。
当正文内容与标题足够多的情况下,系统会自动在第一个标题之前生成目录。
超链接
参见帮助:插入链接。
内链
[[首页]]
→
首页
[[首页|这里链接到首页]]
→
这里链接到首页
外链
[http://mediawiki.org Mediawiki]
→
Mediawiki
http://mediawiki.org
→
http://mediawiki.org
[http://mediawiki.org]
→
[2]
如果不给加了方括号的外链命名,会自动分配一个序号。
(链接到分类页面):
[[:分类:索引]]
→
分类:索引
[[:分类:索引|点这里查看分类:索引]]
→
点这里查看分类:索引
不要把外链当内链用。
评论区
<comments />
→
(总之就是个评论区)
把评论区加在页面代码的最后。
注释&引用&参考文献
参见帮助:插入注释。
此处“注释”不是指HTML注释,而是指wiki文章注释。
插入注释:
这是一段文字<ref>这是注释内容</ref>
→
这是一段文字[1]
注释内容可以是一段话,也可以是一个链接:
这是一段文字<ref>这条注释内容包含了一个链接:http://mediawiki.org</ref>
→
这是一段文字[2]
点击注释符号,可以跳转到注释列表。在注释列表,点击某个注释带有的“↑”符号,也可以回到这个注释在文章中的位置。
注释列表会在页面底部会自动形成,包含该页面所有的注释。
也可以用<references />
改变注释列表的位置:
<references />
→
- ↑ 这是注释内容
- ↑ 这条注释内容包含了一个链接:http://mediawiki.org
模板
如果有一些内容在页面中格式相同但数据不同(套用同一个壳),那么可以为它定制一个模板。
模板的作用:简化代码,减少写代码的工作量。
引用模板
要引用一个模板,用{{模板名称}}
。
所有的模板(包括Mediawiki自带的和其他编辑者创建的)都可以在分类:模板找到。
一些常用的模板:
模板:Chief
模板:Constructing
模板:W
模板:Info
模板:AudioButton
模板:Mask
模板:需要补充
模板:需要翻译
模板:Navbox
模板:Documentation
建立模板、设置参数
模板本身也写在一个页面里。
以{{tl|color}}
为例。名为tl的模板有一个参数:color
。
模板可以拥有多个参数:
{{tl|color|#FFF}}
显示为:{{color|#FFF}}
模板也可以不接受参数,就像这样:{{color}}
当然,这么做对于一些必须接受参数的模板来说会出现问题,不过也有些模板不需要接受参数就可以使用。
那么问题来了:我不想指定第一个参数,只想指定第二个参数,该如何编写呢?方法很简单:{{tl|2=#FFF}}
“2”代表第二个参数,因为这个参数没有被命名,所以称之为匿名参数。使用等于号将右侧的内容赋值给这个参数。
总而言之,使用匿名参数的模板的使用方式可总结为:
{{模板名}}
{{模板名|参数1}}
{{模板名|参数1|参数2}}
{{模板名|1=参数1|2=参数2}}
{{模板名|参数1|参数2|...|参数N}}
有匿名参数,当然也会有非匿名参数。
例如,在{{Info}}模板中,定义了width、title、text等参数。使用方法为:
{{info|width=50%|title=标题|text=文本}}
也可以写成多行样式,易于阅读:
{{info
|width=50%
|title=标题
|text=文本
}}
需要注意的是,这些参数不能以匿名参数的方式使用,例如你不能用“1”或不填写参数名的第一个参数去指代“width”,这些模板在设计的时候可能会考虑快速使用的情况,因此具体如何使用还需阅读随附于模板页面的模板文档。
总而言之,使用非匿名参数的模板的使用方式可总结为:
{{模板名}}
{{模板名|参数名1=参数值1}}
{{模板名|参数名1=参数值1|参数名2=参数值2}}
{{模板名|参数名1=参数值1|参数名2=参数值2|...|参数名N=参数值N}}
关于模板的一些细节
- 同一个页面中重复使用同一个模板不会产生参数冲突。
除非模板的设计者干了件蠢事。
- 模板参数支持输入多行数据。
- 如果你发现匿名参数在处理多行数据时出现了点小问题,试试给他加上参数名。
分类
为了让整个wiki的结构更清晰(同时满足自己的强迫症),需要给页面分类。
所有的分类可以在分类:索引找到。
分类页面本身也可以被分类。一个页面可以同时处于多个分类。
[[分类:按游戏分类]]
→
(总之就是会显示在页面的最后)
分类建议:
游戏的首页
→
分类:按游戏分类
游戏的其他页面
→
分类:xxxx(游戏名)
游戏所用的的模板
→
分类:xxxx模板
游戏的大家族模板:
→
大家族模板
为了方便在游戏wiki的子页面进行导航,需要设置大家族模板。
大家族模板一般直接写作{{游戏名称}}
。
大家族模板一般会使用Navbox模板。参见模板:Navbox。
所有的大家族模板可以在分类:大家族模板找到。
引用大家族模板时,可以设置参数,选择要展开的Navbox subgroup。不设置额外的参数,则默认展开所有subgroup。例如:
图片
音频、音频模板
wiki页面留言
noinclude
html、样式
插入B站视频
<div class="bilibili">BV1XE411L7k2</div>
→
BV1XE411L7k2
开启评论自动刷新
在荷兰的威廉二世
白某不转圈
OrangePig