可驗證的機構級 PDF 簡報與資料視覺化系統
此技能需搭配 verifiable-pdf-pipeline(資料完整性)和 editorial-page-layout-guidelines(網格幾何)使用,以產出媲美 McKinsey、Stripe Press、WEF 與 The Economist 的出版級 16:9 深色高管投影片 與 Letter 淺色瑞士象牙白機構報告。
1. 核心不變原則:內容先於美學
使用此技能建立的每份簡報或報告都必須遵守 verifiable-pdf-pipeline/SKILL.md 中定義的 10 大反作弊嚴格規則:
- 零手寫資料隔離 — 所有數字都必須從
data/raw/中的不可變原始檔案解析。 - 現實與不變性編譯器 — 強制執行 Pydantic 領域邊界與會計恆等式。
- 反循環驗證 — 獨立對原始檔案重新計算,並透過 Python AST 檢查禁止硬編碼的字面斷言。
- 原子溯源分類帳 — 每個發布的純量都必須在
data/provenance_ledger.json中有一對一的對應。 - 消極能力與神聖的「N/A」 — 真實的上游空值應明確呈現為
[N/A],而非捏造的代理值。 - 編譯鎖定 — PDF 編譯器必須呼叫
verify_integrity.py,並在非零退出時中止。 - 類別與單位守衛 — 絕不混合不可通約的範圍或測試方法。
- 法定證明 — 任何監管/關稅聲明都需要官方公報 ID。
- 科學分類學與註冊驗證 — 必須逐字對照即時的 GBIF/OpenTree/iNaturalist 註冊資料庫,核對雙名法、權威、系統發育與 IUCN 狀態。
- 渲染後的散文校準 (
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):
- 雙面板時間序列 + 速率加速度: 歷史月度/日軌跡,附事件陰影和直接起始/峰值註釋,並搭配十年/週期速率條。
- 堆疊質量平衡區域 + 指數軌跡: 堆疊流量體積,附 直接右邊緣終點標籤(零獨立浮動圖例框!),並搭配
Base = 100結構分歧線。 - 脫鉤象限散點圖 + 啞鈴壓縮: 2D 增長與結果散點圖,附陰影目標象限 + 針對緊密叢集的引導箭頭,並搭配基線到當前水平的水平啞鈴圖。
- Stephen Few 水平子彈圖: 3 個定性背景帶 + 主要效能條 + 垂直琥珀色基線/目標刻度 + 右對齊的變化量文字(使用
ax.spines["bottom"].set_bounds(...)修剪 x 軸脊柱)。 - 記憶體內無頭 Tufte 走勢圖:
46–66 pt × 13–16 pt的微線條,渲染到io.BytesIO()緩衝區,並直接嵌入 ReportLab 表格單元格,帶有語意的翡翠綠/信號紅終點點。 - 起點-終點矩陣熱圖與山脊線 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> 展品 結合使用:
- 深色英雄 / 純白資料極性節奏(禁止單調):
- 封面英雄: 深午夜海軍藍 (
#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冰青色章節進度藥丸。
- 封面英雄: 深午夜海軍藍 (
- 高對比編輯襯線 + 幾何無襯線配對:
- 展示用襯線字體 (
Charter/Georgia/BaskervilleBold): 封面標題、章節數字、投影片動作標題、巨大的54 pt#2251FFKPI 重點提示,以及中心甜甜圈總計。 - 資料無襯線字體 (
Inter/Helvetica Neue): 圖表註釋、副標題、縱橫線單元格、頁尾及啟發文案。
- 展示用襯線字體 (
- 4 階 McKinsey 藍色色調漸層(零彩虹雜亂):
#051C2C午夜海軍藍(錨定總計、基線、深度緊縮) →#06319C深皇家藍 →#2251FF電光藍(焦點差異、巨大 KPI、擴張激增) →#00A9F4鮮豔青色 →#9AE6FF冰青色(次要佔比與章節藥丸)。
- 標誌性向量 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>代替。
- 質量平衡瀑布 / 橋接圖: 錨定條 (
- 全出血編輯攝影雜誌模式 (
612 × 792 ptLetter 縱向,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;來錨定垂直的右邊緣版權資訊。
- 首字放大 (
- 排版與紙張材質: 將暖色調無塗層檔案紙 (