快速部署支持 Makedown 和 LaTeX 等格式的 Zbox-Wiki 文檔共享站點
快速部署支持 Makedown 和 LaTeX 等格式的 Zbox-Wiki 文檔共享站點
快速部署支持 Makedown 和 LaTeX 等格式的 Zbox-Wiki 文檔共享站點
Author: Poechant
Blog: blog.CSDN.net/Poechant
Email: zhongchao.ustc@gmail.com
Date: February 23th, 2012
0. What is Zbox-Wiki?
Zbox-Wiki 是一位名為 Shuge Lee 的開源愛好者編寫的軟體，用於搭建簡單而輕便的個人或團隊 Wiki 站點。Zbox-wiki 由 python 編寫，支持 Markdown、Tex/Latex、Graphviz/dot。Zbox-wiki 有以下特點（摘自simple-is-better.com）：
它能用，真的能用
基於 web.py 寫，部分臟活粗暴直接調用 find grep 來干
支持 markdown 標記
不用資料庫，粗暴直接讀寫文本文件，你可以用 Firefox + It』s all text + 任意編輯器更新 wiki ，或者直接 修改對應的文本文件
支持簡單的 LaTeX (確保你機器上安裝了 latex 和 dvipng)
自動生成 table of content
代碼高亮顯示
button-mode path
下面開始介紹如何搭建這個短小精悍的 Wiki 站點。
1. 依賴
setuptools
wget http://peak.telecommunity.com/dist/ez_setup.py
python ez_setup.py
webutils
參考：webutils Homepage
wget http://pypi.python.org/packages/source/w/webutils/webutils-0.9.tar.gz#md5=7501f47b7499cd7b05e2789c27224615
tar zxvf webutils-0.9.tar.gz
cd webutils-0.9
python setup.py build
sudo python setup.py install
web.py
參考：web.py Install Guide
wget http://webpy.org/static/web.py-0.36.tar.gz
tar zxvf web.py-0.36.tar.gz
cd web.py-0.36
sudo python setup.py install
2. 修改錯誤
找到源文件zbox_wiki/zbox_wiki/commons/md_table.py中開始import內容：
import markdown
import re
import web.utils
將import web.utils改為import webutils。
3. 安裝
參考：Zbox-Wiki README
git clone git://github.com/shuge/zbox_wiki.git
cd zbox_wiki
sudo python setup.py build
sudo python setup.py install
zwadmin.py create /tmp/my_instance
sed -i -e s/readonly\ =\ True/readonly\ =\ False/g /tmp/foo/myproj/conf.py
4. 啟動
指定啟動埠為8080，讀者可自行修改。
zwd.py --path /tmp/foo/myproj --port 8080
5. 添加文檔
將你的文檔添加到your_path/pages/zbox-wiki目錄下即可。
Zbox-Wiki 支持自建目錄，並會遞歸搜索形成1個的列表（注意是1個）。
如果想修改文檔目錄顯示方式，可修改zbox_wiki/main.py文件。
《解決方案》
謝謝分享
