使用Gitbook + MarkDown 写技术文档/电子书

Gitbook + Markdown 的组合来写技术文档或电子书是不错的选择。Jeff 最新的DeveMobile 2 版本的主题在线使用文档就是采用Gitbook + Markdown 这个组合——点击查看

用Gitbook 写在线文档电子书等东东什么好处呢?大概能说几点:1.可维护性。既然名字有个Git 这个单词,就知道其实采用了git的版本控制。2.方便写。使用过发现其可以在线编辑,甚至你不懂markdown 语法也可以用类似WordPress 的可视化编辑器,然后其他的诸如支持多人协作,一键导出pdf等电子书格式也为其方便性增色不少。3.目前流行这么做。就好比说这年头大家都用git 进行代码版本控制而非svn了,你还有什么特殊理由固守?就像这年头大家都用GitHub 托管开源代码,你偏偏用国内的gitcxxx 之类的,难道说GFW 挡道是特殊理由?

网络上有不少Gitbook 的教程,在这里我就不复制粘贴了。这里推荐两个教程:

《用Markdown写一本自己的开源电子书》

《Gitbook 使用入门》(这个本身就是gitbook 写的)

在官方托管的话网站速度在国内访问比较慢,建议是自己生成HTML 文件到自己的服务器。当然要这么做就必须在终端通过命令行安装了,具体见上面的入门即可,bulid 了serve 后会生成 _book 的文件夹,里面就是HTML 文件。

这里有不少产自Gitbook的好书:

https://www.gitbook.com/search?q=language%3Azh

原创文章,作者:Carrie001128,如若转载,请注明出处:https://blog.ytso.com/244184.html

(0)
上一篇 2022年4月13日
下一篇 2022年4月13日

相关推荐

发表回复

登录后才能评论