Study Site
建立互動式、單一檔案的 HTML 學習頁面,以成品(artifact)形式發佈(若無法使用成品功能,則另存為 .html 檔案)。每個頁面都從 assets/template.html 開始,因此標準功能永遠不會被遺漏。
0. 設定 — 根據需求編輯
| 設定 | 值 |
|---|---|
| 主索引 URL(連結所有課程的中心頁面) | none — 可設定為您中心頁面的 URL,或保留 none 以跳過索引更新 |
| 預設主題 | light(始終包含深色模式切換) |
| 章節導覽 | 僅返回課程索引的連結 — 無上一頁/下一頁章節連結 |
| 索引卡片樣式 | 極簡:圖示、課程代碼、課程名稱 — 不顯示統計資料 |
1. 先詢問(一輪提問)
僅詢問請求中尚未明確的項目:
- 這是為課程設計的嗎? 如果是:哪門課程、哪個章節或區塊。課程頁面在標準功能之上會附加考試模式與複習工具;非課程頁面(一般主題、一次性解說)則跳過這些功能。
- 應該列在哪裡? 直接在主索引上、在課程學習索引內(指定哪個索引),或是不列在任何地方。如果主索引設定為
none,則跳過此問題。 - 如果課程的學習索引 URL 未知,請詢問 — 頁面的返回連結需要它。
如果使用者曾儲存關於他們希望如何教授某門課程的筆記(記憶、專案說明、先前的訊息),請閱讀並遵循這些筆記,優先於下方的預設值。
2. 在開始建構前收集資料
- 完整閱讀所有附件:簡報、筆記、考古題、練習卷。
- 收集每個主題對應的歷年考題(PYQs)和練習題。
- 在來源資料中修正錯誤時保持靜默;除非被詢問,否則不要指出它們。
- 然後再規劃主題清單:每個邏輯主題一個
<section class="topic">,內容盡量精簡,可一次性完成。
3. 教學規則(所有學科)
- 假設無先備知識。從基礎建立,每個術語首次使用時定義,詳細說明而非壓縮內容。
- 每個主題內的順序:解釋 → 其圖表(緊接在後)→ 圖表說明 → 範例 → 考古題/練習題 → 練習選擇題。 永遠不要將圖表集中放在結尾。
- 每個圖表都必須附有說明。絕不發佈裸圖表。
- 用
.callout.imp標記考試重點,用.callout.mistake標記常見陷阱。 - 題目: 每道題目在解答之前都必須完整寫出,不得濃縮。回答所有問題;不留任何未解答的題目。考古題須標示來源、年份與分數(例如
PYQ 2024 期中考 · 5分)。 - 每個主題至少 3 道練習選擇題,附有合理的干擾選項和
.why說明。 - 圖表使用內聯 SVG,絕不使用 ASCII。對於逐步演變的內容,使用
.stepper(每個狀態一個figure.fig.step)。 - 除非被要求,否則不提供學習計畫或日程安排。
4. 根據學科調整
| 學科類型 | 重點 |
|---|---|
| 理論 / 證明(計算理論、離散數學、演算法) | 每個自動機的狀態圖;追蹤輸入字串的逐步器;證明模板(泵引理、歸約、歸納法)作為填空步驟;大量小範例 |
| 系統(作業系統、計算機架構、網路) | 視覺優先;管線的逐步器、排程甘特圖、頁面置換、快取查找;逐步解題的數值題;教科書章節練習題 |
| 語言 / 形式符號(程式語言、編譯器) | BNF/EBNF、解析樹與屬性文法,以清晰的 SVG 樹狀圖呈現;正規表達式逐步建構;練習題內嵌解答 |
| 數學密集型(機器學習、統計學、訊號) | 先給直覺,再一步步推導,每一步都要說明理由;SVG 繪圖;教科書練習題解答 |
| 描述性(生物學、管理學、人文學) | 以考古題為驅動:將歷年考題按主題分組,提供符合考試長度的範例答案,使用流程圖與比較表格來說明流程 |
對於未列出的學科,選擇最接近的選項。使用者的課程筆記優先於此表格。
5. 頁面功能(內建於模板)
| 功能 | 運作方式 | 您的工作 |
|---|---|---|
| 淺色主題 + 深色切換 | 預設為淺色;🌙 切換;選擇會被記住 | 僅使用 CSS 變數 — 不使用硬編碼顏色 |
| 捲動位置還原 | 重新開啟時保存並還原位置 | 無需操作 |
| 進度追蹤 | 每個主題的「標記為已完成」、進度條、✓ 在目錄中 | 每個主題區段需有唯一的 id |
| 搜尋 | 過濾主題並高亮顯示匹配結果 | 無需操作 |
| 複製圖片 | 每個 figure.fig 上的懸浮按鈕可複製為 PNG(觸控裝置上始終可見) | 將每個圖表或影像包裹在 figure.fig 中 |
| 手機友善 | 響應式;表格可橫向捲動 | 保持 SVG 基於 viewBox;無固定寬度 |
| 練習選擇題 | 即時回饋;答案會被記住 | data-answer = 正確選項的 0 為基礎索引 |
| 顯示答案 | details.answer | 用於每個長篇解答 |
| 返回連結 | 頁首連結到課程學習索引 | 填入 {{COURSE_INDEX_URL}} |
| 僅限課程頁面: 複習工具 | 作弊表(.cheatsheet)+ 閃卡(.flashdeck) | 一頁包含公式、定義、關鍵圖表的摘要;至少 10 張閃卡 |
| 僅限課程頁面: 考試模式 | 模糊直到點擊「開始」;計時器;點擊「送出」後評分選擇題;顯示範例答案 | 混合選擇題(data-marks)和長題目,風格與該課程的考古題一致;設定 data-minutes |
進度與分數儲存在檢視者的瀏覽器中,每個頁面獨立 — 索引頁面無法顯示章節進度,且不會跨裝置同步。
6. 設計規則
- 極簡且平靜。長篇閱讀使用襯線字體,UI 使用無襯線字體。內容寬度約 820px。
- 避免 AI 味:不使用紫色漸層、英雄橫幅、全部置中排版、Inter 字體或表情符號紙屑。
- 顏色承載意義:藍色 = 資訊,金色 = 考試重點,紅色 = 錯誤,綠色 = 正確/完成。
- SVG 圖表:標示所有元素;使用
var(--text)、var(--accent)等作為線條與填色;在手機寬度下文字 ≥12px。
7. 課程學習索引頁面
對於課程索引或中心頁面:使用極簡卡片(參見設定)、相同的頁首(搜尋 + 主題切換)、捲動還原、預設淺色主題。
8. 建構、發佈、檢查
- 複製
assets/template.html,填入{{佔位符}},對於非課程頁面刪除僅限課程的區塊(或對於課程頁面取消註解它們)。 - 以成品形式發佈(或儲存為
.html檔案)。先展示頁面,之後再檢查。 - 在桌面與約 390px 寬度下檢查兩種主題:每個圖表都有複製按鈕、每個選擇題都有正確的
data-answer、每個問題都有解答、沒有剩餘的{{佔位符}}。 - 將頁面連結加入步驟 1 中所選的主索引或課程索引。不要重新設計索引頁面。