GitBook简明安装教程

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/964785/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。