ส่งออก Figure พร้อม Caption ที่เข้าถึงได้ผ่าน Connect

ภาพรวมโดยสรุป

ส่ง HTML <figure> ที่มี <img> และ <figcaption> ผ่านทรานสปอร์ตของ Connect ไปป์ไลน์จะส่งออกอิลิเมนต์โครงสร้างมาตรฐาน Figure ฝัง caption เป็นลูก Caption และใช้แอตทริบิวต์ alt เพื่อกำหนดค่า /Alt จากนั้นตรวจสอบผลลัพธ์ด้วยเครื่องมือการเข้าถึงระดับ Pro-tier NextPDF จะค้นพบเครื่องมือดังกล่าวผ่าน class_exists() และลงทะเบียนเครื่องมือนี้เฉพาะเมื่อมีการติดตั้ง nextpdf/premium ควบคู่กับเซิร์ฟเวอร์ เครื่องมือ Core จัดการการสร้างเอกสารและการนำเข้า HTML

ผลลัพธ์ที่ผ่านเครื่องมือการเข้าถึงถือเป็นการตรวจสอบการเข้าถึง ไม่ใช่การรับรองความสอดคล้องที่เป็นอิสระ

การติดตั้ง

composer require nextpdf/server

ยืนยันว่าเครื่องมือการเข้าถึงระดับ Pro มีอยู่โดยเรียก tools/list ดู /connect/tool-catalog/

ภาพรวมเชิงแนวคิด

คำอธิบายทางเลือกให้ข้อความแทนเนื้อหาที่ไม่ใช่ข้อความ เช่น รูปภาพ (ISO 32000-2 §14.8) อิลิเมนต์โครงสร้างจะเก็บคำอธิบายนี้ไว้ในรายการ /Alt (ISO 32000-2 §14.8) แอตทริบิวต์ alt ของ HTML กำหนดค่า /Alt บน Figure ที่ส่งออก ไปป์ไลน์จะส่งออก <figcaption> เป็นลูก Caption ที่ฝังอยู่ภายใน แทนที่จะเป็นย่อหน้าระดับเดียวกัน เพื่อให้ caption ยังคงเข้าถึงได้ในฐานะส่วนหนึ่งของรูปภาพ (PDF/UA-2 §8.2.4)

ขอบเขต API

ตรวจสอบชื่อเครื่องมือกับรีจิสทรีที่กำลังทำงานโดยใช้ tools/list แคตตาล็อกที่เป็นทางการคือ /connect/tool-catalog/ สูตรนี้ใช้เครื่องมือเอกสารและ HTML ระดับ core ร่วมกับการตรวจสอบการเข้าถึงระดับ Pro โดยไม่ระบุจำนวนเครื่องมือซ้ำอีก

ตัวอย่างโค้ด — เริ่มต้นอย่างรวดเร็ว

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

ตัวอย่างโค้ด — Production

เพิ่มมาร์กอัปสำหรับรูปภาพ โดยต้องมี 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>"
    }
  }
}

เรียกใช้การตรวจสอบการเข้าถึง แล้วตรวจสอบโครงสร้างทรีที่รายงาน โครงสร้างนี้จะแสดง Figure เดียวที่มี /Alt และมีลูก Caption เพียงหนึ่งเดียว

กรณีขอบและข้อควรระวัง

<img> ที่ไม่มี alt การตรวจสอบจะรายงานความล้มเหลวของข้อความทางเลือกสำหรับรูปภาพ ระบุ alt ที่สื่อความหมาย หรือทำเครื่องหมายรูปภาพที่เป็นการตกแต่งล้วนๆ ให้เป็นอาร์ติแฟกต์ (ดู /cookbook/connect/page-artifacts/)
<figcaption> ที่ว่างเปล่า ไปป์ไลน์จะแจ้งเตือน ระบุข้อความ caption หรือนำอิลิเมนต์ออก
<figcaption> ที่อยู่นอก <figure> ใดๆ ไปป์ไลน์จะส่งออกเป็น caption ที่ไม่มี <figure> ครอบอยู่ ให้ครอบไว้ใน <figure>
ไม่มีเครื่องมือ หากไม่มี nextpdf/premium เครื่องมือการเข้าถึงระดับ Pro จะไม่ถูกลงทะเบียน และการตรวจสอบจะล้มเหลวด้วยข้อผิดพลาด unknown-tool

