PDF Toolkit에 PDF 2.0 변환 기능을 붙였다
PDF Header, Catalog Version, XMP PDF/UA 정보를 함께 맞추는 변환 기능 개발 기록
2026-02-20

PDF 버전 변경
PDF Toolkit에 PDF 2.0 변환 기능을 추가했다.
PDF 접근성 작업을 하다 보면 구조 태그만 보는 것으로는 부족하다. PDF Header, Catalog /Version, XMP 메타데이터, PDF/UA 관련 식별자까지 같이 확인해야 하는 경우가 있다.
처음에는 PDF 버전을 올린다고 하면 파일 헤더만 바꾸면 될 것처럼 보인다.
%PDF-2.0
하지만 실제로는 Catalog의 /Version과 XMP 메타데이터도 같이 봐야 한다. PDF/UA 관련 필드도 함께 맞춰야 검수 흐름에서 혼선이 줄어든다.
PDF_VERSION_TARGET = "2.0" PDFUAID_PART_TARGET = "2" PDFUAID_REV_TARGET = "2024"
PDF Toolkit에서는 이 값들을 기준으로 현재 문서 상태를 확인하고, 필요한 경우 보정하도록 했다.
별도 작업 화면으로 분리
이 기능은 일반 PDF 뷰어 화면 안에 억지로 넣기보다, 별도 작업 화면으로 분리했다. 사용자는 PDF를 선택하고 실행하면 된다.
PDF 2.0 변환은 자주 누르는 버튼이라기보다, 필요할 때 명확하게 실행하는 배치 작업에 가깝다. 그래서 일반 확인 탭이 아니라 변환 메뉴 쪽에 두는 것이 더 자연스러웠다.
변환 기능만 있으면 충분하지 않다. 변환 후 실제 값이 어떻게 들어갔는지 바로 확인할 수 있어야 한다.
메타데이터 패널에서는 PDF Header, Catalog /Version, XMP pdfuaid:part, pdfuaid:rev 값을 함께 보여주도록 했다.
self._set_metadata_value( "pdf20_header_check", self._format_pdf20_check(header_version, upgrade_pdf_version.PDF_VERSION_TARGET), )
검증 결과는 단순 값이 아니라 통과 여부까지 같이 표시한다.
회고
단순히 태그 구조만 보는 도구가 아니라, 문서의 메타데이터와 규격 정보를 함께 다루는 도구로 확장시키고있다. 이 외에도 자잘자잘한거 많이 고쳤다.. QA 시트 만들어서 부서원들 의견도 계속 받고있다.. 제발 사소한거 하나라도 전부 말해주세요.. 다 만들어드릴테니..