使用 gitbook 製作自己的 html 文檔
使用 gitbook 製作自己的 html 文檔
步驟如下
npm install gitbook-cli -g // 全局安裝 gitbook-cli
cd MyDoc //切換目錄
gitbook init //初始化
gitbook init //初始化
npm uninstall gitbook-cli -g // 移除全局 gitbook-cli
再次
// 切換 node 環境為 10.x 版本
nvm list // 顯示 node 版本列表
nvm use 10.16.2 // 使用版本 10.16.2 的 nodejs
nvm list // 顯示 node 版本列表
nvm use 10.16.2 // 使用版本 10.16.2 的 nodejs
是
是否有報錯資訊
(TypeError: cb.apply is not a function)?
(TypeError: cb.apply is not a function)?
初始化成功
gitbook serve // 啟動
編寫文檔修改 SUMMARY.md
gitbook build // 生成 html
否
結束
開始
1.全局安裝 gitbook-cli
npm install gitbook-cli -g // 全局安裝gitbook-cli
2.切換文檔路徑且使用 gitbook 初始化
cd MyDoc //切換目錄
gitbook init //初始化
3.報錯 TypeError: cb.apply is not a function
TypeError: cb.apply is not a function
解決辦法： 使用 node 10 即可。
具體的原因在：//stackoverflow.com/questions/63214997/typeerror-cb-apply-is-not-a-function
是 gitbook 使用了一個過時的 dependency 所致。
4.移除全局 gitbook-cli
npm uninstall gitbook-cli -g // 移除全局 gitbook-cli
5.切換 node 環境為 10.x 版本
之前看的某篇文章是 10.21.0，由於本地有 10.x 版本，所以使用 10.16.2
// 切換 node 環境為 10.x 版本
nvm list // 顯示node版本列表
nvm use 10.16.2 // 使用版本10.16.2的nodejs
6.再次全局安裝 gitbook-cli
npm install gitbook-cli -g // 再次全局安裝gitbook-cli
7.再次使用 gitbook 初始化項目
gitbook init
8.初始化成功
等了不少時間
info: initialization is finished
9.啟動 gitbook 項目
在我重裝系統的電腦上很流暢
gitbook serve // 啟動
10.根據自己需要編寫文檔
編寫自己的 *.md 文件
修改目錄文件 SUMMARY.md
11.生成 html 文件
gitbook build // 生成html
參考鏈接
gitbook – 無法運行，報錯：TypeError: cb.apply is not a function gitbook
