Modèle de référence et de corps de note de bas de page avec Connect

En bref

Rend les références et les corps de notes de bas de page via les transports Connect, afin que l’arbre de structure porte les rôles de note de bas de page PDF 2.0. Le marqueur en ligne devient une référence footnote/endnote et le texte de la note devient un corps de note, les deux étant reliés par une référence arrière réciproque. Trois formes HTML produisent la même émission : un lien dans un exposant, un rôle ARIA explicite role="doc-noteref" et un conteneur de corps <aside class="footnote">. La vérification utilise l’outil d’accessibilité de niveau Pro. NextPDF le détecte via class_exists() et ne l’enregistre que lorsque nextpdf/premium est installé avec le serveur.

Un résultat positif de l’outil d’accessibilité vaut vérification d’accessibilité, et non certification de conformité indépendante.

Installation

composer require nextpdf/server

Confirme la présence de l’outil d’accessibilité Pro via un appel tools/list ; voir /connect/tool-catalog/.

Vue d’ensemble conceptuelle

PDF 2.0 définit des types de structure footnote/endnote dédiés ainsi que la relation entre une référence et son corps (PDF/UA-2 §8.2.5). Une référence de note de bas de page doit être associée à son corps (PDF/UA-2 §8.2.5) afin qu’un lecteur d’écran puisse annoncer la référence et suivre le lien pour lire la note. La référence et le corps doivent tous deux être accessibles via l’arbre de structure (PDF/UA-2 §8.2.4).

Le pipeline reconnaît trois formes de référence :

<sup><a href="#fn-N">N</a></sup> — forme abrégée avec lien dans l’exposant.
<sup role="doc-noteref" aria-describedby="fn-N">N</sup> — rôle DPUB-ARIA explicite ; aria-describedby est transmis comme cible de la référence arrière.
<aside class="footnote" id="fn-N">…</aside> (ou role="doc-footnote") — conteneur du corps, émis comme corps de note avec une référence interne renvoyant à la référence correspondante.

Surface de l’API

Vérifie les noms d’outils par rapport au registre en cours d’exécution via tools/list. Le catalogue de référence se trouve dans /connect/tool-catalog/. Cette recette utilise les outils de document et HTML du cœur ainsi que la vérification d’accessibilité Pro, sans répéter le nombre d’outils.

Exemple de code — Démarrage rapide

Crée un document balisé avec une langue définie, puis ajoute la référence sous la forme abrégée avec lien :

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

Exemple de code — Production

Émets les deux références et les deux corps dans un seul ajout HTML, puis vérifie :

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

La vérification d’accessibilité signale les paires de rôles reference/body ainsi que les références arrière réciproques.

Cas limites & pièges

Une référence sans corps (ou un corps sans référence) est signalée par la vérification ; chaque référence a besoin d’un corps correspondant, et inversement.
Une discordance d’id entre aria-describedby et l’id du corps laisse la paire non résolue (sensible à la casse).
Une ancre en exposant vers une URL externe produit un lien simple, et non une référence de note de bas de page ; utilise le rôle explicite pour une cible externe.
Un <aside> nu sans class/role est traité comme un point de repère, et non comme un corps de note. Ajoute class="footnote" ou role="doc-footnote".
Outil absent. Sans nextpdf/premium, l’outil d’accessibilité Pro n’est pas enregistré ; la vérification échoue donc avec une erreur d’outil inconnu.

Performance

Le budget du front-matter sert de plafond documentaire ; l’appariement des notes de bas de page fait partie de la passe de structure normale.

Notes de sécurité

Sans objet au-delà des recommandations générales sur les transports Connect.

Conformité

Correspondance PDF/UA-2

Affirmation	Clause	reference_id
Types de structure footnote/endnote et relation reference/body	PDF/UA-2 §8.2.5
Une référence de note de bas de page est associée à son corps	PDF/UA-2 §8.2.5
Référence et corps accessibles via l’arbre de structure	PDF/UA-2 §8.2.4

Renvoi balise → ISO 32000-2 §14.9

La référence et le corps utilisent les types de structure standard footnote/endnote de PDF 2.0. La référence arrière réciproque constitue le contrat d’une note de bas de page accessible.

Correspondance WCAG 2.2

L’association d’une référence de note de bas de page et de son corps prend en charge les critères de succès WCAG 2.2 SC 1.3.1 (Information et relations) et SC 2.4.1 (Contourner des blocs) au niveau du contenu.

Un résultat positif de l’outil d’accessibilité vaut vérification d’accessibilité, et non certification de conformité ; cette détermination relève d’un outil de contrôle indépendant.

Contexte commercial

L’outil de vérification d’accessibilité relève du niveau Pro et ne s’enregistre que lorsque nextpdf/premium est installé avec le serveur.

Spécificités de Connect

Disponibilité des transports (MCP / REST / gRPC)

create_pdf, add_html et la vérification d’accessibilité s’invoquent de manière identique via MCP, REST et gRPC grâce à l’exécuteur d’outils partagé.

Niveau de risque HITL

La création de document et l’ingestion HTML relèvent du niveau prudence ; la vérification d’accessibilité est en lecture seule. Aucun de ces outils n’est approval_required par défaut. Voir /connect/hitl-risk-tiers/.

Enveloppe JSON du verrou de confirmation

Ces outils ne déclenchent pas le verrou, sauf si une dérogation d’opérateur élève l’un d’eux à approval_required. Le contrat de l’enveloppe et du jeton à usage unique se trouve dans /connect/hitl-risk-tiers/.

Voir aussi

/cookbook/connect/aria-tagged-pdf/ — correspondance des rôles de point de repère.
/cookbook/connect/figure-caption/ — structure Figure / Caption imbriquée.
/connect/tool-catalog/ — calcul de l’ensemble d’outils par niveau.
/connect/hitl-risk-tiers/ — le modèle de risque et le verrou.