PDF 스킬
사용 시기
- 레이아웃과 시각적 요소가 중요한 PDF 콘텐츠를 읽거나 검토할 때
- 신뢰할 수 있는 형식으로 PDF를 프로그래밍 방식으로 생성할 때
- 전달 전 최종 렌더링을 확인할 때
워크플로
- 시각적 검토 선호: PDF 페이지를 PNG로 렌더링하여 검사합니다.
pdftoppm을 사용 가능하다면 사용합니다.- 사용할 수 없는 경우 Poppler를 설치하거나 사용자에게 로컬에서 출력을 검토하도록 요청합니다.
- 새 문서를 생성할 때는
reportlab을 사용하여 PDF를 생성합니다. - 텍스트 추출 및 빠른 확인에는
pdfplumber(또는pypdf)를 사용합니다. 레이아웃 정확성을 위해 의존하지 마십시오. - 의미 있는 업데이트 후에는 페이지를 다시 렌더링하고 정렬, 간격 및 가독성을 확인합니다.
임시 및 출력 파일 규칙
- 중간 파일은
tmp/pdfs/를 사용하고, 완료되면 삭제합니다. - 이 저장소에서 작업할 때는 최종 결과물을
output/pdf/아래에 작성합니다. - 파일 이름은 안정적이고 설명적으로 유지합니다.
종속성 (누락 시 설치)
종속성 관리는 uv를 선호합니다.
Python 패키지:
uv pip install reportlab pdfplumber pypdf
uv를 사용할 수 없는 경우:
python3 -m pip install reportlab pdfplumber pypdf
시스템 도구 (렌더링용):
# macOS (Homebrew)
brew install poppler
# Ubuntu/Debian
sudo apt-get install -y poppler-utils
이 환경에서 설치가 불가능한 경우, 누락된 종속성이 무엇인지와 로컬에서 설치하는 방법을 사용자에게 알려주십시오.
환경
필요한 환경 변수가 없습니다.
렌더링 명령어
pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX
품질 기대 사항
- 세련된 시각적 디자인 유지: 일관된 타이포그래피, 간격, 여백 및 섹션 계층 구조.
- 렌더링 문제 방지: 잘린 텍스트, 겹치는 요소, 깨진 표, 검은 사각형 또는 읽을 수 없는 글리프.
- 차트, 표 및 이미지는 선명하고 정렬되어 있으며 명확하게 레이블이 지정되어야 합니다.
- ASCII 하이픈만 사용하십시오. U+2011(줄 바꿈 없는 하이픈) 및 기타 유니코드 대시를 피하십시오.
- 인용 및 참조는 사람이 읽을 수 있어야 합니다. 도구 토큰 또는 플레이스홀더 문자열을 남기지 마십시오.
최종 확인
- 최신 PNG 검사에서 시각적 또는 형식 결함이 0개임을 확인할 때까지 전달하지 마십시오.
- 머리글/바닥글, 페이지 번호 및 섹션 전환이 정돈되어 있는지 확인합니다.
- 중간 파일을 정리하거나 최종 승인 후 제거합니다.