Opened 10 years ago

Closed 9 years ago

#2459 closed enhancement (fixed)

Docs update after moving osm.xml to Mapnik entities

Reported by: Dane Springmeyer Owned by: mapnik-team@…
Priority: major Milestone:
Component: mapnik Version:
Keywords: Cc:

Description

The osm.xml has been moved to using XML entities and the docs need to be updated.

I took a crack at re-writing the documentation and adding a new python script that gives the user flexibility for getting a customized rendering setup going with the new organization around entities in the 'inc' subdirectory.

This script essentially provides the ability to set the desired parameters needed to localize the osm.xml either by command line flags, from the users environment, or by changing the defaults at the top of the script. The order of preference is that same order, flags, then environment, then defaults stored inside the script.

The script is likely overkill, but I repurposed it from another project and figured it might be helpful. Let me know.

Attachments (3)

README (8.2 KB) - added by Dane Springmeyer 10 years ago.
big update to readme
osm_readme_update.patch (7.9 KB) - added by Dane Springmeyer 10 years ago.
readme update as patch
osm_mapnik_generate_xml_with_entities.patch (10.3 KB) - added by Dane Springmeyer 10 years ago.
patch to modify the variable names in the 'inc' files to be python friendly and a python script to use with them

Download all attachments as: .zip

Change History (6)

Changed 10 years ago by Dane Springmeyer

Attachment: README added

big update to readme

Changed 10 years ago by Dane Springmeyer

Attachment: osm_readme_update.patch added

readme update as patch

Changed 10 years ago by Dane Springmeyer

patch to modify the variable names in the 'inc' files to be python friendly and a python script to use with them

comment:1 Changed 10 years ago by Dane Springmeyer

the benefit of the way this script works is that xml contributers can freely add new variables inside the 'example' inc files or even new '.example' include files themselves, and users will be prompted for these necessary parameters when running the script using updated sources from svn. The catch is that the logic is fairly simplistic and some variables may depend on each other, and may not be handled properly without an update to the 'generate_xml.py' script (for example 'estimate_extent' and 'extent').

comment:2 Changed 10 years ago by Ldp

Now that the .example files will be read directly from scripts, would it make sense to rename them to .template to indicate that these are now part of an automated process?

comment:3 Changed 9 years ago by Ldp

Resolution: fixed
Status: newclosed

These files have been renamed to *.template. The README in svn has been updated to reflect the use of generate_xml.py. The documentation at http://wiki.openstreetmap.org/wiki/Mapnik has been adjusted as well.

All the other lingering mapnik (stylesheet) documentation on the OSM wiki will have to be fixed or obsoleted by their respective maintainers.

Note: See TracTickets for help on using tickets.