這份
README.md是要編輯、提交的來源;README.html只是教材產生的靜態預覽,不會取代 Markdown,也不應拿來放假 hash、假 URL 或假驗收結果。請在教材 repo 外的個人練習資料夾完成三項 TASK。
Secret safety: 不要把 token、密碼、API key、cookie、
.env內容、個資或其他憑證寫進 README、commit、截圖或 GitHub。需要示範時只使用遮罩後的假值;不要提交真實秘密,也不要放可直接貼上的假 repo URL。
作品介紹
尚未寫入作品用途與目標讀者。
預期 Git 證據: 完成後建立第一筆「建立作品集骨架與定位」commit;以 git show --stat --oneline HEAD 說明這筆 commit 的用途與範圍,並確認 git status --short 顯示乾淨。第一筆範圍依任務指示為 README.md、README.html、index.html、style.css。
完成時的預期結果: README 說明作品用途,第一筆 commit 只包含作品骨架與定位,git status --short 顯示乾淨;目前尚未是個人 repo 的驗收證據。
主要功能
- 尚未列出真實功能
如何開啟
尚未說明本機開啟方式。
預期 Git 證據: 完成後建立第二筆「補上功能與本機開啟方式」commit;以 git show --stat --oneline HEAD 與 git log --oneline -2 核對這筆只處理 README.md,並以 README 實際開啟作品、確認 git status --short 顯示乾淨。
完成時的預期結果: 陌生人能依 README 開啟作品,第二筆 commit 只處理功能與開啟方式,且 git status --short 顯示乾淨;目前尚未是個人 repo 的驗收證據。
排錯與版本證據
尚未記錄。請留下可重現的「症狀 → 重現 → 定位 → 修正 → 重跑」流程,並在第三筆「記錄 Git 排錯流程」commit 後執行 git log --oneline -3,逐筆說明三個 commit 的責任。
預期 Git 證據: 排錯紀錄只寫實際做過的操作;第三筆只處理 README.md,git log --oneline -3 能看見三筆範圍清楚且可說明的 commit,git status --short 顯示乾淨。
完成時的預期結果: 排錯紀錄可重現,git log 顯示三筆範圍清楚且可說明的 commit,git status --short 顯示乾淨;目前尚未是個人 repo 的驗收證據。
交付前檢查
README.md是來源,README.html只作靜態預覽。git status --short無輸出。git rev-parse HEAD的實際輸出是最新本機 hash。- 若提供 GitHub URL,驗收者必須核對遠端最新 hash 與本機 hash 一致;沒有 URL 就不要填假 URL。