Wiki 实例教程

Wiki 实例教程


本教程只是一个初步的介绍和实例演示，未提及的内容，比如制作电子书的方法，还请参考Wiki 常见问题解答。

这是一个空白页面，您可以立刻开始编辑新内容
王小二的个人页

我是新手王小二，这是我第一个页面。
我经常去的页面是[Chinese Classics]。
我经常去的页面是[Chinese Classics|古典文学]，其实也就是[[Chinese Classics]]。
来看看[:my recipe|我整理的菜谱]吧。
第一句话。
第二句话。
其实是同一段。

隔一个空行才另起一段。
第一句话。
第二句话。
加上第三句话其实也只有两段。
第四句缩进的更多一写。
1 第一句话。
1 第二句话。
1 加上第三句话其实也只有两段。
1 第四句缩进的更多一写，成为内层列表。
* 第一句话。
1 第二句话。
* 加上第三句话其实也只有两段。
# 名词
第五句成为名词的解释行。
# 动词
动词的解释。
* 接着列表。
-大标题 1
内容 ...
--中标题 1.1
内容 ...
---小标题 1.1.1
内容 ...
-大标题 2
内容 ...
--中标题 2.1
内容 ...
粗体, 斜体，使用
断行。
`[Chinese Classics] 和 ` 都只是显示本身而已，而且 ` 还是显示它自己。

----
登记一个账号
----

首先，您需要登录之后才可以开始编辑本站的页面。如果您没有账号，可以直接点选页首的登录菜单，在那里登记一个新账号。请为自己选取一个好记好认的英文账号名。

登记新账号或者登录之后，都可以点选页首菜单里自己的账号名，这样会来到您的个人页面，您会看到以下字样：

这是一个空白页面，您可以立刻开始编辑新内容
那么就马上开始编辑第一个页面吧！


----
建立自己的个人页面
----

当您点选编辑此页之后，网页显示为一个编辑框，底下有简短的 Wiki 文法说明。在编辑框里输入内容，然后选择保存就可以完成此次编辑了。

总该写点什么吧？比如写一个自己的介绍：

王小二的个人页

我是新手王小二，这是我第一个页面。
那么当保存之后，就可以看到自己的个人页面显示如下：

王小二的个人页我是新手王小二，这是我第一个页面。

这里，首行的内容会被默认为页面的标题，以大字体显示出来，如果您不需要标题，在编辑时把首行留成空行即可。


----
页面名字和页面链接
----

本站每一个页面均有一个英文标识的页面名，显示在页首左上方。您的个人页面名也就是您的账号名，只能由本人进行编辑，其它人无权修改。任何非个人的页面，都可以任意修改。

在书写页面内容时，可以直接把其它的页面名写在 [ 和 ] 中间，作为一个引用，比如

我经

常去的页面是[Chinese Classics]。
当保存之后，就可以看到链接的效果如下：

我经常去的页面是Chinese Classics。

其中 Chinese Classics 自动成为一个链接，可以直接点击访问。

链接的方式

如果您希望不要直接显示链接的页面英文名，可以采取以下的方法之一

我经常去的页面是[Chinese Classics|古典文学]，其实也就是[[Chinese Classics]]。
注意前者以 `[ ... | ... ] 标识，这样链接就会以放在 | 后面的字显示，而 [ [ ... ] ] 则会直接显示所链接的页面标题。效果如下

我经常去的页面是[Chinese Classics|古典文学]，其实也就是古典文学。

通常而言，在 `[ ... ] 之间，您也可以直接使用网络 URL 地址，比如 `[]，这样可以建立与其它网站的链接。同样也可以使用 [ ... | ... ] 的方式显示不同的链接文本。


----
子页面

页面命名时可以使用 : 来表明页面的从属关系。比如 [Chinese Classics:SanGuo] 这个页面名字里，SanGuo 是从属于 Chinese Classics 的子页面。

如果要建立当前页的子页面，在编辑当前页时，可以将 : 前面的主页面名省略，默认当前页为主页面。比如

