62 lines
2.4 KiB
Markdown
62 lines
2.4 KiB
Markdown
---
|
|
layout: default
|
|
title: 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.
|
|
|
|
<table>
|
|
<tr>
|
|
<th>Version</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
<tr>
|
|
<td class="width100"><a href="https://github.com/CloudMade/Leaflet/zipball/v0.4.4">Leaflet 0.4.4</a></td>
|
|
<td>Stable version, released on August 7, 2012</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="width100"><a href="https://github.com/CloudMade/Leaflet/zipball/v0.3.1">Leaflet 0.3.1</a></td>
|
|
<td>Previous stable version, released on February 14, 2012</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a href="http://github.com/CloudMade/Leaflet/zipball/master">Leaflet master</a></td>
|
|
<td>In-progress version, developed on the <code>master</code> branch</td>
|
|
</tr>
|
|
</table>
|
|
|
|
[View Changelog](https://github.com/CloudMade/Leaflet/blob/master/CHANGELOG.md)
|
|
|
|
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.4/leaflet.css" />
|
|
<!--[if lte IE 8]>
|
|
<link rel="stylesheet" href="http://cdn.leafletjs.com/leaflet-0.4.4/leaflet.ie.css" />
|
|
<![endif]-->
|
|
|
|
<script src="http://cdn.leafletjs.com/leaflet-0.4.4/leaflet.js"></script>
|
|
|
|
### Building Leaflet from the Source
|
|
|
|
Leaflet build system is powered by the [Node.js](http://nodejs.org) 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](http://nodejs.org)
|
|
2. Run the following commands in the command line:
|
|
|
|
<pre><code class="no-highlight">npm install -g jake
|
|
npm install jshint
|
|
npm install uglify-js
|
|
</code></pre>
|
|
|
|
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.
|