編輯並即時預覽
在本地端撰寫時,由於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的靜態網站