Des points d'arrivée qui ont un nom

Enregistrer un endroit du document sous un nom, pour qu'un lien y mène sans jamais citer un numéro de page.

Résumé

Dire « voir page 12 » a un défaut : le jour où on ajoute une page au début, tout se décale et le renvoi est faux. Une étiquette collée à l'endroit visé, elle, se déplace avec lui, et tous les renvois qui la citent restent justes. Vous décidez aussi de ce qui remplit l'écran en arrivant : la page entière, sa largeur, ou un cadre précis.

Techniquement

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

destinations enregistre des points d'arrivée dans l'arbre de noms /Dests, chacun sous un nom qui donne la part de la fenêtre remplie et, au choix, une page ou un élément de l'arbre de structure. Une action qui mène à un nom ne dit rien de tout cela : le point d'arrivée suit donc le document, et non le numéro de page où il se trouvait. Un endroit qui tient pour un élément est écrit comme une destination de structure, /SD, avec à côté, dans /D, la page où cet élément commence, pour les logiciels de lecture qui ne connaissent rien de la structure ; c'est ce que la deuxième partie de la norme d'accessibilité demande d'une entrée dans un document. Un élément link y mène par action, sous la forme {"destination": "the name"}.

Schéma de la requête

  • destinations — tableau, facultatif, vide par défaut.
  • destinations[].name — chaîne, obligatoire. Le nom sous lequel l'endroit est enregistré. Un nom enregistré deux fois est refusé.
  • destinations[].page — entier ≥ 1. La page pour laquelle le nom tient. Une page que le document n'a pas est refusée ; un endroit qui nomme à la fois une page et un élément l'est aussi, tout comme un endroit qui ne nomme ni l'un ni l'autre.
  • destinations[].element — chaîne. L'identifiant de l'élément de l'arbre de structure pour lequel le nom tient, écrit comme l'id de cet élément l'écrit. L'endroit est alors la page où cet élément commence : il suit l'élément, et non la page où celui-ci est tombé. Un document qui en contient un est écrit en PDF 2.0, et un identifiant qu'aucun élément de l'arbre ne déclare est refusé.
  • destinations[].fit — facultatif, whole_page par défaut. Huit formes : "whole_page" ; {"full_width": {"top": n}} ; {"full_height": {"left": n}} ; {"rectangle": {"llx": n, "lly": n, "urx": n, "ury": n}} ; "whole_drawing" ; {"drawing_width": {"top": n}} ; {"drawing_height": {"left": n}} ; {"fixed": {"left": n, "top": n, "zoom": n}} — les trois dernières clés étant chacune facultative.

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

{
  "destinations": [{ "name": "annex", "page": 2 }],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "pages": [1],
      "rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 758 },
      "content": ["See the annex"],
      "font": "sans",
      "font_size": 12
    },
    {
      "type": "link",
      "pages": [1],
      "rect": { "llx": 60, "lly": 738, "urx": 160, "ury": 760 },
      "action": { "destination": "annex" }
    },
    {
      "type": "text",
      "pages": [2],
      "rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 768 },
      "content": ["The annex"],
      "font": "sans",
      "font_size": 18
    }
  ]
}

La ligne qui l'envoie, en trois langages

S'y retrouver

L'ordre du passage d'un champ au suivant Ce qu'une page déclenche à l'arrivée et au départ Ce dont le document dit être fait Le sommaire cliquable sur le côté Suivre un article de colonne en colonne Comment le document s'ouvre et s'imprime

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