La norme d'accessibilité que le document déclare

En mots de tous les jours

Écrit pour tout le monde. Il dit ce que cela pose sur une feuille de papier, et ne vous demande rien de plus.

Quelqu'un qui ne voit pas la page lit un document par un programme qui le dit à voix haute. Pour que ça marche, le fichier doit porter, à côté de l'encre, ce que chaque morceau d'encre est : ceci est un titre, ceci est un paragraphe, ceci est une image et voici ce qu'elle montre, cette ligne est un ornement et doit être sautée. Une norme dit exactement ce qu'un fichier doit porter pour être lisible ainsi, et c'est ici qu'on la déclare. La déclaration n'est pas prise sur parole : elle est vérifiée contre la structure dont le document dit être fait, le mobilier qu'il laisse de côté, les polices qu'il emporte et son titre, et un document qui ne tient pas est refusé plutôt que livré en disant quelque chose de faux. C'est ce qui décide d'un marché public, où la déclaration est une exigence et non une politesse.

Pour un développeur

Écrit pour celui qui écrit le programme appelant : le modèle, les unités, et les réglages qui portent le poids.

Écrit au premier niveau d'une requête, sous "accessible"

accessible nomme la norme d'accessibilité que le document respecte. La déclaration est jugée, pas enregistrée : elle est vérifiée contre l'arbre dont le document dit être fait, le mobilier qu'il laisse hors de cet arbre, les polices qu'il emporte et son titre. La partie choisie fixe aussi la version de PDF dans laquelle le fichier est écrit, et aucune autre — PDF/UA-1 repose sur PDF 1.7, PDF/UA-2 sur PDF 2.0, dont l'arbre est enraciné dans un unique élément Document pris dans le jeu de balises de PDF 2.0. Elle va de pair avec structure, que la vérification lit, et elle se pose à côté d'archive sans la remplacer : un document peut être à la fois d'archivage et accessible.

Chaque clé, avec son défaut

La référence : quelles clés sont obligatoires, lesquelles sont facultatives, ce que vaut chacune par défaut et quelles combinaisons le serveur décline.

accessible — chaîne, facultative. Absente, le document ne déclare rien.
pdfua1 — ISO 14289-1, la partie bâtie sur PDF 1.7. Le fichier est écrit en PDF 1.7.
pdfua2 — ISO 14289-2, la partie bâtie sur PDF 2.0, dont l'arbre est enraciné dans un unique élément Document pris dans le jeu de balises de PDF 2.0. Le fichier est écrit en PDF 2.0.

Portée : le document entier. Elle fixe la version dans laquelle le fichier est écrit, donc elle est refusée à côté d'un version qui dit autre chose. Un document déclarant une partie à laquelle il ne tient pas est refusé à la lecture de la demande, plutôt que livré avec une déclaration fausse.

Une requête entière qui le dessine

Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.

Un nom ci-dessous tient lieu d'un fichier de police : mettez le fichier encodé à sa place, ou envoyez le fichier lui-même à côté de la description, comme une partie du même appel.

{
  "accessible": "pdfua1",
  "metadata": { "title": "A readable document" },
  "fonts": [{ "name": "body", "data": "PASTE_THE_FONT_FILE_BASE64_HERE" }],
  "structure": {
    "lang": "en-GB",
    "children": [
      {
        "tag": "Document",
        "children": [{ "tag": "H1", "content": "heading" }]
      }
    ]
  },
  "items": [
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
      "content": ["A readable heading"],
      "font": "body",
      "font_size": 20,
      "tag": "H1",
      "mark": "heading"
    }
  ]
}

La ligne qui l'envoie, en trois langages

Le document dans son ensemble

Les numéros que le logiciel de lecture affiche Cent courriers dans un seul fichier Ce que le document dit de lui-même Un fichier lisible dans trente ans Une facture qu'un humain et une machine lisent L'adresse contre laquelle les liens se lisent La version de PDF que le fichier déclare Ce qu'une image dit d'elle-même Des fichiers que le document emporte à côté de ses pages Quels fichiers emportés une page réclame La fiche d'identité que porte une seule page

Où aller ensuite

Chaque clé d'une requête, en une page Les trente-deux autres réglages d'une requête

Voir les prix Voir les exemples

Glossaire

norme: Une règle débattue en commission, publiée sous un numéro que n'importe qui peut acheter et lire, et identique pour toutes les entreprises qui s'en réclament. Dire qu'on la suit peut donc être vérifié face au texte. Une façon de faire qui s'est simplement répandue parce qu'elle marchait est une habitude du métier : utile, très suivie, et qui ne répond devant aucun texte.
PDF/UA: Un PDF qu'une personne aveugle peut lire. Le fichier indique lui-même quel texte est un titre, lequel est un paragraphe, et dans quel ordre le logiciel qui lit à voix haute doit tout énoncer. Sans cela, ce logiciel lit la page dans l'ordre où elle a été dessinée, qui est rarement le bon.
CMJN: Les quatre encres d'une imprimerie : le cyan (un bleu), le magenta (un rose), le jaune et le noir. Un écran, lui, fabrique ses couleurs avec de la lumière. Un document qui part à l'impression dit donc ses couleurs en encres, et non en couleurs d'écran.
police: Le dessin de chaque lettre, de chaque chiffre et de chaque signe qu'un document écrit, rangé dans un fichier à part. Un PDF emporte à l'intérieur de lui-même les polices dans lesquelles il est composé : c'est pour cela qu'il s'ouvre à l'identique sur une machine qui ne les a jamais eues. Sans elles, un logiciel de lecture en met une autre à la place, et la mise en page bouge.
PDF balisé: Un PDF qui range son texte en plus de le dessiner : ceci est un titre, ceci un tableau, cette case appartient à cette colonne. C'est ce qui permet au logiciel qui lit à voix haute, ou au programme qui récupère les chiffres, de comprendre la page.

Tous les mots que le site explique