Liens internes et externes

Un lien ne dessine rien : rien sur la page ne prouve qu’il est là, il faut le suivre pour le savoir. C’est ce qui fait des liens la partie d’un document la plus souvent cassée sans que personne s’en aperçoive — le fichier est recréé, les pages se décalent d’une, et chaque ligne du sommaire tombe désormais une page trop tôt.

Ce document est donc fait pour être suivi plutôt que regardé. Ouvrez-le et cliquez : chaque ligne du sommaire mène à la page qu’elle nomme, chaque page ramène là d’où elle vient, et l’adresse qui pointe vers l’extérieur ouvre un site. La même liste figure dans le panneau des signets à côté de la page — un logiciel de lecture de bureau comme Adobe Acrobat Reader garde ce panneau ouvert, le logiciel de lecture intégré à un navigateur le cache derrière un bouton.

Chaque chapitre montre ensuite ce qu’un lien sait faire en plus de vous emmener ailleurs. Le premier contient un seul lien étalé sur deux lignes séparées, sans rien de cliquable entre elles, et un retour rangé sous un nom plutôt que sous un numéro de page, qui arrive donc au bon endroit même quand les pages bougent. Le deuxième montre les cinq bordures qu’un lien peut tracer autour de lui : pleine, en tirets, en relief, en creux et soulignée. Le troisième ramène au sommaire de huit façons, une pour chaque manière dont on peut demander au logiciel de lecture d’afficher la page d’arrivée — la page entière, toute sa largeur, toute sa hauteur, un seul rectangle, et ainsi de suite.

Ce que montre cet exemple

  • Un sommaire dont chaque ligne tombe sur la page qu’elle nomme.
  • Une adresse qui sort du document et ouvre un site.
  • La même liste, reprise dans le panneau des signets à côté de la page.

Le code source complet

Rien n’est omis et rien n’est simplifié : c’est le programme exactement tel qu’il tourne, pour le développeur qui utilise cette bibliothèque. La troisième est la description elle-même : une simple liste de ce que la page doit dire, et c’est elle qu’on envoie au service.

Voir le code Rust Voir le code Python Voir le code JSON

Le document lui-même

Ouvrir le document en anglais Ouvrir le document en français Ouvrir le document en allemand Ouvrir le document en espagnol Ouvrir le document en italien Ouvrir le document en portugais

Exemples proches de celui-ci

Un diaporama qui se déroule tout seul

Une première diapositive sobre et treize autres, chacune énonçant l’effet par lequel elle arrive — les douze que définit la norme PDF (ISO 32000) —, la durée de cet effet et le temps pendant lequel la diapositive reste affichée avant que la suivante n’arrive. Le fichier demande à s’ouvrir en plein écran, là où les effets se jouent, et un lien posé sur la première diapositive réaffiche l’écran en le faisant apparaître par dissolution.

Un manuel qui dit comment il veut être lu

Quatre pages qui disent comment elles veulent être ouvertes : quelle page se présente et quelle part de la fenêtre elle remplit, les chapitres à côté, les pages deux par deux, une boîte d’impression déjà remplie — autant de souhaits auxquels le logiciel de lecture répond comme il l’entend.

Liens et marques sur un texte déjà composé

Des liens et des marques accrochés à un texte que le moteur a déjà mis en place : un bandeau derrière une ligne, un soulignement, une cellule encadrée — chaque rectangle repris de ce que la mise en page et le tableau indiquent après coup, aucun mesuré à la main.

Étiquettes de page personnalisées

Quatorze pages numérotées par leurs étiquettes plutôt que par leur position : chiffres romains en minuscules et en capitales, chiffres ordinaires, lettres, un préfixe devant des chiffres ou des lettres, et une quatrième de couverture étiquetée par le seul préfixe.

Un récit qui se poursuit plus loin

Deux articles sur deux pages : chacun commence dans une colonne de la première page et se poursuit dans une colonne de la seconde, et tous deux changent de côté d’une page à l’autre. Le fichier dit quelle colonne suit laquelle, si bien que le logiciel de lecture poursuit l’article en cours.

Tous les exemples, par sujet