https://github.com/Esri/esri-leaflet-doc
Documentation, API Reference and Samples
https://github.com/Esri/esri-leaflet-doc
Last synced: 3 months ago
JSON representation
Documentation, API Reference and Samples
- Host: GitHub
- URL: https://github.com/Esri/esri-leaflet-doc
- Owner: Esri
- License: apache-2.0
- Archived: true
- Created: 2015-03-01T00:05:38.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2023-08-15T17:33:52.000Z (about 2 years ago)
- Last Synced: 2024-08-25T00:55:58.673Z (about 1 year ago)
- Language: Handlebars
- Homepage: https://esri.github.io/esri-leaflet/
- Size: 4.67 MB
- Stars: 81
- Watchers: 25
- Forks: 1,125
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> The official Esri Leaflet documentation has moved to [developers.arcgis.com/esri-leaflet](https://developers.arcgis.com/esri-leaflet/), and this repository is archived. If you have any suggestions or contributions for the documentation going forward, please [log an issue in the Esri Leaflet repository](https://github.com/Esri/esri-leaflet/issues/new/choose) (select "Documentation").
# Esri Leaflet Documentation Site
## Instructions
1. Clone this repository.
2. `npm install -g grunt-cli`
3. `npm install`
4. Create a new file, `data/secret.json` to include an API Key:
```
{
"api_key": "YOUR API KEY HERE"
}
```
4. `npm start`
In order to update the version of Leaflet, Esri Leaflet or any other plugin displayed in the documentation site:
1. Find and update the appropriate library version listed in `package.json` [devDependency](https://github.com/Esri/esri-leaflet-doc/blob/master/package.json).
2. Rerun `npm install`.
3. Run `npm run integrity` (to generate a corresponding [Subresource Integrity](https://w3c.github.io/webappsec-subresource-integrity/) hash).
4. Run `npm start` to confirm locally that this achieved the desired effect.
5. Send a Pull Request!
### Development Tips
#### Testing/Linting
Before committing, run `npm test`, which will run [ESLint](https://eslint.org/) (enforcing the [Semistandard style](https://github.com/standard/semistandard)) on all our sample code to ensure the samples are consistently formatted.
File changes will be watched and also linted with ESLint if you have run `npm start` prior to editing the samples.
#### VS Code
If you're using [VS Code](https://code.visualstudio.com/) and the [ESLint Extension](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint), you can create a new file at `.vscode/settings.json` with the following contents to enable live linting on the HBS files:
```json
{
"eslint.validate": [
"javascript",
"javascriptreact",
"handlebars"
]
}
```
#### Local Esri-Leaflet
If you're working on changes to esri-leaflet locally and want to see those changes within the context of the documentation site:
1. Run `npm start` in the `esri-leaflet` project. This will host the built esri-leaflet file at `http://localhost:5000/dist/esri-leaflet-debug.js` or similar.
1. In this repository, in `\data\devSiteData.json`, set the `localSource` property to `true` and set the `localSourceUrl` property to the full url of your `esri-leaflet-debug.js` file if it's not the same as above.
1. Run `npm start` in this project, and the documentation site will be hosted but load the `esri-leaflet` library locally instead of the CDN version.
## Issues
Find a typo or other problem on the website? Please let us know by submitting an [issue](https://github.com/Esri/esri-leaflet-doc/issues).
## Contributing
Esri welcomes contributions from anyone and everyone. Please see our [guidelines for contributing](https://github.com/Esri/esri-leaflet/blob/master/CONTRIBUTING.md).
## Licensing
Copyright © 2015-2019 Esri
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
> http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
A copy of the license is available in the repository's [LICENSE](./LICENSE) file.