STUDENT HTML DOCUMENT

小綠作品集

這是瀏覽器可讀的 README 預覽;Markdown 原檔仍保留在練習資料夾供實作。

這份 README.md 是要編輯、提交的來源;README.html 只是教材產生的靜態預覽,不會取代 Markdown,也不應拿來放假 hash、假 URL 或假驗收結果。Solution 只完成三項核心 TASK,不代填學生自己的 Git 證據。

Secret safety: 不要把 token、密碼、API key、cookie、.env 內容、個資或其他憑證寫進 README、commit、截圖或 GitHub。需要示範時只使用遮罩後的假值;不要提交真實秘密,也不要放可直接貼上的假 repo URL。

作品介紹

這是一份給初次認識我的訪客閱讀的前端作品集,集中展示活動頁、品牌頁與聯絡入口。

DONE-01 的可觀察證據: README 說明作品用途,第一筆 commit 只包含作品骨架與定位,git status --short 顯示乾淨。範圍應為 README.mdREADME.htmlindex.htmlstyle.css;以 git show --stat --oneline HEAD 核對,並確認 git status --short 無輸出。

主要功能

如何開啟

下載整個資料夾後,以瀏覽器開啟 index.html

DONE-02 的可觀察證據: 陌生人能依 README 開啟作品,第二筆 commit 只處理功能與開啟方式,且 git status --short 顯示乾淨。依上述文件實際開啟作品,以 git show --stat --oneline HEADgit log --oneline -2git status --short 核對實際變更範圍只包含 README.md

排錯與版本證據

DONE-03 的可觀察結果: 排錯紀錄可重現,git log 顯示三筆範圍清楚且可說明的 commit,git status --short 顯示乾淨。

可重現的排錯紀錄

以下是排錯紀錄的寫法與重跑順序;交件時要以自己實際操作的輸出驗收,不把這段文字當成已完成的個人證據。

  1. 症狀: README 修改後,git status --short 顯示工作目錄仍有未提交變更,或 GitHub 頁面尚未反映最新內容。
  2. 重現: 在個人練習資料夾執行 pwdgit status --short,再以 git diff -- README.md 查看未提交差異;確認問題發生在本機工作樹,而不是先猜測遠端狀態。
  3. 定位: 先確認目前位於正確 repo,再用 git diff -- README.md 對照本次排錯紀錄,並用 git log --oneline -3 檢查三筆 commit 是否各有單一責任。
  4. 修正: 只將本次排錯紀錄加入 README.md,執行 git add README.md,建立第三筆「記錄 Git 排錯流程」commit;不要把 token、密碼、個資或 .env 一起加入。
  5. 重跑: 執行 git status --shortgit log --oneline -3git rev-parse HEAD;前者應無輸出,後兩者應呈現三筆可說明的 history 與實際最新本機 hash。

三筆 commit 的責任

順序commit 責任核對方式
第一筆建立作品集骨架與定位:說明用途/目標讀者,範圍為 README.mdREADME.htmlindex.htmlstyle.cssgit show --stat --oneline <第一筆 hash>;提交後 git status --short 無輸出
第二筆補上主要功能與本機開啟方式,範圍只為 README.mdgit show --stat --oneline <第二筆 hash>,並依 README 開啟 index.html
第三筆記錄 Git 排錯流程,範圍只為 README.mdgit show --stat --oneline <第三筆 hash>git log --oneline -3

最新本機 hash: 執行 git rev-parse HEAD 後記錄實際輸出;Solution 不提供示範 hash。若提供 GitHub URL,驗收者必須查詢遠端最新 hash,並確認它與本機 git rev-parse HEAD 完全一致;未提供 URL 時,不要填入假 repo URL。

最終驗收