Skip to content
This repository has been archived by the owner on Jul 24, 2021. It is now read-only.

Docs update after moving osm.xml to Mapnik entities #2459

Closed
openstreetmap-trac opened this issue Jul 23, 2021 · 3 comments
Closed

Docs update after moving osm.xml to Mapnik entities #2459

openstreetmap-trac opened this issue Jul 23, 2021 · 3 comments

Comments

@openstreetmap-trac
Copy link

Reporter: springmeyer
[Submitted to the original trac issue database at 4.39pm, Sunday, 15th November 2009]

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.

@openstreetmap-trac
Copy link
Author

Author: springmeyer
[Added to the original trac issue at 11.36pm, Sunday, 15th November 2009]

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').

@openstreetmap-trac
Copy link
Author

Author: Ldp
[Added to the original trac issue at 8.48pm, Saturday, 28th November 2009]

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?

@openstreetmap-trac
Copy link
Author

Author: Ldp
[Added to the original trac issue at 10.56pm, Tuesday, 2nd March 2010]

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.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

No branches or pull requests

1 participant