使用GitBook遇到的那些事

gitbook相信你們（程序猿和程序媛）你們都應該據說過或者使用過。本人屬於一隻剛入行不久的程序猿（一直在學習，努力成長）。網絡上關於gitbook的內容都不少，我從中也學習到了不少，接下來我將本身使用過程當中遇到的問題記錄一下（給本身作個筆記）。

---

1、使用環境

概覽：

Wndows10 + github + MarkDown工具

詳細描述（工具自理，不在保修範圍😂）：

在Windows10上安裝node（版本自選，本人用的是node-v12.18.3-x64）

安裝好node後再命令窗口安裝gitbook：npm install -g gitbook-cli

 MarkDown工具：有不少，我用的是Typora

版本控制工具git：我使用的是官方的GitHub Desktop

2、使用過程當中遇到的問題（主業用不到node，因此期間幹了很多蠢事）

1 經常使用命令

初始化：gitbook init

啓動gitbook服務：gitbook serve
查看地址：http://localhost:4000

serve 命令也能夠指定端口：gitbook serve --port 2333

構建書籍：gitbook build [書籍路徑] [輸出路徑]
示例：gitbook build ./ ./output

能夠生成 PDF 格式的電子書：gitbook pdf ./ ./mybook.pdf

生成 epub 格式的電子書：gitbook epub ./ ./mybook.epub

生成 mobi 格式的電子書：gitbook mobi ./ ./mybook.mobi

若是生成不了，你可能還須要安裝一些工具，好比 ebook-convert。或者在 Typora 中安裝 Pandoc 進行導出。

2 遇到的問題

（1）build後獲得的靜態文件查看時不能進行跳轉

緣由：

theme.js問題，gitbook做者已提供瞭解決方法，因爲gitbook未再更新（最近一次更新在2018年）因此這個問題未能真正的解決。

解決方式：

build輸出目錄下gitbook文件夾，是該文件夾下theme.js的問題。如個人輸出目錄是output，因此問題在：\output\gitbook\theme.js。

咱們須要在theme.js中查找：if(m)for，將其中的m換爲false。沒錯，就只這一個m搞得鬼，並且咱們須要build一次，修改一次。

有沒有一勞永逸的方法？

在用戶目錄下找到：

C:\Users\用戶名\.gitbook\versions\3.2.3\node_modules\gitbook-plugin-theme-default\_assets\website

在這個目錄下的theme.js中查找：if(m)for，將其中的m換爲false。（親測可用）

（2）gitbook自帶插件問題

緣由：gitbook-plugin-livereload 是gitbook自帶的一個插件，當咱們gitbook serve後，加入修改了書籍中的某些內容，保存後咱們刷新網頁內容應該自動更新內容的，可是如今這個插件不只沒更新，反而會殺掉服務，換句話就是：對不起，你的Ctrl + s 殺掉了gitbook serve。以後就要要從新執行命令了。

解決方式：經過搜索，並無發現解決方法，不是我不告訴大家，而是從網上沒找到(┬＿┬)

3、柳暗花明又一村（上述「遇到的問題」中的內容能夠不用看了）

是的，上述遇到的問題中的內容能夠不用看了。上述問題中的內容就是一個問題的記錄（記筆記）。那上述的兩個問題有沒有好的解決方式呢？

我也是這麼問本身。而後，經歷了發現問題，思考問題，解決問題的漫長過程。解決第一個問題花了3分鐘，是的3分鐘。而後去愉快的玩耍了（碼字）。而後花了一段時間（很差統計），一邊碼字一邊思考解決自動更新的問題，而後碼字，改bug，通過了，1個多小時時間，終於把它搞定了。以後，碼字，寫Bug，終於程序也被我寫崩潰了，（此處重複上句話N次）。在寫本文過程當中，至少沒再次崩潰。不說了上鍊接：

github:https://github.com/2Or3InTheMorning/GitBook_Auxiliary_tools

 

4、關於輔助工具要說的

GitBook輔助工具 v0.5.1
功能概述:
1.一鍵完成初始化、構建、啓動網絡服務
2.構建Book時自動修復標籤頁沒法跳轉
3.經過技術手段彌補實時修改服務中止的bug（未修復）
（可經過config.ini自行啓用初始化、構建、啓動Web）
4。如使用Web服務，程序運行後將會使用電腦自帶瀏覽器打開網頁。
本程序爲本人本身使用GitBook的輔助工具，全部權歸本人全部。

不喜勿噴！！！
後續更新可關注我的Github:
https://github.com/2Or3InTheMorning

因代碼較亂，暫不上傳代碼，後期整理後上傳。
2020年8月

 

注意：使用過程當中build和serve會複製程序和配置文件（請不要刪除配置文件內的配置項，能夠修改，具體請看文件內的註釋）

 

收集網友的問題和解決方式

（1）因爲加載插件出現的問題（網友遇到的，我沒有遇到，由於未驗證）

gitbook serve命令執行反覆報如下報錯

Error: Couldn't locate plugins "toggle-chapters, splitter, anchor-navigation-ex, prism, copy-code-button, alerts, theme-comscore", Run 'gitbook install' to install plugins from registry.

Error: ENOENT: no such file or directory, stat 'D:\workspace\core-solution-docs\_book\gitbook\gitbook-plugin-fontsettings\fontsettings.js'

Error: ENOENT: no such file or directory, stat 'D:\workspace\core-solution-docs\_book\gitbook\gitbook-plugin-livereload\plugin.js'

Error: ENOENT: no such file or directory, stat 'D:\workspace\core-solution-docs\_book\gitbook\gitbook-plugin-alerts\plugin.js'

Error: ENOENT: no such file or directory, stat 'D:\workspace\core-solution-docs\_book\gitbook\gitbook-plugin-livereload\plugin.js'

Error: ENOENT: no such file or directory, stat 'D:\workspace\core-solution-docs\_book\gitbook\gitbook-plugin-search\lunr.min.js'

解決方案：

修改用戶目錄的.gitbook\versions\3.2.3\lib\output\website\copyPluginAssets.js文件，把112行的confirm改成false。