프리플라이트 검사
문서를 내보내기 전에 소스, 빌드 로그, PDF, 참조, 접근성 신호, 제출 위험을 점검합니다.
컴파일에 성공했다는 것은 PDF가 만들어졌다는 사실만 증명합니다. 모든 인용이 해결되었는지, 읽기 순서가 말이 되는지, 제출용 아카이브가 깔끔한지, 파일이 내세우는 접근성 구조를 실제로 갖췄는지는 증명하지 않습니다.
프리플라이트는 이런 질문을 하나의 로컬 검토로 모았습니다. 프로젝트 레일의 방패를 열고 문서에 맞는 검사를 고른 다음, 문제를 고치는 동안에는 검사 하나를, 제출 전에는 전체를 실행하세요.


서로 독립적인 여섯 가지 검사
섹션 제목: “서로 독립적인 여섯 가지 검사”컴파일 및 배치
섹션 제목: “컴파일 및 배치”최신 빌드 로그와 PDF를 읽고 실패한 빌드, 해결되지 않은 인용과 참조, 다시 실행하라는 경고, 누락된 글리프, overfull box, 잘린 텍스트, 중복된 PDF 대상, 섞인 페이지 크기를 찾습니다.
제출 준비 상태
섹션 제목: “제출 준비 상태”선택한 출판 프로필을 프로젝트에 적용합니다. 문서 클래스, 초록과 키워드, 그림 형식, 포함된 글꼴, PDF 제한, 캡션, 이식 가능한 이름, 소스 패키지에 섞인 불필요한 파일처럼 안정적인 요구 사항을 검사합니다.
ATS 준비 상태
섹션 제목: “ATS 준비 상태”지원자 추적 시스템이 하는 것처럼 이력서에서 내용을 추출합니다. 연락처 필드, 기대하는 섹션, 읽기 순서를 뒤섞을 수 있는 배치를 알려 줍니다.
접근성
섹션 제목: “접근성”태그, 대체 텍스트, 언어와 제목 메타데이터, 뷰어 설정, 제목, 표, 링크, 읽기 순서, 선택 가능한 텍스트, 필요한 경우의 북마크, 아주 작은 텍스트와 관련된 소스와 PDF의 신호를 검사합니다.
참조 및 에셋
섹션 제목: “참조 및 에셋”프로젝트 전체를 사용할 수 있을 때 누락된 파일, 해결되지 않은 인용과 상호 참조, 중복된 레이블과 DOI, 불완전한 참고문헌 항목, 인용되지 않은 참고문헌을 찾습니다.
개인정보 및 블라인드 심사
섹션 제목: “개인정보 및 블라인드 심사”자격 증명, 개인 키, 민감한 파일, 초안 메모, 내부 주석, 감사의 글, 저자 필드, 그리고 블라인드 심사를 깰 수 있는 신원 메타데이터를 찾습니다.
Typst 프로젝트
섹션 제목: “Typst 프로젝트”Typst 소스에는 전용 검사가 있습니다. .typ 파일을 직접 읽으므로 LaTeX 규칙이 Typst 구문에 적용되는 일은 없습니다.
- 참조 및 에셋은 일치하는 레이블이나 참고문헌 항목이 없는
@참조와 인용, 중복 레이블, 프로젝트 파일과 맞지 않는 이미지 또는#include경로, 프로젝트에 없는#bibliography파일, 출처를 인용하면서#bibliography를 호출하지 않는 문서를 찾습니다. 인용 키는.bib파일이나 Hayagriva.yml파일에 둘 수 있습니다. - 접근성은 이미지나 그 이미지를 담은 figure에
alt텍스트가 없는 경우, 빈 제목,#set document(title: ...)또는 템플릿으로 제목을 설정하지 않은 문서를 표시합니다. - 제출 준비 상태는 프로젝트가 선택한 프로필에 맞는 템플릿을 가져오는지, 템플릿에 초록과 키워드가 전달되는지,
#lorem텍스트나 자리 표시자, TODO 메모가 남아 있지 않은지 검사합니다. 캡션, 이미지 크기, 파일 이름도 살펴봅니다. - 개인정보 및 블라인드 심사는 템플릿에 전달된 저자 이름, 이메일, 소속, 감사의 글, 로컬 파일 경로를 찾습니다.
각 결과에는 파일과 줄이 표시되고, 자세히 보면 #image("chart.png", alt: "Bar chart of yearly sales") 같은 Typst 수정 방법이 나옵니다.
색상만 보지 말고 확실도를 읽으세요
섹션 제목: “색상만 보지 말고 확실도를 읽으세요”모든 결과에는 Oleafly가 그 결론에 이른 과정이 설명되어 있습니다.
- 검증됨은 앱이 소스, 로그, 프로젝트, PDF에서 직접적인 증거를 관찰했다는 뜻입니다.
- 권고는 문서화된 휴리스틱이 사람이 확인해야 할 무언가를 찾았다는 뜻입니다.
- 수동은 파일만으로는 안전하게 결정할 수 없는 검사를 가리킵니다.
입력이 없다고 통과로 처리되는 일은 없습니다. 소스만 본 결과는 현재 PDF가 생길 때까지 부분 결과로 남습니다.
출판 프로필 선택하기
섹션 제목: “출판 프로필 선택하기”제출처에 가장 잘 맞는 프로필을 일반 출판, arXiv, IEEE, ACM, 저널, 학위논문 중에서 고르세요. 프로필은 자동으로 검사할 만큼 안정적인 요구 사항을 다룹니다. Typst 프로젝트에서는 프로필이 그에 맞는 Typst 템플릿도 요구하며, 결과에 허용하는 템플릿이 표시됩니다.
그런 다음 해당 학회나 저널의 최신 안내를 여세요. 페이지 제한, 여백, 파일 크기 상한, 익명화 규칙, 이름 규칙은 자주 바뀌어서 일반 프로필이 판단할 수 없습니다.
다른 독자가 받는 모습 보기
섹션 제목: “다른 독자가 받는 모습 보기”프리플라이트 패널에서 스크린 리더를 선택하면 PDF 텍스트를 페이지별로 추출해 보여 주는 독자가 보는 내용이 열립니다. 2단 논문이 페이지를 가로질러 읽히는 문제, 아이콘 글꼴로 쓴 전화번호의 누락, 엉뚱한 곳에 놓인 캡션, 선택 가능한 텍스트가 없는 페이지를 잡아낼 때 사용하세요.
이력서에서는 파서가 추출한 내용에 ATS 시뮬레이션이 복원한 이름, 이메일, 전화번호, 링크, 표준 섹션이 표시됩니다.
이 보기는 증거일 뿐이며, 독자가 실제로 쓰는 제출 포털, 화면 낭독기, 파서로 직접 테스트하는 일을 대신하지 않습니다.
PDF/UA와 접근성: 정직한 한계
섹션 제목: “PDF/UA와 접근성: 정직한 한계”Oleafly는 파일에서 읽을 수 있는 PDF/UA-1의 일부를 검사합니다. 결과에는 PDF/UA-1, 다른 경우의 PDF/UA-2, Matterhorn Protocol 체크포인트, WCAG 2.2 PDF 기법이 인용됩니다.
보고서는 다음과 같은 기계가 읽을 수 있는 신호를 다룹니다.
- 실제 콘텐츠가 들어 있는 태그 트리
- 그림과 수식의 대체 텍스트
- 표의 헤더 셀
- 제목 수준의 진행
- 문서 언어와 XMP 제목
- 제목을 표시하는 뷰어 설정
- 링크 설명과 의심스러운 태그되지 않은 콘텐츠
- 선언한 PDF/UA-1 주장을 파일이 뒷받침하는지 여부
패널은 기계가 검사할 수 있는 106개의 PDF/UA-1 규칙 중 몇 개를 확인했는지 알려 줍니다. 규칙을 읽을 수 없었거나 적용되지 않았을 때도 알려 줍니다. 검사하지 않은 규칙은 통과로 세지 않습니다.
LaTeX에서 태그된 PDF 준비하기
섹션 제목: “LaTeX에서 태그된 PDF 준비하기”LaTeX 태그 처리는 문서 클래스, 패키지, 엔진, TeX Live 버전에 따라 달라집니다. 프리플라이트는 준비를 제안하기 전에 실제로 적용되는 메인 문서와 그 문서가 불러오는 프리앰블 파일을 검사합니다.
- 현재 PDF에서 접근성을 실행하고 결과를 읽습니다.
- 접근 가능한 내보내기를 엽니다.
- 클래스와 패키지 호환성 보고서를 확인합니다. 호환되지 않는 클래스는 준비를 막고, 일부만 호환되거나 알 수 없는 패키지는 경고로 표시됩니다.
- 접근 가능한 내보내기 준비를 선택하고 제안된 소스 변경을 모두 검토합니다.
- 생성된 대체 텍스트 자리 표시자를 각각 의미 있는 설명으로 바꾸고, 요청이 있으면 문서 제목을 추가합니다.
- TeX Live 2026의 pdfLaTeX 또는 LuaLaTeX, 또는 2025년 11월 이후에 업데이트한 TeX Live로 컴파일합니다. 접근 가능한 수식에는 LuaLaTeX가 필요합니다.
- 접근성을 다시 실행하고 리더 보기를 확인합니다. 적합성이 중요하다면 Oleafly 밖에서 최종 PDF를 검증합니다.
준비 과정에서 언어, PDF/UA-2 의도, 태그 처리를 지정한 \DocumentMetadata를 추가하거나 갱신할 수 있고, 첫 표 헤더 행을 선언하고, 누락된 그림 대체 텍스트에 눈에 보이는 자리 표시자를 추가하고, 선택한 엔진에 필요하면 unicode-math를 추가합니다. 변경 사항은 적용하기 전에 보여 줍니다.
\DocumentMetadata 줄은 버전 검사 안에 들어갑니다. 번들 엔진처럼 2025년 11월보다 오래된 LaTeX는 이 줄을 건너뛰고, 실패하는 대신 태그 없이 문서를 빌드하며, 그 PDF는 PDF/UA를 표방하지 않습니다. 그러면 프리플라이트가 이 LaTeX는 너무 오래되어 태그 처리를 건너뛰었습니다를 보고하고 빌드에 쓰인 LaTeX를 알려 줍니다.
번들된 Tectonic 엔진은 태그 트리를 만들 수 없습니다. 태그를 켜고 컴파일해 확인은 사용 가능한 시스템 TeX 배포판이나 Oleafly가 관리하는 TinyTeX를 사용하며, Tectonic 프로젝트에서도 항상 LuaLaTeX를 실행합니다. 태그된 컴파일이 TinyTeX의 tagpdf-base.sty 같은 없는 파일 때문에 멈추면 일반 컴파일처럼 그 파일을 설치하겠다고 제안하고, 설치한 뒤 태그된 컴파일을 다시 실행합니다. 준비된 소스를 직접 갖춘 최신 도구 체인으로 컴파일할 수도 있습니다.
TinyTeX, 패키지 상태, 시스템 TeX를 둘러싼 보안 경계는 LaTeX 엔진과 패키지를 참고하세요.
Typst의 PDF 표준
섹션 제목: “Typst의 PDF 표준”Typst 프로젝트에는 준비할 소스가 없습니다. Typst가 보관용 PDF와 접근 가능한 PDF를 직접 작성하므로, 접근성 검사에는 접근 가능한 내보내기 대신 PDF 표준이 표시됩니다.
- 접근성을 실행하고, 누락된 대체 텍스트와 문서 제목을 고칩니다. PDF/UA-1에는 둘 다 필요합니다.
- PDF 표준에서 PDF/UA-1이나 PDF/A-2b 같은 표준을 고릅니다.
- PDF 내보내기를 선택하고 파일을 저장합니다.
- 적합성이 중요하다면 Oleafly 밖에서 내보낸 PDF를 검증합니다.
Typst 0.14 이상은 모든 PDF에 태그를 붙이므로 태그된 컴파일을 따로 하지 않습니다. 이전 버전은 지원하는 표준이 더 적고 Typst 0.11은 지원하는 표준이 없으며, 해당하는 내용은 패널에 표시됩니다. 더 새로운 버전을 쓰려면 컴파일 메뉴에서 Typst 버전(이 프로젝트) 항목을 바꾸세요. Typst 프로젝트를 참고하세요.
실전 최종 점검
섹션 제목: “실전 최종 점검”- 제출하려는 바로 그 소스를 컴파일합니다.
- 관련된 프리플라이트 검사를 모두 실행합니다.
- 검증된 결과는 고치고, 권고 사항은 조사합니다.
- 모든 수동 항목을 해당 학회나 저널의 최신 안내에 맞춰 완료합니다.
- 참고문헌과 부록을 포함해 최종 PDF를 첫 페이지부터 마지막 페이지까지 읽습니다.
- 내보낸 파일과 소스 아카이브를 저장된 위치에서 열어 봅니다.
- 마감 전에 제출처 자체의 검증 도구를 사용합니다.
프리플라이트는 피할 수 있는 뜻밖의 문제를 줄여 줍니다. 논문의 채택, 접근성, 과학적 정확성은 여전히 저자, 학회나 저널, 그리고 문서를 사용할 사람들의 몫입니다.