關於手冊
本書使用 gitbook 編寫,下方列出後續維護之必要資訊。
先備知識與環境
步驟簡要
git clone把 syf/SYFbook 拉回到你自己的工作目錄- 做你要的修改後,在你的工作目錄下運行
gitbook serve,
可以運行本地開發 server 並作 live reload 檢視
預設是 http://localhost:4000/ git commit&&git push將你的修改成果推到 repo 去,
等個幾分鐘後即可在 12 上閱讀發布的 syfbook
其他
12 上的自動發布與更新是透過 git 鉤子,
將更新後的檔案同步到獨立的(i.e.未受 git 版控,僅為檔案目錄)目錄下,
該目錄下的檔案會被 nodejs 的 gitbook serve 作監控,
當檔案目錄有變動時(在此處即為受到鉤子更新)則會重新編譯成靜態檔案。
12 上發布的 syfbook service,會在 12 boot 後自動啟動。
如果無啟動或錯誤,可手動執行
sh /var/www/syfbook/serve.sh試試