共计 2162 个字符，预计需要花费 6 分钟才能阅读完成。
gitbook 残缺装置依赖的软件比拟多：
- nodejs 依赖环境,gitbook 命令行基于 nodejs
- nvm 治理 nodejs 多版本,gitbook 依赖的 nodejs 版本比拟老，可能与零碎已有的抵触
- gitbook-cli 主程序
- gitbook
- calibre 生成 epub、pdf
上面具体介绍在本地如何装置 GitBook。
最终装置的 gitbook 版本：
$ gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3环境要求
- NodeJS(v4.0.0 及以上)，举荐 v10.21.0，其余版本可能会不兼容。gitbook 曾经不更新了。
如果本地已有版本，举荐装置 nvm：https://www.jianshu.com/p/624…
# nvm: https://github.com/nvm-sh/nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
# fast by gitee with 52fhy
curl -o- https://gitee.com/52fhy/nvm/raw/v0.39.1_gitee/install.sh | bash默认会在零碎的 bash 配置里写入环境变量，新建一个窗口就能够应用 nvm 命令了。如果没有失效，能够按装置提醒受到设置环境变量:
=> Appending nvm source string to /home/yjc/.zshrc
=> Appending bash_completion source string to /home/yjc/.zshrc
=> Close and reopen your terminal to start using nvm or run the following to use it now:
export NVM_DIR="$HOME/.config/nvm"
[-s "$NVM_DIR/nvm.sh"] && \. "$NVM_DIR/nvm.sh" # This loads nvm
[-s "$NVM_DIR/bash_completion"] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion接着就能够失常应用 nvm 了：
# 设置 NVM 下载减速
NVM_NODEJS_ORG_MIRROR=http://npm.taobao.org/mirrors/node nvm i 10.21.0
# 常用命令
nvm i 10.21.0 // 装置 nodejs 10
nvm use 10.21.0 // 应用 node
nvm ls // 查看目前已装置的 node 及以后所应用的 node
nvm ls-remote // 查看目前线上所能装置的所有 node 版本
nvm alias default 10.21.0 // 应用 10.21.0 作为预设应用的 node 版本
nvm uninstall 10.21.0 // 移除 node 通过 NPM 装置
运行上面的命令进行装置 gitbook-cli
npm config set registry https://registry.npm.taobao.org
npm install gitbook-cli -g其中 gitbook-cli 是 gitbook 的一个命令行工具, 通过它能够在电脑上装置和治理 gitbook 的多个版本.
此时打印 gitbook 版本：
gitbook -V
CLI version: 2.3.2
Installing GitBook 3.2.3
/提醒正在装置 gitbook。减速装置办法：
wget https://gitee.com/52fhy/gitbook-use/attach_files/963279/download/gitbook_3.2.3.tar.gz
tar zxvf gitbook_3.2.3.tar.gz -C ~/编辑书籍
能够应用 vscode、typora 等反对 markdown 的工具编辑。
gitbook 我的项目构造示例：
wegt https://gitee.com/52fhy/gitbook-use/attach_files/962871/download/gitbook-example.zip预览书籍
应用下列命令会运行一个服务器, 通过 http://localhost:4000/ 能够预览书籍
gitbook serve运行该命令后会在书籍的文件夹中生成一个 _book 文件夹, 外面的内容即为生成的 html 文件.
咱们能够应用上面命令来生成网页而不开启服务器
gitbook build生成 epub、pdf:
gitbook epub
gitbook pdf生成 epub、pdf 须要零碎装置有 calibre: https://calibre-ebook.com/dow… 或 https://download.calibre-eboo…
# linux 通用
sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin
# ubuntu 版本可能比拟老
sudo apt install calibre本文节选自我的 github 我的项目：https://github.com/52fhy/gitb…，欢送 star。