安装gitbook电子书

我使用的腾讯服务器内核版本信息：Linux version 5.4.241-30.0017.17 (mockbuild@builder1.x86.opencloudos.tech) (gcc version 8.5.0 20210514 (Tencent 8.5.0-23) (GCC)) #1 SMP Mon Dec 9 19:57:32 CST 2024

一、安装node运行环境

2026-05-20，此时node最新稳定版是v-24.15.0，但经过测试发现gitbook认为我安装的node v-24.15.0版本过高，所以我选择安装了node v-10.24.1

cd /opt
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
\. "$HOME/.nvm/nvm.sh"
nvm install 10.24.1
nvm use 10.24.1
node version
node -v
npm -v

二、npm安装gitbook

npm install -g gitbook-cli

三、创建gitbook工作目录

cd /home/wwwroot/default
mkdir web.gitbook
cd web.gitbook/
gitbook init

四、创建book.json，写入以下内容：

vi book.json

# 写入以下内容：
{
  "title": "我的技术电子书",
  "author": "作者姓名",
  "description": "相关描述",
  "language": "zh-hans",
  "plugins": [
    "search-pro",
    "back-to-top-button",
    "chapter-fold",
    "code",
    "copy-code-button",
    "expandable-chapters-small",
    "favicon-absolute"
  ],
  "pluginsConfig": {
    "favicon-absolute": {
      "favicon": "./favicon.ico",
      "appleTouchIconPrecomposed152": "./apple-touch-icon.png"
    }
  }
}

# !wq 保存退出

执行安装命令

gitbook install

如果遇到因为gitbook内置版本报错，导致安装插件失败的问题，可以按个执行如下命令，手动安装插件

npm install gitbook-plugin-search-pro
npm install gitbook-plugin-chapter-fold
npm install gitbook-plugin-back-to-top-button
npm install gitbook-plugin-code
npm install gitbook-plugin-copy-code-button
npm install gitbook-plugin-expandable-chapters-small
npm install gitbook-plugin-favicon

五、启动服务

# 方式一：直接在控制台启动
gitbook serve

# 方式二：以守护进程的方式启动
nohup gitbook serve > gitbook.log 2>&1 &
# 查看进程
ps -ef | grep gitbook

六、其他

1. SUMMARY.md文件用于维护电子书目录
2. _book目录用于存放gitbook build生成的html页面等相关文件