Commits

Dinu Gherman  committed c7293cb

Fixed ReST markup issues.

  • Participants
  • Parent commits a323b43

Comments (0)

Files changed (4)

File INSTALL.html

 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
+<meta name="generator" content="Docutils 0.9.1: http://docutils.sourceforge.net/" />
 <title>Pdfgrid</title>
 <meta name="author" content="Dinu Gherman &lt;gherman&#64;darwin.in-berlin.de&gt;" />
 <meta name="date" content="2009-06-07" />
 
 /*
 :Author: David Goodger (goodger@python.org)
-:Id: $Id: html4css1.css 5196 2007-06-03 20:25:28Z wiemann $
+:Id: $Id: html4css1.css 7434 2012-05-11 21:06:27Z milde $
 :Copyright: This stylesheet has been placed in the public domain.
 
 Default cascading style sheet for the HTML output of Docutils.
 dl.docutils dd {
   margin-bottom: 0.5em }
 
+object[type="image/svg+xml"], object[type="application/x-shockwave-flash"] {
+  overflow: hidden;
+}
+
 /* Uncomment (and remove this text!) to get bold-faced definition list terms
 dl.docutils dt {
   font-weight: bold }
 hr.docutils {
   width: 75% }
 
-img.align-left {
-  clear: left }
+img.align-left, .figure.align-left, object.align-left {
+  clear: left ;
+  float: left ;
+  margin-right: 1em }
 
-img.align-right {
-  clear: right }
+img.align-right, .figure.align-right, object.align-right {
+  clear: right ;
+  float: right ;
+  margin-left: 1em }
+
+img.align-center, .figure.align-center, object.align-center {
+  display: block;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+.align-left {
+  text-align: left }
+
+.align-center {
+  clear: both ;
+  text-align: center }
+
+.align-right {
+  text-align: right }
+
+/* reset inner alignment in figures */
+div.align-right {
+  text-align: inherit }
+
+/* div.align-center * { */
+/*   text-align: left } */
 
 ol.simple, ul.simple {
   margin-bottom: 1em }
 pre.address {
   margin-bottom: 0 ;
   margin-top: 0 ;
-  font-family: serif ;
-  font-size: 100% }
+  font: inherit }
 
