Structured Authoring » XSLT http://structuredauthoring.org Learning Structured Authoring - Tools and Processes Tue, 17 Aug 2010 15:03:47 +0000 en hourly 1 http://wordpress.org/?v=3.0.1 XSLT – Converting a Document to Change All Text http://structuredauthoring.org/sa/xslt-converting-document-change-text/ http://structuredauthoring.org/sa/xslt-converting-document-change-text/#comments Thu, 13 Aug 2009 13:50:56 +0000 douglaspaulwade http://structuredauthoring.org/?p=301 Using XSLT, I want to display some examples, however, not show you the original text. My sample file is a real-world example, but the content is a distraction. This simple transformation will convert all of the text nodes (document text) to x’s. During the transformation, the XSLT stylesheet will convert, all the capital, lowercase letters and the numbers to the lower case ‘x’. It will leave the punctuation alone, and the elements’ attributes are left unchanged.

Here is a sample snippet of the input file of S1000D Issue 3, XML:

<?xml version="1.0" encoding="UTF-8"?>

<dmodule xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
 xmlns:dc="http://www.purl.org/dc/elements/1.1/"
 xmlns:xlink="http://www.w3.org/1999/xlink"
 xsi:noNamespaceSchemaLocation="http://www.s1000d.org/S1000D_3-0/xml_schema_master/dm/faultSchema.xsd">

 <idstatus>
 <dmaddres>
 <dmc>
 <avee>
 <modelic>AAA</modelic>
 <sdc>B</sdc>
 <chapnum>28</chapnum>
 <section>0</section>
 <subsect>0</subsect>
 <subject>00</subject>
 <discode>00</discode>
 <discodev>A</discodev>
 <incode>421</incode>
 <incodev>A</incodev>
 <itemloc>A</itemloc>
 </avee>
 </dmc>
 <dmtitle>
 <techname>FUEL LEAK IN FORWARD COMPARTMENT AREA</techname>
 <infoname>OBSERVED FAULT PROCEDURE</infoname>
 </dmtitle>
 <issno issno="001" type="new"/>
 <issdate day="01" month="01" year="2009"/>
 </dmaddres>
 <status>
 <security/>
 <rpc/>
 <orig/>

Here is the transformation stylesheet:

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 xmlns:xs="http://www.w3.org/2001/XMLSchema"
 exclude-result-prefixes="xs"
 version="2.0">

 <!– Use indent yes for development, no for production –>
 <xsl:output method="xml" indent="yes"/>

 <!–
 Template match all items, except
 SGML Notations and Entities e.g., illustrations.
 –>
 <xsl:template match="@*|element()|comment()|processing-instruction()" mode="#all">
 <xsl:copy>
 <xsl:apply-templates select="@*|node()" mode="#current"/>
 </xsl:copy>
 </xsl:template>

 <!– Using the replace function,
 context is: string, pattern, replacement string–>
 <xsl:template match="text()">
 <xsl:value-of select="replace(.,’[a-zA-Z0-9]‘,’x')"/>
 </xsl:template>
</xsl:stylesheet>

Here is the result.s tree (a snippet).

<?xml version="1.0" encoding="UTF-8"?>
<dmodule xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
 xmlns:dc="http://www.purl.org/dc/elements/1.1/"
 xmlns:xlink="http://www.w3.org/1999/xlink"
 xsi:noNamespaceSchemaLocation="http://www.s1000d.org/S1000D_3-0/xml_schema_master/dm/faultSchema.xsd">

 <idstatus>
 <dmaddres>
 <dmc>
 <avee>
 <modelic>xxx</modelic>
 <sdc>x</sdc>
 <chapnum>xx</chapnum>
 <section>x</section>
 <subsect>x</subsect>
 <subject>xx</subject>
 <discode>xx</discode>
 <discodev>x</discodev>
 <incode>xxx</incode>
 <incodev>x</incodev>
 <itemloc>x</itemloc>
 </avee>
 </dmc>
 <dmtitle>
 <techname>xxxx xxxx xx xxxxxxx xxxxxxxxxxx xxxx</techname>
 <infoname>xxxxxxxx xxxxx xxxxxxxxx</infoname>
 </dmtitle>
 <issno issno="001" type="new"/>
 <issdate day="01" month="01" year="2009"/>
 </dmaddres>
 <status>
 <security/>
 <rpc/>
 <orig/>

]]> http://structuredauthoring.org/sa/xslt-converting-document-change-text/feed/ 0 XSLT – A Starting Point http://structuredauthoring.org/xslt/xslt-a-starting-point/ http://structuredauthoring.org/xslt/xslt-a-starting-point/#comments Mon, 10 Aug 2009 13:50:28 +0000 douglaspaulwade http://structuredauthoring.org/?p=293 I recently returned from an XSLT class taught by G. Ken Holman of Crane Softwrights. The class was five days training on XSLT, XQuery, and XPath. The class took place in Walnut Creek, California, August 3-7th, 2009. This was very intense. It was like trying to get a drink of water out of a fire hose. Ken covered every aspect of the specifications. The class was so over whelming that Joe (my co-worker) and I, being newbies, were clearly out classed. Most of the students had taken the class before, and one gentlemen just took it a month ago.

Being a newbie, I am going to post items on transformations that are not about covering everything in the specification; there are plenty of books that cover that. I want to give easy-to-follow examples which can be used in converting documents from one flavor of XML to another. I will not cover creating HTML pages or other outputs from these transformations.

I am no expert, but posting about a subject will help me improve upon writing XSLT. Being that I have a publishing background, I favor XSLT over XQuery (used more for machine-to-machine conversions).

From my IDE, I will be using <oXygen/>. I prefer it because it has a XSLT debugger, and boy, do I need it. It has several XSLT processors, like Xalan, and Saxon and Saxon-SA (Schema Aware) built in. For my source file, I will be using a S1000D Schema document, which all of the text node (words) have been changed to “x”s. That transformation will be posted in upcoming post. This is to protect the data and not display the content, so it does not take on any significance or meaning. If you are interested, <oXygen> has a 30 day free trial version, and/or you can purchase the Academic or Non-Commercial version for $64.

XSL stands for EXtensible Stylesheet Language and is a style sheet language for XML documents. XSLT stands for XSL Transformations. You can use XSLT to transform XML documents into other formats such as other XML documents, HTML, XHTML, and using XSLT-FO (format objects) transform XML to PDF, for example.

The specification is at version 2.0 (2.1 is coming soon), but not all vendors fully support 2.0, as of yet. The specification version 1.0 has been around for some time, and since I am new all of my examples will be in version 2.0, why learn version 1.0 when 2.0 is clearly more verbose.

XSLT is an XML (version 1.0) document. It must be well formed and valid. Below is an example of XSLT stylesheet used to transform an XML document. While it is valid, the stylesheet does not do much; its only output is: <?xml version=”1.0″ encoding=”UTF-8″?>.

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 xmlns:xs="http://www.w3.org/2001/XMLSchema"
 exclude-result-prefixes="xs"
 version="2.0">

 <xsl:template match="/" />

</xsl:stylesheet>

]]> http://structuredauthoring.org/xslt/xslt-a-starting-point/feed/ 1