前期
- nodejs
- npm
- gitbook
- github仓库
- Typora MarkDown 编辑器
环境搭建
nodejs安装：NodeJS可在其官网（https://nodejs.org/zh-cn/）
npn安装gitbook：
npm install gitbook-cli -g
gitbook安装summer插件自动生成SUMMARY.md：
npm install -g gitbook-summary
开始gitbook搭建
创建文件夹
主要是创建以下目录：
- docs：存放md文件
- assert：是相关图片存放的目录（可选择创建）
以下目录是生成的：
- _book：是生成html的目标目录
- node_modules：插件安装目录
创建book.json
以下为模板（包括插件，和配置信息）
{ "plugins": [ "collapsible-menu", "anchor-navigation-ex", "tbfed-pagefooter", "disqus", "summary", "toggle-chapters", "theme-comscore", "book-summary-scroll-position-saver", "expandable-chapters-small", "code", "copy-code-button" ], "title": "Shiver Book", "description": "Shiver Book", "author": "Shiver Book", "language": "zh-hans", "root": "./docs/", "links": { "sidebar": { "GitHub": "https://github.com/ShiverZm", "个人博客": "http://www.shiver.fun" } }, "sharing": { "facebook": true, "twitter": true, "weibo": true, "qq": true, "all": [ "douban", "google", "qzone", "linkedin" ] }, "pluginsConfig": { "tbfed-pagefooter": { "copyright": "Copyright © ershouche-FE 2019", "modify_label": "文件修订时间：", "modify_format": "YYYY-MM-DD HH:mm:ss" }, "disqus": { "shortName": "gitbookuse" } } }
命令
初始化文件夹
生成README.md和SUMMARY.md
gitbook init
进入docs文件夹、根据目录生成SUMMARY.md
cd docs sm book
安装book.json列出的插件
gitbook install
生成HTML
gitbook build
启动服务
gitbook serve
访问localhost:4000即可
开始github
创建仓库
上传book文件夹到主分支
目录上传到其他分支
设置github page
开始github action
创建.workflow/main.yml文件
创建环境变量token
常见问题
Gitbook错误"cb.apply is not a function"的解决办法
nodejs版本过高
改代码
https://zhuanlan.zhihu.com/p/367562636
https://blog.csdn.net/qq_43792900/article/details/131939070
一连串问题
不如卸载当前版本nodejs 安装nvm 来安装nodejs10.3
nvm install 10.3.0 nvm use 10.3.0
