Communitygithub.com

premium-pdf-design

기관 수준의 PDF 프레젠테이션(16:9 다크 임원용 데크) 및 보고서(레터 라이트 스위스 아이보리) 디자인 시스템입니다. 검증 가능한 오픈 데이터 파이프라인, 60-30-10 색상 균형, 헤어라인 투페트 원장, 민토 피라미드 액션 타이틀, 300 DPI 벡터 데이터 시각화, 안전한 Inter 글꼴 등록, 전체 블리드 캔버스 페인팅, 자동화된 PyMuPDF 시각 QA 감사를 적용합니다.

premium-pdf-design란 무엇인가요?

이 스킬은 맥킨지, 스트라이프 프레스, 세계경제포럼, 이코노미스트 스타일의 기관 수준 PDF 프레젠테이션 및 보고서를 제작하기 위한 포괄적인 디자인 시스템입니다. 16:9 다크 임원용 슬라이드 데크와 레터 라이트 스위스 아이보리 기관 보고서를 모두 지원하며, 검증 가능한 오픈 데이터 파이프라인(verifiable-pdf-pipeline)과 편집 페이지 레이아웃 가이드라인(editorial-page-layout-guidelines)과 연동됩니다. 4가지 황금 디자인 법칙(60-30-10 색상 계층 구조, 헤어라인 및 여백 중력, 민토 피라미드 액션 타이틀, 보정된 수직 채우기 예산)을 통해 데이터 무결성과 시각적 품질을 보장합니다. ReportLab과 WeasyPrint를 모두 지원하며, 300 DPI 투명 차트, 안전한 Inter 글꼴 등록, 전체 블리드 캔버스 페인팅, PyMuPDF 기반 자동 시각 QA 감사 기능을 제공합니다. 특히 2023 컨설팅 플래그십 모드는 순수 벡터 인라인 SVG를 활용한 고급 편집 디자인을 지원합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gke0op/verifiable-editorial-skills/tree/HEAD/skills/premium-pdf-design

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

검증 가능한 기관 PDF 프레젠테이션 및 데이터 시각화 시스템

이 스킬은 verifiable-pdf-pipeline(데이터 무결성) 및 editorial-page-layout-guidelines(그리드 지오메트리)와 함께 사용되어 맥킨지, 스트라이프 프레스, 세계경제포럼, 이코노미스트 스타일의 16:9 다크 임원용 슬라이드 데크 및 레터 라이트 스위스 아이보리 기관 보고서를 제작합니다.


1. 핵심 불변 규칙: 미학보다 내용이 우선이다

이 스킬로 제작되는 모든 프레젠테이션 및 보고서는 verifiable-pdf-pipeline/SKILL.md에 정의된 10가지 안티치트 하드 규칙을 준수해야 합니다:

  1. 제로 수기 데이터 에어갭 — data/raw/ 폴더의 변경 불가능한 원시 파일에서 모든 숫자를 구문 분석합니다.
  2. 현실 및 불변 컴파일러 — Pydantic 도메인 경계 및 회계 항등식을 적용합니다.
  3. 비순환 검증 — 독립적인 원시 파일 재계산 + 하드코딩된 리터럴 어설션을 금지하는 Python AST 검사를 수행합니다.
  4. 원자적 출처 원장 — 게시된 모든 스칼라는 data/provenance_ledger.json에 1:1로 매핑됩니다.
  5. 네거티브 역량 및 신성한 'N/A' — 진정한 상류 널값은 가짜 프록시 대신 [N/A]로 명시적으로 렌더링됩니다.
  6. 컴파일 래치 — PDF 컴파일러는 verify_integrity.py를 호출하며 0이 아닌 종료 코드가 반환되면 중단됩니다.
  7. 범주 및 단위 가드 — 측정할 수 없는 범위나 테스트 방법을 절대 혼합하지 않습니다.
  8. 법정 증명 — 규제/관세 주장에는 공식 관보 ID가 필요합니다.
  9. 과학적 분류 및 레지스트리 검증 — 이명법, 권위자, 계통, IUCN 상태를 라이브 GBIF/OpenTree/iNaturalist 레지스트리와 대조하여 정확히 일치시킵니다.
  10. 렌더링 후 산문 접지 (vedit prose) — 최종 PDF의 모든 렌더링된 숫자는 provenance_ledger.json, summary_metrics.json, 또는 background_citations.json의 DOI 지원 항목으로 추적됩니다.

