Muster für Fußnotenverweise und Fußnotentexte über Connect

Auf einen Blick

Rendern Sie Fußnotenverweise und Fußnotentexte mit den Connect-Transporten, damit der Strukturbaum die PDF-2.0-Fußnotenrollen enthält. Aus der Inline-Markierung entsteht ein footnote/endnote-Verweis, aus dem Fußnotentext ein Notentext, jeweils mit einem wechselseitigen Rückverweis. Drei HTML-Formen steuern dieselbe Ausgabe: ein Link innerhalb eines Hochstellungselements, eine explizite ARIA-Rolle role="doc-noteref" und ein Textcontainer <aside class="footnote">. Die Prüfung erfolgt mit dem Barrierefreiheits-Werkzeug der Pro-Stufe. NextPDF erkennt es über class_exists() und registriert es nur, wenn nextpdf/premium zusätzlich zum Server installiert ist.

Ein bestandenes Ergebnis des Barrierefreiheits-Werkzeugs belegt eine Barrierefreiheitsprüfung, aber keine unabhängige Konformitätszertifizierung.

Installation

composer require nextpdf/server

Prüfen Sie mit einem tools/list-Aufruf, ob das Pro-Barrierefreiheits-Werkzeug vorhanden ist; siehe /connect/tool-catalog/.

Konzeptioneller Überblick

PDF 2.0 definiert eigene footnote/endnote-Strukturtypen sowie die Beziehung zwischen Verweis und Text (PDF/UA-2 §8.2.5). Ein Fußnotenverweis muss mit seinem Text verknüpft sein (PDF/UA-2 §8.2.5), damit ein Screenreader den Verweis ankündigen und dem Link zur Note folgen kann. Sowohl Verweis als auch Text müssen über den Strukturbaum erreichbar sein (PDF/UA-2 §8.2.4).

Die Pipeline erkennt drei Verweisformen:

<sup><a href="#fn-N">N</a></sup> — Kurzform mit Link im Hochstellungselement.
<sup role="doc-noteref" aria-describedby="fn-N">N</sup> — explizite DPUB-ARIA-Rolle; aria-describedby wird als Ziel des Rückverweises weitergegeben.
<aside class="footnote" id="fn-N">…</aside> (oder role="doc-footnote") — der Textcontainer, der als Notentext mit einem internen Verweis zurück zum passenden Verweis ausgegeben wird.

API-Oberfläche

Gleichen Sie Werkzeugnamen über tools/list mit der laufenden Registry ab. Der maßgebliche Katalog steht unter /connect/tool-catalog/. Dieses Rezept verwendet die Kernwerkzeuge für Dokumente und HTML sowie die Pro-Barrierefreiheitsprüfung und nennt die Werkzeuganzahl nicht erneut.

Codebeispiel — Schnellstart

Erstellen Sie ein getaggtes Dokument mit gesetzter Sprache und fügen Sie anschließend den Verweis in der Link-Kurzform hinzu:

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

Codebeispiel — Produktion

Fügen Sie beide Verweise und beide Texte mit einem einzigen HTML-Hinzufügen ein und prüfen Sie anschließend:

{
  "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>"
    }
  }
}

Die Barrierefreiheitsprüfung meldet die gepaarten reference/body-Rollen sowie die wechselseitigen Rückverweise.

Randfälle & Fallstricke

Verweis, aber kein Text (oder Text, aber kein Verweis) meldet die Prüfung; jeder Verweis benötigt einen passenden Text und umgekehrt.
id-Konflikt zwischen aria-describedby und der id des Texts verhindert die Auflösung des Paars (Groß-/Kleinschreibung wird beachtet).
Hochstellungsanker zu einer externen URL erzeugt einen einfachen Link, keinen Fußnotenverweis; verwenden Sie für ein externes Ziel die explizite Rolle.
Bloßes <aside> ohne class/role wird als Landmarke behandelt, nicht als Notentext. Fügen Sie class="footnote" oder role="doc-footnote" hinzu.
Werkzeug nicht vorhanden. Ohne nextpdf/premium ist das Pro-Barrierefreiheits-Werkzeug nicht registriert, sodass die Prüfung mit einem Unknown-Tool-Fehler fehlschlägt.

Performance

Das Budget im Front-Matter ist eine Dokumentationsobergrenze; die Fußnotenpaarung erfolgt im normalen Strukturdurchlauf.

Sicherheitshinweise

Über die allgemeinen Hinweise zum Connect-Transport hinaus gibt es keine weiteren Punkte.

Konformität

PDF/UA-2-Zuordnung

Aussage	Klausel	reference_id
Footnote/endnote-Strukturtypen und reference/body-Beziehung	PDF/UA-2 §8.2.5
Ein Fußnotenverweis ist mit seinem Text verknüpft	PDF/UA-2 §8.2.5
Verweis und Text sind über den Strukturbaum erreichbar	PDF/UA-2 §8.2.4

Tag → ISO 32000-2 §14.9-Querverweis

Verweis und Text verwenden die PDF-2.0-Standardstrukturtypen footnote/endnote. Der wechselseitige Rückverweis bildet den Vertrag für barrierefreie Fußnoten.

WCAG-2.2-Zuordnung

Verknüpfte Fußnotenverweise und -texte unterstützen WCAG 2.2 SC 1.3.1 (Info und Beziehungen) und SC 2.4.1 (Blöcke umgehen) auf Inhaltsebene.

Ein bestandenes Ergebnis des Barrierefreiheits-Werkzeugs ist eine Barrierefreiheitsprüfung, keine Konformitätszertifizierung; diese Feststellung trifft ein unabhängiger Prüfer.

Kommerzieller Kontext

Das Barrierefreiheits-Prüfwerkzeug gehört zur Pro-Stufe und wird nur registriert, wenn nextpdf/premium zusätzlich zum Server installiert ist.

Connect-Besonderheiten

Transportverfügbarkeit (MCP / REST / gRPC)

create_pdf, add_html und die Barrierefreiheitsprüfung werden über MCP, REST und gRPC identisch über den gemeinsamen Werkzeug-Executor aufgerufen.

HITL-Risikostufe

Dokumenterstellung und HTML-Aufnahme liegen auf Vorsichtsstufe; die Barrierefreiheitsprüfung ist schreibgeschützt. approval_required ist standardmäßig nicht gesetzt. Siehe /connect/hitl-risk-tiers/.

JSON-Umschlag für das Bestätigungs-Gate

Diese Werkzeuge lösen das Gate nicht aus, es sei denn, ein Betreiber-Override stuft eines auf approval_required hoch. Der Vertrag für den Umschlag und den Einmal-Token steht in /connect/hitl-risk-tiers/.

Siehe auch

/cookbook/connect/aria-tagged-pdf/ — Zuordnung von Landmarken-Rollen.
/cookbook/connect/figure-caption/ — verschachtelte Figure-/Caption-Struktur.
/connect/tool-catalog/ — Berechnung des Werkzeugsatzes pro Stufe.
/connect/hitl-risk-tiers/ — das Risikomodell und das Gate.