From 147a695dace13bf54051e5fd8727755819288e7a Mon Sep 17 00:00:00 2001 From: dch0ph Date: Sat, 24 Jan 2026 17:17:57 +0000 Subject: [PATCH 1/4] 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/4] 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 From 33f0ff4174efe9a7b15fbede1a4c493936661189 Mon Sep 17 00:00:00 2001 From: dch0ph Date: Mon, 26 Jan 2026 19:04:09 +0000 Subject: [PATCH 3/4] Further tidying of README --- README.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 4fb2c25..9ce6e49 100644 --- a/README.md +++ b/README.md @@ -4,9 +4,7 @@ It is useful for building parsers, tests, compilers, and syntax highlighting/checking for languages. -[![Build Status](https://travis-ci.org/mapnik/mapnik-reference.svg)](https://travis-ci.org/mapnik/mapnik-reference) - -Default branch is `gh-pages` which is displayed at http://mapnik.org/mapnik-reference +Default branch is `gh-pages`, which is displayed at http://mapnik.org/mapnik-reference ## Versioning @@ -25,7 +23,7 @@ The structure of `reference.json` is: * `version`: the version of Mapnik targeted. Same as the containing directory. * `style`: properties of the `Style` XML element * `layer`: properties of the `Layer` XML element -* `symbolizers/*`: properties that apply to **all** symbolizers +* `symbolizers`: properties that apply to all symbolizers (removed from version 2.1.0 onwards) * `symbolizers/`_\_: properties that are specific to a given symbolizer * `colors`: named colors supported by Mapnik. see `include/mapnik/css_color_grammar.hpp` @@ -84,4 +82,4 @@ Tests require python and node.js: ## Users * [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)) +* [Mapnik documentation](http://mapnik.org/mapnik-reference) From b16c17f9978b9e478e280a6e2c662f758c0fe86d Mon Sep 17 00:00:00 2001 From: dch0ph Date: Wed, 28 Jan 2026 21:33:04 +0000 Subject: [PATCH 4/4] Document text-extend Refers to mapnik PR #3512 --- 3.1.0/reference.json | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/3.1.0/reference.json b/3.1.0/reference.json index 97ab82f..af4284d 100644 --- a/3.1.0/reference.json +++ b/3.1.0/reference.json @@ -2701,6 +2701,14 @@ "doc": "In case of `line` placement, offsets a text position a number of pixels parallel to its actual path. In case of `grid` placement, reduces or expands the polygon area. Positive values move the line left or expand the polygon, negative values move it right or shrink the polygon (relative to the directionality of the line or polygon winding).", "status": "unstable" } + "extend": { + "css": "text-extend", + "type": "float", + "expression": true, + "default-value": 0.0, + "default-meaning": "", + "doc": "A temporary path will created that extends both the starting and final segments of a line by the given distance (starting and final segments are the same for lines with a single segment). The text will be rendered on this extended line, i.e. text will extend beyond the line length. Option is only valid with placement-line." + }, }, "building": { "default": {