참조
한눈에 보기
섹션 제목: “한눈에 보기”참조 자료는 구체적인 질문에 답하는 문서입니다. 심볼, 값, 지원 수준, 관련 절을 확인하는 데 사용합니다. 이 탭에는 NextPDF가 검증한 범위인 모듈 참조, 지원 매트릭스, API 표면, 오류 참조, 표준 적합성, 프로젝트 공개 정책이 담겨 있습니다. 목표에 도달하는 방법은 여기서 설명하지 않습니다. 그 내용은 가이드 또는 쿡북을 참고하세요.
참조 지도
섹션 제목: “참조 지도”코어 엔진
섹션 제목: “코어 엔진”nextpdf/core 엔진을 모듈별로 문서화합니다.
| 페이지 | 용도 |
|---|---|
| 코어 엔진 참조 | 네임스페이스 지도: 모든 모듈 페이지와 네 개의 하위 계열. |
| Contracts: 41개의 공개 인터페이스(SPI) | 안정성 추적 대상인 공개 인터페이스와 열거형. |
| Core: Document 파사드 + 관심사 트레이트 | Document 파사드와 Has* 트레이트 계열. |
| HTML: HTML+CSS를 PDF로 렌더링하는 서브시스템 | 단일 패스 스트리밍 HTML 렌더러. |
| 보안: 암호화, 암호화 정책 및 서명 표면 | 암호화, 권한, 서명 통합 지점. |
렌더링 지원
섹션 제목: “렌더링 지원”렌더러가 무엇을 검증하고, 무엇을 지원한다고 명시하며, 무엇을 부분적으로 지원하거나 지원하지 않는지 정리합니다.
| 페이지 | 용도 |
|---|---|
| CSS 지원 매트릭스 | HTML 파이프라인에서 기능별 CSS(Cascading Style Sheets) 지원 수준. |
| 지원되지 않는 CSS 기능 및 우회 방법 | 범위를 벗어나는 항목과 대신 취해야 할 조치. |
| 글꼴 및 문자 체계 지원 매트릭스 | 글꼴 기술과 문자 체계 지원 범위. |
| CJK 세로 쓰기 지원 | 중국어, 일본어, 한국어 텍스트를 위한 세로 쓰기 모드 지원. |
| 복합 스크립트 셰이핑 지원 | 셰이핑이 필요한 문자 체계 지원. |
API 표면
섹션 제목: “API 표면”정확한 심볼, 허용되는 값, 서비스 계약을 정리합니다.
| 페이지 | 용도 |
|---|---|
| 열거형 레퍼런스 | 모든 공개 열거형과 허용되는 값. |
| TSA 구성 | 기본 타임스탬프 기관(TSA)과 변경 방법. |
| Connect REST API 참조 | OpenAPI 3.1 문서에서 추출한 NextPDF Connect의 REST 엔드포인트. |
| Connect API 탐색기 | 동일한 계약을 살펴보는 대화형 탐색기. |
패키지 수준의 API(Application Programming Interface) 참조는 각 패키지에서 제공합니다. 가이드 탭에서는 NextPDF Connect API 레퍼런스, 통합 API 색인, Python SDK API 레퍼런스가 여기에 해당합니다.
오류 참조
섹션 제목: “오류 참조”엔진이 발생시키는 모든 예외를 도메인별로 정리하고, 구조화된 컨텍스트와 복구 지침을 함께 제공합니다.
| 페이지 | 용도 |
|---|---|
| 오류 참조 | 예외 모델: NextPdfException 베이스와 컨텍스트 계약. |
| core 및 일반 오류 | Document 수명 주기와 일반 엔진 실패. |
| 렌더링 및 I/O 오류 | HTML, 글꼴, 라이터, 리더 관련 실패. |
| 보안 및 서명 오류 | 암호화, 서명, PKI 실패. |
| 런타임 및 지원 오류 | HTTP, 회복탄력성, 관측성 관련 실패. |
| Accelerator 오류 | 선택적 가속 사이드카의 실패. |
| 적합성 오류 | 유효성 검사 및 적합성 도구 실패. |
표준 적합성
섹션 제목: “표준 적합성”NextPDF Core가 목표로 하는 표준 프로파일과 각 프로파일의 경계를 명시합니다. 엔진은 적합성을 목표로 하는 출력을 생성하며, 적합 여부는 외부 검증기가 판정합니다.
| 페이지 | 용도 |
|---|---|
| 표준 적합성 | 적합성 태세와 프로파일 색인. |
| PDF 2.0 적합성 | 엔진이 목표로 하는 ISO 32000-2 베이스라인. |
| PDF/A-4 적합성 | 보관 목적의 적합성. PDF/A-4 절 매핑 포함. |
| PDF/UA-2 적합성 | 접근성 적합성. PDF/UA-2 절 매핑 포함. |
| PDF/X 적합성 | 인쇄 제작용 적합성. |
| PAdES 절 매핑 | PDF 서명을 위한 ETSI EN 319 142 기준선 프로파일 매핑. |
| ZUGFeRD / Factur-X 적합성 | 하이브리드 전자 인보이스 적합성. |
신뢰 센터
섹션 제목: “신뢰 센터”코어 엔진의 엔지니어링 태세와 각 주장에 적용되는 경계를 함께 제시합니다.
| 페이지 | 용도 |
|---|---|
| 신뢰 센터 | 태세 색인. |
| 제품 라이선싱 | 오픈 코어와 상용 에디션의 라이선스 조건. |
| 상표 및 브랜드 사용 | NextPDF 이름과 마크를 사용하는 방법. |
| 데이터 처리, PII, 텔레메트리 | 엔진이 읽고 저장하며 전송하는 항목. |
| 서명 및 암호화 보안 모델 | 암호화 설계와 그 한계. |
| 엔진 위협 모델 | 엔진이 방어하는 대상과 방어하지 않는 대상. |
| 취약점 공개 정책 | 취약점을 신고하는 방법. |
프로젝트 및 릴리스
섹션 제목: “프로젝트 및 릴리스”| 페이지 | 용도 |
|---|---|
| 변경 로그 | 각 릴리스에서 변경된 내용. |
| 변경 로그 규약 | 변경 로그 항목을 작성하고 분류하는 방법. |
| 버전 관리, 안정성, 지원 중단 및 지원 정책 | 릴리스 간 호환성 약속. |
| NextPDF 문서 구성 방식 | 이 문서 세트의 구조와 거버넌스. |
용어집
섹션 제목: “용어집”용어집은 문서 전반에서 사용하는 용어를 한곳에서 정의하고 어디서나 링크합니다.
참조 항목 계약
섹션 제목: “참조 항목 계약”모든 API 항목은 동일한 질문에 답해야 합니다.
| 질문 | 필수 답변 |
|---|---|
| 무엇을 호출하나요? | 정규화된 심볼, 엔드포인트, CLI(command-line interface) 명령 또는 구성 키. |
| 어떤 입력이 허용되나요? | 유형, 필수 여부, 기본값, 허용되는 값을 포함한 매개변수 표. |
| 기본적으로 어떻게 동작하나요? | 선택적 입력이 생략되었을 때의 동작. |
| 무엇이 반환되나요? | 반환 유형, 응답 본문, 파일 출력, 스트림 또는 부작용. |
| 무엇이 실패할 수 있나요? | 예외, 유효성 검사 오류, HTTP 상태 또는 운영 실패 모드. |
| 안전하게 사용하려면 어떻게 해야 하나요? | 보안, 워커 안전성, 크기 제한, 경로, 시간 제한, 비밀 처리에 관한 참고 사항. |
범위 정책
섹션 제목: “범위 정책”API 및 동작 참조 페이지는 소스를 근거로 작성됩니다. 공개 API는 패키지 소스, 구성 파일, 테스트, 예제를 기준으로 문서화합니다. 내부 헬퍼 클래스는 애플리케이션 개발자가 패키지를 구성하거나 운영하는 데 그 동작을 이해해야 할 때만 문서화합니다.
번역 준비 상태
섹션 제목: “번역 준비 상태”참조 페이지에서는 빽빽한 단락보다 표를 우선합니다. 향후 XLIFF(Extensible Localization Interchange File Format) 분할 과정에서 콘텐츠가 블록 단위로 나뉘므로 각 행은 독립적으로 이해될 수 있어야 합니다.