restructured documents according to documentation writing guidelines

about_mapnik.rst

@@ -1,6 +1,7 @@
 
+******
 Mapnik
-======
+******
 
 Mapnik is about making beautiful maps. It uses the `AGG library
 <http://www.antigrain.com/>`_ or `Cairo library
@@ -13,17 +14,19 @@ parsing and so on, Mapnik doesn't re-invent the wheel, but utilizes
 best of breed industry standard libraries from http://boost.org.
 
 
+
 History
--------
+=======
 
 Mapnik was started in a warm June afternoon in 2005 by Artem
 Pavlenko. First version was released in ...
 
 Current version is 0.7.1 available for download at
 http://mapnik.org/download/.
 
+
 Community
----------
+=========
 
 Mapnik community is organized around main site http://mapnik.org and
 development site http://trac.mapnik.org on which you can find latest
@@ -43,15 +46,15 @@ If you like more direct communication you can find us on **#mapnik** at
 irc.freenode.net, feel free to drop in with your question anytime.
 
 Platforms
----------
+=========
 
 Mapnik is a cross platform toolkit that runs on Windows, Mac, and
 Linux (since release 0.4). Users commonly run Mapnik on Mac >=10.4.x
 (both intel and PPC), as well as Debian/Ubuntu, Fedora, Centos,
 OpenSuse, and FreeBSD. 
 
 Supported data formats
-----------------------
+======================
 
 Mapnik uses a plugin architecture to read different
 datasources. Current plugins which are considered stable, and built by
@@ -91,7 +94,7 @@ cannot wait and/or like coding in C++, why not write your own data
 access plug-in?
 
 Future
-------
+======
 
 Large number of developers and contributors are actively developing
 *mapnik2* which will become **0.8.0**. Also, version **0.7.2** is

getting_started.rst

@@ -1,5 +1,6 @@
+***************
 Getting Started
-===============
+***************
 
 After reading this document you should be able to create a simple
 rendered map using Python or C++. 
@@ -8,7 +9,7 @@ TODO: add final rendered image
 
 
 What do I need to get started?
-------------------------------
+==============================
 
 First of all you need to install Mapnik library to your system. There
 are to two basic ways to do it, you can either download binaries or
@@ -19,7 +20,7 @@ Installation depends on your operating system and following sections
 describe this process.
 
 Windows installation
-^^^^^^^^^^^^^^^^^^^^
+--------------------
 
 Installing Mapnik on windows consists of following steps:
 
@@ -30,7 +31,7 @@ Installing Mapnik on windows consists of following steps:
 Each of this steps is explained in detail ..here..!
 
 Linux installation
-^^^^^^^^^^^^^^^^^^
+------------------
 
 Most modern Linux distributions include Mapnik binaries in their
 repositories. Installation method depends your distribution:
@@ -48,14 +49,14 @@ repositories. Installation method depends your distribution:
   # pacman -S mapnik
 
 MacOSX installation
-^^^^^^^^^^^^^^^^^^^
+-------------------
 
 Dane Springmeyer kindly hosts and builds MacOSX Mapnik binaries, you
 can find more information on his download page
 http://dbsgeo.com/downloads/.
 
 Testing Mapnik installation
----------------------------
+===========================
 
 Easiest way to test if you have successfully installed and configured
 Mapnik is to start up your Python interpreter and try to import mapnik

index.rst

@@ -3,6 +3,7 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
+====================
 Mapnik documentation
 ====================
 
@@ -15,21 +16,22 @@ algorithms/patterns for spatial data access and visualization. It can
 comfortably be used for both desktop and web development enabling
 fast-paced agile development.
 
-
+========
 Contents
 ========
 
 .. toctree::
-   :maxdepth: 1
-
-   About Mapnik <about_mapnik.rst>
+   :maxdepth: 2
+   :numbered:
+
+   about_mapnik.rst
    Getting Started <getting_started.rst>
    Install PostGIS Database <install_postgis_database.rst>
    Load PostGIS Database with Initial Geographic Data <load_postgis_database.rst>
    Install Mapnik Library Prerequisites <install_mapnik_library_prereq.rst>
    Install Mapnik Library <install_mapnik_library.rst>
 
-
+==================
 Indices and tables
 ==================
 

install_mapnik_library.rst

@@ -1,7 +1,9 @@
+**********************
 Install Mapnik Library
 **********************
 
-The Mapnik Library can be installed in several ways, choose only one of:
+The Mapnik Library can be installed in several ways, choose only one
+of:
 
 - Install from your package manager
 - Install from binaries
@@ -18,19 +20,21 @@ Is everything up to date on your system?
 
 
 Install Mapnik Library from Package Manager
--------------------------------------------
+===========================================
 
-This may not be the most recent version of Mapnik, depending on your distribution.
+This may not be the most recent version of Mapnik, depending on your
+distribution.
 
 ::
 
   sudo aptitude install mapnik
 
 
 Install Mapnik Library from Binaries
-------------------------------------
+====================================
 
-Windows and MacOSX binaries are available.  See installation instructions for Windows and MacOSX.  
+Windows and MacOSX binaries are available.  See installation
+instructions for Windows and MacOSX.
 
   TODO: have build server create .deb, .rpm binaries
 
@@ -41,7 +45,7 @@ Windows and MacOSX binaries are available.  See installation instructions for Wi
 
 
 Install Latest Stable Mapnik Library from Source
-------------------------------------------------
+================================================
 
 ::
 
@@ -54,7 +58,8 @@ Install Latest Stable Mapnik Library from Source
   sudo python scons/scons.py install
   sudo ldconfig
 
-If Mapnik compiles without errors, confirm that python can find Mapnik.
+If Mapnik compiles without errors, confirm that python can find
+Mapnik.
 
 ::  
 
@@ -65,8 +70,3 @@ If Mapnik compiles without errors, confirm that python can find Mapnik.
 
 
 
-
-
-
-
-

install_mapnik_library_prereq.rst

@@ -1,8 +1,9 @@
+************************************
 Install Mapnik Library Prerequisites
 ************************************
 
 Install Boost Libraries from Packages
--------------------------------------
+=====================================
 
 Is everything up to date on your system?  
 
@@ -35,11 +36,3 @@ Install Boost development libraries
   sudo aptitude install libboost-program-options1.40-dev 
 
  
-
-
-
-
-
-
-
-

install_postgis_database.rst

@@ -1,8 +1,9 @@
+************************
 Install PostGIS Database
 ************************
 
 Install Postgresql and PostGIS
-------------------------------
+==============================
 
 Is everything up to date on your system?  
 
@@ -11,19 +12,23 @@ Is everything up to date on your system?
   sudo aptitude update
   sudo aptitude safe-upgrade
 
-Install Postgresql and the PostGIS extensions to enable geographical queries.  
+Install Postgresql and the PostGIS extensions to enable geographical
+queries.
 
 ::
 
   sudo aptitude install postgresql-8.4-postgis postgresql-contrib-8.4
-  sudo aptitude install postgresql-server-dev-8.4
-  sudo aptitude install build-essential libxml2-dev
+  sudo aptitude install postgresql-server-dev-8.4 
+  sudo aptitude install build-essential libxml2-dev 
   sudo aptitude install libgeos-dev libpq-dev libbz2-dev proj
  
 Configure the Postgresql Server
--------------------------------
+===============================
 
-Edit the configuration file at /etc/postgresql/8.4/main/postgresql.conf to set some resonable defaults.  These changes help when dealing with large quantities of data that are found in geographic some databases.
+Edit the configuration file at
+/etc/postgresql/8.4/main/postgresql.conf to set some resonable
+defaults.  These changes help when dealing with large quantities of
+data that are found in geographic some databases.
 
 These edits are found in four places in the configuration file. 
 
@@ -35,7 +40,7 @@ These edits are found in four places in the configuration file.
   autovacuum = off
 
 Configure runtime kernel parameters
------------------------------------
+===================================
 
 Edit /etc/sysctl.conf to set kernel parameters after a restart.  
 
@@ -50,9 +55,10 @@ Then apply the same kernel parameter now, without restarting.
   sudo sysctl kernel.shmmax=268435456
 
 Restart the Postgresql Server
------------------------------
+=============================
 
-Restart the postgresql database server to enable the configuration changes.  
+Restart the postgresql database server to enable the configuration
+changes.
 
 ::
 
@@ -64,9 +70,12 @@ The database server should restart without errors or warnings
    |    ...done.
 
 Create the Postgresql Database
-------------------------------
+==============================
 
-Create a database called "gis". Some of our future tools presume that you will use this database name. Substitute your username for "username"  in two places below. This should be the username that will render maps with mapnik.
+Create a database called "gis". Some of our future tools presume that
+you will use this database name. Substitute your username for
+"username" in two places below. This should be the username that will
+render maps with mapnik.
 
 :: 
 
@@ -77,7 +86,7 @@ Create a database called "gis". Some of our future tools presume that you will u
   exit
 
 Apply the PostGIS Extensions to the Database
---------------------------------------------
+============================================
 
 Apply the PostGIS extensions to the postgresql database.
 
@@ -91,21 +100,26 @@ This should respond with many lines ending with
    |  CREATE FUNCTION
    |  COMMIT
 
-Substitute your username for "username" in two places in the next line. This should be the username that will render maps with mapnik.
+Substitute your username for "username" in two places in the next
+line. This should be the username that will render maps with mapnik.
 
 ::
 
-  echo "ALTER TABLE geometry_columns OWNER TO username; ALTER TABLE spatial_ref_sys OWNER TO username;" | psql -d gis
+  echo "ALTER TABLE geometry_columns OWNER TO username; ALTER TABLE
+  spatial_ref_sys OWNER TO username;" | psql -d gis
 
 Should reply with
 
    |  ALTER TABLE
    |  ALTER TABLE
 
 Enable OpenStreetMap Updates
-----------------------------
+============================
 
-This optional step is only required if you plan to use the OpenStreetMap regular data updates.  Enable intarray to enable updates through the OpenStreetMap .osc files for daily, hourly and minutely updates.
+This optional step is only required if you plan to use the
+OpenStreetMap regular data updates.  Enable intarray to enable updates
+through the OpenStreetMap .osc files for daily, hourly and minutely
+updates.
 
 ::
 
@@ -118,7 +132,7 @@ Replies with many lines ending with
    |  CREATE OPERATOR CLASS
 
 Set SRID for PostGIS Database
------------------------------
+=============================
 
 Set the Spatial Reference Identifier (SRID) on the new database.