Changes between Version 129 and Version 130 of DeveloperGuidelines/Tips

Timestamp:

05/30/14 08:36:38 (11 years ago)

Author:

Pat Tressel

Comment:

--

DeveloperGuidelines/Tips

@@ -221 +221 @@
 * Especially useful for USB (minimise disk access): http://web.utk.edu/~jplyon/sqlite/SQLite_optimization_FAQ.html
 
-== XSLT ==
-* DeveloperGuidelines#XSLT
+== XSLT: XML, XSL, XPath ==
+
+We use XSLT (Extensible Stylesheet Language Transformations) to convert external structured data, such as
+CSV files, spreadsheets, GIS data, and CAP messages into internal S3XML format, and from there to create Eden database entries,
+and also to export Eden data into external data formats.
+
+XSL Stylesheets are themselves XML documents that specify a conversion between one data format and another.
+XPath (XML Path Language) is used to select elements from the source document to act on.
+
+The stylesheets for various data formats are found in the directory: [https://github.com/flavour/eden/blob/master/static/formats eden/static/formats]
+
+Support for XSLT is provided by [http://lxml.de/ lxml], which is a Python wrapper for libxml2 and libxslt.
+This currently supports the XML 1.0 standard, not 2.0, and there are functions available in 2.0 that are not in 1.0,
+so be aware of this when you are consulting XML / XSLT references.
+
+=== Online references ===
+
+* W3 standards
+ * [http://www.w3.org/standards/xml/transformation XSLT overview]
+* [http://msdn.microsoft.com/en-us/library/ms256069%28v=vs.110%29.aspx MSDN XSLT Reference]
+* [http://www.dpawson.co.uk/xsl/sect1/sect1.html Dave Pawson's tutorials]
+
+=== Books ===
+
+Mike Kay, XSLT Programmer's Reference, WROX Press
+
+=== Tools ===
+
+Try out your xsl stylesheets with: [https://github.com/flavour/eden/blob/master/static/scripts/tools/xsltransform.py xsltransform.py]
+
+
 
 == Visualization ==