2. 4가지 황금 디자인 법칙

법칙 1: 60-30-10 색상 계층 구조 (라이트 및 다크 모드)

  • 라이트 스위스 편집 모드 (레터 보고서):
    • 60% 캔버스: 스위스 웜 아이보리 (#fcfbf9) — onPage를 통해 명시적으로 페인팅됩니다.
    • 30% 스캐폴딩: 딥 네이비 (#0f2b48), 슬레이트 (#334155), 스틸 (#64748b), 헤어라인 (#cbd5e1), 서브틀 틴트 (#f1f5f9).
    • 10% 시그널 악센트: 코발트 (#0284c7), 앰버 (#d97706), 에메랄드 (#059669), 시그널 크림슨 (#dc2626 — 위험/급증 시에만).
  • 다크 임원 모드 (16:9 슬라이드 데크):
    • 60% 캔버스: 딥 옵시디언 (#0b0f19) 또는 미드나잇 네이비 (#051c2c) — 반드시 onFirstPage/onLaterPages에서 플로어블이 렌더링되기 전에 전체 블리드로 페인팅해야 하며, 기본 흰색 PDF 용지에 의존하지 않아야 합니다!
    • 30% 스캐폴딩 및 고대비 텍스트: 서브틀 토널 밴드 (#111827 / #0a253a), 헤어라인 (#243247), 순수 흰색 제목 (#ffffff), 선명한 라이트 본문 (>= #e2e8f0, >= 9.5–10 pt), 보조 캡션 (>= #cbd5e1, 다크에서는 절대 #64748b–#94a3b8 산문을 사용하지 않음). 파라메트릭 와이어프레임 웨이브나 밝은 아트워크가 텍스트 근처에 있을 때는 항상 커버 타이포그래피 뒤에 미묘한 수평 다크 스크림을 배치합니다.
    • 10% 시그널 악센트: 일렉트릭 코발트 (#38bdf8), 브라이트 앰버 (#fbbf24), 에메랄드 (#34d399), 시그널 크림슨 (#f87171).

법칙 2: 헤어라인 및 여백 중력 (제로 박스형 카드)

  • 지표나 산문을 무거운 직사각형 BOX 윤곽선이나 INNERGRID 웹 대시보드 상자 안에 가두지 마십시오.
  • KPI 및 콜아웃은 테두리 없는 토널 밴드(다크 #111827 / 라이트 #f1f5f9)를 사용하여 그룹화하고, 선명한 1.2 pt 상단 악센트 헤어라인, 넉넉한 12–16 pt 열 여백, 투페트 스타일의 세로선 없는 원장(북탭스 스타일)으로 장식합니다.

법칙 3: 민토 피라미드 액션 타이틀

모든 슬라이드 또는 보고서 섹션은 수동적인 주제 레이블이 아닌 하나의 완전하고 단호한 주장으로 시작합니다:

  • 금지: "글로벌 배출량 동향"
  • 필수: "OECD-5 국가 배출량 -25.0% 감소, 그러나 신흥 3개국 +235.8% 급증하여 패널 총계 23.52 Gt CO2e로 상승."

법칙 4: 보정된 수직 채우기 예산 + 시각적 검사

  • 레터 보고서 (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 vs light)로 렌더링합니다:

  1. 듀얼 패널 시계열 + 비율 가속도: 히스토리컬 월별/일별 궤적에 이벤트 음영과 직접 시작/피크 주석을 추가하고, 10년/기간 비율 막대와 쌍을 이룹니다.
  2. 스택 질량 균형 영역 + 인덱스 궤적: 스택 플로우 볼륨에 직접 오른쪽 가장자리 터미널 레이블(별도 부동 범례 상자 없음!)을 추가하고 Base = 100 구조적 발산선과 쌍을 이룹니다.
  3. 디커플링 사분면 산점도 + 덤벨 압축: 2D 성장 대 결과 산점도에 음영 처리된 목표 사분면 + 밀집 클러스터용 리더 화살표를 추가하고, 기준선 대 현재 수평 덤벨과 쌍을 이룹니다.
  4. 스티븐 퓨 수평 불릿 그래프: 3개 질적 배경 밴드 + 기본 성능 막대 + 수직 앰버 기준선/목표 눈금 + 오른쪽 정렬 델타 텍스트(ax.spines["bottom"].set_bounds(...)를 사용하여 x축 스파인을 자릅니다).
  5. 인메모리 헤드리스 투페트 스파크라인: 46–66 pt × 13–16 pt 마이크로 라인을 io.BytesIO() 버퍼로 렌더링하고 시맨틱 에메랄드/크림슨 터미널 도트와 함께 ReportLab 테이블 셀에 직접 삽입합니다.
  6. 기원-목적지 매트릭스 히트맵 및 능선 KDE: 순차적 팔레트와 대비 전환 듀얼 타이포그래피 또는 $P_{50}$ 및 $P_{90}$을 표시하는 겹치는 분포 능선을 사용합니다.

4. 프로덕션 ReportLab 구현 패턴

4.1 전체 블리드 캔버스 페인팅 (다크 및 아이보리 테마에 중요)

모든 페이지의 플로어블 아래에 캔버스 배경이 페인팅되도록 항상 onPage 콜백을 등록하십시오:

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 2패스 실행 헤더 및 동적 페이지 번호 매기기

showPage()에서 페이지 상태 딕셔너리를 저장하고 save()에서 "Page X of Y" 또는 "Slide X / Y"를 스탬핑하는 reportlab.pdfgen.canvas.Canvas의 서브클래스를 사용하십시오(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계층 맥킨지 블루 크로매틱 램프 (무지개 혼란 제로):
    • #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 가드레일: 플렉스 컨테이너 내에서 항상 인라인 <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 레터 포트레이트, WeasyPrint): 사진 중심의 편집 잡지(Kinfolk × Cereal × Condé Nast Traveler × National Geographic 스타일, demos/felis-mundi-magazine/에 설명됨)를 제작할 때:
    • 타이포그래피 및 용지 재질: 따뜻한 무광택 아카이브 용지(#FAF8F5)와 진한 카본 차콜 잉크(#161616), 고대비 디도네 디스플레이 세리프(Didot / Bodoni 72), 따뜻한 북 세리프 본문 카피(Charter / Baskerville, 9 pt, 1.5× 행간), 넓은 자간 대문자 산스 메타데이터(Inter, 6.5–7 pt, +0.18em 자간)를 페어링합니다. 실행 folio 및 크레딧을 전체 블리드 사진 위에서 순수 #FFFFFF로 매끄럽게 전환합니다.
    • 일관된 사진 (>= 50% 가장자리 간 블리드): 잠긴 마스터 사진 필름 아이덴티티 코어 아래에서 모든 플레이트를 생성하고(references/image_generation_recipes.md §5 참조), 인접 페이지에 걸쳐 스프레드 아키텍처를 다양화하며(100% 커버 → 61% 상단 블리드 → 65% 오른쪽 세로 열 → 100% 포토 에세이 → 76% 4 pt 흰색 인쇄 여백이 있는 2면화 → 68% 하단 블리드 → 77% 연락처 시트 3면화 → 100% 마감 황혼 콜로폰), AI 사진을 SHA-256 플레이트 매니페스트와 함께 투명하게 크레딧합니다.
    • WeasyPrint 매거진 가드레일 (경험적으로 검증됨):
      • 드롭 캡 (float: left): WeasyPrint 67.0의 CSS Grid 또는 Flexbox 항목 내에 float: left 드롭 캡을 절대 배치하지 마십시오(텍스트 열이 축소되거나 드롭 캡이 잘못 오프셋/충돌합니다). 분할 잡지 페이지의 경우 position: absolute 블록 열(display: block)을 사용하여 드롭 캡이 깔끔한 여러 줄 줄바꿈과 함께 100% 왼쪽 정렬되도록 하십시오.
      • 매끄러운 그라데이션 스크림: WeasyPrint에서 밝은 하늘이나 눈 위에 부분 높이 linear-gradient 오버레이 상자를 절대 배치하지 마십시오(Cairo가 상자 가장자리를 따라 희미한 1px 헤어라인 이음을 페인트합니다). 항상 모든 스크림 오버레이의 크기를 사진 컨테이너의 100%로 조정하고 투명 정지점 내에서 rgba(..., 0)으로 페이드아웃하십시오.
      • 회전된 여백 크레딧: 세로 오른쪽 가장자리 크레딧을 top: 18pt; right: 16pt; transform-origin: 100% 0%; transform: rotate(90deg); white-space: nowrap;으로 고정하고, WeasyPrint 67.0의 알려진 변환 버그를 방지하기 위해 절대 위치 지정된 상위 컨테이너(position: relative)를 사용하십시오.

Individual skills in this repo

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

관련 스킬