跳轉到

發布前審核流程

摘要

本頁提供公開發布前的審核流程,用於降低敏感資料外洩、內容錯誤與網站建置失敗的風險。

適用情境

  • 新增或修改 docs/ 文章。
  • 更新 mkdocs.yml 導覽。
  • 部署到 Cloudflare Pages 或 GitHub Pages 前。

審核流程

1. 保密檢查

確認文章不含:

  • API keys、tokens、passwords、private keys
  • credentials 或 .env 內容
  • 內部行政資訊
  • 未確認可公開的草稿

2. 個資檢查

確認文章不含學生、同事、投稿者、受訪者或第三方個人資料。

3. 未公開研究資料檢查

確認沒有放入未公開論文、審稿意見、投稿資料、訪談逐字稿或研究計畫內部資料。

4. 引用與來源檢查

公開資料應標示來源或註明待補。未查證內容請標示「待確認」。

5. 連結檢查

確認相對連結存在,且沒有連到 private/drafts/ 或本機路徑。

6. Markdown 格式檢查

每頁只使用一個 H1。標題層級應依序遞進,路徑與指令使用 inline code。

7. Nav 檢查

確認 mkdocs.yml nav 指向存在的檔案,且沒有暴露不應公開內容。

8. Build 檢查

執行:

mkdocs build --strict

注意事項

若任何一項檢查未通過,應先修正再部署。

相關頁面

更新紀錄

  • 2026-07-02:建立完整初始版。