GitBook簡明安裝教程

飛鴻影發表於2022-02-12
Git

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。

相關文章