IT工程師數位筆記本

DokuWiki 是一個開源的 wiki 項目， 可方便進行知識和內容的管理和分享，不用安裝數據庫，內置權限管理，書寫直觀方便，有大量的插件支持。
特別適用于企業內部的內容和知識管理，只允許內部員工編輯和查閱的場景，也可以用于個人博客。

安裝

1) 添加虛擬主機：由于我的 阿里云CentOs服務器 安裝了oneinstack的一鍵部署PHP、JAVA、Nginx等環境，所以域名配置很方便，照著文檔一步一步做就可以了

cd /root/oneinstack #必須進入 oneinstack 目錄下執行
./vhost.sh #如下圖

上圖中 directory 為網站根目錄，腳本執行后會自動創建，部署網站時請將代碼上傳到該目
錄（目錄、子目錄和文件權限都為：www），對應 Nginx 配置文件路徑為：

/usr/local/nginx/conf/vhost/www.oneinstack.com.conf （www.oneinstack.com 為綁
定的域名）

2) 到 DokuWiki 官網下載:https://www.dokuwiki.org/zh:dokuwiki

curl -O https://download.dokuwiki.org/out/dokuwiki-c5525093cf2c4f47e2e5d2439fe13964.tgz

3) 解壓下載的 dokuwiki

tar zxvf dokuwiki-c5525093cf2c4f47e2e5d2439fe13964.tgz

4) 把解壓文件拷到上面域名配置好的目錄

cp -rf /dokuwiki/* /data/wwwroot/wiki.yourdomain.com

5) 文件授權

網站根目錄權限遵循：
文件 644， 文件夾 755 ，權限用戶和用戶組 www
如出現文件權限問題時，請執行下面 3 條命令：
chown -R www.www /data/wwwroot/
find /data/wwwroot/ -type d -exec chmod 755 {} \;
find /data/wwwroot/ -type f -exec chmod 644 {} \;

初始化

dokuwiki 在第一次訪問時，會進入初始化頁面，即install.php， 配置一下管理員登錄賬號和密碼就可以了；

插件

dokuwiki 的一個強悍功能是可以安裝大量的擴張插件，下面介紹常用的插件
1) markdowku 兼用 markdown 語法；
2) ImgPaste Plugin chrome 瀏覽器支持圖片的復制粘貼功能；
3) EditTable Plugin 可編輯的 table 界面；
4) IndexMenu Plugin 樹級索引菜單；
5) PageQuery Plugin 按時間分類的索引；
6) [SyntaxHighlighter3 Plugin)(https://www.dokuwiki.org/plugin:syntaxhighlighter3) 代碼高亮；

配置

1) 增大頁面寬度

打開文件 lib/tpl/dokuwiki/style.ini

__site_width__    = "105em"; 默認是 75em

下圖默認寬度;75em

下圖修改后的寬度：105em

2) 左邊添加樹級索引菜單
樹級索引菜單需要插件支持：IndexMenu Plugin
添加一個 sidebar 頁面（如何添加頁面? 參考DokuWiki 使用），添加如下內容

{{indexmenu>...#1|js#shiki_brave.png navbar id#random}}

效果如下

3) 美化樹級索引， 去掉紅色三角形

打開文件 lib/plugins/indexmenu/style.css
找到下面的 .dtree .indexmenu_tocbullet 這個樣式，把 background 注釋掉，如

/*tocbullet property*/
.dtree .indexmenu_tocbullet {
    position: absolute;
    /*background: transparent url(images/toc_bullet.gif) no-repeat scroll;*/
    vertical-align: middle;
    width: 11px;
    height: 11px;
}

4) 隱藏sidebar 樹節點

進入管理配置頁面，滾到 indexmenu 配置項， 在

plugin»indexmenu»skip_index 這項設為 /(sidebar|.*:sub.*|.*:api$)/， 即把這些頁面跳過，不生成樹節點

5) 文件首行標題設為文件的顯示標題

DokuWiki 使用簡介