Wiki 语法详解

DokuWiki 支持 粗体，斜体，下划线 以及 等宽 字体。

DokuWiki 支持 **粗体**，//斜体//，__下划线__ 以及 ''等宽'' 字体。 

当然你也可以 **__//''组合使用''//__** 所有这些标志。 

你也可以使用_下标和^上标。

你也可以使用<sub>下标</sub>和<sup>上标</sup>。 

你还可以标记某些句子为已删除。

你还可以标记某些句子为<del>已删除</del>。 

用空行可以生成段落 。如果想在一个段中 强制回车 而不是生成新段落，可以使用两个反斜线加上一个空格或放在行尾。

这段文字这里要断开
注意两个反斜线仅在

出现在行尾时才能被识别成回车

或者双反斜线后面
跟着一个空格也行 \\这里没有跟空格也不在行尾，就不行。

这段文字这里要断开\\ 注意两个反斜线仅在 

出现在行尾时才能被识别\ 

或者双反斜线后面\\ 跟着一个空格也行 \\这里没有跟空格也不在行尾，就不行。 

注意：为了方便编辑，强制换行已经被我改掉了，也就是说，只要回车就可以，所见即所得

DokuWiki 可用多种方法来生成链接。

外部链接可以自动识别：http://www.google.com 或更简单的 www.google.com - 也可以设定链接名： 这里是google的链接。 电子邮件可以这样：andi@splitbrain.org 。

外部链接可以自动识别：http://www.google.com 或 

更简单的 www.google.com - 也可以设定链接名： 

 [[http://www.google.com|这里是google的链接]]。  

电子邮件可以这样：<andi@splitbrain.org> 。 

内部链接是通过方括号来生成的。可以简单地使用 wiki:pagename 或更进一步 网页标题 。页面名会自动地转换成小写，并且不允许使用特殊字符。不推荐使用中文作为页面名，但可以使用中文做为页面标题名。

内部链接是通过方括号来生成的。可以简单地使用 [[doku>wiki:pagename]]  

或更进一步 [[doku>wiki:pagename|网页标题]]。 

页面名会自动地转换成小写，并且不允许使用特殊字符。不推荐使用中文作为页面名，但可以使用中文做为页面标题名。 

页面名中可以使用 namespaces ，用冒号同页面名隔开。

页面名中可以使用 [[wiki:namespaces]] ，用冒号同页面名隔开。 

有关命名空间的详情参见：wiki:namespaces 。

也可以链接到页面的某一部分。只需加上一个井号，后面跟上那一小节的名字即可。比如这个链接指向本小节：本小节

这个链接指向本小节：[[syntaxcn#interal|本小节]] 

注意：

• 指向 已存在页面 的链接同指向 不存在页面 的链接显示风格不同。

• DokuWiki 不使用 驼峰字 (即一个词中有两个大写，其余小写，形如驼峰)来自动生成链接。但此功能亦可通过 config 文件打开。提示：如果 DokuWiki 显示成链接那就是已经打开了。

• 如果小节名改变，它的链接也会改变，所以不要过多使用指向小节的链接。

• 如上“本小节”的链接所示，小节名为中文的情况下，不能成功创建指向页面某一部分的链接。

DokuWiki 支持 wiki:interwiki 链接。这是一种快速创建到其他Wiki的链接的方法。比如指向维基百科(Wikipedia)有关Wiki的页面： Wiki 。

DokuWiki 支持 [[doku>wiki:interwiki]] 链接。这是一种快速创建到其他Wiki的链接的方法。 

比如指向维基百科(Wikipedia)有关Wiki的页面： [[wp>Wiki]] 。 

也可以识别像 这样的 Windows共享链接。这只有在一个用户组内，比如公司内部网上才有意义。

也可以识别像 [[\\server\share|这样的]] Windows共享链接。 

注意：

• 出于安全原因，直接浏览Windows共享只在IE内才可以。

你也可以在一个图片上生成链接，指向内部或外部网页。其作法是把链接和图片的语法合并使用，如：

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]] 

效果是：

注意：

• 在链接名中只有图片的格式才能出现。

用双圆括号括上文字即可生成脚注 ¹⁾，括号中的文字即为脚注内容 ²⁾。

用双圆括号括上文字即可生成脚注 ((脚注一))，括号中的文字即为脚注内容 ((这就是脚注内容))。 

页面中可以使用多达5级的标题，来对页面进行结构化。如果标题超过3个，就会自动生成页面目录，出现在页面右上角──这个目录也可以通过在文件中加入 ~~NOTOC~~ 来禁用。

==== 3级标题 ==== 

=== 4级标题 === 

== 5级标题 == 

输入4个短横线即可生成一条水平线：

用花括号可以引入内部或外部 images 。同时可以指定其尺寸。

真实尺寸:

指定宽度:

指定宽度和高度:

指定外部图片的尺寸:

真实尺寸:              {{wiki:dokuwiki-128.png}} 

指定宽度:   {{wiki:dokuwiki-128.png?100}} 

指定宽度和高度:  {{wiki:dokuwiki-128.png?100x100}} 

指定外部图片的尺寸: {{http://de3.php.net/images/php.gif?100x100}} 

在左边或右边加空格可以指定其对齐方式：

{{ wiki:dokuwiki-128.png}} 

{{wiki:dokuwiki-128.png }} 

{{ wiki:dokuwiki-128.png }} 

当然，也可以为图片指定一个标题(在多数浏览器中，鼠标放到它上面时可以显示)。

{{ wiki:dokuwiki-128.png |其实应该算替代文字}} 

如果指定的文件名(外部或内部)不是图形格式 (gif,jpeg,png) ，就会显示成链接。

Dokuwiki 支持有序和无序列表。 要生成列表，首先要把文字缩进两个空格，再加上一个 * 即可生成无序列表，加上一个 - 可创建有序列表。

• 这是一个列表 - 可能不太好玩

• 第2项

• 可以有不同的级别

• 又一个-怎么样呢

1. 一样的列表，不过有编号

1. 另一项

1. 缩进就可以生成一个级别

1. 这里又回来

 

  * 这是一个列表 

  * 第2项 

    * 可以有不同的级别 

  * 又一个 



  - 一样的列表，不过有编号 

  - 另一项 

    - 缩进就可以生成一个级别 

  - 这里又回来 

DokuWiki 可以把通常使用的 emoticon (网络表情符号)转换成图形来显示。把图片放在 smiley 目录中并在 conf/smileys.conf 中进行配置即可使用。下面是 DokuWiki 已经包含的表情符号。

• 8-)

• 8-O

• :-(

• :-)

• =)

• :-/

• :-\

• :-?

• :-D

• :-P

• :-O

• :-X

• :-|

• ;-)

• ^_^

• :?:

• :!:

• LOL

• FIXME

• DELETEME

DokuWiki 可以把普通的文本转换成相应的印刷字形。下面是可识别字形的例子：

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ®

“他想 'It's a man's world'...”

 

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) 

