-
Notifications
You must be signed in to change notification settings - Fork 2
Expand file tree
/
Copy pathbackground.html
More file actions
326 lines (258 loc) · 16.9 KB
/
background.html
File metadata and controls
326 lines (258 loc) · 16.9 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
<!DOCTYPE html>
<html lang="de" data-content_root="../">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Tutorial background — MapServer 8.6.2 documentation</title>
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=03e43079" />
<link rel="stylesheet" type="text/css" href="../_static/sphinx.css?v=48f05237" />
<link rel="stylesheet" type="text/css" href="../_static/copybutton.css?v=76b2166b" />
<link rel="stylesheet" type="text/css" href="../_static/sphinx_collapse.css?v=226d88b4" />
<link rel="stylesheet" type="text/css" href="../_static/custom.css?v=dd298242" />
<link rel="stylesheet" type="text/css" href="../_static/ribbon.css?v=ea091bf4" />
<script src="../_static/jquery.js?v=5d32c60e"></script>
<script src="../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
<script src="../_static/documentation_options.js?v=e71285a4"></script>
<script src="../_static/doctools.js?v=fd6eb6e6"></script>
<script src="../_static/sphinx_highlight.js?v=6ffebe34"></script>
<script src="../_static/clipboard.min.js?v=a7894cd8"></script>
<script src="../_static/copybutton.js?v=f281be69"></script>
<script src="../_static/translations.js?v=9bf55d28"></script>
<link rel="icon" href="../_static/mapserver.ico"/>
<link rel="author" title="Über dieses Dokument" href="../about.html" />
<link rel="index" title="Stichwortverzeichnis" href="../genindex.html" />
<link rel="search" title="Suche" href="../search.html" />
<link rel="copyright" title="Copyright" href="../copyright.html" />
<link rel="next" title="Section 1: Static Maps and the MapFile" href="section1.html" />
<link rel="prev" title="MapServer Tutorial" href="index.html" />
</head><body>
<!-- for main branch only, do not backport this -->
<table width="100%" style="width: 100%; background-color: white;">
<tr>
<td rowspan="2" style="padding: 10px 0px 10px 10px;">
<a href="../index.html" title="Home"><img src="../_static/banner.png" alt="MapServer banner" border="0" /></a>
</td>
<td style="padding: 10px 10px 0px 0px; text-align: right; vertical-align: top;">
<a href="../index.html" title="Home">Home</a> |
<a href="../products.html" title="Products (MapServer core, MapCache, TinyOWS">Products</a> |
<a href="https://github.com/mapserver/mapserver/issues/" title="Issue Tracker (MapServer core)">Issue Tracker</a> |
<a href="../community/service_providers.html" title="Professional Service Providers">Service Providers</a> |
<a href="../faq.html" title="Frequently Asked Questions">FAQ</a> |
<a href="https://fosstodon.org/@mapserver" title="Mastodon" target="_blank">Mastodon</a> |
<a href="../download.html" title="Download Source or Binaries">Download </a> |
<a class="badge" href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=KRJ2X44N3HA6U&source=url" target="_blank">
<img src="https://img.shields.io/badge/donate-%E2%9D%A4%C2%A0-ff69b4.svg?style=flat" alt="Donate to MapServer">
</a>
</td>
</tr>
<tr>
<td style="padding: 0px 10px 0px 0px; text-align: right; vertical-align: bottom;">
<a href="../../tutorial/background.html"><img src="../_static/flagicons/en.png" alt="en" title="en" border="0" /></a>
<a href="../../ar/tutorial/background.html"><img src="../_static/flagicons/ar.png" alt="ar" title="ar" border="0" /></a>
<img src="../_static/flagicons/de.png" alt="de" title="de" border="0" width="18px" height="13px"/>
<a href="../../el/tutorial/background.html"><img src="../_static/flagicons/el.png" alt="el" title="el" border="0" /></a>
<a href="../../es/tutorial/background.html"><img src="../_static/flagicons/es.png" alt="es" title="es" border="0" /></a>
<a href="../../fr/tutorial/background.html"><img src="../_static/flagicons/fr.png" alt="fr" title="fr" border="0" /></a>
<a href="../../id/tutorial/background.html"><img src="../_static/flagicons/id.png" alt="id" title="id" border="0" /></a>
<a href="../../it/tutorial/background.html"><img src="../_static/flagicons/it.png" alt="it" title="it" border="0" /></a>
<a href="../../ja/tutorial/background.html"><img src="../_static/flagicons/ja.png" alt="ja" title="ja" border="0" /></a>
<a href="../../nl_NL/tutorial/background.html"><img src="../_static/flagicons/nl_NL.png" alt="nl_NL" title="nl_NL" border="0" /></a>
<a href="../../pl/tutorial/background.html"><img src="../_static/flagicons/pl.png" alt="pl" title="pl" border="0" /></a>
<a href="../../ru/tutorial/background.html"><img src="../_static/flagicons/ru.png" alt="ru" title="ru" border="0" /></a>
<a href="../../sq/tutorial/background.html"><img src="../_static/flagicons/sq.png" alt="sq" title="sq" border="0" /></a>
<a href="../../tr/tutorial/background.html"><img src="../_static/flagicons/tr.png" alt="tr" title="tr" border="0" /></a>
</td>
</tr>
</table>
<div class="related" role="navigation" aria-label="Related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="Stichwortverzeichnis"
accesskey="I">Index</a></li>
<li class="right" >
<a href="section1.html" title="Section 1: Static Maps and the MapFile"
accesskey="N">weiter</a> |</li>
<li class="right" >
<a href="index.html" title="MapServer Tutorial"
accesskey="P">zurück</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">Home</a> »</li>
<li class="nav-item nav-item-1"><a href="../documentation.html" >MapServer 8.6.2 Documentation</a> »</li>
<li class="nav-item nav-item-2"><a href="index.html" accesskey="U">MapServer Tutorial</a> »</li>
<li class="nav-item nav-item-this"><a href="">Tutorial background</a></li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="tutorial-background">
<span id="id1"></span><h1>Tutorial background<a class="headerlink" href="#tutorial-background" title="Link to this heading">¶</a></h1>
<section id="tutorial-timeframe">
<h2>Tutorial Timeframe<a class="headerlink" href="#tutorial-timeframe" title="Link to this heading">¶</a></h2>
<p>While some users can go through this tutorial in one day, those who work on each
example in detail can probably expect to finish in one week.</p>
</section>
<section id="tutorial-data">
<h2>Tutorial Data<a class="headerlink" href="#tutorial-data" title="Link to this heading">¶</a></h2>
<p>The dataset used in this tutorial was taken from the U.S. Department of the
Interior’s National Atlas of the United States (which is no longer available, but was hosted by
<a class="reference external" href="https://www.usgs.gov/faqs/national-atlas-program-has-ended-any-data-still-available">data.gov</a>).
The dataset was clipped to the upper great lakes region (Minnesota, Michigan,
and Wisconsin) to reduce storage size. Additional raster images were added
courtesy of the TerraSIP project at the University of Minnesota. When using
this tutorial, you are encouraged to use your own dataset.</p>
<p>Like MapServer itself, this tutorial is open and customizable to anyone.
This was done in the hope that someone (or some folks) will help design and
develop it further.</p>
<p>Download the data (and all html files) for this tutorial at <a class="reference external" href="https://download.osgeo.org/mapserver/docs/mapserver-tutorial.zip">https://download.osgeo.org/mapserver/docs/mapserver-tutorial.zip</a> .</p>
</section>
<section id="before-using-the-tutorial">
<h2>Before Using the Tutorial<a class="headerlink" href="#before-using-the-tutorial" title="Link to this heading">¶</a></h2>
<p>There are some prerequisites to using this tutorial:</p>
<ol class="arabic">
<li><p>Users will need to have a web server installed and running on their computer.
This web server has to have support for common gateway interface (CGI) programs.</p></li>
<li><p>Users should have a basic understanding of web servers and internet security.
A poorly configured web server can easily be attacked by malicious people.
At the very least your software installation will be corrupted and you’ll
lose hours of productivity, at worst your computer can be used to attack
other computers on the internet.</p></li>
<li><p>It is recommended that users of this tutorial read the
<a class="reference internal" href="../introduction.html#introduction"><span class="std std-ref">Introduction to MapServer</span></a> before proceeding with this
tutorial.</p></li>
<li><p>To use this tutorial, users will need to have a MapServer
CGI program (mapserv or mapserv.exe) installed in their systems. MapServer
source code is available for download <a class="reference internal" href="../download.html#download"><span class="std std-ref">here</span></a>. Documentation
exists on how to compile and install MapServer:</p>
<ul class="simple">
<li><p>for UNIX users, please read the <a class="reference internal" href="../installation/unix.html#unix"><span class="std std-ref">MapServer UNIX Compilation and Installation HOWTO</span></a>.</p></li>
<li><p>Windows users should read the <a class="reference internal" href="../installation/win32.html#win32"><span class="std std-ref">MapServer Win32 Compilation and Installation HOWTO</span></a></p></li>
</ul>
<p>In addition, precompiled binaries exist for a number of platform (see the
<a class="reference internal" href="../download.html#windows"><span class="std std-ref">download page</span></a>).</p>
</li>
</ol>
</section>
<section id="windows-unix-linux-issues">
<h2>Windows, UNIX/Linux Issues<a class="headerlink" href="#windows-unix-linux-issues" title="Link to this heading">¶</a></h2>
<section id="paths">
<h3>Paths<a class="headerlink" href="#paths" title="Link to this heading">¶</a></h3>
<p>This tutorial is packaged for Windows users, but should work with minimal changes on
UNIX or other platforms. The main differences are the paths in the map files. Windows
users can specify the drive letter of the hard disk where their tutorial
files reside. Here’s an example:</p>
<p>A UNIX map file might include a parameter like this:</p>
<div class="highlight-mapfile notranslate"><div class="highlight"><pre><span></span><span class="k">SHAPEPATH</span> <span class="s">"/data/projects/tutorial/data"</span>
</pre></div>
</div>
<p>In Windows, the same parameters might look like this:</p>
<div class="highlight-mapfile notranslate"><div class="highlight"><pre><span></span><span class="k">SHAPEPATH</span> <span class="s">"C:/ms4w/apps/tutorial/data"</span>
</pre></div>
</div>
<p>or:</p>
<div class="highlight-mapfile notranslate"><div class="highlight"><pre><span></span><span class="k">SHAPEPATH</span> <span class="s">"C:\ms4w</span><span class="se">\a</span><span class="s">pps</span><span class="se">\t</span><span class="s">utorial\data"</span>
</pre></div>
</div>
<p>Notice that either slash or backslash works in Windows. The usual
backslash may work well for you if you want to make a distinction
between virtual (as in URLs or web addresses) and local paths in your
map file. However, if you plan to move your application to UNIX at
some point, you’ll have the tedious task of switching all backslashes
to slashes.</p>
<p>While we’re on the subject of paths, keep in mind that paths in
mapfiles are typically <strong>relative to the directory where the mapfile is stored</strong>.
When working with HTML template files, paths are relative to
the web server’s root directory. i.e., „/tutorial/“ is relative to
„<a class="reference external" href="https://demo.mapserver.org/">https://demo.mapserver.org/</a>“. Please read <a class="reference external" href="https://alistapart.com/article/slashforward/">this</a>
for a few insights on URLs.</p>
</section>
<section id="executable">
<h3>Executable<a class="headerlink" href="#executable" title="Link to this heading">¶</a></h3>
<p>Another issue is that UNIX executable files don’t contain a .EXE extension,
but they do in Windows. So you might have to adjust all instances of
„/cgi-bin/mapserv.exe“ to „/cgi-bin/mapserv“.</p>
</section>
</section>
<section id="other-resources">
<h2>Other Resources<a class="headerlink" href="#other-resources" title="Link to this heading">¶</a></h2>
<p>Other documentation exist to give you better understanding of the many
customizations MapServer offer. Please visit the MapServer
documentation page at <a class="reference external" href="https://mapserver.org/documentation.html">https://mapserver.org/documentation.html</a> . There you will find
many HOWTO documents, from getting started to using MapScript, a
scripting interface for MapServer.</p>
<hr class="docutils" />
<p><a class="reference internal" href="index.html#tutorial"><span class="std std-ref">Back to Tutorial home</span></a> | <a class="reference internal" href="section1.html#tutorial-section1"><span class="std std-ref">Proceed to Section 1</span></a></p>
</section>
</section>
<div class="clearer"></div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="Main">
<div class="sphinxsidebarwrapper">
<search id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Schnellsuche</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Los" />
</form>
</div>
</search>
<script>document.getElementById('searchbox').style.display = "block"</script><h3>Navigation</h3>
<p>
<a href="../about.html" title="About">About</a><br>
<a href="../products.html" title="Products">Products</a><br>
<a href="../community/index.html" title="Community">Community</a><br>
<a href="../development/index.html" title="Development">Development</a><br>
<a href="../download.html" title="Downloads">Downloads</a><br>
<a href="../documentation.html" title="Documentation">Documentation</a><br>
<a href="../faq.html" title="FAQ">FAQ</a><br>
<a href="../psc.html" title="PSC">PSC</a><br>
<a href="https://fosstodon.org/@mapserver" title="Mastodon">Mastodon</a>
</p>
<h3>Current Table Of Contents</h3>
<ul>
<li><a class="reference internal" href="#">Tutorial background</a><ul>
<li><a class="reference internal" href="#tutorial-timeframe">Tutorial Timeframe</a></li>
<li><a class="reference internal" href="#tutorial-data">Tutorial Data</a></li>
<li><a class="reference internal" href="#before-using-the-tutorial">Before Using the Tutorial</a></li>
<li><a class="reference internal" href="#windows-unix-linux-issues">Windows, UNIX/Linux Issues</a><ul>
<li><a class="reference internal" href="#paths">Paths</a></li>
<li><a class="reference internal" href="#executable">Executable</a></li>
</ul>
</li>
<li><a class="reference internal" href="#other-resources">Other Resources</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="Related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="Stichwortverzeichnis"
>Index</a></li>
<li class="right" >
<a href="section1.html" title="Section 1: Static Maps and the MapFile"
>weiter</a> |</li>
<li class="right" >
<a href="index.html" title="MapServer Tutorial"
>zurück</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">Home</a> »</li>
<li class="nav-item nav-item-1"><a href="../documentation.html" >MapServer 8.6.2 Documentation</a> »</li>
<li class="nav-item nav-item-2"><a href="index.html" >MapServer Tutorial</a> »</li>
<li class="nav-item nav-item-this"><a href="">Tutorial background</a></li>
</ul>
</div>
<div class="footer" role="contentinfo">
© <a href="../copyright.html">Copyright</a> 2026, Open Source Geospatial Foundation.
Zuletzt aktualisiert am 2026-04-20.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 9.1.0.
</div>
</body>
</html>