前不久受研發(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í)的頁(yè)面為進(jìn)入wiki系統(tǒng)的主頁(yè)面帘饶,當(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)入詞條頁(yè)面,即可進(jìn)行編輯先改。
如何刪除詞條(頁(yè)面)
要?jiǎng)h除頁(yè)面只需在編輯框內(nèi)把所有內(nèi)容清空后保存即可疚察。
語(yǔ)法詳解
參考 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.圖片
上傳圖片通過媒體管理器或使用一下語(yǔ)法:
{{: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)語(yǔ)法高亮的高亮渲染alias參考http://alexgorbatchev.com/SyntaxHighlighter/manual/brushes
其中 sxh c 中的 c 表示使用 c 語(yǔ)言的高亮方案,例如:
<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語(yǔ)法比使用可視化編輯器更快速
- 對(duì)于復(fù)雜的表格猾漫,使用HTML更直觀
- 復(fù)雜的排版,水平布局感凤,TableLayout等使用HTML
- 良好的命名習(xí)慣