Wiki语法入门
基本语法
文本样式
黑体、斜体、非wiki格式功能可以在wiki 的编辑器上方找到。
格式 | 语法 | 效果 |
---|---|---|
黑体 | '''黑体''' | 黑体 |
斜体 | ''斜体'' | 斜体 |
黑体+斜体 | '''''示例''''' | 示例 |
划掉 | <strike>划掉</strike> | 划掉 |
非wiki格式 | <nowiki>{{infobox}}</nowiki> | {{infobox}} |
段落格式
各级大标题效果
格式 | 语法 | 效果 |
---|---|---|
各级大标题 |
== 二级 == === 三级 === ==== 四级 ==== ===== 五级 ===== |
二级三级四级五级 |
水平分割线 |
上一段话 ---- 下一段话 |
上一段话 下一段话 |
无序列表 |
* 无序列表项 ** 无序列表项 * 无序列表项 每多一个"*"就多一级 |
|
有序列表 |
# 有序列表项 ## 有序列表项 ### 有序列表项 # 有序列表项 每多一个"#"就多一级 |
|
定义列表 |
;概念1 : 定义1 ;概念2 : 定义 2-1 : 定义 2-2 这里的";"是英文的分号,":"是英文的冒号 |
|
文本缩进 |
:缩进1个字符 ::缩进2个字符 :::::缩进多个字符 这里的":"是英文的冒号 |
|
多种段落格式混用 |
# 有序列表项1 # 有序列表项2 #* 有序列表项2的无序列表项1 #* 有序列表项2的无序列表项2 # 有序列表项3 #; 有序列表项3的概念 #: 有序列表项3的定义 # 有序列表项4 #: 有序列表项4的 #: 缩进样式 # 有序列表项5 ## 有序列表项5-1 ### 有序列表项5-1-1 ## 有序列表项5-2 |
|
2.2 Wiki基础语法
本节正式介绍Wiki语言的基础语法规则。如果你曾经接触过Markdown之类的文本标记语法,你会发现二者十分接近。如果你接触过网页语言HTML就更好了,因为Wiki语言某种意义上就是一种高度简化的HTML。
2.2.1 综述 Wiki语言是一种文本标记语言,将约定的特殊标记写进普通文本里,解析器就可以识别出这些标记,从而以需要的样式处理文本。Wiki语言高度简化了HTML,使得使用门槛大大降低,某种意义上不会比使用Word软件更难。
2.2.2 Wiki原生语法 这一部分语法在支持MediaWiki的站点上一般都可以使用。
= 一级标题 =、== 二级标题 ==、……、====== 六级标题 ======:标记之间的文本被识别为标题文本,具体样式看本地的设置。一般不要用一级标题。 ''斜体文字''、'''粗体文字'''、'''''粗斜体文字''''':标记之间的文本变为相应样式。不能跨行使用。
[[内部链接]]:标记之间的文本会变成指向本Wiki站点上的同名页面的链接。如果该页面存在,这个链接是蓝色的(有效链接),否则是红色的(无效链接)。
特殊用法: [[页面名称|链接文本]]:仍然指向“页面名称”,但是外观上显示的文本是“链接文本”。“链接文本”可以嵌套一些复杂的样式,比如说可以做出彩色链接等。
[[页面名称#标题]]:定位到目的页面具体对应标题的位置。缺省“页面名称”时,定位到本页面的对应标题。
[[File:文件名|一系列参数]]:嵌入本Wiki上的文件(一般是图片)。具体用法见本Wiki上的帮助页。
[[Category:分类名称]]、[[分类:分类名称]]:为当前页面添加分类。分类是一种类似于Tags的东西,便于检索和管理。
两次换行:Wiki语法中需要两次换行才能在实际显示中“换行”。实际的内在原因是,两次换行才能识别为一个“段落”。
行首的:(半角冒号)表示缩进:※需要注意,Wiki语法中不允许段首空格。※如果需要缩进,在段首添加半角冒号,半角冒号的数目代表缩进量。这个语法常在讨论串中使用,做出参差错落的回复串便于阅读。
行首的*(乘号或星号,whatever)表示无序列表项:表现为段首的一个实心小圆点,*的数量代表列表级数,也表现为缩进量。
行首的#(井号)表示有序列表项:表现为段首的序号,#的数量代表列表级数,表现为缩进量和序号起点。 以上三种行首标记可以混写。
----(四个连续减号/短横线):分割线。
外部链接: 1. 文本中以https或http开头的网址会被自动识别并显示为外部链接,无须特殊标记。
2. 在以上基础上,用[]将网址括起来,会显示为类似于[1]↗的形式,避免网址过长影响观感。
3. 在以上基础上,可以自定义链接文本:[https://zh.moegirl.org 萌娘百科],显示为 萌娘百科↗ 。
另有表格系统等不在此说明。
2.2.4 模板
在我看来,Wiki语言最成功,最具有代表性的两个语法,一个是内部链接——[[]],另一个是模板(Template)系统——{{}}。内部链接构成的是一个庞大的词条网络,从一个词条可以前往大量的其他页面,激发读者的探索欲;后者则在极大地提高了Wiki语言的自由度和表现力的同时,降低了编辑门槛——这简直是不可思议的。
模板的核心思想是在一个页面调用另一个页面的内容。这另一个页面一般是以Template(模板)为名字空间的页面,如Template:洛天依、Template:黑幕。这意味着不同Wiki上的模板系统不相同,不能通用。 在我看来,模板一般可以分为两种,一种是内容性的,一种是工具性的。
前者有实际性的内容,自身也可以单独抽出来作为词条,代表性的如各种大家族模板,如Template:乐正绫,我们需要频繁地更新这个列表,而所有含有乐正绫演唱的歌曲词条都会含有这个列表,我们不可能每一次都手动更新所有相关页面,但是使用模板就可以做到只更新模板页面就可以让所有相关页面更新。
后者一般没有实际的内容,但是一般构成了一个框架,就像一个函数,通过调用时传入参数,生成所需的文本,这种模板一般建立时就确认了主要框架,不会频繁更新。
模板一般有两种调用方式,分别是直接调用和传参调用。
直接调用的语法即 {{模板名称(不含Template等字样)}},如 {{洛天依}} 即可直接拷贝 Template:洛天依 的可见内容至标记位置。
传参调用的语法为: {{模板名称|匿名参数值1|匿名参数值2|...|匿名参数值n|参数名1=参数值1|参数名2=参数值2|...|参数名n=参数值n}} 有点头晕?不怕,我一个个详细解释。
我们以B站播放插件模板 {{BilibiliVideo|id=6009789|page=1}} 为例。 首先,参数之间用|分隔号间隔,这个符号在你键盘右端,如果你学过编程你对此会比较熟悉。 然后,id和page是参数名,分别代表了AV号和第几P,等号后面的部分为对应的参数值(如该视频即为COP的《世末歌者》)。 这个模板没有匿名参数。所谓匿名参数没有参数名,他们是根据传入顺序来分配的,如 {{洛天依|collapsed}} 中就往模板传入了值为"collapsed"的一个匿名参数,生成的大家族列表会默认折叠。
有的参数是可以缺省的,如上面的BilibiliVideo还有包括宽度、高度等参数,但是省略了,模板内部设置了默认值,缺省的参数会使用默认值。而直接使用 {{洛天依}} 时,显示为展开状态。但是有的参数是必需的,若不传入会出现错误。
参数名、参数值前后的空格和换行会被忽略,故对于一些大型模板会有类似于 {{Vocaloid_Songbox_Introduction |lbgcolor = |ltcolor = |group1 = |list1 = |group2 = |list2 = |group3 = |list3 = }}
这样的写法。 一个模板可能会被设计为具有强大的功能和复杂的参数,要查看它的详细用法可以直接访问它的页面,模板作者和修订者一般会给出完整的使用文档。
萌百上常用的基础模板: {{color|颜色|文本}}:给文本染色。 {{黑幕|文本}}:在文本上罩一层黑幕,鼠标移上去时才能看到。用于幽默,但不应滥用。
{{Hide|标题=|文本=}}:文本会被折叠起来,用于折叠大段文本或者剧透内容。
{{info|文本}}:会生成一个提示栏,并有多种衍生版本。
…… 更多的模板可以在编辑框下面看到,在此不作赘述。
模板的出现和完善令编辑者不需要从头开始写词条,也大大提高了词条的规范性。萌百VC区的歌曲词条便通过几个核心模板搭建成稳定全面的结构体系,新手编辑只需要复制一个已有的歌曲词条,更改其中的小部分信息即可,更像是一个填表单的工作,大大降低了门槛和劳动量。
有一个问题就是,在一个庞大的Wiki中,模板的数量也是庞大的,新手编辑通常不太能知道,要实现某种功能,需要用哪个模板。这是每个人必经的一步,而且确实没有速成的捷径。所以你可以大方地在提问求助区或者向熟练编辑者提问,随着日后代码的阅读量上去后,这就不再是问题了。另外,高级搜索里面是可以专门搜索模板的,可以根据自己的需求搜索关键词,看看有没有适用的模板。
如果没有能够满足你需求的,而且又确实具有使用价值的模板,也可以在提问求助区描述你的需求,请其他人帮忙制作。模板的制作有一定的门槛,日后编辑熟练后,可以阅读进阶教程学习制作。
理论上,看到这里的你现在已经可以开始编辑甚至创建新页面了;这篇基础编辑入门中已经包含了我们平常99%的编辑需要用到的知识。你可以先从抄代码开始,通过修改部分信息和预览来熟悉常用模板的表现。
posted on 2020-06-30 19:29 blogernice 阅读(6399) 评论(0) 编辑 收藏 举报