Changes between Version 1 and Version 2 of XMLMapfiles

Timestamp:

Sep 25, 2009, 6:42:13 AM (15 years ago)

Author:

aboudreault

Comment:

Added a few explanations

XMLMapfiles

@@ -11 +11 @@
 Coming soon ...
 
-== Getting Started: where to get the XML schema and XSLT? ==
+== Getting Started: where to get the XML schema and XSL file? ==
 
-Coming soon ...
+The XML schema and the XSL file are included with the distribution in the '''xmlmapfile''' directory.[[BR]]
+ * mapfile.xsd : The XML schema used to validate a XML mapfile.[[BR]]
+ * mapfile.xsl : The XSL file used by XSLT to convert a XML mapfile into a regular mapfile.
+
+== What kind of XML files can I create using the schema? ==
+
+You can create 3 XML file types:
+ * A complete XML mapfile: <Map ...></Map>
+ * A XML file for your layers: <LayerSet ...><Layer ...></Layer>...</LayerSet>
+ * A XML file for your symbols: <SymBolSet><Symbol ...></Symbol></SymbolSet>
+
+There is one exampe of each type in the '''xmlmapfile/tests''' directory.
 
 == How to use the XML schema? ==
 
-Coming soon ...
+If you are using a XML editor like XMLSpy or XMLPad, you can easily specify the XML schema used to validate your current XML document. Furthermore, those editors will provide XML completition by listing allowed tags/attributes, automatic validation and more..
+
+If you prefer, you can also use a normal text editor. On Linux, there is a few tools to validate a XML file with its schema. On Ubuntu, you can do the following command:
+{{{
+apt-get install xmlstarlet
+xmlstarlet val -e --xsd mapfile.xsd my-new-mapfile.xml
+}}}
 
 == How to convert an XML mapfile to regular mapfile using the XSLT? ==
 
-Coming soon ...
+If you are using a XML editor, you can easily specify the XSL file to use and transform the document.
+
+On Ubuntu, you can do the following command:
+{{{
+apt-get install xsltproc
+xsltproc my-new-mapfile.xml > /tmp/my-regular-mapfile.map
+}}}