PPTX 建立、編輯與分析
概述
使用者可能會要求您建立、編輯或分析 .pptx 檔案的內容。.pptx 檔案本質上是一個 ZIP 壓縮檔,內含 XML 檔案與其他資源,您可以讀取或編輯這些內容。針對不同的任務,您可以使用不同的工具與工作流程。
讀取與分析內容
文字提取
如果您只需要讀取簡報的文字內容,請將文件轉換為 Markdown 格式:
# 將文件轉換為 Markdown
python -m markitdown path-to-file.pptx
原始 XML 存取
若要處理註解、備忘錄、投影片版面配置、動畫、設計元素與複雜格式,您需要存取原始 XML。對於這些功能,您必須先解壓縮簡報,然後讀取其原始 XML 內容。
解壓縮檔案
python ooxml/scripts/unpack.py <office_file> <output_dir>
注意:unpack.py 腳本位於專案根目錄的 skills/pptx/ooxml/scripts/unpack.py。如果該路徑下沒有這個腳本,請使用 find . -name "unpack.py" 來尋找。
關鍵檔案結構
ppt/presentation.xml- 主要簡報中繼資料與投影片參考ppt/slides/slide{N}.xml- 個別投影片內容 (slide1.xml、slide2.xml 等)ppt/notesSlides/notesSlide{N}.xml- 每張投影片的備忘錄ppt/comments/modernComment_*.xml- 特定投影片的註解ppt/slideLayouts/- 投影片的版面配置範本ppt/slideMasters/- 投影片母片範本ppt/theme/- 主題與樣式資訊ppt/media/- 圖片與其他媒體檔案
字型與色彩擷取
當需要模仿指定的設計範例時:請務必先使用下列方法分析簡報的字型與色彩:
- 讀取主題檔案:檢查
ppt/theme/theme1.xml中的顏色 (<a:clrScheme>) 與字型 (<a:fontScheme>) - 取樣投影片內容:檢查
ppt/slides/slide1.xml中實際使用的字型 (<a:rPr>) 與顏色 - 搜尋模式:使用 grep 在所有 XML 檔案中尋找顏色 (
<a:solidFill>,<a:srgbClr>) 與字型的參考
不使用範本建立新的 PowerPoint 簡報
若要從無到有建立新的 PowerPoint 簡報,請使用 html2pptx 工作流程,將 HTML 投影片轉換為 PowerPoint,並確保定位精準。
設計原則
關鍵:在建立任何簡報前,請先分析內容並選擇合適的設計元素:
- 考慮主題:這份簡報的主題是什麼?它暗示了什麼樣的調性、產業或氛圍?
- 檢查品牌:如果使用者提到某家公司/組織,請考慮他們的品牌色彩與識別
- 配色符合內容:選擇能反映主題的顏色
- 說明您的做法:在編寫程式碼之前,解釋您的設計選擇
需求:
- ✅ 在編寫程式碼之前,說明您根據內容做出的設計選擇
- ✅ 僅使用網頁安全字型:Arial、Helvetica、Times New Roman、Georgia、Courier New、Verdana、Tahoma、Trebuchet MS、Impact
- ✅ 透過大小、粗細與顏色建立清晰的視覺層次
- ✅ 確保可讀性:強烈對比、適當大小的文字、整齊的對齊
- ✅ 保持一致:在投影片之間重複使用模式、間距與視覺語言
配色方案選擇
創意選色:
- 跳脫預設:什麼顏色真正符合這個特定主題?避免自動選擇。
- 考慮多個角度:主題、行業、氛圍、能量等級、目標受眾、品牌識別 (如果有提到)
- 勇於嘗試:嘗試意想不到的組合——醫療保健簡報不一定要用綠色,金融簡報不一定要用海軍藍
- 建立色板:選擇 3-5 種能搭配的顏色 (主色 + 輔助色 + 強調色)
- 確保對比:文字在背景上必須清晰可讀
範例色板 (使用這些範例來激發靈感——選擇一個、改編它,或建立自己的色板):
- 經典藍:深海軍藍 (#1C2833)、石板灰 (#2E4053)、銀色 (#AAB7B8)、米白 (#F4F6F6)
- 青綠與珊瑚:青綠 (#5EA8A7)、深青綠 (#277884)、珊瑚 (#FE4447)、白色 (#FFFFFF)
- 大膽紅:紅色 (#C0392B)、亮紅 (#E74C3C)、橘色 (#F39C12)、黃色 (#F1C40F)、綠色 (#2ECC71)
- 暖色腮紅:紫紅 (#A49393)、腮紅 (#EED6D3)、玫瑰 (#E8B4B8)、奶油 (#FAF7F2)
- 酒紅奢華:酒紅 (#5D1D2E)、深紅 (#951233)、鐵鏽 (#C15937)、金色 (#997929)
- 深紫與祖母綠:紫色 (#B165FB)、深藍 (#181B24)、祖母綠 (#40695B)、白色 (#FFFFFF)
- 奶油與森林綠:奶油 (#FFE1C7)、森林綠 (#40695B)、白色 (#FCFCFC)
- 粉紅與紫色:粉紅 (#F8275B)、珊瑚 (#FF574A)、玫瑰 (#FF737D)、紫色 (#3D2F68)
- 萊姆與李子:萊姆 (#C5DE82)、李子 (#7C3A5F)、珊瑚 (#FD8C6E)、藍灰 (#98ACB5)
- 黑與金:金色 (#BF9A4A)、黑色 (#000000)、奶油 (#F4F6F6)
- 鼠尾草與赤陶:鼠尾草 (#87A96B)、赤陶 (#E07A5F)、奶油 (#F4F1DE)、木炭 (#2C2C2C)
- 木炭與紅:木炭 (#292929)、紅色 (#E33737)、淺灰 (#CCCBCB)
- 活力橘:橘色 (#F96D00)、淺灰 (#F2F2F2)、木炭 (#222831)
- 森林綠:黑色 (#191A19)、綠色 (#4E9F3D)、深綠 (#1E5128)、白色 (#FFFFFF)
- 復古彩虹:紫色 (#722880)、粉紅 (#D72D51)、橘色 (#EB5C18)、琥珀 (#F08800)、金色 (#DEB600)
- 復古大地色:芥末 (#E3B448)、鼠尾草 (#CBD18F)、森林綠 (#3A6B35)、奶油 (#F4F1DE)
- 海岸玫瑰:老玫瑰 (#AD7670)、海狸 (#B49886)、蛋殼 (#F3ECDC)、灰綠 (#BFD5BE)
- 橘與土耳其藍:淺橘 (#FC993E)、灰土耳其藍 (#667C6F)、白色 (#FCFCFC)
視覺細節選項
幾何圖案:
- 斜線區塊分隔線,而非水平線
- 不對稱欄寬 (30/70、40/60、25/75)
- 旋轉 90° 或 270° 的文字標題
- 圓形/六邊形圖片框
- 角落的三角形裝飾形狀
- 重疊形狀營造深度
邊框與框架處理方式:
- 單側粗邊框 (10-20pt)
- 對比色的雙線邊框
- 角落括弧,而非完整框架
- L 形邊框 (上方+左方 或 下方+右方)
- 標題下方的底線裝飾 (3-5pt 粗)
字型處理方式:
- 極端的尺寸對比 (72pt 標題 vs 11pt 內文)
- 大寫字母標題,搭配寬字距
- 使用超大顯示字型的編號章節
- 等寬字型 (Courier New) 用於資料/統計/技術內容
- 壓縮字型 (Arial Narrow) 用於資訊密集的內容
- 空心字型用於強調
圖表與資料樣式:
- 單色圖表,加上單一強調色標示關鍵資料
- 水平長條圖,而非垂直
- 圓點圖,而非長條圖
- 最少或無格線
- 資料標籤直接放在元素上 (無圖例)
- 超大數字顯示關鍵指標
版面創新:
- 滿版圖片搭配文字疊加
- 側邊欄 (20-30% 寬度) 用於導覽/脈絡
- 模組化網格系統 (3×3、4×4 區塊)
- Z 字型或 F 字型內容流向
- 浮動文字方塊置於彩色形狀上
- 雜誌風格多欄版面
背景處理方式:
- 佔據投影片 40-60% 的實心色塊
- 漸層填滿 (僅限垂直或對角)
- 分割背景 (雙色,對角或垂直)
- 邊到邊的色帶
- 將留白作為設計元素
版面配置提示
建立包含圖表或表格的投影片時:
- 雙欄版面 (首選):使用跨欄的標題,下方再分為兩欄——文字/項目符號一欄,重點內容另一欄。這能提供更好的平衡,並使圖表/表格更易讀。使用不等欄寬 (例如 40%/60%) 的 flexbox 來為每種內容類型最佳化空間。
- 全投影片版面:讓重點內容 (圖表/表格) 佔據整張投影片,以達到最大的視覺衝擊與可讀性
- 永遠不要垂直堆疊:不要將圖表/表格放在文字下方的同一欄中——這會導致可讀性不佳與版面問題
工作流程
- 必讀 - 完整閱讀檔案:從頭到尾完整閱讀
html2pptx.md。閱讀此檔案時,絕對不要設定任何範圍限制。 在開始建立簡報前,請閱讀完整的檔案內容,以了解詳細語法、關鍵格式規則與最佳實務。 - 為每張投影片建立一個具有適當尺寸 (例如 16:9 比例為 720pt × 405pt) 的 HTML 檔案
- 使用
<p>,<h1>-<h6>,<ul>,<ol>處理所有文字內容 - 使用
class="placeholder"標記將要加入圖表/表格的區域 (以灰色背景呈現,便於檢視) - 關鍵:首先使用 Sharp 將漸層與圖示轉換為 PNG 圖片,然後在 HTML 中引用
- 版面配置:對於包含圖表/表格/圖片的投影片,請使用全投影片版面或雙欄版面以獲得更好的可讀性
- 使用
- 建立並執行一個 JavaScript 檔案,使用
html2pptx.js程式庫將 HTML 投影片轉換為 PowerPoint 並儲存簡報- 使用
html2pptx()函數處理每個 HTML 檔案 - 使用 PptxGenJS API 將圖表與表格加入佔位區域
- 使用
pptx.writeFile()儲存簡報
- 使用
- 視覺驗證:產生縮圖並檢查版面問題
- 建立縮圖網格:
python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4 - 仔細檢查縮圖圖片,查看是否有以下問題:
- 文字被截斷:文字被標題列、形狀或投影片邊緣截斷
- 文字重疊:文字與其他文字或形狀重疊
- 定位問題:內容太靠近投影片邊界或其他元素
- 對比問題:文字與背景之間的對比不足
- 若發現問題,請調整 HTML 的邊距/間距/顏色,並重新產生簡報
- 重複此步驟,直到所有投影片的視覺效果都正確為止
- 建立縮圖網格:
編輯現有的 PowerPoint 簡報
編輯現有 PowerPoint 簡報中的投影片時,您需要處理原始的 Office Open XML (OOXML) 格式。這涉及解壓縮 .pptx 檔案、編輯 XML 內容,然後重新打包。
工作流程
- 必讀 - 完整閱讀檔案:從頭到尾完整閱讀
ooxml.md(約 500 行)。閱讀此檔案時,絕對不要設定任何範圍限制。 在開始編輯簡報前,請閱讀完整的檔案內容,以取得關於 OOXML 結構與編輯工作流程的詳細指引。 - 解壓縮簡報:
python ooxml/scripts/unpack.py <office_file> <output_dir> - 編輯 XML 檔案 (主要是
ppt/slides/slide{N}.xml及相關檔案) - 關鍵:每次編輯後立即進行驗證,並在繼續之前修正所有驗證錯誤:
python ooxml/scripts/validate.py <dir> --original <file> - 打包最終簡報:
python ooxml/scripts/pack.py <input_directory> <office_file>
使用範本建立新的 PowerPoint 簡報
當您需要建立一個遵循現有範本設計的簡報時,您需要先複製並重新排列範本投影片,然後取代佔位內容。
工作流程
-
提取範本文字並建立視覺縮圖網格:
- 提取文字:
python -m markitdown template.pptx > template-content.md - 讀取
template-content.md:完整閱讀整個檔案以了解範本簡報的內容。閱讀此檔案時,絕對不要設定任何範圍限制。 - 建立縮圖網格:
python scripts/thumbnail.py template.pptx - 詳情請參閱建立縮圖網格章節
- 提取文字:
-
分析範本並將庫存清單儲存至檔案:
- 視覺分析:檢視縮圖網格以了解投影片版面、設計模式與視覺結構
- 建立範本庫存清單檔案
template-inventory.md,內容包含:# 範本庫存分析 **投影片總數:[計數]** **重要:投影片索引從 0 開始 (第一張投影片 = 0,最後一張 = 總數-1)** ## [類別名稱] - 投影片 0:[版面代碼 (若可用)] - 說明/用途 - 投影片 1:[版面代碼] - 說明/用途 - 投影片 2:[版面代碼] - 說明/用途 [... 每張投影片都必須單獨列出其索引 ...] - 使用縮圖網格:參考視覺縮圖來識別:
- 版面模式 (標題投影片、內容版面、章節分隔線)
- 圖片佔位符的位置與數量
- 不同投影片群組之間的一致性
- 視覺層次與結構
- 此庫存清單檔案是在下一步驟中選擇合適範本的必要條件
-
根據範本庫存建立簡報大綱:
- 檢閱步驟 2 中可用的範本。
- 為第一張投影片選擇一個介紹或標題範本。這應該是前幾個範本之一。
- 為其他投影片選擇安全的、以文字為主的版面。
- 關鍵:將版面結構與實際內容匹配:
- 單欄版面:用於統一的敘事或單一主題
- 雙欄版面:僅在您有剛好 2 個不同的項目/概念時使用
- 三欄版面:僅在您有剛好 3 個不同的項目/概念時使用
- 圖片+文字版面:僅在您有實際圖片要插入時使用
- 引言版面:僅用於引用人物 (附上出處) 的真實引言,絕不用於強調
- 切勿使用比您擁有的內容還要多個佔位符的版面
- 如果您有 2 個項目,不要將它們塞進三欄版面
- 如果您有 4 個以上的項目,可以考慮分成多張投影片或使用列表格式
- 在選擇版面之前,先計算您實際的內容數量
- 驗證所選版面的每個佔位符都將填入有意義的內容
- 為每個內容區塊選擇一個代表最佳版面的選項。
- 儲存
outline.md,內容包含內容以及利用現有設計的範本對應 - 範本對應範例:
...