ประสิทธิภาพ

งบประมาณใน front-matter เป็นเพดานที่ระบุไว้ในเอกสาร การจัดการรูปภาพทำงานเป็นส่วนหนึ่งของรอบการจัดเค้าโครงตามปกติ

หมายเหตุด้านความปลอดภัย

ไม่มีคำแนะนำเพิ่มเติมนอกเหนือจากคำแนะนำทั่วไปเกี่ยวกับทรานสปอร์ตของ Connect

ความสอดคล้อง

การแมป PDF/UA-2

ข้อกล่าวอ้าง	ข้อกำหนด	รหัสอ้างอิง (reference_id)
คำอธิบายทางเลือกสำหรับเนื้อหาที่ไม่ใช่ข้อความ	ISO 32000-2 §14.8
คำอธิบายทางเลือกถูกเก็บไว้ใน `/Alt`	ISO 32000-2 §14.8
Caption เข้าถึงได้ผ่านโครงสร้างทรี	PDF/UA-2 §8.2.4

การอ้างอิงข้ามแท็ก → ISO 32000-2 §14.9

Figure และ Caption เป็นชนิดโครงสร้างมาตรฐาน การฝัง <figcaption> เป็น Caption ถือเป็นการกำหนดสัญญาของรูปภาพที่เข้าถึงได้

การแมป WCAG 2.2

รูปภาพที่มีข้อความ alt และ caption ที่เกี่ยวข้องช่วยรองรับ Web Content Accessibility Guidelines (WCAG) 2.2 SC 1.1.1 (Non-text Content) และ SC 1.3.1 (Info and Relationships) ในระดับเนื้อหา

ผลลัพธ์ที่ผ่านเครื่องมือการเข้าถึงถือเป็นการตรวจสอบการเข้าถึง ไม่ใช่การรับรองความสอดคล้อง ตัวตรวจสอบอิสระเป็นผู้ตัดสินใจเรื่องดังกล่าว

บริบทเชิงพาณิชย์

เครื่องมือตรวจสอบการเข้าถึงอยู่ในระดับ Pro และจะลงทะเบียนเฉพาะเมื่อมีการติดตั้ง nextpdf/premium ควบคู่กับเซิร์ฟเวอร์

รายละเอียดเฉพาะของ Connect

ความพร้อมใช้งานของทรานสปอร์ต (MCP / REST / gRPC)

เรียกใช้ create_pdf, add_html และการตรวจสอบการเข้าถึงผ่าน Model Context Protocol (MCP), REST และ gRPC ด้วยวิธีเดียวกัน โดยใช้ตัวรันเครื่องมือที่ใช้ร่วมกัน

ระดับความเสี่ยง HITL

การสร้างเอกสารและการนำเข้า HTML อยู่ในระดับที่ต้องใช้ความระมัดระวัง การตรวจสอบการเข้าถึงเป็นแบบอ่านอย่างเดียว โดยค่าเริ่มต้น ไม่มีเครื่องมือใดเป็น approval_required ดู /connect/hitl-risk-tiers/

ซองข้อมูล JSON ของเกตการยืนยัน

เครื่องมือเหล่านี้จะไม่เรียกใช้เกต เว้นแต่การแทนที่โดยผู้ดำเนินการจะยกระดับเครื่องมือใดเครื่องมือหนึ่งให้เป็น approval_required ซองข้อมูลและสัญญาโทเค็นแบบใช้ครั้งเดียวอยู่ใน /connect/hitl-risk-tiers/

ดูเพิ่มเติม

/cookbook/connect/aria-tagged-pdf/ — การแมปบทบาท landmark
/cookbook/connect/aria-noteref-pattern/ — บทบาทของการอ้างอิงเชิงอรรถและเนื้อหาหลัก
/cookbook/connect/page-artifacts/ — ทำเครื่องหมายรูปภาพที่เป็นการตกแต่งให้เป็นอาร์ติแฟกต์
/connect/tool-catalog/ — การคำนวณชุดเครื่องมือตามระดับ