首页 > 技术文章 > dukuwiki简单教程

amw863 2015-10-19 11:55 原文

=====请先阅读下面的说明,有助于你快速入门=====
* DokuWiki(也就是我们通常称谓的wiki) 支持一些简单的标记语言, 以尽最大可能使文档看上去更友好。
* 你可以把它理解为一种和css类似的给文本或者代码加样式的语言,这样会使你的文档更加友好。
* 你可以点击右边栏编辑按钮对整个页面的进行编辑。
* 你可以模仿下面的语法方式来实现你自己的样式。
* 本页面所有资料源于参考资料((DokuWiki格式语法说明:http://phylab.fudan.edu.cn/doku.php?id=wiki:syntax))
* 同样,在你的实践中如果有好的样式,不妨把你的经验放在这里,让大家写出更好看的wiki。
====(一)基本文本格式====

- DokuWiki支持 **粗体**, //斜体//, __下划线__ and ''等宽体'' 等格式。 当然,您也可以 **__//''混合使用''//__** 所有这些格式。
- 可以使用 <sub>下标</sub> 和 <sup>上标</sup>。
- 您也可以使用 <del>删除线</del> 标记某些信息。
- 段落 是由空行所建立的。如果您想 强制建立新行 而不建立段落,您可以使用两个连续的反斜杠+空格或是回车作为标记。请看样例:
这是一些有着换行标记的文字。
请注意 反斜杠只在回车符之前
或者在
一个空格之前的时候才有效。 \\而这样就并不起作用。
* 注:请只在必须的时候才使用强制的换行标记。

====(二)注脚====
您可以使用两个连续小括号来添加脚注((看这里,这是一个脚注))(本页最下面)。
====标题段落====
您可以使用最多达5层的标题来使您的页面更富结构性。如果您使用了三个以上的标题,那么DokuWiki会自动在页面上生成一个名为“本页目录”的标题列表。当然,您也可以关闭这项特性,只需在编辑时在页面里加入 ~~NOTOC~~ 字样即可。
==== H3标题 ====
=== H4标题 ===
== H5标题 ==

* 注:如果你接触过html语言的话,你会发现它与类似html的<h1><h2>...语法很类似吧
==== (三)图片和其他文件====
您可以使用双大括号来在页面中加入 {{:banner.jpg?200|}}图像 。您还可以选择是否指定图像的显示大小。
原始大小: {{:banner.jpg?200|}}
指定宽度: {{:banner.jpg?100}}
指定宽度和高度: {{:banner.jpg?100*50}}
重新指定宽度和高度的外部图像: {{http://de3.php.net/images/php.gif?200x50}}
* 注:更多见参考资料1(最下):
====(四)列表====
Dokuwiki支持带编号或不带编号的列表。要使用列表,在文字前加入两个空格,然后使用*标志不带编号的列表,用-标志带编号的列表。
* 列表
* 第二项
* 下一层
* 第三项

- 带编号的列表
- 第二项
- 用缩进表示更深的层
- 完了
<code>
* 列表
* 第二项
* 下一层
* 第三项

- 带编号的列表
- 第二项
- 用缩进表示更深的层
- 完了
</code>
====(五)无格式区块====
您可以在文章中插入无格式区块,在这些区块中Wiki语法将不起作用。可以有三种方法:在行前加两个以上的空格(前面做样例时用的方法),或者可以使用 Code 或 file 标记。
<code>
这是一段被code包围的区块,其中的空格都被保留了:像 <-这样
</code>
要让Wiki语法解释完全失效,可以用 nowiki 标签包围整个区块,或者也可以简单地使用双百分号标记 %%。

推荐阅读