• Rewrote Oracle documentation and Blackboard elements to use the hyperlink template rather than hyperlink-internal. • Removed no longer necessary inclusion of EXSLT namespace (closes #5). • Removed obsolete hyperlink-internal and empty-hyperlink-url-internal templates. • Refactored oracle-docs.perl: - Rewrote with better Perl idiom (hash instead of tab-delimited strings for configuration).

nigel.stanger / XML

Browse code • Rewrote Oracle documentation and Blackboard elements to use the hyperlink template rather than hyperlink-internal. • Removed no longer necessary inclusion of EXSLT namespace (closes #5). • Removed obsolete hyperlink-internal and empty-hyperlink-url-internal templates. • Refactored oracle-docs.perl: - Rewrote with better Perl idiom (hash instead of tab-delimited strings for configuration). - Removed deprecated and obsolete code. master
1 parent c8e302b commit b5b8eddc2a5bb94eb541b14c7d1c990223d0a97f Nigel Stanger authored on 12 Feb 2016

Browse code

• Rewrote Oracle documentation and Blackboard elements to use the hyperlink template rather than hyperlink-internal.

• Removed no longer necessary inclusion of EXSLT namespace (closes #5).
• Removed obsolete hyperlink-internal and empty-hyperlink-url-internal templates.
• Refactored oracle-docs.perl:
    - Rewrote with better Perl idiom (hash instead of tab-delimited strings for configuration).
    - Removed deprecated and obsolete code.

master

1 parent c8e302b commit b5b8eddc2a5bb94eb541b14c7d1c990223d0a97f

Nigel Stanger authored on 12 Feb 2016

Patch

Showing 5 changed files

                Ignore Space
               Show notes
              View
            
          
          1 ■■■■■
          extract_svg_layers.xsl
 <xsl:stylesheet
	version="2.0"
	xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
	xmlns:exsl="http://exslt.org/common"
	xmlns:svg="http://www.w3.org/2000/svg"
	xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape">
 
 

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

<!--
	Extract named layers of an SVG file into an new SVG file. This is particularly useful for images that have a base layer of objects with various different overlays. The entire image can be created as one file with each overlay on a separate layer, then only the required overlay layers plus the base layer are output.
	
	The base layer is assumed to be named "Base Layer" (case-insensitive).
	
	Arguments
		$base-layer: The case-insensitive name of the base layer, which will always be included. Omit if there is no base layer.
		
		$layers: A list of case-insensitive layer names. You can use any character as a separator, as long as it doesn't appear in any of the layer names. Comma would be usual. Pass "*" to include all layers (this obviously rules out "*" as an layer name!).
		
		$items: A list of case-insensitive SVG item IDs to extract from the base layer. ONLY these items are extracted from the base layer; everything else in the base layer is ignored. Pass "*" to include all items (this obviously rules out "*" as an item ID!).
-->
	
<xsl:stylesheet
	version="2.0"
	xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
	xmlns:svg="http://www.w3.org/2000/svg"
	xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape">


	<xsl:output method="xml" encoding="UTF-8" standalone="no" />


	<!--
		The case-insensitive name of the base layer. Everything in the base layer will be included in the output, unless the $items parameter is set (see below).
	-->
	<xsl:param name="base-layer" />
	
	<!--
		The names of the layers to extract. Normally comma-separated, but any separator should work, as long as it doesn't appear in any of the layer names. Watch out for blanks in layer names when passing this from the command line! Note that the base layer is ALWAYS included in the output. Pass "*" to include all layers (default).
	-->
	<xsl:param name="layers">*</xsl:param>
	
	<!--
		A list of the *base layer* item IDs to extract. ONLY items that appear in this list will be extracted. Pass "*" to include all items (default).
	-->
	<xsl:param name="items">*</xsl:param>
	

	<!-- Identity transformation. -->
	<xsl:template match="@*|node()">
		<!-- Copy the current node -->
		<xsl:copy>
			<!-- Including any attributes it has and any child nodes -->
			<xsl:apply-templates select="@*|node()" />
		</xsl:copy>
	</xsl:template>
	
	
	<!--
		Always output the base layer.
		
		XPath explanation
			@inkscape:groupmode = 'layer'
				This is a layer.
			lower-case( @inkscape:label ) = lower-case( $base-layer )
				This is the base layer.
	-->
	<xsl:template name="output-base-layer"
		match="svg:g[ ( @inkscape:groupmode = 'layer' ) and
					  ( lower-case( @inkscape:label ) = lower-case( $base-layer ) )
					]" priority="10">
		<!-- Copy the current node -->
		<xsl:copy>
			<!-- Including any attributes it has and any child nodes -->
			<xsl:apply-templates select="@*|node()" />
		</xsl:copy>
	</xsl:template>
	
	
	<!--
		Ignore base layer items not included in the items list. The basic list of item types appears to be svg:rect, svg:text, svg:path (anything other than a rect or text) and svg:g (group). We only consider "top-level" elements within the layer, otherwise the number of potential element IDs could explode massively. This could will be tricky if we ever decide that we want to omit an item that appears inside a group.
		
		XPath explanation
			@inkscape:groupmode = 'layer'
				See output-base-layer template above.
			( lower-case( @inkscape:label ) = lower-case( $base-layer ) ) or ( $layers = '*' )
				Either this is the base layer, or we're outputting all layers anyway.
			
			.../element()[...]
				All immediate child elements of the base layer.
			
			contains( 'svg:g|svg:path|svg:rect|svg:text', string( node-name ( . ) ) )
				The current child element is one those listed.
			not( contains( lower-case( $items ), lower-case( @id ) ) )
				The current child node's ID isn't in the items list.
			$items != '*'
				We're not outputting all items.
	-->
	<xsl:template name="ignore-items"
		match="svg:g[ ( @inkscape:groupmode = 'layer' ) and
					  ( ( lower-case( @inkscape:label ) = lower-case( $base-layer ) ) or
					    ( $layers = '*' )
					  )
					]/element()[ contains( 'svg:g|svg:path|svg:rect|svg:text', string( node-name ( . ) ) ) and
					             not( contains( lower-case( $items ), lower-case( @id ) ) ) and
					             ( $items != '*' )
					           ]" />
	
	
	<!--
		Ignore layers that aren't in the list of layers.
		
		XPath explanation
			@inkscape:groupmode = 'layer'
				See output-base-layer template above.
			$layers != '*'
				We're not outputting all layers
			not( contains ( $layers, @inkscape:label ) )
				The layer's label isn't in the list of layers.
	-->
	<xsl:template name="ignore-layers"
		match="svg:g[ ( @inkscape:groupmode = 'layer' ) and
					  ( $layers != '*') and
					  not( contains ( lower-case( $layers ), lower-case( @inkscape:label ) ) )
					]" />
	
	
	<!--
		Ensure that extracted layers are always visible, regardless of their setting in the original file.
		
		XPath explanation
			@inkscape:groupmode = 'layer'
				See output-base-layer template above.
			@style[. = 'display:none']
				This layer is invisible.
	-->
	<xsl:template name="make-layers-visible" match="svg:g[@inkscape:groupmode = 'layer']/@style[. = 'display:none']">
		<xsl:attribute name="style">
			<xsl:text>display:inline</xsl:text>
		</xsl:attribute>
	</xsl:template>
	
	
</xsl:stylesheet>

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

<!--
	Extract named layers of an SVG file into an new SVG file. This is particularly useful for images that have a base layer of objects with various different overlays. The entire image can be created as one file with each overlay on a separate layer, then only the required overlay layers plus the base layer are output.
	
	The base layer is assumed to be named "Base Layer" (case-insensitive).
	
	Arguments
		$base-layer: The case-insensitive name of the base layer, which will always be included. Omit if there is no base layer.
		
		$layers: A list of case-insensitive layer names. You can use any character as a separator, as long as it doesn't appear in any of the layer names. Comma would be usual. Pass "*" to include all layers (this obviously rules out "*" as an layer name!).
		
		$items: A list of case-insensitive SVG item IDs to extract from the base layer. ONLY these items are extracted from the base layer; everything else in the base layer is ignored. Pass "*" to include all items (this obviously rules out "*" as an item ID!).
-->
	
<xsl:stylesheet
	version="2.0"
	xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
	xmlns:exsl="http://exslt.org/common"
	xmlns:svg="http://www.w3.org/2000/svg"
	xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape">


	<xsl:output method="xml" encoding="UTF-8" standalone="no" />


	<!--
		The case-insensitive name of the base layer. Everything in the base layer will be included in the output, unless the $items parameter is set (see below).
	-->
	<xsl:param name="base-layer" />
	
	<!--
		The names of the layers to extract. Normally comma-separated, but any separator should work, as long as it doesn't appear in any of the layer names. Watch out for blanks in layer names when passing this from the command line! Note that the base layer is ALWAYS included in the output. Pass "*" to include all layers (default).
	-->
	<xsl:param name="layers">*</xsl:param>
	
	<!--
		A list of the *base layer* item IDs to extract. ONLY items that appear in this list will be extracted. Pass "*" to include all items (default).
	-->
	<xsl:param name="items">*</xsl:param>
	

	<!-- Identity transformation. -->
	<xsl:template match="@*|node()">
		<!-- Copy the current node -->
		<xsl:copy>
			<!-- Including any attributes it has and any child nodes -->
			<xsl:apply-templates select="@*|node()" />
		</xsl:copy>
	</xsl:template>
	
	
	<!--
		Always output the base layer.
		
		XPath explanation
			@inkscape:groupmode = 'layer'
				This is a layer.
			lower-case( @inkscape:label ) = lower-case( $base-layer )
				This is the base layer.
	-->
	<xsl:template name="output-base-layer"
		match="svg:g[ ( @inkscape:groupmode = 'layer' ) and
					  ( lower-case( @inkscape:label ) = lower-case( $base-layer ) )
					]" priority="10">
		<!-- Copy the current node -->
		<xsl:copy>
			<!-- Including any attributes it has and any child nodes -->
			<xsl:apply-templates select="@*|node()" />
		</xsl:copy>
	</xsl:template>
	
	
	<!--
		Ignore base layer items not included in the items list. The basic list of item types appears to be svg:rect, svg:text, svg:path (anything other than a rect or text) and svg:g (group). We only consider "top-level" elements within the layer, otherwise the number of potential element IDs could explode massively. This could will be tricky if we ever decide that we want to omit an item that appears inside a group.
		
		XPath explanation
			@inkscape:groupmode = 'layer'
				See output-base-layer template above.
			( lower-case( @inkscape:label ) = lower-case( $base-layer ) ) or ( $layers = '*' )
				Either this is the base layer, or we're outputting all layers anyway.
			
			.../element()[...]
				All immediate child elements of the base layer.
			
			contains( 'svg:g|svg:path|svg:rect|svg:text', string( node-name ( . ) ) )
				The current child element is one those listed.
			not( contains( lower-case( $items ), lower-case( @id ) ) )
				The current child node's ID isn't in the items list.
			$items != '*'
				We're not outputting all items.
	-->
	<xsl:template name="ignore-items"
		match="svg:g[ ( @inkscape:groupmode = 'layer' ) and
					  ( ( lower-case( @inkscape:label ) = lower-case( $base-layer ) ) or
					    ( $layers = '*' )
					  )
					]/element()[ contains( 'svg:g|svg:path|svg:rect|svg:text', string( node-name ( . ) ) ) and
					             not( contains( lower-case( $items ), lower-case( @id ) ) ) and
					             ( $items != '*' )
					           ]" />
	
	
	<!--
		Ignore layers that aren't in the list of layers.
		
		XPath explanation
			@inkscape:groupmode = 'layer'
				See output-base-layer template above.
			$layers != '*'
				We're not outputting all layers
			not( contains ( $layers, @inkscape:label ) )
				The layer's label isn't in the list of layers.
	-->
	<xsl:template name="ignore-layers"
		match="svg:g[ ( @inkscape:groupmode = 'layer' ) and
					  ( $layers != '*') and
					  not( contains ( lower-case( $layers ), lower-case( @inkscape:label ) ) )
					]" />
	
	
	<!--
		Ensure that extracted layers are always visible, regardless of their setting in the original file.
		
		XPath explanation
			@inkscape:groupmode = 'layer'
				See output-base-layer template above.
			@style[. = 'display:none']
				This layer is invisible.
	-->
	<xsl:template name="make-layers-visible" match="svg:g[@inkscape:groupmode = 'layer']/@style[. = 'display:none']">
		<xsl:attribute name="style">
			<xsl:text>display:inline</xsl:text>
		</xsl:attribute>
	</xsl:template>
	
	
</xsl:stylesheet>
 <xsl:stylesheet
 	version="2.0"
 	xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-	xmlns:exsl="http://exslt.org/common"
 	xmlns:svg="http://www.w3.org/2000/svg"
 	xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape">

                Ignore Space
               Show notes
              View
            
          
          18 ■■■■■
          modules/global-elements.xml
 		A link to Blackboard.
	-->
	<template name="Blackboard" match="Blackboard">
		<common>
			<xsl:call-template name="hyperlink-internal">
				<xsl:with-param name="url">https://blackboard.otago.ac.nz/</xsl:with-param>
				<xsl:with-param name="label">Blackboard</xsl:with-param>
			</xsl:call-template>
		    <xsl:variable name="BlackboardLink">
		        <xsl:element name="hyperlink">
		            <xsl:attribute name="url">
		                <xsl:text>https://blackboard.otago.ac.nz/</xsl:text>
		            </xsl:attribute>
		            <xsl:text>Blackboard</xsl:text>
		        </xsl:element>
		    </xsl:variable>
			<xsl:apply-templates select="$BlackboardLink" />
		</common>
	</template>
 
	<template name="Blackboard-strip" match="Blackboard" mode="strip">

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

<!--
	Various "global" elements that are frequently used across all documents. Some are passed in as arguments to the stylesheet (e.g., paper number), while others are things that don't change that often, and are thus hard coded (e.g., Oracle version). One or two are dynamic, based on elements within the document (e.g., the due date for an assignment).
	
	The "strip" mode forms of the templates are for use in the context of an HTML <title> element (so the mode is only relevant to the HTML formats). Embedding HTML markup inside the <title> element causes the markup to appear verbatim in the window title, i.e., <title><em>foo</em> bar</title> will appear in the window title as "<em>foo</em> bar", not "foo bar". Putting the stylesheet into strip mode means that it will only output text nodes unless otherwise specified for a particular element. Generally the "strip" templates will simply call-template to the original, unless the original contains markup that needs to be eliminated (e.g., see OracleServer below).
	
	The downside of this approach, of course, is that you need "strip" mode templates for quite a lot of things, but that can't really be helped.
-->

<stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

	<!--
		Subject code (e.g., "INFO").
	-->
	<template name="SubjectCode" match="SubjectCode">
		<common>
			<xsl:value-of select="$subject-code" />
		</common>
	</template>

	<template name="SubjectCode-strip" match="SubjectCode" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:call-template name="SubjectCode" />
		</common>
	</template>

	<!--
		Paper number (e.g., "212").
	-->
	<template name="PaperNumber" match="PaperNumber">
		<common>
			<xsl:value-of select="$paper-number" />
		</common>
	</template>

	<template name="PaperNumber-strip" match="PaperNumber" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:call-template name="PaperNumber" />
		</common>
	</template>

	<!--
		Complete paper code (e.g., "INFO 212").
	-->
	<template name="PaperCode" match="PaperCode">
		<common>
			<xsl:value-of select="$subject-code" />
			<xsl:text> </xsl:text>
			<xsl:value-of select="$paper-number" />
		</common>
	</template>

	<template name="PaperCode-strip" match="PaperCode" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:call-template name="PaperCode" />
		</common>
	</template>
	
	<!--
		Year in which the paper is offered, plus or minus some offset.
		
		@offset: Output the year +/- some integer value. The input value is truncated and defaults to zero if not supplied.
	-->
	<template name="PaperYear" match="PaperYear">
		<common>
			<xsl:variable name="add" as="xs:integer">
				<xsl:value-of select="if ( @offset ) then floor( @offset ) else 0" />
			</xsl:variable>
			<!--
				It appears that we need an explicit type cast for $paper-year to keep everyone happy?!?! Even if you declare $paper-year to be xs:integer, XML Exchanger Editor still thinks you can't add a string ($paper-year) to an integer ($add). Stupid.
			-->
			<xsl:value-of select="xs:integer( $paper-year ) + $add" />
		</common>
	</template>

	<template name="PaperYear-strip" match="PaperYear" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:call-template name="PaperYear" />
		</common>
	</template>

	<!--
		Period in which a paper is offered (e.g., "Semester 2").
	-->
	<template name="PaperPeriod" match="PaperPeriod">
		<common>
			<xsl:value-of select="$period-string" />
		</common>
	</template>

	<template name="PaperPeriod-strip" match="PaperPeriod" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:call-template name="PaperPeriod" />
		</common>
	</template>

	<!--
		The name of the currently used Oracle server.
	-->
	<template name="OracleServer" match="OracleServer">
		<common formats="/latex/xelatex/">Oracle11\textit{g}</common>
		<common formats="/html/xhtml/">Oracle11<i>g</i></common>
	</template>

	<template name="OracleServer-strip" match="OracleServer" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:text>Oracle11g</xsl:text>
		</common>
	</template>

	<!--
		The release number of the currently used Oracle server.
	-->
	<template name="OracleServerRelease" match="OracleServerRelease">
		<common>2</common>
	</template>

	<template name="OracleServerRelease-strip" match="OracleServerRelease" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:call-template name="OracleServerRelease" />
		</common>
	</template>

	<!--
		The version number of the currently used Oracle server.
	-->
	<template name="OracleServerVersion" match="OracleServerVersion">
		<common>11.2</common>
	</template>

	<template name="OracleServerVersion-strip" match="OracleServerVersion" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:call-template name="OracleServerVersion" />
		</common>
	</template>

	<!--
		A link to Blackboard.
	-->
	<template name="Blackboard" match="Blackboard">
		<common>
		    <xsl:variable name="BlackboardLink">
		        <xsl:element name="hyperlink">
		            <xsl:attribute name="url">
		                <xsl:text>https://blackboard.otago.ac.nz/</xsl:text>
		            </xsl:attribute>
		            <xsl:text>Blackboard</xsl:text>
		        </xsl:element>
		    </xsl:variable>
			<xsl:apply-templates select="$BlackboardLink" />
		</common>
	</template>

	<template name="Blackboard-strip" match="Blackboard" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:text>Blackboard</xsl:text>
		</common>
	</template>
	
	<!--
		Assignment due date. Obviously this is only relevant if /document/@class is "assignment". The code seems a little inelegant, but there isn't really any other way to do it.
		
		@style: Additional formatting to apply to the due date when displayed. It should be a delimited list (it doesn't really matter what the delimiter is) containing one or more of the following values: "bold", "italic", "underline". Anything unrecognised is ignored.
	-->
	<template name="DueDate" match="DueDate">
		<common>
			<!-- There must be a due-date element for this to work! -->
			<xsl:if test="not( /document/due-date )">
				<xsl:message terminate="yes">The due date for this assignment has not been specified (use /document/due-date).</xsl:message>
			</xsl:if>
		</common>
		<common formats="/latex/xelatex/">
			<xsl:if test="contains( @style, 'bold' )">
				<xsl:text>\textbf{</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'italic' )">
				<xsl:text>\emph{</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'underline' )">
				<xsl:text>\underline{</xsl:text>
			</xsl:if>
			<xsl:apply-templates select="/document/due-date" mode="inline" />
			<!-- It doesn't actually matter in what order we generate the closing braces. -->
			<xsl:if test="contains( @style, 'underline' )">
				<xsl:text>}</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'italic' )">
				<xsl:text>}</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'bold' )">
				<xsl:text>}</xsl:text>
			</xsl:if>
		</common>
		<common formats="/html/xhtml/">
			<!--
				Unfortunately, we have to generate the formatting elements as raw text rather than proper elements because otherwise the XSLT code would not be well-formed.
			-->
			<xsl:if test="contains( @style, 'bold' )">
				<xsl:text disable-output-escaping="yes">&lt;strong&gt;</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'italic' )">
				<xsl:text disable-output-escaping="yes">&lt;em&gt;</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'underline' )">
				<xsl:text disable-output-escaping="yes">&lt;ul&gt;</xsl:text>
			</xsl:if>
			<xsl:apply-templates select="/document/due-date" mode="inline" />
			<xsl:if test="contains( @style, 'underline' )">
			<!-- We must close the elements in the correct order! -->
				<xsl:text disable-output-escaping="yes">&lt;/ul&gt;</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'italic' )">
				<xsl:text disable-output-escaping="yes">&lt;/em&gt;</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'bold' )">
				<xsl:text disable-output-escaping="yes">&lt;/strong&gt;</xsl:text>
			</xsl:if>
		</common>
	</template>
	
	<!--
		It seems pretty unlikely that someone will want to put the due date in the HTML document title, but I'm paranoid :).
	-->
	<template name="DueDate-strip" match="DueDate" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:apply-templates select="/document/due-date" mode="inline" />
		</common>
	</template>


</stylesheet>

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

<!--
	Various "global" elements that are frequently used across all documents. Some are passed in as arguments to the stylesheet (e.g., paper number), while others are things that don't change that often, and are thus hard coded (e.g., Oracle version). One or two are dynamic, based on elements within the document (e.g., the due date for an assignment).
	
	The "strip" mode forms of the templates are for use in the context of an HTML <title> element (so the mode is only relevant to the HTML formats). Embedding HTML markup inside the <title> element causes the markup to appear verbatim in the window title, i.e., <title><em>foo</em> bar</title> will appear in the window title as "<em>foo</em> bar", not "foo bar". Putting the stylesheet into strip mode means that it will only output text nodes unless otherwise specified for a particular element. Generally the "strip" templates will simply call-template to the original, unless the original contains markup that needs to be eliminated (e.g., see OracleServer below).
	
	The downside of this approach, of course, is that you need "strip" mode templates for quite a lot of things, but that can't really be helped.
-->

<stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

	<!--
		Subject code (e.g., "INFO").
	-->
	<template name="SubjectCode" match="SubjectCode">
		<common>
			<xsl:value-of select="$subject-code" />
		</common>
	</template>

	<template name="SubjectCode-strip" match="SubjectCode" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:call-template name="SubjectCode" />
		</common>
	</template>

	<!--
		Paper number (e.g., "212").
	-->
	<template name="PaperNumber" match="PaperNumber">
		<common>
			<xsl:value-of select="$paper-number" />
		</common>
	</template>

	<template name="PaperNumber-strip" match="PaperNumber" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:call-template name="PaperNumber" />
		</common>
	</template>

	<!--
		Complete paper code (e.g., "INFO 212").
	-->
	<template name="PaperCode" match="PaperCode">
		<common>
			<xsl:value-of select="$subject-code" />
			<xsl:text> </xsl:text>
			<xsl:value-of select="$paper-number" />
		</common>
	</template>

	<template name="PaperCode-strip" match="PaperCode" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:call-template name="PaperCode" />
		</common>
	</template>
	
	<!--
		Year in which the paper is offered, plus or minus some offset.
		
		@offset: Output the year +/- some integer value. The input value is truncated and defaults to zero if not supplied.
	-->
	<template name="PaperYear" match="PaperYear">
		<common>
			<xsl:variable name="add" as="xs:integer">
				<xsl:value-of select="if ( @offset ) then floor( @offset ) else 0" />
			</xsl:variable>
			<!--
				It appears that we need an explicit type cast for $paper-year to keep everyone happy?!?! Even if you declare $paper-year to be xs:integer, XML Exchanger Editor still thinks you can't add a string ($paper-year) to an integer ($add). Stupid.
			-->
			<xsl:value-of select="xs:integer( $paper-year ) + $add" />
		</common>
	</template>

	<template name="PaperYear-strip" match="PaperYear" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:call-template name="PaperYear" />
		</common>
	</template>

	<!--
		Period in which a paper is offered (e.g., "Semester 2").
	-->
	<template name="PaperPeriod" match="PaperPeriod">
		<common>
			<xsl:value-of select="$period-string" />
		</common>
	</template>

	<template name="PaperPeriod-strip" match="PaperPeriod" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:call-template name="PaperPeriod" />
		</common>
	</template>

	<!--
		The name of the currently used Oracle server.
	-->
	<template name="OracleServer" match="OracleServer">
		<common formats="/latex/xelatex/">Oracle11\textit{g}</common>
		<common formats="/html/xhtml/">Oracle11<i>g</i></common>
	</template>

	<template name="OracleServer-strip" match="OracleServer" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:text>Oracle11g</xsl:text>
		</common>
	</template>

	<!--
		The release number of the currently used Oracle server.
	-->
	<template name="OracleServerRelease" match="OracleServerRelease">
		<common>2</common>
	</template>

	<template name="OracleServerRelease-strip" match="OracleServerRelease" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:call-template name="OracleServerRelease" />
		</common>
	</template>

	<!--
		The version number of the currently used Oracle server.
	-->
	<template name="OracleServerVersion" match="OracleServerVersion">
		<common>11.2</common>
	</template>

	<template name="OracleServerVersion-strip" match="OracleServerVersion" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:call-template name="OracleServerVersion" />
		</common>
	</template>

	<!--
		A link to Blackboard.
	-->
	<template name="Blackboard" match="Blackboard">
		<common>
			<xsl:call-template name="hyperlink-internal">
				<xsl:with-param name="url">https://blackboard.otago.ac.nz/</xsl:with-param>
				<xsl:with-param name="label">Blackboard</xsl:with-param>
			</xsl:call-template>
		</common>
	</template>

	<template name="Blackboard-strip" match="Blackboard" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:text>Blackboard</xsl:text>
		</common>
	</template>
	
	<!--
		Assignment due date. Obviously this is only relevant if /document/@class is "assignment". The code seems a little inelegant, but there isn't really any other way to do it.
		
		@style: Additional formatting to apply to the due date when displayed. It should be a delimited list (it doesn't really matter what the delimiter is) containing one or more of the following values: "bold", "italic", "underline". Anything unrecognised is ignored.
	-->
	<template name="DueDate" match="DueDate">
		<common>
			<!-- There must be a due-date element for this to work! -->
			<xsl:if test="not( /document/due-date )">
				<xsl:message terminate="yes">The due date for this assignment has not been specified (use /document/due-date).</xsl:message>
			</xsl:if>
		</common>
		<common formats="/latex/xelatex/">
			<xsl:if test="contains( @style, 'bold' )">
				<xsl:text>\textbf{</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'italic' )">
				<xsl:text>\emph{</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'underline' )">
				<xsl:text>\underline{</xsl:text>
			</xsl:if>
			<xsl:apply-templates select="/document/due-date" mode="inline" />
			<!-- It doesn't actually matter in what order we generate the closing braces. -->
			<xsl:if test="contains( @style, 'underline' )">
				<xsl:text>}</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'italic' )">
				<xsl:text>}</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'bold' )">
				<xsl:text>}</xsl:text>
			</xsl:if>
		</common>
		<common formats="/html/xhtml/">
			<!--
				Unfortunately, we have to generate the formatting elements as raw text rather than proper elements because otherwise the XSLT code would not be well-formed.
			-->
			<xsl:if test="contains( @style, 'bold' )">
				<xsl:text disable-output-escaping="yes">&lt;strong&gt;</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'italic' )">
				<xsl:text disable-output-escaping="yes">&lt;em&gt;</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'underline' )">
				<xsl:text disable-output-escaping="yes">&lt;ul&gt;</xsl:text>
			</xsl:if>
			<xsl:apply-templates select="/document/due-date" mode="inline" />
			<xsl:if test="contains( @style, 'underline' )">
			<!-- We must close the elements in the correct order! -->
				<xsl:text disable-output-escaping="yes">&lt;/ul&gt;</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'italic' )">
				<xsl:text disable-output-escaping="yes">&lt;/em&gt;</xsl:text>
			</xsl:if>
			<xsl:if test="contains( @style, 'bold' )">
				<xsl:text disable-output-escaping="yes">&lt;/strong&gt;</xsl:text>
			</xsl:if>
		</common>
	</template>
	
	<!--
		It seems pretty unlikely that someone will want to put the due date in the HTML document title, but I'm paranoid :).
	-->
	<template name="DueDate-strip" match="DueDate" mode="strip">
		<common formats="/html/xhtml/">
			<xsl:apply-templates select="/document/due-date" mode="inline" />
		</common>
	</template>


</stylesheet>
 		A link to Blackboard.
 	-->
 	<template name="Blackboard" match="Blackboard">
 		<common>
