关于我
哔哩哔哩 @靠墙的钴-60
挖坑
皇室战争 进展：
|
|||||||||||||||||||||||||||||||||||||
写在前面
欢迎参与语音维基的编辑！在开始编辑前，请务必学习Wiki语法。本文是Voicewiki的语法入门教程。
如果有HTML语法基础，接下来的学习会轻松很多，因为Voicewiki支持主要的HTML脚本。
这个栏目是按照要点编写的（二轮复习），无法涵盖所有的Voicewiki格式。请先通过目录了解一下这里都写了什么。
学会了语法并不意味着可以任意进行编辑。格式规范也是Wiki生态的重要部分。
官方文档
- Voicewiki采用Mediawiki作为引擎，可以参考Mediawiki的文档。
格式化文本
这是wiki最基本的功能。（其中一些格式不常用的，忘了吧（doge））。
- 参见Mediawiki官方文档 帮助:格式化文本 - Mediawiki。
这里只列出常用的。
右边是html注释 <!--注释内容--> 左边是html注释 |
→ | 右边是html注释 左边是html注释 |
写在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> |
或 | ======六级标题====== |
→ | 六级标题 |
- 目录最多六级。
- 需要特别注意的是，一级标题（
=一级标题=）是给条目大标题使用的，不要随意使用。
- 当正文内容与标题足够多（达到3个）的情况下，系统会自动在第一个标题之前生成一个目录。
超链接
- 参见帮助:插入链接。
内链
[[首页]] |
→ | 首页 |
[[首页|这里链接到首页]] |
→ | 这里链接到首页 |
外链
[http://mediawiki.org Mediawiki] |
→ | Mediawiki |
http://mediawiki.org |
→ | http://mediawiki.org |
[http://mediawiki.org] |
→ | [1] |
- 如果不给加了方括号的外链命名，会自动分配一个序号。
- （链接到分类页面）：
[[:分类:索引]]
|
→ | 分类:索引 |
[[:分类:索引|点这里查看分类:索引]]
|
→ | 点这里查看分类:索引 |
- 不要把外链当内链用。
评论区
<comments />
|
→ | （总之就是个评论区） |
- 把评论区加在页面代码的最后。
注释&引用&参考文献
- 主页面：帮助:插入注释
和上面的源代码注释意义不同，这里是真正意义上的注释。在Wiki中，如果要对某处添加注释，可以使用<ref>标签，简单使用方法如下：
<ref>注释内容</ref>
插入注释以后，注释内容会自动在页面底部生成，当然您也可以使用<references />标签手动指定注释列表生成的位置，一般放置在页面底部。
在注释中，您可以插入一段话，也可以插入一个链接。例如：
您可以点击右上角的注释角标定位到注释列表。<ref>也可以点击左侧的箭头返回注释的位置。</ref>您也可以在注释中插入链接。<ref>[https://en.wikipedia.org/ 维基百科]</ref>
您可以点击右上角的注释角标定位到注释列表。[1]您也可以在注释中插入链接。[2]
注释示例
模板
- 如果有一些内容在页面中格式相同但数据不同（套用同一个壳），那么可以为它定制一个模板。
模板的特点：集中书写，分开引用。
- 例如：
{{Crcard|}}
|
→ |
- 要引用一个模板，用
模板:模板名称</nowiki>。
- 所有的模板（包括Mediawiki自带的和其他编辑者创建的）都可以在:分类:模板找到。
- 几个基本的模板：
| {{Chief}} |
| {{Constructing}} |
| {{W}} |
| {{Info}} |
| {{QA}} |
| {{AudioButton}} |
| {{Mask}} |
| {{流彩字}} |
| {{需要补充}} |
| {{需要翻译}} |
- 在模板的页面，可以写入
</nowiki>来引用名为“doc”的子页面。参见模板:Documentation
- 在写模板时，如果希望在引用模板时不要显示某些内容（例如对模板文档本身的介绍），可以把不希望显示的内容放在
</nowiki>里。
- 模板的代码里也可以引用模板。
上文中提到的{{Color}}就是一种模板。同样的，把这个模板以特定格式显示在这里的{{tl}}模板也是一种模板。如果点击前面的模板链接，可以看到模板的页面地址格式是“模板:模板名”。
如果我们把{{tl}}拆开来可以看到以下代码：
{{{{ {{{|safesubst:}}}#if:{{{3|}}}|{{{3|}}}:|}}[[{{ {{{|safesubst:}}}ns:Template}}:{{{1}}}|{{{1}}}]]{{ {{{|safesubst:}}}#if:{{{2|{{{arg|}}}}}}|{{!}}{{{2|{{{arg}}}}}}}}}}
显然这段代码十分不利于阅读、使用和维护，而模板的作用就是简化这一过程。
事实上，如果你急于完成入门学习的话，这个章节可以以后再看，因为模板文档会告诉你如何使用模板，例如{{color}}。
使用模板和赋予参数
例如，我们可以这样使用这个模板：{{tl|color}} 来显示这样的效果：{{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模板 |
| 游戏的大家族模板: | → | 大家族模板 |
- 如果要链接到分类页面：
[http://voicewiki.cn/wiki/分类:按游戏分类 分类:按游戏分类]
|
→ | 分类:按游戏分类 |
- 为了方便在游戏wiki的子页面进行导航，需要设置大家族模板。
- 大家族模板一般直接写作
模板:游戏名称</nowiki>。
- 大家族模板一般会使用Navbox模板。参见模板:Navbox。
- 所有的大家族模板可以在分类:大家族模板找到。
- 引用大家族模板时，可以设置参数，选择要展开的Navbox subgroup。不设置额外的参数，则默认展开所有subgroup。
- 效果：
图片
音频、音频模板
wiki页面留言
noinclude
html、样式
插入B站视频
<div class="bilibili"> BV1XE411L7k2 </div>
|
→ | BV1XE411L7k2
|
开启评论自动刷新
在荷兰的威廉二世
白某不转圈
OrangePig