Interne und externe Links
Ein Link zeichnet nichts, also beweist nichts auf einer Seite, dass er da ist: Nur ihm zu folgen beweist es. Deshalb sind Links der Teil eines Dokuments, der am häufigsten unbemerkt kaputtgeht — die Datei wird neu erzeugt, die Seiten verschieben sich um eine, und jede Zeile des Inhaltsverzeichnisses landet nun eine Seite zu früh.
Dieses Dokument ist also gemacht, um ihm zu folgen, statt es anzusehen. Öffnen Sie es und klicken Sie: Jede Zeile des Inhaltsverzeichnisses landet auf der Seite, die sie nennt, jede Seite führt dorthin zurück, woher sie kam, und die nach außen zeigende Adresse öffnet eine Website. Dieselbe Liste steht in der Lesezeichenleiste neben der Seite — Desktop-Anzeigesoftware wie Adobe Acrobat Reader hält diese Leiste offen, die in einen Browser eingebaute Anzeigesoftware verbirgt es hinter einer Schaltfläche.
Jedes Kapitel zeigt dann etwas, das ein Link außer dem Hinführen tut. Das erste enthält einen über zwei getrennte Zeilen verteilten Link, ohne etwas Anklickbares dazwischen, und einen Rückweg, der unter einem Namen statt einer Seitenzahl abgelegt ist, sodass er auch dann richtig landet, wenn sich die Seiten verschieben. Das zweite zeigt die fünf Rahmen, die ein Link um sich zeichnen kann: durchgezogen, gestrichelt, erhaben, vertieft und unterstrichen. Das dritte führt auf acht Arten zum Inhaltsverzeichnis zurück, eine für jede Art, wie man der Anzeigesoftware sagen kann, die Zielseite zu zeigen — die ganze Seite, ihre volle Breite, ihre volle Höhe, ein Rechteck daraus und so weiter.
Was dieses Beispiel zeigt
- Ein Inhaltsverzeichnis, dessen Zeilen auf den Seiten landen, die sie nennen.
- Eine Adresse, die das Dokument verlässt und eine Website öffnet.
- Dieselbe Liste noch einmal in der Lesezeichenleiste neben der Seite.
Der Quellcode, vollständig
Nichts ist weggelassen und nichts vereinfacht: Das ist das Programm genau so, wie es läuft, für den Entwickler, der diese Bibliothek nutzt.
Die dritte ist die Beschreibung selbst: eine schlichte Liste dessen, was die Seite sagen muss, und das wird dem Dienst gesendet.
Den Rust-Quellcode lesen
Den Python-Quellcode lesen
Den JSON-Quellcode lesen
Das Dokument selbst
Das Dokument auf Englisch öffnen
Das Dokument auf Französisch öffnen
Das Dokument auf Deutsch öffnen
Das Dokument auf Spanisch öffnen
Das Dokument auf Italienisch öffnen
Das Dokument auf Portugiesisch öffnen