Gitbook + Markdown 的组合来写技术文档或电子书是不错的选择。Jeff 最新的DeveMobile 2 版本的主题在线使用文档就是采用Gitbook + Markdown 这个组合——点击查看。
用Gitbook 写在线文档电子书等东东什么好处呢?大概能说几点:1.可维护性。既然名字有个Git 这个单词,就知道其实采用了git的版本控制。2.方便写。使用过发现其可以在线编辑,甚至你不懂markdown 语法也可以用类似WordPress 的可视化编辑器,然后其他的诸如支持多人协作,一键导出pdf等电子书格式也为其方便性增色不少。3.目前流行这么做。就好比说这年头大家都用git 进行代码版本控制而非svn了,你还有什么特殊理由固守?就像这年头大家都用GitHub 托管开源代码,你偏偏用国内的gitcxxx 之类的,难道说GFW 挡道是特殊理由?
网络上有不少Gitbook 的教程,在这里我就不复制粘贴了。这里推荐两个教程:
《Gitbook 使用入门》(这个本身就是gitbook 写的)
在官方托管的话网站速度在国内访问比较慢,建议是自己生成HTML 文件到自己的服务器。当然要这么做就必须在终端通过命令行安装了,具体见上面的入门即可,bulid 了serve 后会生成 _book 的文件夹,里面就是HTML 文件。
这里有不少产自Gitbook的好书:
gitbook使用入门无法打开~~