Lu Lab Docs
Edit

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>

Build gitbook (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

Last updated