II. Local Gitbook Builder

Contributed by Xupeng Chen

Gitbook 新版不再支持pdf和其他静态导出，也不再兼容旧版command line版本，旧版command line不支持右边栏和一些hint和embed语法，需要第三方插件，

Install command line gitbook tool

先安装brew和npm两个包管理软件

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

brew install node
brew install npm

再用npm安装gitbook

npm install gitbook -g
npm install gitbook-cli -g
gitbook -V #查看版本gitbook和gitbook-cli版本

Install packages for gitbook tool

在book.json中填入插件名称，then run gitbook install就可以自动安装依赖的插件。安装新版gitbook的一些替代插件以及一些额外的美化插件。

urlembed取代embed，效果不是很完美，tabs也没有新版gitbook的效果 插件用法

<div data-gb-custom-block data-tag="urlembed">

https://website.org/stuff/this-is-the-path-name

</div>

<div data-gb-custom-block data-tag="tabs" data-0=', third=' data-first='First Tab' data-second='Second Tab'></div>

<div data-gb-custom-block data-tag="content" data-0='first'></div>

Content for first tab ...

<div data-gb-custom-block data-tag="content" data-0='second'></div>

Content for second tab ...

<div data-gb-custom-block data-tag="content" data-0='third'>

Content for third tab ...

</div>

Build gitbook (html)

gitbook init #自动生成SUMMARY.md，但多级目录似乎无法找到，建议略过这一步用手工编辑版本
gitbook serve #可在浏览器预览，默认在http://localhost:4000
gitbook build #产生html

How to build pdf/epub

• 下载calibre

  https://calibre-ebook.com/dist/osx

• 链接到bin下

• ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin

• 产生pdf gitbook pdf . training_book.pdf