查看“帮助:Wiki编辑入门手册”的源代码

{{帮助文档难度/简单}}
{{Template:引用自MCBBS Wiki|Help:Wiki编辑入门手册}}
'''欢迎加入KLPBBS Wiki！'''本条目将为您介绍如何使用维基文本编辑条目，以及KLPBBS Wiki的编辑规范。

== 使用维基文本编辑器 ==
当您创建或编辑页面时，您将会看到一个维基文本编辑器，这个编辑器能帮助您解决大部分的常用维基语法。话虽如此，我们依然需要学习维基语法，因为这个编辑器是用'''纯文本'''编辑的，这意味着只有您学会了维基语法才能看懂别人写的维基文本。

== 基础文本格式 ==
维基文本依赖于HTML语言，如果您学习过HTML语言，那么再学习维基语法会轻松很多。

=== 换行 ===
这一点需要特别强调，这和我们平常的语言习惯不同，维基语法需要用'''两个回车'''来拆分段落（也就是一个空行），因为wiki不识别单独的回车，例如：
<pre>
这里只有
一个回车

到这里有两个
</pre>
显示：
<div class="pre-like">
这里只有
一个回车

到这里有两个
</div>
需要注意的是，刚才特意提到了“拆分段落”，意思是说两个回车可以实现真正意义上的创建新段落，并且与上一个段落保持一定的垂直距离。之所以刻意提到这一点，是因为我们还有另一种换行方式——使用换行标签。
<pre>
这里使用了<br>换行标签

这里使用了<br>
换行标签
</pre>

显示：
<div class="pre-like">
这里使用了<br>换行标签

这里使用了<br>
换行标签
</div>
两种用法效果相同，同时也能看出换行标签和两个回车换段的区别。

=== 粗体、斜体、下划线和删除线 ===
四种基本的文本样式。

语法：
<pre>
'''粗体显示的内容'''

''斜体显示的内容''

<u>有下划线的内容</u>

<del>有删除线的内容</del>
</pre>
显示：
<div class="pre-like">
'''粗体显示的内容'''

''斜体显示的内容''

<u>有下划线的内容</u>

<del>有删除线的内容</del>
</div>
注意：'是英文的单引号，使用中文模式是无效的。

<pre><u></u><del></del></pre>后一个标签的斜杠/不能省略。

在KLPBBS Wiki中，粗体常常用于介绍对象的条目中的开篇简介，例如：

'''混乱'''是KLPBBS现任管理员中的一员。

也经常用于需要强调的内容。

=== 前景色和背景色 ===
维基语法中并没有用于定义颜色的语法，但是KLPBBS Wiki中有相关的模板可以使用。
<pre>
{{Color|green|这是绿色}}

{{Color|rgb(255,0,0)|这是红色}}

{{Background color|#FFF|背景是白色的}}
</pre>

这两种模板的语法均为：

<pre>{{模板名|颜色代码|文本内容}}</pre>

颜色代码可以是HTML颜色名、16进制颜色码、RGB函数和RGBA函数。

显示效果：
<div class="pre-like">
{{Color|green|这是绿色}}

{{Color|rgb(255,0,0)|这是红色}}

{{Background color|#FFF|背景是白色的}}
</div>
'''注意：这不一定是所有Wiki通用的语法！可能有大部分的Wiki约定俗成地使用这种语法，但您需要知道这种语法是由每个Wiki自定义的。'''

== 标题(章节) ==
您应该早就注意到了本文的章节划分。维基语法可以使用多种级别的标题，其格式为：
<pre>
== 二级标题 ==
=== 三级标题 ===
==== 四级标题 ====
===== 五级标题 =====
</pre>
显示效果：
<div class="pre-like">
<span style="font-size:1.5em;margin-top:1em;border-bottom:1px solid #CFB78E;display:block;width:100%">二级标题</span>
<span style="font-size:1.2em;margin-top:1em;font-weight: bold;display:block;width:100%">三级标题</span>
<span style="font-size:1em;margin-top:1em;font-weight: bold;display:block;width:100%">四级标题</span>
<span style="font-size:1em;margin-top:1em;font-weight: bold;display:block;width:100%">五级标题</span>
</div>
正确使用标题，页面可以自动生成目录，让页面更有条理。

您可以通过[[KLPBBS Wiki:社区公用沙盒|社区公用沙盒]]来测试您的代码。代码中的空格并不强求，这只是为了更好看。

此外，还有一级标题（<code><nowiki>= 一级标题 =</nowiki></code>），但因为MediaWiki的页面设计原因（一级标题指代页面总标题），请不要使用一级标题。

== 内链与外链 ==
这部分请见[[帮助:Wiki编辑进阶手册]]的链接部分。

== 模板的使用 ==
模板顾名思义就是可以反复套用的一种格式。当模板被创建后，就可以在全站任何地方使用它的格式。之前我们用到的Color就是一种模板。

模板的基本语法有以下几种——
无参数：
<pre>
{{模板名}}
</pre>

单个参数：
<pre>
{{模板名|参数}}
</pre>

多个参数：
<pre>
{{模板名|参数1|参数2|参数3|...|参数N}}
</pre>

如果需要了解模板的使用方法，可以访问 模板:''模板名'' 页面，例如：[[模板:Color]]，模板页面一般会有使用帮助。

事实上，模板的使用并不一定需要使用“模板”（Template）前缀的页面，不过一般用不上这种特殊使用方法，此处不对新人作详细解释。

== 条目分类 ==
一个规范的内容条目必须要有分类，而分类代码必须放置在页面底部，以便于编辑者修改。

分类的语法为：
<pre>
[[分类:分类名]]
</pre>

使用效果请见页面底部。

把分类写成Category也是可以的。

== 代码注释 ==
注释可以帮助编辑者更好地了解代码，注释里的内容不会被阅读模式所看见，只有在编辑模式下才能看见。注释也可以用于删去暂时用不上的代码或暂时不想展示的内容。

注释的语法和HTML一样：
<pre><!--注释的内容--></pre>

<!--
耶！你发现我了！
-->

您可以通过点击本章节的编辑按钮查看这里注释的内容。

== 创建条目 ==
学完了以上内容后，您已经可以创建一个规范的条目了。在创建条目之前，请多多阅读其他规范的条目和相关指引。

在KLPBBS Wiki，您有两种方式创建新条目：

# 在搜索框中搜索您需要创建的条目名称，如果没有搜索到您想要的条目，则点击创建。
# 直接在地址栏输入访问页面，如果页面不存在，则点击创建。

== 其他Wiki常识 ==
* 蓝色的链接意味着页面存在，红色的链接意味着页面不存在。一定要避免太多的红色链接。
* “讨论”标签页可以访问有关于该页面的编辑者讨论。如果页面不存在，则会创建讨论页面。
* “查看历史”标签页可以查看该页面的历史版本、编辑者的编辑注释，还可以对比两个不同的版本。
* “移动”操作顾名思义可以移动页面，如果原页面与新页面存在一定的关联，可以保留重定向，使访问原页面的用户可以跳转到新页面，也可以不保留重定向。

== 结语 ==
以上就是本入门教程的全部内容了。再次感谢您愿意参与KLPBBS Wiki的编辑，期待您的表现！高级教程请见[[帮助:Wiki编辑进阶手册|这里]]。

== 另见 ==
* [[帮助:Wiki编辑进阶手册]]


[[分类:编辑帮助]]