DokuWiki 语法

DokuWiki 是一个开源的维基程序，可以方便地搭建内部知识库。它的内容都是纯文本的txt，配合自己的一套语法可以组织出一个内部知识库出来。

链接

DokuWiki 支持多种方法创建页面内的链接

内部链接

内部链接使用两个方括号 [[pagename]] 来创建一个新的页面。在 DokuWiki 内部使用了一个命名空间 namespace 的概念，每个 namespace 是一个文件夹，文件夹间用冒号分隔，比如 [[folder1:pagename]]

[[folder1:pagename]]


[[folder2:pagename]]


[[folder3:pagename]]


[[folder1:folder2:folder3:pagename]]

在文件系统上，Demo 中使用的 namespace 对应为如下文件夹：

bash$ tree folder*
folder1
├── folder2
│   └── folder3
│       └── pagename.txt
└── pagename.txt
folder2
└── pagename.txt
folder3
└── pagename.txt


2 directories, 4 files

在当前 namespace 下创建一个新的页面，只需要使用两个方括号框住一个词条即可生成一个新的页面。当页面内容为空时，新的页面或链接将被删除。当 namespace 下的内容都为空时，操作系统上的文件夹也会自动被删除。

外部链接

DokuWiki 可以自动识别URL，如果需要给URL取别名，可以使用如下语法。

[[http://www.google.com|This Link points to google]]

图像

通过花括号来引用图片，可以指定宽度和高度，当只指定宽度时，高度会自适应。

原始大小：{{wiki:dokuwiki-128.png}}
指定宽度：{{wiki:dokuwiki-128.png?50}}
指定宽x高: {{wiki:dokuwiki-128.png?200x50}}
支持外部图像：{{https://secure.php.net/images/php.gif?200x50}}

图像也和链接一样支持别名：

{{ wiki:dokuwiki-128.png |This is the caption}}

图像的对齐和居中使用空格来调整：

右对齐： {{ wiki:dokuwiki-128.png}}
左对齐：{{wiki:dokuwiki-128.png }}
居中对齐：{{ wiki:dokuwiki-128.png }}

如果只想显示图像链接，不需要把图片在页面上展示出来，使用如下语法：

{{wiki:dokuwiki-128.png?linkonly}}

另外一种让图片带链接功能的语法，点击图片可以跳转到指定链接：

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

DokuWiki 的新建页面的功能与链接是绑定的，这个语法是比较独特的。图像可以使用外部图像，也可以自己上传媒体，媒体的命名空间与页面类似。页面使用方括号，媒体使用花括号。其它格式语法完全可以使用markdown代替。

全文完。

如果转发本文，文末务必注明：“转自微信公众号：生有可恋”。