前不久受研发部门的委托搭建了公司内部的 Wiki 只是管理平台，毫无疑问，wiki 系统采用的使 Doku Wiki，这个太强大了。

安装过程很容易，对于有虚拟主机的用户，直接解压文件传到主机空间里即可，当然需要支持 PHP 的主机，不需要数据库的支持。如果没有虚拟主机，需要在自己本机搭建或者在云主机搭建的话，可以装个 Xampp，有 Linux 和 Windows 版本的，用起来也十分方便，过程就不赘述。

下面进入主题。

什么是WIKI?

中文译为维基，是指代一种多人协同创作的超文本系统，可用于百科和知识管理。最大的特点在于能够让多人写作编辑，并允许任何人访问，具有简单的版本管理和差异对比，修订历史查看功能。

和维基百科有什么区别

维基百科是一个使用了 WIKI 系统的网站，是 Wiki 的子集，是人类和张三的区别。它的展现形式是综合百科，具有开放性，人人都可以创建和编辑词条，人人都可以查看词条。

和博客的区别

都是向用户展现文字或媒体内容，博客是只有博主可以编辑，wiki是开放性的，通常博客是以博主为核心导向，博主分享内容，wiki是以内容为主体导向，协同编辑内容。

DokuWiki是什么？

是一个开放源代码的wiki引擎，使用PHP开发，无需数据库支持，部署简单，主要用于中小团队和个人网站知识库的管理。
如果你想自己部署一套 wiki 系统，可参考官方网站：https://www.dokuwiki.org/start

用户和Doku Wiki 的关系

通过管理员添加用户，或者用户自己注册成为dokuwiku系统的用户，整个系统的核心主体是词条，任何具有编辑权限的用户都可以对词条进行修改修正操作，每一次修订都会产生一个版本，每个用户在修改时，内容会锁定，只有用户结束编辑，锁定方能解除，这避免一个词条因同一个用户同时编辑造成混乱，当用户既没有结束编辑也没有解除内容的锁定，系统会在15分钟自动解除锁定，此时，其它用户可进行编辑。
未登录的用户只能查看词条，并不能编辑词条，除非在dokuwiki设置完全公开

如何开始？

注：在词条没有明确的链接指向时，用户只能通过搜索进入该词条。尽管通过搜索能进入词条的编辑界面，但是尽量先建立词条索引。

一级的页面为进入wiki系统的主页面，当我们要创建新词条时，有两种方式，一种是通过搜索这个新词条进行创建，第二种是建立指向该词条的链接。

通过搜索创建的方式

例如搜索百度

根据提示，点击创建按钮，即可创建该词条。

通过链接方式

这是一个连向 [[baidu|百度]] 的链接。

此实例中，baidu 为词条的友好url，百度是链接文字

这是推荐的一种创建方式。

当如果词条已经存在，直接进入词条页面，即可进行编辑。

如何删除词条(页面)

要删除页面只需在编辑框内把所有内容清空后保存即可。

语法详解

参考 https://www.dokuwiki.org/start?id=zh:wiki:syntax

1.标题

使用 # 号包括标题文字

==== H3标题 ====
=== H4标题 ===
== H5标题 ==

预览效果

2.水平线

使用4个以上的 – 线

3.基本格式


** 我是粗体 **

// 我是斜体  //

__ 我是下划线  __

我是删除线

4.超链接

[[http://www.baidu.com|百度]]
这是一个连向 [[syntax#内部链接|本节]] 的链接。

5.图片

上传图片通过媒体管理器或使用一下语法：


{{:auto.gif}}

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

符号 ‘：’ 是命名空间分隔符，充当路径分隔符的作用，类似文件系统中的 / (*nix,在 windows下通常为 \ )，所以建立在媒体管理器中通过路径分割建立自己的文件夹，防止和别人的文件重名导致覆盖。

如：

你的命名空间:年份:分类目录:文件名

例如上传文档 Hello.docx，用户真实姓名为张三，今年年份为 2017，文档所属分类为 website，则命名为：

zhangsan:2017:website:Hello.docx

6.插入代码段


printf("hello world");

有关语法高亮的高亮渲染alias参考http://alexgorbatchev.com/SyntaxHighlighter/manual/brushes

其中 sxh c 中的 c 表示使用 c 语言的高亮方案，例如：


#include 
int main(char** argv){
    printf("hello world");
    return 0;
}

7.使用HTML



内容

8.使用 PHP


Php 代码

9.列表

*无序列表
-有序列表

10.目录 TOC

当标题层级超过两层时，TOC会自动创建

11.其它

在编辑时应当及时保存
使用自己的规范命名空间目录防止图片或媒体资源
发布之前预览
熟练使用doku语法比使用可视化编辑器更快速
对于复杂的表格，使用HTML更直观
复杂的排版，水平布局，TableLayout等使用HTML
良好的命名习惯

Doku Wiki 的入门