关于我
哔哩哔哩 @靠墙的钴-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 /> |
→ | (总之就是个评论区) |
把评论区加在页面代码的最后。
注释&引用&参考文献
参见帮助:插入注释。
此处“注释”不是指HTML注释,而是指wiki文章注释。
插入注释:
这是一段文字<ref>这是注释内容</ref> |
→ | 这是一段文字[1] |
注释内容可以是一段话,也可以是一个链接:
这是一段文字<ref>这是注释内容,包含了一个链接:http://mediawiki.org</ref> |
→ | 这是一段文字[2] |
点击注释符号,可以跳转到注释列表。在注释列表,点击某个注释带有的“↑”符号,也可以回到这个注释在文章中的位置。
注释列表会在页面底部会自动形成,包含该页面所有的注释。
也可以用<references />
改变注释列表的位置:
<references /> |
→ |
|
模板
- 如果有一些内容在页面中格式相同但数据不同(套用同一个壳),那么可以为它定制一个模板。
模板的特点:集中书写,分开引用。
- 例如:
{{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