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