|
1 | 1 | # Provenance of dependencies |
2 | 2 |
|
3 | | -## JS file sources |
| 3 | +All external JavaScript and CSS libraries are served locally from this directory to avoid CDN dependencies. |
4 | 4 |
|
5 | | -```bash |
6 | | -wget https://code.jquery.com/jquery-3.4.1.slim.min.js -P js/ |
7 | | -wget https://cdn.jsdelivr.net/npm/ [email protected]/dist/js/bootstrap.min.js -P js/ |
8 | | -wget https://cdn.jsdelivr.net/npm/ [email protected]/dist/js/bootstrap.min.js.map -P js/ |
9 | | -wget https://unpkg.com/ [email protected]/dist/leaflet.js -P js/ |
10 | | -wget https://unpkg.com/ [email protected]/dist/leaflet.js.map -P js/ |
11 | | -``` |
| 5 | +## Automated Download Script |
12 | 6 |
|
13 | | -Required for Bootstrap tooltips in REST Framework UI: |
| 7 | +Run the download script to update all libraries to their specified versions: |
14 | 8 |
|
15 | 9 | ```bash |
16 | | -wget https://unpkg.com/@popperjs/core@2 -O js/popper.js |
| 10 | +cd publications/static |
| 11 | +./download_libraries.sh |
17 | 12 | ``` |
18 | 13 |
|
19 | | -## CSS file sources |
| 14 | +This script downloads all dependencies listed below. |
20 | 15 |
|
21 | | -```bash |
22 | | -wget https://cdn.jsdelivr.net/npm/ [email protected]/dist/css/bootstrap.min.css -P css/ |
23 | | -wget https://cdn.jsdelivr.net/npm/ [email protected]/dist/css/bootstrap.min.css.map -P css/ |
24 | | -wget https://unpkg.com/ [email protected]/dist/leaflet.css -P css/ |
25 | | - |
26 | | -wget https://unpkg.com/ [email protected]/dist/images/marker-icon.png -P css/images |
27 | | -wget https://unpkg.com/ [email protected]/dist/images/marker-icon-2x.png -P css/images |
28 | | -wget https://unpkg.com/ [email protected]/dist/images/marker-shadow.png -P css/images |
29 | | -wget https://unpkg.com/ [email protected]/dist/images/layers.png -P css/images |
30 | | -wget https://unpkg.com/ [email protected]/dist/images/layers-2x.png -P css/images |
31 | | -``` |
| 16 | +## JS Libraries |
| 17 | + |
| 18 | +### Core Libraries |
| 19 | + |
| 20 | +- **jQuery 3.4.1** - MIT License |
| 21 | + - Source: https://code.jquery.com/jquery-3.4.1.slim.min.js |
| 22 | + - Files: `js/jquery-3.4.1.slim.min.js` |
| 23 | + |
| 24 | +- **Bootstrap 4.4.1** - MIT License |
| 25 | + - Source: https://cdn.jsdelivr.net/npm/[email protected]/dist/js/ |
| 26 | + - Files: `js/bootstrap.min.js`, `js/bootstrap.min.js.map` |
| 27 | + |
| 28 | +- **Popper.js 2.x** - MIT License (required for Bootstrap tooltips) |
| 29 | + - Source: https://unpkg.com/@popperjs/core@2/dist/umd/ |
| 30 | + - Files: `js/popper.min.js` |
| 31 | + |
| 32 | +### Leaflet and Plugins |
| 33 | + |
| 34 | +- **Leaflet 1.9.4** - BSD-2-Clause License |
| 35 | + - Source: https://unpkg.com/[email protected]/dist/ |
| 36 | + - Files: `js/leaflet.js`, `js/leaflet.js.map` |
| 37 | + - Homepage: https://leafletjs.com/ |
| 38 | + |
| 39 | +- **Leaflet Draw 1.0.4** - MIT License |
| 40 | + - Source: https://unpkg.com/[email protected]/dist/ |
| 41 | + - Files: `js/leaflet.draw.js` |
| 42 | + - Homepage: https://github.com/Leaflet/Leaflet.draw |
| 43 | + |
| 44 | +- **Leaflet Fullscreen 3.0.2** - MIT License |
| 45 | + - Source: https://unpkg.com/[email protected]/ |
| 46 | + - Files: `js/leaflet.fullscreen.js` |
| 47 | + - Homepage: https://github.com/brunob/leaflet.fullscreen |
| 48 | + |
| 49 | +### Other Libraries |
| 50 | + |
| 51 | +- **Bootstrap Datepicker 1.9.0** - Apache License 2.0 |
| 52 | + - Source: https://cdnjs.cloudflare.com/ajax/libs/bootstrap-datepicker/1.9.0/ |
| 53 | + - Files: `js/bootstrap-datepicker.min.js` |
| 54 | + - Homepage: https://github.com/uxsolutions/bootstrap-datepicker |
| 55 | + |
| 56 | +## CSS Libraries |
| 57 | + |
| 58 | +### Core Stylesheets |
| 59 | + |
| 60 | +- **Bootstrap 4.4.1** - MIT License |
| 61 | + - Source: https://cdn.jsdelivr.net/npm/[email protected]/dist/css/ |
| 62 | + - Files: `css/bootstrap.min.css`, `css/bootstrap.min.css.map` |
| 63 | + |
| 64 | +- **Leaflet 1.9.4** - BSD-2-Clause License |
| 65 | + - Source: https://unpkg.com/[email protected]/dist/ |
| 66 | + - Files: `css/leaflet.css` |
| 67 | + |
| 68 | +- **Leaflet Draw 1.0.4** - MIT License |
| 69 | + - Source: https://unpkg.com/[email protected]/dist/ |
| 70 | + - Files: `css/leaflet.draw.css` |
| 71 | + |
| 72 | +- **Leaflet Fullscreen 3.0.2** - MIT License |
| 73 | + - Source: https://unpkg.com/[email protected]/ |
| 74 | + - Files: `css/leaflet.fullscreen.css` |
| 75 | + |
| 76 | +- **Bootstrap Datepicker 1.9.0** - Apache License 2.0 |
| 77 | + - Source: https://cdnjs.cloudflare.com/ajax/libs/bootstrap-datepicker/1.9.0/ |
| 78 | + - Files: `css/bootstrap-datepicker.min.css` |
| 79 | + |
| 80 | +### Fonts |
| 81 | + |
| 82 | +- **Font Awesome 4.7.0** - Font: SIL OFL 1.1, CSS: MIT License |
| 83 | + - Source: https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/ |
| 84 | + - Files: `css/font-awesome.min.css`, `css/fonts/fontawesome-webfont.*` |
| 85 | + - Homepage: https://fontawesome.com/ |
| 86 | + |
| 87 | +## Images |
| 88 | + |
| 89 | +### Leaflet Marker Icons |
| 90 | + |
| 91 | +- **Default Leaflet Markers** - BSD-2-Clause License |
| 92 | + - Source: https://unpkg.com/[email protected]/dist/images/ |
| 93 | + - Files: `css/images/marker-icon*.png`, `css/images/marker-shadow.png`, `css/images/layers*.png` |
| 94 | + |
| 95 | +- **Leaflet Draw Sprites** - MIT License |
| 96 | + - Source: https://unpkg.com/[email protected]/dist/images/ |
| 97 | + - Files: `css/images/spritesheet*.png`, `css/images/spritesheet.svg` |
| 98 | + |
| 99 | +- **Leaflet Fullscreen Icons** - MIT License |
| 100 | + - Source: https://unpkg.com/[email protected]/ |
| 101 | + - Files: `css/images/fullscreen/icon-fullscreen*.png` |
| 102 | + |
| 103 | +### Colored Markers |
32 | 104 |
|
33 | | -## Fonts |
| 105 | +- **Leaflet Color Markers** - BSD-2-Clause License |
| 106 | + - Source: https://github.com/pointhi/leaflet-color-markers |
| 107 | + - Files: `css/images/marker-icon-{color}.png`, `css/images/marker-icon-2x-{color}.png` |
| 108 | + - Colors available: red, orange, gold, blue (and others in upstream repo) |
| 109 | + - Used for highlighting selected features on the map |
| 110 | + - License: https://github.com/pointhi/leaflet-color-markers/blob/master/LICENSE |
34 | 111 |
|
35 | | -<https://use.fontawesome.com/releases/v6.2.1/fontawesome-free-6.2.1-web.zip> |
| 112 | +## License Compliance |
36 | 113 |
|
37 | | -See <https://fontawesome.com/docs/web/setup/host-yourself/webfonts>. |
38 | | -We only use the (free) 'solid' variant of CSS and fonts. |
| 114 | +All libraries used are open-source with permissive licenses (MIT, BSD-2-Clause, Apache 2.0, SIL OFL 1.1). |
| 115 | +See individual library homepages for full license texts. |
0 commit comments