@basemaps/landing 7.12.0 → 7.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/build/components/layer.switcher.dropdown.js +1 -0
- package/build/components/layer.switcher.dropdown.js.map +1 -1
- package/build/components/map.js +11 -13
- package/build/components/map.js.map +1 -1
- package/build/components/map.label.js +1 -1
- package/build/components/map.label.js.map +1 -1
- package/build/config.map.js +6 -0
- package/build/config.map.js.map +1 -1
- package/dist/android-chrome-192x192.png +0 -0
- package/dist/android-chrome-512x512.png +0 -0
- package/dist/apple-touch-icon.png +0 -0
- package/dist/assets/clear.svg +1 -0
- package/dist/assets/fonts/OpenSans-Bold.woff2 +0 -0
- package/dist/assets/fonts/OpenSans-Italic.woff2 +0 -0
- package/dist/assets/fonts/OpenSans-Light.woff2 +0 -0
- package/dist/assets/fonts/OpenSans-Regular.woff2 +0 -0
- package/dist/assets/fonts/OpenSans-SemiBold.woff2 +0 -0
- package/dist/assets/logo-linz.svg +124 -0
- package/dist/assets/logo-nz-govt.svg +196 -0
- package/dist/assets/whats_new_updates.svg +1 -0
- package/dist/basemaps-card.jpeg +0 -0
- package/dist/docs/404.html +71 -31
- package/dist/docs/assets/javascripts/bundle.83f73b43.min.js +16 -0
- package/dist/docs/assets/javascripts/bundle.83f73b43.min.js.map +7 -0
- package/dist/docs/assets/javascripts/swagger-ui-bundle.js +1 -2
- package/dist/docs/assets/javascripts/swagger-ui-bundle.js.map +1 -1
- package/dist/docs/assets/javascripts/swagger-ui-standalone-preset.js +1 -2
- package/dist/docs/assets/javascripts/swagger-ui-standalone-preset.js.map +1 -1
- package/dist/docs/assets/javascripts/workers/{search.f886a092.min.js → search.6ce7567c.min.js} +3 -3
- package/dist/docs/assets/javascripts/workers/{search.f886a092.min.js.map → search.6ce7567c.min.js.map} +2 -2
- package/dist/docs/assets/stylesheets/main.0253249f.min.css +1 -0
- package/dist/docs/assets/stylesheets/main.0253249f.min.css.map +1 -0
- package/dist/docs/assets/stylesheets/palette.06af60db.min.css +1 -0
- package/dist/docs/assets/stylesheets/palette.06af60db.min.css.map +1 -0
- package/dist/docs/assets/stylesheets/swagger-ui-dark.css +16 -0
- package/dist/docs/assets/stylesheets/swagger-ui.css +1 -1
- package/dist/docs/assets/stylesheets/swagger-ui.css.map +1 -1
- package/dist/docs/configuration/index.html +25 -17
- package/dist/docs/deployment/index.html +25 -17
- package/dist/docs/developer-guide/cli-methods/bundle-the-basemaps-assets-archive/index.html +748 -0
- package/dist/docs/developer-guide/cli-methods/bundle-the-basemaps-config-file/index.html +33 -26
- package/dist/docs/developer-guide/index.html +25 -17
- package/dist/docs/developer-guide/run-basemaps-locally/index.html +33 -18
- package/dist/docs/developer-guide/server-methods/serve-basemaps-with-bundled-config-file/index.html +98 -30
- package/dist/docs/developer-guide/server-methods/serve-basemaps-with-collection-of-geotiff-files/index.html +29 -22
- package/dist/docs/examples/_overview/index.html +25 -17
- package/dist/docs/examples/leaflet.xyz.3857/index.html +25 -17
- package/dist/docs/examples/maplibre.opacity.3857/index.html +25 -17
- package/dist/docs/examples/maplibre.vector.3857/index.html +25 -17
- package/dist/docs/index.html +25 -17
- package/dist/docs/operator-guide/cog-quality/index.html +25 -17
- package/dist/docs/operator-guide/empty-tiles/index.html +31 -19
- package/dist/docs/operator-guide/gebco/index.html +25 -17
- package/dist/docs/operator-guide/index.html +25 -17
- package/dist/docs/operator-guide/quick-start/index.html +25 -17
- package/dist/docs/operator-guide/relief-shade/index.html +25 -17
- package/dist/docs/operator-guide/texture-shade/index.html +25 -17
- package/dist/docs/operator-guide/xyz-projection/index.html +25 -17
- package/dist/docs/quick-start/index.html +25 -17
- package/dist/docs/sitemap.xml +28 -48
- package/dist/docs/sitemap.xml.gz +0 -0
- package/dist/docs/user-guide/_get-started/index.html +25 -17
- package/dist/docs/user-guide/api-documentation/index.html +26 -18
- package/dist/docs/user-guide/api-documentation/{swagger-ccf476ba.html → swagger-be89a08e.html} +1 -1
- package/dist/docs/user-guide/technical-documentation/index.html +25 -17
- package/dist/examples/index.html +34 -0
- package/dist/examples/index.leaflet.xyz.3857.html +43 -0
- package/dist/examples/index.maplibre.compare.3857.html +111 -0
- package/dist/examples/index.maplibre.elevation.3857.html +100 -0
- package/dist/examples/index.maplibre.opacity.3857.html +218 -0
- package/dist/examples/index.maplibre.vector.3857.html +48 -0
- package/dist/examples/index.openlayers.attribution.wmts.3857.html +55 -0
- package/dist/examples/index.openlayers.wmts.3857.html +49 -0
- package/dist/examples/index.openlayers.xyz.3857.html +49 -0
- package/dist/favicon-16x16.png +0 -0
- package/dist/favicon-32x32.png +0 -0
- package/dist/favicon.ico +0 -0
- package/dist/index-7.13.0-c5e57c4593cca04a.css +7686 -0
- package/dist/index-7.13.0-ee1085e6b02ac062.js +65655 -0
- package/dist/index.css +7686 -0
- package/dist/index.html +24 -0
- package/dist/index.js +65655 -0
- package/dist/json-schema/stac-basemaps-extension/1.0/schema.json +144 -0
- package/dist/lib/attribution-7.13.0-6b67bd96f9957d4a.js +10438 -0
- package/dist/lib/attribution.js +10438 -0
- package/package.json +3 -3
- package/dist/docs/assets/javascripts/bundle.6c14ae12.min.js +0 -29
- package/dist/docs/assets/javascripts/bundle.6c14ae12.min.js.map +0 -7
- package/dist/docs/assets/stylesheets/main.fad675c6.min.css +0 -1
- package/dist/docs/assets/stylesheets/main.fad675c6.min.css.map +0 -1
- package/dist/docs/assets/stylesheets/palette.356b1318.min.css +0 -1
- package/dist/docs/assets/stylesheets/palette.356b1318.min.css.map +0 -1
|
@@ -0,0 +1,748 @@
|
|
|
1
|
+
|
|
2
|
+
<!DOCTYPE html>
|
|
3
|
+
|
|
4
|
+
<html class="no-js" lang="en">
|
|
5
|
+
<head>
|
|
6
|
+
<meta charset="utf-8"/>
|
|
7
|
+
<meta content="width=device-width,initial-scale=1" name="viewport"/>
|
|
8
|
+
<link href="http://localhost:8000/docs/developer-guide/cli-methods/bundle-the-basemaps-assets-archive/" rel="canonical"/>
|
|
9
|
+
<link href="../../run-basemaps-locally/" rel="prev"/>
|
|
10
|
+
<link href="../bundle-the-basemaps-config-file/" rel="next"/>
|
|
11
|
+
<link href="../../../assets/images/favicon.png" rel="icon"/>
|
|
12
|
+
<meta content="mkdocs-1.6.1, mkdocs-material-9.5.44" name="generator"/>
|
|
13
|
+
<title>Bundle the basemaps assets archive - LINZ Basemaps</title>
|
|
14
|
+
<link href="../../../assets/stylesheets/main.0253249f.min.css" rel="stylesheet"/>
|
|
15
|
+
<link href="../../../assets/stylesheets/palette.06af60db.min.css" rel="stylesheet"/>
|
|
16
|
+
<link crossorigin="" href="https://fonts.gstatic.com" rel="preconnect"/>
|
|
17
|
+
<link href="https://fonts.googleapis.com/css?family=Open+Sans:300,300i,400,400i,700,700i%7COpen+Sans+Mono:400,400i,700,700i&display=fallback" rel="stylesheet"/>
|
|
18
|
+
<style>:root{--md-text-font:"Open Sans";--md-code-font:"Open Sans Mono"}</style>
|
|
19
|
+
<link href="../../../index.css" rel="stylesheet"/>
|
|
20
|
+
<script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
|
|
21
|
+
<script id="__analytics">function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config",""),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script>
|
|
22
|
+
<script>"undefined"!=typeof __md_analytics&&__md_analytics()</script>
|
|
23
|
+
</head>
|
|
24
|
+
<body data-md-color-accent="indigo" data-md-color-primary="indigo" data-md-color-scheme="default" dir="ltr">
|
|
25
|
+
<input autocomplete="off" class="md-toggle" data-md-toggle="drawer" id="__drawer" type="checkbox"/>
|
|
26
|
+
<input autocomplete="off" class="md-toggle" data-md-toggle="search" id="__search" type="checkbox"/>
|
|
27
|
+
<label class="md-overlay" for="__drawer"></label>
|
|
28
|
+
<div data-md-component="skip">
|
|
29
|
+
<a class="md-skip" href="#bundle-the-basemaps-assets-archive">
|
|
30
|
+
Skip to content
|
|
31
|
+
</a>
|
|
32
|
+
</div>
|
|
33
|
+
<div data-md-component="announce">
|
|
34
|
+
</div>
|
|
35
|
+
<header class="md-header md-header--shadow" data-md-component="header">
|
|
36
|
+
<nav aria-label="Header" class="md-header__inner md-grid">
|
|
37
|
+
<a aria-label="LINZ Basemaps" class="md-header__button md-logo" data-md-component="logo" href="../../.." title="LINZ Basemaps">
|
|
38
|
+
<img alt="logo" src="../../../linz-motif.svg"/>
|
|
39
|
+
</a>
|
|
40
|
+
<label class="md-header__button md-icon" for="__drawer">
|
|
41
|
+
<svg viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"></path></svg>
|
|
42
|
+
</label>
|
|
43
|
+
<div class="md-header__title" data-md-component="header-title">
|
|
44
|
+
<div class="md-header__ellipsis">
|
|
45
|
+
<div class="md-header__topic">
|
|
46
|
+
<span class="md-ellipsis">
|
|
47
|
+
LINZ Basemaps
|
|
48
|
+
</span>
|
|
49
|
+
</div>
|
|
50
|
+
<div class="md-header__topic" data-md-component="header-topic">
|
|
51
|
+
<span class="md-ellipsis">
|
|
52
|
+
|
|
53
|
+
Bundle the basemaps assets archive
|
|
54
|
+
|
|
55
|
+
</span>
|
|
56
|
+
</div>
|
|
57
|
+
</div>
|
|
58
|
+
</div>
|
|
59
|
+
<form class="md-header__option" data-md-component="palette">
|
|
60
|
+
<input aria-label="Switch to dark mode" class="md-option" data-md-color-accent="indigo" data-md-color-media="(prefers-color-scheme: light)" data-md-color-primary="indigo" data-md-color-scheme="default" id="__palette_0" name="__palette" type="radio"/>
|
|
61
|
+
<label class="md-header__button md-icon" for="__palette_1" hidden="" title="Switch to dark mode">
|
|
62
|
+
<svg viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"></path></svg>
|
|
63
|
+
</label>
|
|
64
|
+
<input aria-label="Switch to light mode" class="md-option" data-md-color-accent="indigo" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-primary="indigo" data-md-color-scheme="slate" id="__palette_1" name="__palette" type="radio"/>
|
|
65
|
+
<label class="md-header__button md-icon" for="__palette_0" hidden="" title="Switch to light mode">
|
|
66
|
+
<svg viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"></path></svg>
|
|
67
|
+
</label>
|
|
68
|
+
</form>
|
|
69
|
+
<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
|
|
70
|
+
<div class="md-header__source">
|
|
71
|
+
<a class="md-source" data-md-component="source" href="https://github.com/linz/basemaps" title="Go to repository">
|
|
72
|
+
<div class="md-source__icon md-icon">
|
|
73
|
+
<svg viewbox="0 0 448 512" xmlns="http://www.w3.org/2000/svg"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"></path></svg>
|
|
74
|
+
</div>
|
|
75
|
+
<div class="md-source__repository">
|
|
76
|
+
GitHub
|
|
77
|
+
</div>
|
|
78
|
+
</a>
|
|
79
|
+
</div>
|
|
80
|
+
</nav>
|
|
81
|
+
</header>
|
|
82
|
+
<div class="md-container" data-md-component="container">
|
|
83
|
+
<main class="md-main" data-md-component="main">
|
|
84
|
+
<div class="md-main__inner md-grid">
|
|
85
|
+
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation">
|
|
86
|
+
<div class="md-sidebar__scrollwrap">
|
|
87
|
+
<div class="md-sidebar__inner">
|
|
88
|
+
<nav aria-label="Navigation" class="md-nav md-nav--primary" data-md-level="0">
|
|
89
|
+
<label class="md-nav__title" for="__drawer">
|
|
90
|
+
<a aria-label="LINZ Basemaps" class="md-nav__button md-logo" data-md-component="logo" href="../../.." title="LINZ Basemaps">
|
|
91
|
+
<img alt="logo" src="../../../linz-motif.svg"/>
|
|
92
|
+
</a>
|
|
93
|
+
LINZ Basemaps
|
|
94
|
+
</label>
|
|
95
|
+
<div class="md-nav__source">
|
|
96
|
+
<a class="md-source" data-md-component="source" href="https://github.com/linz/basemaps" title="Go to repository">
|
|
97
|
+
<div class="md-source__icon md-icon">
|
|
98
|
+
<svg viewbox="0 0 448 512" xmlns="http://www.w3.org/2000/svg"><!--! Font Awesome Free 6.6.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"></path></svg>
|
|
99
|
+
</div>
|
|
100
|
+
<div class="md-source__repository">
|
|
101
|
+
GitHub
|
|
102
|
+
</div>
|
|
103
|
+
</a>
|
|
104
|
+
</div>
|
|
105
|
+
<ul class="md-nav__list" data-md-scrollfix="">
|
|
106
|
+
<li class="md-nav__item">
|
|
107
|
+
<a class="md-nav__link" href="../../..">
|
|
108
|
+
<span class="md-ellipsis">
|
|
109
|
+
LINZ Basemaps
|
|
110
|
+
</span>
|
|
111
|
+
</a>
|
|
112
|
+
</li>
|
|
113
|
+
<li class="md-nav__item">
|
|
114
|
+
<a class="md-nav__link" href="../../../configuration/">
|
|
115
|
+
<span class="md-ellipsis">
|
|
116
|
+
Configuration
|
|
117
|
+
</span>
|
|
118
|
+
</a>
|
|
119
|
+
</li>
|
|
120
|
+
<li class="md-nav__item">
|
|
121
|
+
<a class="md-nav__link" href="../../../deployment/">
|
|
122
|
+
<span class="md-ellipsis">
|
|
123
|
+
Deployment
|
|
124
|
+
</span>
|
|
125
|
+
</a>
|
|
126
|
+
</li>
|
|
127
|
+
<li class="md-nav__item">
|
|
128
|
+
<a class="md-nav__link" href="../../../quick-start/">
|
|
129
|
+
<span class="md-ellipsis">
|
|
130
|
+
Quick start guide
|
|
131
|
+
</span>
|
|
132
|
+
</a>
|
|
133
|
+
</li>
|
|
134
|
+
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
|
|
135
|
+
<input checked="" class="md-nav__toggle md-toggle" id="__nav_5" type="checkbox"/>
|
|
136
|
+
<div class="md-nav__link md-nav__container">
|
|
137
|
+
<a class="md-nav__link" href="../../">
|
|
138
|
+
<span class="md-ellipsis">
|
|
139
|
+
Developer guide
|
|
140
|
+
</span>
|
|
141
|
+
</a>
|
|
142
|
+
<label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
|
|
143
|
+
<span class="md-nav__icon md-icon"></span>
|
|
144
|
+
</label>
|
|
145
|
+
</div>
|
|
146
|
+
<nav aria-expanded="true" aria-labelledby="__nav_5_label" class="md-nav" data-md-level="1">
|
|
147
|
+
<label class="md-nav__title" for="__nav_5">
|
|
148
|
+
<span class="md-nav__icon md-icon"></span>
|
|
149
|
+
Developer guide
|
|
150
|
+
</label>
|
|
151
|
+
<ul class="md-nav__list" data-md-scrollfix="">
|
|
152
|
+
<li class="md-nav__item">
|
|
153
|
+
<a class="md-nav__link" href="../../run-basemaps-locally/">
|
|
154
|
+
<span class="md-ellipsis">
|
|
155
|
+
How to run basemaps locally
|
|
156
|
+
</span>
|
|
157
|
+
</a>
|
|
158
|
+
</li>
|
|
159
|
+
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
|
|
160
|
+
<input checked="" class="md-nav__toggle md-toggle" id="__nav_5_3" type="checkbox"/>
|
|
161
|
+
<label class="md-nav__link" for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
|
|
162
|
+
<span class="md-ellipsis">
|
|
163
|
+
Cli methods
|
|
164
|
+
</span>
|
|
165
|
+
<span class="md-nav__icon md-icon"></span>
|
|
166
|
+
</label>
|
|
167
|
+
<nav aria-expanded="true" aria-labelledby="__nav_5_3_label" class="md-nav" data-md-level="2">
|
|
168
|
+
<label class="md-nav__title" for="__nav_5_3">
|
|
169
|
+
<span class="md-nav__icon md-icon"></span>
|
|
170
|
+
Cli methods
|
|
171
|
+
</label>
|
|
172
|
+
<ul class="md-nav__list" data-md-scrollfix="">
|
|
173
|
+
<li class="md-nav__item md-nav__item--active">
|
|
174
|
+
<input class="md-nav__toggle md-toggle" id="__toc" type="checkbox"/>
|
|
175
|
+
<label class="md-nav__link md-nav__link--active" for="__toc">
|
|
176
|
+
<span class="md-ellipsis">
|
|
177
|
+
Bundle the basemaps assets archive
|
|
178
|
+
</span>
|
|
179
|
+
<span class="md-nav__icon md-icon"></span>
|
|
180
|
+
</label>
|
|
181
|
+
<a class="md-nav__link md-nav__link--active" href="./">
|
|
182
|
+
<span class="md-ellipsis">
|
|
183
|
+
Bundle the basemaps assets archive
|
|
184
|
+
</span>
|
|
185
|
+
</a>
|
|
186
|
+
<nav aria-label="Table of contents" class="md-nav md-nav--secondary">
|
|
187
|
+
<label class="md-nav__title" for="__toc">
|
|
188
|
+
<span class="md-nav__icon md-icon"></span>
|
|
189
|
+
Table of contents
|
|
190
|
+
</label>
|
|
191
|
+
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix="">
|
|
192
|
+
<li class="md-nav__item">
|
|
193
|
+
<a class="md-nav__link" href="#get-started">
|
|
194
|
+
<span class="md-ellipsis">
|
|
195
|
+
Get started
|
|
196
|
+
</span>
|
|
197
|
+
</a>
|
|
198
|
+
</li>
|
|
199
|
+
<li class="md-nav__item">
|
|
200
|
+
<a class="md-nav__link" href="#generate-the-basemaps-assets">
|
|
201
|
+
<span class="md-ellipsis">
|
|
202
|
+
Generate the basemaps assets
|
|
203
|
+
</span>
|
|
204
|
+
</a>
|
|
205
|
+
<nav aria-label="Generate the basemaps assets" class="md-nav">
|
|
206
|
+
<ul class="md-nav__list">
|
|
207
|
+
<li class="md-nav__item">
|
|
208
|
+
<a class="md-nav__link" href="#1-create-local-directory">
|
|
209
|
+
<span class="md-ellipsis">
|
|
210
|
+
1. Create local directory
|
|
211
|
+
</span>
|
|
212
|
+
</a>
|
|
213
|
+
</li>
|
|
214
|
+
<li class="md-nav__item">
|
|
215
|
+
<a class="md-nav__link" href="#2-convert-fonts-into-pbf-protobuf-encoded-glyphs-files">
|
|
216
|
+
<span class="md-ellipsis">
|
|
217
|
+
2. Convert fonts into .pbf (protobuf-encoded glyphs) files
|
|
218
|
+
</span>
|
|
219
|
+
</a>
|
|
220
|
+
</li>
|
|
221
|
+
<li class="md-nav__item">
|
|
222
|
+
<a class="md-nav__link" href="#3-convert-sprite-files-into-sprite-sheets">
|
|
223
|
+
<span class="md-ellipsis">
|
|
224
|
+
3. Convert sprite files into sprite sheets
|
|
225
|
+
</span>
|
|
226
|
+
</a>
|
|
227
|
+
</li>
|
|
228
|
+
</ul>
|
|
229
|
+
</nav>
|
|
230
|
+
</li>
|
|
231
|
+
<li class="md-nav__item">
|
|
232
|
+
<a class="md-nav__link" href="#run-the-basemapscli-package">
|
|
233
|
+
<span class="md-ellipsis">
|
|
234
|
+
Run the basemaps/cli package
|
|
235
|
+
</span>
|
|
236
|
+
</a>
|
|
237
|
+
<nav aria-label="Run the basemaps/cli package" class="md-nav">
|
|
238
|
+
<ul class="md-nav__list">
|
|
239
|
+
<li class="md-nav__item">
|
|
240
|
+
<a class="md-nav__link" href="#command">
|
|
241
|
+
<span class="md-ellipsis">
|
|
242
|
+
Command
|
|
243
|
+
</span>
|
|
244
|
+
</a>
|
|
245
|
+
</li>
|
|
246
|
+
<li class="md-nav__item">
|
|
247
|
+
<a class="md-nav__link" href="#parameters">
|
|
248
|
+
<span class="md-ellipsis">
|
|
249
|
+
Parameters
|
|
250
|
+
</span>
|
|
251
|
+
</a>
|
|
252
|
+
</li>
|
|
253
|
+
</ul>
|
|
254
|
+
</nav>
|
|
255
|
+
</li>
|
|
256
|
+
</ul>
|
|
257
|
+
</nav>
|
|
258
|
+
</li>
|
|
259
|
+
<li class="md-nav__item">
|
|
260
|
+
<a class="md-nav__link" href="../bundle-the-basemaps-config-file/">
|
|
261
|
+
<span class="md-ellipsis">
|
|
262
|
+
Bundle the basemaps config file
|
|
263
|
+
</span>
|
|
264
|
+
</a>
|
|
265
|
+
</li>
|
|
266
|
+
</ul>
|
|
267
|
+
</nav>
|
|
268
|
+
</li>
|
|
269
|
+
<li class="md-nav__item md-nav__item--nested">
|
|
270
|
+
<input class="md-nav__toggle md-toggle" id="__nav_5_4" type="checkbox"/>
|
|
271
|
+
<label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
|
|
272
|
+
<span class="md-ellipsis">
|
|
273
|
+
Server methods
|
|
274
|
+
</span>
|
|
275
|
+
<span class="md-nav__icon md-icon"></span>
|
|
276
|
+
</label>
|
|
277
|
+
<nav aria-expanded="false" aria-labelledby="__nav_5_4_label" class="md-nav" data-md-level="2">
|
|
278
|
+
<label class="md-nav__title" for="__nav_5_4">
|
|
279
|
+
<span class="md-nav__icon md-icon"></span>
|
|
280
|
+
Server methods
|
|
281
|
+
</label>
|
|
282
|
+
<ul class="md-nav__list" data-md-scrollfix="">
|
|
283
|
+
<li class="md-nav__item">
|
|
284
|
+
<a class="md-nav__link" href="../../server-methods/serve-basemaps-with-bundled-config-file/">
|
|
285
|
+
<span class="md-ellipsis">
|
|
286
|
+
Serve basemaps using a bundled config file
|
|
287
|
+
</span>
|
|
288
|
+
</a>
|
|
289
|
+
</li>
|
|
290
|
+
<li class="md-nav__item">
|
|
291
|
+
<a class="md-nav__link" href="../../server-methods/serve-basemaps-with-collection-of-geotiff-files/">
|
|
292
|
+
<span class="md-ellipsis">
|
|
293
|
+
Serve basemaps using a collection of GeoTIFF files
|
|
294
|
+
</span>
|
|
295
|
+
</a>
|
|
296
|
+
</li>
|
|
297
|
+
</ul>
|
|
298
|
+
</nav>
|
|
299
|
+
</li>
|
|
300
|
+
</ul>
|
|
301
|
+
</nav>
|
|
302
|
+
</li>
|
|
303
|
+
<li class="md-nav__item md-nav__item--nested">
|
|
304
|
+
<input class="md-nav__toggle md-toggle" id="__nav_6" type="checkbox"/>
|
|
305
|
+
<label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
|
|
306
|
+
<span class="md-ellipsis">
|
|
307
|
+
Examples
|
|
308
|
+
</span>
|
|
309
|
+
<span class="md-nav__icon md-icon"></span>
|
|
310
|
+
</label>
|
|
311
|
+
<nav aria-expanded="false" aria-labelledby="__nav_6_label" class="md-nav" data-md-level="1">
|
|
312
|
+
<label class="md-nav__title" for="__nav_6">
|
|
313
|
+
<span class="md-nav__icon md-icon"></span>
|
|
314
|
+
Examples
|
|
315
|
+
</label>
|
|
316
|
+
<ul class="md-nav__list" data-md-scrollfix="">
|
|
317
|
+
<li class="md-nav__item">
|
|
318
|
+
<a class="md-nav__link" href="../../../examples/_overview/">
|
|
319
|
+
<span class="md-ellipsis">
|
|
320
|
+
Overview
|
|
321
|
+
</span>
|
|
322
|
+
</a>
|
|
323
|
+
</li>
|
|
324
|
+
<li class="md-nav__item">
|
|
325
|
+
<a class="md-nav__link" href="../../../examples/leaflet.xyz.3857/">
|
|
326
|
+
<span class="md-ellipsis">
|
|
327
|
+
Leaflet Raster Map
|
|
328
|
+
</span>
|
|
329
|
+
</a>
|
|
330
|
+
</li>
|
|
331
|
+
<li class="md-nav__item">
|
|
332
|
+
<a class="md-nav__link" href="../../../examples/maplibre.opacity.3857/">
|
|
333
|
+
<span class="md-ellipsis">
|
|
334
|
+
Maplibre Opacity Slider
|
|
335
|
+
</span>
|
|
336
|
+
</a>
|
|
337
|
+
</li>
|
|
338
|
+
<li class="md-nav__item">
|
|
339
|
+
<a class="md-nav__link" href="../../../examples/maplibre.vector.3857/">
|
|
340
|
+
<span class="md-ellipsis">
|
|
341
|
+
Maplibre Vector Map
|
|
342
|
+
</span>
|
|
343
|
+
</a>
|
|
344
|
+
</li>
|
|
345
|
+
</ul>
|
|
346
|
+
</nav>
|
|
347
|
+
</li>
|
|
348
|
+
<li class="md-nav__item md-nav__item--nested">
|
|
349
|
+
<input class="md-nav__toggle md-toggle" id="__nav_7" type="checkbox"/>
|
|
350
|
+
<div class="md-nav__link md-nav__container">
|
|
351
|
+
<a class="md-nav__link" href="../../../operator-guide/">
|
|
352
|
+
<span class="md-ellipsis">
|
|
353
|
+
Operator guide
|
|
354
|
+
</span>
|
|
355
|
+
</a>
|
|
356
|
+
<label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
|
|
357
|
+
<span class="md-nav__icon md-icon"></span>
|
|
358
|
+
</label>
|
|
359
|
+
</div>
|
|
360
|
+
<nav aria-expanded="false" aria-labelledby="__nav_7_label" class="md-nav" data-md-level="1">
|
|
361
|
+
<label class="md-nav__title" for="__nav_7">
|
|
362
|
+
<span class="md-nav__icon md-icon"></span>
|
|
363
|
+
Operator guide
|
|
364
|
+
</label>
|
|
365
|
+
<ul class="md-nav__list" data-md-scrollfix="">
|
|
366
|
+
<li class="md-nav__item">
|
|
367
|
+
<a class="md-nav__link" href="../../../operator-guide/cog-quality/">
|
|
368
|
+
<span class="md-ellipsis">
|
|
369
|
+
COG Quality
|
|
370
|
+
</span>
|
|
371
|
+
</a>
|
|
372
|
+
</li>
|
|
373
|
+
<li class="md-nav__item">
|
|
374
|
+
<a class="md-nav__link" href="../../../operator-guide/empty-tiles/">
|
|
375
|
+
<span class="md-ellipsis">
|
|
376
|
+
Sparse Datasets and empty tiles
|
|
377
|
+
</span>
|
|
378
|
+
</a>
|
|
379
|
+
</li>
|
|
380
|
+
<li class="md-nav__item">
|
|
381
|
+
<a class="md-nav__link" href="../../../operator-guide/gebco/">
|
|
382
|
+
<span class="md-ellipsis">
|
|
383
|
+
Gebco re-project to NZTM2000Quad cog file
|
|
384
|
+
</span>
|
|
385
|
+
</a>
|
|
386
|
+
</li>
|
|
387
|
+
<li class="md-nav__item">
|
|
388
|
+
<a class="md-nav__link" href="../../../operator-guide/quick-start/">
|
|
389
|
+
<span class="md-ellipsis">
|
|
390
|
+
Running LINZ Basemaps - Quick Start
|
|
391
|
+
</span>
|
|
392
|
+
</a>
|
|
393
|
+
</li>
|
|
394
|
+
<li class="md-nav__item">
|
|
395
|
+
<a class="md-nav__link" href="../../../operator-guide/relief-shade/">
|
|
396
|
+
<span class="md-ellipsis">
|
|
397
|
+
Relief shade
|
|
398
|
+
</span>
|
|
399
|
+
</a>
|
|
400
|
+
</li>
|
|
401
|
+
<li class="md-nav__item">
|
|
402
|
+
<a class="md-nav__link" href="../../../operator-guide/texture-shade/">
|
|
403
|
+
<span class="md-ellipsis">
|
|
404
|
+
Texture shading
|
|
405
|
+
</span>
|
|
406
|
+
</a>
|
|
407
|
+
</li>
|
|
408
|
+
<li class="md-nav__item">
|
|
409
|
+
<a class="md-nav__link" href="../../../operator-guide/xyz-projection/">
|
|
410
|
+
<span class="md-ellipsis">
|
|
411
|
+
XYZ and projection math
|
|
412
|
+
</span>
|
|
413
|
+
</a>
|
|
414
|
+
</li>
|
|
415
|
+
</ul>
|
|
416
|
+
</nav>
|
|
417
|
+
</li>
|
|
418
|
+
<li class="md-nav__item md-nav__item--nested">
|
|
419
|
+
<input class="md-nav__toggle md-toggle" id="__nav_8" type="checkbox"/>
|
|
420
|
+
<label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
|
|
421
|
+
<span class="md-ellipsis">
|
|
422
|
+
User guide
|
|
423
|
+
</span>
|
|
424
|
+
<span class="md-nav__icon md-icon"></span>
|
|
425
|
+
</label>
|
|
426
|
+
<nav aria-expanded="false" aria-labelledby="__nav_8_label" class="md-nav" data-md-level="1">
|
|
427
|
+
<label class="md-nav__title" for="__nav_8">
|
|
428
|
+
<span class="md-nav__icon md-icon"></span>
|
|
429
|
+
User guide
|
|
430
|
+
</label>
|
|
431
|
+
<ul class="md-nav__list" data-md-scrollfix="">
|
|
432
|
+
<li class="md-nav__item">
|
|
433
|
+
<a class="md-nav__link" href="../../../user-guide/_get-started/">
|
|
434
|
+
<span class="md-ellipsis">
|
|
435
|
+
Get started with LINZ Basemaps
|
|
436
|
+
</span>
|
|
437
|
+
</a>
|
|
438
|
+
</li>
|
|
439
|
+
<li class="md-nav__item">
|
|
440
|
+
<a class="md-nav__link" href="../../../user-guide/api-documentation/">
|
|
441
|
+
<span class="md-ellipsis">
|
|
442
|
+
API documentation
|
|
443
|
+
</span>
|
|
444
|
+
</a>
|
|
445
|
+
</li>
|
|
446
|
+
<li class="md-nav__item">
|
|
447
|
+
<a class="md-nav__link" href="../../../user-guide/technical-documentation/">
|
|
448
|
+
<span class="md-ellipsis">
|
|
449
|
+
Technical documentation and specifications
|
|
450
|
+
</span>
|
|
451
|
+
</a>
|
|
452
|
+
</li>
|
|
453
|
+
</ul>
|
|
454
|
+
</nav>
|
|
455
|
+
</li>
|
|
456
|
+
</ul>
|
|
457
|
+
</nav>
|
|
458
|
+
</div>
|
|
459
|
+
</div>
|
|
460
|
+
</div>
|
|
461
|
+
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc">
|
|
462
|
+
<div class="md-sidebar__scrollwrap">
|
|
463
|
+
<div class="md-sidebar__inner">
|
|
464
|
+
<nav aria-label="Table of contents" class="md-nav md-nav--secondary">
|
|
465
|
+
<label class="md-nav__title" for="__toc">
|
|
466
|
+
<span class="md-nav__icon md-icon"></span>
|
|
467
|
+
Table of contents
|
|
468
|
+
</label>
|
|
469
|
+
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix="">
|
|
470
|
+
<li class="md-nav__item">
|
|
471
|
+
<a class="md-nav__link" href="#get-started">
|
|
472
|
+
<span class="md-ellipsis">
|
|
473
|
+
Get started
|
|
474
|
+
</span>
|
|
475
|
+
</a>
|
|
476
|
+
</li>
|
|
477
|
+
<li class="md-nav__item">
|
|
478
|
+
<a class="md-nav__link" href="#generate-the-basemaps-assets">
|
|
479
|
+
<span class="md-ellipsis">
|
|
480
|
+
Generate the basemaps assets
|
|
481
|
+
</span>
|
|
482
|
+
</a>
|
|
483
|
+
<nav aria-label="Generate the basemaps assets" class="md-nav">
|
|
484
|
+
<ul class="md-nav__list">
|
|
485
|
+
<li class="md-nav__item">
|
|
486
|
+
<a class="md-nav__link" href="#1-create-local-directory">
|
|
487
|
+
<span class="md-ellipsis">
|
|
488
|
+
1. Create local directory
|
|
489
|
+
</span>
|
|
490
|
+
</a>
|
|
491
|
+
</li>
|
|
492
|
+
<li class="md-nav__item">
|
|
493
|
+
<a class="md-nav__link" href="#2-convert-fonts-into-pbf-protobuf-encoded-glyphs-files">
|
|
494
|
+
<span class="md-ellipsis">
|
|
495
|
+
2. Convert fonts into .pbf (protobuf-encoded glyphs) files
|
|
496
|
+
</span>
|
|
497
|
+
</a>
|
|
498
|
+
</li>
|
|
499
|
+
<li class="md-nav__item">
|
|
500
|
+
<a class="md-nav__link" href="#3-convert-sprite-files-into-sprite-sheets">
|
|
501
|
+
<span class="md-ellipsis">
|
|
502
|
+
3. Convert sprite files into sprite sheets
|
|
503
|
+
</span>
|
|
504
|
+
</a>
|
|
505
|
+
</li>
|
|
506
|
+
</ul>
|
|
507
|
+
</nav>
|
|
508
|
+
</li>
|
|
509
|
+
<li class="md-nav__item">
|
|
510
|
+
<a class="md-nav__link" href="#run-the-basemapscli-package">
|
|
511
|
+
<span class="md-ellipsis">
|
|
512
|
+
Run the basemaps/cli package
|
|
513
|
+
</span>
|
|
514
|
+
</a>
|
|
515
|
+
<nav aria-label="Run the basemaps/cli package" class="md-nav">
|
|
516
|
+
<ul class="md-nav__list">
|
|
517
|
+
<li class="md-nav__item">
|
|
518
|
+
<a class="md-nav__link" href="#command">
|
|
519
|
+
<span class="md-ellipsis">
|
|
520
|
+
Command
|
|
521
|
+
</span>
|
|
522
|
+
</a>
|
|
523
|
+
</li>
|
|
524
|
+
<li class="md-nav__item">
|
|
525
|
+
<a class="md-nav__link" href="#parameters">
|
|
526
|
+
<span class="md-ellipsis">
|
|
527
|
+
Parameters
|
|
528
|
+
</span>
|
|
529
|
+
</a>
|
|
530
|
+
</li>
|
|
531
|
+
</ul>
|
|
532
|
+
</nav>
|
|
533
|
+
</li>
|
|
534
|
+
</ul>
|
|
535
|
+
</nav>
|
|
536
|
+
</div>
|
|
537
|
+
</div>
|
|
538
|
+
</div>
|
|
539
|
+
<div class="md-content" data-md-component="content">
|
|
540
|
+
<article class="md-content__inner md-typeset">
|
|
541
|
+
<h1 id="bundle-the-basemaps-assets-archive">Bundle the <code>basemaps</code> assets archive</h1>
|
|
542
|
+
<p>This guide explains how to generate the <code>basemaps</code> bundled assets archive using the <strong>basemaps/cli</strong> package.</p>
|
|
543
|
+
<h2 id="get-started">Get started</h2>
|
|
544
|
+
<p>Clone the <a href="https://github.com/linz/basemaps-config"><strong>linz/basemaps-config</strong></a> repository to your machine.</p>
|
|
545
|
+
<div class="tabbed-set tabbed-alternate" data-tabs="1:3"><input checked="checked" id="__tabbed_1_1" name="__tabbed_1" type="radio"><input id="__tabbed_1_2" name="__tabbed_1" type="radio"><input id="__tabbed_1_3" name="__tabbed_1" type="radio"><div class="tabbed-labels"><label for="__tabbed_1_1">HTTPS</label><label for="__tabbed_1_2">SSH</label><label for="__tabbed_1_3">GitHub CLI</label></div>
|
|
546
|
+
<div class="tabbed-content">
|
|
547
|
+
<div class="tabbed-block">
|
|
548
|
+
<div class="language-bash highlight"><pre><span></span><code><span id="__span-0-1"><a href="#__codelineno-0-1" id="__codelineno-0-1" name="__codelineno-0-1"></a>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/linz/basemaps-config.git
|
|
549
|
+
</span></code></pre></div>
|
|
550
|
+
</div>
|
|
551
|
+
<div class="tabbed-block">
|
|
552
|
+
<div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a href="#__codelineno-1-1" id="__codelineno-1-1" name="__codelineno-1-1"></a>git<span class="w"> </span>clone<span class="w"> </span>git@github.com:linz/basemaps-config.git
|
|
553
|
+
</span></code></pre></div>
|
|
554
|
+
</div>
|
|
555
|
+
<div class="tabbed-block">
|
|
556
|
+
<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a href="#__codelineno-2-1" id="__codelineno-2-1" name="__codelineno-2-1"></a>gh<span class="w"> </span>repo<span class="w"> </span>clone<span class="w"> </span>linz/basemaps-config
|
|
557
|
+
</span></code></pre></div>
|
|
558
|
+
</div>
|
|
559
|
+
</div>
|
|
560
|
+
</input></input></input></div>
|
|
561
|
+
<div class="admonition abstract">
|
|
562
|
+
<p class="admonition-title">Paths</p>
|
|
563
|
+
<p>This guide uses variables as shorthand to reference key directories and files. On your machine, note the following paths:</p>
|
|
564
|
+
<div class="tabbed-set tabbed-alternate" data-tabs="2:3"><input checked="checked" id="__tabbed_2_1" name="__tabbed_2" type="radio"><input id="__tabbed_2_2" name="__tabbed_2" type="radio"><input id="__tabbed_2_3" name="__tabbed_2" type="radio"><div class="tabbed-labels"><label for="__tabbed_2_1"><code>BM_CONFIG_REPO</code></label><label for="__tabbed_2_2"><code>BM_CLI_BUILD</code></label><label for="__tabbed_2_3"><code>BM_SPRITES_BIN</code></label></div>
|
|
565
|
+
<div class="tabbed-content">
|
|
566
|
+
<div class="tabbed-block">
|
|
567
|
+
<p>The path to the <strong>basemaps-config</strong> repository folder on your machine.</p>
|
|
568
|
+
<div class="language-bash highlight"><pre><span></span><code><span id="__span-3-1"><a href="#__codelineno-3-1" id="__codelineno-3-1" name="__codelineno-3-1"></a><span class="nv">$BM_CONFIG_REPO</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="o">{</span>path_to<span class="o">}</span>/basemaps-config
|
|
569
|
+
</span></code></pre></div>
|
|
570
|
+
</div>
|
|
571
|
+
<div class="tabbed-block">
|
|
572
|
+
<p>The <strong>basemaps/cli</strong> package provides a <strong>bundle-assets</strong> function we can use to generate a bundled assets archive.</p>
|
|
573
|
+
<p>The path to the <strong>build</strong> folder of the <strong>basemaps/cli</strong> package.</p>
|
|
574
|
+
<div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a href="#__codelineno-4-1" id="__codelineno-4-1" name="__codelineno-4-1"></a><span class="nv">$BM_CLI_BUILD</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">$BM_REPO</span>/packages/cli/build/cli
|
|
575
|
+
</span></code></pre></div>
|
|
576
|
+
</div>
|
|
577
|
+
<div class="tabbed-block">
|
|
578
|
+
<p>The <strong>basemaps/sprites</strong> package provides a default function we can use to generate sprite sheets from a collection of sprite images.</p>
|
|
579
|
+
<p>The path to the <strong>bin</strong> folder of the <strong>basemaps/sprites</strong> package.</p>
|
|
580
|
+
<div class="language-bash highlight"><pre><span></span><code><span id="__span-5-1"><a href="#__codelineno-5-1" id="__codelineno-5-1" name="__codelineno-5-1"></a><span class="nv">$BM_SPRITES_BIN</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">$BM_REPO</span>/packages/sprites/bin
|
|
581
|
+
</span></code></pre></div>
|
|
582
|
+
</div>
|
|
583
|
+
</div>
|
|
584
|
+
</input></input></input></div>
|
|
585
|
+
</div>
|
|
586
|
+
<h2 id="generate-the-basemaps-assets">Generate the <code>basemaps</code> assets</h2>
|
|
587
|
+
<h3 id="1-create-local-directory">1. Create local directory</h3>
|
|
588
|
+
<p>To prepare for bundling the <code>basemaps</code> assets archive, create a local directory on your machine with the following subdirectory structure:</p>
|
|
589
|
+
<div class="language-md highlight"><pre><span></span><code><span id="__span-6-1"><a href="#__codelineno-6-1" id="__codelineno-6-1" name="__codelineno-6-1"></a><span class="k">-</span><span class="w"> </span>assets
|
|
590
|
+
</span><span id="__span-6-2"><a href="#__codelineno-6-2" id="__codelineno-6-2" name="__codelineno-6-2"></a><span class="w"> </span><span class="k">-</span><span class="w"> </span>fonts
|
|
591
|
+
</span><span id="__span-6-3"><a href="#__codelineno-6-3" id="__codelineno-6-3" name="__codelineno-6-3"></a><span class="w"> </span><span class="k">-</span><span class="w"> </span>sprites
|
|
592
|
+
</span></code></pre></div>
|
|
593
|
+
<p>You can specify a location and directory name of your choice.</p>
|
|
594
|
+
<div class="admonition abstract">
|
|
595
|
+
<p class="admonition-title">Path</p>
|
|
596
|
+
<p>On your machine, consider the following path:</p>
|
|
597
|
+
<div class="tabbed-set tabbed-alternate" data-tabs="3:1"><input checked="checked" id="__tabbed_3_1" name="__tabbed_3" type="radio"><div class="tabbed-labels"><label for="__tabbed_3_1"><code>ASSETS_DIR</code></label></div>
|
|
598
|
+
<div class="tabbed-content">
|
|
599
|
+
<div class="tabbed-block">
|
|
600
|
+
<p>The path to the created directory on your machine.</p>
|
|
601
|
+
<div class="language-bash highlight"><pre><span></span><code><span id="__span-7-1"><a href="#__codelineno-7-1" id="__codelineno-7-1" name="__codelineno-7-1"></a><span class="nv">$ASSETS_DIR</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="o">{</span>path_to_directory<span class="o">}</span>
|
|
602
|
+
</span></code></pre></div>
|
|
603
|
+
</div>
|
|
604
|
+
</div>
|
|
605
|
+
</input></div>
|
|
606
|
+
</div>
|
|
607
|
+
<h3 id="2-convert-fonts-into-pbf-protobuf-encoded-glyphs-files">2. Convert fonts into <code>.pbf</code> (protobuf-encoded glyphs) files</h3>
|
|
608
|
+
<p>To generate the <code>basemaps</code> <code>.pbf</code> files, follow the instructions described in this <a href="https://github.com/linz/basemaps-config/tree/master/config/fonts">README.md</a> file. Alternatively, there is a <a href="https://github.com/korywka/fonts.pbf">repository</a> containing various fonts that have already been converted into the <code>.pbf</code> format.</p>
|
|
609
|
+
<p>Move the generated and/or downloaded collections of <code>.pbf</code> files <strong>into</strong> the following directory:</p>
|
|
610
|
+
<div class="language-text highlight"><pre><span></span><code><span id="__span-8-1"><a href="#__codelineno-8-1" id="__codelineno-8-1" name="__codelineno-8-1"></a>$ASSETS_DIR/assets/fonts
|
|
611
|
+
</span></code></pre></div>
|
|
612
|
+
<p>The contents of your <code>$ASSETS_DIR/assets/fonts</code> directory should look similar to the following:</p>
|
|
613
|
+
<div class="language-md highlight"><pre><span></span><code><span id="__span-9-1"><a href="#__codelineno-9-1" id="__codelineno-9-1" name="__codelineno-9-1"></a><span class="k">-</span><span class="w"> </span>$ASSETS_DIR/assets/fonts
|
|
614
|
+
</span><span id="__span-9-2"><a href="#__codelineno-9-2" id="__codelineno-9-2" name="__codelineno-9-2"></a><span class="w"> </span><span class="k">-</span><span class="w"> </span>Noto Sans Bold
|
|
615
|
+
</span><span id="__span-9-3"><a href="#__codelineno-9-3" id="__codelineno-9-3" name="__codelineno-9-3"></a><span class="w"> </span><span class="k">-</span><span class="w"> </span>0-255.pbf
|
|
616
|
+
</span><span id="__span-9-4"><a href="#__codelineno-9-4" id="__codelineno-9-4" name="__codelineno-9-4"></a><span class="w"> </span><span class="k">-</span><span class="w"> </span>...
|
|
617
|
+
</span><span id="__span-9-5"><a href="#__codelineno-9-5" id="__codelineno-9-5" name="__codelineno-9-5"></a><span class="w"> </span><span class="k">-</span><span class="w"> </span>Open Sans Bold
|
|
618
|
+
</span><span id="__span-9-6"><a href="#__codelineno-9-6" id="__codelineno-9-6" name="__codelineno-9-6"></a><span class="w"> </span><span class="k">-</span><span class="w"> </span>0-255.pbf
|
|
619
|
+
</span><span id="__span-9-7"><a href="#__codelineno-9-7" id="__codelineno-9-7" name="__codelineno-9-7"></a><span class="w"> </span><span class="k">-</span><span class="w"> </span>...
|
|
620
|
+
</span></code></pre></div>
|
|
621
|
+
<h3 id="3-convert-sprite-files-into-sprite-sheets">3. Convert sprite files into sprite sheets</h3>
|
|
622
|
+
<p>Use the following command to generate the <code>basemaps</code> sprite sheets from the collection of topographic sprite files:</p>
|
|
623
|
+
<div class="language-bash highlight"><pre><span></span><code><span id="__span-10-1"><a href="#__codelineno-10-1" id="__codelineno-10-1" name="__codelineno-10-1"></a>node<span class="w"> </span><span class="nv">$BM_SPRITES_BIN</span>/basemaps-sprites.mjs<span class="w"> </span><span class="se">\</span>
|
|
624
|
+
</span><span id="__span-10-2"><a href="#__codelineno-10-2" id="__codelineno-10-2" name="__codelineno-10-2"></a><span class="nv">$BM_CONFIG_REPO</span>/config/sprites/topographic
|
|
625
|
+
</span></code></pre></div>
|
|
626
|
+
<p>The above command will output the resulting sprite sheets to the location from which you executed the command. Move the outputted files <strong>into</strong> the following directory:</p>
|
|
627
|
+
<div class="language-md highlight"><pre><span></span><code><span id="__span-11-1"><a href="#__codelineno-11-1" id="__codelineno-11-1" name="__codelineno-11-1"></a>$ASSETS_DIR/assets/sprites
|
|
628
|
+
</span></code></pre></div>
|
|
629
|
+
<p>The contents of your <code>$ASSETS_DIR/assets/sprites</code> directory should look similar to the following:</p>
|
|
630
|
+
<div class="language-md highlight"><pre><span></span><code><span id="__span-12-1"><a href="#__codelineno-12-1" id="__codelineno-12-1" name="__codelineno-12-1"></a><span class="k">-</span><span class="w"> </span>$ASSETS_DIR/assets/sprites
|
|
631
|
+
</span><span id="__span-12-2"><a href="#__codelineno-12-2" id="__codelineno-12-2" name="__codelineno-12-2"></a><span class="w"> </span><span class="k">-</span><span class="w"> </span>topographic.json
|
|
632
|
+
</span><span id="__span-12-3"><a href="#__codelineno-12-3" id="__codelineno-12-3" name="__codelineno-12-3"></a><span class="w"> </span><span class="k">-</span><span class="w"> </span>topographic.png
|
|
633
|
+
</span><span id="__span-12-4"><a href="#__codelineno-12-4" id="__codelineno-12-4" name="__codelineno-12-4"></a><span class="w"> </span><span class="k">-</span><span class="w"> </span>topographic@2x.json
|
|
634
|
+
</span><span id="__span-12-5"><a href="#__codelineno-12-5" id="__codelineno-12-5" name="__codelineno-12-5"></a><span class="w"> </span><span class="k">-</span><span class="w"> </span>topographic@2x.png
|
|
635
|
+
</span></code></pre></div>
|
|
636
|
+
<h2 id="run-the-basemapscli-package">Run the <code>basemaps/cli</code> package</h2>
|
|
637
|
+
<h3 id="command">Command</h3>
|
|
638
|
+
<p>Use the following command to bundle the <code>basemaps</code> assets archive:</p>
|
|
639
|
+
<div class="language-bash highlight"><pre><span></span><code><span id="__span-13-1"><a href="#__codelineno-13-1" id="__codelineno-13-1" name="__codelineno-13-1"></a>node<span class="w"> </span><span class="nv">$BM_CLI_BUILD</span>/bin.js<span class="w"> </span>bundle-assets<span class="w"> </span><span class="se">\</span>
|
|
640
|
+
</span><span id="__span-13-2"><a href="#__codelineno-13-2" id="__codelineno-13-2" name="__codelineno-13-2"></a><span class="w"> </span>--assets<span class="w"> </span><span class="nv">$ASSETS_DIR</span><span class="w"> </span><span class="se">\</span>
|
|
641
|
+
</span><span id="__span-13-3"><a href="#__codelineno-13-3" id="__codelineno-13-3" name="__codelineno-13-3"></a><span class="w"> </span>--output<span class="w"> </span>assets.bundle.tar.co<span class="w"> </span><span class="se">\</span>
|
|
642
|
+
</span></code></pre></div>
|
|
643
|
+
<h3 id="parameters">Parameters</h3>
|
|
644
|
+
<div class="tabbed-set tabbed-alternate" data-tabs="4:2"><input checked="checked" id="__tabbed_4_1" name="__tabbed_4" type="radio"><input id="__tabbed_4_2" name="__tabbed_4" type="radio"><div class="tabbed-labels"><label for="__tabbed_4_1"><code>--assets</code></label><label for="__tabbed_4_2"><code>--output</code></label></div>
|
|
645
|
+
<div class="tabbed-content">
|
|
646
|
+
<div class="tabbed-block">
|
|
647
|
+
<p>Specifies the location of the assets folder to use. This folder refers to that which contains the <code>.pbf</code> files and sprite sheets on your local machine.</p>
|
|
648
|
+
</div>
|
|
649
|
+
<div class="tabbed-block">
|
|
650
|
+
<p>Specifies where to save the bundled assets archive, relative to the location from which you execute the command. You can specify a location and filename of your choice.</p>
|
|
651
|
+
</div>
|
|
652
|
+
</div>
|
|
653
|
+
</input></input></div>
|
|
654
|
+
<!-- external links -->
|
|
655
|
+
</article>
|
|
656
|
+
</div>
|
|
657
|
+
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
|
|
658
|
+
</div>
|
|
659
|
+
</main>
|
|
660
|
+
<footer class="md-footer">
|
|
661
|
+
<div class="md-footer-meta md-typeset">
|
|
662
|
+
<div class="md-footer-meta__inner md-grid">
|
|
663
|
+
<div class="md-copyright">
|
|
664
|
+
<div class="md-copyright__highlight">
|
|
665
|
+
<a href="https://www.linz.govt.nz/copyright">© CC BY 4.0 LINZ</a>
|
|
666
|
+
</div>
|
|
667
|
+
|
|
668
|
+
|
|
669
|
+
Made with
|
|
670
|
+
<a href="https://squidfunk.github.io/mkdocs-material/" rel="noopener" target="_blank">
|
|
671
|
+
Material for MkDocs
|
|
672
|
+
</a>
|
|
673
|
+
</div>
|
|
674
|
+
</div>
|
|
675
|
+
</div>
|
|
676
|
+
</footer>
|
|
677
|
+
</div>
|
|
678
|
+
<div class="md-dialog" data-md-component="dialog">
|
|
679
|
+
<div class="md-dialog__inner md-typeset"></div>
|
|
680
|
+
</div>
|
|
681
|
+
<script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.indexes", "content.code.copy"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
|
|
682
|
+
<script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
|
|
683
|
+
<script>document$.subscribe(() => {
|
|
684
|
+
window.update_swagger_ui_iframe_height = function (id) {
|
|
685
|
+
var iFrameID = document.getElementById(id);
|
|
686
|
+
if (iFrameID) {
|
|
687
|
+
full_height = (iFrameID.contentWindow.document.body.scrollHeight + 80) + "px";
|
|
688
|
+
iFrameID.height = full_height;
|
|
689
|
+
iFrameID.style.height = full_height;
|
|
690
|
+
}
|
|
691
|
+
}
|
|
692
|
+
|
|
693
|
+
let iframe_id_list = []
|
|
694
|
+
var iframes = document.getElementsByClassName("swagger-ui-iframe");
|
|
695
|
+
for (var i = 0; i < iframes.length; i++) {
|
|
696
|
+
iframe_id_list.push(iframes[i].getAttribute("id"))
|
|
697
|
+
}
|
|
698
|
+
|
|
699
|
+
let ticking = true;
|
|
700
|
+
|
|
701
|
+
document.addEventListener('scroll', function(e) {
|
|
702
|
+
if (!ticking) {
|
|
703
|
+
window.requestAnimationFrame(()=> {
|
|
704
|
+
let half_vh = window.innerHeight/2;
|
|
705
|
+
for(var i = 0; i < iframe_id_list.length; i++) {
|
|
706
|
+
let element = document.getElementById(iframe_id_list[i])
|
|
707
|
+
if(element==null){
|
|
708
|
+
return
|
|
709
|
+
}
|
|
710
|
+
let diff = element.getBoundingClientRect().top
|
|
711
|
+
if(element.contentWindow.update_top_val){
|
|
712
|
+
element.contentWindow.update_top_val(half_vh - diff)
|
|
713
|
+
}
|
|
714
|
+
}
|
|
715
|
+
ticking = false;
|
|
716
|
+
});
|
|
717
|
+
ticking = true;
|
|
718
|
+
}
|
|
719
|
+
});
|
|
720
|
+
|
|
721
|
+
const dark_scheme_name = "slate"
|
|
722
|
+
|
|
723
|
+
window.scheme = document.body.getAttribute("data-md-color-scheme")
|
|
724
|
+
const options = {
|
|
725
|
+
attributeFilter: ['data-md-color-scheme'],
|
|
726
|
+
};
|
|
727
|
+
function color_scheme_callback(mutations) {
|
|
728
|
+
for (let mutation of mutations) {
|
|
729
|
+
if (mutation.attributeName === "data-md-color-scheme") {
|
|
730
|
+
scheme = document.body.getAttribute("data-md-color-scheme")
|
|
731
|
+
var iframe_list = document.getElementsByClassName("swagger-ui-iframe")
|
|
732
|
+
for(var i = 0; i < iframe_list.length; i++) {
|
|
733
|
+
var ele = iframe_list.item(i);
|
|
734
|
+
if (ele) {
|
|
735
|
+
if (scheme === dark_scheme_name) {
|
|
736
|
+
ele.contentWindow.enable_dark_mode();
|
|
737
|
+
} else {
|
|
738
|
+
ele.contentWindow.disable_dark_mode();
|
|
739
|
+
}
|
|
740
|
+
}
|
|
741
|
+
}
|
|
742
|
+
}
|
|
743
|
+
}
|
|
744
|
+
}
|
|
745
|
+
observer = new MutationObserver(color_scheme_callback);
|
|
746
|
+
observer.observe(document.body, options);
|
|
747
|
+
})</script></body>
|
|
748
|
+
</html>
|