关于我
哔哩哔哩 @靠墙的钴-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>
注释示例
模板
- 如果有一些内容在页面中格式相同但数据不同(套用同一个壳),那么可以为它定制一个模板。
模板的特点:集中书写,分开引用。
- 例如:
{{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。
- 效果:
{{红色警戒2}}
|
→ | |
{{红色警戒2|苏联}}
|
→ |
图片
音频、音频模板
wiki页面留言
noinclude
html、样式
插入B站视频
<div class="bilibili"> BV1XE411L7k2 </div>
|
→ | BV1XE411L7k2
|
开启评论自动刷新
在荷兰的威廉二世
白某不转圈
OrangePig