Internal and External Links

A link draws nothing, so nothing on a page proves it is there: only following it does. That is what makes links the part of a document most often broken without anybody noticing — the file is created again, the pages shift by one, and every line of the contents now lands a page early.

So this document is made to be followed rather than looked at. Open it and click: every line of the contents lands on the page it names, every page leads back to where it came from, and the address pointing outwards opens a site. The same list stands in the panel of bookmarks beside the page — desktop reading software such as Adobe Acrobat Reader keeps that panel open, the reading software built into a browser hides it behind a button.

Each chapter then shows something a link does besides take you somewhere. The first holds one link spread over two separate lines, with nothing clickable between them, and a way back filed under a name rather than a page number, so it still lands right when the pages move. The second shows the five borders a link can draw round itself: solid, dashed, raised, sunken and underlined. The third goes back to the contents eight ways, one for each way reading software can be told to show the page it lands on — the whole page, its full width, its full height, one rectangle of it, and so on.

What This Example Shows

  • A contents page whose lines land on the pages they name.
  • One address that leaves the document and opens a site.
  • The same list again in the panel of bookmarks beside the page.

The Source Code, Complete

Nothing is left out and nothing is simplified: this is the program exactly as it runs, for the developer who uses this library. The third is the description itself: a plain list of what the page has to say, which is what the service is sent.

Read the Rust source Read the Python source Read the JSON source

The Document Itself

Open the document in English Open the document in French Open the document in German Open the document in Spanish Open the document in Italian Open the document in Portuguese

Examples Near This One

A Slideshow That Runs Itself

A plain first slide and thirteen more, each stating the effect it arrives by — the twelve the PDF standard (ISO 32000) defines — how long that effect takes and how long the slide stands before the next one comes. The file asks to open full screen, which is where the effects play, and a link on the first slide shows the screen again, brought in by dissolving.

A Handbook That Says How It Wants to Be Read

Four pages that say how they want to be opened: which page comes up and how much of the window it fills, the chapters beside it, the pages two at a time, a print dialog already filled in — every one of them a wish reading software answers for itself.

Links and Marks on Placed Text

Links and marks hung on text the engine has already placed: a band behind a line, an underline, a boxed cell — every rectangle taken from what the layout and the table report afterwards, none of it measured by hand.

Custom Page Labels

Fourteen pages numbered by their labels rather than their position: small and capital roman numerals, ordinary figures, letters, a prefix before figures or letters, and a back cover labelled with the prefix alone.

A Story That Carries on Further In

Two stories over two pages: each one begins in a column of the front page and carries on in a column of the second, and the two swap sides on the way. The file says which column follows which, so reading software goes on with the story it is on.

Codes That Name Their Character Set

Nine codes whose bytes say which character set they are written in, so Greek comes back as Greek and Cyrillic as Cyrillic, whatever set the scanner would have fallen back on.

Every example, by subject