GitBook 是一款现代化的文档平台,支持团队协作,可以在上面写产品文档、内部知识分享、接口文档等。GitBook 有网页版和本地版两种,网页版地址如下:https://www.gitbook.com/,本地版地址如下:https://github.com/GitbookIO/gitbook。
本地版是基于 Node.js 开发的,所以需要本地安装 Node.js 环境,本地版现已停止维护了,而且本地版的大部分功能网页版都支持,所以本教程主要是介绍网页版的使用方式。
GitBook 和 GitHub 是什么关系呢?这是两个相互独立的网站,但是你在 GitBook 上创建的文档可以同步到 GitHub 仓库,每次对文档的修改都会生成一个 commit,GitBook 会自动帮你提交到 GitHub,这样有助于追溯历史版本。而你往 GitHub 提交的内容也会自动同步到 GitBook。(具体怎么在 GitBook 和 GitHub 之间建立关联一会儿会讲到,但是在这之前,我假设你已经会使用 GitHub 了,如果你没有,可以关注文末的公众号,回复「GitHub」获取相关教程。)
开源工具链
这个工具链 (GitBook) 是一个使用 Git 和 Markdown 来构建书籍的工具。它可以将你的书输出很多格式:PDF,ePub,mobi,或者输出为静态网页。
GitBook工具链是开源并且完全免费的,它的源码可以在 GitHub 上获取。
与格式和工具链相关的问题被发表在 github.com/GitbookIO/gitbook/issues。
GitBook.com
GitBook.com 是一个使用工具链来创建和托管书籍的在线平台 (www.gitbook.com)。
其他文档
开发文档 (API & 插件) 地址 developer.gitbook.com。
企业版本的安装向导和手册的地址 hep.enterprise.gitbook.com。
评论 ( 0 )