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

Déclarer que le document est conçu pour être lu à voix haute et décrit, et faire vérifier cette déclaration au regard de ce qu’il contient vraiment.

Le résultat dans un vrai PDF

Un montant qui dit de quels titres il dépend

Les recettes de trente agences, trimestre par trimestre, sur deux pages. Chaque montant de la page est rattaché aux en-têtes sous lesquels il se trouve : l’agence à côté de lui, le trimestre au-dessus, et l’année au-dessus des quatre trimestres réunis. Lu à voix haute, un montant est annoncé par sa ville, son trimestre et son année avant la somme elle-même.

Ouvrir le PDF Voir l’exemple complet

Également dans les exemples : Un bulletin de paie

Résumé

Quelqu’un qui ne voit pas la page lit un document au moyen d’un programme qui le dit à voix haute. Pour que cela fonctionne, le fichier doit contenir, à 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 du décor et doit être sautée. La vérification regarde la structure dont le document dit être fait, les éléments de décor qu’il écarte, les polices qu’il contient 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.

Techniquement

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

accessible déclare, dans le paquet XMP, la norme d’accessibilité que le document respecte, et écrit /MarkInfo. La déclaration est jugée, pas enregistrée : elle est confrontée à l’arbre dont le document se déclare composé, aux éléments de décor qu’il laisse hors de cet arbre, aux polices qu’il contient 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 s’ajoute à archive sans la remplacer : un document peut être à la fois d’archivage et accessible.

Schéma de la requête

  • 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 qui déclare une partie qu’il ne respecte pas est refusé à la lecture de la requête, plutôt que livré avec une déclaration fausse.

Une requête entière qui crée un PDF

Un nom ci-dessous tient lieu de fichier de police : mettez le fichier encodé à sa place, ou envoyez le fichier lui-même à côté de la description, comme une pièce fournie dans le même appel. Une page contient une vraie police déjà encodée, et sa requête part telle quelle.

{
  "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 montre le logiciel de lecture Cent courriers dans un seul fichier Ce que le document dit de lui-même Ce que le document dit de lui-même, dit une seule fois Un texte que personne ne peut copier Les notes qu’un programme laisse pour lui-même Les notes qu’un programme laisse sur une page Les données qu’un programme accroche à un passage d’encre Un fichier encore lisible dans des dizaines d’années La norme d’impression que le document déclare La norme d’impression variable déclarée par le document Le mot de passe qui l’ouvre, et ce qu’on peut en faire Une facture qu’un humain et une machine lisent L’adresse à partir de laquelle se lisent les liens relatifs La version de PDF que le fichier déclare Les extensions de PDF dont le fichier dit se servir Ce qu’une image dit d’elle-même, et comment elle est lue Les pièces jointes du document, à côté de ses pages Des fichiers que le document nomme sans les contenir Les pièces jointes, présentées en portefeuille Les pièces jointes que revendique une page Les pièces jointes que revendique une police La fiche d’identité propre à une police Les pièces jointes que revendique la fiche du document Une fiche de document rédigée ailleurs Les zones d’une page où un lecteur mesure La fiche d’identité que contient une seule page Les normes contre lesquelles le document fini est mesuré

Où aller ensuite

Toutes les clés JSON d’une requête, en une page Les quarante et un autres réglages d’une requête

Voir les prix Voir les exemples