Le document dit ce que veulent dire ses marques

Résumé

Une personne qui ne voit pas la page l'écoute. Le logiciel qui la lit à voix haute doit savoir ce qui est un titre, ce qui est un paragraphe, ce qui est un tableau, quelle cellule se range sous quel titre de colonne, et surtout dans quel ordre dire tout cela. Une page qui n'enregistre que l'endroit où chaque lettre est tracée ne dit rien de tout cela : le logiciel de lecture la parcourt alors dans l'ordre où le texte a été tracé, qui est rarement celui où une personne le lirait.

La réponse est un arbre de structure écrit à côté du contenu de la page : ce groupe de mots est un titre, celui-là un paragraphe, ce bloc est un tableau et voici sa ligne d'en-tête. Le tracé ne change pas. Ce qui change, c'est que le fichier sait désormais ce qu'il a tracé — ce qui permet aussi à un logiciel d'en ressortir les chiffres, et à un moteur de recherche d'indexer le texte correctement.

Un tableau trop long pour une page est coupé, et reprend en haut de la suivante. Sa ligne d'en-tête y est redessinée, pour qu'une personne qui lit la deuxième page sache toujours ce que contient chaque colonne.

Aucune règle publiée ne dit ce qu'est cette ligne retracée. Le moteur la rattache à la même cellule d'en-tête : la colonne intitulée Mars reste une seule colonne, ses mots restent sélectionnables et lus sur les deux pages, et la structure ne la nomme qu'une fois. La section Article par article énumère les articles consultés.

L'essentiel se construit au fil de la mise en page. Ce qui vous reste, c'est le plan : quelle partie du document est une section, ce que veut dire telle image, et dans quel ordre tout cela se lit.

Article par article

Le moteur signale un arbre manquant, des en-têtes de tableau manquants, un titre de document manquant et une langue manquante, puis refuse d'écrire : un document qui revendique la norme d'accessibilité sans la respecter ne sort pas du moteur. Ce rapport se demande au moteur avant l'écriture — par le service, la clé check de la requête — et il énumère ces manques alors que le fichier n'existe pas encore.

La deuxième partie de la norme d'accessibilité demande qu'un point d'entrée dans le document nomme un morceau de sa structure plutôt qu'une page. Le moteur écrit ces destinations : un lien, un signet ou la vue d'ouverture mène à un élément de l'arbre, et la page où cet élément commence est écrite à côté, pour les logiciels de lecture qui ne connaissent rien de la structure. Un document qui en porte une est écrit en PDF 2.0, et un identifiant qu'aucun élément de l'arbre ne porte est refusé plutôt qu'écrit. Le rapport nomme aussi les points d'entrée qui mènent à une page sans nommer d'élément de la structure.

Le moteur demande au programme appelant de marquer la décoration comme telle ; il ne vérifie pas ce marquage. Il lit et signale les règles des tableaux : la forme du tableau, une légende unique à l'une de ses extrémités, des lignes de même largeur, aucune cellule posée sur une autre, et chaque cellule de titre, qui dit ce qu'elle intitule ou bien est nommée par les cellules qui s'en servent.

Aucune de ces règles n'atteint un tableau coupé par un saut de page. ISO 14289-1 7.5 et ISO 14289-2 8.2.5.26 demandent à quels en-têtes une cellule répond et quelle forme a un tableau ; ni l'une ni l'autre ne dit un mot d'une ligne d'en-tête retracée sur la page suivante, et aucun texte publié de la famille ne nomme cette répétition. Ce qui est écrit ici est donc affirmé, et non cité : un en-tête coupé sur deux pages est un seul en-tête, rattaché une seule fois à la structure, et ses deux tracés se lisent comme ce même en-tête. Aucune règle publiée ne permet à un vérificateur de mesurer ce choix ; il est donc annoncé ici.