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.
Le résultat dans un vrai PDF
Un document fait pour être suivi, pas regardé : chaque ligne du sommaire mène à la page qu’elle nomme, et chaque page ramène là d’où l’on vient. En chemin, il montre un lien étalé sur deux lignes, les cinq bordures qu’un lien peut tracer, et huit façons d’afficher la page où mène un lien.
Ouvrir le PDF Voir l’exemple complet
Également dans les exemples : Un formulaire interactif
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 à l’arrivée : 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 désigne 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 que le nom désigne. 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 que le nom désigne, orthographié exactement comme sonid. 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 contient est refusé. -
destinations[].fit— facultatif,whole_pagepar 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
}
]
}
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 Fermer, enregistrer, imprimer : ce qu’exécute le document Les scripts que le document enregistre sous un nom 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