Connect로 Caption이 포함된 접근 가능한 Figure 생성

한눈에 보기

<img>와 <figcaption>을 포함한 HTML <figure>를 Connect 전송 계층을 통해 전송합니다. 파이프라인은 Figure 표준 구조 요소를 만들고, 캡션을 Caption 자식으로 중첩한 뒤, alt 속성으로 /Alt을 채웁니다. 검증 단계에서는 Pro 등급 접근성 도구를 사용합니다. NextPDF는 class_exists()로 이 도구를 찾으며, nextpdf/premium이 서버와 함께 설치된 경우에만 등록합니다. 문서 생성과 HTML 수집에는 코어 도구를 사용합니다.

접근성 도구에서 통과했다는 결과는 접근성 검사 결과일 뿐, 독립적인 적합성 인증이 아닙니다.

설치

composer require nextpdf/server

Pro 접근성 도구가 있는지 tools/list 호출로 확인합니다. /connect/tool-catalog/.를 참조하십시오.

개념 개요

대체 설명은 그림 같은 비텍스트 콘텐츠를 설명하는 텍스트입니다(ISO 32000-2 §14.8). 구조 요소는 이 설명을 /Alt 항목에 보관합니다(ISO 32000-2 §14.8). HTML alt 속성은 생성된 Figure의 /Alt을 채웁니다. 파이프라인은 <figcaption>을 형제 단락이 아닌 중첩된 Caption 자식으로 생성하므로, 캡션은 그림의 일부로 접근 가능한 상태를 유지합니다(PDF/UA-2 §8.2.4).

API 표면

tools/list로 실행 중인 레지스트리의 도구 이름을 확인하십시오. 공식 카탈로그는 /connect/tool-catalog/.입니다. 이 레시피는 코어 문서 및 HTML 도구와 Pro 접근성 검사를 사용합니다. 도구 개수를 다시 언급하지 않습니다.

코드 샘플 — 빠른 시작

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "create_pdf",
    "arguments": { "page_size": "A4", "title": "Architecture Reference", "language": "en" }
  }
}

코드 샘플 — 프로덕션

figure 마크업을 추가합니다. 접근 가능한 그림을 만들려면 alt이 필수입니다.

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "add_html",
    "arguments": {
      "document_id": "<id from create_pdf>",
      "html": "<figure><img src=\"diagrams/architecture.png\" alt=\"Three-tier deployment: web frontend, REST API, datastore\" /><figcaption>Figure 1 — Deployment topology.</figcaption></figure>"
    }
  }
}

접근성 검사를 실행한 뒤 보고된 구조 트리를 살펴보십시오. /Alt을 가진 단일 Figure와 정확히 하나의 Caption 자식이 표시됩니다.

엣지 케이스 및 주의 사항

alt이 없는 <img>. 검사에서 figure 대체 텍스트 실패가 보고됩니다. 설명적인 alt을 제공하거나, 순전히 장식용인 이미지를 아티팩트로 표시하십시오(/cookbook/connect/page-artifacts/ 참조).
빈 <figcaption>. 파이프라인에서 경고가 발생합니다. 캡션 텍스트를 제공하거나 요소를 제거하십시오.
어떤 <figure>에도 속하지 않는 <figcaption>. 파이프라인은 이를 고아 캡션으로 생성합니다. <figure>로 감싸십시오.
도구 부재. nextpdf/premium이 없으면 Pro 접근성 도구가 등록되지 않으며, 검증은 알 수 없는 도구 오류로 실패합니다.

성능

프런트매터 예산은 문서에 명시된 상한값입니다. Figure 처리는 일반 레이아웃 패스의 일부로 실행됩니다.

보안 참고 사항

일반적인 Connect 전송 지침 외에 추가 사항은 없습니다.

적합성

PDF/UA-2 매핑

주장	조항	reference_id
비텍스트 콘텐츠에 대한 대체 설명	ISO 32000-2 §14.8
`/Alt`에 보관된 대체 설명	ISO 32000-2 §14.8
구조 트리를 통해 접근 가능한 Caption	PDF/UA-2 §8.2.4

Tag → ISO 32000-2 §14.9 교차 참조

Figure와 Caption은 표준 구조 유형입니다. <figcaption>을 Caption으로 중첩하는 것이 접근 가능한 그림을 위한 구조적 계약입니다.

WCAG 2.2 매핑

대체 텍스트 및 연결된 캡션을 가진 그림은 콘텐츠 수준에서 WCAG 2.2 SC 1.1.1(비텍스트 콘텐츠)과 SC 1.3.1(정보와 관계)을 지원합니다.

접근성 도구에서 통과했다는 결과는 접근성 검사 결과일 뿐, 적합성 인증이 아닙니다. 적합성 판정은 독립적인 검사 도구가 내립니다.

상용 맥락

접근성 검사 도구는 Pro 등급 도구이며 nextpdf/premium이 서버와 함께 설치된 경우에만 등록됩니다.

Connect 세부 사항

전송 가용성 (MCP / REST / gRPC)

공유 도구 실행기를 통해 MCP, REST, gRPC에서 create_pdf, add_html 및 접근성 검사를 동일하게 호출합니다.

HITL 위험 등급

문서 생성과 HTML 수집은 주의 수준입니다. 접근성 검사는 읽기 전용입니다. 기본적으로 이 중 어떤 것도 approval_required가 아닙니다. /connect/hitl-risk-tiers/.를 참조하십시오.

확인 게이트 JSON 엔벨로프

이 도구들은 운영자 재정의로 어느 하나가 approval_required로 상향되지 않는 한 게이트를 트리거하지 않습니다. 엔벨로프와 일회용 토큰 계약은 /connect/hitl-risk-tiers/.에 있습니다.

Connect로 Caption이 포함된 접근 가능한 Figure 생성

Connect로 Caption이 포함된 접근 가능한 Figure 생성

한눈에 보기

설치

개념 개요

API 표면

코드 샘플 — 빠른 시작

코드 샘플 — 프로덕션

엣지 케이스 및 주의 사항

성능

보안 참고 사항

적합성

PDF/UA-2 매핑

Tag → ISO 32000-2 §14.9 교차 참조

WCAG 2.2 매핑

상용 맥락

Connect 세부 사항

전송 가용성 (MCP / REST / gRPC)

HITL 위험 등급

확인 게이트 JSON 엔벨로프

관련 항목