82 lines
3.1 KiB
Markdown
82 lines
3.1 KiB
Markdown
---
|
|
layout: v2
|
|
title: Download
|
|
bodyclass: download-page
|
|
---
|
|
|
|
## Download Leaflet
|
|
|
|
<table>
|
|
<tr>
|
|
<th>Version</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
<tr>
|
|
<td><a href="http://cdn.leafletjs.com/leaflet/v1.0.0/leaflet.zip">Leaflet 1.0.0</a></td>
|
|
<td>Stable version, released on September 27, 2016.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><a href="https://leafletjs-cdn.s3.amazonaws.com/content/leaflet/master/leaflet.zip">Leaflet 1.1-dev</a></td>
|
|
<td>In-progress version, developed on the <code>master</code> branch.</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="width100"><a href="http://cdn.leafletjs.com/leaflet/v0.7.7/leaflet.zip">Leaflet 0.7.7</a></td>
|
|
<td>Legacy version, released on November 18, 2013 and last updated on October 26, 2015.</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 Leaflet release is hosted on a CDN — to start using
|
|
it straight away, place this in the `head` of your HTML code:
|
|
|
|
<link rel="stylesheet" href="https://unpkg.com/leaflet@1.0.0/dist/leaflet.css" />
|
|
<script src="https://unpkg.com/leaflet@1.0.0/dist/leaflet.js"></script>
|
|
|
|
### Using a Downloaded Version of Leaflet
|
|
|
|
Inside the archives downloaded from the above links, you will see four things:
|
|
|
|
- `leaflet.js` - This is the minified Leaflet JavaScript code.
|
|
- `leaflet-src.js` - This is the readable, unminified Leaflet JavaScript, which is sometimes helpful for debugging.
|
|
- `leaflet.css` - This is the stylesheet for Leaflet.
|
|
- `images` - This is a folder that contains images referenced by `leaflet.css`. It must be in the same directory as `leaflet.css`.
|
|
|
|
Unzip the downloaded archive to your website's directory and add this to the `head` of your HTML code:
|
|
|
|
<link rel="stylesheet" href="/path/to/leaflet.css" />
|
|
<script src="/path/to/leaflet.js"></script> <!-- or use leaflet-src.js --!>
|
|
|
|
### Leaflet Source Code
|
|
|
|
These download packages above only contain the library itself.
|
|
If you want to download the full source code, including unit tests, files for debugging, build scripts, etc.,
|
|
you can <a href="https://github.com/Leaflet/Leaflet/releases">download it</a>
|
|
from the <a href="https://github.com/Leaflet/Leaflet">GitHub repository</a>.
|
|
|
|
### Building Leaflet from the Source
|
|
|
|
Leaflet build system is powered by the [Node.js](http://nodejs.org) platform,
|
|
which installs easily and works well across all major platforms.
|
|
Here are the steps to set it up:
|
|
|
|
1. [Download and install Node](http://nodejs.org)
|
|
2. Run the following commands in the command line:
|
|
|
|
<pre><code>npm install -g jake
|
|
npm install</code></pre>
|
|
|
|
Now that you have everything installed, run `jake build` inside the Leaflet directory.
|
|
This will combine and compress the Leaflet source files, saving the build 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 Leaflet source code contents, choose the components
|
|
(it figures out dependencies for you) and then run the command generated with it.
|