mapnik-reference - GitLite

KO | EN

gitlite — search

#proxy #csharp #pdf #c #deep-learning #self-hosted #nextjs #gpt #rag #dotnet

mapnik-reference

(★ 52)

JSON specification of Mapnik styling and datasources

File Explorer

ZIP Download

- reference.json
- reference.json
- reference.json
- reference.json
- reference.json
- reference.json
- datasources.json
- datasources.template.json
- reference.json
- datasources.json
- datasources.template.json
- reference.json
- datasources.json
- datasources.template.json
- reference.json
- datasources.json
- datasources.template.json
- reference.json
- datasources.json
- datasources.template.json
- reference.json
- datasources.json
- datasources.template.json
- reference.json
- datasources.json
- datasources.template.json
- reference.json
- lint.js
- make-datasource-ref.js
- test.py
- validate-mapnik-instance.py
- .eslintrc
- main.css
- main.js
- nanoajax.min.js
- test.js
.gitignore
.npmignore
.travis.yml
CHANGELOG.md
contributing.md
generate.js
index._
index.html
index.js
LICENSE.md
Makefile
package.json
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`npm install`

View Details ▼

Install Node packages.

npm {{[i|install]}}

Install dependencies listed in `package.json`:

npm {{[i|install]}} {{package_name}}@{{version}}

Download a specific version of a package and add it to the list of dependencies in `package.json`:

npm {{[i|install]}} {{package_name}} {{[-D|--save-dev]}}

Download the latest version of a package and add it to the list of dev dependencies in `package.json`:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

`mapnik-reference` is a spec of what Mapnik styling and datasource properties are supported for each version.

It is useful for building parsers, tests, compilers, and syntax highlighting/checking for languages.

Default branch is `gh-pages`, which is displayed at http://mapnik.org/mapnik-reference

## Versioning

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](http://semver.org/).

The directories in this repository directly correspond to released versions of Mapnik
and the next targeted release of Mapnik.

## Meaning

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 (removed from version 2.1.0 onwards)
* `symbolizers/`_\<symbolizer\>_: properties that are specific to a given symbolizer
* `colors`: named colors supported by Mapnik. see `include/mapnik/css_color_grammar.hpp`

### Property stability
The `status` key may be used to define the stability of a property. When the key is not specified,
then the `status` is `stable`. Possible values are:

- **stable:** `property` is here to stay and its behavior is not anticipated to change
- **unstable:** `property` is here to stay but its behavior/meaning of `property` may change
- **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

This is a valid [npm](http://npmjs.org/) module and therefore can easily be used with
[node.js](http://nodejs.org/).

npm install @mapnik/mapnik-reference

Install it as a dependency of your application. Then use that API to get a reference instance
for a specific version of Mapnik:

```javascript
var mapnik_reference = require('@mapnik/mapnik-reference');
var ref = mapnik_reference.load('4.2.0');
```

You can also get access to an array of all known versions:

```javascript
var mapnik_reference = require('@mapnik/mapnik-reference');
mapnik_reference.versions;
[
  '2.0.0',  '2.0.1',
  '2.0.2',  '2.1.0',
  '2.1.1',  '2.2.0',
  '2.3.0',  '3.0.0',
  '3.0.3',  '3.0.6',
  '3.0.20', '3.0.22',
  '4.2.0'
]
```

Other implementations will want to simply copy the [JSON](http://www.json.org/) file
from the desired implementation, like `2.0.1/reference.json`.

The file can then be parsed with any of the many [json parsers](http://www.json.org/).

## Testing

Tests require python and node.js:

make test

## Users

* [carto.js](https://github.com/cartocss/carto)
* [Mapnik documentation](http://mapnik.org/mapnik-reference)