如何使用gitbook制作书籍

gitbook使用gitbook命令来制作当地文件目录和文件(并可用localhost浏览效果)，使用git进行版本管理和上传同步到gitbook.com网站上(目前不支持ssh方式)，使用calibre进行pdf书籍制作。

1.安装gitbook

    # 若没有安装npm则先安装npm
$ npm install -g gitbook-cli
$ gitbook -V

2.简单使用gitbook命令

$ gitbook init  # 建立README.md和SUMMARY.md文件
    
  # 编辑SUMMARY.md文件，示例文件如下
  * [简介](README.md)
  * [第一章](chapter1/README.md)
   - [第一节](chapter1/section1.md)
   - [第二节](chapter1/section2.md)
  * [第二章](chapter2/README.md)
   - [第一节](chapter2/section1.md)
   - [第二节](chapter2/section2.md)
  * [结束](end/README.md)

$ gitbook init    #生成对应的目录和文件
$ gitbook serve .  #可以使用localhost预览
$ gtibook build  #_book文件夹下是完整的静态网页html

$ gitbook pdf .  #生成pdf，要先安装calibre工具，并把/Applications/calibre.app/Contents/MacOS添加到path路径

3.使用git命令将当前文件夹同步到gitbook.com网站上

    # 这一步和github同步文件夹的步骤类似，但是不能用ssh上传，也就是说不能免密码登陆
$ git clone https://name/your.project.git  # 从gitbook上clone
    # 用gitbook等方式编辑文件和文件目录
$ git add .
$ git commit -m "commit"
$ git push

4.gitbook editor是用来同步编辑gitbook.com上的书本的工具

5.个性化配置和插件