xamjiang/handout-remake

# iPad 深色講義製作 SOP

把老師的上課教材重新教一次，做成一份在 11 吋 iPad 直向閱讀、可以用 Apple Pencil 作答的深色 PDF。
這份文件是規則（怎麼教、怎麼排、怎麼畫）；排版與建置用的檔案放在本 skill 資料夾（這份 SKILL.md 所在的資料夾），見〈檔案〉。

讀者設定：對這門課幾乎零基礎；用台灣正體中文；最在意資訊排版清楚，討厭花俏和雜亂的層級；喜歡生活例子和動手練習。

## 流程

1. **讀懂來源**。PPT 用 `soffice --headless --convert-to pdf` 轉成 PDF，再用 `pdftotext -layout` 取文字、`pdftoppm -r 40 -png` 轉縮圖並實際看過每一頁（公式和圖常常只存在圖片裡）。來源檔放在獨立資料夾，不要在裡面執行程式。
2. **決定範圍並切段**。一份講義只教一個小節，大約對應 6–12 張投影片、成品 12–18 頁。範圍以投影片為準，但不要逐張翻譯：先自己弄懂，再依「初學者要先知道什麼」重新安排順序。一章太長就拆成多份（例如「上」「下」），並在回覆中說明這份涵蓋到哪一頁。切成 3–6 個段落，每個段落只講一個概念。
3. **寫內容**，遵守〈教學規則〉。
4. **畫圖**，遵守〈圖解規則〉。
5. **排成 HTML**。照〈環境準備〉建立工作資料夾並複製檔案，然後複製 `template.html` 改寫內容。一個 `<section class="page">` 就是一頁，手動分頁。