Une zone de la page sur laquelle on clique

Rendre une zone de la page cliquable : il ouvre une adresse web, ou emmène le lecteur à une autre page du même document.

Le résultat dans un vrai PDF

Une lettre par destinataire, toutes dans le même fichier

Quatre lettres personnelles derrière un sommaire. Les lettres n’ont pas de numéro de page : chaque destinataire reçoit les pages qui suivent la sienne, autant qu’il en faut. Chaque ligne du sommaire conduit à la lettre concernée.

Ouvrir le PDF Voir l’exemple complet

Également dans les exemples : Liens et marques sur un texte déjà composé · Un diaporama qui se déroule tout seul · Liens internes et externes

Résumé

Elle est invisible : elle se pose par-dessus ce qui est déjà dessiné, en général sur un texte que vous avez mis en bleu pour qu’on voie qu’il est cliquable. Un saut à l’intérieur du document fonctionne comme un sommaire — le lecteur arrive sur la bonne page sans avoir à la chercher. Sur papier, la feuille reste telle quelle ; à l’écran, cette zone transforme votre document en quelque chose qui se parcourt.

Techniquement

Demandé avec "type": "link"

Un lien est une annotation /Subtype /Link posée au-dessus des éléments déjà dessinés, son /Rect donné en points : il se contente des pages que ces éléments ont créées, si bien qu’un lien nommé au-delà de la dernière page reste simplement de côté. Sa destination s’écrit de deux façons : la forme courte, qui dit une adresse ou un numéro de page, ou l’action complète, qui dit en plus la vue à laquelle la page s’ouvre, une destination nommée, une partie du document, un déplacement de lecture, l’envoi et la remise à zéro d’un formulaire, et l’affichage et le masquage des champs qu’elle nomme. Quelle que soit celle qui est écrite, l’annotation contient soit un /Dest, soit une action /A, jamais les deux à la fois : chaque lien dit l’une ou l’autre, ce qui garde une seule lecture possible.

Schéma de la requête

Clé obligatoire : rect. Exactement une clé de cible : to, valant soit {"uri": "address"}, soit {"page": n} avec n ≥ 1 ; ou action, valant {"uri": …} (une chaîne, ou un objet à uri obligatoire et track_pointer, false par défaut), {"page": …} (un entier ≥ 1, ou un objet à page obligatoire et fit, "whole_page" par défaut), {"destination": "name"}, {"part": n} avec n ≥ 1, {"menu_item": …} valant next_page, previous_page, first_page ou last_page, {"transition": {"effect": …, "seconds": …}}, qui affiche la zone de la page telle que l’action précédente l’a laissée, en la faisant apparaître par cette transition, et prend les mêmes effect et seconds qu’une page, {"reset_fields": {"fields": …}}, {"submit_fields": {…}} avec un url obligatoire, un fields facultatif et un format (par défaut {"fdf": {"with_no_value": false}}, également {"html": {"get": …, "with_click": …}}, "xfdf" et {"whole_document": {"get": …}}), {"import_fields": {"file": "name"}}, {"show": ["field", …]} ou {"hide": ["field", …]}. Un ensemble de champs s’écrit {"only": …} ou {"all_but": …} ; absent, il désigne le formulaire entier. show ramène à la vue les champs nommés et hide les en retire, chaque nom étant celui sous lequel un champ rapporte sa réponse, tous les champs placés sous lui suivant avec lui ; un nom que le document ne contient pas est refusé, et un champ retiré de la vue garde sa réponse, qu’un formulaire envoyé contient. Dans part, n est un numéro de page et non le rang d’une partie : le lecteur est mené à la partie qui réclame la page n, et une page qu’aucune partie ne réclame est refusée. Facultatives : highlight, ce que montre le logiciel de lecture tant que le pointeur reste enfoncé dessus, valant none, invert, outline ou push ; absent, la chose est laissée au logiciel de lecture. over, un tableau de quadrilatères, chacun quatre coins [x, y] dans le sens inverse des aiguilles d’une montre à partir de celui où commence son bord inférieur, les morceaux de page sur lesquels il est cliquable ; absent, son rectangle en tient lieu tout entier, ce qui suffit à une phrase tenant sur une ligne. description, une chaîne, ce vers quoi le lien mène, dit en mots ; border, l’encadrement tracé autour de lui, absent n’en traçant aucun ; layer, le nom d’un calque déclaré. pages, un tableau d’entiers comptés à partir de 1, vide par défaut. Refus croisés : to avec action ; ni l’un ni l’autre ; une page hors du document. Au-delà, action accepte aussi {"other_document": {"file": …, "page": n}}, une page d’un autre PDF, avec element et new_window facultatifs ; {"launch": {"file": …}}, un autre fichier ou une application, avec new_window facultatif ; {"viewer_command": "FullScreen"}, un geste qu’un logiciel de lecture offre sous un nom ; et {"switch_layers": {"switches": [{"layer": …, "switch": "toggle"}], "ignoring_radio_groups": false}}, qui allume, éteint ou bascule des calques déclarés. action prend aussi {"attachment": {"file_name": …, "page": n}}, une page d’un fichier PDF joint au document sous le file_name donné, refusée si aucun PDF n’est joint sous ce nom, avec fit et new_window facultatifs, ce qui demande PDF 1.6 ; {"carried_path": {"path": [{"child": …}, {"annotation": {"page": n, "name": …}}, "parent"], "page": n}}, une page d’un fichier PDF auquel on parvient de proche en proche, refusée si path est vide ou si sa première étape ne mène à aucun fichier PDF joint au document (les étapes suivantes, situées dans d’autres fichiers, ne sont pas vérifiées) : child entre dans le fichier joint sous ce nom au fichier courant, annotation dans le fichier que joint l’annotation de pièce jointe de ce nom posée sur la page donnée, comptée à partir de 1, et parent remonte au fichier auquel le fichier courant est joint, avec les mêmes fit et new_window facultatifs, ce qui demande PDF 1.6 ; et {"script": …}, un script exécuté tel qu’il est donné, qu’aucun document revendiquant l’une des trois premières parties de PDF/A ne contient. Un lien prend aussi mark, l’étiquette sous laquelle l’arbre de structure le réclame, par les annotations d’un nœud ; un lien placé sur plusieurs pages range sous elle un lien par page.

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

