Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Parseable Specifications of Mapnik's Symbolizers and Colors

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 2.0.1
Octocat-spinner-32 2.0.2
Octocat-spinner-32 2.1.0
Octocat-spinner-32 latest
Octocat-spinner-32 test
Octocat-spinner-32 Makefile
Octocat-spinner-32 index.js
Octocat-spinner-32 package.json


mapnik-reference is a parse-able spec of what Mapnik can do - what symbolizers it supports and the properties they can contain. It's useful for building parsers, tests, compilers, and syntax highlighting/checking for languages.


The version of this repository indicates the schema of the reference.json file. Schema changes of any type are expected to change the implementation requirements of a parser, so they will increment the major version of this repository in semver style.

The directories in this repository directly correspond to released versions of Mapnik and the next targeted release of Mapnik. The latest reference, usually targeted toward a pre-release, is copied into /latest for convenience.


The structure of the file is as such:

  • version: the version of Mapnik targeted. Same as the containing directory.
  • style: properties of the Style XML element
  • font-set: properties of the FontSet XML element
  • layer: properties of the Layer XML element
  • symbolizers/*: properties that apply to all symbolizers
  • symbolizers/symbolizer: properties that apply to each type of symbolizer
  • colors: named colors supported by Mapnik. see include/mapnik/css_color_grammar.hpp


This is a valid npm module and thus is pretty easy to use from node.js.

npm install mapnik-reference

Once installing it as a dependency (like it's used in Carto), it can be included and used for a specific version of Mapnik:

var mapnik_reference = require('mapnik-reference');
var data = mapnik_reference.version['2.1.0'];

Other implementations will want to simply copy the JSON file from the desired implementation, like 2.0.1/reference.json.

The file can then be parsed with any of the many json parsers.


Tests require python:

make test


Something went wrong with that request. Please try again.