關於手冊

本書使用 gitbook 編寫,下方列出後續維護之必要資訊。

先備知識與環境

  1. nodejs
  2. git
  3. gitbook
  4. markdown

步驟簡要

  1. git clonesyf/SYFbook 拉回到你自己的工作目錄
  2. 做你要的修改後,在你的工作目錄下運行 gitbook serve
    可以運行本地開發 server 並作 live reload 檢視
    預設是 http://localhost:4000/
  3. 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 試試

results matching ""

    No results matching ""