-pre.literal-block, pre.doctest-block {
+pre.literal-block, pre.doctest-block, pre.math, pre.code {
   margin-left: 2em ;
   margin-right: 2em }
 
+pre.code .ln { /* line numbers */
+  color: grey;
+}
+
+.code {
+  background-color: #eeeeee
+}
+
 span.classifier {
   font-family: sans-serif ;
   font-style: oblique }
 <!-- -*- mode: rst -*- -->
 <div class="section" id="installation">
 <h1>Installation</h1>
-<p>There are two ways to install <cite>pdfgrid</cite>, depending on whether you have
-the <cite>easy_install</cite> command available on your system or not.</p>
+<p>There are two ways to install <em>pdfgrid</em>, depending on whether you have
+the <tt class="docutils literal">easy_install</tt> command available on your system or not.</p>
 <div class="section" id="using-easy-install">
-<h2>1. Using <cite>easy_install</cite></h2>
-<p>With the <cite>easy_install</cite> command on your system and a working internet
-connection you can install <cite>pdfgrid</cite> with only one command in a terminal:</p>
+<h2>1. Using <em>easy_install</em></h2>
+<p>With the <tt class="docutils literal">easy_install</tt> command on your system and a working internet
+connection you can install <em>pdfgrid</em> with only one command in a terminal:</p>
 <pre class="literal-block">
 $ easy_install pdfgrid
 </pre>
-<p>If the <cite>easy_install</cite> command is not available to you and you want to
-install it before installing <cite>pdfgrid</cite>, you might want to go to the
+<p>If the <tt class="docutils literal">easy_install</tt> command is not available to you and you want to
+install it before installing <em>pdfgrid</em>, you might want to go to the
 <a class="reference external" href="http://peak.telecommunity.com/DevCenter/EasyInstall">Easy Install homepage</a>
 and follow the <a class="reference external" href="http://peak.telecommunity.com/DevCenter/EasyInstall#installing-easy-install">instructions there</a>.</p>
 </div>
 <div class="section" id="manual-installation">
 <h2>2. Manual installation</h2>
-<p>Alternatively, you can install the <cite>pdfgrid</cite> tarball after downloading
+<p>Alternatively, you can install the <em>pdfgrid</em> tarball after downloading
 the file <tt class="docutils literal"><span class="pre">pdfgrid-0.2.0.tar.gz</span></tt> and decompressing it with the following
 command:</p>
 <pre class="literal-block">
 $ tar xfz pdfgrid-0.2.0.tar.gz
 </pre>
-<p>Then change into the newly created directory <tt class="docutils literal"><span class="pre">pdfgrid</span></tt> and install
-<cite>pdfgrid</cite> by running the following command:</p>
+<p>Then change into the newly created directory <tt class="docutils literal">pdfgrid</tt> and install
+<em>pdfgrid</em> by running the following command:</p>
 <pre class="literal-block">
 $ python setup.py install
 </pre>
-<p>This will install a Python module file named <tt class="docutils literal"><span class="pre">pdfgrid.py</span></tt> in the
+<p>This will install a Python module file named <tt class="docutils literal">pdfgrid.py</tt> in the
 <tt class="docutils literal"><span class="pre">site-packages</span></tt> subfolder of your Python interpreter and a script
-tool named <tt class="docutils literal"><span class="pre">pdfgrid</span></tt> in your <tt class="docutils literal"><span class="pre">bin</span></tt> directory, usually in
-<tt class="docutils literal"><span class="pre">/usr/local/bin</span></tt>.</p>
+tool named <tt class="docutils literal">pdfgrid</tt> in your <tt class="docutils literal">bin</tt> directory, usually in
+<tt class="docutils literal">/usr/local/bin</tt>.</p>
 </div>
 </div>
 </div>
 Installation
 ------------
 
-There are two ways to install `pdfgrid`, depending on whether you have
-the `easy_install` command available on your system or not.
+There are two ways to install *pdfgrid*, depending on whether you have
+the ``easy_install`` command available on your system or not.
 
-1. Using `easy_install`
+1. Using *easy_install*
 ++++++++++++++++++++++++
 
-With the `easy_install` command on your system and a working internet 
-connection you can install `pdfgrid` with only one command in a terminal::
+With the ``easy_install`` command on your system and a working internet 
+connection you can install *pdfgrid* with only one command in a terminal::
 
   $ easy_install pdfgrid
 
-If the `easy_install` command is not available to you and you want to
-install it before installing `pdfgrid`, you might want to go to the 
+If the ``easy_install`` command is not available to you and you want to
+install it before installing *pdfgrid*, you might want to go to the 
 `Easy Install homepage <http://peak.telecommunity.com/DevCenter/EasyInstall>`_ 
 and follow the `instructions there <http://peak.telecommunity.com/DevCenter/EasyInstall#installing-easy-install>`_.
 
 2. Manual installation
 +++++++++++++++++++++++
 
-Alternatively, you can install the `pdfgrid` tarball after downloading 
+Alternatively, you can install the *pdfgrid* tarball after downloading 
 the file ``pdfgrid-0.2.0.tar.gz`` and decompressing it with the following 
 command::
 
   $ tar xfz pdfgrid-0.2.0.tar.gz
 
 Then change into the newly created directory ``pdfgrid`` and install 
-`pdfgrid` by running the following command::
+*pdfgrid* by running the following command::
 
   $ python setup.py install
   
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
+<meta name="generator" content="Docutils 0.9.1: http://docutils.sourceforge.net/" />
 <title>Pdfgrid</title>
 <meta name="author" content="Dinu Gherman &lt;gherman&#64;darwin.in-berlin.de&gt;" />
 <meta name="date" content="2009-06-07" />
 
 /*
 :Author: David Goodger (goodger@python.org)
-:Id: $Id: html4css1.css 5196 2007-06-03 20:25:28Z wiemann $
+:Id: $Id: html4css1.css 7434 2012-05-11 21:06:27Z milde $
 :Copyright: This stylesheet has been placed in the public domain.
 
 Default cascading style sheet for the HTML output of Docutils.
 dl.docutils dd {
   margin-bottom: 0.5em }
 
+object[type="image/svg+xml"], object[type="application/x-shockwave-flash"] {
+  overflow: hidden;
+}
+
 /* Uncomment (and remove this text!) to get bold-faced definition list terms
 dl.docutils dt {
   font-weight: bold }
 hr.docutils {
   width: 75% }
 
-img.align-left {
-  clear: left }
+img.align-left, .figure.align-left, object.align-left {
+  clear: left ;
+  float: left ;
+  margin-right: 1em }
 
-img.align-right {
-  clear: right }
+img.align-right, .figure.align-right, object.align-right {
+  clear: right ;
+  float: right ;
+  margin-left: 1em }
+
+img.align-center, .figure.align-center, object.align-center {
+  display: block;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+.align-left {
+  text-align: left }
+
+.align-center {
+  clear: both ;
+  text-align: center }
+
+.align-right {
+  text-align: right }
+
+/* reset inner alignment in figures */
+div.align-right {
+  text-align: inherit }
+
+/* div.align-center * { */
+/*   text-align: left } */
 
 ol.simple, ul.simple {
   margin-bottom: 1em }
 pre.address {
   margin-bottom: 0 ;
   margin-top: 0 ;
-  font-family: serif ;
-  font-size: 100% }
+  font: inherit }
 
