Typst 0.14: 이제 접근성 지원 – Typst 블로그

1 week ago 9

  • 문서 조판 도구 Typst 0.14 버전이 출시되어, 접근성 기본 지원, PDF 이미지 처리, 문자 단위 정렬 등 주요 기능을 포함
  • 이번 버전은 PDF/UA-1 표준 지원을 통해 접근성 규제 준수를 돕고, PDF를 이미지로 직접 삽입할 수 있는 기능을 추가
  • 문자 단위 정렬(character-level justification) 기능으로 시각적으로 균형 잡힌 문단 조판을 구현
  • HTML 내보내기 기능이 강화되어, 각종 문서 요소를 의미론적 HTML로 변환하고, 타입이 지정된 HTML API도 도입
  • 이번 업데이트는 산업 현장에서의 자동화 문서 생성과 접근성 규제 대응을 강화하며, Typst의 실무 적용 범위를 크게 확장

Typst 0.14 개요

  • Typst는 학계에서 출발했으나, 최근 산업 현장에서도 수동 문서 작성, 자동 보고서, 대량 PDF 생성 파이프라인 등으로 확장
    • 이번 0.14 버전은 이러한 산업적 활용을 위한 핵심 기능을 대거 포함
  • 접근성, PDF 표준, 문자 단위 정렬, HTML 내보내기 등 생산 환경 중심의 기능 개선이 이루어짐
  • 웹 앱과 CLI 모두에서 손쉽게 업데이트 가능하며, 새 버전으로의 마이그레이션 가이드도 제공

접근성(Accessibility)

  • Typst 0.14는 기본적으로 접근성 태그(tagged PDF) 를 자동 생성하여, 스크린 리더 등 보조 기술(Assistive Technology)이 문서 구조를 인식 가능
    • 내장 마크업과 요소를 사용하면 자동으로 적절한 태그가 지정됨
  • 새롭게 추가된 alt 매개변수를 통해 도형이나 그림의 대체 설명(alt text) 을 제공 가능
    • 예시 코드에서는 두 개의 사각형과 화살표로 구성된 다이어그램에 대체 설명을 추가해, 시각 장애 사용자도 동일한 정보를 인식할 수 있게 함
  • PDF/UA-1 내보내기 기능을 통해 문서 접근성 검증을 자동화
    • 문서 제목 누락, 잘못된 제목 계층, 대체 설명 누락 등 문제를 탐지
  • PDF/UA-1은 EU의 European Accessibility Act(EAA)미국 ADA Title II 등 국제 접근성 규제 준수를 지원
    • EU는 2025년 6월 28일부터, 미국은 2026년 4월 24일부터 적용 예정
    • 고객 또는 정부 대상 문서를 다루는 기업은 Typst 0.14 도입이 권장됨

PDF 표준 지원 확대

  • 기존 PDF 1.7만 지원하던 것을 PDF 1.4~2.0 버전까지 선택 가능
  • PDF/A 표준도 기존 두 하위 표준에서 모든 4개 파트와 적합성 레벨을 지원하도록 확장
  • 특정 표준 선택을 통해 문서의 호환성·보존성·규제 대응성을 최적화 가능
  • 관련 세부 내용은 Typst 문서의 PDF 표준 참조 섹션에서 확인 가능

PDF를 이미지로 사용

  • Typst 0.14는 PDF를 네이티브 이미지 형식으로 지원
    • PDF 내보내기 시에는 그대로 포함되고, HTML/SVG 내보내기 시에는 SVG로 변환, PNG나 웹 미리보기에서는 래스터화 처리
  • 모든 변환 과정은 Typst 컴파일러 내부에서 수행, 외부 시스템 의존성 없음
  • 이 기능은 Rust로 작성된 새로운 PDF 처리 라이브러리 hayro 덕분에 구현
    • hayro는 Typst 커뮤니티 기여자 @LaurenzV가 개발한 완전 Rust 기반 라이브러리로, 높은 이식성과 성능을 제공

문자 단위 정렬(Character-level Justification)

  • 문단의 시각적 균형을 위해 단어 간격뿐 아니라 문자 간격까지 조정하는 기능 도입
    • 기존 대부분의 소프트웨어는 단어 간격만 조정하지만, Typst는 문자 간격까지 세밀하게 제어
  • 향후에는 가변 폰트(variable fonts) 를 활용한 글자 폭 조정이나, 아랍어의 Kashida 삽입 등도 탐구 예정
  • Typst는 LaTeX와 동일한 기본 알고리듬을 사용하지만, LaTeX에는 없는 문자 단위 정렬 기능을 추가
    • 과도한 사용은 부자연스러울 수 있으나, 적절한 한계값과 알고리듬 조합으로 미세한 조판 품질 향상 가능
  • 결과적으로 보다 균형 잡힌 문단 회색도(grayness) 를 구현, 전문 출판 수준의 조판 품질 제공

향상된 HTML 내보내기

  • Typst 0.13에서 실험적으로 도입된 HTML 내보내기를 0.14에서 대폭 개선
    • 각종 내장 요소(각주, 개요, 인용 등)에 대한 의미론적 HTML 매핑(show rules) 추가
  • 텍스트 처리 개선으로 모델 계층(Model category) 의 대부분 요소가 올바른 HTML로 변환
  • 새롭게 Typed HTML 인터페이스 도입
    • #html.video(autoplay: true, width: 1280, …)처럼 타입 안전한 속성 지정 가능
    • 기존의 문자열 기반 html.elem 방식보다 안전하고 직관적
  • HTML 내보내기는 여전히 실험적 기능으로, CLI에서는 --features html 옵션 또는 환경 변수 TYPST_FEATURES=html로 활성화
    • 웹 앱에서도 프로젝트별로 개별 활성화 필요
  • 향후 Typst 웹 앱에서도 HTML 내보내기 기능 정식 지원 예정

Typst 0.14로의 마이그레이션

  • 이번 릴리스는 호환성 파괴 변경이 거의 없는 안정적 업데이트
    • 일부 검증이 강화되어, 라벨·링크 URL·폰트 목록이 비어 있을 수 없음
  • 주요 변경 사항
    • pdf.embed → pdf.attach로 대체
    • 두 가지 참고문헌 스타일 이름 변경
    • CLI의 --make-deps 플래그가 --deps --deps-format make로 대체
    • 일부 심볼(symbols) 사용 중단, 컴파일러가 자동 경고 표시
  • 웹 앱에서는 버전 업그레이드 경험 개선
    • 이전에는 항상 최신 버전을 사용했으나, 이제는 새 버전 감지 시 자동 업그레이드 제안 및 호환성 검사 수행
    • 새 버전으로 컴파일 후 오류·경고를 비교해 결과를 표시

커뮤니티 및 향후 계획

  • Typst 0.14는 8개월간의 개발 및 커뮤니티 협업 결과물
  • 출시 기념으로 11월 7일 Discord 커뮤니티 콜 개최 예정
    • 사용자 경험 공유 및 피드백 수집 목적
  • Typst 팀은 향후 HTML 내보내기 완성도 향상, 접근성 강화, 조판 품질 개선을 지속 추진 예정

Read Entire Article