gitbook安装使用教程及和github同步方法

gitbook(www.gitbook.com)是一个网络出版平台,作者可以方便的在上面撰写书籍的章节,然而整理成册,形成电子书。GitBook是一个命令行工具,我们可以借用该工具使用Github和Markdown来制作图书。

GitBook支持输出多种文档格式,如静态站点,PDF,eBook,Json等。

使用gitbook的方式如下:

1、安装npm

登录http://nodejs.org/ 下载nodeJs安装包,直接双击安装即可。node.js已经集成了npm,直接在命令行输入 npm -v 即可。

2、安装gitbook

输入

npm install -g gitbook-cli 即可

3、创建gitbook

登录github 创建一个仓库作为书籍的工程。

gitbook安装使用教程及和github同步方法_第1张图片

使用github的账号授权登录gitbook(https://www.gitbook.com

gitbook安装使用教程及和github同步方法_第2张图片

  创建gitbook,选择从github导入,选择github中相应的仓库

gitbook安装使用教程及和github同步方法_第3张图片

gitbook安装使用教程及和github同步方法_第4张图片


4、gitbook工具的使用

SUMMARY.md 是一本书的目录结构,主要目录结构如下

* [Chapter1](chapter1/test1.md)
    * [Section1.1](chapter1/test1.md)
    * [Section1.2](chapter1/test1.md)
* [Chapter2](chapter2/test2.md)

然后在命令行输入 

gitbook init

gitbook serve

即可通过本地4000端口访问,预览生成的gitbook。

5、书籍的上传和同步

将github仓库克隆到本地,编辑好之后上传到github,便会自动同步到gitbook,点击gitbook书籍主页的read即可阅读。



你可能感兴趣的:(环境搭建教程)