js.leaflet 1.0.0b2
Fanstatic packaging of Leaflet
License: BSD
Keywords: javascript mapping map leaflet js openlayers

js.leaflet
***********

Introduction
============

This library packages the `Leaflet`_ JavaScript mapping library for
`fanstatic`_.

.. _`fanstatic`: http://fanstatic.org
.. _`Leaflet`: http://leafletjs.com/

This requires integration between your web framework and ``fanstatic``,
and making sure that the original resources (shipped in the ``resources``
directory in ``js.leaflet``) are published to some URL.  As a bonus, this
library also packages up minified versions of the original CSS resources.

Packaging
=========

.. image:: https://travis-ci.org/davidjb/js.leaflet.png?branch=master
    :target: https://travis-ci.org/davidjb/js.leaflet

The packaging is stored on GitHub at
https://github.com/davidjb/js.leaflet. If you happen to come across a bug
that corresponds to *packaging*, then please report it here. Pull requests are
more than welcome if you're fixing something yourself -- the more help the
better!

Any other bugs that relate to the library itself should be directed to the
original developers.

Development of this package
---------------------------

This process requires installation of the package for development - the
suggested method to do this is via the `Buildout` within this package::

    cd js.leaflet
    python boostrap.py
    ./bin/buildout

Running tests
-------------

After running the `Buildout` within this package, do this:

    ./bin/tox

...and watch the magic unfold.

Updating this package
---------------------

In order to obtain a newer version of this library, do the following 
(substituting the version number for the newer version)::

    LEAFLET_VERSION=1.0.0-b1
    pushd js/leaflet/resources
    wget http://cdn.leafletjs.com/downloads/leaflet-$LEAFLET_VERSION.zip -O leaflet.zip
    #Overwrites older files with new ones
    unzip -o leaflet.zip
    rm leaflet.zip
    popd
    #Edit changelog, setup.py for versions, etc here
    ./bin/fanstatic-compile -v js
    git add js
    git commit -a -m "Updated for release $LEAFLET_VERSION"
    git push

If you're doing this out in your own fork of the GitHub repository, then
send through a pull request so everyone can benefit from the updated 
library.

Usage
=====

You can import ``leaflet`` from ``js.leaflet`` and ``need`` it where you want
these resources to be included on a page::

  >>> from js.leaflet import leaflet
  >>> leaflet.need()


CHANGES
*******

1.0.0b2 (2015-11-11)
====================

- Update Leaflet to 1.0.0-beta.2.
  [davidjb]
- Update Leaflet to master to incorporate fix for https://github.com/Leaflet/Leaflet/issues/3606.
  [davidjb]


1.0.0b1 (2015-07-20)
====================

- Update Leaflet to v1.0.0-b1.  This removes the IE style sheets and
  resources, which are now incorprated in ``leaflet.css``.
  [davidjb]
- Update Buildout bootstrap to v2.
  [davidjb]


0.7.1 (2014-01-06)
==================

- Upgraded Leaflet to v0.7.1.
  [davidjb]


0.6.3 (2013-07-18)
==================

- Upgraded Leaflet to v0.6.3.
  [davidjb]


0.6.2 (2013-07-03)
==================

- Upgraded Leaflet to v0.6.2.
  [davidjb]
- Use Fanstatic for minification of CSS. This library now requires Fanstatic
  1.0a or above.
  [davidjb]
- Fix typo in library name.
  [davidjb]
- Add tox and Travis CI support.
  [davidjb]


0.5 (2013-02-04)
================

- Upgraded Leaflet to v0.5.
  [davidjb]


0.4.5 (2013-01-07)
==================

- Initial release.