前不久受研发部门的委托搭建了公司内部的 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.基本格式
** 我是粗体 **
// 我是斜体 //
__ 我是下划线 __
<del>我是删除线</del>
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.插入代码段
<sxh c>
printf("hello world");
</sxh>
有关语法高亮的高亮渲染alias参考http://alexgorbatchev.com/SyntaxHighlighter/manual/brushes
其中 sxh c 中的 c 表示使用 c 语言的高亮方案，例如：
<sxh java>
#include <stdio.h>
int main(char** argv){
printf("hello world");
return 0;
}
</sxh>
7.使用HTML
<html>
内容
</html>
8.使用 PHP
<php>
Php 代码
</php>
9.列表
*无序列表
-有序列表
10.目录 TOC
当标题层级超过两层时，TOC会自动创建
11.其它
- 在编辑时应当及时保存
- 使用自己的规范命名空间目录防止图片或媒体资源
- 发布之前预览
- 熟练使用doku语法比使用可视化编辑器更快速
- 对于复杂的表格，使用HTML更直观
- 复杂的排版，水平布局，TableLayout等使用HTML
- 良好的命名习惯
网友评论