.. _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
:Revision: $Revision: 8294 $
:Date: $Date: 2010-09-23 21:11:00 +0000 (Sat, 29 Sept 2010) $


Le mapfile est le coeur de MapServer. Il définit les relations entre les objets, 
indique à MapServer où se trouvent les données et définit la façon dont 
elles seront dessinées.

Il y a quelques concepts importants que vous devez comprendre avant de 
pouvoir utiliser les mapfiles efficacement pour configurer MapServer. 
Le premier concept est celui de :ref:`LAYER`. Une couche est une 
combinaison de données et de styles. Les données, composées d'attributs 
et d'une géométrie, sont stylées en utilisant les directives :ref:`CLASS` 
et :ref:`STYLE`.

.. seealso::
    :ref:`introduction` pour "une introduction au 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
-----------------------------------------------------------------------------

* Le mapfile N'EST PAS sensible à la casse.
* Les chaînes de caractères contenant des caractères non alphanumériques ou un 
  mot clé de MapServer DOIVENT être placées entre guillemets ("quotes"). Il est
  recommandé de placer TOUTES les chaînes de caractères entre doubles 
  apostrophes (double-quotes).
* Pour les versions de MapServer < 5, il y a une limite par défaut de 200 couches 
  maximum par mapfile (il n'y a pas de limite de couches avec MapServer >= 5). 
  Cela peut être changé en éditant le fichier map.h, en modifiant la valeur de 
  MS_MAXLAYERS puis en recompilant MasServer. Il y a d'autres limites 
  importantes par défaut dans MapServer < 5 :

  * MAXCLASSES 250 (définie dans map.h)
  * MAXSTYLES 5 (définie dans map.h)
  * MAXSYMBOLS 64 (définie dans mapsymbol.h)

  Les versions de MapServer >= 5 n'ont pas de limites pour les classes, styles, 
  symboles et couches.
* Les chemins de fichier peuvent être donnés en chemins absolus, ou en 
  chemins relatifs par rapport à l'emplacement du mapfile.  De plus, les fichiers 
  de données doivent être spécifiés relativement au SHAPEPATH.
* Le mapfile a une structure hiérarchisée, avec l'objet Map constituant la 
  racine ("root"). Tous les autres objets sont rattachés à celui-ci.
* Les commentaires sont indiqués par le caractère #.
* Les attributs sont désignés en utilisant la syntaxe suivante : 
  [ATTRIBUTENAME]... Notez que le nom de l'attribut entre les crochets 
  *EST* sensible à la casse. Généralement les fichiers shape ESRI ont leurs 
  propres attributs (noms de colonnes .dbf) en majuscules, et pour PostGIS, 
  les minuscules sont *TOUJOURS* utilisées.
* Les expressions régulières dans MapServer sont utilisées à travers la 
  bibliothèque C du système d'exploitation. Pour plus d'informations sur 
  l'utilisation et la syntaxe de votre système, vous devriez lire la 
  documentation fournie avec votre bibliothèque C. Sur Linux il s'agit de la 
  GLibC et vous pouvez lire "man 7 regex"... Cette page d'aide est disponible 
  sous différents systèmes UNIX. Comme ces expressions régulières sont 
  conformes à POSIX, elles devraient être identiques sous Windows, aussi les 
  utilisateurs Windows peuvent essayer de rechercher sur Internet "man 7 
  regex" puisque ces pages y sont disponibles.