CD2H gitForager

makinacorpus/tilemill

Name: tilemill

Owner: Makina Corpus

Description: where maps come from

Created: 2011-03-10 12:47:04.0

Updated: 2016-09-21 17:59:07.0

Pushed: 2011-03-10 13:10:07.0

Homepage: http://mapbox.github.com/tilemill

Size: 5684

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

TileMill

TileMill is a modern map design studio powered by open source technology.

Features

Access datasources on the local filesystem or through Amazon S3
Manage map layers with file-based datasources (shapefiles, rasters)
Edit carto stylesheets directly in the browser
Edit carto stylesheets with a custom editor like vim in Minimal mode
Preview map tiles instantly while editing stylesheets
Inspect datasource field values and data types
Export maps to PNG, PDF and MBTiles formats

Requirements

TileMill client
Tested: Chrome 6+, Firefox 3+, IE8+
May work: Opera 11
TileMill server
Tested: Mac OS X 10.6, Ubuntu 10.10
At least 2GB memory
May work: Older versions, other POSIX-compliant systems

Installation: Mac OS X 10.6

Install Xcode for Mac OS X:

Xcode

Install Mapnik 2.0 from OS X package:

mapnik 2.0

Download and unpack TileMill. Build & install:

cd TileMill
./ndistro

Start TileMill:

./tilemill.js

TileMill should now be accessible from a browser at http://localhost:8889.

Installation: Ubuntu 10.10

Install build requirements:

# Mapnik dependencies
sudo apt-get install -y g++ cpp \
libboost-filesystem1.42-dev \
libboost-iostreams1.42-dev libboost-program-options1.42-dev \
libboost-python1.42-dev libboost-regex1.42-dev \
libboost-system1.42-dev libboost-thread1.42-dev \
python-dev libxml2 libxml2-dev \
libfreetype6 libfreetype6-dev \
libjpeg62 libjpeg62-dev \
libltdl7 libltdl-dev \
libpng12-0 libpng12-dev \
libgeotiff-dev libtiff4 libtiff4-dev libtiffxx0c2 \
libcairo2 libcairo2-dev python-cairo python-cairo-dev \
libcairomm-1.0-1 libcairomm-1.0-dev \
ttf-unifont ttf-dejavu ttf-dejavu-core ttf-dejavu-extra \
subversion build-essential python-nose

# Mapnik plugin dependencies
sudo apt-get install libgdal1-dev python-gdal \
postgresql-8.4 postgresql-server-dev-8.4 postgresql-contrib-8.4 postgresql-8.4-postgis \
libsqlite3-0 libsqlite3-dev

# TileMill dependencies
sudo apt-get install libzip1 libzip-dev curl

Install mapnik from source:

svn checkout http://svn.mapnik.org/trunk mapnik
cd mapnik
python scons/scons.py configure
python scons/scons.py
sudo python scons/scons.py install
sudo ldconfig

Download and unpack TileMill. Build & install:

cd TileMill
./ndistro

Start TileMill:

./tilemill.js

TileMill should now be accessible from a browser at http://localhost:8889.

Configuration

Optional. Edit settings.js to change server settings including port, files directories, and enabled asset providers.

Development

TileMill development is moving fast and we intend to create tags as soon as we get to usable stopping points. If you are interested in keeping up with or helping with development here are some steps to get setup:

Replace your TileMill directory with a git clone:

mv tilemill tilemill.old
git clone git@github.com:mapbox/tilemill.git

Bring your files directory with you - it contains all projects, exports and settings:

cp -r tilemill.old/files tilemill

Install TileMill as usual:

cd tilemill
./ndistro

To update your dev version, clean your copy and rebuild:

git pull
./ndistro clean
./ndistro

Contributors

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.