乐趣区

关于gitbook: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/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。

退出移动版