
| If you are | Read |
|---|---|
| New to interactive fiction, or new to writing it | The chapters in order, skipping every boxed note. |
| An author who knows Inform or TADS | The chapters in order, with the boxes headed “From another system”. |
| Curious about what the platform does with your lines | The chapters in order, with the boxes headed “Under the Hood”. |
| Looking something up | The table of contents, and the appendices at the back. |
The chapters build on one another, and the story grows through them, so the book works best read from the front. Part I is short and gets a story on the screen. If you read nothing else before starting a story of your own, read Parts I and II.
The main text is complete without either kind of box. Skip them freely.
Under the Hood: what this box is for
A box like this one names the part of the Sharpee platform that a Chord line becomes: a trait, a standard action, an event, a message. It is for readers who also write for the platform directly, or who like to know what is underneath. Nothing later in the book depends on it.
From another system: what this box is for
A box like this one compares Chord with Inform 10 and TADS 3, and with no other system. It is for authors who already think in one of them. Each statement it makes about either system was checked against that system’s own documentation.
Lines of Chord appear in blocks like this one.
create the Lodge, a room
Commands for your terminal appear in their own blocks, and so does
what the story prints. In a block of story output, a line that begins
with > is a command the player typed.
> take lamp
You take it.
A block of Chord is sometimes a whole declaration and sometimes the few lines of one that the chapter is talking about. The prose says which lines are new, and the companion folder for the chapter always has the whole story.
In a story file the end of a line means something, and some lines are
longer than a printed page is wide. When the page has to break such a
line, the continuation begins with the mark ↪, set under
the start of the line it continues.
description: Thirty years after the magic went out of the world, a lamp burns blue.
Type a marked row on the same line as the row above it, with one space where the page broke it, and leave the mark out. On a screen the line is not broken and there is no mark. Story output is prose, and the page wraps it as it wraps any paragraph.
Most chapters end with a section called “Build and try it”, which
gives the sharpee commands that compile and play the
chapter’s story in a terminal. Chord Writer, the editor made for Chord,
does the same work from one window. The story file is the same in both,
and chapter 4 introduces the two.
The Relighting as it stands at the end of each chapter is on the
book’s website, in a folder named for the chapter:
chapter-05, chapter-06, and so on. The folders
are at this address:
Each one can be read in a browser, file by file, and each can be
downloaded whole by adding .zip to its name:
A folder holds the story file and a test tree, which chapter 38
explains, and from Part VII on it holds the story’s sounds, picture and
stylesheet as well. Beside them are eight folders named
part-1 to part-8, each holding the story as it
stands at the end of that part. No step in this book uses those.
You need the folders to follow the book. A chapter prints the lines
it teaches. It does not print every line of the story, because a page of
descriptions teaches nothing about Chord. Part I’s story is short, and
you type all of it. From chapter 5 on, each chapter’s “Build and try it”
begins by copying that chapter’s relighting.story from its
folder over your own, so that your story is the book’s at the end of
every chapter. The same section lists what changed, for the reader who
would sooner make the changes by hand and take only the unprinted lines
from the file.
A few chapters say plainly that a part of the language is not covered, because it could not be shown working in this edition. That is a statement about the edition and not about your story. The language’s reference material lists every form, and a later edition of this book will cover what this one could not.