OpenStreetMap Carto Tutorials - OpenStreetMap Carto documentation     Site map    

OpenStreetMap Carto Tutorials

OpenStreetMap Carto is the style used for the Standard tile layer of OpenStreetMap.

This independent site includes unofficial tutorials to set-up a development environment of OpenStreetMap Carto and to manage this software. It will allow exploiting the style and also being able to contribute to the developments.

To implement this site I kept track of technical notes that have been useful to me and that I hope will also be of help to master OpenStreetMap Carto fast, learning all most relevant aspects from the ground up.

All pages of this site allow commenting. You can also contribute or create GitHup issues. Opening GitHup issues is the most effective way for correction requests.

DISCALIMER: the documentation included in this site is unofficial, might be at early stage and could require improvements that will be possibly addressed in the future. I strongly recommend referencing the official documentation for openstreetmap-carto. Keep also in mind that some information might be only valid at the time of writing and could require possible updates.

Contributing to OpenStreetMap

OpenStreetMap, the Wikipedia of maps, is a collaborative project to create a free editable map of the world. It consists of open data and open source software; both can be contributed.

A Beginners’ guide is available in the OpenStreetMap Wiki, providing basic information on how to add data to OpenStreetMap.

Technical details to maintain and develop the OpenStreetMap open source software, from portal to rendering and other backend platforms, can be found at the Develop page.

OpenStreetMap Carto

OpenStreetMap Carto includes the CartoCSS map stylesheets for the Standard map layer of OpenStreetMap. The styles can be converted from CartoCSS to XML and then processed by Mapnik.

CartoCSS is a CSS-like language for map design developed by MapBox and currently adopted by OpenStreetMap.

OpenStreetMap Carto is a Git-based, active and complex open source “non-software” project owned by Andy Allan, who had the brilliant idea to re-implement the original OpenStreetMap Mapnik XML style in CartoCSS, performing the initial port, involving multiple maintainers and opening the project to contributors.

If you are also willing to contribute, you are strongly advised to analyze Guidelines for adding new features and understand the current project trend, which is very cautious with additions.

Site Update Notes

Installing a Docker image of Kosmtik with Ubuntu or Windows

Added the full procedure to Install a Docker image of Kosmtik with Ubuntu and with Windows.

Documentation updated to OSM-Carto tag 4.0.0

Documentation updated to openstreetmap-carto tag v4.0.0, commit ecc8aa6 performed on May 22, 2017.

  • Support of carto 0.18.0
  • Revised documentation

Please, avoid opening requests of correction with Discus and use it only for for general comments; all issues should be managed with GitHub issues.

Documentation updated to OSM-Carto tag 3.3.0

  • Documentation updated to openstreetmap-carto tag v3.3.0, commit 12ad3a1 performed on May 10, 2017.
  • Support of carto 0.16.3
  • Support of Noto fonts
  • Support of hstore
  • Usage of nodejs-legacy
  • Closed issues #7, #8, #9.
  • Revised documentation according to notes and hints within Discus.

Editing Guidelines for OpenStreetMap Carto

Added a document including the description of the general editing process of the OpenStreetMap Carto style through some best practices; this document replaces and incorporates the former description of the scripts included in OpenStreetMap Carto.


comments powered by Disqus