{
  "standard_fonts": [{"name": "sans", "face": "helvetica"}],
  "layers": [{"name": "Notes"}],
  "items": [
    {
      "type": "text",
      "rect": {"llx": 72, "lly": 740, "urx": 300, "ury": 760},
      "content": ["Visit hqf-pdf.com"],
      "font": "sans",
      "font_size": 14,
      "color": [0.11, 0.31, 0.55]
    },
    {
      "type": "link",
      "rect": {"llx": 72, "lly": 740, "urx": 300, "ury": 760},
      "to": {"uri": "https://hqf-pdf.com/"},
      "border": { "solid": { "color": [0.11, 0.31, 0.55], "width": 0.5 } },
      "highlight": "invert"
    },
    {
      "type": "text",
      "rect": {"llx": 72, "lly": 700, "urx": 300, "ury": 720},
      "content": ["Read on"],
      "font": "sans",
      "font_size": 14,
      "color": [0.11, 0.31, 0.55]
    },
    {
      "type": "link",
      "rect": {"llx": 72, "lly": 700, "urx": 300, "ury": 720},
      "action": {"menu_item": "next_page"}
    },
    {
      "type": "text",
      "rect": {"llx": 72, "lly": 740, "urx": 300, "ury": 760},
      "content": ["The page the move lands on"],
      "font": "sans",
      "font_size": 14,
      "pages": [2]
    },
    {
      "type": "text",
      "rect": {"llx": 72, "lly": 660, "urx": 300, "ury": 680},
      "content": ["A note shown or hidden by the link above it"],
      "font": "sans",
      "font_size": 11,
      "layer": "Notes"
    },
    {
      "type": "link",
      "rect": {"llx": 72, "lly": 680, "urx": 300, "ury": 695},
      "action": {
        "switch_layers": {"switches": [{"layer": "Notes", "switch": "toggle"}]}
      }
    }
  ]
}

La ligne qui l’envoie, en trois langages

Où aller ensuite

Toutes les clés JSON d’une requête, en une page Les vingt-deux autres choses que l’on peut dessiner

Voir les prix Voir les exemples