前不久受研發(fā)部門的委托搭建了公司內(nèi)部的 Wiki 只是管理平臺(tái)，毫無疑問，wiki 系統(tǒng)采用的使 Doku Wiki，這個(gè)太強(qiáng)大了。
安裝過程很容易，對(duì)于有虛擬主機(jī)的用戶，直接解壓文件傳到主機(jī)空間里即可，當(dāng)然需要支持 PHP 的主機(jī)，不需要數(shù)據(jù)庫(kù)的支持。如果沒有虛擬主機(jī)，需要在自己本機(jī)搭建或者在云主機(jī)搭建的話，可以裝個(gè) Xampp，有 Linux 和 Windows 版本的，用起來也十分方便，過程就不贅述。
下面進(jìn)入主題。
什么是WIKI?
中文譯為維基，是指代一種多人協(xié)同創(chuàng)作的超文本系統(tǒng)，可用于百科和知識(shí)管理。最大的特點(diǎn)在于能夠讓多人寫作編輯，并允許任何人訪問，具有簡(jiǎn)單的版本管理和差異對(duì)比，修訂歷史查看功能。
和維基百科有什么區(qū)別
維基百科是一個(gè)使用了 WIKI 系統(tǒng)的網(wǎng)站，是 Wiki 的子集，是人類和張三的區(qū)別。它的展現(xiàn)形式是綜合百科，具有開放性，人人都可以創(chuàng)建和編輯詞條，人人都可以查看詞條。
和博客的區(qū)別
都是向用戶展現(xiàn)文字或媒體內(nèi)容，博客是只有博主可以編輯，wiki是開放性的，通常博客是以博主為核心導(dǎo)向，博主分享內(nèi)容，wiki是以內(nèi)容為主體導(dǎo)向，協(xié)同編輯內(nèi)容。
DokuWiki是什么？
是一個(gè)開放源代碼的wiki引擎，使用PHP開發(fā)，無需數(shù)據(jù)庫(kù)支持，部署簡(jiǎn)單，主要用于中小團(tuán)隊(duì)和個(gè)人網(wǎng)站知識(shí)庫(kù)的管理。
如果你想自己部署一套 wiki 系統(tǒng)，可參考官方網(wǎng)站：https://www.dokuwiki.org/start
用戶和Doku Wiki 的關(guān)系
通過管理員添加用戶，或者用戶自己注冊(cè)成為dokuwiku系統(tǒng)的用戶，整個(gè)系統(tǒng)的核心主體是詞條，任何具有編輯權(quán)限的用戶都可以對(duì)詞條進(jìn)行修改修正操作，每一次修訂都會(huì)產(chǎn)生一個(gè)版本，每個(gè)用戶在修改時(shí)，內(nèi)容會(huì)鎖定，只有用戶結(jié)束編輯，鎖定方能解除，這避免一個(gè)詞條因同一個(gè)用戶同時(shí)編輯造成混亂，當(dāng)用戶既沒有結(jié)束編輯也沒有解除內(nèi)容的鎖定，系統(tǒng)會(huì)在15分鐘自動(dòng)解除鎖定，此時(shí)，其它用戶可進(jìn)行編輯。
未登錄的用戶只能查看詞條，并不能編輯詞條，除非在dokuwiki設(shè)置完全公開
如何開始？
注：在詞條沒有明確的鏈接指向時(shí)，用戶只能通過搜索進(jìn)入該詞條。盡管通過搜索能進(jìn)入詞條的編輯界面，但是盡量先建立詞條索引。
一級(jí)的頁面為進(jìn)入wiki系統(tǒng)的主頁面，當(dāng)我們要?jiǎng)?chuàng)建新詞條時(shí)，有兩種方式，一種是通過搜索這個(gè)新詞條進(jìn)行創(chuàng)建，第二種是建立指向該詞條的鏈接。
通過搜索創(chuàng)建的方式
例如搜索 百度
根據(jù)提示，點(diǎn)擊創(chuàng)建按鈕，即可創(chuàng)建該詞條。
通過鏈接方式
這是一個(gè)連向 [[baidu|百度]] 的鏈接。
此實(shí)例中，baidu 為詞條的友好url，百度是鏈接文字
這是推薦的一種創(chuàng)建方式。
當(dāng)如果詞條已經(jīng)存在，直接進(jìn)入詞條頁面，即可進(jìn)行編輯。
如何刪除詞條(頁面)
要?jiǎng)h除頁面只需在編輯框內(nèi)把所有內(nèi)容清空后保存即可。
語法詳解
參考 https://www.dokuwiki.org/start?id=zh:wiki:syntax
1.標(biāo)題
使用 # 號(hào)包括標(biāo)題文字
==== H3標(biāo)題 ====
=== H4標(biāo)題 ===
== H5標(biāo)題 ==
預(yù)覽效果
2.水平線
使用4個(gè)以上的 – 線
3.基本格式
** 我是粗體 **
// 我是斜體 //
__ 我是下劃線 __
<del>我是刪除線</del>
4.超鏈接
[[http://www.baidu.com|百度]]
這是一個(gè)連向 [[syntax#內(nèi)部鏈接|本節(jié)]] 的鏈接。
5.圖片
上傳圖片通過媒體管理器或使用一下語法：
{{:auto.gif}}
{{:wiki:dokuwiki-128.png}}
符號(hào) ‘：’ 是命名空間分隔符，充當(dāng)路徑分隔符的作用，類似文件系統(tǒng)中的 / (*nix,在 windows下通常為 \ )，所以建立在媒體管理器中通過路徑分割建立自己的文件夾，防止和別人的文件重名導(dǎo)致覆蓋。
如：
你的命名空間:年份:分類目錄:文件名
例如上傳文檔 Hello.docx，用戶真實(shí)姓名為張三，今年年份為 2017，文檔所屬分類為 website，則命名為：
zhangsan:2017:website:Hello.docx
6.插入代碼段
<sxh c>
printf("hello world");
</sxh>
有關(guān)語法高亮的高亮渲染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>
內(nèi)容
</html>
8.使用 PHP
<php>
Php 代碼
</php>
9.列表
*無序列表
-有序列表
10.目錄 TOC
當(dāng)標(biāo)題層級(jí)超過兩層時(shí)，TOC會(huì)自動(dòng)創(chuàng)建
11.其它
- 在編輯時(shí)應(yīng)當(dāng)及時(shí)保存
- 使用自己的規(guī)范命名空間目錄防止圖片或媒體資源
- 發(fā)布之前預(yù)覽
- 熟練使用doku語法比使用可視化編輯器更快速
- 對(duì)于復(fù)雜的表格，使用HTML更直觀
- 復(fù)雜的排版，水平布局，TableLayout等使用HTML
- 良好的命名習(xí)慣
