mapnik / mapnik.github.com

mapnik.org
8 stars 13 forks source link

Mapnik configuration XML diagram #30

Open amyleew opened 9 years ago

amyleew commented 9 years ago

@springmeyer @flippmoke @artemp - First stab at diagram for Mapnik configuration XML

image

Thoughts? Anything missing? Does Include container need to be added? Does data vs. datasource work? Should map image be more specific to .png / .pdf format map image?

springmeyer commented 9 years ago

Thoughts?

This is really useful and a great first pass.

Anything missing?

No.

Does Include container need to be added?

No.

Does data vs. datasource work?

datasource would be better

Should map image be more specific to .png / .pdf format map image?

What about "image" (this would capture formats like png, jpeg, webp, tiff all of which Mapnik supports, "svg", "vector tiles"? That is a bit of a simplification, since we also support PDF and Postscript technically. But simpler the better for a diagram like this.

springmeyer commented 9 years ago

@amyleew what about removing the arrow that points from style -> layer and instead pointing both downward? This is more appropriate because both "style" and "layer" are independent and combined produce a map:

3587dda8-105c-11e5-9110-4b0ff845be6f

amyleew commented 9 years ago

@springmeyer - Updated w/ image output simplified.

image

springmeyer commented 9 years ago

@amyleew - ideas to further simplify: remove the XML above style. Change the word image and just use tile (idea being to capture that Mapnik can output both image tiles (aka raster tiles) and vector tiles, etc)

amyleew commented 9 years ago

@springmeyer thanks! update:

image

springmeyer commented 9 years ago

\o/ @amyleew - so do you have ideas where in the site this should live?

amyleew commented 9 years ago

@springmeyer - Link here on wiki for XMLConfigReference? And add as a blog post?