Leaflet/download.md
2013-02-06 16:03:22 +02:00

62 lines
2.5 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/Leaflet/Leaflet/zipball/v0.5.1">Leaflet 0.5.1</a></td>
<td>Stable version, released on January 17, 2013 and last updated on February 6, 2013</td>
</tr>
<tr>
<td class="width100"><a href="https://github.com/Leaflet/Leaflet/zipball/v0.4.5">Leaflet 0.4.5</a></td>
<td>Previous stable version, released on July 30, 2012 and last updated on October 25, 2012</td>
</tr>
<tr>
<td><a href="http://github.com/Leaflet/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/Leaflet/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.5.1/leaflet.css" />
<!--[if lte IE 8]>
<link rel="stylesheet" href="http://cdn.leafletjs.com/leaflet-0.5.1/leaflet.ie.css" />
<![endif]-->
<script src="http://cdn.leafletjs.com/leaflet-0.5.1/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.