虽然文档的生成,已经有一些现成的工具,比如
https://readthedocs.org/但是我们想要有更轻便的体验,这样文档维护起来就会轻松很多。所以在开发FarBox的时候,有时候也会顺带做一些额外功能,来支持我们自己的文档库
doc.farbox.com 我们内部已经使用了比较长时间,还是比较稳定地在工作着。简单的说,就是基于Dropbox的数据同步,FarBox的API自定义模板,以及FarBox Editor导出PDF。
至于特性,比如自动生成的菜单、TOC支持、代码高亮、全文检索、文件夹对应的landing page .etc,本身都是FarBox引擎支持的,所以,Web端出来的站点也有这些特性, 除去css外的模板代码大概60行左右。
几副截图:
本地的文件夹结构:

对应的网站模板
https://doc.farbox.com :
具体的源码与使用方法参见:
https://github.com/BuildFarBox/doc.farbox.com/blob/master/readme-cn.markdown
FarBox Editor导出的PDF文档其中的一索引页, 具体PDF可以到
https://doc.farbox.com 上下载。
