gitbook残缺装置依赖的软件比拟多:
- nodejs 依赖环境,gitbook命令行基于nodejs
- nvm 治理nodejs多版本,gitbook依赖的nodejs版本比拟老,可能与零碎已有的抵触
- gitbook-cli 主程序
- gitbook
- calibre 生成epub、pdf
上面具体介绍在本地如何装置 GitBook。
最终装置的gitbook版本:
$ gitbook -VCLI version: 2.3.2GitBook 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 10nvm use 10.21.0 // 应用 nodenvm ls // 查看目前已装置的 node 及以后所应用的 nodenvm 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.orgnpm install gitbook-cli -g
其中gitbook-cli
是gitbook的一个命令行工具, 通过它能够在电脑上装置和治理gitbook的多个版本.
此时打印gitbook版本:
gitbook -V CLI version: 2.3.2Installing GitBook 3.2.3/
提醒正在装置gitbook。减速装置办法:
wget https://gitee.com/52fhy/gitbook-use/attach_files/963279/download/gitbook_3.2.3.tar.gztar 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 epubgitbook 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。