windows+gitbook

一、windows安装

1.安装node

node-v14.21.3-x64

2.安装gitbook

npm install gitbook-cli -g

3.测试

 4.任意打开文件夹，初始化电子书

gitbook init

如果报错：参考(15条消息) windows10下gitbook本地部署过程及问题处理_物宝天华的博客-CSDN博客

5.根目录下添加book.json文件，管理相关插件

{ 
  "title" : "软件组业务提升",
  "language": "zh-hans",
  "plugins": [
    "-sharing",
    "highlight",
    "search",
    "back-to-top-button",
    "expandable-chapters",
    "-chapter-fold",
    "-toggle-chapters",
    "splitter", 
    "summary",
    "hide-element",
    "katex",
    "-mathjax",
    "-mathjax-commonhtml" 
],
  "pluginsConfig":{ 
    "hide-element": {
      "elements": [".gitbook-link"]
    },
    "expandable-chapters": {
      "openByDefault": false
    }
  }
}  

plugins就是依赖的插件，前面加”-“代表取消使用

6.安装插件

gitbook install

7.生成网页

gitbook build

8.启动网页服务

gitbook serve

这个也会自动调用gitbook build

9.访问

浏览器输入：127.0.0.1:4000,或者把127改成192也行

其他：

①、启动网页服务的情况下，更新book.json网页会自动刷新

②、summary插件可以自动根据目录生成SUMMARY.md，参考：Gitbook根据目录生成Summary.md - 简书 (jianshu.com)

③、文件夹名称不能有"+"，如C++，就无法显示；每个文件夹里都要有README.md文件，文件夹可以用-1，-2来排序，并且网页里不会显示

④、隐藏”本书使用GitBook发布“：(9条消息) 隐藏“ Published with Gitbook”(本书使用GitBook发布)_chicken_h的博客-CSDN博客

⑤、配置了新的插件后需要：gitbook install

⑥、目录无法显示下划线

参考：

windows10下gitbook本地部署过程及问题处理_物宝天华的博客-CSDN博客

(9条消息) Gitbook发布为本地文件后内容无法跳转问题解决_gitbook目录跳转_你的破壁人呀的博客-CSDN博客

Gitbook教程（小白入坑gitbook全过程） - 简书 (jianshu.com)

Gitbook教程（小白入坑gitbook全过程） - 简书 (jianshu.com)

 

 

二、内网移植

1.在外网电脑安装node，可设置目录后默认安装

2.外网电脑安装gitbook

3.在外网电脑复制：
①、C:\Users\13912\AppData\Roaming\npm下的所有文件,包含文件夹：node_modules，文件：gitbook、gitbook.cmd、gitbook.ps1
其中文件夹C:\Users\13912\AppData\Roaming\npm\node_modules\里的gitbook-cli文件夹需要先打包再复制，否则会因为文件名称过长导致复制失败；
②、C:\Users\13912\.gitbook

4.内网电脑安装了node后，将3中的文件放入内网电脑即可，路径需要一致

5.测试
cmd执行gitbook -V