TileMill is a modern map design studio powered by open source technology. Installation instructions, development docs and other information are available on the TileMill website.
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:
POSTGIS_VERSION="1.5" # you may need to change this POSTGIS_PATH=`pg_config --sharedir`/contrib/postgis-$POSTGIS_VERSION createdb -E UTF8 template_postgis createlang -d template_postgis plpgsql psql -d template_postgis -f $POSTGIS_PATH/postgis.sql psql -d template_postgis -f $POSTGIS_PATH/spatial_ref_sys.sql For more info see: http://postgis.refractions.net/documentation/manual-1.5/ch02.html#id2619431
Tilemill documentation is kept in the gh-pages branch, which is independently managed and not merged with master.
Tilemill's in-app reference available as the "Manual" is a very small subset of docs for offline usage and is manually sync'ed from the gh-pages branch.
To view all the TileMill documentation locally, first checkout the gh-pages branch:
git checkout gh-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 gh-pages updates do:
export TILEMILL_SOURCES=`pwd` cd ../ git clone --depth=1 -b gh-pages https://github.com/mapbox/tilemill tilemill-gh-pages cd ${TILEMILL_SOURCES} export TILEMILL_GHPAGES=../tilemill-gh-pages rm -rf ${TILEMILL_SOURCES}/assets/manual mkdir -p ${TILEMILL_SOURCES}/assets/manual cp -r ${TILEMILL_GHPAGES}/assets/manual/* ${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/