Communitygithub.com

premium-pdf-design

機構級 PDF 簡報與報告設計系統,包含 16:9 深色高管簡報與 Letter 淺色瑞士象牙白報告,強制執行可驗證開放資料管線、60-30-10 色彩平衡、Tufte 髮絲線、Minto 金字塔行動標題等規範。

premium-pdf-design 是什麼?

此技能提供一個嚴謹的 PDF 設計系統,專為製作機構級的 16:9 深色高管簡報(投影片)與 Letter 淺色瑞士象牙白報告而設計。它強制執行一套「10 大反作弊嚴格規則」,確保所有資料來自不可變的原始檔案,並透過 Pydantic 領域約束與獨立重新計算進行驗證,保證資料完整性。設計方面遵循四大黃金法則:60-30-10 色彩階層(深色/淺色模式)、髮絲線與留白重力(禁止方框卡片)、Minto 金字塔行動標題(禁止被動標籤),以及校準的垂直填充預算。此外,它還整合了 300 DPI 的向量資料視覺化、安全的 Inter 字型註冊、全出血畫布繪製,以及基於 PyMuPDF 的自動化視覺 QA 審核。支援 ReportLab(用於程式化 PDF 生成)和 WeasyPrint(用於旗艦級 SVG 展品)兩種實作模式。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gke0op/verifiable-editorial-skills/tree/HEAD/skills/premium-pdf-design

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

可驗證的機構級 PDF 簡報與資料視覺化系統

此技能需搭配 verifiable-pdf-pipeline(資料完整性)和 editorial-page-layout-guidelines(網格幾何)使用,以產出媲美 McKinsey、Stripe Press、WEF 與 The Economist 的出版級 16:9 深色高管投影片 與 Letter 淺色瑞士象牙白機構報告。


1. 核心不變原則:內容先於美學

使用此技能建立的每份簡報或報告都必須遵守 verifiable-pdf-pipeline/SKILL.md 中定義的 10 大反作弊嚴格規則:

  1. 零手寫資料隔離 — 所有數字都必須從 data/raw/ 中的不可變原始檔案解析。
  2. 現實與不變性編譯器 — 強制執行 Pydantic 領域邊界與會計恆等式。
  3. 反循環驗證 — 獨立對原始檔案重新計算,並透過 Python AST 檢查禁止硬編碼的字面斷言。
  4. 原子溯源分類帳 — 每個發布的純量都必須在 data/provenance_ledger.json 中有一對一的對應。
  5. 消極能力與神聖的「N/A」 — 真實的上游空值應明確呈現為 [N/A],而非捏造的代理值。
  6. 編譯鎖定 — PDF 編譯器必須呼叫 verify_integrity.py,並在非零退出時中止。
  7. 類別與單位守衛 — 絕不混合不可通約的範圍或測試方法。
  8. 法定證明 — 任何監管/關稅聲明都需要官方公報 ID。
  9. 科學分類學與註冊驗證 — 必須逐字對照即時的 GBIF/OpenTree/iNaturalist 註冊資料庫,核對雙名法、權威、系統發育與 IUCN 狀態。
  10. 渲染後的散文校準 (vedit prose) — 最終 PDF 中的每個渲染數字都必須能追溯到 provenance_ledger.json、summary_metrics.json 或 background_citations.json 中 DOI 支援的條目。

2. 四大黃金設計法則

