Name: tilemill
Owner: OpenGeoscience
Description: A modern map design studio.
Created: 2014-06-09 14:59:12.0
Updated: 2016-10-01 16:59:43.0
Pushed: 2016-08-28 03:53:25.0
Homepage: http://tilemill.com
Size: 122209
Language: JavaScript
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
TileMill is a modern map design studio powered by Node.js and Mapnik.
Installation instructions, development docs and other information are available on the TileMill website.
However, node-mapnik (which depends on Mapnik and protobuf) is now packaged as a binary. So, you do not need an external Mapnik. See Installation
To install from source just do:
git clone git@github.com:mapbox/tilemill.git
cd tilemill
npm install
Then to start TileMill do:
./index.js # and then view http://localhost:20009 in your web browser
For more extended details follow:
Install mocha and run the tests
npm install mocha
npm test
Note: the tests require a running postgres server and a postgis enabled
database called template_postgis
.
If you do not have a template_postgis
create one like:
createdb -E UTF8 template_postgis
psql -c "CREATE EXTENSION postgis" template_postgis
If you experience failing tests here are two tips:
Debug the project data by running TileMill with
./index.js –files=./test/fixtures/files/
Try clearing the cache of test data:
rm -rf ./test/fixtures/files/
For more info see: http://postgis.net/docs/manual-1.5/ch02.html
TileMill documentation is kept in the mb-pages branch, which is independently managed and not merged with master.
TileMill's in-app reference available as the “Manual” (see below for syncing details) is a very small subset of docs for offline usage and is manually sync'ed from the mb-pages branch.
To view all the TileMill documentation locally, first checkout the mb-pages branch:
git checkout mb-pages
Then install Jekyll:
sudo gem install jekyll
And run Jekyll:
jekyll
Once Jekyll has started you should be able to view the docs in a browser at:
http://localhost:4000/tilemill/
To sync the manual with mb-pages updates do:
export TILEMILL_SOURCES=`pwd`
cd ../
git clone --depth=1 -b mb-pages https://github.com/mapbox/tilemill tilemill-mb-pages
cd ${TILEMILL_SOURCES}
export TILEMILL_GHPAGES=../tilemill-mb-pages
rm -rf ${TILEMILL_SOURCES}/assets/manual
mkdir -p ${TILEMILL_SOURCES}/assets/manual
cp -r ${TILEMILL_GHPAGES}/assets/manual/* ${TILEMILL_SOURCES}/assets/manual/
git add ${TILEMILL_SOURCES}/assets/manual/*
rm -rf ${TILEMILL_SOURCES}/_posts/docs/reference
mkdir -p ${TILEMILL_SOURCES}/_posts/docs/reference
cp -r ${TILEMILL_GHPAGES}/_posts/docs/reference/* ${TILEMILL_SOURCES}/_posts/docs/reference/
git add ${TILEMILL_SOURCES}/_posts/docs/reference/*