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
评论没有发现