Changes between Version 11 and Version 12 of XsltTemplates

Timestamp:

04/02/11 21:07:55 (14 years ago)

Author:

Fran Boon

Comment:

--

XsltTemplates

@@ -1 @@
-XSLT and XPath are two key technologies used within SahanaPy to allow easy importing and exporting of information in a wide variety of formats. Support for importing and exporting data is mostly managed via XSLT templates.
+[[TOC]]
+= XSLT =
+XSLT and XPath are two key technologies used within Sahana Eden to allow easy importing and exporting of information in a wide variety of formats.
+
+Support for importing and exporting data is mostly managed via XSLT templates.
 
 == Sahana Data Models ==
-The underlying data models in {{{models/}}} define the resulting structure that will be within <sahanapy>. More technical detail is [http://trac.sahanapy.org/wiki/S3XRC available here].
+The underlying data models in {{{models/}}} define the resulting structure that will be within the XML.
 
-== Sahana XSLT Information ==
-Sahana XSLT/XPath capability is provided by [http://codespeak.net/lxml/ lxml]. Currently Sahana only supports XSLT/XPath 1.0.
+== XSLT Library ==
+Sahana XSLT/XPath capability is provided by [http://codespeak.net/lxml/ lxml]. Currently lxml only supports XSLT/XPath 1.0.
+
+A collection of useful reusable functions are stored in {{{static/formats/xml/commons.xsl}}}
 
 == Sahana XML Representation ==
-Here is a simplified blank XML document that highlights the key elements providing in the native XML within SahanaPy.
-{{{
-<sahanapy>
-  <resource name="" uuid="" created_on="" modified_on="" url="">
-    <data field=""></data>
-    <reference field="" resource="" uuid=""></reference>
-  </resource>
-</sahanapy>
-}}}
- * {{{<resource>}}} - identifies the type of resource e.g. {{{name="hms_hospital"}}}
- * {{{<data>}}} - represents a data field from the model e.g. if a resource is hms_hospital, then the data fields provided will be defined in {{{models/hms.py}}} - look for the resource definition for hospital
- * {{{<reference>}}} - contains information about things such as location e.g. {{{field="location_id" resource="gis_location"}}}
+See: [wiki:S3XRC/S3XML]
+
+There are 2 parameters which are passed in:
+ * name (comes from the resourcename - e.g. 'sehlter')
+ * xsltmode (passed in as a var on the URL - e.g. '&xsltmode=extended')
 
 == Exporting Data from Sahana ==
-Sahana export templates are stored in: {{{static/xslt/export}}}
+Sahana export templates are stored in: {{{static/formats/*/export.xsl}}}
 
 == Importing Data from Sahana ==
-Sahana import templates are stored in: {{{static/xslt/import}}}
+Sahana import templates are stored in: {{{static/formats/*/import.xsl}}}
 
 == Background Info and Resources ==
@@ -33 +32 @@
  * [http://www.w3schools.com/xpath/default.asp XPath Tutorial] on w3schools
  * [http://www.w3schools.com/xsl/tryxslt.asp?xmlfile=cdcatalog&xsltfile=cdcatalog interactive xslt environment]
+
+== Debugging ==
+Debug the stylesheets outside Sahana using Xalan.
+
+Start by converting smaller extracts in debug mode:
+{{{
+java -jar xalan.jar -param name shelter -param xsltmode extended -tt -tg -ts -in japanquake2011_shelter_extract.kml -xsl web2py\applications\eden\static\formats\kml\import.xsl -out shelters.xml
+}}}
+
+Then process the full thing in non-debug mode:
+{{{
+java -jar xalan.jar -param name shelter -param xsltmode extended -in japanquake2011_shelter.kml -xsl web2py\applications\eden\static\formats\kml\import.xsl -out shelters.xml
+}}}
+
+For a graphical IDE (Java, so cross-platform), you can trial [http://editix.com EditX]
+
+----
+DeveloperGuidelines