法則 1:60-30-10 色彩階層(淺色與深色模式)

  • 淺色瑞士編輯模式(Letter 報告):
    • 60% 畫布:瑞士暖象牙白 (#fcfbf9) — 必須透過 onPage 明確繪製。
    • 30% 骨架:深海軍藍 (#0f2b48)、石板灰 (#334155)、鋼鐵灰 (#64748b)、髮絲線 (#cbd5e1)、微妙色調 (#f1f5f9)。
    • 10% 信號強調色:鈷藍 (#0284c7)、琥珀色 (#d97706)、翡翠綠 (#059669)、信號紅 (#dc2626 — 僅用於風險/激增)。
  • 深色執行模式(16:9 投影片):
    • 60% 畫布:深黑曜石 (#0b0f19) 或午夜海軍藍 (#051c2c) — 必須在 onFirstPage/onLaterPages 中於 flowables 渲染前繪製全出血,絕不能依賴預設的白色 PDF 紙張!
    • 30% 骨架與高對比文字:微妙色調帶 (#111827 / #0a253a)、髮絲線 (#243247)、純白標題 (#ffffff)、清晰淺色正文 (>= #e2e8f0,>= 9.5–10 pt)、次要說明文字 (>= #cbd5e1,絕不用 #64748b–#94a3b8 的暗淡文字)。當參數化線框波紋或明亮藝術品靠近文字時,始終在封面排版下方放置一個微妙的水平深色遮罩。
    • 10% 信號強調色:電光鈷藍 (#38bdf8)、亮琥珀色 (#fbbf24)、翡翠綠 (#34d399)、信號紅 (#f87171)。

法則 2:髮絲線與留白重力(零方框卡片)

  • 絕不將指標或散文困在厚重的矩形 BOX 邊框或 INNERGRID 網頁儀表板方框中。
  • 透過 無邊框色調帶(深色 #111827 / 淺色 #f1f5f9)來分組 KPI 和重點提示,並在其頂部加上一條清晰的 1.2 pt 頂部強調髮絲線、寬敞的 12–16 pt 欄間距,以及書籤風格的 Tufte 橫向線(零垂直線)。

法則 3:Minto 金字塔行動標題

  • 每張投影片或報告章節都應以 一個完整、果斷的主張 開頭,而非被動的主題標籤:
  • 禁止: 「全球排放趨勢」
  • 要求: 「OECD-5 減少排放 -25.0%,然而新興-3 激增 +235.8%,推動總體達到 23.52 Gt CO2e。」

法則 4:校準的垂直填充預算 + 視覺檢查

  • Letter 報告 (612×792 pt): 目標垂直填充率 85%–92%(最低 >= 82%)。
  • 16:9 投影片 (960×540 pt): 目標垂直填充率 72%–88%(最低 >= 72%)。
  • 絕不將自動化通過視為最終結果:透過 audit_pdf.py 匯出 180-DPI PNG 預覽,並目視檢查每個渲染頁面是否有標籤重疊、孤兒標題換行和視覺平衡。

3. 機構級資料視覺化配方(300 DPI,透明背景)

以 dpi=300、transparent=True 渲染所有圖表,移除頂部/右側軸線,並使用主題匹配的色板(dark 與 light):

  1. 雙面板時間序列 + 速率加速度: 歷史月度/日軌跡,附事件陰影和直接起始/峰值註釋,並搭配十年/週期速率條。
  2. 堆疊質量平衡區域 + 指數軌跡: 堆疊流量體積,附 直接右邊緣終點標籤(零獨立浮動圖例框!),並搭配 Base = 100 結構分歧線。
  3. 脫鉤象限散點圖 + 啞鈴壓縮: 2D 增長與結果散點圖,附陰影目標象限 + 針對緊密叢集的引導箭頭,並搭配基線到當前水平的水平啞鈴圖。
  4. Stephen Few 水平子彈圖: 3 個定性背景帶 + 主要效能條 + 垂直琥珀色基線/目標刻度 + 右對齊的變化量文字(使用 ax.spines["bottom"].set_bounds(...) 修剪 x 軸脊柱)。
  5. 記憶體內無頭 Tufte 走勢圖: 46–66 pt × 13–16 pt 的微線條,渲染到 io.BytesIO() 緩衝區,並直接嵌入 ReportLab 表格單元格,帶有語意的翡翠綠/信號紅終點點。
  6. 起點-終點矩陣熱圖與山脊線 KDE: 順序色板,搭配對比切換的雙重排版或重疊分佈山脊線,標記 $P_{50}$ 和 $P_{90}$。

4. 生產級 ReportLab 實作模式

4.1 全出血畫布繪製(對於深色與象牙白主題至關重要)

始終註冊一個 onPage 回呼,使畫布背景在每個頁面上繪製 於 所有 flowables 之下:

from reportlab.lib import colors

def paint_background(canv, _doc, bg_hex="#0b0f19", accent_hex="#38bdf8", page_w=960.0, page_h=540.0):
    canv.saveState()
    canv.setFillColor(colors.HexColor(bg_hex))
    canv.rect(0, 0, page_w, page_h, fill=1, stroke=0)
    if canv.getPageNumber() == 1:
        canv.setFillColor(colors.HexColor(accent_hex))
        canv.rect(0, page_h - 4, page_w, 4, fill=1, stroke=0)
    canv.restoreState()

4.2 安全的 Inter TTF 發現機制與乾淨的備援方案

絕不應在未註冊 TTF 的情況下硬編碼 "Inter-SemiBold" — 應使用一個輔助函式來檢查 INTER_FONT_DIR 和標準的 OS 字型路徑,並在找不到時乾淨地回退到 Helvetica:

import os
from pathlib import Path
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont

def register_editorial_fonts() -> dict[str, str]:
    search = [Path(os.environ["INTER_FONT_DIR"])] if os.environ.get("INTER_FONT_DIR") else []
    search += [Path.home() / "Library/Fonts", Path("/Library/Fonts"), Path("/usr/share/fonts/truetype/inter")]
    files = {"regular": "Inter-Regular.ttf", "semibold": "Inter-SemiBold.ttf",
             "bold": "Inter-Bold.ttf", "italic": "Inter-Italic.ttf", "bold_italic": "Inter-BoldItalic.ttf"}
    found = {r: d / f for d in search if d.is_dir() for r, f in files.items() if (d / f).is_file()}
    if {"regular", "bold", "italic", "bold_italic"}.issubset(found):
        for role, name in [("regular", "Inter-Regular"), ("bold", "Inter-Bold"),
                           ("italic", "Inter-Italic"), ("bold_italic", "Inter-BoldItalic")]:
            pdfmetrics.registerFont(TTFont(name, str(found[role])))
        semi = "Inter-Bold"
        if "semibold" in found:
            pdfmetrics.registerFont(TTFont("Inter-SemiBold", str(found["semibold"])))
            semi = "Inter-SemiBold"
        pdfmetrics.registerFontFamily("Inter-Regular", normal="Inter-Regular", bold="Inter-Bold",
                                      italic="Inter-Italic", boldItalic="Inter-BoldItalic")
        return {"regular": "Inter-Regular", "semibold": semi, "bold": "Inter-Bold",
                "italic": "Inter-Italic", "bold_italic": "Inter-BoldItalic", "mono": "Courier"}
    return {"regular": "Helvetica", "semibold": "Helvetica-Bold", "bold": "Helvetica-Bold",
            "italic": "Helvetica-Oblique", "bold_italic": "Helvetica-BoldOblique", "mono": "Courier"}

4.3 兩次傳遞的執行標題與動態頁碼

使用 reportlab.pdfgen.canvas.Canvas 的子類別,在 showPage() 中儲存頁面狀態字典,並在 save() 中印出 "Page X of Y" 或 "Slide X / Y"(請參閱 examples/reportlab_premium_template.py)。


5. 2023 年諮詢旗艦模式(WeasyPrint + 純向量內嵌 SVG)

對於以旗艦級 2023 年機構出版物(Quantum Technology Monitor、The Economic Potential of Generative AI、Global Economics Intelligence、The State of Organizations)為藍本的高階投影片,請將 WeasyPrint(@page { size: 960pt 540pt; margin: 0; }) 與 100% 純向量內嵌 <svg> 展品 結合使用:

  1. 深色英雄 / 純白資料極性節奏(禁止單調):
    • 封面英雄: 深午夜海軍藍 (#051C2C) 過渡到鈷藍 (#0A2E8A),覆蓋一層 42 股參數化雙曲貝茲線框波紋 (#2251FF / #00A9F4),並在右側放置乾淨的編輯英雄圖稿。
    • 執行摘要: 全出血 #051C2C,清晰的 28 pt 白色襯線標題下方緊接一條 1.2 pt 白色水平線,3 個寬敞的無襯線列,以及 3 個巨大的青色/藍色襯線 KPI。
    • 分隔章節頁: 上半部 48% 全出血發光圖稿,由一個 120 pt 粗體白色襯線數字(1、2)錨定;下半部 52% 純白,帶有 220 pt 左縮排的襯線章節標題和 2 欄框架文案。
    • 資料展示投影片: 純 #FFFFFF 畫布,19.5–22 pt 粗體襯線動作標題位於一條 1.1 pt #051C2C 線條上方,底部有微弱的頁尾分隔線,以及一個 右下角 #9AE6FF 冰青色章節進度藥丸。
  2. 高對比編輯襯線 + 幾何無襯線配對:
    • 展示用襯線字體 (Charter / Georgia / Baskerville Bold): 封面標題、章節數字、投影片動作標題、巨大的 54 pt #2251FF KPI 重點提示,以及中心甜甜圈總計。
    • 資料無襯線字體 (Inter / Helvetica Neue): 圖表註釋、副標題、縱橫線單元格、頁尾及啟發文案。
  3. 4 階 McKinsey 藍色色調漸層(零彩虹雜亂):
    • #051C2C 午夜海軍藍(錨定總計、基線、深度緊縮) → #06319C 深皇家藍 → #2251FF 電光藍(焦點差異、巨大 KPI、擴張激增) → #00A9F4 鮮豔青色 → #9AE6FF 冰青色(次要佔比與章節藥丸)。
  4. 標誌性向量 SVG 展品原型:
    • 質量平衡瀑布 / 橋接圖: 錨定條 (#051C2C)、浮動增加 (#2251FF) 和減少 (#00A9F4)、虛線階梯連接器、頂部方括號跨度提示,以及浮動襯線淨變化量。
    • 小多圖牆 + 灰色 » 啟發側邊欄: 分組的 5 + 3 索引軌跡卡片,搭配一個右側 #EFEFEF 側邊欄,並由一個圓形 #051C2C » 字形徽章(3 pt 白色環)橋接。
    • 10×10 圓角方形華夫單元矩陣: 由下而上填充的 10×10 網格(#E5E7EB 軌道,4 階藍色填充),並在灰色空白區域內置中顯示粗體數字。
    • 甜甜圈環 + 100% 堆疊佔比變遷: 5 階藍色甜甜圈(2 px 白色切片分隔線、襯線中心總計),搭配 2000 年與 2024 年的欄位,由半透明流向絲帶連接。
    • WeasyPrint SVG 護欄: 在 flex 容器內,始終為內嵌 <svg> 指定以 pt 為單位的明確 width/height(並設定 .slide { height: 539.5pt; break-after: page; break-inside: avoid; }),以防止出現子畫素空白溢出頁面或 300 px 的 SVG 收縮。切勿在 WeasyPrint 中對 <text> 使用 SVG 2 的 paint-order="stroke"(它會將筆畫 繪製在 文字填充 之上);應改用乾淨的標籤偏移或明確的背景 <rect> 代替。
  5. 全出血編輯攝影雜誌模式 (612 × 792 pt Letter 縱向,WeasyPrint): 在製作以攝影為主的編輯雜誌時(Kinfolk × Cereal × Condé Nast Traveler × National Geographic 風格,如 demos/felis-mundi-magazine/ 所示):
    • 排版與紙張材質: 將暖色調無塗層檔案紙 (#FAF8F5) 和深碳色墨水 (#161616) 與高對比 Didone 展示襯線字體(Didot / Bodoni 72)、暖色調書籍襯線正文(Charter / Baskerville,大小 9 pt,行距 1.5×)以及寬字距大寫無襯線元資料(Inter,大小 6.5–7 pt,字距 +0.18em)搭配使用。在全出血攝影上,無縫地將運行頁碼和版權資訊翻轉為純 #FFFFFF。
    • 連貫的攝影 (>= 50% 邊到邊出血): 在一個鎖定的 總攝影膠卷識別核心(請參閱 references/image_generation_recipes.md §5)下生成每個版面,在相鄰頁面之間變換跨頁架構(100% 封面 → 61% 頂部出血 → 65% 右側垂直欄 → 100% 攝影散文 → 76% 雙聯畫,帶有 4 pt 白色印刷中縫 → 68% 底部出血 → 77% 連絡表三聯畫 → 100% 結尾黃昏版權頁),並與 SHA-256 版面清單一起透明地為 AI 攝影註明出處。
    • WeasyPrint 雜誌護欄(經驗證):
      • 首字放大 (float: left): 切勿在 WeasyPrint 67.0 的 CSS Grid 或 Flexbox 項目內放置 float: left 的首字放大(它會縮小文字欄或導致首字放大偏移/碰撞)。對於分欄的雜誌頁面,請使用 position: absolute 的區塊欄(display: block),以便首字放大能夠 100% 貼左,並實現清晰的換行。
      • 無縫漸層遮罩: 切勿在 WeasyPrint 中將部分高度的 linear-gradient 覆蓋框放置在明亮的天空或雪地上(Cairo 會沿著框的邊緣繪製一條微弱的 1 px 髮絲線接縫)。始終將每個遮罩覆蓋層的大小設為其照片容器的 100%,並在透明停駐點內淡出到 rgba(..., 0)。
      • 旋轉的邊緣版權資訊: 使用 top: 18pt; right: 16pt; transform-origin: 100% 0%; transform: rotate(90deg); text-align: right; 來錨定垂直的右邊緣版權資訊。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能