X-Git-Url: https://jxself.org/git/?a=blobdiff_plain;f=about.rst;h=aa6f5c93e5f24adfe6d2f7da6d6fba4b411a0d17;hb=0d516f59baf6cdad07fe8f00264da39ddd8b0ebb;hp=32e58f2b31b423c7169e49d92c7244a6eb58284f;hpb=e0b6ffefd08041869d6d78a5cbefdab1ddec2996;p=ibg.git diff --git a/about.rst b/about.rst index 32e58f2..aa6f5c9 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. @@ -58,13 +58,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 +92,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 + + 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: - 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. + :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,8 +141,8 @@ 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/ @@ -168,7 +168,7 @@ 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` The Usenet newsgroup for authors of IF, commonly known by the abbreviation RAIF. Here you'll find discussion on IF technology, @@ -176,7 +176,7 @@ 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` The complementary newsgroup for IF *players*, often known as RGIF. @@ -222,19 +222,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.