Let's change our first passage so it reads:
:: Start
It's a dark and stormy night aboard the Orient Express. You can't sleep; something about the motion of the train disturbed you subtly. So instead you have elected to spend the night in the dining car, sipping coffee and perusing [[the newspaper]].
You hear the door to the car open behind you, but you don't look up at first.
The double brackets around the phrase the newspaper creates a link to another passage. By default, the names must match exactly, so if we had written a passage named THE NEWSPAPER, or even The newspaper, we would run into problems. Broken links have a pink background when you're viewing your story, and show this message when they're clicked:
The passage 'The newspaper' doesn't exist.
In some cases, you may not want to match names exactly. You can add a second part to your link to make passages fit together better:
:: Start
It's a dark and stormy night aboard the Orient Express. You can't sleep; something about the motion of the train disturbed you subtly. So instead you have elected to spend the night in the dining car, sipping coffee and perusing [[the newspaper|The London Times]].
You hear the door to the car open behind you, but you don't look up at first.
:: The London Times
If you believe what you read, the world is quiet. The London Times' front page is awash in some lurid tale of a fellow named John Lee whose execution failed thrice, and thus proven innocent -- or at least innocent enough to serve a life sentence.
The | character (sometimes called a pipe) acts as a separator between the text to display and the passage to link to. It can be easy to forget the order of these two things; one way to remember it is to say to yourself, "This text links to this passage."
You can also use a pipe character to link to an external Web page. For example, if we wanted to link to the Wikipedia article on John Lee, we could rewrite the newspaper passage to read:
:: The London Times
If you believe what you read, the world is quiet. The London Times' front page is awash in some lurid tale of a fellow named [[John Lee|http://en.wikipedia.org/wiki/John_%27Babbacombe%27_Lee]] whose execution failed thrice, and thus proven innocent -- or at least innocent enough to serve a life sentence.
You can use any kind of address that a Web browser would understand. For example, if you wanted to create a link that let your readers email you, you could write [[Contact me|mailto:my@email.address]].
Now that we've added some links to our story, try compiling your source code again. You should be able to click between them now, and the Bookmark and Rewind to Here links on each passage should have noticeable effects.