• Fixed framed paragraphs in (Xe)LaTeX so that the frame width adjusts to fit the text width. • Adjusted paragraph frames to stick out into the margin, leaving the text the normal width.

nigel.stanger / XML

Browse code • Fixed framed paragraphs in (Xe)LaTeX so that the frame width adjusts to fit the text width. • Adjusted paragraph frames to stick out into the margin, leaving the text the normal width. master
1 parent f376b08 commit 35e01c869fabda03fa1d0d381854872b245e7ffc Nigel Stanger authored on 27 Feb 2017

Patch

Showing 2 changed files

                Ignore Space
               Show notes
              View
            
          
          16 ■■■■■
          modules/basic-page-elements.xml
 			<xsl:if test="@indent = ('no', 'n', 'false', 'f', '0')">
				<xsl:text>\noindent </xsl:text>
			</xsl:if>
			<xsl:if test="@border = ('yes', 'y')">
				<xsl:text>\fbox{\parbox[t]{\textwidth}{</xsl:text>
			    <!-- Adjust box to fit relevant text margins. -->
			    <xsl:text>\hspace*{-\fboxsep}</xsl:text>
                <xsl:text>\setlength{\parwidth}{\textwidth}</xsl:text>
			    <xsl:if test="ancestor::item">
                    <xsl:text>\addtolength{\parwidth}{-\leftmargin}</xsl:text>
                    <xsl:text>\addtolength{\parwidth}{-\rightmargin}</xsl:text>
                </xsl:if>
				<xsl:text>\fbox{\parbox[t]{\parwidth}{</xsl:text>
			</xsl:if>
			<xsl:apply-templates />
			<xsl:if test="@border = ('yes', 'y')">
				<xsl:text>}}</xsl:text>

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

<!--
	Basic page layout elements, like paragraphs, page breaks, etc.
-->

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


	<!--
		Plain paragraph.
		
		@indent: Whether or not to indent this paragraph (probably only relevant in LaTeX).
			'no' => don't indent.
			otherwise => apply standard paragraph formatting. [default]
		
		@align: How to align the paragraph. Note that these are potentially distinct from the default action, e.g., specifying align="left" will produce a flushleft environment in LaTeX, which is a different effect from not specifying an alignment at all.
			'left' => left alignment
			'center' => centered alignment
			'right' => right alignment
			otherwise => apply standard paragraph formatting. [default]

		@border: Whether or not to draw a border around the paragraph.
			'yes' => draw a border.
			otherwise => apply standard paragraph formatting. [default]
	-->
	<template name="paragraph" match="paragraph|para|p|P">
		<common formats="/latex/xelatex/">
			<!--
				LaTeX delimits paragraphs with vertical whitespace, so we need to ensure plenty. A couple of blank lines before and after should be sufficient.
			-->
			<xsl:call-template name="newline-internal" />
			<xsl:call-template name="newline-internal" />
			<xsl:choose>
				<xsl:when test="@align = ('left', 'right')">
					<xsl:text>\begin{flush</xsl:text>
					<xsl:value-of select="@align" />
					<xsl:text>}</xsl:text>
				</xsl:when>
				<xsl:when test="@align = ('center', 'centre')">
					<xsl:text>\begin{center}</xsl:text>
				</xsl:when>
			</xsl:choose>
			<xsl:if test="@indent = ('no', 'n', 'false', 'f', '0')">
				<xsl:text>\noindent </xsl:text>
			</xsl:if>
			<xsl:if test="@border = ('yes', 'y')">
			    <!-- Adjust box to fit relevant text margins. -->
			    <xsl:text>\hspace*{-\fboxsep}</xsl:text>
                <xsl:text>\setlength{\parwidth}{\textwidth}</xsl:text>
			    <xsl:if test="ancestor::item">
                    <xsl:text>\addtolength{\parwidth}{-\leftmargin}</xsl:text>
                    <xsl:text>\addtolength{\parwidth}{-\rightmargin}</xsl:text>
                </xsl:if>
				<xsl:text>\fbox{\parbox[t]{\parwidth}{</xsl:text>
			</xsl:if>
			<xsl:apply-templates />
			<xsl:if test="@border = ('yes', 'y')">
				<xsl:text>}}</xsl:text>
			</xsl:if>
			<xsl:choose>
				<xsl:when test="@align = ('left', 'right')">
					<xsl:text>\end{flush</xsl:text>
					<xsl:value-of select="@align" />
					<xsl:text>}</xsl:text>
				</xsl:when>
				<xsl:when test="@align = ('center', 'centre')">
					<xsl:text>\end{center}</xsl:text>
				</xsl:when>
			</xsl:choose>
			<xsl:call-template name="newline-internal" />
			<xsl:call-template name="newline-internal" />
		</common>
		<!--
			HTML is weird about what things you cannot include inside paragraphs (e.g. lists of any kind). However, the end P tag is optional, so one option might simply be not to output it (not for XHTML, though!).
		-->
		<common formats="/html/xhtml/">
			<!--
				The HTMLStyle parameter is an Ugly Hack(tm) to ensure that paragraphs are indented correctly inside definition lists in HTML. I tried modes first, but they didn't work correctly. Fortunately this only needs to be done with paragraphs, so this will work fine.
			-->
			<xsl:param name="HTMLStyle" />
			<p>
                <xsl:if test="@border = ('yes', 'y')">
					<xsl:attribute name="style">border: 1px solid black;</xsl:attribute>
				</xsl:if>
				<xsl:if test="$HTMLStyle">
					<xsl:attribute name="class">
						<xsl:value-of select="$HTMLStyle" />
					</xsl:attribute>
				</xsl:if>
				<xsl:if test="@align">
					<xsl:attribute name="align">
						<xsl:value-of select="@align" />
					</xsl:attribute>
				</xsl:if>
				<xsl:apply-templates />
			</p>
		</common>
	</template>
	
	
	<!-- New line. -->
	
	<template name="newline" match="newline|line-break|br">
		<common formats="/latex/xelatex/">
			<xsl:text> \\</xsl:text>
			<xsl:call-template name="newline-internal" />
		</common>
		<common formats="/html/xhtml/">
			<br />
		</common>
	</template>

	<!--
		Whereas the "newline" template above is for line breaks intended to be displayed in the final document, this is for additional linebreaks in the generated LaTeX or HTML markup. This is used to avoid things like "\end{verbatim}\item" all on one line, not that this really matters in general, as the generated markup will be pretty messy anyway, and TeX doesn't usually care :).
		
		This also makes any XSLT markup that generates internal newlines a lot tidier looking!
	-->
	<template name="newline-internal" match="newline-internal">
		<common>
			<xsl:text>
</xsl:text>
		</common>
	</template>
	
	
	<!--
		Text that shouldn't be broken across a line (i.e., LaTeX \mbox).
		Only really relevant for LaTeX because we can't control this in HTML.
	-->
	<template name="no-break" match="no-break|mbox">
		<common formats="/latex/xelatex/">
			<xsl:text>\mbox{</xsl:text>
			<xsl:apply-templates />
			<xsl:text>}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<xsl:apply-templates />
		</common>
	</template>
	
	
	<!--
		Page break. This is only relevant for LaTeX formats at present.
		
		The page break is automatically suppressed if the parent node is "answer" and $showanswers is "no", or the parent node is "question" and $showanswers is "yes". This is to prevent page breaks that look fine in one but not the other.
		If you want to force a page break regardless, put after the "answer" element for a question item.
		
		@print-caption: Whether or not to print a caption before the page break.
			'yes' => display the caption
			otherwise => display nothing [default]
		
		@caption-text: The text to be printed before the page break. The default is "continues over...".
	-->
	
	<template name="page-break" match="page-break|new-page|newpage|pagebreak">
		<common formats="/latex/xelatex/">
            <xsl:variable name="insert" select="
                if ((name(..) eq 'answer') and ($showanswers = ('no', 'n', 'false', 'f', '0'))) then false()
                else if ((name(..) eq 'question') and ($showanswers = ('yes', 'y', 'true', 't', '1'))) then false()
                else true()" />
            <xsl:if test="$insert">
                <xsl:if test="@print-caption = ('yes', 'y', 'true', 't', '1')">
                    <xsl:text>\begin{flushright}</xsl:text>
                    <xsl:call-template name="newline-internal" />
                    <xsl:text>\emph{</xsl:text>
                    <xsl:choose>
                        <xsl:when test="@caption-text">
                            <xsl:value-of select="@caption-text" />
                        </xsl:when>
                        <xsl:otherwise>
                            <xsl:text>continues over\ldots</xsl:text>
                        </xsl:otherwise>
                    </xsl:choose>
                    <xsl:text>}</xsl:text>
                    <xsl:call-template name="newline-internal" />
                    <xsl:text>\end{flushright}</xsl:text>
                    <xsl:call-template name="newline-internal" />
                </xsl:if>
                <xsl:text>\newpage</xsl:text>
                <xsl:call-template name="newline-internal" />
            </xsl:if>
		</common>
	</template>
	
	
	<!--
		Skip a certain amount of space vertically. Probably more relevant to LaTeX than HTML. Is it even possible to vskip a set amount in HTML?? I suppose you could create an empty <div> element with a specified height, but I'm not sure that it even makes sense in HTML to skip more than the standard paragraph separation anyway.
		
		@size: the amount of space to skip.
			missing => \vskip\baselineskip [default]
			'small' => \smallskip
			'medium' => \medskip
			'large' => \bigskip
			'fill' => \vfill
			LaTeX length => \vskipxx
	-->
	<template name="vertical-skip" match="vertical-skip|vskip">
		<common formats="/latex/xelatex/">
			<xsl:choose>
				<xsl:when test="not(@size)">
					<xsl:text>\vskip\baselineskip</xsl:text>
				</xsl:when>
				<xsl:when test="@size='small'">
					<xsl:text>\smallskip</xsl:text>
				</xsl:when>
				<xsl:when test="@size='medium'">
					<xsl:text>\medskip</xsl:text>
				</xsl:when>
				<xsl:when test="@size='large'">
					<xsl:text>\bigskip</xsl:text>
				</xsl:when>
				<xsl:when test="@size='fill'">
					<xsl:text>\vfill</xsl:text>
				</xsl:when>
				<!-- Check for valid LaTeX length format, e.g., "2.54cm". -->
				<xsl:when test="matches( @size, '^\d*\.?\d+(cm|em|ex|in|pc|pt|mm|bp)$' )">
					<xsl:text>\vskip</xsl:text>
					<xsl:value-of select="@size" />
				</xsl:when>
				<xsl:otherwise>
					<xsl:message terminate="yes">
						<xsl:text>Invalid skip expression for LaTeX: "</xsl:text>
						<xsl:value-of select="@size" />
						<xsl:text>" (valid values are "small", "medium", "large", "fill", or a LaTeX length, e.g., "24pt")</xsl:text>
					</xsl:message>
				</xsl:otherwise>
			</xsl:choose>
			<xsl:call-template name="newline-internal" />
		</common>
		<common formats="/html/xhtml/">
			<!-- For the moment we'll just throw in a <br /> :). -->
			<br clear="left" />
		</common>
	</template>
	
	
	<!--
	    Generate a horizontal rule the width of the column.
	-->
	<template name="horizontal-rule" match="horizontal-rule|hrule|hr">
		<common formats="/latex/xelatex/">
		    <xsl:text>\hrule</xsl:text>
			<xsl:call-template name="newline-internal" />
		</common>
		<common formats="/html/xhtml/">
		    <xsl:element name="hr" />
		</common>
	</template>

	
</stylesheet>

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

<!--
	Basic page layout elements, like paragraphs, page breaks, etc.
-->

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


	<!--
		Plain paragraph.
		
		@indent: Whether or not to indent this paragraph (probably only relevant in LaTeX).
			'no' => don't indent.
			otherwise => apply standard paragraph formatting. [default]
		
		@align: How to align the paragraph. Note that these are potentially distinct from the default action, e.g., specifying align="left" will produce a flushleft environment in LaTeX, which is a different effect from not specifying an alignment at all.
			'left' => left alignment
			'center' => centered alignment
			'right' => right alignment
			otherwise => apply standard paragraph formatting. [default]

		@border: Whether or not to draw a border around the paragraph.
			'yes' => draw a border.
			otherwise => apply standard paragraph formatting. [default]
	-->
	<template name="paragraph" match="paragraph|para|p|P">
		<common formats="/latex/xelatex/">
			<!--
				LaTeX delimits paragraphs with vertical whitespace, so we need to ensure plenty. A couple of blank lines before and after should be sufficient.
			-->
			<xsl:call-template name="newline-internal" />
			<xsl:call-template name="newline-internal" />
			<xsl:choose>
				<xsl:when test="@align = ('left', 'right')">
					<xsl:text>\begin{flush</xsl:text>
					<xsl:value-of select="@align" />
					<xsl:text>}</xsl:text>
				</xsl:when>
				<xsl:when test="@align = ('center', 'centre')">
					<xsl:text>\begin{center}</xsl:text>
				</xsl:when>
			</xsl:choose>
			<xsl:if test="@indent = ('no', 'n', 'false', 'f', '0')">
				<xsl:text>\noindent </xsl:text>
			</xsl:if>
			<xsl:if test="@border = ('yes', 'y')">
				<xsl:text>\fbox{\parbox[t]{\textwidth}{</xsl:text>
			</xsl:if>
			<xsl:apply-templates />
			<xsl:if test="@border = ('yes', 'y')">
				<xsl:text>}}</xsl:text>
			</xsl:if>
			<xsl:choose>
				<xsl:when test="@align = ('left', 'right')">
					<xsl:text>\end{flush</xsl:text>
					<xsl:value-of select="@align" />
					<xsl:text>}</xsl:text>
				</xsl:when>
				<xsl:when test="@align = ('center', 'centre')">
					<xsl:text>\end{center}</xsl:text>
				</xsl:when>
			</xsl:choose>
			<xsl:call-template name="newline-internal" />
			<xsl:call-template name="newline-internal" />
		</common>
		<!--
			HTML is weird about what things you cannot include inside paragraphs (e.g. lists of any kind). However, the end P tag is optional, so one option might simply be not to output it (not for XHTML, though!).
		-->
		<common formats="/html/xhtml/">
			<!--
				The HTMLStyle parameter is an Ugly Hack(tm) to ensure that paragraphs are indented correctly inside definition lists in HTML. I tried modes first, but they didn't work correctly. Fortunately this only needs to be done with paragraphs, so this will work fine.
			-->
			<xsl:param name="HTMLStyle" />
			<p>
                <xsl:if test="@border = ('yes', 'y')">
					<xsl:attribute name="style">border: 1px solid black;</xsl:attribute>
				</xsl:if>
				<xsl:if test="$HTMLStyle">
					<xsl:attribute name="class">
						<xsl:value-of select="$HTMLStyle" />
					</xsl:attribute>
				</xsl:if>
				<xsl:if test="@align">
					<xsl:attribute name="align">
						<xsl:value-of select="@align" />
					</xsl:attribute>
				</xsl:if>
				<xsl:apply-templates />
			</p>
		</common>
	</template>
	
	
	<!-- New line. -->
	
	<template name="newline" match="newline|line-break|br">
		<common formats="/latex/xelatex/">
			<xsl:text> \\</xsl:text>
			<xsl:call-template name="newline-internal" />
		</common>
		<common formats="/html/xhtml/">
			<br />
		</common>
	</template>

	<!--
		Whereas the "newline" template above is for line breaks intended to be displayed in the final document, this is for additional linebreaks in the generated LaTeX or HTML markup. This is used to avoid things like "\end{verbatim}\item" all on one line, not that this really matters in general, as the generated markup will be pretty messy anyway, and TeX doesn't usually care :).
		
		This also makes any XSLT markup that generates internal newlines a lot tidier looking!
	-->
	<template name="newline-internal" match="newline-internal">
		<common>
			<xsl:text>
</xsl:text>
		</common>
	</template>
	
	
	<!--
		Text that shouldn't be broken across a line (i.e., LaTeX \mbox).
		Only really relevant for LaTeX because we can't control this in HTML.
	-->
	<template name="no-break" match="no-break|mbox">
		<common formats="/latex/xelatex/">
			<xsl:text>\mbox{</xsl:text>
			<xsl:apply-templates />
			<xsl:text>}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<xsl:apply-templates />
		</common>
	</template>
	
	
	<!--
		Page break. This is only relevant for LaTeX formats at present.
		
		The page break is automatically suppressed if the parent node is "answer" and $showanswers is "no", or the parent node is "question" and $showanswers is "yes". This is to prevent page breaks that look fine in one but not the other.
		If you want to force a page break regardless, put after the "answer" element for a question item.
		
		@print-caption: Whether or not to print a caption before the page break.
			'yes' => display the caption
			otherwise => display nothing [default]
		
		@caption-text: The text to be printed before the page break. The default is "continues over...".
	-->
	
	<template name="page-break" match="page-break|new-page|newpage|pagebreak">
		<common formats="/latex/xelatex/">
            <xsl:variable name="insert" select="
                if ((name(..) eq 'answer') and ($showanswers = ('no', 'n', 'false', 'f', '0'))) then false()
                else if ((name(..) eq 'question') and ($showanswers = ('yes', 'y', 'true', 't', '1'))) then false()
                else true()" />
            <xsl:if test="$insert">
                <xsl:if test="@print-caption = ('yes', 'y', 'true', 't', '1')">
                    <xsl:text>\begin{flushright}</xsl:text>
                    <xsl:call-template name="newline-internal" />
                    <xsl:text>\emph{</xsl:text>
                    <xsl:choose>
                        <xsl:when test="@caption-text">
                            <xsl:value-of select="@caption-text" />
                        </xsl:when>
                        <xsl:otherwise>
                            <xsl:text>continues over\ldots</xsl:text>
                        </xsl:otherwise>
                    </xsl:choose>
                    <xsl:text>}</xsl:text>
                    <xsl:call-template name="newline-internal" />
                    <xsl:text>\end{flushright}</xsl:text>
                    <xsl:call-template name="newline-internal" />
                </xsl:if>
                <xsl:text>\newpage</xsl:text>
                <xsl:call-template name="newline-internal" />
            </xsl:if>
		</common>
	</template>
	
	
	<!--
		Skip a certain amount of space vertically. Probably more relevant to LaTeX than HTML. Is it even possible to vskip a set amount in HTML?? I suppose you could create an empty <div> element with a specified height, but I'm not sure that it even makes sense in HTML to skip more than the standard paragraph separation anyway.
		
		@size: the amount of space to skip.
			missing => \vskip\baselineskip [default]
			'small' => \smallskip
			'medium' => \medskip
			'large' => \bigskip
			'fill' => \vfill
			LaTeX length => \vskipxx
	-->
	<template name="vertical-skip" match="vertical-skip|vskip">
		<common formats="/latex/xelatex/">
			<xsl:choose>
				<xsl:when test="not(@size)">
					<xsl:text>\vskip\baselineskip</xsl:text>
				</xsl:when>
				<xsl:when test="@size='small'">
					<xsl:text>\smallskip</xsl:text>
				</xsl:when>
				<xsl:when test="@size='medium'">
					<xsl:text>\medskip</xsl:text>
				</xsl:when>
				<xsl:when test="@size='large'">
					<xsl:text>\bigskip</xsl:text>
				</xsl:when>
				<xsl:when test="@size='fill'">
					<xsl:text>\vfill</xsl:text>
				</xsl:when>
				<!-- Check for valid LaTeX length format, e.g., "2.54cm". -->
				<xsl:when test="matches( @size, '^\d*\.?\d+(cm|em|ex|in|pc|pt|mm|bp)$' )">
					<xsl:text>\vskip</xsl:text>
					<xsl:value-of select="@size" />
				</xsl:when>
				<xsl:otherwise>
					<xsl:message terminate="yes">
						<xsl:text>Invalid skip expression for LaTeX: "</xsl:text>
						<xsl:value-of select="@size" />
						<xsl:text>" (valid values are "small", "medium", "large", "fill", or a LaTeX length, e.g., "24pt")</xsl:text>
					</xsl:message>
				</xsl:otherwise>
			</xsl:choose>
			<xsl:call-template name="newline-internal" />
		</common>
		<common formats="/html/xhtml/">
			<!-- For the moment we'll just throw in a <br /> :). -->
			<br clear="left" />
		</common>
	</template>
	
	
	<!--
	    Generate a horizontal rule the width of the column.
	-->
	<template name="horizontal-rule" match="horizontal-rule|hrule|hr">
		<common formats="/latex/xelatex/">
		    <xsl:text>\hrule</xsl:text>
			<xsl:call-template name="newline-internal" />
		</common>
		<common formats="/html/xhtml/">
		    <xsl:element name="hr" />
		</common>
	</template>

	
</stylesheet>
 			<xsl:if test="@indent = ('no', 'n', 'false', 'f', '0')">
 				<xsl:text>\noindent </xsl:text>
 			</xsl:if>
 			<xsl:if test="@border = ('yes', 'y')">
+				<xsl:text>\fbox{\parbox[t]{\textwidth}{</xsl:text>
+			    <!-- Adjust box to fit relevant text margins. -->
+			    <xsl:text>\hspace*{-\fboxsep}</xsl:text>
+                <xsl:text>\setlength{\parwidth}{\textwidth}</xsl:text>
+			    <xsl:if test="ancestor::item">
+                    <xsl:text>\addtolength{\parwidth}{-\leftmargin}</xsl:text>
+                    <xsl:text>\addtolength{\parwidth}{-\rightmargin}</xsl:text>
+                </xsl:if>
+				<xsl:text>\fbox{\parbox[t]{\parwidth}{</xsl:text>
 			</xsl:if>
 			<xsl:apply-templates />
 			<xsl:if test="@border = ('yes', 'y')">
 				<xsl:text>}}</xsl:text>

                Ignore Space
               Show notes
              View
            
          
          5 ■■■■■
          xml2xslt.xsl
 \lstloadlanguages{Oracle}
\lstset{basicstyle=\ttfamily,basewidth=0.5em,escapeinside={(@}{@)},
	showspaces=false,showstringspaces=false}
 
% Length for tracking paragraph width so that we can draw borders (frames)
% to the correct width.
\newlength{\parwidth}
\setlength{\parwidth}{\textwidth}
 
</xsl-out:text>
 
                            <xsl-out:choose>
                                <xsl-out:when test="@latex-document-class eq 'lectureassignment'">

            <?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="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>
	
	
    <!-- *** TEMPLATES *** -->
    
	<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>
		
		<!-- This is normally the path to the current document directory. -->
		<xsl-out:param name="base-path"><xsl:text>.</xsl:text></xsl-out:param>
		
		<!-- This is normally the path to the root directory of the paper tree in the filesystem. -->
		<xsl-out:param name="paper-include-path"><xsl:text>.</xsl:text></xsl-out:param>
		
		<!-- This is normally the file paper_init.tex in the root of the paper tree. -->
		<xsl-out:param name="latex-initialisation-file"><xsl:text>paper_init</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 )" />
		
		<!-- 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" />
		
		<!--
		    Boilerplate (Xe)LaTeX code for loading hyperref. If the package is already loaded (by the document class), attempting to load it again will cause an "option clash" error. To avoid this, check first whether it's already loaded. We apply the required settings afterwards regardless.
		-->
        <xsl-out:variable name="latex-hyperref-boilerplate">
            <xsl-out:text>
% Avoid option clash if document class already loaded it.
\makeatletter
\@ifpackageloaded{hyperref}{}{\usepackage{hyperref}}
\makeatother

% Safer to specify the hyperref options directly rather than relying on
% the default hyperref.cfg, as XeLaTeX seems to ignore it :(.
\hypersetup{pdfpagemode=UseNone,colorlinks,urlcolor=blue,citecolor=blue,%
            linkcolor=blue,breaklinks}
</xsl-out:text>
        </xsl-out:variable>
				
		<!--
			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', 'html')">
					<xsl:text>iso-8859-1</xsl:text>
				</xsl:when>
				
				<xsl:when test="$target-format = ('xelatex', '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>
	    
	    
		<!--
			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 eq '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 eq '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 eq '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:value-of select="$latex-hyperref-boilerplate" />

					<xsl-out:text>
\renewcommand{\ttdefault}{blg}
</xsl-out:text>
				</xsl-out:template>
				
			</xsl:when>
			
			<xsl:when test="$target-format eq '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:value-of select="$latex-hyperref-boilerplate" />

					<xsl-out:text>
\defaultfontfeatures{Mapping=tex-text}
\setmainfont{Minion Pro}
\setsansfont[Scale=MatchUppercase,BoldFont={Open Sans}]{Open Sans Light}
\setmonofont[Scale=MatchLowercase]{Letter Gothic 12 Pitch}
\setmathsfont(Latin,Digits){TeX Gyre Pagella}

% Hack to prevent digits in hyperlinks from being set in the main font instead of the mono font.
% From http://tex.stackexchange.com/questions/99770/problem-with-digits-in-urls-when-using-mathspec-and-hyperref
% Note: doesn't matter if this is executed multiple times.
\makeatletter
     \DeclareMathSymbol{0}{\mathalpha}{\eu@DigitsArabic@symfont}{`0}
     \DeclareMathSymbol{1}{\mathalpha}{\eu@DigitsArabic@symfont}{`1}
     \DeclareMathSymbol{2}{\mathalpha}{\eu@DigitsArabic@symfont}{`2}
     \DeclareMathSymbol{3}{\mathalpha}{\eu@DigitsArabic@symfont}{`3}
     \DeclareMathSymbol{4}{\mathalpha}{\eu@DigitsArabic@symfont}{`4}
     \DeclareMathSymbol{5}{\mathalpha}{\eu@DigitsArabic@symfont}{`5}
     \DeclareMathSymbol{6}{\mathalpha}{\eu@DigitsArabic@symfont}{`6}
     \DeclareMathSymbol{7}{\mathalpha}{\eu@DigitsArabic@symfont}{`7}
     \DeclareMathSymbol{8}{\mathalpha}{\eu@DigitsArabic@symfont}{`8}
     \DeclareMathSymbol{9}{\mathalpha}{\eu@DigitsArabic@symfont}{`9}
\makeatother
</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', 'xhtml')">
			
				<!-- *** (X)HTML Output *** -->
				
				<!-- Default to PNG images for web dispay. -->
				<xsl-out:param name="image-format"><xsl:text>png</xsl:text></xsl-out:param>

				<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 eq '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 eq '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', '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.
				    
				    Note that if the document class loads a package that the boilerplate in this template also attempts to load, it may cause an "option clash" error. If so, the loading of that package will need to be made conditional in the boilerplate (using \@ifpackageloaded). So far this applies to the following packages:
				        * geometry
				        * hyperref
				    
				    Other packages that *might* cause similar problems (guessing here):
				        * listings
				-->
				<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>
				
				<!--
				    Generate macro to specify document class options.
				-->
				<xsl-out:template name="setup-class-options">
					<xsl-out:text>
\def\LaTeXOptions{</xsl-out:text>
                    <xsl-out:value-of select="string-join((
                        if (@latex-font-size) then @latex-font-size else '12pt',
                        if (@latex-paper-size) then @latex-paper-size else 'a4paper',
                        @latex-class-options), ',')" />
				    <xsl-out:text>}
</xsl-out:text>
				</xsl-out:template>

				<!-- *** (Xe)LaTeX Source Output *** -->
				
				<xsl-out:template match="/document">
					<xsl-out:choose>

						<!-- standalone = "yes" means generate an entire valid (Xe)LaTeX source document. -->
						<xsl-out:when test="$standalone eq 'yes'">
							<xsl-out:text>
% THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT!

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

% Set up paper variables, if applicable.
\makeatletter
\@ifpackageloaded{lecturecommon}{\input{</xsl-out:text><xsl-out:value-of select="$paper-include-path" /><xsl-out:text>/</xsl-out:text><xsl-out:value-of select="$latex-initialisation-file" /><xsl-out:text>}}
\makeatother

% Avoid option clash if document class already loaded it.
\makeatletter
\@ifpackageloaded{geometry}{}{\usepackage[margin=1in]{geometry}}
\makeatother

\usepackage{multirow}
\usepackage{longtable}
\usepackage{graphicx}
\usepackage{verbatim}           % needed for \verbatiminput
\usepackage{relalg}             % needed for join operators
\usepackage{pifont}
\usepackage[mode=text]{siunitx} % number and SI unit formatting ([mode=text] needed to make it use the correct
                                % maths typeface under Unicode/fontspec, otherwise it uses Computer Modern. Works
                                % fine in non-Unicode regardless.)
\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.
\usepackage{microtype}          % For better typesetting in general.

\makeatletter
\@ifpackageloaded{amsmath}{}{\usepackage{amsmath}}
\makeatother

</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 commonly used 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}

% Length for tracking paragraph width so that we can draw borders (frames)
% to the correct width.
\newlength{\parwidth}
\setlength{\parwidth}{\textwidth}

</xsl-out:text>

                            <xsl-out:choose>
                                <xsl-out:when test="@latex-document-class eq 'lectureassignment'">
                                    <xsl-out:text>\SetAssignmentNumber{</xsl-out:text>
                                    <xsl-out:value-of select="@sequence-number" />
                                    <xsl-out:text>}</xsl-out:text>
							        <xsl-out:call-template name="newline-internal" />
                                </xsl-out:when>
                                <xsl-out:when test="@latex-document-class eq 'lectureworksheet'">
                                    <xsl-out:text>\SetWeekNumber{</xsl-out:text>
                                    <xsl-out:value-of select="@sequence-number" />
                                    <xsl-out:text>}</xsl-out:text>
							        <xsl-out:call-template name="newline-internal" />
                                </xsl-out:when>
                                <xsl-out:otherwise />
                            </xsl-out:choose>

							<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 not(@suppress-latex-title = ('yes', 'y', 'true', 't', '1'))">
                                <xsl-out:text>
	\maketitle
</xsl-out:text>
                            </xsl-out:if>
                            <!--
                                Note that the generate-latex-toc attribute doesn't override anything that the document class does. If the document class generates a table of contents anyway, the value of the attribute is irrelevant.
                            -->
                            <xsl-out:if test="@generate-latex-toc eq 'yes'">
                                <xsl-out:text>
	\tableofcontents
</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 not(@auto-latex-build-date = ('no', 'n', 'false', 'f', '0'))">
							
								<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>
						
						<!-- standalone = "no" means generate a (Xe)LaTeX source fragment. -->
						<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 not(@auto-latex-build-date = ('no', 'n', 'false', 'f', '0'))">
								<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>
	

</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: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="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>
	
	
    <!-- *** TEMPLATES *** -->
    
	<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>
		
		<!-- This is normally the path to the current document directory. -->
		<xsl-out:param name="base-path"><xsl:text>.</xsl:text></xsl-out:param>
		
		<!-- This is normally the path to the root directory of the paper tree in the filesystem. -->
		<xsl-out:param name="paper-include-path"><xsl:text>.</xsl:text></xsl-out:param>
		
		<!-- This is normally the file paper_init.tex in the root of the paper tree. -->
		<xsl-out:param name="latex-initialisation-file"><xsl:text>paper_init</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 )" />
		
		<!-- 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" />
		
		<!--
		    Boilerplate (Xe)LaTeX code for loading hyperref. If the package is already loaded (by the document class), attempting to load it again will cause an "option clash" error. To avoid this, check first whether it's already loaded. We apply the required settings afterwards regardless.
		-->
        <xsl-out:variable name="latex-hyperref-boilerplate">
            <xsl-out:text>
