Markdown + Daux.io + GitHub Actions & Pages
起源於最近想要把之前隨手在 hackmd.io 打的筆記放到 GitHub 上讓朋友共編,先放個最後的成果: WildfootW / Security-Note ,當 main branch 有新的 push 時會自動生成 Daux.io 的 static html 檔,並且 push 到 gh-pages branch。 一開始是打算參考 OneJar 的文章 (免費無限建立自己的 GitBook 圖文教學 – 利用 GitHub Pages + GitHub Actions 自動發佈) 直接照做,但是有幾個問題: gitbook 已經遺棄開源社群,把原本的 gitbook 改為 legacy ,另外做了一個毫不相干的服務。 OneJar 寫的 GitHub Actions 是從頭到尾只有一個步驟,用他自己寫的 Dockerfile,也就是說 push gh-pages 要用到的 token 也要 Pass 給他做的 Docker,身為一個有資安潔癖的人實在有點困擾。 於是才決定改用 Daux.io 來做,順便研究 CI。 我們最主要的結構如下: .github/workflows/documentation.yml ─ GitHub Actions 需要的檔案,檔名可自訂。 docs/chapter…/articles… ─ 文章的目錄和文章本身 docs/config.json ─ Daux.io 生成書的設定檔,內容相當直覺,可以去 Daux.io Read more about Markdown + Daux.io + GitHub Actions & Pages[…]