Le sommaire cliquable sur le côté

Donner au document un sommaire dépliable, affiché à côté des pages, dont chaque ligne mène directement à une page.

Le résultat dans un vrai PDF

Liens internes et externes

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 manuel qui dit comment il veut être lu

Résumé

Dans un gros classeur, des intercalaires à onglets permettent de trouver une section sans feuilleter. Une ligne peut en contenir d’autres, comme la table des matières d’un livre avec ses chapitres et ses sous-chapitres, et vous décidez lesquelles s’ouvrent d’elles-mêmes la première fois que le document est affiché.

Techniquement

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

bookmarks écrit l’arbre /Outlines que le logiciel de lecture montre dans son panneau latéral. Chaque signet a un titre, la page vers laquelle il mène, et le cas échéant d’autres signets imbriqués sous lui. L’ordre du tableau est l’ordre d’affichage. Pour que le panneau s’ouvre de lui-même à l’ouverture du document, demandez-le par reading.open_mode. Un signet qui mène à une page que le document n’a pas est refusé.

Schéma de la requête

  • bookmarks — tableau, facultatif, vide par défaut.
  • bookmarks[].title — chaîne, obligatoire. Le titre qu’affiche le logiciel de lecture.
  • bookmarks[].page — entier ≥ 1, facultatif. La page où mène le signet, affichée en entier sauf si fit dit autre chose. Une page que le document n’a pas est refusée, et la réponse la nomme dans la numérotation de la requête.
  • bookmarks[].open — booléen, facultatif, false par défaut. Affiche ce qui est imbriqué dessous sans qu’on le demande.
  • bookmarks[].children — tableau, facultatif, vide par défaut. Les signets imbriqués sous celui-ci, de même forme, sans limite de profondeur.
  • bookmarks[].fit — objet ou chaîne, facultatif. La part de cette page qui remplit la fenêtre, dans les formes de cadrage de reading.open_on.fit : un chapitre qui s’ouvre sur sa première ligne s’écrit {"full_width": {"top": 742}}. Nommé sur un signet qui ne nomme aucune page, il est refusé.
  • bookmarks[].action — action, facultative. Ce que déclenche le signet, quand on le suit, à la place d’une page : une adresse, une page d’un autre fichier, un calque basculé. Nommer à la fois page et action est refusé.
  • bookmarks[].element — chaîne, facultative. L’id du nœud de structure que le signet représente. À côté d’une page ou d’une action, un logiciel de lecture qui comprend cette clé va à cet élément, et un autre suit le signet tel qu’il est ; nommé seul, le signet mène à cet élément où qu’il soit mis en page, ce qui relève de PDF 2.0.
  • bookmarks[].separator — booléen, facultatif, false par défaut. true fait un signet qui ne mène nulle part : la ligne qui partage le panneau, son title étant le trait que le panneau affiche. Un séparateur ne nomme ni page, ni action, ni element, et prend quand même une couleur, un style et des signets imbriqués.
  • bookmarks[].color — couleur, facultative. La couleur dans laquelle le titre est affiché, donnée en lumière : trois nombres, ou un seul pour un gris. Absente, celle du logiciel de lecture.
  • bookmarks[].italic et bookmarks[].bold — booléens, facultatifs, false par défaut. Si le titre est en italique, en gras ; les deux peuvent être donnés ensemble.
  • Un signet qui ne nomme ni page, ni action, ni element, et qui n’est pas un séparateur, est refusé.

Un signet mène à une page par son numéro. Pour un point d’arrivée qui suive le document plutôt que le numéro, on passe par destinations et un élément link qui le nomme.

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

{
  "bookmarks": [
    {
      "title": "Contents",
      "page": 1,
      "open": true,
      "children": [{ "title": "The annex", "page": 2 }]
    }
  ],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "pages": [1],
      "rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 768 },
      "content": ["Contents"],
      "font": "sans",
      "font_size": 18
    },
    {
      "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 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 Des points d’arrivée qui ont un nom 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