% Avoid option clash if document class already loaded it.
\makeatletter
\@ifpackageloaded{hyperref}{}{\usepackage{hyperref}}
\makeatother

% Safer to specify the hyperref options directly rather than relying on
% the default hyperref.cfg, as XeLaTeX seems to ignore it :(.
\hypersetup{pdfpagemode=UseNone,colorlinks,urlcolor=blue,citecolor=blue,%
            linkcolor=blue,breaklinks}
</xsl-out:text>
        </xsl-out:variable>
				
		<!--
			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', 'html')">
					<xsl:text>iso-8859-1</xsl:text>
				</xsl:when>
				
				<xsl:when test="$target-format = ('xelatex', '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>
	    
	    
		<!--
			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 eq '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 eq '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 eq '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:value-of select="$latex-hyperref-boilerplate" />

					<xsl-out:text>
\renewcommand{\ttdefault}{blg}
</xsl-out:text>
				</xsl-out:template>
				
			</xsl:when>
			
			<xsl:when test="$target-format eq '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:value-of select="$latex-hyperref-boilerplate" />

					<xsl-out:text>
\defaultfontfeatures{Mapping=tex-text}
\setmainfont{Minion Pro}
\setsansfont[Scale=MatchUppercase,BoldFont={Open Sans}]{Open Sans Light}
\setmonofont[Scale=MatchLowercase]{Letter Gothic 12 Pitch}
\setmathsfont(Latin,Digits){TeX Gyre Pagella}

% Hack to prevent digits in hyperlinks from being set in the main font instead of the mono font.
% From http://tex.stackexchange.com/questions/99770/problem-with-digits-in-urls-when-using-mathspec-and-hyperref
% Note: doesn't matter if this is executed multiple times.
\makeatletter
     \DeclareMathSymbol{0}{\mathalpha}{\eu@DigitsArabic@symfont}{`0}
     \DeclareMathSymbol{1}{\mathalpha}{\eu@DigitsArabic@symfont}{`1}
     \DeclareMathSymbol{2}{\mathalpha}{\eu@DigitsArabic@symfont}{`2}
     \DeclareMathSymbol{3}{\mathalpha}{\eu@DigitsArabic@symfont}{`3}
     \DeclareMathSymbol{4}{\mathalpha}{\eu@DigitsArabic@symfont}{`4}
     \DeclareMathSymbol{5}{\mathalpha}{\eu@DigitsArabic@symfont}{`5}
     \DeclareMathSymbol{6}{\mathalpha}{\eu@DigitsArabic@symfont}{`6}
     \DeclareMathSymbol{7}{\mathalpha}{\eu@DigitsArabic@symfont}{`7}
     \DeclareMathSymbol{8}{\mathalpha}{\eu@DigitsArabic@symfont}{`8}
     \DeclareMathSymbol{9}{\mathalpha}{\eu@DigitsArabic@symfont}{`9}
\makeatother
</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', 'xhtml')">
			
				<!-- *** (X)HTML Output *** -->
				
				<!-- Default to PNG images for web dispay. -->
				<xsl-out:param name="image-format"><xsl:text>png</xsl:text></xsl-out:param>

				<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 eq '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 eq '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', '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.
				    
				    Note that if the document class loads a package that the boilerplate in this template also attempts to load, it may cause an "option clash" error. If so, the loading of that package will need to be made conditional in the boilerplate (using \@ifpackageloaded). So far this applies to the following packages:
				        * geometry
				        * hyperref
				    
				    Other packages that *might* cause similar problems (guessing here):
				        * listings
				-->
				<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>
				
				<!--
				    Generate macro to specify document class options.
				-->
				<xsl-out:template name="setup-class-options">
					<xsl-out:text>
\def\LaTeXOptions{</xsl-out:text>
                    <xsl-out:value-of select="string-join((
                        if (@latex-font-size) then @latex-font-size else '12pt',
                        if (@latex-paper-size) then @latex-paper-size else 'a4paper',
                        @latex-class-options), ',')" />
				    <xsl-out:text>}
