book

XSLT

by Doug Tidwell

August 2001

Intermediate to advanced

480 pages

11h 16m

English

O'Reilly Media, Inc.

Read now

Unlock full access

Organization of This Book
I Believe in Open, Platform-Neutral, Standards-Based ComputingI Assume You’re BusyI Don’t Care Which Standards-Compliant Tools You UseXSLT Is a Tool, Not a Religion
The Design of XSLT
XML’s HeritageXML Document RulesAn XML document must be contained in a single elementAll elements must be nestedAll attributes must be quotedXML tags are case-sensitiveAll end tags are requiredEmpty tags can contain the end markerXML declarationsDocument Type Definitions (DTDs) and XML SchemasWell-formed versus valid documentsTags versus elementsNamespacesDOM and SAXDOMA sample DOM treeSAXXML StandardsXML 1.0The Extensible Stylesheet Language (XSL)XML SchemasThe Simple API for XML (SAX)Document Object Model (DOM) Level 1Document Object Model (DOM) Level 2Namespaces in XMLAssociating stylesheets with XML documentsScalable Vector Graphics (SVG)Canonical XML Version 1.0XML digital signaturesXML Pointer Language (XPointer) Version 1.0XML Linking Language (XLink) Version 1.0

Goals of This Chapter
Our Sample DocumentA Sample StylesheetTransforming the XML DocumentStylesheet Results
Parsing the StylesheetParsing the TransformeeLather, Rinse, RepeatWalking Through Our Example
The <xsl:stylesheet> ElementThe <xsl:output> ElementOur First <xsl:template>The <xsl:template> for <greeting> ElementsBuilt-in Template RulesBuilt-in template rule for element and root nodesBuilt-in template rule for modesBuilt-in template rule for text and attribute nodesBuilt-in template rule for comment and processing instruction nodesBuilt-in template rule for namespace nodesTop-Level ElementsOther Approaches
The Hello World SVG FileThe Hello World PDF FileThe Hello World Java ProgramThe Hello World VRML File
The XPath Data ModelThe Root NodeElement NodesAttribute NodesText NodesComment NodesProcessing Instruction NodesNamespace Nodes
The ContextSimple Location PathsRelative and Absolute ExpressionsSelecting Things Besides Elements with Location PathsSelecting attributesSelecting the text of an elementSelecting comments, processing instructions, and namespace nodesUsing WildcardsAxesUnabbreviated syntaxAxis roll callPredicatesNumbers in predicatesFunctions in predicates
Output ViewThe Stylesheet
Goals of This Chapter
The <xsl:if> ElementConverting to boolean valuesBoolean examplesThe <xsl:choose> Element<xsl:choose> exampleThe <xsl:for-each> Element<xsl:for-each> example
How It WorksTemplates à la Mode
Defining a Parameter in a TemplatePassing ParametersGlobal ParametersXalanXTMicrosoft’s XSLT toolsSaxonOracleSetting global parameters in a Java program
Are These Things Really Variables?Variable Scope
Implementing a String Replace FunctionProcedural designRecursive design
Template DesignImplementationThe Complete Example
XML InputTemplate DesignComplications
Generating Links with the id() FunctionThe ID, IDREF, and IDREFs DatatypesAn XML Document in Need of LinksA Stylesheet That Uses the id() FunctionLimitations of IDs
Defining a key()A Slightly More Complicated XML Document in Need of LinksStylesheets That Use the key() FunctionThe key() function and the IDREFS datatypeSolution #1: Replace the IDREFS datatypeSolution #2: Use the XPath contains() functionSolution #3: Use recursion to process the IDREFS datatypeSolution #4: Use an extension functionAdvantages of the key() Function
An Unstructured XML Document in Need of LinksThe generate-id() Function
Sorting Data with <xsl:sort>Our First ExampleThe Details on the <xsl:sort> ElementWhat’s the deal with that syntax?AttributesWhere can you use <xsl:sort>?Another Example
Our First AttemptA Brute-Force ApproachGrouping with <xsl:variable>The <xsl:key> Approach
Overview
An Aside: Doing Math with RecursionRecursive designGenerating output to initialize a variableUsing format-number() to control output
The document() Function and SortingImplementing Lookup TablesGrouping Across Multiple Documents
Extension Elements, Extension Functions, and Fallback ProcessingExtension ElementsExample: Generating multiple output filesExample: Using extension functions from multiple processorsExtension FunctionsExample: A library of trigonometric functionsExample: Writing extensions in other languagesFallback Processing
Generating JPEG Files from XML ContentAccessing a Database with an Extension Element
About the Toot-O-Matic
Make It Easier to Create TutorialsShow Our Audience That We Use the Technologies We AdvocateSee Just How Much We Could Accomplish Through Stylesheets
Menu PanelIndividual PanelsSection MenuFeedback PanelEmail PanelZip FilePDF Files
Individual Panels
Stylesheets and ModesInitializing Global VariablesGenerating the Main Menu PanelGenerating the Section IndexesGenerating the Individual PanelsGenerating the PDF FilesGenerating the JPEG FilesGenerating the Zip File
XPath Node TypesThe Root NodeElement NodesAttribute NodesText NodesComment NodesProcessing-Instruction NodesNamespace Nodes
Mathematical OperatorsBoolean OperatorsComparing values of various datatypesExpression Operators
How Do I Put Quotes Inside an Attribute Value?

Content preview from XSLT

Name

<xsl:include> — Allows you to include another XSLT stylesheet. This element allows you to put common transformations in a separate stylesheet, then include the templates from that stylesheet at any time. Unlike <xsl:import>, all templates included with <xsl:include> have the same priority as those in the including stylesheet. Another difference is that <xsl:include> can appear anywhere in a stylesheet, while <xsl:import> must appear at the beginning.

Required Attributes

href: Defines the URI of the included stylesheet.

Optional Attributes

None.

Content

None. <xsl:include> is an empty element.

Appears in

<xsl:include> is a top-level element and can appear only as a child of <xsl:stylesheet>.

Defined in

XSLT section 2.6.1, Stylesheet Inclusion.

Example

The <xsl:include> element is a good way to break your stylesheets into smaller pieces. (Those smaller pieces are often easier to reuse.) In our case study (see Chapter 9), we had a number of different stylesheets, each of which contained templates for a particular purpose. Here’s how our <xsl:include> elements look:

<xsl:include href="toot-o-matic-variables.xsl"/>

<xsl:include href="xslt-utilities.xsl"/>
<xsl:include href="dw-style.xsl"/>

<xsl:include href="build-main-index.xsl"/>
<xsl:include href="build-section-indexes.xsl"/>
<xsl:include href="build-individual-panels.xsl"/>
<xsl:include href="build-graphics.xsl"/>
<xsl:include href="build-pdf-file.xsl"/>
<xsl:include href="build-zip-file.xsl"/>

Segmenting your stylesheets ...