+			<xsl:call-template name="hyperlink-internal">
+				<xsl:with-param name="url">https://blackboard.otago.ac.nz/</xsl:with-param>
+				<xsl:with-param name="label">Blackboard</xsl:with-param>
+			</xsl:call-template>
+		    <xsl:variable name="BlackboardLink">
+		        <xsl:element name="hyperlink">
+		            <xsl:attribute name="url">
+		                <xsl:text>https://blackboard.otago.ac.nz/</xsl:text>
+		            </xsl:attribute>
+		            <xsl:text>Blackboard</xsl:text>
+		        </xsl:element>
+		    </xsl:variable>
+			<xsl:apply-templates select="$BlackboardLink" />
 		</common>
 	</template>
 	<template name="Blackboard-strip" match="Blackboard" mode="strip">

                Ignore Space
               Show notes
              View
            
          
          36 ■■■■■
          modules/hyperlinks.xml
                     <!--
                        Sometimes the hyperlink content may be explicitly split across multiple lines, separated by <br> elements. This isn't a problem in (X)HTML, but it breaks (Xe)LaTeX, because you can't include a \\ inside most macros. The solution is to explicitly process the sub-elements, and wrap appropriate hyperref macros around them, /except/ for any embedded <br> elements. This does lead to some slightly
                        odd output when you embed markup in the hyperlink text; in particular, spaces won't be included in
                        the hyperlink.
                        
                        We can't just call hyperlink-internal, because we still want to process the <br> elements.
                    -->
                    <xsl:for-each select="node()">
                        <xsl:if test="not( self::br )">
                            <xsl:text>\href{</xsl:text>
                </xsl:otherwise>
            </xsl:choose>
        </common>
        <common formats="/html/xhtml/">
            <!-- We can't just call hyperlink-internal, because there may be an @target attribute. -->
            <a href="{$fullURL}">
                <xsl:if test="@target">
                    <xsl:attribute name="target">
                        <xsl:value-of select="@target" />
        </common>
    </template>
    
    
    <!-- Internal parameterised hyperlink templates to be called by the likes of the empty Oracle documentation elements. -->
    <template name="hyperlink-internal" match="hyperlink" mode="hyperlink-internal">
        <common>
            <xsl:param name="url" />
            <xsl:param name="label" />
        </common>
        <common formats="/latex/xelatex/">
            <xsl:text>\href{</xsl:text>
            <xsl:value-of select="$url" />
            <xsl:text>}{</xsl:text>
            <xsl:apply-templates select="exsl:node-set($label)" />
            <xsl:text>}</xsl:text>
        </common>
        <common formats="/html/xhtml/">
            <a href="{$url}"><xsl:apply-templates select="exsl:node-set($label)" /></a>
        </common>
    </template>
 
    <template name="empty-hyperlink-url-internal" match="hyperlink" mode="empty-hyperlink-internal">
        <common>
            <xsl:param name="url" />
        </common>
        <common formats="/latex/xelatex/">
            <xsl:text>\url{</xsl:text>
            <xsl:value-of select="$url" />
            <xsl:text>}</xsl:text>
        </common>
        <common formats="/html/xhtml/">
            <a href="{$url}"><code><xsl:value-of select="$url" /></code></a>
        </common>
    </template>
    
    
    <!-- A plain URL (i.e., not necessarily a hyperlink). -->
    <template name="url" match="url|uri|email|e-mail|email-address|e-mail-address">
        <!--
            \url in Hyperref will give us an active linke, so use \nolinkurl instead.

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

<!--
    Hyperlinks and URLs. The content of the hyperlink element becomes the link text. All hyperlink elements have these attributes:
    
    @url: A URL that the hyperlink links to. If no link text is provided, the URL is used as the link text.
    
    @label: A label that the hyperlink links to. The value should be an acceptable label in both LaTeX and HTML.
    
    @target: The target tab/window to open the hyperlink in. Only applies to (X)HTML.
-->

<stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform">


    <!--
        A hyperlink with an HTTP URL and some combination of label (page anchor) and content (link text).
        
        @url:       The URL to link to. [required]
        @label:     The name of the anchor to link to in the URL (i.e., url#label). [optional]
        @target:    The target of the URL (e.g., _blank). Only relevant to (X)HTML. [optional]
    -->
    <template name="hyperlink" match="hyperlink[@url]">
        <!--
            In very rare circumstances, hyperref can get munged in such a way that it doesn't correctly escape the # character for the anchor (e.g., an \href inside a \resizebox; why? I don't know). We therefore need to escape it manually, which produces the correct output regardless. The best way to do this is construct the full URL first, then replace "#" with "\#" in (Xe)LaTeX; this also catches hyperlinks where the author has embedded the anchor in the @url attribute.
        -->
        <common>
            <xsl:variable name="fullURL">
                <xsl:value-of select="@url" />
                <xsl:if test="@label">
                    <xsl:text>#</xsl:text>
                    <xsl:value-of select="@label" />
                </xsl:if>
            </xsl:variable>
        </common>
        <common formats="/latex/xelatex/">
            <xsl:choose>
                <!--
                    Just a bare URL with no link text.
                -->
                <xsl:when test="not( node() )">
                    <xsl:text>\url{</xsl:text>
                    <xsl:value-of select="replace( $fullURL, '#', '\\#' )" />
                    <xsl:text>}</xsl:text>
                </xsl:when>
                <xsl:otherwise>
                    <!--
                        Sometimes the hyperlink content may be explicitly split across multiple lines, separated by <br> elements. This isn't a problem in (X)HTML, but it breaks (Xe)LaTeX, because you can't include a \\ inside most macros. The solution is to explicitly process the sub-elements, and wrap appropriate hyperref macros around them, /except/ for any embedded <br> elements. This does lead to some slightly
                        odd output when you embed markup in the hyperlink text; in particular, spaces won't be included in
                        the hyperlink.
                    -->
                    <xsl:for-each select="node()">
                        <xsl:if test="not( self::br )">
                            <xsl:text>\href{</xsl:text>
                            <xsl:value-of select="replace( $fullURL, '#', '\\#' )" />
                            <xsl:text>}{</xsl:text>
                        </xsl:if>
                        <xsl:apply-templates select="." />
                        <xsl:if test="not( self::br )">
                            <xsl:text>}</xsl:text>
                        </xsl:if>
                    </xsl:for-each>
                </xsl:otherwise>
            </xsl:choose>
        </common>
        <common formats="/html/xhtml/">
            <a href="{$fullURL}">
                <xsl:if test="@target">
                    <xsl:attribute name="target">
                        <xsl:value-of select="@target" />
                    </xsl:attribute>
                </xsl:if>
                <xsl:choose>
                    <xsl:when test="not( node() )">
        				<code><xsl:value-of select="$fullURL" /></code>
                    </xsl:when>
                    <xsl:otherwise>
                        <xsl:apply-templates />
                    </xsl:otherwise>
                </xsl:choose>
            </a>
        </common>
    </template>
    
    
    <!--
        Special case: hyperlink with a label and content but no URL. These represent internal links within the document, and require different code in (Xe)LaTeX (need to use the full \hyperref macro instead of \href).
        
        @label:     The name of the label to link to (will become #label in (X)HTML). [required]
        @target:    The target of the URL (e.g., _blank). Only relevant to (X)HTML. [optional]
    -->
    <template name="hyperlink-label" match="hyperlink[@label and node() and not( @url )]">
        <!-- Note: not safe to use the url package here because \url{...} is fragile. -->
        <common formats="/latex/xelatex/">
            <xsl:for-each select="node()">
                <xsl:if test="not( self::br )">
                    <xsl:text>\hyperref[</xsl:text>
                    <xsl:value-of select="../@label" />
                    <xsl:text>]{</xsl:text>
                </xsl:if>
                <xsl:apply-templates select="." />
                <xsl:if test="not( self::br )">
                    <xsl:text>}</xsl:text>
                </xsl:if>
            </xsl:for-each>
        </common>
        <common formats="/html/xhtml/">
            <a href="#{@label}">
                <xsl:if test="@target">
                    <xsl:attribute name="target">
                        <xsl:value-of select="@target" />
                    </xsl:attribute>
                </xsl:if>
                <xsl:apply-templates />
            </a>
        </common>
    </template>
    
    
    <!-- ERROR: hyperlink has a label, but no URL and no content. -->
    <template name="empty-hyperlink-label" match="hyperlink[@label and not( node() ) and not( @url )]">
        <common>
            <xsl:message terminate="yes">&lt;hyperlink&gt; with @label and no @url must include link text.</xsl:message>
        </common>
    </template>
    
    
    <!-- A plain URL (i.e., not necessarily a hyperlink). -->
    <template name="url" match="url|uri|email|e-mail|email-address|e-mail-address">
        <!--
            \url in Hyperref will give us an active linke, so use \nolinkurl instead.
        -->
        <common formats="/latex/xelatex/">
            <xsl:text>\nolinkurl{</xsl:text>
            <xsl:apply-templates />
            <xsl:text>}</xsl:text>
        </common>
        <common formats="/html/xhtml/">
            <code><xsl:apply-templates /></code>
        </common>
    </template>


</stylesheet>

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

<!--
    Hyperlinks and URLs. The content of the hyperlink element becomes the link text. All hyperlink elements have these attributes:
    
    @url: A URL that the hyperlink links to. If no link text is provided, the URL is used as the link text.
    
    @label: A label that the hyperlink links to. The value should be an acceptable label in both LaTeX and HTML.
    
    @target: The target tab/window to open the hyperlink in. Only applies to (X)HTML.
-->

<stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform">


    <!--
        A hyperlink with an HTTP URL and some combination of label (page anchor) and content (link text).
        
        @url:       The URL to link to. [required]
        @label:     The name of the anchor to link to in the URL (i.e., url#label). [optional]
        @target:    The target of the URL (e.g., _blank). Only relevant to (X)HTML. [optional]
    -->
    <template name="hyperlink" match="hyperlink[@url]">
        <!--
            In very rare circumstances, hyperref can get munged in such a way that it doesn't correctly escape the # character for the anchor (e.g., an \href inside a \resizebox; why? I don't know). We therefore need to escape it manually, which produces the correct output regardless. The best way to do this is construct the full URL first, then replace "#" with "\#" in (Xe)LaTeX; this also catches hyperlinks where the author has embedded the anchor in the @url attribute.
        -->
        <common>
            <xsl:variable name="fullURL">
                <xsl:value-of select="@url" />
                <xsl:if test="@label">
                    <xsl:text>#</xsl:text>
                    <xsl:value-of select="@label" />
                </xsl:if>
            </xsl:variable>
        </common>
        <common formats="/latex/xelatex/">
            <xsl:choose>
                <!--
                    Just a bare URL with no link text.
                -->
                <xsl:when test="not( node() )">
                    <xsl:text>\url{</xsl:text>
                    <xsl:value-of select="replace( $fullURL, '#', '\\#' )" />
                    <xsl:text>}</xsl:text>
                </xsl:when>
                <xsl:otherwise>
                    <!--
                        Sometimes the hyperlink content may be explicitly split across multiple lines, separated by <br> elements. This isn't a problem in (X)HTML, but it breaks (Xe)LaTeX, because you can't include a \\ inside most macros. The solution is to explicitly process the sub-elements, and wrap appropriate hyperref macros around them, /except/ for any embedded <br> elements. This does lead to some slightly
                        odd output when you embed markup in the hyperlink text; in particular, spaces won't be included in
                        the hyperlink.
                        
                        We can't just call hyperlink-internal, because we still want to process the <br> elements.
                    -->
                    <xsl:for-each select="node()">
                        <xsl:if test="not( self::br )">
                            <xsl:text>\href{</xsl:text>
                            <xsl:value-of select="replace( $fullURL, '#', '\\#' )" />
                            <xsl:text>}{</xsl:text>
                        </xsl:if>
                        <xsl:apply-templates select="." />
                        <xsl:if test="not( self::br )">
                            <xsl:text>}</xsl:text>
                        </xsl:if>
                    </xsl:for-each>
                </xsl:otherwise>
            </xsl:choose>
        </common>
        <common formats="/html/xhtml/">
            <!-- We can't just call hyperlink-internal, because there may be an @target attribute. -->
            <a href="{$fullURL}">
                <xsl:if test="@target">
                    <xsl:attribute name="target">
                        <xsl:value-of select="@target" />
                    </xsl:attribute>
                </xsl:if>
                <xsl:choose>
                    <xsl:when test="not( node() )">
        				<code><xsl:value-of select="$fullURL" /></code>
                    </xsl:when>
                    <xsl:otherwise>
                        <xsl:apply-templates />
                    </xsl:otherwise>
                </xsl:choose>
            </a>
        </common>
    </template>
    
    
    <!--
        Special case: hyperlink with a label and content but no URL. These represent internal links within the document, and require different code in (Xe)LaTeX (need to use the full \hyperref macro instead of \href).
        
        @label:     The name of the label to link to (will become #label in (X)HTML). [required]
        @target:    The target of the URL (e.g., _blank). Only relevant to (X)HTML. [optional]
    -->
    <template name="hyperlink-label" match="hyperlink[@label and node() and not( @url )]">
        <!-- Note: not safe to use the url package here because \url{...} is fragile. -->
        <common formats="/latex/xelatex/">
            <xsl:for-each select="node()">
                <xsl:if test="not( self::br )">
                    <xsl:text>\hyperref[</xsl:text>
                    <xsl:value-of select="../@label" />
                    <xsl:text>]{</xsl:text>
                </xsl:if>
                <xsl:apply-templates select="." />
                <xsl:if test="not( self::br )">
                    <xsl:text>}</xsl:text>
                </xsl:if>
            </xsl:for-each>
        </common>
        <common formats="/html/xhtml/">
            <a href="#{@label}">
                <xsl:if test="@target">
                    <xsl:attribute name="target">
                        <xsl:value-of select="@target" />
                    </xsl:attribute>
                </xsl:if>
                <xsl:apply-templates />
            </a>
        </common>
    </template>
    
    
    <!-- ERROR: hyperlink has a label, but no URL and no content. -->
    <template name="empty-hyperlink-label" match="hyperlink[@label and not( node() ) and not( @url )]">
        <common>
            <xsl:message terminate="yes">&lt;hyperlink&gt; with @label and no @url must include link text.</xsl:message>
        </common>
    </template>
    
    
    <!-- Internal parameterised hyperlink templates to be called by the likes of the empty Oracle documentation elements. -->
    <template name="hyperlink-internal" match="hyperlink" mode="hyperlink-internal">
        <common>
            <xsl:param name="url" />
            <xsl:param name="label" />
        </common>
        <common formats="/latex/xelatex/">
            <xsl:text>\href{</xsl:text>
            <xsl:value-of select="$url" />
            <xsl:text>}{</xsl:text>
            <xsl:apply-templates select="exsl:node-set($label)" />
            <xsl:text>}</xsl:text>
        </common>
        <common formats="/html/xhtml/">
            <a href="{$url}"><xsl:apply-templates select="exsl:node-set($label)" /></a>
        </common>
    </template>

    <template name="empty-hyperlink-url-internal" match="hyperlink" mode="empty-hyperlink-internal">
        <common>
            <xsl:param name="url" />
        </common>
        <common formats="/latex/xelatex/">
            <xsl:text>\url{</xsl:text>
            <xsl:value-of select="$url" />
            <xsl:text>}</xsl:text>
        </common>
        <common formats="/html/xhtml/">
            <a href="{$url}"><code><xsl:value-of select="$url" /></code></a>
        </common>
    </template>
    
    
    <!-- A plain URL (i.e., not necessarily a hyperlink). -->
    <template name="url" match="url|uri|email|e-mail|email-address|e-mail-address">
        <!--
            \url in Hyperref will give us an active linke, so use \nolinkurl instead.
        -->
        <common formats="/latex/xelatex/">
            <xsl:text>\nolinkurl{</xsl:text>
            <xsl:apply-templates />
            <xsl:text>}</xsl:text>
        </common>
        <common formats="/html/xhtml/">
            <code><xsl:apply-templates /></code>
        </common>
    </template>


</stylesheet>
                     <!--
                         Sometimes the hyperlink content may be explicitly split across multiple lines, separated by <br> elements. This isn't a problem in (X)HTML, but it breaks (Xe)LaTeX, because you can't include a \\ inside most macros. The solution is to explicitly process the sub-elements, and wrap appropriate hyperref macros around them, /except/ for any embedded <br> elements. This does lead to some slightly
                         odd output when you embed markup in the hyperlink text; in particular, spaces won't be included in
                         the hyperlink.
-                        We can't just call hyperlink-internal, because we still want to process the <br> elements.
                     -->
                     <xsl:for-each select="node()">
                         <xsl:if test="not( self::br )">
                             <xsl:text>\href{</xsl:text>
                 </xsl:otherwise>
             </xsl:choose>
         </common>
         <common formats="/html/xhtml/">
-            <!-- We can't just call hyperlink-internal, because there may be an @target attribute. -->
             <a href="{$fullURL}">
                 <xsl:if test="@target">
                     <xsl:attribute name="target">
                         <xsl:value-of select="@target" />
         </common>
     </template>
-    <!-- Internal parameterised hyperlink templates to be called by the likes of the empty Oracle documentation elements. -->
-    <template name="hyperlink-internal" match="hyperlink" mode="hyperlink-internal">
-        <common>
-            <xsl:param name="url" />
-            <xsl:param name="label" />
-        </common>
-        <common formats="/latex/xelatex/">
-            <xsl:text>\href{</xsl:text>
-            <xsl:value-of select="$url" />
-            <xsl:text>}{</xsl:text>
-            <xsl:apply-templates select="exsl:node-set($label)" />
-            <xsl:text>}</xsl:text>
-        </common>
-        <common formats="/html/xhtml/">
-            <a href="{$url}"><xsl:apply-templates select="exsl:node-set($label)" /></a>
-        </common>
-    </template>
-    <template name="empty-hyperlink-url-internal" match="hyperlink" mode="empty-hyperlink-internal">
-        <common>
-            <xsl:param name="url" />
-        </common>
-        <common formats="/latex/xelatex/">
-            <xsl:text>\url{</xsl:text>
-            <xsl:value-of select="$url" />
-            <xsl:text>}</xsl:text>
-        </common>
-        <common formats="/html/xhtml/">
-            <a href="{$url}"><code><xsl:value-of select="$url" /></code></a>
-        </common>
-    </template>
     <!-- A plain URL (i.e., not necessarily a hyperlink). -->
     <template name="url" match="url|uri|email|e-mail|email-address|e-mail-address">
         <!--
             \url in Hyperref will give us an active linke, so use \nolinkurl instead.

                Ignore Space
               Show notes
              View
            
          
          236 ■■■■■
          oracle-docs.perl
 # Here's the raw data.
# Each entry has a name (marked up as XML), a unique, short, space-less code name for it, and the actual URL.
# It's probably sensible to have the full URL here, rather than prefixing the Oracle document root, because it's easier to copy the entire URL from the Web browser when updating.
@references =
%references =
(
	# Name(0)	Code(1)	URL(2)
	"Database Documentation Library									Docs			${oracle_documentation_root}",
	"Database Administrator<apostrophe />s Guide					Admin			${oracle_documentation_root}server.111/b28310/toc.htm",
	"Database 2 Day Developer<apostrophe />s Guide					AppDev2Day		${oracle_documentation_root}appdev.111/b28843/toc.htm",
	"Database Advanced Application Developer<apostrophe />s Guide	AppDevAdv		${oracle_documentation_root}appdev.111/b28424/toc.htm",
	"Object-Relational Developer<apostrophe />s Guide				AppDevOR		${oracle_documentation_root}appdev.111/b28371/toc.htm",
	"Database Concepts												Concepts		${oracle_documentation_root}server.111/b28318/toc.htm",
	"Database Data Warehousing Guide								DataWarehousing	${oracle_documentation_root}server.111/b28313/toc.htm",
	"Database Error Messages										Errors			${oracle_documentation_root}server.111/b28278/toc.htm",
	"Database SQL Language Reference								SQL				${oracle_documentation_root}server.111/b28286/toc.htm",
	"Database Java Developer<apostrophe />s Guide					Java			${oracle_documentation_root}java.111/b31225/toc.htm",
	"Database JDBC Developer<apostrophe />s Guide and Reference		JDBC			${oracle_documentation_root}java.111/b31224/toc.htm",
	"Database Master Glossary										Glossary		${oracle_documentation_root}mix.111/b14388/toc.htm",
	"Database Performance Tuning Guide								Tuning			${oracle_documentation_root}server.111/b28274/toc.htm",
	"Database PL/SQL Language Reference								PLSQL			${oracle_documentation_root}appdev.111/b28370/toc.htm",
	"Database PL/SQL Packages and Types Reference					PLSQLPkgTyp		${oracle_documentation_root}appdev.111/b28419/toc.htm",
	"Database Master Index											Index			${oracle_documentation_root}mix.111/b14387/toc.htm",
	"Database Reference												Reference		${oracle_documentation_root}server.111/b28320/toc.htm"
    Docs => { name => 'Database Documentation Library',
              url => $oracle_documentation_root },
    Admin => { name => 'Database Administrator<apostrophe />s Guide',
               url => $oracle_documentation_root . 'server.111/b28310/toc.htm' },
    AppDev2Day => { name => 'Database 2 Day Developer<apostrophe />s Guide',
                    url => $oracle_documentation_root . 'appdev.111/b28843/toc.htm' },
    AppDevAdv => { name => 'Database Advanced Application Developer<apostrophe />s Guide',
                   url => $oracle_documentation_root . 'appdev.111/b28424/toc.htm' },
    AppDevOR => { name => 'Object-Relational Developer<apostrophe />s Guide',
                  url => $oracle_documentation_root . 'appdev.111/b28371/toc.htm' },
    Concepts => { name => 'Database Concepts',
                  url => $oracle_documentation_root . 'server.111/b28318/toc.htm' },
    DataWarehousing => { name => 'Database Data Warehousing Guide',
                         url => $oracle_documentation_root . 'server.111/b28313/toc.htm' },
    Errors => { name => 'Database Error Messages',
                url => $oracle_documentation_root . 'server.111/b28278/toc.htm' },
    SQL => { name => 'Database SQL Language Reference',
             url => $oracle_documentation_root . 'server.111/b28286/toc.htm' },
    Java => { name => 'Database Java Developer<apostrophe />s Guide',
              url => $oracle_documentation_root . 'java.111/b31225/toc.htm' },
    JDBC => { name => 'Database JDBC Developer<apostrophe />s Guide and Reference',
              url => $oracle_documentation_root . 'java.111/b31224/toc.htm' },
    Glossary => { name => 'Database Master Glossary',
                  url => $oracle_documentation_root . 'mix.111/b14388/toc.htm' },
    Tuning => { name => 'Database Performance Tuning Guide',
                url => $oracle_documentation_root . 'server.111/b28274/toc.htm' },
    PLSQL => { name => 'Database PL/SQL Language Reference',
               url => $oracle_documentation_root . 'appdev.111/b28370/toc.htm' },
    PLSQLPkgTyp => { name => 'Database PL/SQL Packages and Types Reference',
                     url => $oracle_documentation_root . 'appdev.111/b28419/toc.htm' },
    Index => { name => 'Database Master Index',
               url => $oracle_documentation_root . 'mix.111/b14387/toc.htm' },
    Reference => { name => 'Database Reference',
                   url => $oracle_documentation_root . 'server.111/b28320/toc.htm' },
);
 
# Prefix to use in the generated template names:
$oracle_prefix = "Ora";
 
if ($#ARGV != 1)
{
	warn "usage: oracle-docs <section-code-regexp> (xml | xslt | xslt_html | xslt_latex | link | all)\n";
	exit;
    warn "usage: oracle-docs <section-code-regexp> (xml | xslt | xslt_html | xslt_latex | link | all)\n";
    exit;
}
 
$section_code = $ARGV[0];
$output_type = $ARGV[1];
 
if ($output_type eq "xslt") {
	print <<END_OF_HEADER
    print <<END_OF_HEADER
<?xml version="1.0"?>
<!-- Do not edit!  Automatically generated by oracle-docs.perl! -->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
 
;
}
 
# One-off hard-coded template for a link to the root of the documentation set, using the URL as the anchor text.
# This is used in several places in the INFO 212 course book and updating them is more of a pain than implementing this!
# This is used in several places in the course book and updating them is more of a pain than implementing this!
if ($output_type eq "xslt") {
	print <<END_OF_TEMPLATE
	<xsl:template name="OraDocsURL" match="OraDocsURL">
		<xsl:call-template name="empty-hyperlink-url-internal">
			<xsl:with-param name="url">${oracle_documentation_root}</xsl:with-param>
		</xsl:call-template>
	</xsl:template>
    print <<END_OF_TEMPLATE
    <xsl:template name="OraDocsURL" match="OraDocsURL">
        <xsl:variable name="OracleURL">
            <xsl:element name="hyperlink">
                <xsl:attribute name="url">
                    <xsl:text>${oracle_documentation_root}</xsl:text>
                </xsl:attribute>
            </xsl:element>
        </xsl:variable>
        <xsl:apply-templates select="\$OracleURL" />
    </xsl:template>
 
END_OF_TEMPLATE
;
#	print "<xsl:template name=\"OraDocsURL\" match=\"OraDocsURL\"><xsl:apply-templates><xsl:element name=\"hyperlink\"><xsl:attribute name=\"url\">" . $oracle_documentation_root . "</xsl:attribute></xsl:element></xsl:apply-templates></xsl:template>\n";
}
	
foreach $current_record (@references) {
	@fields = split(/[	]+/, $current_record);
	# Only print the entries for the matching section:
	if (@fields[1] =~ /$section_code/) {
		# Print the requested stuff:
		if ($output_type eq "link") {
			print generate_doc_netlink(@fields[0], @fields[2]) . "\n";
		} elsif ($output_type eq "xml") {
			print generate_xml(@fields[1]) . "\n";
		} elsif ($output_type eq "xslt") {
			print generate_xsl_metatemplate(@fields[0], @fields[1], @fields[2]) . "\n";
		} elsif ($output_type eq "xslt_html") {
			print generate_xsl_template_for_html(@fields[0], @fields[1], @fields[2]) . "\n";
		} elsif ($output_type eq "xslt_latex") {
			print generate_xsl_template_for_latex(@fields[0], @fields[1], @fields[2]) . "\n";
		} elsif ($output_type eq "all") {
			print generate_doc_netlink(@fields[0], @fields[2]) . "\n";
			print generate_xsl_metatemplate(@fields[0], @fields[1], @fields[2]) . "\n";
			print generate_xsl_template_for_html(@fields[0], @fields[1], @fields[2]) . "\n";
			print generate_xsl_template_for_latex(@fields[0], @fields[1], @fields[2]) . "\n";
		} else {
			warn "Sorry - I don't know anything about a \"$output_type\" format.\n";
			exit;
		}
	}
    
foreach $doccode (keys %references) {
    $docname = $references{$doccode}{'name'};
    $docurl = $references{$doccode}{'url'};
    if ($doccode =~ /$section_code/) {
        # Print the requested stuff:
        if ($output_type eq "xml") {
            print generate_xml($doccode) . "\n";
        } elsif ($output_type eq "xslt") {
            print generate_xsl_template($docname, $doccode, $docurl) . "\n";
        } elsif ($output_type eq "all") {
            print generate_xsl_template($docname, $doccode, $docurl) . "\n";
        } else {
            warn "Sorry - I don't know anything about a \"$output_type\" format.\n";
            exit;
        }
    }
}
 
if ($output_type eq "xslt") {
	print "</xsl:stylesheet>\n";
    print "</xsl:stylesheet>\n";
}
 
 
 
# what we really need to produce is a template that calls the hyperlink template when matched.  I think.
# Markup for a hyperlink (as defined in format-master.xml) looks like this:
# 
# 	<hyperlink url="http://wherever/">Some Web Site</hyperlink>
# 
# However, this will only match elements with a url attribute; we therefore need a new internal hyperlink that's parameterised.  Should be modal (but "call-templates" doesn't seem to like it when you give it a "mode" attribute).
# The derived xml2html.xsl and xml2latex.xsl files will need to call this hyperlink-internal template directly:
#
# 	<xsl:call-template name="hyperlink-internal" mode="hyperlink-internal">
#		<xsl:with-param name="url">http://wherever/</xsl:with-param>
#		<xsl:with-param name="label">Some Web Site</xsl:with-param>
#	</xsl:call-template>
 
# Generate an XSLT meta-template for generating either an HTML or a LaTeX producing template.
# Generate an XSLT template for generating a hyperlink to the specified Oracle document.
# Arguments: (<descriptive-label>, <entry-code>, <url>)
sub generate_xsl_metatemplate {
	return <<END_OF_TEMPLATE
	<xsl:template name="${oracle_prefix}${_[1]}" match="${oracle_prefix}${_[1]}">
		<xsl:call-template name="hyperlink-internal">
			<xsl:with-param name="url">${_[2]}</xsl:with-param>
			<xsl:with-param name="label">
				<xsl:call-template name="OracleServer" /> ${_[0]}
			</xsl:with-param>
		</xsl:call-template>
	</xsl:template>
sub generate_xsl_template {
    return <<END_OF_TEMPLATE
    <xsl:template name="${oracle_prefix}${_[1]}" match="${oracle_prefix}${_[1]}">
        <xsl:variable name="OracleURL">
            <xsl:element name="hyperlink">
                <xsl:attribute name="url">
                    <xsl:text>${_[2]}</xsl:text>
                </xsl:attribute>
                <xsl:call-template name="OracleServer" />
                <xsl:text> </xsl:text>
                ${_[0]}
            </xsl:element>
        </xsl:variable>
        <xsl:apply-templates select="\$OracleURL" />
    </xsl:template>
END_OF_TEMPLATE
;
	# Nope, wrong tree here:
	return "<xsl:template name=\"" . $oracle_prefix . $_[1] . "\" match=\"" . $oracle_prefix . $_[1] . "\">" . 
		"<latex>" . "\\href{" . $_[2] . "}" . "{" . "<xsl:call-template name=\"OracleServer\" />" . " " . $_[0] . "}" . "</latex>" . 
		"<html>" . "<a href=\"" . $_[2]. "\">" . "<xsl:call-template name=\"OracleServer\" />" . " " . $_[0] . "</a>" . "</html>" . 
		"</xsl:template>";
}
 
 
# Produce the actual XML markup to be used in authoring (just to provide a handy list of them all):
# Arguments: (<entry-code>)
sub generate_xml {
	return "<" . $oracle_prefix . $_[0]. " />";
    return "<" . $oracle_prefix . $_[0]. " />";
}
# Produce XML markup for a link to a section of the documentation (deprecated):
sub generate_doc_netlink {
	return "<netlink><label>" . $_[0] . "</label><target>" . $_[1] . "</target></netlink>";
}
 
# Generate an XSLT template for HTML output (deprecated):
sub generate_xsl_template_for_html {
		return "<xsl:template match=\"" . $_[0] . "\"><A><xsl:attribute name=\"HREF\">" . $_[1] . "</xsl:attribute>" . "<xsl:call-template name=\"OracleServer\" /> " . $_[2] . "</A></xsl:template>";
}
 
# Generate an XSLT template for LaTeX output (deprecated):
sub generate_xsl_template_for_latex {
	return "<xsl:template match=\"" . $_[0] . "\">\\href{" . $_[1] . "}{<xsl:call-template name=\"OracleServer\" /> " . $_[2] . "}</xsl:template>";
}
 

            #!/usr/bin/perl
#
# Basic script for generating XML markup for the major sections of the Oracle Documentation, and XSLT templates (and meta-templates, for both output formats) for transforming it.
# 
# To do:
#  * Maybe modify the script to work for any URL-based hyperlinks (e.g. <Blackboard/>, <OtagoUniversity/>).  This would mean ditching the automatic "Ora" prefix, but wouldn't require much else to implement.
#  * Generalise so that the LaTeX output is split to use a separate hyperlink for each word in the link label (to allow the links to be wrapped across lines).  HTML version doesn't need to be changed.
 

# I figure this is also a sensible place to store the root of the Oracle documentation on the department's Web server.
# Should this have a trailing slash (appropriate for standalone URL) or not (appropriate for a prefix for composite URLs)?
$oracle_documentation_root = "http://info-nts-12.otago.ac.nz/docs/oracle11gr1/";


# Here's the raw data.
# Each entry has a name (marked up as XML), a unique, short, space-less code name for it, and the actual URL.
# It's probably sensible to have the full URL here, rather than prefixing the Oracle document root, because it's easier to copy the entire URL from the Web browser when updating.
%references =
(
    Docs => { name => 'Database Documentation Library',
              url => $oracle_documentation_root },
    Admin => { name => 'Database Administrator<apostrophe />s Guide',
               url => $oracle_documentation_root . 'server.111/b28310/toc.htm' },
    AppDev2Day => { name => 'Database 2 Day Developer<apostrophe />s Guide',
                    url => $oracle_documentation_root . 'appdev.111/b28843/toc.htm' },
    AppDevAdv => { name => 'Database Advanced Application Developer<apostrophe />s Guide',
                   url => $oracle_documentation_root . 'appdev.111/b28424/toc.htm' },
    AppDevOR => { name => 'Object-Relational Developer<apostrophe />s Guide',
                  url => $oracle_documentation_root . 'appdev.111/b28371/toc.htm' },
    Concepts => { name => 'Database Concepts',
                  url => $oracle_documentation_root . 'server.111/b28318/toc.htm' },
    DataWarehousing => { name => 'Database Data Warehousing Guide',
                         url => $oracle_documentation_root . 'server.111/b28313/toc.htm' },
    Errors => { name => 'Database Error Messages',
                url => $oracle_documentation_root . 'server.111/b28278/toc.htm' },
    SQL => { name => 'Database SQL Language Reference',
             url => $oracle_documentation_root . 'server.111/b28286/toc.htm' },
    Java => { name => 'Database Java Developer<apostrophe />s Guide',
              url => $oracle_documentation_root . 'java.111/b31225/toc.htm' },
    JDBC => { name => 'Database JDBC Developer<apostrophe />s Guide and Reference',
              url => $oracle_documentation_root . 'java.111/b31224/toc.htm' },
    Glossary => { name => 'Database Master Glossary',
                  url => $oracle_documentation_root . 'mix.111/b14388/toc.htm' },
    Tuning => { name => 'Database Performance Tuning Guide',
                url => $oracle_documentation_root . 'server.111/b28274/toc.htm' },
    PLSQL => { name => 'Database PL/SQL Language Reference',
               url => $oracle_documentation_root . 'appdev.111/b28370/toc.htm' },
    PLSQLPkgTyp => { name => 'Database PL/SQL Packages and Types Reference',
                     url => $oracle_documentation_root . 'appdev.111/b28419/toc.htm' },
    Index => { name => 'Database Master Index',
               url => $oracle_documentation_root . 'mix.111/b14387/toc.htm' },
    Reference => { name => 'Database Reference',
                   url => $oracle_documentation_root . 'server.111/b28320/toc.htm' },
);

# Prefix to use in the generated template names:
$oracle_prefix = "Ora";

if ($#ARGV != 1)
{
    warn "usage: oracle-docs <section-code-regexp> (xml | xslt | xslt_html | xslt_latex | link | all)\n";
    exit;
}

$section_code = $ARGV[0];
$output_type = $ARGV[1];

if ($output_type eq "xslt") {
    print <<END_OF_HEADER
<?xml version="1.0"?>
<!-- Do not edit!  Automatically generated by oracle-docs.perl! -->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

END_OF_HEADER
;
}

# One-off hard-coded template for a link to the root of the documentation set, using the URL as the anchor text.
# This is used in several places in the course book and updating them is more of a pain than implementing this!
if ($output_type eq "xslt") {
    print <<END_OF_TEMPLATE
    <xsl:template name="OraDocsURL" match="OraDocsURL">
        <xsl:variable name="OracleURL">
            <xsl:element name="hyperlink">
                <xsl:attribute name="url">
                    <xsl:text>${oracle_documentation_root}</xsl:text>
                </xsl:attribute>
            </xsl:element>
        </xsl:variable>
        <xsl:apply-templates select="\$OracleURL" />
    </xsl:template>

END_OF_TEMPLATE
;
}
    
foreach $doccode (keys %references) {
    $docname = $references{$doccode}{'name'};
    $docurl = $references{$doccode}{'url'};
    if ($doccode =~ /$section_code/) {
        # Print the requested stuff:
        if ($output_type eq "xml") {
            print generate_xml($doccode) . "\n";
        } elsif ($output_type eq "xslt") {
            print generate_xsl_template($docname, $doccode, $docurl) . "\n";
        } elsif ($output_type eq "all") {
            print generate_xsl_template($docname, $doccode, $docurl) . "\n";
        } else {
            warn "Sorry - I don't know anything about a \"$output_type\" format.\n";
            exit;
        }
    }
}

if ($output_type eq "xslt") {
    print "</xsl:stylesheet>\n";
}



# Generate an XSLT template for generating a hyperlink to the specified Oracle document.
# Arguments: (<descriptive-label>, <entry-code>, <url>)
sub generate_xsl_template {
    return <<END_OF_TEMPLATE
    <xsl:template name="${oracle_prefix}${_[1]}" match="${oracle_prefix}${_[1]}">
        <xsl:variable name="OracleURL">
            <xsl:element name="hyperlink">
                <xsl:attribute name="url">
                    <xsl:text>${_[2]}</xsl:text>
                </xsl:attribute>
                <xsl:call-template name="OracleServer" />
                <xsl:text> </xsl:text>
                ${_[0]}
            </xsl:element>
        </xsl:variable>
        <xsl:apply-templates select="\$OracleURL" />
    </xsl:template>
END_OF_TEMPLATE
;
}


# Produce the actual XML markup to be used in authoring (just to provide a handy list of them all):
# Arguments: (<entry-code>)
sub generate_xml {
    return "<" . $oracle_prefix . $_[0]. " />";
}

            #!/usr/bin/perl
#
# Basic script for generating XML markup for the major sections of the Oracle Documentation, and XSLT templates (and meta-templates, for both output formats) for transforming it.
# 
# To do:
#  * Maybe modify the script to work for any URL-based hyperlinks (e.g. <Blackboard/>, <OtagoUniversity/>).  This would mean ditching the automatic "Ora" prefix, but wouldn't require much else to implement.
#  * Generalise so that the LaTeX output is split to use a separate hyperlink for each word in the link label (to allow the links to be wrapped across lines).  HTML version doesn't need to be changed.
 

# I figure this is also a sensible place to store the root of the Oracle documentation on the department's Web server.
# Should this have a trailing slash (appropriate for standalone URL) or not (appropriate for a prefix for composite URLs)?
$oracle_documentation_root = "http://info-nts-12.otago.ac.nz/docs/oracle11gr1/";


# Here's the raw data.
# Each entry has a name (marked up as XML), a unique, short, space-less code name for it, and the actual URL.
# It's probably sensible to have the full URL here, rather than prefixing the Oracle document root, because it's easier to copy the entire URL from the Web browser when updating.
@references =
(
	# Name(0)	Code(1)	URL(2)
	"Database Documentation Library									Docs			${oracle_documentation_root}",
	"Database Administrator<apostrophe />s Guide					Admin			${oracle_documentation_root}server.111/b28310/toc.htm",
	"Database 2 Day Developer<apostrophe />s Guide					AppDev2Day		${oracle_documentation_root}appdev.111/b28843/toc.htm",
	"Database Advanced Application Developer<apostrophe />s Guide	AppDevAdv		${oracle_documentation_root}appdev.111/b28424/toc.htm",
	"Object-Relational Developer<apostrophe />s Guide				AppDevOR		${oracle_documentation_root}appdev.111/b28371/toc.htm",
	"Database Concepts												Concepts		${oracle_documentation_root}server.111/b28318/toc.htm",
	"Database Data Warehousing Guide								DataWarehousing	${oracle_documentation_root}server.111/b28313/toc.htm",
	"Database Error Messages										Errors			${oracle_documentation_root}server.111/b28278/toc.htm",
	"Database SQL Language Reference								SQL				${oracle_documentation_root}server.111/b28286/toc.htm",
	"Database Java Developer<apostrophe />s Guide					Java			${oracle_documentation_root}java.111/b31225/toc.htm",
	"Database JDBC Developer<apostrophe />s Guide and Reference		JDBC			${oracle_documentation_root}java.111/b31224/toc.htm",
	"Database Master Glossary										Glossary		${oracle_documentation_root}mix.111/b14388/toc.htm",
	"Database Performance Tuning Guide								Tuning			${oracle_documentation_root}server.111/b28274/toc.htm",
	"Database PL/SQL Language Reference								PLSQL			${oracle_documentation_root}appdev.111/b28370/toc.htm",
	"Database PL/SQL Packages and Types Reference					PLSQLPkgTyp		${oracle_documentation_root}appdev.111/b28419/toc.htm",
	"Database Master Index											Index			${oracle_documentation_root}mix.111/b14387/toc.htm",
	"Database Reference												Reference		${oracle_documentation_root}server.111/b28320/toc.htm"
);

# Prefix to use in the generated template names:
$oracle_prefix = "Ora";

if ($#ARGV != 1)
{
	warn "usage: oracle-docs <section-code-regexp> (xml | xslt | xslt_html | xslt_latex | link | all)\n";
	exit;
}

$section_code = $ARGV[0];
$output_type = $ARGV[1];

if ($output_type eq "xslt") {
	print <<END_OF_HEADER
<?xml version="1.0"?>
<!-- Do not edit!  Automatically generated by oracle-docs.perl! -->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

END_OF_HEADER
;
}

# One-off hard-coded template for a link to the root of the documentation set, using the URL as the anchor text.
# This is used in several places in the INFO 212 course book and updating them is more of a pain than implementing this!
if ($output_type eq "xslt") {
	print <<END_OF_TEMPLATE
	<xsl:template name="OraDocsURL" match="OraDocsURL">
		<xsl:call-template name="empty-hyperlink-url-internal">
			<xsl:with-param name="url">${oracle_documentation_root}</xsl:with-param>
		</xsl:call-template>
	</xsl:template>

END_OF_TEMPLATE
;
#	print "<xsl:template name=\"OraDocsURL\" match=\"OraDocsURL\"><xsl:apply-templates><xsl:element name=\"hyperlink\"><xsl:attribute name=\"url\">" . $oracle_documentation_root . "</xsl:attribute></xsl:element></xsl:apply-templates></xsl:template>\n";
}
	
foreach $current_record (@references) {
	@fields = split(/[	]+/, $current_record);
	# Only print the entries for the matching section:
	if (@fields[1] =~ /$section_code/) {
		# Print the requested stuff:
		if ($output_type eq "link") {
			print generate_doc_netlink(@fields[0], @fields[2]) . "\n";
		} elsif ($output_type eq "xml") {
			print generate_xml(@fields[1]) . "\n";
		} elsif ($output_type eq "xslt") {
			print generate_xsl_metatemplate(@fields[0], @fields[1], @fields[2]) . "\n";
		} elsif ($output_type eq "xslt_html") {
			print generate_xsl_template_for_html(@fields[0], @fields[1], @fields[2]) . "\n";
		} elsif ($output_type eq "xslt_latex") {
			print generate_xsl_template_for_latex(@fields[0], @fields[1], @fields[2]) . "\n";
		} elsif ($output_type eq "all") {
			print generate_doc_netlink(@fields[0], @fields[2]) . "\n";
			print generate_xsl_metatemplate(@fields[0], @fields[1], @fields[2]) . "\n";
			print generate_xsl_template_for_html(@fields[0], @fields[1], @fields[2]) . "\n";
			print generate_xsl_template_for_latex(@fields[0], @fields[1], @fields[2]) . "\n";
		} else {
			warn "Sorry - I don't know anything about a \"$output_type\" format.\n";
			exit;
		}
	}
}

if ($output_type eq "xslt") {
	print "</xsl:stylesheet>\n";
}



# what we really need to produce is a template that calls the hyperlink template when matched.  I think.
# Markup for a hyperlink (as defined in format-master.xml) looks like this:
# 
# 	<hyperlink url="http://wherever/">Some Web Site</hyperlink>
# 
# However, this will only match elements with a url attribute; we therefore need a new internal hyperlink that's parameterised.  Should be modal (but "call-templates" doesn't seem to like it when you give it a "mode" attribute).
# The derived xml2html.xsl and xml2latex.xsl files will need to call this hyperlink-internal template directly:
#
# 	<xsl:call-template name="hyperlink-internal" mode="hyperlink-internal">
#		<xsl:with-param name="url">http://wherever/</xsl:with-param>
#		<xsl:with-param name="label">Some Web Site</xsl:with-param>
#	</xsl:call-template>

# Generate an XSLT meta-template for generating either an HTML or a LaTeX producing template.
# Arguments: (<descriptive-label>, <entry-code>, <url>)
sub generate_xsl_metatemplate {
	return <<END_OF_TEMPLATE
	<xsl:template name="${oracle_prefix}${_[1]}" match="${oracle_prefix}${_[1]}">
		<xsl:call-template name="hyperlink-internal">
			<xsl:with-param name="url">${_[2]}</xsl:with-param>
			<xsl:with-param name="label">
				<xsl:call-template name="OracleServer" /> ${_[0]}
			</xsl:with-param>
		</xsl:call-template>
	</xsl:template>
END_OF_TEMPLATE
;
	# Nope, wrong tree here:
	return "<xsl:template name=\"" . $oracle_prefix . $_[1] . "\" match=\"" . $oracle_prefix . $_[1] . "\">" . 
		"<latex>" . "\\href{" . $_[2] . "}" . "{" . "<xsl:call-template name=\"OracleServer\" />" . " " . $_[0] . "}" . "</latex>" . 
		"<html>" . "<a href=\"" . $_[2]. "\">" . "<xsl:call-template name=\"OracleServer\" />" . " " . $_[0] . "</a>" . "</html>" . 
		"</xsl:template>";
}


# Produce the actual XML markup to be used in authoring (just to provide a handy list of them all):
# Arguments: (<entry-code>)
sub generate_xml {
	return "<" . $oracle_prefix . $_[0]. " />";
}

# Produce XML markup for a link to a section of the documentation (deprecated):
sub generate_doc_netlink {
	return "<netlink><label>" . $_[0] . "</label><target>" . $_[1] . "</target></netlink>";
}

# Generate an XSLT template for HTML output (deprecated):
sub generate_xsl_template_for_html {
		return "<xsl:template match=\"" . $_[0] . "\"><A><xsl:attribute name=\"HREF\">" . $_[1] . "</xsl:attribute>" . "<xsl:call-template name=\"OracleServer\" /> " . $_[2] . "</A></xsl:template>";
}

# Generate an XSLT template for LaTeX output (deprecated):
sub generate_xsl_template_for_latex {
	return "<xsl:template match=\"" . $_[0] . "\">\\href{" . $_[1] . "}{<xsl:call-template name=\"OracleServer\" /> " . $_[2] . "}</xsl:template>";
}
 # Here's the raw data.
 # Each entry has a name (marked up as XML), a unique, short, space-less code name for it, and the actual URL.
 # It's probably sensible to have the full URL here, rather than prefixing the Oracle document root, because it's easier to copy the entire URL from the Web browser when updating.
+@references =
+%references =
 (
+	# Name(0)	Code(1)	URL(2)
+	"Database Documentation Library									Docs			${oracle_documentation_root}",
+	"Database Administrator<apostrophe />s Guide					Admin			${oracle_documentation_root}server.111/b28310/toc.htm",
+	"Database 2 Day Developer<apostrophe />s Guide					AppDev2Day		${oracle_documentation_root}appdev.111/b28843/toc.htm",
+	"Database Advanced Application Developer<apostrophe />s Guide	AppDevAdv		${oracle_documentation_root}appdev.111/b28424/toc.htm",
+	"Object-Relational Developer<apostrophe />s Guide				AppDevOR		${oracle_documentation_root}appdev.111/b28371/toc.htm",
+	"Database Concepts												Concepts		${oracle_documentation_root}server.111/b28318/toc.htm",
+	"Database Data Warehousing Guide								DataWarehousing	${oracle_documentation_root}server.111/b28313/toc.htm",
+	"Database Error Messages										Errors			${oracle_documentation_root}server.111/b28278/toc.htm",
+	"Database SQL Language Reference								SQL				${oracle_documentation_root}server.111/b28286/toc.htm",
+	"Database Java Developer<apostrophe />s Guide					Java			${oracle_documentation_root}java.111/b31225/toc.htm",
+	"Database JDBC Developer<apostrophe />s Guide and Reference		JDBC			${oracle_documentation_root}java.111/b31224/toc.htm",
+	"Database Master Glossary										Glossary		${oracle_documentation_root}mix.111/b14388/toc.htm",
+	"Database Performance Tuning Guide								Tuning			${oracle_documentation_root}server.111/b28274/toc.htm",
+	"Database PL/SQL Language Reference								PLSQL			${oracle_documentation_root}appdev.111/b28370/toc.htm",
+	"Database PL/SQL Packages and Types Reference					PLSQLPkgTyp		${oracle_documentation_root}appdev.111/b28419/toc.htm",
+	"Database Master Index											Index			${oracle_documentation_root}mix.111/b14387/toc.htm",
+	"Database Reference												Reference		${oracle_documentation_root}server.111/b28320/toc.htm"
+    Docs => { name => 'Database Documentation Library',
+              url => $oracle_documentation_root },
+    Admin => { name => 'Database Administrator<apostrophe />s Guide',
+               url => $oracle_documentation_root . 'server.111/b28310/toc.htm' },
+    AppDev2Day => { name => 'Database 2 Day Developer<apostrophe />s Guide',
+                    url => $oracle_documentation_root . 'appdev.111/b28843/toc.htm' },
+    AppDevAdv => { name => 'Database Advanced Application Developer<apostrophe />s Guide',
+                   url => $oracle_documentation_root . 'appdev.111/b28424/toc.htm' },
+    AppDevOR => { name => 'Object-Relational Developer<apostrophe />s Guide',
+                  url => $oracle_documentation_root . 'appdev.111/b28371/toc.htm' },
+    Concepts => { name => 'Database Concepts',
+                  url => $oracle_documentation_root . 'server.111/b28318/toc.htm' },
+    DataWarehousing => { name => 'Database Data Warehousing Guide',
+                         url => $oracle_documentation_root . 'server.111/b28313/toc.htm' },
+    Errors => { name => 'Database Error Messages',
+                url => $oracle_documentation_root . 'server.111/b28278/toc.htm' },
+    SQL => { name => 'Database SQL Language Reference',
+             url => $oracle_documentation_root . 'server.111/b28286/toc.htm' },
+    Java => { name => 'Database Java Developer<apostrophe />s Guide',
+              url => $oracle_documentation_root . 'java.111/b31225/toc.htm' },
+    JDBC => { name => 'Database JDBC Developer<apostrophe />s Guide and Reference',
+              url => $oracle_documentation_root . 'java.111/b31224/toc.htm' },
+    Glossary => { name => 'Database Master Glossary',
+                  url => $oracle_documentation_root . 'mix.111/b14388/toc.htm' },
+    Tuning => { name => 'Database Performance Tuning Guide',
+                url => $oracle_documentation_root . 'server.111/b28274/toc.htm' },
+    PLSQL => { name => 'Database PL/SQL Language Reference',
+               url => $oracle_documentation_root . 'appdev.111/b28370/toc.htm' },
+    PLSQLPkgTyp => { name => 'Database PL/SQL Packages and Types Reference',
+                     url => $oracle_documentation_root . 'appdev.111/b28419/toc.htm' },
+    Index => { name => 'Database Master Index',
+               url => $oracle_documentation_root . 'mix.111/b14387/toc.htm' },
+    Reference => { name => 'Database Reference',
+                   url => $oracle_documentation_root . 'server.111/b28320/toc.htm' },
 );
 # Prefix to use in the generated template names:
 $oracle_prefix = "Ora";
 if ($#ARGV != 1)
 {
+	warn "usage: oracle-docs <section-code-regexp> (xml | xslt | xslt_html | xslt_latex | link | all)\n";
+	exit;
+    warn "usage: oracle-docs <section-code-regexp> (xml | xslt | xslt_html | xslt_latex | link | all)\n";
+    exit;
 }
 $section_code = $ARGV[0];
 $output_type = $ARGV[1];
 if ($output_type eq "xslt") {
+	print <<END_OF_HEADER
+    print <<END_OF_HEADER
 <?xml version="1.0"?>
 <!-- Do not edit!  Automatically generated by oracle-docs.perl! -->
 <xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
 ;
 }
 # One-off hard-coded template for a link to the root of the documentation set, using the URL as the anchor text.
+# This is used in several places in the INFO 212 course book and updating them is more of a pain than implementing this!
+# This is used in several places in the course book and updating them is more of a pain than implementing this!
 if ($output_type eq "xslt") {
+	print <<END_OF_TEMPLATE
+	<xsl:template name="OraDocsURL" match="OraDocsURL">
+		<xsl:call-template name="empty-hyperlink-url-internal">
+			<xsl:with-param name="url">${oracle_documentation_root}</xsl:with-param>
+		</xsl:call-template>
+	</xsl:template>
+    print <<END_OF_TEMPLATE
+    <xsl:template name="OraDocsURL" match="OraDocsURL">
+        <xsl:variable name="OracleURL">
+            <xsl:element name="hyperlink">
+                <xsl:attribute name="url">
+                    <xsl:text>${oracle_documentation_root}</xsl:text>
+                </xsl:attribute>
+            </xsl:element>
+        </xsl:variable>
+        <xsl:apply-templates select="\$OracleURL" />
+    </xsl:template>
 END_OF_TEMPLATE
 ;
-#	print "<xsl:template name=\"OraDocsURL\" match=\"OraDocsURL\"><xsl:apply-templates><xsl:element name=\"hyperlink\"><xsl:attribute name=\"url\">" . $oracle_documentation_root . "</xsl:attribute></xsl:element></xsl:apply-templates></xsl:template>\n";
 }
+foreach $current_record (@references) {
+	@fields = split(/[	]+/, $current_record);
+	# Only print the entries for the matching section:
+	if (@fields[1] =~ /$section_code/) {
+		# Print the requested stuff:
+		if ($output_type eq "link") {
+			print generate_doc_netlink(@fields[0], @fields[2]) . "\n";
+		} elsif ($output_type eq "xml") {
+			print generate_xml(@fields[1]) . "\n";
+		} elsif ($output_type eq "xslt") {
+			print generate_xsl_metatemplate(@fields[0], @fields[1], @fields[2]) . "\n";
+		} elsif ($output_type eq "xslt_html") {
+			print generate_xsl_template_for_html(@fields[0], @fields[1], @fields[2]) . "\n";
+		} elsif ($output_type eq "xslt_latex") {
+			print generate_xsl_template_for_latex(@fields[0], @fields[1], @fields[2]) . "\n";
+		} elsif ($output_type eq "all") {
+			print generate_doc_netlink(@fields[0], @fields[2]) . "\n";
+			print generate_xsl_metatemplate(@fields[0], @fields[1], @fields[2]) . "\n";
+			print generate_xsl_template_for_html(@fields[0], @fields[1], @fields[2]) . "\n";
+			print generate_xsl_template_for_latex(@fields[0], @fields[1], @fields[2]) . "\n";
+		} else {
+			warn "Sorry - I don't know anything about a \"$output_type\" format.\n";
+			exit;
+		}
+	}
+foreach $doccode (keys %references) {
+    $docname = $references{$doccode}{'name'};
+    $docurl = $references{$doccode}{'url'};
+    if ($doccode =~ /$section_code/) {
+        # Print the requested stuff:
+        if ($output_type eq "xml") {
+            print generate_xml($doccode) . "\n";
+        } elsif ($output_type eq "xslt") {
+            print generate_xsl_template($docname, $doccode, $docurl) . "\n";
+        } elsif ($output_type eq "all") {
+            print generate_xsl_template($docname, $doccode, $docurl) . "\n";
+        } else {
+            warn "Sorry - I don't know anything about a \"$output_type\" format.\n";
+            exit;
+        }
+    }
 }
 if ($output_type eq "xslt") {
+	print "</xsl:stylesheet>\n";
+    print "</xsl:stylesheet>\n";
 }
+# what we really need to produce is a template that calls the hyperlink template when matched.  I think.
+# Markup for a hyperlink (as defined in format-master.xml) looks like this:
+#
+# 	<hyperlink url="http://wherever/">Some Web Site</hyperlink>
+#
+# However, this will only match elements with a url attribute; we therefore need a new internal hyperlink that's parameterised.  Should be modal (but "call-templates" doesn't seem to like it when you give it a "mode" attribute).
+# The derived xml2html.xsl and xml2latex.xsl files will need to call this hyperlink-internal template directly:
+#
+# 	<xsl:call-template name="hyperlink-internal" mode="hyperlink-internal">
+#		<xsl:with-param name="url">http://wherever/</xsl:with-param>
+#		<xsl:with-param name="label">Some Web Site</xsl:with-param>
+#	</xsl:call-template>
+# Generate an XSLT meta-template for generating either an HTML or a LaTeX producing template.
+# Generate an XSLT template for generating a hyperlink to the specified Oracle document.
 # Arguments: (<descriptive-label>, <entry-code>, <url>)
+sub generate_xsl_metatemplate {
+	return <<END_OF_TEMPLATE
+	<xsl:template name="${oracle_prefix}${_[1]}" match="${oracle_prefix}${_[1]}">
+		<xsl:call-template name="hyperlink-internal">
+			<xsl:with-param name="url">${_[2]}</xsl:with-param>
+			<xsl:with-param name="label">
+				<xsl:call-template name="OracleServer" /> ${_[0]}
+			</xsl:with-param>
+		</xsl:call-template>
+	</xsl:template>
+sub generate_xsl_template {
+    return <<END_OF_TEMPLATE
+    <xsl:template name="${oracle_prefix}${_[1]}" match="${oracle_prefix}${_[1]}">
+        <xsl:variable name="OracleURL">
+            <xsl:element name="hyperlink">
+                <xsl:attribute name="url">
+                    <xsl:text>${_[2]}</xsl:text>
+                </xsl:attribute>
+                <xsl:call-template name="OracleServer" />
+                <xsl:text> </xsl:text>
+                ${_[0]}
+            </xsl:element>
+        </xsl:variable>
+        <xsl:apply-templates select="\$OracleURL" />
+    </xsl:template>
 END_OF_TEMPLATE
 ;
-	# Nope, wrong tree here:
-	return "<xsl:template name=\"" . $oracle_prefix . $_[1] . "\" match=\"" . $oracle_prefix . $_[1] . "\">" .
-		"<latex>" . "\\href{" . $_[2] . "}" . "{" . "<xsl:call-template name=\"OracleServer\" />" . " " . $_[0] . "}" . "</latex>" .
-		"<html>" . "<a href=\"" . $_[2]. "\">" . "<xsl:call-template name=\"OracleServer\" />" . " " . $_[0] . "</a>" . "</html>" .
-		"</xsl:template>";
 }
 # Produce the actual XML markup to be used in authoring (just to provide a handy list of them all):
 # Arguments: (<entry-code>)
 sub generate_xml {
+	return "<" . $oracle_prefix . $_[0]. " />";
+    return "<" . $oracle_prefix . $_[0]. " />";
 }
-# Produce XML markup for a link to a section of the documentation (deprecated):
-sub generate_doc_netlink {
-	return "<netlink><label>" . $_[0] . "</label><target>" . $_[1] . "</target></netlink>";
-}
-# Generate an XSLT template for HTML output (deprecated):
-sub generate_xsl_template_for_html {
-		return "<xsl:template match=\"" . $_[0] . "\"><A><xsl:attribute name=\"HREF\">" . $_[1] . "</xsl:attribute>" . "<xsl:call-template name=\"OracleServer\" /> " . $_[2] . "</A></xsl:template>";
-}
-# Generate an XSLT template for LaTeX output (deprecated):
-sub generate_xsl_template_for_latex {
-	return "<xsl:template match=\"" . $_[0] . "\">\\href{" . $_[1] . "}{<xsl:call-template name=\"OracleServer\" /> " . $_[2] . "}</xsl:template>";
-}

                Ignore Space
               Show notes
              View
            
          
          3 ■■■■■
          xml2xslt.xsl
-            <?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet	version="2.0"
				xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
				xmlns:xsl-out="[irrelevant]"
				xmlns:exsl="http://exslt.org/common"
				xmlns:xs="http://www.w3.org/2001/XMLSchema"
				xmlns:infosci="http://info-nts-12.otago.ac.nz/infosci">
 
	<!--
	
 
	<xsl:template match="/">
		
		<xsl-out:stylesheet version="2.0" exclude-result-prefixes="exsl">
		<xsl-out:stylesheet version="2.0">
		
		<xsl-out:strip-space elements="*" />
 
		<xsl-out:param name="subject-code"><xsl:text>INFO</xsl:text></xsl-out:param>

            <?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet	version="2.0"
				xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
				xmlns:xsl-out="[irrelevant]"
				xmlns:xs="http://www.w3.org/2001/XMLSchema"
				xmlns:infosci="http://info-nts-12.otago.ac.nz/infosci">

	<!--
		XSLT transformation for a master XML document defining how to transform elements in the course handbook source into HTML and LaTeX.  Hmm, meta-stylesheet?!
	-->
	
	<!--	<xsl:output method="text" encoding="utf-8" media-type="text/xml" /> -->
	<xsl:output method="xml" encoding="utf-8" cdata-section-elements="html" />

	<!--
		What target format are we generating a styesheet for?
		Possible values: html, xhtml, latex (includes pdflatex), xelatex.
	-->
	<xsl:param name="target-format"><xsl:text>html</xsl:text></xsl:param>

	<!--
		Define an alias for the xsl namespace to avoid confusion when generating xsl: elements in the output of this stylesheet.
	-->
	<xsl:namespace-alias stylesheet-prefix="xsl-out" result-prefix="xsl" />

	<!--
		Some useful variables. (Could some of these become callable templates?)
	-->
	<xsl:variable name="newline">
<xsl:text>
</xsl:text>
	</xsl:variable>

	<xsl:variable name="space"><xsl:text> </xsl:text></xsl:variable>
	

	<xsl:template match="/">
		
		<xsl-out:stylesheet version="2.0">
		
		<xsl-out:strip-space elements="*" />

		<xsl-out:param name="subject-code"><xsl:text>INFO</xsl:text></xsl-out:param>
		<xsl-out:param name="paper-number" />
		<xsl-out:param name="paper-year"		select="year-from-date( current-date() )"/>
		<xsl-out:param name="period-code" />
		
		<xsl-out:param name="showanswers"><xsl:text>no</xsl:text></xsl-out:param>
		
		<xsl-out:param name="base-path"><xsl:text>.</xsl:text></xsl-out:param>
		
		<!-- Full period string corresponding to the supplied period code. -->
		<xsl-out:variable name="period-string" select="infosci:expand-period-code( $period-code )" />
<!-- 
			<xsl-out:choose>
				<xsl-out:when test="$period-code = 'SS'">
					<xsl-out:text>Summer School</xsl-out:text>
				</xsl-out:when>
				<xsl-out:when test="$period-code = 'S1'">
					<xsl-out:text>Semester One</xsl-out:text>
				</xsl-out:when>
				<xsl-out:when test="$period-code = 'S2'">
					<xsl-out:text>Semester Two</xsl-out:text>
				</xsl-out:when>
				<xsl-out:when test="$period-code = 'FY'">
					<xsl-out:text>Full Year</xsl-out:text>
				</xsl-out:when>
				<xsl-out:otherwise>
					<xsl-out:message terminate="yes">
						<xsl-out:text>Unrecognised period code "</xsl-out:text>
						<xsl-out:value-of select="$period-code" />
						<xsl-out:text>".</xsl-out:text>
					</xsl-out:message>
				</xsl-out:otherwise>
			</xsl-out:choose>
		</xsl-out:variable>
 -->
		
		<!-- The date and time when the document was last built. -->
		<xsl-out:variable name="date-built"		select="current-dateTime()" />
		
		<!-- Get the name of the document being processed. -->
		<xsl-out:variable name="document-name"	select="reverse( tokenize( base-uri(), '/' ) )[1]" />

		<!-- Include the generated Oracle documentation code. -->
		<xsl-out:include href="oracle-docs.xsl" />

		<!-- Include the generated teaching calendar dates. -->
<!-- 
		<xsl-out:include href="calendar_dates.xsl" />
 -->

		<!--
			We're going to use the text encoding in a few different places, so let's work out what it should be now.
		-->
		<xsl:variable name="text-encoding">
			<xsl:choose>
			
				<xsl:when test="($target-format = 'latex') or ($target-format = 'html')">
					<xsl:text>iso-8859-1</xsl:text>
				</xsl:when>
				
				<xsl:when test="($target-format = 'xelatex') or ($target-format = 'xhtml')">
					<xsl:text>utf-8</xsl:text>
				</xsl:when>
				
				<xsl:otherwise>
					<xsl:message terminate="yes">
						<xsl:text>Sorry, unknown target format: </xsl:text><xsl:value-of select="$target-format" />
					</xsl:message>
				</xsl:otherwise>
			
			</xsl:choose>
		</xsl:variable>

		<!-- root-level documents should say what type/class of document they are (lecture, tutorial, generic, ...).  Do we want to call this a class or a type? -->
		<!--
		<xsl:variable name="doctype"><xsl:value-of select="/document/@type" /></xsl:variable>
		-->
		
		<!--
			First, output the document preamble according to target format. This is generally different for each target format.
		-->
		<xsl:choose>
			
			<!--
				The HTML formats are fairly simple: the only things that change are the doctypes, version number and text encoding.
			-->
			<xsl:when test="$target-format = 'html'">
			
				<xsl-out:output
					method="html"
					encoding="{$text-encoding}"
					version="4.01"
					media-type="text/html"
					doctype-public="-//W3C//DTD HTML 4.01 Transitional//EN"
					doctype-system="http://www.w3.org/TR/html4/loose.dtd"
				/>
				
			</xsl:when>
			
			<xsl:when test="$target-format = 'xhtml'">
			
				<xsl-out:output
					method="xml"
					encoding="{$text-encoding}"
					byte-order-mark="no"
					version="1.1"
					media-type="text/html"
					doctype-public="-//W3C//DTD XHTML 1.1//EN"
					doctype-system="http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"
				/>
				
			</xsl:when>
			
			<!--
				The LaTeX formats, however have a bunch of miscellaneous boilerplate that appears at the start of every document, and requires more complex interleaving because of hyperref. Since we need to stuff this into a template later on, we define this using a callable template, so that we can do useful things like apply-templates within it (which wouldn't work if we just used a variable).
			-->
			<xsl:when test="$target-format = 'latex'">
			
				<xsl-out:output method="text" encoding="{$text-encoding}" media-type="text/plain" />	

				<!--
					Set to no if you want this to be included inside another
					document. Appears here because it's used in the document
					preamble.
				-->
				<xsl-out:param name="standalone"><xsl:text>yes</xsl:text></xsl-out:param>
				
				<xsl-out:template name="latex-preamble">
					<xsl-out:text>
\usepackage{mathpazo} % mathpple is deprecated
\usepackage[T1]{fontenc}
\usepackage{textcomp}
</xsl-out:text>

					<xsl-out:apply-templates select="environment/latex-packages" />

					<xsl-out:text>
% Safer to specify the hyperref options directly rather than relying on
% the default hyperref.cfg, as XeLaTeX seems to ignore it :(.
\usepackage[	pdfpagemode=UseNone,%
				colorlinks,%
				urlcolor=blue,%
				citecolor=blue,%
				linkcolor=blue,%
				breaklinks	]{hyperref}

\renewcommand{\ttdefault}{blg}
</xsl-out:text>
				</xsl-out:template>
				
			</xsl:when>
			
			<xsl:when test="$target-format = 'xelatex'">
			
				<xsl-out:output method="text" encoding="{$text-encoding}" media-type="text/plain" />	

				<!--
					Set to no if you want this to be included inside another
					document. Appears here because it's used in the document
					preamble.
				-->
				<xsl-out:param name="standalone"><xsl:text>yes</xsl:text></xsl-out:param>
				
				<xsl-out:template name="latex-preamble">
					<xsl-out:text>
\usepackage[no-math]{fontspec}
\usepackage{mathspec}
\usepackage{xunicode}
\usepackage{xltxtra}
\usepackage{textcomp} % ???
</xsl-out:text>

					<xsl-out:apply-templates select="environment/latex-packages" />
					
					<xsl-out:text>
% Safer to specify the hyperref options directly rather than relying on
% the default hyperref.cfg, as XeLaTeX seems to ignore it :(.
\usepackage[	pdfpagemode=UseNone,%
				colorlinks,%
				urlcolor=blue,%
				citecolor=blue,%
				linkcolor=blue,%
				breaklinks	]{hyperref}

\defaultfontfeatures{Mapping=tex-text}
\setmainfont{TeX Gyre Pagella}
\setmathsfont(Digits){TeX Gyre Pagella}
\setmonofont[Scale=MatchLowercase]{Letter Gothic 12 Pitch}
</xsl-out:text>
				</xsl-out:template>
				
			</xsl:when>
			
			<!--
				No need for an otherwise, as weird target formats will have already been trapped by the definition of the text-encoding variable above.
			-->
			
		</xsl:choose>
		
		<!--
			Next, output the main document body according to target format. This is generally the same across similar target formats.
		-->
		<xsl:choose>

			<xsl:when test="($target-format = 'html') or ($target-format = 'xhtml')">
			
				<!-- *** (X)HTML Output *** -->
				
				<!-- Old version: before using xsl:namespace-alias: -->
				<!--
				<xsl-out:element name="xsl:output">
					<xsl-out:attribute name="method">html</xsl-out:attribute>
					<xsl-out:attribute name="encoding">UTF-8</xsl-out:attribute>
					<xsl-out:attribute name="media-type">text/html</xsl-out:attribute>
					<xsl-out:attribute name="doctype-public">-//W3C//DTD HTML 4.01 Transitional//EN</xsl-out:attribute>
				</xsl-out:element>
				-->
				
				<!-- Default to PNG images for web dispay. -->
				<xsl-out:param name="image-format"><xsl:text>png</xsl:text></xsl-out:param>

			<!-- Nope, includes can only appear as a child of xsl:stylesheet. -->
			<!-- <xsl-out:include href="xml2html-root.xsl" /> -->
				
				<xsl-out:template match="/document">
					<xsl-out:comment> THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT! </xsl-out:comment>
					<html>
						<head>
							<xsl-out:element name="link">
								<xsl-out:attribute name="rel">
									<xsl-out:text>Stylesheet</xsl-out:text>
								</xsl-out:attribute>
								<xsl-out:attribute name="href">
									<xsl-out:text>https://blackboard.otago.ac.nz/bbcswebdav/courses/</xsl-out:text>
									<xsl-out:value-of select="$subject-code" />
									<xsl-out:value-of select="$paper-number" />
									<xsl-out:text>_</xsl-out:text>
									<xsl-out:value-of select="$period-code" />
									<xsl-out:text>DNI_</xsl-out:text>
									<xsl-out:value-of select="$paper-year" />
									<xsl-out:text>/db_styles.css</xsl-out:text>
								</xsl-out:attribute>
								<xsl-out:attribute name="type">
									<xsl-out:text>text/css</xsl-out:text>
								</xsl-out:attribute>
							</xsl-out:element>
							<xsl-out:element name="meta">
								<xsl-out:attribute name="http-equiv">
									<xsl-out:text>Content-type</xsl-out:text>
								</xsl-out:attribute>
								<xsl-out:attribute name="content">
									<xsl-out:text>
										<xsl:text>text/html;charset=</xsl:text>
										<xsl:value-of select="$text-encoding" />
									</xsl-out:text>
								</xsl-out:attribute>
							</xsl-out:element>
							<title>
								<xsl-out:choose>
									<xsl-out:when test="@class = 'calendar'">
										<xsl-out:value-of select="$subject-code" />
										<xsl-out:value-of select="$paper-number" />
										<xsl-out:text> Teaching Calendar, </xsl-out:text>
										<xsl-out:value-of select="$period-string" />
										<xsl-out:text>, </xsl-out:text>
										<xsl-out:value-of select="$paper-year" />
									</xsl-out:when>
									<xsl-out:otherwise>
										<xsl-out:apply-templates select="title" mode="preamble" />
									</xsl-out:otherwise>
								</xsl-out:choose>
							</title>
						</head>
						<body>
							<xsl-out:choose>
								<xsl-out:when test="@class = 'calendar'" />
								<xsl-out:otherwise>
									<xsl-out:apply-templates select="title" mode="title" />
									<xsl-out:apply-templates select="date" mode="title" />
									<xsl-out:apply-templates select="due-date" mode="title" />
								</xsl-out:otherwise>
							</xsl-out:choose>
							<xsl-out:apply-templates />

							<!-- How best to approach this - certain elements that need special handling (e.g. title, author) shouldn't be passed through here as well. -->
							<!-- How about we just match certain elements that we know can be handled safely, e.g. sections, paragraphs, ...?  (...and their aliases?) -->
							<!-- Are introductions just another section, or should there be an introduction element? -->
							
							<!-- The solution is to get cleverer with our templates, e.g., multiple templates for <title> that have different match patterns (document/title, section/title). -->
							<!-- We also need to define an empty template for the <document-metadata> element so that its contents get ignored. -->
							<!-- Once these are done, we can just go apply-templates and forget about it. -->
							
							<hr />
							<!--
								Since HTML doesn't support footnotes as such, we
								instead include them as endnotes at the end of
								the document.
							-->
							<xsl-out:if test="count(//footnote) &gt; 0">
								<h3>Notes</h3>
								<xsl-out:apply-templates select="//footnote" mode="list" />
								<hr />
							</xsl-out:if>
							<xsl-out:call-template name="build-date-internal">
								<xsl-out:with-param name="format">long</xsl-out:with-param>
								<xsl-out:with-param name="style">footer</xsl-out:with-param>
							</xsl-out:call-template>
						</body>
					</html>
				</xsl-out:template>
			</xsl:when>

			<xsl:when test="($target-format = 'latex') or ($target-format = 'xelatex')">
			
				<!-- Set to pdf if using PDFLaTeX, otherwise eps. -->
				<xsl-out:param name="image-format"><xsl:text>pdf</xsl:text></xsl-out:param>
				
				<!--
				    Generate macro to encode the document class name.
				    This is currently BROKEN. If the document class specified loads packages that are then loaded by the boilerplate below with different optons, it will cause LaTeX "option clash" errors. Therefore, DO NOT use the @latex-document-class attribute for now until a solution can be devised!
				-->
				<xsl-out:template name="setup-document-class">
					<xsl-out:text>
\def\DocumentClass{</xsl-out:text>
                    <xsl-out:value-of select="@latex-document-class" />
                    <xsl-out:if test="not( @latex-document-class )">
                        <xsl-out:text>article</xsl-out:text>
                    </xsl-out:if>
				    <xsl-out:text>}
</xsl-out:text>
				</xsl-out:template>

				<!-- *** LaTeX Source Output *** -->
				<!-- Should this produce a LaTeX source fragment or an entire valid source document? -->
				<xsl-out:template match="/document">
					<xsl-out:choose>

						<xsl-out:when test="$standalone = 'yes'">
							<xsl-out:text>
% THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT!

</xsl-out:text>
							<xsl-out:call-template name="setup-document-class" />
							<xsl-out:text>
\PassOptionsToClass{\LaTeXOptions}{\DocumentClass}
\documentclass{\DocumentClass}

\usepackage[margin=1in]{geometry}
\usepackage{multirow}
\usepackage{graphicx}
\usepackage{verbatim}       % needed for \verbatiminput
\usepackage{relalg}         % needed for join operators
\usepackage{pifont}
\usepackage{siunitx}        % number and SI unit formatting
\usepackage{listings}       % nicely formatted code listings
\usepackage[normalem]{ulem} % fancy underlining, strikeout, etc.
\usepackage{boxedminipage}
\usepackage{parskip}        % Space-separated rather than indented paragraphs.
\usepackage{rotating}		% Rotate stuff.

</xsl-out:text>

							<xsl-out:call-template name="latex-preamble" />

							<xsl-out:apply-templates select="environment/latex-commands" />

							<xsl-out:text>
\newenvironment{answer}{\par\vspace{0.5em}\itshape}{\normalfont\vspace{1.5em}}

% Listings setup. We preload the most obviously like languages to speed things
% up. Other languages will still work, just not quite as quickly.
\lstloadlanguages{Oracle}
\lstset{basicstyle=\ttfamily,basewidth=0.5em,escapeinside={(@}{@)},
	showspaces=false,showstringspaces=false}

% Environment for worksheet exercises.
\newcounter{exercise}
\setcounter{exercise}{0}
\newenvironment{exercise}%
	{\noindent\refstepcounter{exercise}\begin{boxedminipage}{\columnwidth}\textbf{Exercise \theexercise: }}%
	{\end{boxedminipage}}

</xsl-out:text>

							<xsl-out:apply-templates select="title" mode="preamble" />
							<xsl-out:call-template name="newline-internal" />
							<xsl-out:apply-templates select="author" mode="preamble" />
							<xsl-out:call-template name="newline-internal" />
							<xsl-out:apply-templates select="date|due-date" mode="preamble" />
							<xsl-out:call-template name="newline-internal" />

							<xsl-out:text>
\begin{document}
</xsl-out:text>
                            <xsl-out:if test="not( @suppress-latex-title ) or ( @suppress-latex-title != 'yes' )">
                                <xsl-out:text>
	\maketitle
</xsl-out:text>
                            </xsl-out:if>
							<xsl-out:text>

</xsl-out:text>

							<xsl-out:apply-templates />

							<!--
								If you're having problems with the build date appearing in weird or annoying locations (usually because of floating items like tables and figures), set document/@auto-latex-build-date to "no". You can then use the build-date element to insert the build date wherever you like, if necessary. This really only applies to LaTeX documents. The behaviour of HTML documents is much more predictable because they don't have elements with "minds of their own", so the build date is guaranteed to always appear at the very end.
							-->
							<xsl-out:if test="not( @auto-latex-build-date ) or ( @auto-latex-build-date != 'no' )">
							
								<xsl-out:call-template name="build-date-internal">
									<xsl-out:with-param name="format">long</xsl-out:with-param>
									<xsl-out:with-param name="style">footer</xsl-out:with-param>
								</xsl-out:call-template>
							</xsl-out:if>
							<xsl-out:text>\end{document}</xsl-out:text>
						</xsl-out:when>
						<!-- Not standalone: -->
						<xsl-out:otherwise>
							<xsl-out:apply-templates select="title" mode="chapter" />
							<xsl-out:apply-templates select="*[not(self::title)]" />
							<xsl-out:if test="not( @auto-latex-build-date ) or ( @auto-latex-build-date != 'no' )">
								<xsl-out:call-template name="build-date-internal">
									<xsl-out:with-param name="format">long</xsl-out:with-param>
									<xsl-out:with-param name="style">footer</xsl-out:with-param>
								</xsl-out:call-template>
							</xsl-out:if>
						</xsl-out:otherwise>
					</xsl-out:choose>
				</xsl-out:template>
				
			</xsl:when>
			
			<!--
				No need for an otherwise, as weird formats will have already been trapped by the definition of the text-encoding variable above.
			-->
			
		</xsl:choose>


		<xsl:apply-templates />

		</xsl-out:stylesheet>
	</xsl:template>


	<!--
		Copy across templates according to the target format. If there's no common code for a particular format, an empty template is generated.
	-->
	<xsl:template match="template">
		<xsl-out:template>
		
			<!--
				Much easier to just copy all attributes across verbatim rather than copying specific named attributes, because we might want to use attributes that weren't originally anticipated.
				
				Might this be a problem in future?
			-->
			<xsl:copy-of select="@*" />
			
			<!--
				Copy across code that is common to ALL target formats. Any code not specific to a particular target format will therefore always appear FIRST in the resulting template.
			-->
			<xsl:copy-of select="common[not(@formats)]/node()" />
			
			<!-- Copy across code that is specific to the current format. -->
			<xsl:copy-of select="common[contains(@formats, concat('/', $target-format, '/'))]/node()" />
			<xsl:copy-of select="*[name(.) = $target-format]/node()" />
			
		</xsl-out:template>
	</xsl:template>

	<!--
		Dealing with functions is slightly more complex than templates, as functions aren't allowed to be empty. We therefore have to completely ignore function definitions that have no code for the target format. The second, more specific template will match in preference to the empty one.
	-->
	<xsl:template match="function" />

	<xsl:template match="function[common[contains( @formats, concat( '/', $target-format, '/' ) )]]|function[common[not( @formats )]]">
		<xsl-out:function>
		
			<!--
				Much easier to just copy all attributes across verbatim rather than copying specific named attributes, because we might want to use attributes that weren't originally anticipated.
				
				Might this be a problem in future?
			-->
			<xsl:copy-of select="@*" />

			<!--
				Copy across code that is common to ALL target formats. Any code not specific to a particular target format will therefore always appear FIRST in the resulting template.
			-->
			<xsl:copy-of select="common[not( @formats )]/node()" />
			
			<!-- Copy across code that is specific to the current format. -->
			<xsl:copy-of select="common[contains( @formats, concat( '/', $target-format, '/' ) )]/node()" />
			<xsl:copy-of select="*[name( . )=$target-format]/node()" />
			
		</xsl-out:function>
	</xsl:template>
	
	
	<!--
		Include templates from a stylesheet sub-module. This enables us to modularise the master stylesheet.
	-->
	<xsl:template match="include">
		<xsl:apply-templates select="document( @href )/stylesheet/*" />
	</xsl:template>

	
	<!--
		This template produces a template that calls another template, i.e.
		it implements a template alias.
		
		The generated template probably doesn't need a name, but we'll put one
		in anyway.
	-->

	<xsl:template match="alias">
		<xsl-out:template>
			<xsl:attribute name="name"><xsl:value-of select="@source" /></xsl:attribute>
			<xsl:attribute name="match"><xsl:value-of select="@source" /></xsl:attribute>
			<xsl-out:call-template>
				<xsl:attribute name="name"><xsl:value-of select="@target" /></xsl:attribute>
			</xsl-out:call-template>
		</xsl-out:template>
	</xsl:template>
	

	<!--
		This template produces a template for processing style-oriented markup,
		such as empahsis, foreign terms, and quotations.
	-->
	<!--
	<xsl:template match="d">
	</xsl-out:template match>
	-->

	<!--
		This template produces a template for processing an element that
		refers to a hyperlink.
	-->
	<xsl:template match="hyperlink">
	</xsl:template>
	
</xsl:stylesheet>

            <?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet	version="2.0"
				xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
				xmlns:xsl-out="[irrelevant]"
				xmlns:exsl="http://exslt.org/common"
				xmlns:xs="http://www.w3.org/2001/XMLSchema"
				xmlns:infosci="http://info-nts-12.otago.ac.nz/infosci">

	<!--
		XSLT transformation for a master XML document defining how to transform elements in the course handbook source into HTML and LaTeX.  Hmm, meta-stylesheet?!
	-->
	
	<!--	<xsl:output method="text" encoding="utf-8" media-type="text/xml" /> -->
	<xsl:output method="xml" encoding="utf-8" cdata-section-elements="html" />

	<!--
		What target format are we generating a styesheet for?
		Possible values: html, xhtml, latex (includes pdflatex), xelatex.
	-->
	<xsl:param name="target-format"><xsl:text>html</xsl:text></xsl:param>

	<!--
		Define an alias for the xsl namespace to avoid confusion when generating xsl: elements in the output of this stylesheet.
	-->
	<xsl:namespace-alias stylesheet-prefix="xsl-out" result-prefix="xsl" />

	<!--
		Some useful variables. (Could some of these become callable templates?)
	-->
	<xsl:variable name="newline">
<xsl:text>
</xsl:text>
	</xsl:variable>

	<xsl:variable name="space"><xsl:text> </xsl:text></xsl:variable>
	

	<xsl:template match="/">
		
		<xsl-out:stylesheet version="2.0" exclude-result-prefixes="exsl">
		
		<xsl-out:strip-space elements="*" />

		<xsl-out:param name="subject-code"><xsl:text>INFO</xsl:text></xsl-out:param>
		<xsl-out:param name="paper-number" />
		<xsl-out:param name="paper-year"		select="year-from-date( current-date() )"/>
		<xsl-out:param name="period-code" />
		
		<xsl-out:param name="showanswers"><xsl:text>no</xsl:text></xsl-out:param>
		
		<xsl-out:param name="base-path"><xsl:text>.</xsl:text></xsl-out:param>
		
		<!-- Full period string corresponding to the supplied period code. -->
		<xsl-out:variable name="period-string" select="infosci:expand-period-code( $period-code )" />
<!-- 
			<xsl-out:choose>
				<xsl-out:when test="$period-code = 'SS'">
					<xsl-out:text>Summer School</xsl-out:text>
				</xsl-out:when>
				<xsl-out:when test="$period-code = 'S1'">
					<xsl-out:text>Semester One</xsl-out:text>
				</xsl-out:when>
				<xsl-out:when test="$period-code = 'S2'">
					<xsl-out:text>Semester Two</xsl-out:text>
				</xsl-out:when>
				<xsl-out:when test="$period-code = 'FY'">
					<xsl-out:text>Full Year</xsl-out:text>
				</xsl-out:when>
				<xsl-out:otherwise>
					<xsl-out:message terminate="yes">
						<xsl-out:text>Unrecognised period code "</xsl-out:text>
						<xsl-out:value-of select="$period-code" />
						<xsl-out:text>".</xsl-out:text>
					</xsl-out:message>
				</xsl-out:otherwise>
			</xsl-out:choose>
		</xsl-out:variable>
 -->
		
		<!-- The date and time when the document was last built. -->
		<xsl-out:variable name="date-built"		select="current-dateTime()" />
		
		<!-- Get the name of the document being processed. -->
		<xsl-out:variable name="document-name"	select="reverse( tokenize( base-uri(), '/' ) )[1]" />

		<!-- Include the generated Oracle documentation code. -->
		<xsl-out:include href="oracle-docs.xsl" />

		<!-- Include the generated teaching calendar dates. -->
<!-- 
		<xsl-out:include href="calendar_dates.xsl" />
 -->

		<!--
			We're going to use the text encoding in a few different places, so let's work out what it should be now.
		-->
		<xsl:variable name="text-encoding">
			<xsl:choose>
			
				<xsl:when test="($target-format = 'latex') or ($target-format = 'html')">
					<xsl:text>iso-8859-1</xsl:text>
				</xsl:when>
				
				<xsl:when test="($target-format = 'xelatex') or ($target-format = 'xhtml')">
					<xsl:text>utf-8</xsl:text>
				</xsl:when>
				
				<xsl:otherwise>
					<xsl:message terminate="yes">
						<xsl:text>Sorry, unknown target format: </xsl:text><xsl:value-of select="$target-format" />
					</xsl:message>
				</xsl:otherwise>
			
			</xsl:choose>
		</xsl:variable>

		<!-- root-level documents should say what type/class of document they are (lecture, tutorial, generic, ...).  Do we want to call this a class or a type? -->
		<!--
		<xsl:variable name="doctype"><xsl:value-of select="/document/@type" /></xsl:variable>
		-->
		
		<!--
			First, output the document preamble according to target format. This is generally different for each target format.
		-->
		<xsl:choose>
			
			<!--
				The HTML formats are fairly simple: the only things that change are the doctypes, version number and text encoding.
			-->
			<xsl:when test="$target-format = 'html'">
			
				<xsl-out:output
					method="html"
					encoding="{$text-encoding}"
					version="4.01"
					media-type="text/html"
					doctype-public="-//W3C//DTD HTML 4.01 Transitional//EN"
					doctype-system="http://www.w3.org/TR/html4/loose.dtd"
				/>
				
			</xsl:when>
			
			<xsl:when test="$target-format = 'xhtml'">
			
				<xsl-out:output
					method="xml"
					encoding="{$text-encoding}"
					byte-order-mark="no"
					version="1.1"
					media-type="text/html"
					doctype-public="-//W3C//DTD XHTML 1.1//EN"
					doctype-system="http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"
				/>
				
			</xsl:when>
			
			<!--
				The LaTeX formats, however have a bunch of miscellaneous boilerplate that appears at the start of every document, and requires more complex interleaving because of hyperref. Since we need to stuff this into a template later on, we define this using a callable template, so that we can do useful things like apply-templates within it (which wouldn't work if we just used a variable).
			-->
			<xsl:when test="$target-format = 'latex'">
			
				<xsl-out:output method="text" encoding="{$text-encoding}" media-type="text/plain" />	

				<!--
					Set to no if you want this to be included inside another
					document. Appears here because it's used in the document
					preamble.
				-->
				<xsl-out:param name="standalone"><xsl:text>yes</xsl:text></xsl-out:param>
				
				<xsl-out:template name="latex-preamble">
					<xsl-out:text>
\usepackage{mathpazo} % mathpple is deprecated
\usepackage[T1]{fontenc}
\usepackage{textcomp}
</xsl-out:text>

					<xsl-out:apply-templates select="environment/latex-packages" />

					<xsl-out:text>
% Safer to specify the hyperref options directly rather than relying on
% the default hyperref.cfg, as XeLaTeX seems to ignore it :(.
\usepackage[	pdfpagemode=UseNone,%
				colorlinks,%
				urlcolor=blue,%
				citecolor=blue,%
				linkcolor=blue,%
				breaklinks	]{hyperref}

\renewcommand{\ttdefault}{blg}
</xsl-out:text>
				</xsl-out:template>
				
			</xsl:when>
			
			<xsl:when test="$target-format = 'xelatex'">
			
				<xsl-out:output method="text" encoding="{$text-encoding}" media-type="text/plain" />	

				<!--
					Set to no if you want this to be included inside another
					document. Appears here because it's used in the document
					preamble.
				-->
				<xsl-out:param name="standalone"><xsl:text>yes</xsl:text></xsl-out:param>
				
				<xsl-out:template name="latex-preamble">
					<xsl-out:text>
\usepackage[no-math]{fontspec}
\usepackage{mathspec}
\usepackage{xunicode}
\usepackage{xltxtra}
\usepackage{textcomp} % ???
</xsl-out:text>

					<xsl-out:apply-templates select="environment/latex-packages" />
					
					<xsl-out:text>
% Safer to specify the hyperref options directly rather than relying on
% the default hyperref.cfg, as XeLaTeX seems to ignore it :(.
\usepackage[	pdfpagemode=UseNone,%
				colorlinks,%
				urlcolor=blue,%
				citecolor=blue,%
				linkcolor=blue,%
				breaklinks	]{hyperref}

\defaultfontfeatures{Mapping=tex-text}
\setmainfont{TeX Gyre Pagella}
\setmathsfont(Digits){TeX Gyre Pagella}
\setmonofont[Scale=MatchLowercase]{Letter Gothic 12 Pitch}
</xsl-out:text>
				</xsl-out:template>
				
			</xsl:when>
			
			<!--
				No need for an otherwise, as weird target formats will have already been trapped by the definition of the text-encoding variable above.
			-->
			
		</xsl:choose>
		
		<!--
			Next, output the main document body according to target format. This is generally the same across similar target formats.
		-->
		<xsl:choose>

			<xsl:when test="($target-format = 'html') or ($target-format = 'xhtml')">
			
				<!-- *** (X)HTML Output *** -->
				
				<!-- Old version: before using xsl:namespace-alias: -->
				<!--
				<xsl-out:element name="xsl:output">
					<xsl-out:attribute name="method">html</xsl-out:attribute>
					<xsl-out:attribute name="encoding">UTF-8</xsl-out:attribute>
					<xsl-out:attribute name="media-type">text/html</xsl-out:attribute>
					<xsl-out:attribute name="doctype-public">-//W3C//DTD HTML 4.01 Transitional//EN</xsl-out:attribute>
				</xsl-out:element>
				-->
				
				<!-- Default to PNG images for web dispay. -->
				<xsl-out:param name="image-format"><xsl:text>png</xsl:text></xsl-out:param>

			<!-- Nope, includes can only appear as a child of xsl:stylesheet. -->
			<!-- <xsl-out:include href="xml2html-root.xsl" /> -->
				
				<xsl-out:template match="/document">
					<xsl-out:comment> THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT! </xsl-out:comment>
					<html>
						<head>
							<xsl-out:element name="link">
								<xsl-out:attribute name="rel">
									<xsl-out:text>Stylesheet</xsl-out:text>
								</xsl-out:attribute>
								<xsl-out:attribute name="href">
									<xsl-out:text>https://blackboard.otago.ac.nz/bbcswebdav/courses/</xsl-out:text>
									<xsl-out:value-of select="$subject-code" />
									<xsl-out:value-of select="$paper-number" />
									<xsl-out:text>_</xsl-out:text>
									<xsl-out:value-of select="$period-code" />
									<xsl-out:text>DNI_</xsl-out:text>
									<xsl-out:value-of select="$paper-year" />
									<xsl-out:text>/db_styles.css</xsl-out:text>
								</xsl-out:attribute>
								<xsl-out:attribute name="type">
									<xsl-out:text>text/css</xsl-out:text>
								</xsl-out:attribute>
							</xsl-out:element>
							<xsl-out:element name="meta">
								<xsl-out:attribute name="http-equiv">
									<xsl-out:text>Content-type</xsl-out:text>
								</xsl-out:attribute>
								<xsl-out:attribute name="content">
									<xsl-out:text>
										<xsl:text>text/html;charset=</xsl:text>
										<xsl:value-of select="$text-encoding" />
									</xsl-out:text>
								</xsl-out:attribute>
							</xsl-out:element>
							<title>
								<xsl-out:choose>
									<xsl-out:when test="@class = 'calendar'">
										<xsl-out:value-of select="$subject-code" />
										<xsl-out:value-of select="$paper-number" />
										<xsl-out:text> Teaching Calendar, </xsl-out:text>
										<xsl-out:value-of select="$period-string" />
										<xsl-out:text>, </xsl-out:text>
										<xsl-out:value-of select="$paper-year" />
									</xsl-out:when>
									<xsl-out:otherwise>
										<xsl-out:apply-templates select="title" mode="preamble" />
									</xsl-out:otherwise>
								</xsl-out:choose>
							</title>
						</head>
						<body>
							<xsl-out:choose>
								<xsl-out:when test="@class = 'calendar'" />
								<xsl-out:otherwise>
									<xsl-out:apply-templates select="title" mode="title" />
									<xsl-out:apply-templates select="date" mode="title" />
									<xsl-out:apply-templates select="due-date" mode="title" />
								</xsl-out:otherwise>
							</xsl-out:choose>
							<xsl-out:apply-templates />

							<!-- How best to approach this - certain elements that need special handling (e.g. title, author) shouldn't be passed through here as well. -->
							<!-- How about we just match certain elements that we know can be handled safely, e.g. sections, paragraphs, ...?  (...and their aliases?) -->
							<!-- Are introductions just another section, or should there be an introduction element? -->
							
							<!-- The solution is to get cleverer with our templates, e.g., multiple templates for <title> that have different match patterns (document/title, section/title). -->
							<!-- We also need to define an empty template for the <document-metadata> element so that its contents get ignored. -->
							<!-- Once these are done, we can just go apply-templates and forget about it. -->
							
							<hr />
							<!--
								Since HTML doesn't support footnotes as such, we
								instead include them as endnotes at the end of
								the document.
							-->
							<xsl-out:if test="count(//footnote) &gt; 0">
								<h3>Notes</h3>
								<xsl-out:apply-templates select="//footnote" mode="list" />
								<hr />
							</xsl-out:if>
							<xsl-out:call-template name="build-date-internal">
								<xsl-out:with-param name="format">long</xsl-out:with-param>
								<xsl-out:with-param name="style">footer</xsl-out:with-param>
							</xsl-out:call-template>
						</body>
					</html>
				</xsl-out:template>
			</xsl:when>

			<xsl:when test="($target-format = 'latex') or ($target-format = 'xelatex')">
			
				<!-- Set to pdf if using PDFLaTeX, otherwise eps. -->
				<xsl-out:param name="image-format"><xsl:text>pdf</xsl:text></xsl-out:param>
				
				<!--
				    Generate macro to encode the document class name.
				    This is currently BROKEN. If the document class specified loads packages that are then loaded by the boilerplate below with different optons, it will cause LaTeX "option clash" errors. Therefore, DO NOT use the @latex-document-class attribute for now until a solution can be devised!
				-->
				<xsl-out:template name="setup-document-class">
					<xsl-out:text>
\def\DocumentClass{</xsl-out:text>
                    <xsl-out:value-of select="@latex-document-class" />
                    <xsl-out:if test="not( @latex-document-class )">
                        <xsl-out:text>article</xsl-out:text>
                    </xsl-out:if>
				    <xsl-out:text>}
</xsl-out:text>
				</xsl-out:template>

				<!-- *** LaTeX Source Output *** -->
				<!-- Should this produce a LaTeX source fragment or an entire valid source document? -->
				<xsl-out:template match="/document">
					<xsl-out:choose>

						<xsl-out:when test="$standalone = 'yes'">
							<xsl-out:text>
% THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT!

</xsl-out:text>
							<xsl-out:call-template name="setup-document-class" />
							<xsl-out:text>
\PassOptionsToClass{\LaTeXOptions}{\DocumentClass}
\documentclass{\DocumentClass}

\usepackage[margin=1in]{geometry}
\usepackage{multirow}
\usepackage{graphicx}
\usepackage{verbatim}       % needed for \verbatiminput
\usepackage{relalg}         % needed for join operators
\usepackage{pifont}
\usepackage{siunitx}        % number and SI unit formatting
\usepackage{listings}       % nicely formatted code listings
\usepackage[normalem]{ulem} % fancy underlining, strikeout, etc.
\usepackage{boxedminipage}
\usepackage{parskip}        % Space-separated rather than indented paragraphs.
\usepackage{rotating}		% Rotate stuff.

</xsl-out:text>

							<xsl-out:call-template name="latex-preamble" />

							<xsl-out:apply-templates select="environment/latex-commands" />

							<xsl-out:text>
\newenvironment{answer}{\par\vspace{0.5em}\itshape}{\normalfont\vspace{1.5em}}

% Listings setup. We preload the most obviously like languages to speed things
% up. Other languages will still work, just not quite as quickly.
\lstloadlanguages{Oracle}
\lstset{basicstyle=\ttfamily,basewidth=0.5em,escapeinside={(@}{@)},
	showspaces=false,showstringspaces=false}

% Environment for worksheet exercises.
\newcounter{exercise}
\setcounter{exercise}{0}
\newenvironment{exercise}%
	{\noindent\refstepcounter{exercise}\begin{boxedminipage}{\columnwidth}\textbf{Exercise \theexercise: }}%
	{\end{boxedminipage}}

</xsl-out:text>

							<xsl-out:apply-templates select="title" mode="preamble" />
							<xsl-out:call-template name="newline-internal" />
							<xsl-out:apply-templates select="author" mode="preamble" />
							<xsl-out:call-template name="newline-internal" />
							<xsl-out:apply-templates select="date|due-date" mode="preamble" />
							<xsl-out:call-template name="newline-internal" />

							<xsl-out:text>
\begin{document}
</xsl-out:text>
                            <xsl-out:if test="not( @suppress-latex-title ) or ( @suppress-latex-title != 'yes' )">
                                <xsl-out:text>
	\maketitle
</xsl-out:text>
                            </xsl-out:if>
							<xsl-out:text>

</xsl-out:text>

							<xsl-out:apply-templates />

							<!--
								If you're having problems with the build date appearing in weird or annoying locations (usually because of floating items like tables and figures), set document/@auto-latex-build-date to "no". You can then use the build-date element to insert the build date wherever you like, if necessary. This really only applies to LaTeX documents. The behaviour of HTML documents is much more predictable because they don't have elements with "minds of their own", so the build date is guaranteed to always appear at the very end.
							-->
							<xsl-out:if test="not( @auto-latex-build-date ) or ( @auto-latex-build-date != 'no' )">
							
								<xsl-out:call-template name="build-date-internal">
									<xsl-out:with-param name="format">long</xsl-out:with-param>
									<xsl-out:with-param name="style">footer</xsl-out:with-param>
								</xsl-out:call-template>
							</xsl-out:if>
							<xsl-out:text>\end{document}</xsl-out:text>
						</xsl-out:when>
						<!-- Not standalone: -->
						<xsl-out:otherwise>
							<xsl-out:apply-templates select="title" mode="chapter" />
							<xsl-out:apply-templates select="*[not(self::title)]" />
							<xsl-out:if test="not( @auto-latex-build-date ) or ( @auto-latex-build-date != 'no' )">
								<xsl-out:call-template name="build-date-internal">
									<xsl-out:with-param name="format">long</xsl-out:with-param>
									<xsl-out:with-param name="style">footer</xsl-out:with-param>
								</xsl-out:call-template>
							</xsl-out:if>
						</xsl-out:otherwise>
					</xsl-out:choose>
				</xsl-out:template>
				
			</xsl:when>
			
			<!--
				No need for an otherwise, as weird formats will have already been trapped by the definition of the text-encoding variable above.
			-->
			
		</xsl:choose>


		<xsl:apply-templates />

		</xsl-out:stylesheet>
	</xsl:template>


	<!--
		Copy across templates according to the target format. If there's no common code for a particular format, an empty template is generated.
	-->
	<xsl:template match="template">
		<xsl-out:template>
		
			<!--
				Much easier to just copy all attributes across verbatim rather than copying specific named attributes, because we might want to use attributes that weren't originally anticipated.
				
				Might this be a problem in future?
			-->
			<xsl:copy-of select="@*" />
			
			<!--
				Copy across code that is common to ALL target formats. Any code not specific to a particular target format will therefore always appear FIRST in the resulting template.
			-->
			<xsl:copy-of select="common[not(@formats)]/node()" />
			
			<!-- Copy across code that is specific to the current format. -->
			<xsl:copy-of select="common[contains(@formats, concat('/', $target-format, '/'))]/node()" />
			<xsl:copy-of select="*[name(.) = $target-format]/node()" />
			
		</xsl-out:template>
	</xsl:template>

	<!--
		Dealing with functions is slightly more complex than templates, as functions aren't allowed to be empty. We therefore have to completely ignore function definitions that have no code for the target format. The second, more specific template will match in preference to the empty one.
	-->
	<xsl:template match="function" />

	<xsl:template match="function[common[contains( @formats, concat( '/', $target-format, '/' ) )]]|function[common[not( @formats )]]">
		<xsl-out:function>
		
			<!--
				Much easier to just copy all attributes across verbatim rather than copying specific named attributes, because we might want to use attributes that weren't originally anticipated.
				
				Might this be a problem in future?
			-->
			<xsl:copy-of select="@*" />

			<!--
				Copy across code that is common to ALL target formats. Any code not specific to a particular target format will therefore always appear FIRST in the resulting template.
			-->
			<xsl:copy-of select="common[not( @formats )]/node()" />
			
			<!-- Copy across code that is specific to the current format. -->
			<xsl:copy-of select="common[contains( @formats, concat( '/', $target-format, '/' ) )]/node()" />
			<xsl:copy-of select="*[name( . )=$target-format]/node()" />
			
		</xsl-out:function>
	</xsl:template>
	
	
	<!--
		Include templates from a stylesheet sub-module. This enables us to modularise the master stylesheet.
	-->
	<xsl:template match="include">
		<xsl:apply-templates select="document( @href )/stylesheet/*" />
	</xsl:template>

	
	<!--
		This template produces a template that calls another template, i.e.
		it implements a template alias.
		
		The generated template probably doesn't need a name, but we'll put one
		in anyway.
	-->

	<xsl:template match="alias">
		<xsl-out:template>
			<xsl:attribute name="name"><xsl:value-of select="@source" /></xsl:attribute>
			<xsl:attribute name="match"><xsl:value-of select="@source" /></xsl:attribute>
			<xsl-out:call-template>
				<xsl:attribute name="name"><xsl:value-of select="@target" /></xsl:attribute>
			</xsl-out:call-template>
		</xsl-out:template>
	</xsl:template>
	

	<!--
		This template produces a template for processing style-oriented markup,
		such as empahsis, foreign terms, and quotations.
	-->
	<!--
	<xsl:template match="d">
	</xsl-out:template match>
	-->

	<!--
		This template produces a template for processing an element that
		refers to a hyperlink.
	-->
	<xsl:template match="hyperlink">
	</xsl:template>
	
</xsl:stylesheet>
 <?xml version="1.0" encoding="utf-8"?>
 <xsl:stylesheet	version="2.0"
 				xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 				xmlns:xsl-out="[irrelevant]"
-				xmlns:exsl="http://exslt.org/common"
 				xmlns:xs="http://www.w3.org/2001/XMLSchema"
 				xmlns:infosci="http://info-nts-12.otago.ac.nz/infosci">
 	<!--
 	<xsl:template match="/">
+		<xsl-out:stylesheet version="2.0" exclude-result-prefixes="exsl">
+		<xsl-out:stylesheet version="2.0">
 		<xsl-out:strip-space elements="*" />
 		<xsl-out:param name="subject-code"><xsl:text>INFO</xsl:text></xsl-out:param>

Show line notes below