https://yuzeshan.gitbooks.io/gitbook-studying/content/index.html     简明教程

http://www.chengweiyang.cn/gitbook/

https://www.gitbook.com/book/yuzeshan/gitbook-studying/details

http://yangjh.oschina.io/gitbook/faq/Contents.html

快速安装： 

1. 安装nodejs

2. npm install -g gitbook-cli

3.创建项目目录 mkdir mybook  ; cd mybook

4. npm install gitbook

5. 创建 READ.md , SUMMARY.md 文件

6. 在SUMMARY.md 中编写书的目录结构 

7. 初始化  gitbook init 

8. 创建 book.json 项目配置文件， 设置插件 书的名称等

9. 使用markdown语法编写内容 

10. gitbook serve  .\  运行

生成： 

1. html ，gitbook build .\ .\output  ; 将静态生成到output目录  ， 需要web服务器支持才能访问

2. pdf , gitbook pdf  .\   .\mybook.pdf ;  生成一个pdf文件 ， 需要安装一个插件来生成 

附： book.json

{
  "author": "zhukf - zhukf@tcl.com",
  "description": "消费机与人证服务器对接协议",
  "extension": null,
  "generator": "site",
  "links": {
    "sharing": {
      "all": null,
      "facebook": null,
      "google": null,
      "twitter": null,
      "weibo": null
    },
    "sidebar": {

    }
  },
  "output": null,
  "pdf": {
    "fontSize": 12,
    "footerTemplate": null,
    "headerTemplate": null,
    "margin": {
      "bottom": 36,
      "left": 62,
      "right": 62,
      "top": 36
    },
    "pageNumbers": true,
    "paperSize": "a4"
  },
  "plugins": [
    "ace",
    "-search",
    "search-pro",
    "prism",
    "-highlight",
    "image-viewer"

  ],
  "pluginsConfig": {
    "search-pro": {
      "cutWordLib": "nodejieba",
      "defineWord" : ["Gitbook Use"],
      "placeholder": "搜索"
    },
    "searchbox" : {
      "placeholder": "搜索"
    },

    "prism": {
      "css": [
        "prismjs/themes/prism-okaidia.css"
      ],
      "ignore": [
        "mermaid",
        "eval-js"
      ]
    }

  },
  "title": "消费机与人证服务器对接协议",
  "variables": {},
  "styles": {
    "website": "styles/website.css"
  }
}

--------------------------------------------------------

image-viewer插件有点问题（大图片放大时左边被挡被 导致显示不全，需要修改一个Css样式）

zoomify.css

zoomed样式， position改成 absolute