Leaflet/download.md
2013-01-11 13:48:54 +02:00

2.4 KiB

layout title
default Download

Download Leaflet

Besides the library itself, the download package contains full source code, unit tests, files for debugging and a build system. The production files are in the dist folder.

Version Description
Leaflet 0.4.5 Stable version, released on October 25, 2012
Leaflet 0.3.1 Previous stable version, released on February 14, 2012
Leaflet master In-progress version, developed on the master branch

View Changelog

Note that the master version can contain incompatible changes, so please read the changelog carefully when upgrading to it.

Using a Hosted Version of Leaflet

The latest stable release of Leaflet is hosted on a CDN — to start using it straight away, place this code in the head section of your HTML:

<link rel="stylesheet" href="http://cdn.leafletjs.com/leaflet-0.4.5/leaflet.css" />
<!--[if lte IE 8]>
    <link rel="stylesheet" href="http://cdn.leafletjs.com/leaflet-0.4.5/leaflet.ie.css" />
<![endif]-->

<script src="http://cdn.leafletjs.com/leaflet-0.4.5/leaflet.js"></script>

Building Leaflet from the Source

Leaflet build system is powered by the Node.js platform and Jake, JSHint and UglifyJS libraries, which install easily and work well across all major platforms. Here are the steps to install it:

  1. Download and install Node
  2. Run the following commands in the command line:
npm install -g jake
npm install jshint
npm install uglify-js

Now that you have everything installed, run jake inside the Leaflet directory. This will check Leaflet source files for JavaScript errors and inconsistencies, and then combine and compress it to the dist folder.

Building a Custom Version of Leaflet

To make a custom build of the library with only the things you need, open build/build.html page of the package contents, choose the components (it figures out dependencies for you) and then run the command generated with it.