Fix up the remaining hardcoded page refs.
[ibg.git] / chapters / 02.rst
index ee0b5b20081f17e5f5b2c4a657e4c45a88589813..950db122ced9e4b308b014e82dd29ab3d6adb463 100644 (file)
@@ -4,19 +4,15 @@
 
 .. epigraph::
 
-   | *C was a captain, all covered with lace;*
-   | *D was a drunkard, and had a red face.*
+   | |CENTER| *C was a captain, all covered with lace;*
+   | |CENTER| *D was a drunkard, and had a red face.*
 
 .. only:: html
 
   .. image:: /images/picC.png
      :align: left
 
-.. raw:: latex
-
-   \dropcap{c}
-
-onventional -- static -- fiction can be written using nothing more than
+|C|\onventional -- static -- fiction can be written using nothing more than
 pencil and paper, or typewriter, or word-processor; however, the
 requirements for producing IF are a little more extensive, and the creative
 process slightly more complex.
@@ -99,17 +95,17 @@ no fancy formatting features, no bold or italics or font control, no
 embedded graphics; it simply enables you to type lines of text, which is
 exactly what's needed to create an IF game.
 
-If you look at the game source on the previous page, or in
-:doc:`/appendices/c`, you'll notice ``Include "Parser";`` and ``Include
-"VerbLib";`` a few lines down from the top of the file.  These are
-instructions to the Inform compiler to "include" -- that is, to merge in
-the contents -- of files called ``Parser.h`` and ``VerbLib.h``.  These are
-not files which you have to create; they're standard :term:`library files`,
-part of the Inform system.  All that you have to do is remember to Include
-them in every game that you write.  Until you've a fair understanding of
-how Inform works, you've no need to worry about what they contain (though
-you can look if you want to: they're readable text files, just like the
-ones this guide will teach you to write).
+If you look at the game source above, or in :doc:`/appendices/c`, you'll
+notice ``Include "Parser";`` and ``Include "VerbLib";`` a few lines down
+from the top of the file.  These are instructions to the Inform compiler to
+"include" -- that is, to merge in the contents -- of files called
+``Parser.h`` and ``VerbLib.h``.  These are not files which you have to
+create; they're standard :term:`library files`, part of the Inform system.
+All that you have to do is remember to Include them in every game that you
+write.  Until you've a fair understanding of how Inform works, you've no
+need to worry about what they contain (though you can look if you want to:
+they're readable text files, just like the ones this guide will teach you
+to write).
 
 So, we've now introduced all of the bits and pieces which you need in order to
 write an Inform adventure game:
@@ -171,12 +167,12 @@ Follow these steps:
    In order to make the download small and fast, these folders include just
    enough to get you started as an Inform designer -- the compiler and
    interpreter programs, the library files, the ``Ruins.inf`` example file
-   from the *Inform Designer's Manual*, and a template for your own first
-   game.  A few other folders are included as placeholders where you could
-   later download additional components, if you wanted them.  As soon as
-   possible, you should download the *Inform Designer's Manual* into the
-   ``Inform\Doc`` folder -- it's an essential document to have, and has
-   been omitted from this download only because of its 3MB size.
+   from the |DM4|, and a template for your own first game.  A few other
+   folders are included as placeholders where you could later download
+   additional components, if you wanted them.  As soon as possible, you
+   should download the |DM4| into the ``Inform\Doc`` folder -- it's an
+   essential document to have, and has been omitted from this download only
+   because of its 3MB size.
 
 3. To verify that the downloaded files work properly, use Windows Explorer
    to display the contents of the ``Inform\Games\MyGame1`` folder: you will
@@ -235,7 +231,7 @@ Follow these steps:
 
 9. Using the same techniques, you can compile and play ``Ruins.inf``, which
    is held in the ``Inform\Games\Download`` folder.  RUINS is the game used
-   as an example throughout the *Inform Designer's Manual*.
+   as an example throughout the |DM4|.
 
 .. rubric:: Setting file associations
 
@@ -316,8 +312,8 @@ doing.  There are four parts to the first line:
    .. note::
 
       On the command line, you sometimes also see a compiler :term:`switch`
-      such as ``-S``, used for controlling detailed aspects of how the
-      compiler operates.  Rather than do that here, we find it more
+      such as :option:`-S`, used for controlling detailed aspects of how
+      the compiler operates.  Rather than do that here, we find it more
       convenient to place any necessary switches at the very top of the
       source file, as we'll explain in the next chapter.
 
@@ -423,13 +419,13 @@ Follow these steps:
    In order to make the download small and fast, these folders include just
    enough to get you started as an Inform designer -- the compiler and
    interpreter programs, the library files, the ``Ruins.inf`` example from
-   the *Inform Designer's Manual*, and a template for your own first game,
-   which you may copy and rename each time you begin a new Inform project.
-   A few other folders are included as placeholders where you could later
-   download additional components, if you wanted them.  As soon as
-   possible, you should download the *Inform Designer's Manual* into the
-   ``Inform/Doc`` folder -- it's an essential document to have, and has
-   been omitted from this download only because of its 3MB size.
+   the |DM4|, and a template for your own first game, which you may copy
+   and rename each time you begin a new Inform project.  A few other
+   folders are included as placeholders where you could later download
+   additional components, if you wanted them.  As soon as possible, you
+   should download the |DM4| into the ``Inform/Doc`` folder -- it's an
+   essential document to have, and has been omitted from this download only
+   because of its 3MB size.
 
 3. To verify that the downloaded files work properly, use the Finder to
    display the contents of the ``Inform/Games/MyGame1`` folder: you will see
@@ -605,8 +601,8 @@ There are three parts to the second line:
    .. note::
 
       On the command line, you sometimes also see a compiler :term:`switch`
-      such as ``-S``, used for controlling detailed aspects of how the
-      compiler operates.  Rather than do that here, we find it more
+      such as :option:`-S`, used for controlling detailed aspects of how
+      the compiler operates.  Rather than do that here, we find it more
       convenient to place any necessary switches at the very top of the
       source file, as we'll explain in the next chapter.