Markdoc是著眼於管理技術文檔,但可用於各種目的。 Markdoc有幾個顯著的賣點:
*維基是由完全的純文本文件,所以你可以很容易地把他們納入版本控制。
*維基編譯成獨立的HTML的目錄,它可以通過一個HTTP服務器分發的壓縮包或送達。
*您可以選擇包括將被編譯到旁邊所有的渲染頁面的HTML目錄靜態媒體。
* Markdoc配備了一個全功能的純Python WSGI應用程序和HTTP服務器提供了編譯維基。
*您可以使您的維基與各種降價的擴展,如Pygments為基礎的代碼高亮,擴展語法定義列表,TOC代,等等的。
*您可以完全自主的你如何維基由編輯用於渲染降價轉換成完整的HTML文檔的Jinja2模板呈現。
快速入門
安裝方式:
#!/斌/ bash的
汞克隆SSH://hg@bitbucket.org/zacharyvoase/markdoc
CD markdoc /
PIP安裝-r要求
蟒蛇setup.py安裝
製作一個維基
#!/斌/ bash的
markdoc初始化我的維基
CD我維基/
VIM維基/ somefile.md
#......寫一些文檔...
markdoc構建
markdoc服務
#..打開http://本地主機:8008在瀏覽器/ ...
佈局
Markdoc維基有以下默認佈局:
WIKI_ROOT /
| - 的.html /
| - .templates /
| - .TMP /
| - 靜電/
| - 維基/
` - markdoc.yaml
將.html /和.tmp /目錄應排除任何VCS,因為它們包含臨時文件。
在諮詢的DOC文檔的佈局/維基/ layout.md對不同的子目錄裡的角色的更多信息
要求:
- 的Python
- PIP
- 的rsync
評論沒有發現