gitbook

在macOS上安装gitbook

1. 安装nodejs, 在macOS上, 只要安装了Xcode, nodejs就会被默认安装
2. node -V, 显示当前系统的node版本号
3. npm install -g npm, 更新当前系统的npm版本
4. npm install -g gitbook-cli, 安装gitbook命令行工具
5. gitbook -V, 查看当前的gitbook-cli和gitbook版本, 这个时候会自动安装gitbook, gitbook-cli和gitbook是两个软件, 使用gitbook-cli中的gitbook命令来管理我们的gitbook
6. brew cask install gitbook-editor, 安装gitbook编辑器
7. 为了生成电子书, 安装ebook-convert, 下载 Calibre application, 接着sudo ln -sv /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin, 如果要生成pdf的话, 则使用gitbook pdf . ./mybook.pdf

gitbook命令

• gitbook ls-remote: 列出远程gitbook可用的版本
• gitbook ls: 列出本地gitbook可用的版本
• gitbook init: 初始化目录为gitbook的根目录
• gitbook build: 编译成静态的html
• gitbook serve: 启动服务到localhost:4000
• gitbook uninstall 2.2.2: 卸载对应的版本的gitbook
• gitbook update: 更新gitbook

创建电子书步骤

• mkdir book
• cd book
• gitbook init
• gitbook build
• gitbook serve

配置

通过book.json文件修改

gitbook editor 使用注意点

• gitbook editor 对中文的支持不太好, 所以最好在终端中创建
• gitbook editor 存放的图片都放在asset中, 所以不需要担心URL