</xsl-out:text>
				</xsl-out:template>

				<!-- *** (Xe)LaTeX Source Output *** -->
				
				<xsl-out:template match="/document">
					<xsl-out:choose>

						<!-- standalone = "yes" means generate an entire valid (Xe)LaTeX source document. -->
						<xsl-out:when test="$standalone eq 'yes'">
							<xsl-out:text>
% THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT!

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

% Set up paper variables, if applicable.
\makeatletter
\@ifpackageloaded{lecturecommon}{\input{</xsl-out:text><xsl-out:value-of select="$paper-include-path" /><xsl-out:text>/</xsl-out:text><xsl-out:value-of select="$latex-initialisation-file" /><xsl-out:text>}}
\makeatother

% Avoid option clash if document class already loaded it.
\makeatletter
\@ifpackageloaded{geometry}{}{\usepackage[margin=1in]{geometry}}
\makeatother

\usepackage{multirow}
\usepackage{longtable}
\usepackage{graphicx}
\usepackage{verbatim}           % needed for \verbatiminput
\usepackage{relalg}             % needed for join operators
\usepackage{pifont}
\usepackage[mode=text]{siunitx} % number and SI unit formatting ([mode=text] needed to make it use the correct
                                % maths typeface under Unicode/fontspec, otherwise it uses Computer Modern. Works
                                % fine in non-Unicode regardless.)
