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。