Tilemill documentation

[Ircama]

Contributing to OpenStreetMap-Carto through Tilemill with Windows.

Added documentation about contributing to OpenStreetMap-Carto through Tilemill with Windows.

This procedure allows implementing a working installation on Win32 and Win64, as well as contributing to OpenStreetMap-Carto via GitHub.

There are still unclear aspects through a Windows PC (32 and 64 bit OS):

• how to install Kosmtik with Windows, including the latest version of Mapnik
• how to upgrade Tilemill, downloading the latest drop from GitHub, after the first Windows installation is performed through the EXE setup
• how to upgrade the Mapnik version of Tilemill with Windows to the latest one found in GitHub
• where to find the latest Windows executable files of Mapnik (e.g., 3.5.13 for Win32 and for win64).

None of them currently succeed with Windows, neither with Cygwin.

[pnorman]

We do not have hstore available as part of this style.

[Ircama]

I was wrong in creating this branch from an incorrect commit.
I then tried in many ways to rebase/reset, unsuccessfully.
Maybe it is better that I newly recreate it after all revisions have been done (it is just one file that I added, together with an update to another).
BTW, If anyone would like to suggest rephrasing, is welcomed of course; this guide is just a collection of quick notes I jotted down while finding a way to manage openstreetmap-carto with Windows.

This doesn't seem tilemill specific

If you are referring to the need of “Guidelines to edit the stilesheets” inside this guide, I just wanted to avoid that Windows users, after following all these long steps, forget to study the main documentation pages of this project.

We do not have hstore available as part of this style.

Do you feel we will have to wait for long to have hstore merged?

[matkoniecz]

I then tried in many ways to rebase/reset, unsuccessfully.

According to my test

g rebase -i master

followed by squashing all commits in one

pick d1b9f47 Branch reset to master
s 22cdbb2 Revised min zoom visibility for some elements
s 5c5aadf (revised comment)
s 3a2644e Revert "Revised min zoom visibility for some elements"
s e0b3c43 Contributing to OpenStreetMap-Carto through Tilemill with Windows

and editing comment to drop unneded parts resulted in https://github.com/matkoniecz/openstreetmap-carto/commits/test with all content merged in one commit (matkoniecz@15975ec)

Note that pushing to remote repository afte rebase requires --force argument.

[matkoniecz]

Do you feel we will have to wait for long to have hstore merged?

It would be better to rephrase it and mention hstore once it is merged (work on it is ongoing for a realy long time).

[pnorman]

We intentionally keep the scope of our installation instructions small and refer to other sources like switch2osm for detailed instructions. We should be doing the same here.

[matthijsmelissen]

@pnorman So what concrete actions do need to be taken?

[pnorman]

Removing instructions for installing Tilemill. The only instructions should be ones for OpenStreetMap Carto.

[kocio-pl]

So I guess this PR should only change few lines about Linux in INSTALL.md
(without https://github.com/gravitystorm/openstreetmap-carto/pull/2143/files#diff-7d442b7eb49f5fc377f51e74b291cfc1R7)? This ticket should be renamed then.

[Ircama]

OK, I can move these instructions to switch2osm and update them, closing this PR then.
Is there a GitHub repository and some guidelines to update switch2osm?

[SomeoneElseOSM]

https://switch2osm.org was set up by Richard Fairhurst ( @systemed ) though a few other people (including me) have access. There's also https://switch2osm.github.io , which I think is an initiative of @pnorman , but that's not quite complete yet.

If you want other people to see https://github.com/Ircama/openstreetmap-carto/blob/d22064b02d7bc7c8dada7ec460ab13592c7ac635/TILEMILL.md and maybe provide feedback on it, perhaps write an OSM diary entry or mailing list post referencing it? I'd also post an answer to https://help.openstreetmap.org/questions/11715/easiest-way-of-importing-osm-data-into-tilemill-using-windows .

Also does it definitely work with current "OSM carto". Someone reported at https://help.openstreetmap.org/questions/49645/problem-loading-openstreetmap-carto-project-into-tile-mill a problem with highway shields.

[Ircama]

@SomeoneElseOSM: thanks for your post. At the end I provided an updated version at https://github.com/Ircama/switch2osm.github.io/blob/tilemill-osm-carto/tilemill-osm-carto.md

You are free to publish it to https://switch2osm.org.

There's also https://switch2osm.github.io , which I think is an initiative of @pnorman , but that's not quite complete yet.

I made a PR to that initiative.

I'd also post an answer to https://help.openstreetmap.org/questions/11715/easiest-way-of-importing-osm-data-into-tilemill-using-windows .

I checked that question and I think that the link in the answer is missing some information which should be included in my description.

Also does it definitely work with current "OSM carto". Someone reported at https://help.openstreetmap.org/questions/49645/problem-loading-openstreetmap-carto-project-into-tile-mill a problem with highway shields.

Yes it works at the moment.

[matthijsmelissen]

@pnorman I notice we have both https://switch2osm.org/ and http://switch2osm.github.io/. What is the difference between both websites?

[matthijsmelissen]

Is somebody else working on documentation at the moment? I seem to remember another ticket, but can't find it right now.

[Ircama]

Is somebody else working on documentation at the moment? I seem to remember another ticket, but can't find it right now.

Some other references (none merged):

• Add a description for scripts included in OpenStreetMap Carto #2333
• Review onboarding #2291

Besides I'm maintaining some rather updated document here (at least until I don't get bored).

[matthijsmelissen]

Thanks!

[systemed]

@math1985 switch2osm.org is the live Wordpress-hosted site, switch2osm.github.io is an in-progress Github-hosted rewrite.

[matthijsmelissen]

@systemed And how does this relate to the draft at https://hackpad.com/TileMill-I6rxRVszKMv ? Has this draft already been merged in one of the other projects, of is it an independent 'branch'?

[systemed]

@math1985 I think that's largely outdated given that most people use Kosmtik these days, not Tilemill.

[matthijsmelissen]

@systemed Do you still maintain https://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/? Osm2pgsql now uses cmake instead of autogen, so the described method of installing will not work.

In 16.04, the packages libtiff4-dev and postgresql-9.3-postgis-2.1 (now postgresql-9.5-postgis-2.2) do not exist anymore. Apart from that, I expect not much has changed.

[kocio-pl]

TileMill might be back some day: I was able to open our project from master and this PR is already merged:

tilemill-project/tilemill#2614

however there is still a problem with saving:

tilemill-project/tilemill#2615

I also try to make a Mapnik build for Windows (see mapbox/windows-builds#104 (comment)) to allow the new release (macOS build is still ahead):

tilemill-project/tilemill#2567