来看看[:my recipe|我整理的菜谱]吧。
这里指明了一个名为 my recipe 的子页面，从属于当前页。如果希望链接其它页面的子页面，则必须使用全名，也即 : 的格式。比如 `[Chinese Classics:SanGuo] 会链接去三国演义。


----
不存在的链接和新页面

上面的例子可能会显示如下：

来看看我整理的菜谱?吧。

注意这里并没有出现链接，而是有一个 ? 号。这是因为此页面还不存在，点击 ? 号则可以开始编辑所指向的页面。

这就是通常建立新页面的方式，直接在编辑的时候以链接的方式写上新页面名，保存后就会看到链接以 ? 号出现，直接点击进入编辑。


----
书写 Wiki 的格式
----

本站的 Wiki 尽量贴近纯文本，段首必须顶行不留空格，段与段之间必须空行。比如

第一句话。
第二句话。
其实是同一段。

隔一个空行才另起一段。
一句话前面如果不空格，就会被并入上一句话，显示效果如下

第一句话。第二句话。其实是同一段。

隔一个空行才另起一段。

写一个列表

如果顶行空格了会是什么效果？比如

第一句话。
第二句话。
加上第三句话其实也只有两段。
第四句缩进的更多一写。
会以缩进的列表来显示，这用来显示已经分好行的诗词比较方便。您也可以注意到同样顶行不空格的，会被认为是接着上一句。列表时对空格的数目没有要求，比之前的列表空得多了，会被认为是再缩进一层。实际显示效果如下：

第一句话。第二句话。
加上第三句话其实也

只有两段。
第四句缩进的更多一写。



----
以数字或其它方式列表

列表时如果空格后面跟着的第一个字符为 1，那么将以数字编号来列表。比如

1 第一句话。
1 第二句话。
1 加上第三句话其实也只有两段。
1 第四句缩进的更多一写，成为内层列表。
显示时会自动生成数字编号，如下

1 第一句话。
2 1 第二句话。
3 加上第三句话其实也只有两段。
1 第四句缩进的更多一写，成为内层列表。

注意同样的，行首不空格的话还是会被认为上一句的延续，所以第二句话前面的 1 还是显示了出来。

Wiki 还支持其它的方式列表，比如用 * 代替 1 会显示圆点，用 \# 代替则会产生名字解释。例如

* 第一句话。
1 第二句话。
* 加上第三句话其实也只有两段。
# 名词
第五句成为名词的解释行。
# 动词
动词的解释。
* 接着列表。
注意使用 \# 时，下面紧跟的一行没有接着本行显示，而是成为缩进的段落。效果如下

* 第一句话。
* 1 第二句话。
* 加上第三句话其实也只有两段。
名词
第五句成为名词的解释行。
动词
动词的解释。

接着列表。


----
标题和目录

比较长的文章通常会分成大小章节，章节名字通过前面顶行附上 - 符号来标识。比如

-大标题 1
内容 ...
--中标题 1.1
内容 ...
---小标题 1.1.1
内容 ...
-大标题 2
内容 ...
--中标题 2.1
内容 ...
显示为

大标题 1内容 ...中标题 1.1内容 ...小标题 1.1.1内容 ...大标题 2内容 ...中标题 2.1内容 ...

当整篇页面完成后，还可以显示自动建立的标题目录，方法为顶行写 。比如本教程的页首目录，即采用此方法建立。


----
其它特殊标识的使用
----

直接使用部分 HTML 标识

本站支持部分 HTML 标识，可以和普通文字混排。比如

粗体, 斜体，使用
断行。
显示效果为

，使用\\断行。

其它支持的标识为 div, blockquote, font, pre, a, u 等，必须采用小写字符。


----
关闭对链接或 HTML 标识的解释

如果需要显示链接或 HTML 标识本身，可以在前面使用反引号 ` 后面接上标识。比如

`[Chinese Classics] 和 ` 都只是显示本身而已，而且 ` 还是显示它自己。
显示效果为

[Chinese Classics] 和 都只是显示本身而已，而且 ` 还是显示它自己。

注意标识前面的 ` 自动被隐去，而普通的 ` 则正常显示。