GitBook Tutorial

GitBook是什么?在GitbookGithub上的介绍:

Modern documentation format and toolchain using Git and Markdown.

GitBook is a command line tool (and Node.js library)for building beautiful books using GitHub/Git and Markdown (or AsciiDoc).

上面两段引文中都明确提到一个关键词tool,因此,Gitbook首先就是一个工具。它基于Nodejs的命令工具,可以结合使用GitHub/Git和Markdown语法来快速的制作一套精美的电子书或文档集。

GitBook支持多种文档格式的输出:

  • PDF:需要Gitbook-PDF 插件的支持;
  • JSON:用于电子书的调式或元数据提取;
  • eBook:需要ebook-convert支持;
  • HTML: 支持单页面的html;
  • Static WebSite:默认输出格式,可托管Github pages上。

legacy.gitbook.com是创建和托管电子书的平台,可多人协作,提供在线编辑器。

作为一款开源的在线文档创作项目,不仅有免费的空间使用,当然更多的是面向企业或是收费的群体提供服务,但对于我们个人总结文档的需求是完全足够的。同类产品还有看云Read the Docs,大家可以去比对一下,所谓适合自己的才是最好的,可根据自己的喜好选择。

作为学习实战案列,我把Gitbook的学习总结整理成一本电子书,分享给大家,欢迎多多批评指正!

项目地址