小 (→模板) |
|||
第12行: | 第12行: | ||
{{皇室战争}} | {{皇室战争}} | ||
+ | 引用测试: | ||
− | {{ | + | {{:帮助:Wiki语法入门}} |
− | |||
− | |||
第208行: | 第207行: | ||
|→ | |→ | ||
|[http://mediawiki.org] | |[http://mediawiki.org] | ||
+ | |} | ||
+ | |||
+ | |||
+ | *特殊情况(链接到分类页面): | ||
+ | |||
+ | {| align=center | ||
+ | |- | ||
+ | |<pre>[[:分类:索引]]</pre> | ||
+ | |→ | ||
+ | |[[:分类:索引]] | ||
+ | |- | ||
+ | |<pre>[[:分类:索引|点这里查看分类:索引]]</pre> | ||
+ | |→ | ||
+ | |[[:分类:索引|点这里查看分类:索引]] | ||
|} | |} | ||
第214行: | 第227行: | ||
− | * | + | *不要把外链当内链用。 |
===链接到页面中某一章节=== | ===链接到页面中某一章节=== |
2021年4月22日 (四) 18:33的版本
关于我
哔哩哔哩 @靠墙的钴-60
挖坑
皇室战争 进展:
|
引用测试:
欢迎参与语音维基的编辑!在开始编辑前,您需要学习Wiki语法,本文将指导您如何使用Wiki语法。如果您有HTML语法基础,接下来的学习会轻松很多。
字形
粗体与斜体
粗体与斜体使用英文单引号标记,粗体是三个单引号,斜体是两个单引号,使用方法如下所示:
'''粗体''' ''斜体'' '''''粗体和斜体'''''
其表现效果为: 粗体 斜体 粗体和斜体
下划线和删除线
在Wiki中,下划线和删除线使用HTML标签:
<u>下划线</u> <s>删除线</s>
效果为:
下划线
删除线
颜色
在本Wiki中,您可以使用 {{Color}}
模板改变文字前景色,{{Bgcolor}}
模板改变文字背景色,使用方法请点击模板链接查看。这不是 Wiki 原生方法,因此在其他 Wiki 上可能并不适用。
例如:
{{Color|#0af|天蓝色的文字}}
显示为:天蓝色的文字
{{Bgcolor|#707|紫色的背景}}
显示为:紫色的背景
行内代码和代码块
在 Wiki 中没有对应的便捷语法,只能通过 HTML 标签进行定义。
使用 HTML <code> 标签定义行内代码:
这是一段行内代码 <code>This is an inline code</code>
效果为:
这是一段行内代码 This is an inline code
使用 HTML <pre> 标签定义一个多行代码块:
<pre> 这是一个代码块 </pre>
效果:
这是一个代码块
换行与换段
在Wiki上,需要使用<br>
标签换行,但不会起一个新的段落,这不适用于一般的文章换行。因此,更多情况下应该使用两次回车换行:
第一段落 <-- 这里一个回车 <-- 这里又一个回车 第二段落
换行与换段的区别可以在垂直间距上看出来:
你看现在这里起了一个新的段落。
这里换行了,但是没有起一个新的段落。
这又是一个新的段落。
链接
- 主页面:帮助:插入链接
内部链接
如果需要引用Wiki内部的链接,需要使用两对方括号[[]]
,具体操作方法如下:
[[页面完整名称]] [[页面完整名称|显示名称]]
例如在这里插入一个首页的链接:首页
还是首页链接,但是改一下显示名称:Mainpage
外部链接
和插入外部链接类似,仅需使用一对方括号[[]]
,具体操作方法如下:
[URL地址] [URL地址 显示名称]
例如插入维基百科的链接:[1] ←如果不写任何名称,链接将会开始编号。
为其添加显示名称:维基百科
另外,外部链接也可以直接插入不做任何修饰:https://en.wikipedia.org/
标题&章节
如您所见,这篇文章的层次结构清晰,正是因为↑↑↑这个标题的功劳。您可以使用英文等号制作标题,方法如下:
== 二级标题 == === 三级标题 === ==== 四级标题 ==== ===== 五级标题 =====
等号与内容之间的空格仅仅是为了代码好看,没有实际作用。
需要特别注意的是:一级标题(= 一级标题 =
)是给条目大标题使用的,不要随意使用。
当正文内容与标题足够多的情况下,系统会自动在第一个标题之前生成一个目录。
源代码注释
如果您需要为其他编辑者留下一些信息,或者暂时删掉一段不用的代码,可以使用源代码注释功能。和HTML一样,Wiki使用这种格式注释内容:
<!-- 注释内容 -->
放入注释中的内容不会被显示出来,您可以点击本页的【编辑/查看源代码】来阅读这里的隐藏信息。
注释&引用&参考文献
- 主页面:帮助:插入注释
和上面的源代码注释意义不同,这里是真正意义上的注释。在Wiki中,如果要对某处添加注释,可以使用<ref>
标签,简单使用方法如下:
<ref>注释内容</ref>
插入注释以后,注释内容会自动在页面底部生成,当然您也可以使用<references />
标签手动指定注释列表生成的位置,一般放置在页面底部。
在注释中,您可以插入一段话,也可以插入一个链接。例如:
您可以点击右上角的注释角标定位到注释列表。<ref>也可以点击左侧的箭头返回注释的位置。</ref>您也可以在注释中插入链接。<ref>[https://en.wikipedia.org/ 维基百科]</ref>
您可以点击右上角的注释角标定位到注释列表。[1]您也可以在注释中插入链接。[2]
注释示例
模板
繁琐重复的代码不利于理解和维护,如果将其包装为一个模板,就可以方便的使用,同时也更利于理解。在语音维基中,模板是一种重要的工具。
上文中提到的{{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}}
关于模板的一些细节
- 同一个页面中重复使用同一个模板不会产生参数冲突。
除非模板的设计者干了件蠢事。 - 模板参数支持输入多行数据。
- 如果你发现匿名参数在处理多行数据时出现了点小问题,试试给他加上参数名。
另见
格式速成班:
写在前面
欢迎参阅Voicewiki格式速成班!
- 这个栏目是按照要点编写的(二轮复习),无法涵盖所有的Voicewiki格式。请先通过目录了解一下这里都写了什么。
- 一些操作需要高级权限,例如创建文档。这种限制并不是平白无故地设置的。因此,在进行这些操作前,先与其他编辑者/站长进行确认,确保你的操作是合适的。(惨痛教训)
- 挖了坑一定要填,不要一挖一堆坑然后跑路。
- 从别的页面复制来的代码,虽然都能正常显示,但是有一些代码不应该直接复制粘贴,例如给这个游戏wiki定制的模板。
官方文档
Voicewiki格式速成班是一个非官方栏目,如果与官方文档的描述冲突,请以官方文档为准(顺便Cue我进行修改~)。
- Voicewiki采用Mediawiki作为引擎,可以参考Mediawiki的文档。
格式化文本
这是wiki最基本的功能。(其中一些格式不常用的,忘了吧(doge))。
- 参见Mediawiki官方文档 帮助:格式化文本 - Mediawiki。
这里只列出常用的。
<!--这是html注释,不会显示在页面上,只会显示在代码里--> |
→ | |
nowiki |
→ | |
pre |
→ | |
code |
→ | |
''这是斜体。'' |
→ | 这是斜体。 |
'''这是加粗。''' |
→ | 这是加粗。 |
'''''这是加粗斜体。''''' |
→ | 这是加粗斜体。 |
- 也可用html的文字样式代码。例如:
<b>这是加粗</b> |
→ | 这是加粗 |
回车、换行
- 在编辑页面显示的换行,不一定真的会换行(不是bug,是特性)。这时候就再补一个。
- 换行可以直接回车,也可以用
<br>
:
换<br>行 |
→ | 换 行 |
目录、小标题
==二级目录== |
→ | ==二级目录== |
===三级目录=== |
→ | ===三级目录=== |
====四级目录==== |
→ | ====四级目录==== |
=====五级目录===== |
→ | =====五级目录===== |
======六级目录====== |
→ | ======六级目录====== |
- 目录最多六级。
- 一级目录留给标题用。
- 也可以用html代码:
<h2>二级目录</h2> |
→ | 二级目录 |
<h3>三级目录</h3> |
→ | 三级目录 |
<h4>四级目录</h4> |
→ | 四级目录 |
<h5>五级目录</h5> |
→ | 五级目录 |
<h6>六级目录</h6> |
→ | 六级目录 |
超链接
内链
[[User:Kqa|我的主页]] |
→ | 我的主页 |
外链
[http://mediawiki.org Mediawiki] |
→ | Mediawiki |
http://mediawiki.org |
→ | http://mediawiki.org |
[http://mediawiki.org] |
→ | [2] |
- 特殊情况(链接到分类页面):
[[:分类:索引]] |
→ | 分类:索引 |
[[:分类:索引|点这里查看分类:索引]] |
→ | 点这里查看分类:索引 |
- 如果不给加了方括号的外链命名,会自动分配一个序号。
- 不要把外链当内链用。
链接到页面中某一章节
[http://voicewiki.cn/wiki/User:Kqa#超链接 进入这一页面且定位到“超链接”章节] |
→ | 进入这一页面且定位到“超链接”章节 |
链接到某一评论
- 评论下都有“固定评论|回复”的按钮。点击“固定回复”,然后从浏览器复制网址。
评论区
<comments /> |
→ | (总之就是个评论区) |
- 把评论区加在页面代码的最后。
模板
- 如果有一些内容在页面中格式相同但数据不同(套用同一个壳),那么可以为它定制一个模板。
模板的特点:集中书写,分开引用。
- 例如:
{{Crcard|}} |
→ |
- 要引用一个模板,用
{{模板名称}}
。
- 所有的模板(包括Mediawiki自带的和其他编辑者创建的)都可以在:分类:模板找到。
- 几个基本的模板:
{{Chief}} |
{{Constructing}} |
{{W}} |
{{Info}} |
{{QA}} |
{{AudioButton}} |
{{Mask}} |
{{流彩字}} |
{{需要补充}} |
{{需要翻译}} |
- 在模板的页面,可以写入
{{doc}}
来引用名为“doc”的子页面。参见模板:Documentation
- 在写模板时,如果希望在引用模板时不要显示某些内容(例如对模板文档本身的介绍),可以把不希望显示的内容放在
<noinclude></noinclude>
里。
- 模板的代码里也可以引用模板。
分类
- 为了让整个wiki的结构更清晰(同时满足自己的强迫症),需要把页面进行分类。
- 所有的分类可以在分类:索引找到。
- 分类页面本身也可以分类。一个页面可以同时写多个分类。
[[分类:按游戏分类]] |
→ | (总之就是会显示在页面的最后) |
- 分类建议:
游戏的首页 | → | 分类:按游戏分类 |
游戏的其他页面 | → | 分类:xxxx(游戏名) |
游戏所用的的模板 | → | 分类:xxxx模板 |
游戏的大家族模板: | → | 大家族模板 |
- 如果要链接到分类页面:
[http://voicewiki.cn/wiki/分类:按游戏分类 分类:按游戏分类] |
→ | 分类:按游戏分类 |
- 为了方便在游戏wiki的子页面进行导航,需要设置大家族模板。
- 大家族模板一般直接写作
{{游戏名称}}
。
- 大家族模板一般会使用Navbox模板。参见模板:Navbox。
- 所有的大家族模板可以在分类:大家族模板找到。
- 引用大家族模板时,可以设置参数,选择要展开的Navbox subgroup。不设置额外的参数,则默认展开所有subgroup。
- 效果:
图片
音频、音频模板
wiki页面留言
noinclude
html、样式
插入B站视频
<div class="bilibili">BV1XE411L7k2</div> |
→ | BV1XE411L7k2
|
写在最后
开启评论自动刷新
在荷兰的威廉二世
白某不转圈
OrangePig