"他想 'It's a man's world'..." 

注意：此转换可在配置文件中关闭。

DokuWiki 生成表格的语法相当简单。

以 | 开头和结尾的行是普通行，用 ^ 的是标题行。

^ 表头 1      ^ 表头 2       ^ 表头 3          ^ 

| 行 1 Col 1    | 行 1 列 2     | 行 1 列 3        | 

| 行 2 Col 1    | 占据两列(注意后面两条竖线) || 

| 行 3 Col 1    | 行 2 列 2     | 行 2 列 3        | 

要把水平的两个格子连在一起，只须把后面那个留空。要注意的是，格子的数量一定要对应。

也可以生成竖列的表头。

可以看到：格子开头的分隔符号决定了格子的样式。

|              ^ 表头 1            ^ 表头 2          ^ 

^ 表头 3    | 行 1 列 2          | 行 1 列 3        | 

^ 表头 4    | 这回没有合并 |                    | 

^ 表头 5    | 行 2 列 2          | 行 2 列 3        | 

注意：不支持竖向的格子合并，即rowspan。

在每一行前加上至少两个空格即可使这些行变成不解释的行。或者也可以使用标签 code 或 file 。

d我来试下下是不是在每一行的前加上至少两 个空格即可使这些行变成不解释的行或者也可以用标签''code'' 

 

这里所有格式都会照样显示，空格也会保留：比如              <-这些都是空格。 

 

这里差不多是一样的，但可以看出显示成引用了一个文件。  

要想让解释器对一整块都不解释，可以用 nowiki 标签把它圈上，或者简单一点用两个百分号也行： %% 。

这一句就包含许多可以解释的东西： http://www.splitbrain.org and **formatting** 但它并没有被解释。

编辑本页或本小节即可看到如何使用这种块。

DokuWiki 可以对文字进行语法高亮显示，以使其易读。它使用的是 GeSHi 通用语法高亮模块，所以只要是GeSHi支持的语言，本Wiki系统就可以支持。语法同前面讲的代码块类似，但要加上该代码所使用的语言： <code java> 。

 
/**  
 
 * The HelloWorldApp class implements an application that 
 
 * simply displays "Hello World!" to the standard output. 
 
 */ 
 
class HelloWorldApp { 
 
    public static void main(String[] args) { 
 
        System.out.println("Hello World!"); //Display the string. 
 
    } 
 
}

目前可以支持的语言有：actionscript, ada, apache, asm, asp, bash, caddcl, cadlisp, c, cpp, css, delphi, html4strict, java, javascript, lisp, lua, nsis, oobas, pascal, perl, php-brief, php, python, qbasic, sql, vb, visualfoxpro, xml

使用 html 或 php 标签可以在页面中嵌入HTML或PHP代码块，如下：

 

<html> 

这是 <font color="red" size="+1">HTML</font>，字变大一些。 

</html> 

这是 HTML，字变大一些。

 

<php> 

echo '用PHP生成的Logo:'; 

echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; 

</php> 

  echo '用PHP生成的Logo:';   echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';

注意：HTML和PHP嵌入功能可以在配置中关闭。如果已经关闭就会显示代码而不是执行它。上面是执行还是显示代码呢？

参考 MozCN 自定义 Wiki 语法。