gitbook安装和使用的问题

2023年6月7日09:10:09

npm官方地址：
https://www.npmjs.com/package/gitbook

注意：这个包已经停留在 2.6.9版本，Published 5 years ago

nodejs版本列表 https://nodejs.org/en/download/releases

建议使用 10.24.1，如果版本较新会出现报错

如果你在windows不方便切换版本，建议使用 nvm-windows node版本管理工具
中文参考文档：https://www.cnblogs.com/zx-admin/p/17317721.html

阿里云镜像地址 ：https://npmmirror.com/

# 使用阿里云镜像
npm install -g cnpm --registry=https://registry.npmmirror.com

# gitbook使用说明

# 安装
$ npm install gitbook-cli -g

# 创建目录并初始化
$ gitbook init

# 以http服务姓氏访问
$ gitbook serve

# 编译成html方式发布
$ gitbook build

# 安装所有插件 或者修改  book.json
$ gitbook install

# 安装单个插件
$ npm i gitbook-plugin-anchor-navigation-ex

book.json

{
    "author": "ZX",
    "description": "包括不限于PHP，GO，redis，mysql，elasticsearch，nginx，常用算法等",
    "plugins": [
        "expandable-chapters",
        "splitter",
        "tbfed-pagefooter",
        "emphasize",
        "back-to-top-button",
        "page-toc-button",
        "popup"
    ],
    "pluginsConfig": {
        "tbfed-pagefooter": {
            "copyright":"Copyright &copy ZX",
            "modify_label": "该文章修订时间：",
            "modify_format": "YYYY-MM-DD HH:mm:ss"
        },
        "theme-api": {
            "theme": "light"
        }
    },
    "links": {
        "sidebar": {
            "博客园": "https://www.cnblogs.com/zx-admin/",
        }
    }
}

注意：gitbook init 可能会卡主，建议先增加阿里云镜像，或者挂个加速，不着急运行慢慢等久好了