[mapserver-commits] r12526 - branches/branch-6-0/docs/en/mapfile trunk/docs/en/mapfile

[svn at osgeo.org]

Author: havatv
Date: 2011-09-06 13:50:05 -0700 (Tue, 06 Sep 2011)
New Revision: 12526

Added:
   branches/branch-6-0/docs/en/mapfile/xml_mapfile.txt
   trunk/docs/en/mapfile/xml_mapfile.txt
Modified:
   branches/branch-6-0/docs/en/mapfile/index.txt
   trunk/docs/en/mapfile/index.txt
Log:
Added document on xml mapfile support (#3334).

Modified: branches/branch-6-0/docs/en/mapfile/index.txt
===================================================================
--- branches/branch-6-0/docs/en/mapfile/index.txt	2011-09-06 20:21:29 UTC (rev 12525)
+++ branches/branch-6-0/docs/en/mapfile/index.txt	2011-09-06 20:50:05 UTC (rev 12526)
@@ -58,7 +58,9 @@
    union
    variable_sub
    web
+   xml_mapfile
    
+   
 Notes
 -----------------------------------------------------------------------------
 

Added: branches/branch-6-0/docs/en/mapfile/xml_mapfile.txt
===================================================================
--- branches/branch-6-0/docs/en/mapfile/xml_mapfile.txt	                        (rev 0)
+++ branches/branch-6-0/docs/en/mapfile/xml_mapfile.txt	2011-09-06 20:50:05 UTC (rev 12526)
@@ -0,0 +1,47 @@
+*******************
+XML Mapfile support
+*******************
+
+MapServer is able to load XML mapfiles automatically, without user
+XSLT tranformations. Basicly, MapServer will simply do an XSLT
+transformation when the mapfile passed to it is an XML one, convert it
+to a text mapfile in a temporary file on disk, then process the
+mapfile normally.
+
+New Dependencies
+
+* libxslt
+* libexslt 
+
+Enabling the support
+====================
+
+You can enable the XML mapfile support by adding the following option:
+--with-xml-mapfile. This configure option will enable the libxslt and
+libexslt check up. If your libxslt/libexslt are not installed in /usr,
+you'll have to add the following options:
+
+::
+
+    --with-xslt=/path/to/xslt/installation
+    --with-exslt=/path/to/exslt/installation
+
+Usage:
+======
+
+In order to enable this feature, set the MS_XMLMAPFILE_XSLT
+environment variable to point to the location of the XSLT to use for
+the XML->text mapfile conversion. e.g. in Apache:
+
+::
+
+    SetEnv MS_XMLMAPFILE_XSLT /path/to/mapfile.xsl
+    PassEnv MS_XMLMAPFILE_XSLT
+
+With this enabled, passing an .xml filename to the CGI `map` parameter
+will automatically trigger the conversion.
+
+.. note::
+   This is a first step to XML mapfile loading support. Obviously,
+   there is a cost to parse and translate the XML mapfile, but this
+   allows easier use of XML mapfiles.

Modified: trunk/docs/en/mapfile/index.txt
===================================================================
--- trunk/docs/en/mapfile/index.txt	2011-09-06 20:21:29 UTC (rev 12525)
+++ trunk/docs/en/mapfile/index.txt	2011-09-06 20:50:05 UTC (rev 12526)
@@ -58,7 +58,9 @@
    union
    variable_sub
    web
+   xml_mapfile
    
+   
 Notes
 -----------------------------------------------------------------------------
 

Added: trunk/docs/en/mapfile/xml_mapfile.txt
===================================================================
--- trunk/docs/en/mapfile/xml_mapfile.txt	                        (rev 0)
+++ trunk/docs/en/mapfile/xml_mapfile.txt	2011-09-06 20:50:05 UTC (rev 12526)
@@ -0,0 +1,47 @@
+*******************
+XML Mapfile support
+*******************
+
+MapServer is able to load XML mapfiles automatically, without user
+XSLT tranformations. Basicly, MapServer will simply do an XSLT
+transformation when the mapfile passed to it is an XML one, convert it
+to a text mapfile in a temporary file on disk, then process the
+mapfile normally.
+
+New Dependencies
+
+* libxslt
+* libexslt 
+
+Enabling the support
+====================
+
+You can enable the XML mapfile support by adding the following option:
+--with-xml-mapfile. This configure option will enable the libxslt and
+libexslt check up. If your libxslt/libexslt are not installed in /usr,
+you'll have to add the following options:
+
+::
+
+    --with-xslt=/path/to/xslt/installation
+    --with-exslt=/path/to/exslt/installation
+
+Usage:
+======
+
+In order to enable this feature, set the MS_XMLMAPFILE_XSLT
+environment variable to point to the location of the XSLT to use for
+the XML->text mapfile conversion. e.g. in Apache:
+
+::
+
+    SetEnv MS_XMLMAPFILE_XSLT /path/to/mapfile.xsl
+    PassEnv MS_XMLMAPFILE_XSLT
+
+With this enabled, passing an .xml filename to the CGI `map` parameter
+will automatically trigger the conversion.
+
+.. note::
+   This is a first step to XML mapfile loading support. Obviously,
+   there is a cost to parse and translate the XML mapfile, but this
+   allows easier use of XML mapfiles.