.. _mapfile:

*****************************************************************************
 Mapfile
*****************************************************************************

:Author: Steve Lime
:Contact: steve.lime at dnr.state.mn.us
:Author: Jeff McKenna
:Contact: jmckenna at gatewaygeomatics.com
:Author: Jean-François Doyon
:Contact: jdoyon at ccrs.nrcan.gc.ca


Das Mapfile ist die Zentrale vom MapServer. Hier werden die Beziehungen
zwischen den Objekten definiert, dem MapServer gesagt wo er welche Daten findet
und mitgeteilt wie diese gezeichnet werden sollen.

Es gibt einige wichtige Sachverhalte die für eine zuverlässige Konfiguration
des MapServers duch Mapfiles verstanden werden müssen. Der Sachverhalt wird
durch :ref:`LAYER` beschrieben. Ein Layer ist die Kombination von Daten und
ihrer Ausprägung (Styling). Daten, in der Form von Attributen und Geometrie,
können durch die Benutzung von :ref:`CLASS` und :ref:`STYLE` Direktiven
dargestellt werden.

.. seealso::
    :ref:`introduction` for "An Introduction to the Mapfile"

.. toctree::
   :maxdepth: 1

   class
   expressions
   feature
   fontset
   Include
   grid
   join
   label
   layer
   legend
   map
   outputformat
   projection
   querymap
   reference
   scalebar
   style
   symbol
   symbology/construction
   symbology/examples
   template
   variable_sub
   web

Notes
-----------------------------------------------------------------------------

* Im Mapfile wird NICHT zwischen Groß- und Kleinschreibung unterschieden.
* Zeichenketten mit alphanumerischen Zeichen oder MapServer Schlüsselwörter
  SOLLTEN in Anführungszeichen stehen. Es wird empfohlen ALLE Zeichenketten
  in doppelte Anführungszeichen zu setzen.
* Für MapServer Versionen < 5 gab es ein Maximum von 200 Layer pro Mapfile
  (für MapServer >= 5 gibt es keine Begrenzung). Dies kann in der Datei map.h
  geändert werden in dem der Wert von MS_MAXLAYERS entsprechend angepasst wird.
  Anschließend muss MapServer neu übersetzt werden.
  Weitere Begrenzungen für Versionen < 5:

  * MAXCLASSES 250 (set in map.h)
  * MAXSTYLES 5 (set in map.h)
  * MAXSYMBOLS 64 (set in mapsymbol.h)

  MapServer Versionen >= 5 besitzen keine Begrenzungen für Klassen, Style,
  Symbole, oder Layer.
* Pfadangaben können als absolute Angaben oder relativ zur Position des
  Mapfiles gemacht werden. Zusätzlich können Datenquellen relativ zum
  SHAPEPATH angegeben werden.
* Das Mapfile ist hierarchich aufgebaut und beginnt mit dem MAP Objekt als
  Wurzel. Alle anderen Objekte sind dem Map objekt untergeordnet.
* Kommentare beginnen mit einem #.
* Attribute werden nach folgender Syntax beschrieben: [ATTRIBUTENAME] ...
  Dabei wird bei den Angaben zwischen den eckigen Klammern zwischen
  GROß- UND KLEINSCHREIBUNG UNTERSCHIEDEN. Allgemein sind in Shapefiles von
  ESRI erzeugten Produkten die Namen der Attributspalten (.dbf Spaltennamen)
  immer in Großbuchstaben und für PostGIS sollte *IMMER* Kleinschreibung
  benutzt werden.
* MapServer reguläre Ausdrücke werden durch die C Bibliothek des
  Betriebssystems zur Verfügung gestellt. Für Informationen wie reguläre
  Ausdrücke benutzt und erstellt werden, wird empfohlen die Dokumentation
  der C Bibliothek zu lesen. Für Linux ist dies GLibC und die Handbuchseite
  ist über "man 7 regex" erreichbar. Dieses Handbuch sollte ebenso auf vielen
  UNIX-Systemen verfügbar sein. Da die regulären Ausdrücke kompatibel zum
  POSIX Standard sind, sollten sie unter Windows ebenso funktionieren. Somit
  können Windowsnutzer im Internet nach "man 7 regex" suchen da die Handbücher
  im Internet verfügbar sind.
* In der deutschen Übersetzung gibt es einige Wörter die nicht übersetzt
  wurden, da der englische Begriff bereits große Verbreitung gefunden hat bzw
  vielsagender ist.
  Diese sind im folgenden mit ihrer Bedeutung/Übersetzung aufgelistet:

  * mapfile      - Mapfile, Mapdatei
  * layer        - Ebene, Layer
  * shapefile    - Shapefile, Shapedatei
  * feature      - Objekt, Feature
  * expression   - Ausdruck, Expression
  * annotation   - Anmerkung, Beschriftung, Annotation
  * lookup table - Lookup-Tabelle
  * join         - (Datenbank-)Verknüpfung, Join
  * tile index   - Tileindex/Kachelindex
  * extent       - Extent, Ausdehnung