Have ideas to improve npm?Join in the discussion! »

    tilemill

    0.10.1 • Public • Published

    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.

    Running tests

    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

    Documentation

    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/
    

    Syncing manual

    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/
    

    Install

    npm i tilemill

    DownloadsWeekly Downloads

    24

    Version

    0.10.1

    License

    none

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar
    • avatar
    • avatar