Deployment

1. Set up mapnik 2.3

Clone the repository of mapnik 2.3:
git clone -b 2.3.x https://github.com/mapnik/mapnik.git

1.1 Install mapnik

Follow the instructions on:
https://github.com/mapnik/mapnik/blob/2.3.x/INSTALL.md

We documented the issues we frequently encountered while setting up mapnik below (3. Known Issues).

2. Set up Preselected Rendering

Clone this repository
git clone https://github.com/OpenHistoricalDataMap/Preselected-Rendering.git

2.1 Install psycopg2

This is needed to access a postgres database.

pip install psycopg2

2.2 Customize Settings

You NEED TO customize the following file to match your database configuration.

inc/datasource-settings.xml.inc

You CAN customize the following file to change fontsettings for Mapnik fonts.

inc/fontset-settings.xml.inc

You CAN customize the following file to match your settings for symbols, the spatial reference of your postgis tables and coastline shapefiles directory. You SHOULD NOT however change the <!ENTITY prefix [...]>, because that entry is used by generate_view_tiles.py to access preselected database tables (Views).

inc/settings.xml.inc

You should stick with the recommended defaults unless you know better.

Testing rendering

To generate a simple image of the United Kingdom use the 'generate_image.py' script.

./generate_image.py # will output an 'image.png' file...

3. Known issues

1. Set up mapnik 2.3: Step './configure'

Exiting... the following required dependencies were not found:
- freetype-config (freetype-config program | try setting FREETYPE_CONFIG SCons option or configure with FREETYPE_LIBS & FREETYPE_INCLUDES)
- boost development headers (more info see: https://github.com/mapnik/mapnik/wiki/Mapnik-Installation & http://www.boost.org/)

See '/home/<user>/mapnik/config.log' for details on possible problems.

https://github.com/mapnik/mapnik/issues/3211