X-Git-Url: https://jxself.org/git/?p=ibg.git;a=blobdiff_plain;f=about.rst;h=ed87193f9cac1e201af12f40fbde83a5bf8bd43b;hp=9c8f55e80e12152c179a1b5332b10b31e245acac;hb=fd8f547191457928785b8bc38570b05205f369ac;hpb=9e9feffd79cc1c4aa9c387afe98e16c7fbfae78d diff --git a/about.rst b/about.rst index 9c8f55e..ed87193 100644 --- a/about.rst +++ b/about.rst @@ -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. @@ -214,11 +214,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. @@ -239,7 +234,6 @@ eventually of presenting, the Inform text adventure development system. .. [#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.