X-Git-Url: https://jxself.org/git/?p=ibg.git;a=blobdiff_plain;f=about.rst;h=0cbd9d3a460b27fa303550f635628ff0ecb88246;hp=9c8f55e80e12152c179a1b5332b10b31e245acac;hb=4381288eeb792adb3672ef747013c02815fa760a;hpb=9e9feffd79cc1c4aa9c387afe98e16c7fbfae78d diff --git a/about.rst b/about.rst index 9c8f55e..0cbd9d3 100644 --- a/about.rst +++ b/about.rst @@ -6,8 +6,8 @@ .. epigraph:: - | *If they asked me, I could write a book;* - | *About the way you TALK, and LISTEN; And LOOK.* + | |CENTER| *If they asked me, I could write a book;* + | |CENTER| *About the way you TALK, and LISTEN; And LOOK.* -- with apologies to Richard Rodgers and Lorenz Hart. @@ -30,6 +30,10 @@ and writing tutorials and reviews, these enthusiasts have led a revival responsible for many notable works, including some whose quality arguably surpasses that of the best commercial titles of the 1980s. +.. Generated by autoindex +.. index:: + single: TADS + Nowadays, IF is a hobby; almost everything that you need to begin writing your own text adventures is available, for free, on the Internet. While expert programmers may relish the considerable challenge of creating @@ -58,13 +62,13 @@ Scope and approach Because this is only an introduction to Inform, many features are treated rather superficially, or ignored altogether. The definitive text is Graham -Nelson's Inform *Designer's Manual* (Fourth Edition, July 2001), commonly -known as the DM4; you cannot hope to use Inform successfully without having -this splendid book by your side. Our guide should be seen merely as a -supplement to the DM4, offering step-by-step descriptions of those aspects -of Inform which are most important on first acquaintance. In any matter -where we seem at odds with what Graham has written, you should assume that -he is right and that we are, well, confused. +Nelson's |DM4| (Fourth Edition, July 2001), commonly known as the DM4; you +cannot hope to use Inform successfully without having this splendid book by +your side. Our guide should be seen merely as a supplement to the DM4, +offering step-by-step descriptions of those aspects of Inform which are +most important on first acquaintance. In any matter where we seem at odds +with what Graham has written, you should assume that he is right and that +we are, well, confused. As a tutorial, this guide is intended to be printed out and then read sequentially; it isn't meant for online usage or designed as a reference @@ -92,22 +96,22 @@ Presentation and style Most of the guide's text appears in this typeface, except where we're using words which are part of the Inform system (like ``print``, ``Include``, ``VerbLib``) or are extracted from one of our games (like ``bird``, -``nest``, ``top_of_tree``). Terms in **bold type** are included in the -glossary -- Appendix G on page 273. We switch to italic type for a -placeholder: for example you should read the Inform statement: +``nest``, ``top_of_tree``). -.. parsed-literal:: +.. only:: html - print "*string*"; + Terms that are included in the :doc:`Glossary ` appear as + links to that glossary entry. -.. todo:: +.. only:: latex - The above will not render correctly in PDF. In PDF the leading - quotes always appear with at least one backquote. At the moment, the - best solution I can think up is to have a script fire off after LaTeX - generation to take care of this problem so that when the LaTeX code - is compiled, we'll get the correct glyphs. At the moment, I don't - know how to make such a script automatically run. + Terms that are included in the :doc:`Glossary ` appear in + blue italic. In the PDF version, these are links to the glossary entry. + +We switch to italic type for a placeholder: for example you should read the +Inform statement: + + :samp:`print "{string}";` as meaning "display on the player's screen the arbitrary character or characters which are represented here by the placeholder *string*". @@ -141,11 +145,15 @@ locations: * http://www.inform-fiction.org/ The Inform home page, maintained by Graham Nelson and a small team of - helpers. Most important, this is where you can find the *Inform - Designer's Manual* in PDF format. + helpers. Most important, this is where you can find the |DM4| in PDF + format. * http://mirror.ifarchive.org/ + .. Generated by autoindex + .. index:: + single: IF Archive + The IF Archive (or actually a high-speed mirror copy of it), from which you can download almost anything that's free and in the public domain. For a clickable map of Inform-related parts of the Archive, see @@ -168,7 +176,11 @@ locations: A more general list of FAQs about IF authorship, covering both Inform and the other main systems. -* news:rec.arts.int-fiction +* :newsgroup:`rec.arts.int-fiction` + + .. Generated by autoindex + .. index:: + single: RAIF The Usenet newsgroup for authors of IF, commonly known by the abbreviation RAIF. Here you'll find discussion on IF technology, @@ -176,7 +188,11 @@ locations: assistance with your own "how do I..." questions (but please, look in the manual first). -* news:rec.games.int-fiction +* :newsgroup:`rec.games.int-fiction` + + .. Generated by autoindex + .. index:: + single: RGIF The complementary newsgroup for IF *players*, often known as RGIF. @@ -214,11 +230,6 @@ The drop capitals, and their associated poem, are from "A Picture Alphabet", digitised from a collection of public domain woodcuts, circa 1834, by Steven J. Lundeen of emerald city fontwerks. -.. todo:: - - Reference to the drop-caps should only apply to those places they're - used (just the PDF?). - All credit to the generosity of http://briefcase.yahoo.com/ for making international file-sharing such a breeze. @@ -227,19 +238,18 @@ for devising it all, thereby giving us the opportunity -- first independently and later in enjoyable collaboration -- of using, and eventually of presenting, the Inform text adventure development system. -| *Roger Firth* -| *Wallingford, England* +| |FILL| *Roger Firth* +| |FILL| *Wallingford, England* -| *Sonja Kesserich* -| *Madrid, Spain* +| |FILL| *Sonja Kesserich* +| |FILL| *Madrid, Spain* -| *August 2004* +| |FILL| *August 2004* .. rubric:: Footnotes .. [#play] If you feel confused about IF in general or about this distinction - between writing and playing in particular, try glancing ahead at "Just - what is interactive fiction?" on page 13 and at "How to play an IF game" - on page 209; also, you may find the Ifaq at - http://www.plover.net/~textfire/raiffaq/ifaq/ helpful. + between writing and playing in particular, try glancing ahead at + :doc:`chapters/01` and at :doc:`appendices/a`; also, you may find the + Ifaq at http://www.plover.net/~textfire/raiffaq/ifaq/ helpful.