\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.
\usepackage{microtype}          % For better typesetting in general.

\makeatletter
\@ifpackageloaded{amsmath}{}{\usepackage{amsmath}}
\makeatother

</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 commonly used 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}

</xsl-out:text>

                            <xsl-out:choose>
                                <xsl-out:when test="@latex-document-class eq 'lectureassignment'">
                                    <xsl-out:text>\SetAssignmentNumber{</xsl-out:text>
                                    <xsl-out:value-of select="@sequence-number" />
                                    <xsl-out:text>}</xsl-out:text>
							        <xsl-out:call-template name="newline-internal" />
                                </xsl-out:when>
                                <xsl-out:when test="@latex-document-class eq 'lectureworksheet'">
                                    <xsl-out:text>\SetWeekNumber{</xsl-out:text>
                                    <xsl-out:value-of select="@sequence-number" />
                                    <xsl-out:text>}</xsl-out:text>
							        <xsl-out:call-template name="newline-internal" />
                                </xsl-out:when>
                                <xsl-out:otherwise />
                            </xsl-out:choose>

							<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 not(@suppress-latex-title = ('yes', 'y', 'true', 't', '1'))">
                                <xsl-out:text>
	\maketitle
</xsl-out:text>
                            </xsl-out:if>
                            <!--
                                Note that the generate-latex-toc attribute doesn't override anything that the document class does. If the document class generates a table of contents anyway, the value of the attribute is irrelevant.
                            -->
                            <xsl-out:if test="@generate-latex-toc eq 'yes'">
                                <xsl-out:text>
	\tableofcontents
</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 not(@auto-latex-build-date = ('no', 'n', 'false', 'f', '0'))">
							
								<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>
						
						<!-- standalone = "no" means generate a (Xe)LaTeX source fragment. -->
						<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 not(@auto-latex-build-date = ('no', 'n', 'false', 'f', '0'))">
								<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>
	

</xsl:stylesheet>
 \lstloadlanguages{Oracle}
 \lstset{basicstyle=\ttfamily,basewidth=0.5em,escapeinside={(@}{@)},
 	showspaces=false,showstringspaces=false}
+% Length for tracking paragraph width so that we can draw borders (frames)
+% to the correct width.
+\newlength{\parwidth}
+\setlength{\parwidth}{\textwidth}
 </xsl-out:text>
                             <xsl-out:choose>
                                 <xsl-out:when test="@latex-document-class eq 'lectureassignment'">

Show line notes below