帮助:Wiki编辑入门手册
欢迎加入MCBBS Wiki!本条目将为您介绍如何使用维基文本编辑条目,以及MCBBS Wiki的编辑规范。
使用维基文本编辑器
当您创建或编辑页面时,您将会看到一个维基文本编辑器,这个编辑器能帮助您解决大部分的常用维基语法。话虽如此,我们依然需要学习维基语法,因为这个编辑器是用纯文本编辑的,这意味着只有您学会了维基语法才能看懂别人写的维基文本。
基础文本格式
维基文本依赖于HTML语言,如果您学习过HTML语言,那么再学习维基语法会轻松很多。
换行
这一点需要特别强调,这和我们平常的语言习惯不同,维基语法需要用两个回车来拆分段落(也就是一个空行),因为wiki不识别单独的回车,例如:
这里只有 一个回车 到这里有两个
显示:
这里只有 一个回车
到这里有两个
需要注意的是,刚才特意提到了“拆分段落”,意思是说两个回车可以实现真正意义上的创建新段落,并且与上一个段落保持一定的垂直距离。之所以刻意提到这一点,是因为我们还有另一种换行方式——使用换行标签。
这里使用了<br>换行标签 这里使用了<br> 换行标签
显示:
这里使用了
换行标签
这里使用了
换行标签
两种用法效果相同,同时也能看出换行标签和两个回车换段的区别。另外,如果您连续打了多个回车,最终都只会被解析为一次换段,需要多次换行只能使用br换行标签。
粗体、斜体、下划线和删除线
四种基本的文本样式。
语法:
'''粗体显示的内容''' ''斜体显示的内容'' <u>有下划线的内容</u> <s>有删除线的内容</s>
显示:
粗体显示的内容
斜体显示的内容
有下划线的内容
有删除线的内容
注意:'是英文的单引号,使用中文模式是无效的。
<u></u><s></s>
后一个标签的斜杠/不能省略。
在MCBBS Wiki中,粗体常常用于介绍对象的条目中的开篇简介,例如:
混乱是MCBBS现任管理员中的一员。
也经常用于需要强调的内容。
前景色和背景色
维基语法中并没有用于定义颜色的语法,但是MCBBS Wiki中有相关的模板可以使用。
{{Color|green|这是绿色}} {{Color|rgb(255,0,0)|这是红色}} {{Background color|#FFF|背景是白色的}}
这两种模板的语法均为:
{{模板名|颜色代码|文本内容}}
颜色代码可以是HTML颜色名、16进制颜色码、RGB函数和RGBA函数。
显示效果:
这是绿色
这是红色
背景是白色的
注意:这不一定是所有Wiki通用的语法!可能有大部分的Wiki约定俗成地使用这种语法,但您需要知道这种语法是由每个Wiki自定义的。
标题(章节)
您应该早就注意到了本文的章节划分。维基语法可以使用多种级别的标题,其格式为:
== 二级标题 == === 三级标题 === ==== 四级标题 ==== ===== 五级标题 =====
为了本页面的排版效果,此处不再演示。您可以通过社区公用沙盒来测试您的代码。代码中的空格并不强求,这只是为了更好看。
内链与外链
链接是维基中十分重要的机制,链接可以让多个页面相互连接,使页面不会显得孤立。对于站内条目,我们可以通过以下方法添加链接:
[[条目名称]] [[条目名称|想要显示的文字]] [[条目名称#章节名称]] [[#当前条目下的章节名称]]
以上代码的实现效果如下:
对于外链,可以使用以下方法插入:
[链接] [链接 显示的名称]
例如:
模板的使用
模板顾名思义就是可以反复套用的一种格式。当模板被创建后,就可以在全站任何地方使用它的格式。之前我们用到的Color就是一种模板。
模板的基本语法有以下几种—— 无参数:
{{模板名}}
单个参数:
{{模板名|参数}}
多个参数:
{{模板名|参数1|参数2|参数3|...|参数N}}
如果需要了解模板的使用方法,可以访问 模板:模板名 页面,例如:模板:Color,模板页面一般会有使用帮助。
事实上,模板的使用并不一定需要使用“模板”(Template)前缀的页面,不过一般用不上这种特殊使用方法,此处不对新人作详细解释。
条目分类
一个规范的内容条目必须要有分类,而分类代码必须放置在页面底部,以便于编辑者修改。
分类的语法为:
[[分类:分类名]]
使用效果请见页面底部。
把分类写成Category也是可以的。
代码注释
注释可以帮助编辑者更好地了解代码,注释里的内容不会被阅读模式所看见,只有在编辑模式下才能看见。注释也可以用于删去暂时用不上的代码或暂时不想展示的内容。
注释的语法和HTML一样:
<!--注释的内容-->
您可以通过点击本章节的编辑按钮查看这里注释的内容。
创建条目
学完了以上内容后,您已经可以创建一个规范的条目了。在创建条目之前,请多多阅读其他规范的条目和相关指引。
在MCBBS Wiki,您有两种方式创建新条目:
- 在搜索框中搜索您需要创建的条目名称,如果没有搜索到您想要的条目,则点击创建。
- 直接在地址栏输入访问页面,如果页面不存在,则点击创建。
其他Wiki常识
- 蓝色的链接意味着页面存在,红色的链接意味着页面不存在。一定要避免太多的红色链接。
- “讨论”标签页可以访问有关于该页面的编辑者讨论。如果页面不存在,则会创建讨论页面。
- “查看历史”标签页可以查看该页面的历史版本、编辑者的编辑注释,还可以对比两个不同的版本。
- “移动”操作顾名思义可以移动页面,如果原页面与新页面存在一定的关联,可以保留重定向,使访问原页面的用户可以跳转到新页面,也可以不保留重定向。
结语
以上就是本入门教程的全部内容了。再次感谢您愿意参与MCBBS Wiki的编辑,期待您的表现!高级教程请见这里。