Shelley - Drawing maps simply
=============================

Shelley is a python library for defining and drawing maps.

.. image:: clifton.png

Python is used to define the map drawing primitives and so can easily be
extended for experimentation. 

 * `pycairo <http://www.cairographics.org/pycairo/>`_ is used for creating the images.
 * pango is used in conjunction with cairo to draw text and is available via the `pygtk <http://www.pygtk.org/>`_ bindings.
 * `pyproj <http://code.google.com/p/pyproj/>`_ is used for specifying projections.

Optional dependencies

 * `geodjango <http://geodjango.org>`_ to read data from spatial databases
 * `python bindings <http://pypi.python.org/pypi/GDAL/>`_ for the GDAL library to read various formats of GIS data.

Shelley is still in the early stages of development and any suggestions for
improvement are welcome.

For map creation you're probably going to be better off using one of the established
map rendering software tools such as
`MapServer <http://mapserver.org/>`_, 
`Mapnik <http://www.mapnik.org/>`_
and 
`GeoServer <http://geoserver.org>`_

.. epigraph::
    I beheld the wretch — the miserable monster whom I had created

    -- Victor Frankenstein

Documentation:

.. toctree::
    :maxdepth: 2

    introduction
    concepts
    reference
   
Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`