Connect ile dipnot referansı ve gövde modeli

Bir bakışta

Dipnot referanslarını ve dipnot gövdelerini Connect ile işleyin; böylece yapı ağacı PDF 2.0 dipnot rollerini içerir. Satır içi işaretleyici bir footnote/endnote referansına, dipnot metni ise bir not gövdesine dönüşür ve aralarında karşılıklı bir geri referans bulunur. Üç HTML biçimi aynı çıktıyı üretir: üst simge içindeki bir bağlantı, açık bir Accessible Rich Internet Applications (ARIA) role="doc-noteref" kullanımı ve bir <aside class="footnote"> gövde kapsayıcısı. Doğrulama, Pro katmanı erişilebilirlik aracını kullanır. NextPDF bu aracı class_exists() ile keşfeder ve yalnızca nextpdf/premium sunucuyla birlikte kurulu olduğunda kaydeder.

Erişilebilirlik aracından alınan başarılı sonuç, bir erişilebilirlik denetimidir; bağımsız bir uygunluk sertifikası değildir.

Kurulum

composer require nextpdf/server

Pro erişilebilirlik aracının kullanılabilirliğini bir tools/list çağrısıyla doğrulayın; bkz. /connect/tool-catalog/.

Kavramsal genel bakış

PDF 2.0, footnote/endnote için özel yapı türlerini ve bir referans ile gövdesi arasındaki ilişkiyi tanımlar (PDF/UA-2 §8.2.5). Bir dipnot referansı gövdesiyle ilişkilendirilmelidir (PDF/UA-2 §8.2.5); böylece ekran okuyucu referansı seslendirebilir ve notu okumak için bağlantıyı takip edebilir. Hem referans hem de gövde, yapı ağacı üzerinden erişilebilir olmalıdır (PDF/UA-2 §8.2.4).

İşlem hattı üç referans biçimini tanır:

<sup><a href="#fn-N">N</a></sup> — üst simge içinde bağlantı kısayolu.
<sup role="doc-noteref" aria-describedby="fn-N">N</sup> — açıkça belirtilmiş Digital Publishing Accessible Rich Internet Applications (DPUB-ARIA) rolü; aria-describedby, geri referans hedefi olarak aktarılır.
<aside class="footnote" id="fn-N">…</aside> (veya role="doc-footnote") — gövde kapsayıcısı; eşleşen referansa geri dönen bir iç referansla birlikte bir not gövdesi olarak yayımlanır.

API yüzeyi

Araç adlarını, çalışan kayıt defterine göre tools/list ile doğrulayın. Kayıtlı katalog için bkz. /connect/tool-catalog/. Bu tarif, temel belge ve HTML araçlarını ve ayrıca Pro erişilebilirlik denetimini kullanır; araç sayısını burada yinelemez.

Kod örneği — hızlı başlangıç

Dili ayarlanmış, etiketli bir belge oluşturun, ardından bağlantı kısayolu referansını ekleyin:

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

Kod örneği — üretim

Her iki referansı ve her iki gövdeyi tek bir HTML ekleme işleminde yayımlayın, ardından denetimi çalıştırın:

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "add_html",
    "arguments": {
      "document_id": "<id from create_pdf>",
      "html": "<p>Revenue grew 24%<sup><a href=\"#fn-1\">1</a></sup>.</p><p>Margin 33%<sup role=\"doc-noteref\" aria-describedby=\"fn-2\">2</sup>.</p><aside class=\"footnote\" id=\"fn-1\"><p>YoY vs prior year.</p></aside><aside class=\"footnote\" id=\"fn-2\" role=\"doc-footnote\"><p>(Revenue − OpEx) / Revenue.</p></aside>"
    }
  }
}

Erişilebilirlik denetimi, eşleştirilmiş reference/body rollerini ve karşılıklı geri referansları raporlar.

Uç durumlar ve dikkat edilmesi gerekenler

Referans var ama gövde yok (veya gövde var ama referans yok) denetim tarafından raporlanır; her referansın eşleşen bir gövdeye gereksinimi vardır ve bunun tersi de geçerlidir.
id uyumsuzluğu — aria-describedby ile gövde id değeri arasında — çiftin çözümlenmeden kalmasına neden olur (büyük/küçük harfe duyarlıdır).
Harici bir URL’ye bağlanan üst simge bağlantısı, dipnot referansı değil, düz bir bağlantı yayımlar; harici hedef için açık rolü kullanın.
class/role olmadan yalın <aside>, bir not gövdesi olarak değil, bir yer işareti olarak değerlendirilir. class="footnote" veya role="doc-footnote" ekleyin.
Araç yok. nextpdf/premium olmadan Pro erişilebilirlik aracı kaydedilmez; bu nedenle doğrulama bilinmeyen araç hatasıyla başarısız olur.

Performans

Frontmatter bütçesi belge için bir üst sınırdır; dipnot eşleştirmesi olağan yapı geçişinin bir parçasıdır.

Güvenlik notları

Genel Connect aktarım kılavuzu dışında ek bir gereklilik yoktur.

Uygunluk

PDF/UA-2 eşlemesi

İddia	Madde	reference_id
Dipnot/sonnot yapı türleri ve reference/body ilişkisi	PDF/UA-2 §8.2.5
Bir dipnot referansı gövdesiyle ilişkilendirilir	PDF/UA-2 §8.2.5
Referans ve gövde, yapı ağacı üzerinden erişilebilir	PDF/UA-2 §8.2.4

Etiket → ISO 32000-2 §14.9 çapraz referansı

Referans ve gövde, PDF 2.0 footnote/endnote standart yapı türlerini kullanır. Karşılıklı geri referans, erişilebilir dipnot sözleşmesini oluşturur.

WCAG 2.2 eşlemesi

İlişkilendirilmiş dipnot referansı ve gövdesi, içerik düzeyinde Web Content Accessibility Guidelines (WCAG) 2.2 SC 1.3.1 (Info and Relationships) ve SC 2.4.1 (Bypass Blocks) ölçütlerini destekler.

Erişilebilirlik aracından alınan başarılı bir sonuç, bir erişilebilirlik denetimidir; bir uygunluk sertifikası değildir. Bu belirlemeyi bağımsız bir denetleyici yapar.

Ticari bağlam

Erişilebilirlik denetimi aracı Pro katmanındadır ve yalnızca nextpdf/premium sunucuyla birlikte kurulu olduğunda kaydedilir.

Connect ayrıntıları

Aktarım kullanılabilirliği (MCP / REST / gRPC)

create_pdf, add_html ve erişilebilirlik denetimi, Model Context Protocol (MCP), REST ve gRPC üzerinden paylaşılan araç yürütücüsü aracılığıyla aynı şekilde çağrılır.

HITL risk katmanı

Belge oluşturma ve HTML alımı dikkat düzeyinde sınıflandırılır; erişilebilirlik denetimi salt okunurdur. Varsayılan olarak hiçbiri approval_required değildir. Bkz. /connect/hitl-risk-tiers/.

Onay kapısı JSON zarfı

Bir operatör geçersiz kılma işlemi bunlardan birini approval_required düzeyine yükseltmedikçe bu araçlar kapıyı tetiklemez. Zarf ve tek kullanımlık belirteç sözleşmesi şurada yer alır: /connect/hitl-risk-tiers/.

Ayrıca bakınız

/cookbook/connect/aria-tagged-pdf/ — yer işareti rol eşlemesi.
/cookbook/connect/figure-caption/ — iç içe Figure / Caption yapısı.
/connect/tool-catalog/ — katman başına araç kümesi hesaplaması.
/connect/hitl-risk-tiers/ — risk modeli ve kapı.