← Docs hub

PDF Export Guide

이 문서는 LLM 운영 PDF를 만들 때 문서 구조와 그림 경계가 깨지지 않도록 확인하는 기준입니다.

1. 권장 PDF 구성 순서

PDF는 아래 순서로 묶는 것을 권장합니다.

2. PDF-safe SVG 사용 기준

PDF 본문에는 아래 그림을 우선 사용합니다.

기존 svg/architecture/ 아래 일부 그림은 원본 분석용으로 유지합니다. PDF 본문에는 폭이 작은 svg/pdf-safe/ 또는 svg/day-sections/ 그림을 우선 배치합니다.

소스레벨 부록과 템플릿 부록은 svg/source-sections/ 그림을 사용합니다. 이 그림은 모두 1120x420 크기로 생성되어 PDF 본문에서 잘림 위험이 낮습니다.

3. 경계 잘림 방지 기준

1. SVG width가 1500px을 넘는 그림은 PDF 본문에 직접 넣지 않는다.
2. 한 페이지에 큰 SVG 2개 이상을 연속 배치하지 않는다.
3. 긴 표는 핵심 요약표를 먼저 두고, 상세 표는 부록에 둔다.
4. 코드 블록은 80~100자 기준으로 줄바꿈된 예시를 사용한다.
5. H2 챕터마다 최소 1개 그림을 두되, 같은 관점의 그림이 반복되면 요약 SVG를 사용한다.
6. Source-level/templates 문서도 H2마다 `svg/source-sections/` 요약 그림이 있는지 확인한다.
7. PDF 출력 전 HTML에서 이미지가 본문 영역 밖으로 넘치지 않는지 확인한다.

4. 출력 전 검증 명령

/home/silogood/.local/bin/llmwiki build
/home/silogood/.local/bin/llmwiki lint

링크 검사는 LLM 운영 산출물 기준으로 수행합니다.

python3 - <<'PY'
from pathlib import Path
import html
import re

root = Path(
    "/home/silogood/.local/share/llm-wiki-pratiyush/site/docs/sk-intellix/vendor-llm-training"
)
pattern = re.compile(r'(?:href|src)="([^"]+)"')
missing = []

for page in root.rglob("*.html"):
    text = page.read_text(errors="ignore")
    for match in pattern.finditer(text):
        url = html.unescape(match.group(1))
        if url.startswith(("http://", "https://", "mailto:", "#", "/", "javascript:")):
            continue
        target = url.split("#", 1)[0]
        if target and not (page.parent / target).resolve().exists():
            missing.append((str(page.relative_to(root)), url))

print("missing", len(missing))
print(missing[:20])
PY

5. PDF에 반드시 포함할 핵심 표

6. PDF 품질 게이트

PDF를 만들기 전에는 아래 게이트를 순서대로 통과해야 합니다. 이 표는 “문서가 길다”는 문제보다 “출력 후 잘리거나, 링크가 깨지거나, 운영자가 근거 없이 판단하게 되는 문제”를 막기 위한 기준입니다.

7. 출력 후 확인

PDF 파일을 만든 뒤에는 아래 페이지를 우선 확인합니다.