Editorial PPTX Deck
產出精緻、編輯極簡風格的幻燈片簡報,並匯出為可編輯的 PPTX。最終交付物僅為 .pptx —— HTML 幻燈片只是建構來源,不產出 PDF 或 HTML 檢視器。
運作方式
幻燈片以受限的 HTML 撰寫(每個幻燈片一個檔案),接著 scripts/html2pptx.js 將每個 DOM 元素轉換為原生的 PowerPoint 物件(真正的、可雙擊編輯的文字框)。主體固定為 1280px × 720px = 960pt × 540pt (LAYOUT_WIDE)。
建構工作流程
複製此檢查清單並追蹤進度:
- [ ] 1. 建立專案結構(shared/ assets/ slides/ output/)
- [ ] 2. 規劃敘事架構 → 將每張幻燈片對應到一個範本類型
- [ ] 3. 從範本編寫 slides/NN-name.html(僅編輯文字)
- [ ] 4. check_overflow → 修正任何未完全符合 1280x720 的幻燈片
- [ ] 5. 匯出 PPTX(僅匯出此格式)
- [ ] 6. 清理建構來源(僅保留 .pptx)
1. 建立專案結構。 在工作目錄中建立 shared/、assets/、slides/、output/。從此技能複製 shared/tokens.css 到專案的 shared/。僅複製你會用到的照片,從此技能的 assets/ 複製到專案的 assets/。確保安裝相依套件一次:
npm i pptxgenjs playwright sharp && npx playwright install chromium
2. 規劃。 將來源內容轉換為幻燈片列表。每張幻燈片都屬於某個範本類型。典型的簡報結構 = 封面 → (章節分隔頁 → 1–3 張內容幻燈片) × 章節 → 結尾頁。文字保持簡潔;此風格要求留白充足。
3. 編寫幻燈片。 從 templates/ 複製最接近的範本到 slides/NN-name.html 並替換文字。規則:
- 保留
<link rel="stylesheet" href="../shared/tokens.css">。 - 標題使用襯線字體;其他所有文字使用無襯線字體(tokens.css 中已設定)。
- 僅使用一個紅色強調色。謹慎使用深色面板 (
--ink-panel) 以營造對比,其唯一強調色為金色#C9A24B。 - 照片透過
<img>引入(絕不能使用 CSSbackground-image)。請參閱照片庫。
4. 確認尺寸。 溢出的幻燈片在 PPTX 中會被裁剪:
node scripts/check_overflow.mjs --slides slides
修正所有標記為 OVERFLOW 的項目(縮短文字或調整位置),直到全部顯示為 1280x720。
5. 僅匯出 PPTX。
node scripts/export_deck_pptx.mjs --slides slides --out output/DeckName.pptx
幻燈片依檔名排序(01-…、02-…)。不要執行任何 PDF/HTML 匯出 —— PPTX 是唯一的交付物。
6. 清理。 刪除 slides/ 中的 HTML 與任何暫存檔案,僅保留 output/DeckName.pptx(如果使用者想疊代開發,可保留可重複使用的 shared/ 和 assets/)。
設計系統
定義於 shared/tokens.css。請勿發明新顏色。
| Token | HEX | 用途 |
|---|---|---|
--ink | #1A1A1A | 標題與主要內文 |
--soft | #555555 | 次要內文 |
--muted | #8C8C8C | 標籤、註解、頁碼 |
--red | #C8102E | 唯一強調色:條、引文、關鍵詞、底線 |
--red-deep | #A00C24 | 表格中的消極強調 |
--red-pale | #FBE9EC | 連接晶片(例如「→」圓圈) |
--box | #F4F3F1 | 淺色卡片 / 斑馬紋行 |
--line | #E4E2DE | 極細分隔線 |
--ink-panel | #1C1C1C | 深色對比面板 |
| gold | #C9A24B | 僅用於深色面板的強調色 |
| background | #FFFFFF | 頁面背景 |
- 字體: Georgia 襯線字體用於
h*/標題;Arial/Helvetica 無襯線字體用於所有其他文字。 - 標誌性元素: 標題左側的細紅色垂直條 + 上方小字距的紅色引文;底部居中放置小型頁碼。
- 品牌切換: 若要符合其他公司風格,只需更改
tokens.css中的--red(以及選擇性更改--ink-panel/gold)—— 無需更改其他項目。
照片庫
照片存放於此技能的 assets/。人像照片填滿右側約 40% 的分隔頁/封面面板(object-fit:cover);橫向照片適合滿版封面。
| 檔案 | 方向 | 最佳用途 |
|---|---|---|
sail.png | 人像 589×1024 | 分隔頁 / 封面右側面板(預設) |
lighthouse-cliff.png | 人像 627×1024 | 分隔頁 / 封面右側面板 |
staircase.png | 直立 312×1024 | 寧靜/抽象的分隔條 |
mast.png | 狹長 208×1024 | 狹長分隔條 |
hiker-clouds.png | 狹長 225×1024 | 狹長分隔條 |
lighthouse-sunset.png | 橫向 1024×721 | 滿版封面 / 頂部帶區 |
sailboat-deck.png | 橫向 1024×721 | 滿版封面 / 頂部帶區 |
透過更改 <img src="../assets/….png"> 來替換照片。為了整體一致性,在所有分隔頁中保持使用同一張照片(或同一個主題)。使用者也可以將自己的圖片放入 assets/。
範本目錄
位於 templates/(每個範本都是完整、不會溢位的 1280×720 幻燈片):
| 檔案 | 類型 |
|---|---|
01-cover.html | 分割封面:左側襯線標題,右側人像照片 |
02-divider.html | 章節分隔頁:引文 + 襯線標題 + 紅色條,右側人像照片 |
03-three-column.html | 引文/標題 + 核心線 + 3 欄 + 結果條 |
04-mapping.html | 雙欄「客戶需求 → 我們方案」搭配連接晶片 |
05-compare-table.html | 3 欄比較表格,斑馬紋行 |
06-dark-contrast.html | 雙面板(淺色 vs 深色)+ 襯線頁尾線 |
07-pipeline.html | 編號水平步驟流程 + 深色輸出條 |
08-closing.html | 結尾提案:編號襯線清單 + 右側人像照片 |
硬性限制
若違反以下限制,HTML→PPTX 轉換將失敗或顯示錯誤。完整細節與修正方式請參閱 reference.md:
- 文字只能放在
<p>/<h1>–<h6>中(絕不能有裸露在<div>中的文字)。 - 不能使用 CSS 漸層。
background/border/box-shadow僅能用於<div>,不可用於文字標籤。- 不能使用
background-image;請改用<img>。 - 行內標籤(
span/em/strong)不能有 margin。 - 主體大小固定為 1280×720;任何元素都不能溢出。
