Move manual ingredients all into one directory

doc/manual.rst → doc/manual/manual.rst

@@ -80,7 +80,7 @@ The user's file at ``~/.rst2pdf/config`` will have priority over the system's at
 Here's an example file showing some of the currently available options:
 
 .. code-block:: ini
-   :include: config.sample
+   :include: includes/config.sample
 
 Pipe usage
 ==========
@@ -154,11 +154,11 @@ You can insert images in the middle of your text like this::
 
   This |biohazard| means you have to run.
 
-  .. |biohazard| image:: ../rst2pdf/tests/input/images/biohazard.png
+  .. |biohazard| image:: images/biohazard.png
 
 This |biohazard| means you have to run.
 
-.. |biohazard| image:: ../rst2pdf/tests/input/images/biohazard.png
+.. |biohazard| image:: images/biohazard.png
 
 This only works correctly with reportlab 2.2 or later.
 
@@ -1074,14 +1074,14 @@ the options are:
 Let's display a class from rst2pdf::
 
       .. code-block:: python
-         :include: ../rst2pdf/flowables.py
+         :include: includes/flowables.py
          :start-at: class Separation(Flowable):
          :end-before: class Reference(Flowable):
 
 this command gives
 
 .. code-block:: python
-    :include: ../rst2pdf/flowables.py
+    :include: includes/flowables.py
     :start-at: class Separation(Flowable):
     :end-before: class Reference(Flowable):
 
@@ -1381,6 +1381,17 @@ as text, the math role embeds an image. That means:
 
 So, use it only in emergencies ;-)
 
+You can also use an inline substitution of the math directive for things you use often,
+which is the same as using the math role::
+
+    This is the square of x: |xsq|
+
+    .. |xsq| math:: x^2
+
+This is the square of x: |xsq|
+
+.. |xsq| math:: x^2
+
 You don't need to worry about fonts, the correct math fonts will be used and embedded in
 your PDF automatically (they are included with matplotlib).
 
@@ -1810,30 +1821,30 @@ Several are included with rst2pdf.
 Preprocess (``-e preprocess``)
 ------------------------------
 
-.. include:: ../rst2pdf/extensions/preprocess_r2p.py
+.. include:: ../../rst2pdf/extensions/preprocess_r2p.py
    :start-after:  '''
    :end-before: '''
 
 Inkscape (``-e inkscape``)
 --------------------------
 
-.. include:: ../rst2pdf/extensions/inkscape_r2p.py
+.. include:: ../../rst2pdf/extensions/inkscape_r2p.py
    :start-after:  '''
    :end-before: '''
 
 
 Dotted_TOC (``-e dotted_toc``)
 ------------------------------
 
-.. include:: ../rst2pdf/extensions/dotted_toc.py
+.. include:: ../../rst2pdf/extensions/dotted_toc.py
    :start-after:  '''
    :end-before: '''
 
 
 Developers
 ==========
 
-.. include:: DEVELOPERS.rst
+.. include:: ../DEVELOPERS.rst
    :start-line: 8
 
 

doc/manual.style → doc/manual/manual.style

@@ -7,7 +7,7 @@
         "frames": [
             ["0cm", "0cm", "100%", "100%"]
           ],
-        "background" : "biohazard.pdf",
+        "background" : "images/biohazard.pdf",
         "showHeader" : false,
         "showFooter" : false
     }