頁面公開與隱藏規則
這份規則用來統一 `Exercises` 內各類 HTML 的公開方式,避免之後再出現 hidden 頁、錯誤入口或把編輯頁直接公開。
哪些頁面要公開
- 每個單元的主頁 `index.html`。
- 學生需要直接打開觀看的示範頁、成果頁、答案版頁面。
- 主課頁中明確提到的 `完成版` 或 `答案版` 範例頁。
- 需要在課堂中直接展示的 example / preview / 完成版 / 答案版頁面。
哪些頁面應保持隱藏
- `for-edit` 或 `start` 資料夾中的頁面。
- 只供老師或學生修改的草稿頁、半成品頁。
- `another-example`、`index-old`、測試頁、臨時頁。
- 純技術拆件頁,如果不是主課頁的一部分,不應直接放公開入口。
主課頁應怎樣放入口
- 主課頁底部可設 `練習預覽` 或 `成果展示` 區。
- 只連到適合學生直接打開的 `完成版` 或 `答案版` 頁面。
- 不要在主課頁直接連到 `for-edit`、`start`、`*-edit`。
- 如需要提及 `for-edit` 或 `start`,只寫用途說明,不放公開超連結。
命名與路徑建議
- 主單元資料夾用對應 `Slides_*` 名稱。
- `final` 內建議保留清楚的題號或功能名。
- `for-edit`、`start`、`.*-edit` 保持只作教材編輯用途。
- 避免把資料夾命名成看起來像單一 `.html` 檔,減少 hidden 掃描誤判。
對外顯示名稱統一規則
- 之後新頁面的對外文案,只固定使用 `未完成版`、`完成版`、`答案版` 三種名稱。
- `start`、`for-edit`、`*-edit` 這類路徑,在按鈕、標題、說明文中一律顯示為 `未完成版`。
- `final` 這類完成效果頁,如果是展示最終成果,顯示為 `完成版`。
- `Final-Sample`、`參考答案`、老師示範解法這類頁面,顯示為 `答案版`。
- 不要把 `Start`、`Final`、`For-Edit`、`Final-Sample` 直接當作對外顯示名稱。
之後整理新頁的順序
- 先建立或更新主課頁 `index.html`。
- 把適合公開的 `完成版` 或 `答案版` 頁面加到主課頁底部的 `成果展示` 區。
- 確認 `未完成版` 路徑不在公開入口中。
- 最後再掃一次 hidden HTML,確保沒有漏掉真正應公開的頁面。