文件系統

[toomore]

以 https://github.com/ocftw/OSCVPass/issues/18 所討論使用 mdbook 來建立。

待確定項目：

• [x] 是否針對文件額外建立新的 repo，或是將文件部分存放在 ./docs 底下。
  • output.html.site-url
• [x] Hosting: Github or where?
• [x] Github actions for generating the docs.

Host on Github

1. Create branch: docs
2. Github Actions (trigger by push to main)
3. mdbook build in Github Actions, and push to branch: docs with GITHUB_DEPLOY_KEY

ref: Automated Deployment: GitHub Actions

Result

https://oscvpass.ocf.tw/docs/

nojekyll

Add .nojekyll in the root source.

ref: Static site generators