-pre.literal-block, pre.doctest-block {
+pre.literal-block, pre.doctest-block, pre.math, pre.code {
   margin-left: 2em ;
   margin-right: 2em }
 
+pre.code .ln { /* line numbers */
+  color: grey;
+}
+
+.code {
+  background-color: #eeeeee
+}
+
 span.classifier {
   font-family: sans-serif ;
   font-style: oblique }
 <!-- -*- mode: rst -*- -->
 <div class="section" id="about">
 <h1>About</h1>
-<p><cite>Pdfgrid</cite> is a Python command-line tool and module for adding a regular
+<p><em>Pdfgrid</em> is a Python command-line tool and module for adding a regular
 grid on top of all pages of an exiwsting PDF document. It will mostly be
 used for measuring individual parts of PDF pages like graphics or paragraph
 widths. For the time being, only a rectangular grid with major and minor
 <p>NOTE: This is an initial release. The API is likely to change and for the
 time being the grid size is limited to A4, but this will change in future
 releases.</p>
-<p><cite>Pdfgrid</cite> depends on two Open Source libraries, namely
+<p><em>Pdfgrid</em> depends on two Open Source libraries, namely
 <a class="reference external" href="http://pypi.python.org/pypi/pyPdf">pyPdf</a>, a package written by
 Mathieu Fenniak and <a class="reference external" href="http://www.reportlab.org/downloads.html">reportlab</a>
 by ReportLab, Ltd.</p>
 <li>define grid origin on all PDF pages</li>
 <li>define grid styles containing grid step, line width and colour</li>
 <li>use multiple grids at once with different styling</li>
-<li>install a Python module named <tt class="docutils literal"><span class="pre">pdfgrid.py</span></tt></li>
-<li>install a Python command-line script named <tt class="docutils literal"><span class="pre">pdfgrid</span></tt></li>
+<li>install a Python module named <tt class="docutils literal">pdfgrid.py</tt></li>
+<li>install a Python command-line script named <tt class="docutils literal">pdfgrid</tt></li>
 <li>provide a Unittest test suite</li>
 </ul>
 </div>
 &gt;&gt;&gt; grid(&quot;foo.pdf&quot;, origin=(0, 0), styles=[(1*cm, 0.1, red)])
 written: foo-grid.pdf
 </pre>
-<p>In addition there is a script named <tt class="docutils literal"><span class="pre">pdfscript</span></tt>, which can be used
+<p>In addition there is a script named <tt class="docutils literal">pdfscript</tt>, which can be used
 from the system command-line e.g. like this:</p>
 <pre class="literal-block">
 $ pdfgrid -h
 </div>
 <div class="section" id="installation">
 <h1>Installation</h1>
-<p>There are two ways to install <cite>pdfgrid</cite>, either as a so-called Python <em>egg</em>
-via the <tt class="docutils literal"><span class="pre">easy_install</span></tt> command, if available on your system, or from
-a source tarball. Please see the seperate file <tt class="docutils literal"><span class="pre">INSTALL.txt</span></tt> for more
+<p>There are two ways to install <em>pdfgrid</em>, either as a so-called Python <em>egg</em>
+via the <tt class="docutils literal">easy_install</tt> command, if available on your system, or from
+a source tarball. Please see the seperate file <tt class="docutils literal">INSTALL.txt</tt> for more
 detailed instructions!</p>
 </div>
 <div class="section" id="dependencies">
 <h1>Dependencies</h1>
-<p><cite>Pdfgrid</cite> depends on <cite>pyPdf</cite> which, if missing, will miraculously be
-installed together with <cite>pdfgrid</cite> if you have a working internet
+<p><em>Pdfgrid</em> depends on <em>pyPdf</em> which, if missing, will miraculously be
+installed together with <em>pdfgrid</em> if you have a working internet
 connection during the installation procedure. If for whatever reason
-<cite>pyPdf</cite> cannot be installed, <cite>pdfgrid</cite> should still install fine.
-In this case you'll get a warning when trying to run <cite>pdfgrid</cite>.</p>
-<p><cite>PyPdf</cite> also needs the <a class="reference external" href="http://www.reportlab.org/downloads.html">ReportLab toolkit</a> to be installed,
-which unfortunately cannot be installed yet as a Python <strong>egg</strong>.</p>
+<em>pyPdf</em> cannot be installed, <em>pdfgrid</em> should still install fine.
+In this case you'll get a warning when trying to run <em>pdfgrid</em>.</p>
+<p><em>PyPdf</em> also needs the <a class="reference external" href="http://www.reportlab.org/downloads.html">ReportLab toolkit</a> to be installed,
+which unfortunately cannot be installed yet as a Python <em>egg</em>.</p>
 </div>
 <div class="section" id="testing">
 <h1>Testing</h1>
-<p>The <cite>pdfgrid</cite> tarball distribution contains a Unittest test suite
-in the folder <tt class="docutils literal"><span class="pre">src/test</span></tt> which can be run like shown in the
+<p>The <em>pdfgrid</em> tarball distribution contains a Unittest test suite
+in the folder <tt class="docutils literal">src/test</tt> which can be run like shown in the
 following lines on the system command-line:</p>
 <pre class="literal-block">
 $ tar xfz pdfgrid-0.2.0.tar.gz
 About
 -----
 
-`Pdfgrid` is a Python command-line tool and module for adding a regular 
+*Pdfgrid* is a Python command-line tool and module for adding a regular 
 grid on top of all pages of an exiwsting PDF document. It will mostly be 
 used for measuring individual parts of PDF pages like graphics or paragraph 
 widths. For the time being, only a rectangular grid with major and minor 
 time being the grid size is limited to A4, but this will change in future 
 releases.
 
-`Pdfgrid` depends on two Open Source libraries, namely 
+*Pdfgrid* depends on two Open Source libraries, namely 
 `pyPdf <http://pypi.python.org/pypi/pyPdf>`_, a package written by 
 Mathieu Fenniak and `reportlab <http://www.reportlab.org/downloads.html>`_ 
 by ReportLab, Ltd.
 Installation
 ------------
 
-There are two ways to install `pdfgrid`, either as a so-called Python *egg* 
+There are two ways to install *pdfgrid*, either as a so-called Python *egg* 
 via the ``easy_install`` command, if available on your system, or from 
 a source tarball. Please see the seperate file ``INSTALL.txt`` for more 
 detailed instructions! 
 Dependencies
 ------------
 
-`Pdfgrid` depends on `pyPdf` which, if missing, will miraculously be 
-installed together with `pdfgrid` if you have a working internet 
+*Pdfgrid* depends on *pyPdf* which, if missing, will miraculously be 
+installed together with *pdfgrid* if you have a working internet 
 connection during the installation procedure. If for whatever reason 
-`pyPdf` cannot be installed, `pdfgrid` should still install fine. 
-In this case you'll get a warning when trying to run `pdfgrid`.
+*pyPdf* cannot be installed, *pdfgrid* should still install fine. 
+In this case you'll get a warning when trying to run *pdfgrid*.
 
-`PyPdf` also needs the `ReportLab toolkit 
+*PyPdf* also needs the `ReportLab toolkit 
 <http://www.reportlab.org/downloads.html>`_ to be installed, 
 which unfortunately cannot be installed yet as a Python **egg**.
 
 Testing
 -------
 
-The `pdfgrid` tarball distribution contains a Unittest test suite 
+The *pdfgrid* tarball distribution contains a Unittest test suite 
 in the folder ``src/test`` which can be run like shown in the 
 following lines on the system command-line::