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。