背景

一直在用markdown 在寫一些文件，有個東西需要用gitbook來看效果，就裝了gitbook，在使用gitbook的時候並不是一帆風順的。雖然之前也用過很多次，也許之前運氣好，並沒有出什麼問題，gitbook本身可能也不是很完美，在操作時有問題，這裡做一個簡單的記錄。

安裝操作

npm install -g gitbook-cli

當前環境

1. cli version : 2.3.2
2. gitbook version: 3.2.3
3. node : 10.6.0
4. npm: 6.1.0
5. System Version: Win 10 企業版 (1803）(17134.376)

常見問題

1. Error: Cannot find module ‘gitbook-html’

原因及解決辦法： 原因是沒有下載依賴，需要運營下面的命令解決

gitbook fetch

2. random errors when using gitbook plugin on running “gitbook serve”.

Error: ENOENT: no such file or directory, stat ‘/nfs/home/alf/gitbook/foobar/_book/gitbook/gitbook-plugin-lunr/lunr.min.js’

Error: ENOENT: no such file or directory, stat ‘/home/aparra/Documentos/zoi-api/book/_book/gitbook/gitbook-plugin-livereload/plugin.js’

Error: ENOENT: no such file or directory, stat ‘…_book\gitbook\gitbook-plugin-fontsettings\fontsettings.js’

原因及解決辦法：

暫時沒有好的辦法，但是可以通過修改配置來解決這個問題
修改下面的問題件~指的是使用者目錄
~\.gitbook\versions\3.2.3\lib\output\website\copyPluginAssets.js

return fs.copyDir(
        assetsFolder,
        assetOutputFolder,
        {
            deleteFirst: false,
            overwrite: true,
            confirm: true
        }
    );

修改後

return fs.copyDir(
        assetsFolder,
        assetOutputFolder,
        {
            deleteFirst: false,
            overwrite: true,
            confirm: false
        }
    );