From 147a695dace13bf54051e5fd8727755819288e7a Mon Sep 17 00:00:00 2001 From: dch0ph Date: Sat, 24 Jan 2026 17:17:57 +0000 Subject: [PATCH 1/2] Update README Update links and refer to datasources explicitly --- README.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 734b331..bf23e90 100644 --- a/README.md +++ b/README.md @@ -20,7 +20,7 @@ and the next targeted release of Mapnik. ## Meaning -The structure of the file is as such: +The structure of `reference.json` is: * `version`: the version of Mapnik targeted. Same as the containing directory. * `style`: properties of the `Style` XML element @@ -38,6 +38,7 @@ then the `status` is `stable`. Possible values are: - **deprecated:** `property` should not be used and will be removed in upcoming major version of Mapnik - **experimental:** `property` should not be used and may change, be re-named, or disappear at any time +`datasources.json` separately details the properties of the possible data sources (since version 2.3.0). ## Using @@ -82,5 +83,5 @@ Tests require python and node.js: ## Users -* [carto.js](https://github.com/mapbox/carto) -* Mapnik itself (the util/validate-mapnik-instance.py is used to check binding consistency like in [#1427](https://github.com/mapnik/mapnik/issues/1427)) +* [carto.js](https://github.com/cartocss/carto) +* Mapnik itself (the utility [mapnik-reference-validate.py](https://gist.github.com/springmeyer/3410845) can be used to check binding consistency like in [#1427](https://github.com/mapnik/mapnik/issues/1427)) From 577bda4fc24dc4cd23dd00efe5d1627be2d79c35 Mon Sep 17 00:00:00 2001 From: dch0ph Date: Sat, 24 Jan 2026 17:27:22 +0000 Subject: [PATCH 2/2] Update README for symbolizer properties clarification --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index bf23e90..4fb2c25 100644 --- a/README.md +++ b/README.md @@ -26,7 +26,7 @@ The structure of `reference.json` is: * `style`: properties of the `Style` 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 +* `symbolizers/`_\_: properties that are specific to a given symbolizer * `colors`: named colors supported by Mapnik. see `include/mapnik/css_color_grammar.hpp` ### Property stability