編輯並即時預覽

在本地端撰寫時,由於gitbook-cli沒有提供GUI工具
寫書時需要自行撰寫Markdown語法,再compile成靜態網站
但使用Markdown時,無法所見即所得,不能及時發現語法或是顯示的錯誤

為了解決這個問題,所以gitbook-cli提供了可以在編輯時即時預覽的功能
要使用這個功能,就在test_book底下使用這個指令:

$ gitbook serve

也可以在其他路徑上對專案資料夾執行上面的指令,但後面要記得加上相對/絕對路徑

$ gitbook serve ./test_book

可以看到Terminal會顯示類似以下的資訊

info: 7 plugins are installed
info: loading plugin "livereload"... OK
info: loading plugin "highlight"... OK
info: loading plugin "search"... OK
info: loading plugin "lunr"... OK
info: loading plugin "sharing"... OK
info: loading plugin "fontsettings"... OK
info: loading plugin "theme-default"... OK
info: found 1 pages
info: found 0 asset files
info: >> generation finished with success in 0.5s !

Starting server ...
Serving book on http://localhost:4000

gitbook serve指令實際上會先
使用gitbook build編譯.md檔案,生成Gitbook靜態網頁
接著建立一個輕量型的Server,並且監聽4000 port
在每次編輯完成儲存檔案後,Server會自動重新編譯你的.md檔案生成Gitbook靜態網,然後重新載入
並且可以用http://localhost:4000存取Gitbook靜態網頁,所以可以使用瀏覽器來查看目前書籍的內容與樣式

gitbook serve命令实际上会首先调用gitbook build编译书籍,完成以后会打开一个 web 服务器,监听本地 4000 端口,在浏览器中输入http://localhost:4000,即可打开电子书。

或是如果4000 port已經有其他應用程式使用了,可以在指令後面加上-p port號碼,指定Server要使用的port

$ gitbook serve -p 5566

作者在離線時,有時會像下面這樣進行撰寫,右邊在編輯完成存檔後,左邊會隨之更新
不過作者實測之後,因為作者習慣使用編輯器的「自動存擋」功能
每次編輯時一打字就會自動儲存,觸發重新編譯,導致畫面閃爍頻率很高

而執行了gitbook serve指令之後,可以發現test_book資料夾底下多了一個_book資料夾
這個資料夾內就是編譯好的Gitbook的靜態網站

results matching ""

    No results matching ""