gitbook 是过去几年特别流行的一个文档工具,但是它的开发团队已经全力做在线服务,不再维护免费的开源项目。gitbook 的问题没有人解决,一个特别严重的问题是,gitbook 编译效率非常低,几百个页面就需要接近半个小时的时间,如果是几千个页面,十几个小时都没有结果。
firefox 社区中有人提议用 mdbook 替代 gitbook,见 Alternatives to GitBook for publishing documentation ,试用了一下,mdbook 的效率很高,gitbook 需要半小时,mdbook 只需要十秒。
brew install mdbook
初始化:
mdbook init
启动:
mdbook serve
页面样式和 gitbook 类似,mdBook Documentation 就是用 mdbook 生成的。
美中不足的是,mdbook 现在没有模版,只提供预处理的接口。另外搜索功能很弱鸡,不好使。