Newer
Older
XML / format-master.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- This will mostly be a list of element names to match, along with the corresponding HTML and LaTeX handling XSLT code. -->
<stylesheet	xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
			xmlns:xs="http://www.w3.org/2001/XMLSchema">

	<!--
		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).
	-->
	<include href="modules/global-elements.xml" />
	
	<!-- Output a string containing the date that the document was last built. -->
	<include href="modules/build-date.xml" />

	<!-- Basic page layout elements: paragraphs, page breask, etc. -->
	<include href="modules/basic-page-elements.xml" />

	<!-- Special characters. -->
	<include href="modules/special-characters.xml" />

	<!-- Greek characters. -->
	<include href="modules/greek-characters.xml" />

	<!-- Miscellaneous symbols. -->
	<include href="modules/miscellaneous-symbols.xml" />

	<!-- Emoticons. -->
	<include href="modules/emoticons.xml" />

	<!-- Mathematical operators and symbols. -->
	<include href="modules/mathematical-symbols.xml" />

	<!-- Relational algebra operators. -->
	<include href="modules/relational-algebra.xml" />

	<template name="LaTeX" match="LaTeX|latex">
		<common formats="/latex/xelatex/">{\LaTeX}</common>
		<common formats="/html/xhtml/">L<sup>A</sup>T<sub>E</sub>X</common>
	</template>

	<template name="LaTeX-strip" match="LaTeX|latex" mode="strip">
		<common formats="/html/xhtml/">LaTeX</common>
	</template>

	<!-- In-text "menus", e.g., for displaying things like Windows Start Menu items. -->
	<include href="modules/menus.xml" />

	<!-- Special styles -->
	<template name="emph" match="emph|em">
		<common formats="/latex/xelatex/">\emph{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><em><xsl:apply-templates /></em></common>
	</template>
	<!--
		Emphasis inside answers needs to be handled specially in HTML, as
		it doesn't just flip-flop automatically like it does in LaTeX.
	-->
	<template name="emph-in-answer" match="answer//emph|answer//em">
		<common formats="/latex/xelatex/">\emph{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><strong><xsl:apply-templates /></strong></common>
	</template>
	<template name="italic" match="italic">
		<common formats="/latex/xelatex/">\textit{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><i><xsl:apply-templates /></i></common>
	</template>
	<template name="strong" match="strong">
		<common formats="/latex/xelatex/">\textbf{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><strong><xsl:apply-templates /></strong></common>
	</template>
	<template name="bold" match="bold">
		<common formats="/latex/xelatex/">\textbf{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><b><xsl:apply-templates /></b></common>
	</template>
	<template name="underline" match="underline|u">
		<common formats="/latex/xelatex/">\underline{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><span style="text-decoration: underline;"><xsl:apply-templates /></span></common>
	</template>
	<template name="term" match="term">
		<common formats="/latex/xelatex/">\term{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><i class="term"><xsl:apply-templates /></i></common>
	</template>
	<template name="foreign" match="foreign">
		<common formats="/latex/xelatex/">\foreign{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><i class="foreign"><xsl:apply-templates /></i></common>
	</template>
	<template name="code" match="code">
		<!-- <latex>\code{<xsl:apply-templates />}</latex> -->
		<!-- Using \verb is quite handy because things like underscores don't bother it.  However, it seems it can't be used inside hyperlinks.   Maybe create another template that just does a \texttt on the contents? -->
		<!-- OK, but then we need an <underscore> element to stop them from freaking LaTeX out. -->
		<common formats="/latex/xelatex/">\verb`<xsl:apply-templates />`</common>
		<common formats="/html/xhtml/"><code><xsl:apply-templates /></code></common>
	</template>

	<template name="typewriter" match="typewriter|monospace|tt">
		<common formats="/latex/xelatex/">\texttt{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><tt><xsl:apply-templates /></tt></common>
	</template>
	
	<template name="sans-serif" match="sans-serif|sans|ss|sf">
		<common formats="/latex/xelatex/">\textsf{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><font face="sans-serif"><xsl:apply-templates /></font></common>
	</template>
	
	<!-- Non-maths super- and subscript. -->
	<template name="superscript" match="superscript">
		<common formats="/latex/xelatex/">\ensuremath{^{\mathrm{<xsl:apply-templates />}}}</common>
		<common formats="/html/xhtml/"><sup><xsl:apply-templates /></sup></common>
	</template>
	
	<template name="subscript" match="subscript">
		<common formats="/latex/xelatex/">\ensuremath{_{\mathrm{<xsl:apply-templates />}}}</common>
		<common formats="/html/xhtml/"><sub><xsl:apply-templates /></sub></common>
	</template>
	
	<!--
		Font sizing, using relative font size elements borrowed from
		LaTeX. Note that we use CSS relative font sizes (smaller and
		larger), which means that we have to string a bunch of them
		together to achieve the same effect as a single command in
		LaTeX. We can't use absolute sizes in CSS as they would probably
		look different on different machines.
	-->
	<template name="tiny" match="tiny">
		<common formats="/latex/xelatex/">{\tiny <xsl:apply-templates />}</common>
		<common formats="/html/xhtml/">
			<span style="font-size:smaller;">
			<span style="font-size:smaller;">
			<span style="font-size:smaller;">
			<span style="font-size:smaller;">
			<xsl:apply-templates />
			</span>
			</span>
			</span>
			</span>
		</common>
	</template>
	
	<template name="scriptsize" match="scriptsize">
		<common formats="/latex/xelatex/">{\scriptsize <xsl:apply-templates />}</common>
		<common formats="/html/xhtml/">
			<span style="font-size:smaller;">
			<span style="font-size:smaller;">
			<span style="font-size:smaller;">
			<xsl:apply-templates />
			</span>
			</span>
			</span>
		</common>
	</template>
	
	<template name="footnotesize" match="footnotesize">
		<common formats="/latex/xelatex/">{\footnotesize <xsl:apply-templates />}</common>
		<common formats="/html/xhtml/">
			<span style="font-size:smaller;">
			<span style="font-size:smaller;">
			<xsl:apply-templates />
			</span>
			</span>
		</common>
	</template>
	
	<template name="small" match="small">
		<common formats="/latex/xelatex/">{\small <xsl:apply-templates />}</common>
		<common formats="/html/xhtml/">
			<span style="font-size:smaller;">
			<xsl:apply-templates />
			</span>
		</common>
	</template>
	
	<template name="large" match="large">
		<common formats="/latex/xelatex/">{\large <xsl:apply-templates />}</common>
		<common formats="/html/xhtml/">
			<span style="font-size:larger;">
			<xsl:apply-templates />
			</span>
		</common>
	</template>
	
	<!-- Fortunately, XML is case-sensitive. -->
	<template name="Large" match="Large">
		<common formats="/latex/xelatex/">{\Large <xsl:apply-templates />}</common>
		<common formats="/html/xhtml/">
			<span style="font-size:larger;">
			<span style="font-size:larger;">
			<xsl:apply-templates />
			</span>
			</span>
		</common>
	</template>
	
	<template name="LARGE" match="LARGE">
		<common formats="/latex/xelatex/">{\LARGE <xsl:apply-templates />}</common>
		<common formats="/html/xhtml/">
			<span style="font-size:larger;">
			<span style="font-size:larger;">
			<span style="font-size:larger;">
			<xsl:apply-templates />
			</span>
			</span>
			</span>
		</common>
	</template>
	
	<template name="huge" match="huge">
		<common formats="/latex/xelatex/">{\huge <xsl:apply-templates />}</common>
		<common formats="/html/xhtml/">
			<span style="font-size:larger;">
			<span style="font-size:larger;">
			<span style="font-size:larger;">
			<span style="font-size:larger;">
			<xsl:apply-templates />
			</span>
			</span>
			</span>
			</span>
		</common>
	</template>
	
	<template name="Huge" match="Huge">
		<common formats="/latex/xelatex/">{\Huge <xsl:apply-templates />}</common>
		<common formats="/html/xhtml/">
			<span style="font-size:larger;">
			<span style="font-size:larger;">
			<span style="font-size:larger;">
			<span style="font-size:larger;">
			<span style="font-size:larger;">
			<xsl:apply-templates />
			</span>
			</span>
			</span>
			</span>
			</span>
		</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/">\mbox{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><xsl:apply-templates /></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??
		
		@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)">
					\vskip\baselineskip
				</xsl:when>
				<xsl:when test="@size='small'">
					\smallskip
				</xsl:when>
				<xsl:when test="@size='medium'">
					\medskip
				</xsl:when>
				<xsl:when test="@size='large'">
					\bigskip
				</xsl:when>
				<xsl:when test="@size='fill'">
					\vfill
				</xsl:when>
				<xsl:otherwise>
					\vskip<xsl:value-of select="@size" />
				</xsl:otherwise>
			</xsl:choose>
		</common>
		<!-- For the moment we'll just throw in a BR :) -->
		<common formats="/html/xhtml/"><br clear="left" /></common>
	</template>
	

	<!-- We can decide later whether to use plain verbatim or listings. -->
	<template name="code-block" match="code-block">
		<common formats="/latex/xelatex/">
			<xsl:call-template name="newline-internal" />
			<!-- If the code-block specifies "allow-breaks='no'", wrap the verbatim inside a minipage to avoid page breaks within the code. -->
			<xsl:if test="@allow-breaks = 'no'">
				<xsl:text>\vskip\baselineskip</xsl:text>
				<xsl:call-template name="newline-internal" />
				<xsl:text>\begin{minipage}{\textwidth}</xsl:text>
				<xsl:call-template name="newline-internal" />
			</xsl:if>
			<xsl:text>\begin{verbatim}</xsl:text>
			<xsl:apply-templates />
			<xsl:text>\end{verbatim}</xsl:text>
			<xsl:call-template name="newline-internal" />
			<xsl:if test="@allow-breaks = 'no'">
				<xsl:text>\end{minipage}</xsl:text>
				<xsl:call-template name="newline-internal" />
				<xsl:text>\vskip\baselineskip</xsl:text>
				<xsl:call-template name="newline-internal" />
			</xsl:if>
			<xsl:call-template name="newline-internal" />
		</common>
		<common formats="/html/xhtml/">
			<pre class="code"><xsl:apply-templates /></pre>
		</common>
	</template>

	<!--
		This is for stuff that should unequivocally be treated verbatim (e.g. problem code).
		I'm pretty sure that previously this was distinguished from "code-block" because it (code-block) used to use listings instead of verbatim.  Now that they're both using verbatim there is probably no need for them both (but we might switch back to using listings for code-block).
	-->
	<template name="verbatim" match="verbatim">
		<common formats="/latex/xelatex/">
			<xsl:call-template name="newline-internal" />
			<xsl:text>\begin{verbatim}</xsl:text>
			<xsl:apply-templates />
			<xsl:text>\end{verbatim}</xsl:text>
			<xsl:call-template name="newline-internal" />
		</common>
		<common formats="/html/xhtml/">
			<pre><xsl:apply-templates /></pre>
		</common>
	</template>

	
	<!--
		Quoted text. Handles nested quotes correctly.
		
		@single: Whether to enclose the text in single or double quotes.
			'yes' => single quotes ('').
			otherwise => double quotes (""). [default]
	-->
	<template name="single-quote" match="quote[@single='yes']|q[@single='yes']">
		<common formats="/latex/xelatex/">`<xsl:apply-templates />'</common>
		<html>
			<xsl:text disable-output-escaping="yes">&amp;lsquo;</xsl:text>
			<xsl:apply-templates />
			<xsl:text disable-output-escaping="yes">&amp;rsquo;</xsl:text>
		</html>
		<xhtml>
			<!-- U+2018 LEFT SINGLE QUOTATION MARK -->
			<xsl:text>‘</xsl:text>
			<xsl:apply-templates />
			<!-- U+2019 RIGHT SINGLE QUOTATION MARK -->
			<xsl:text>’</xsl:text>
		</xhtml>
	</template>
	<template name="double-quote" match="quote|qq">
		<common formats="/latex/xelatex/">``<xsl:apply-templates />''</common>
		<html>
			<xsl:text disable-output-escaping="yes">&amp;ldquo;</xsl:text>
			<xsl:apply-templates />
			<xsl:text disable-output-escaping="yes">&amp;rdquo;</xsl:text>
		</html>
		<xhtml>
			<!-- U+201C LEFT DOUBLE QUOTATION MARK -->
			<xsl:text>“</xsl:text>
			<xsl:apply-templates />
			<!-- U+201D RIGHT DOUBLE QUOTATION MARK -->
			<xsl:text>”</xsl:text>
		</xhtml>
	</template>
	<!--
		With nested quotes, we need to figure out what depth of nesting
		we're at, then call the appropriate template depending on
		the initial quoting style (single or double).
	-->
	<template name="nested-double-quote" match="quote//quote">
		<common>
			<xsl:choose>
				<xsl:when test="(count(ancestor::quote) mod 2) = 0">
					<xsl:call-template name="double-quote" />
				</xsl:when>
				<xsl:otherwise>
					<xsl:call-template name="single-quote" />
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>
	<template name="nested-single-quote" match="quote[@single='yes']//quote" priority="2">
		<common>
			<xsl:choose>
				<xsl:when test="(count(ancestor::quote) mod 2) = 0">
					<xsl:call-template name="single-quote" />
				</xsl:when>
				<xsl:otherwise>
					<xsl:call-template name="double-quote" />
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>


	<!-- Environments (in the LaTeX terminology): enumerated, ordered, and numbered lists. -->
	<!-- Note the lack of orthgonality that means that elements other than <item> are ignored. -->
	<!-- TODO: Use just xsl:apply-templates and instead of using modes, check inside the item template what the parent is? -->

	<!-- Unordered lists -->
	
	<template name="itemised-list" match="itemised-list|itemize|unordered-list|bulleted-list|bullet-list|bullet-points|UL|ul">
		<common formats="/latex/xelatex/">
			\begin{itemize}
				<xsl:apply-templates select="item" mode="normal" />
			\end{itemize}
			
		</common>
		<common formats="/html/xhtml/">
			<ul>
				<xsl:apply-templates select="item" mode="normal" />
			</ul>
		</common>
	</template>
	

	<!--
		Ordered lists.
		
		@start: The starting number for the list. [default 1]
	-->
	
	<template name="enumerated-list" match="enumerated-list|enumerate|ordered-list|numbered-list|question-list|OL|ol">
		<common formats="/latex/xelatex/">
			\begin{enumerate}
				<xsl:if test='@start'>
					<!--
						Set the appropriate enum counter according to the depth. Use the format attribute of xsl:number to output it in Roman numerals. Depth must be at least 1 (enumi) and at most 4 (enumiv). Bizarrely, a count(ancestor::xxx) here gives 0 for the outermost element, whereas for section elements it gives 1?!?!
					-->
					<xsl:text>\setcounter{enum</xsl:text>
					<xsl:number value="min( ( 1 + count( ancestor::enumerated-list|ancestor::enumerate|ancestor::ordered-list|ancestor::numbered-list|ancestor::question-list|ancestor::OL|ancestor::ol ), 4 ) )" format="i" />
					<xsl:text>}{</xsl:text>
					<!-- Remember that LaTeX adds 1 to the counter before using it. -->
					<xsl:value-of select="@start - 1" />
					<xsl:text>}</xsl:text>
				</xsl:if>
				<xsl:apply-templates select="item" mode="enumerated-list" />
			\end{enumerate}
			
		</common>
		<common formats="/html/xhtml/">
			<ol>
				<xsl:if test="@start">
					<!--
						Note that we're using the START attribute of OL, which is actually deprecated in HTML 4 and XHTML. However, the alternative (using CSS styling) is useless, as it doesn't permit different number formatting for different levels of list (e.g., 1., a., ii., etc.). The only standards-compliant solution to this is to forgo HTML list elements completely and do it all ourselves. Ugh, no thanks!
					-->
					<xsl:attribute name="start">
						<xsl:value-of select="@start" />
					</xsl:attribute>
				</xsl:if>
				<xsl:apply-templates select="item" mode="enumerated-list" />
			</ol>
		</common>
	</template>
	
	
	<!-- Definition or description lists. -->
	<template name="definition-list" match="definition-list|description-list|DL|dl">
		<common formats="/latex/xelatex/">
			\begin{description}
				<xsl:apply-templates select="item" mode="definition-list" />
			\end{description}
			
		</common>
		<common formats="/html/xhtml/">
			<!--
				<dl>s in HTML tend to come out with the spacing a bit wrong (or maybe it's just my browser?). Anyway, they don't appear to be displayed correctly. A more portable solution is to use plain <p>s with CSS margins to control the hanging indent. The tricky part is dealing with embedded <paragraph>s inside the <description-list>. The clever details are handled in the "definition-item" template.
			-->
			<xsl:apply-templates select="item" mode="definition-list" />
		</common>
	</template>


	<!-- List elements -->
	<template name="list-item" match="item" mode="normal">
		<common formats="/latex/xelatex/"><xsl:text>\item </xsl:text><xsl:apply-templates /></common>
		<common formats="/html/xhtml/">
			<xsl:choose>
				<!--
					Check whether there are actual paragraphs or things that
					should be treated like paragraphs inside the item. If so,
					let them worry about inserting the <p> tags.
				-->
				<xsl:when test="count(paragraph|para|p|question|answer|code-block) != 0">
					<li><xsl:apply-templates /></li>
				</xsl:when>
				<!--
					Otherwise, insert <p> tags surrounding the item content
					so that the item spacing looks OK.
				-->
				<xsl:otherwise>
					<li><p><xsl:apply-templates /></p></li>
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>
	
	<!--
		Provide the ability to set the numbering of specific items in enumerated lists. Results could be unpredictable if this is applied to an itemised list!
		
		@value: the number to use for the next list item. [default 1]
	-->
	<template name="enumerated-item-value" match="item[@value]" mode="enumerated-list">
		<common formats="/latex/xelatex/">
			<!-- Set the appropriate enum counter. -->
			<xsl:text>\setcounter{enum</xsl:text>
			<xsl:number value="min( ( count( ancestor::enumerated-list|ancestor::enumerate|ancestor::ordered-list|ancestor::numbered-list|ancestor::question-list|ancestor::OL|ancestor::ol ), 4 ) )" format="i" />
			<xsl:text>}{</xsl:text>
			<!-- Remember that LaTeX adds 1 to the counter before using it. -->
			<xsl:value-of select="@value - 1" />
			<xsl:text>}</xsl:text>
			<xsl:apply-templates select="." mode="normal" />
		</common>
		<!--
			Unfortunately this can't just be a wrapper around the "normal" item template because of the nesting of attributes inside the element.
		-->
		<common formats="/html/xhtml/">
			<xsl:choose>
				<!--
					Check whether there are actual paragraphs or things that
					should be treated like paragraphs inside the item. If so,
					let them worry about inserting the <p> tags.
				-->
				<xsl:when test="count(paragraph|para|p|question|answer|code-block) != 0">
					<li>
						<xsl:attribute name="value" select="@value" />
						<xsl:apply-templates />
					</li>
				</xsl:when>
				<!--
					Otherwise, insert <p> tags surrounding the item content
					so that the item spacing looks OK.
				-->
				<xsl:otherwise>
					<li>
						<xsl:attribute name="value" select="@value" />
						<p><xsl:apply-templates /></p>
					</li>
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>

	<template name="enumerated-item" match="item[not( @value )]" mode="enumerated-list">
		<common>
			<xsl:apply-templates select="." mode="normal" />
		</common>
	</template>
	

	<template name="definition-item" match="item" mode="definition-list">
		<common formats="/latex/xelatex/">
			<xsl:text>\item[</xsl:text>
			<xsl:apply-templates select="keyword|term|topic|DT|dt" />
			<xsl:text>] </xsl:text>
			<xsl:apply-templates select="definition|description|discourse|DD|dd" />
		</common>
		<common formats="/html/xhtml/">
			<!--
				We have to be a little clever here, because we're
				transforming potentially multiple embedded elements
				(embedded <paragraph>s in particular) into one or more
				<p> tags in the HTML. We need to ensure that:
				
					(a) we don't end up with nested <p> tags,
					    
					(b) all paragraphs are correctly indented, and
					
					(c) if the first thing following the <definition>
						is a <paragraph> or text node, it gets
						positioned correctly relative to the <keyword>.

				We know that the <keyword> won't have embedded
				<paragraph>s (it doesn't really make sense, not that we
				actually check :)  The only thing we therefore need to
				check for is <paragraph> elements inside the
				<definition> element.
			-->
			<xsl:choose>
				<!--
					If the first sub-node of the <definition> is NOT a
					<p> node, then the whole thing should be just simple
					text and contain only basic formatting elements, if
					anything (i.e., no lists!). We therefore just wrap
					the <keyword> and <definition> within a <p> with a
					hanging indent and finish. Note the use of
					child::node[1|2], because we don't necessarily know
					what variants of <keyword> and <definition> have
					actually been used, but we know that they will
					(should!) always be the first and second children of
					the <item> respectively.
					
					This probably is the most common case, so test for
					it first.
				-->
				<xsl:when test="not(child::node()[2]/child::node()[1][self::p] or child::node()[2]/child::node()[1][self::paragraph])">
					<p class="definition1">
						<xsl:apply-templates select="child::node()[1]" />
						<xsl:text> </xsl:text>
						<xsl:apply-templates select="child::node()[2]" />
					</p>
				</xsl:when>
				<!--
					If the first sub-node of the <definition> IS a <p>
					or <paragraph>, then we need to skip over the
					processing of this element to avoid nested <p>s in
					the output. Any remaining sub-nodes are processed
					normally, except that we pass in the HTMLStyle
					parameter to ensure that any remaining paragraph
					elements are correctly indented. I would have used
					modes for this, but it killed embedded <itemize>s,
					because there isn't an <itemize> template with the
					appropriate mode (nor is there a need for one). Grr.
				-->
				<xsl:otherwise>
					<p class="definition1">
						<xsl:apply-templates select="child::node()[1]" />
						<xsl:text> </xsl:text>
						<xsl:apply-templates select="child::node()[2]/child::node()[1]/node()" />
					</p>
					<xsl:apply-templates select="child::node()[2]/*[position() > 1]">
						<xsl:with-param name="HTMLStyle">definition2</xsl:with-param>
					</xsl:apply-templates>
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>
	
	<!--
		Need to provide some context here as, e.g., <term> is also
		a standalone element.
	-->
	<template name="keyword" match="item/keyword|item/term|item/topic|item/DT|item/dt">
		<common formats="/latex/xelatex/"><xsl:apply-templates /></common>
		<common formats="/html/xhtml/"><strong><xsl:apply-templates /></strong></common>
	</template>
	
	
	<!--
		Need to provide some context here as, e.g., <description> is also used within <image>.
	-->
	<template name="definition" match="item/definition|item/description|item/discourse|item/DD|item/dd">
		<common><xsl:apply-templates /></common>
	</template>


	<!--
		Question text. This only exists so that we can ensure that appropriate
		<p> tags are correctly inserted. If this template didn't exist, showing
		the answers would generate invalid HTML. The answers are enclosed in a
		<div class="answer">...</div>. Without this template, the answer markup
		ends up embedded inside <p>...</p>, which is invalid.
	-->
	<template name="question" match="question">
		<common formats="/latex/xelatex/"><xsl:apply-templates /></common>
		<common formats="/html/xhtml/">
			<xsl:choose>
				<!--
					Check whether there are actual paragraphs inside the
					question. If so, let them worry about inserting the
					<p> tags.
				-->
				<xsl:when test="count(paragraph|para|p|question|answer|code-block) != 0">
					<xsl:apply-templates />
				</xsl:when>
				<!--
					Otherwise, insert <p> tags surrounding the question content.
				-->
				<xsl:otherwise>
					<p><xsl:apply-templates /></p>
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>

	
	<!--
		Sample answers, which may optionally be excluded from the
		output. This can be done globally for all answers by setting the
		style sheet parameter $showanswers to "no", or it can be done
		locally on a question-by-question basis by setting the @hide
		attribute of the element to "yes".
		
		@hide: If "yes", don't include this answer in the output stream.
		The default is to include the answer.
	-->
	<template name="answer" match="answer">
		<common formats="/latex/xelatex/">
			<!--
				It's nice to weed out the sample answer markup at the XSLT processing stage to make LaTeX run faster.
				Note that \showanswers still needs to be called so that LaTeX can format chapter headings like "Answers for ..."
			-->
			<xsl:if test="$showanswers='yes'">
			\begin{answer}
				<xsl:apply-templates />
			\end{answer}

			</xsl:if>
		</common>
		<common formats="/html/xhtml/">
			<xsl:if test="$showanswers='yes'">
				<div class="answer">
					<xsl:apply-templates />
				</div>
			</xsl:if>
		</common>
	</template>
	
	<!--
		Match hidden answers and do nothing.
	-->
	<template name="hidden-answer" match="answer[@hide='yes']" />

	
	<!--
		Sections, subsections, subsubsections, ...
		
		@label: A label that can be used for cross referencing. Any value can be used, as long as it's a legal identifier in both LaTeX and HTML.
		
		@number: Whether or not to generate a section number. It makes the most logical sense for this attribute to be associated with the section element, but the section numbers are actually generated in the "section-title" template (see below). Consequently, this attribute isn't even mentioned in this template.
			'yes'	[default]
			'no'
	-->
	<template name="section" match="section">
		<common formats="/latex/xelatex/">
			<xsl:apply-templates>
				<xsl:with-param name="label">
					<xsl:value-of select="@label" />
					<xsl:if test="not(@label)">THERE_IS_NO_LABEL</xsl:if>
				</xsl:with-param>
			</xsl:apply-templates>
		</common>
		<common formats="/html/xhtml/">
			<xsl:if test="@label"><a id="{@label}"></a></xsl:if>
			<xsl:apply-templates />
		</common>
	</template>
	
	
	<!-- Footnotes. -->
	<template name="footnote" match="footnote">
		<common formats="/latex/xelatex/">\footnote{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/">
			<a>
				<xsl:attribute name="name">
					<xsl:text>footnote-</xsl:text>
					<xsl:number level="any" count="footnote" />
					<xsl:text>-source</xsl:text>
				</xsl:attribute>
				<xsl:attribute name="href">
					<xsl:text>#footnote-</xsl:text>
					<xsl:number level="any" count="footnote" />
					<xsl:text>-target</xsl:text>
				</xsl:attribute>
				<xsl:text>[</xsl:text>
				<xsl:number level="any" count="footnote" />
				<xsl:text>]</xsl:text>
			</a>
		</common>
	</template>

	<!-- This is only required for HTML, as LaTeX does it all for you. -->
	<template name="footnote-list" match="footnote" mode="list">
		<common formats="/html/xhtml/">
			<p>
				<a>
					<xsl:attribute name="name">
						<xsl:text>footnote-</xsl:text>
						<xsl:number level="any" count="footnote" />
						<xsl:text>-target</xsl:text>
					</xsl:attribute>
					<sup>
						<xsl:text>[</xsl:text>
						<xsl:number level="any" count="footnote" />
						<xsl:text>]</xsl:text>
					</sup>
				</a>
				<xsl:text> </xsl:text>
				<xsl:apply-templates />
				<xsl:text> </xsl:text>
				<!-- Provide a back link to the original footnote marker. -->
				<a>
					<xsl:attribute name="href">
						<xsl:text>#footnote-</xsl:text>
						<xsl:number level="any" count="footnote" />
						<xsl:text>-source</xsl:text>
					</xsl:attribute>
					<xsl:text>[Back]</xsl:text>
				</a>
			</p>
		</common>
	</template>

	
	<!-- Document preamble stuff: title, author, date. -->
	<template name="preamble-title" match="document/title" mode="preamble">
		<common formats="/latex/xelatex/">
			<xsl:text>\title{</xsl:text>
			<xsl:if test="/document/@class = 'assignment'">
				<xsl:if test="$showanswers='yes'">Sample Solution for </xsl:if>
				<xsl:call-template name="PaperCode" />
				<xsl:text> Assignment </xsl:text>
				<xsl:value-of select="/document/@sequence-number" />
				<xsl:text>: \\</xsl:text>
			</xsl:if>
			<xsl:apply-templates />
			<xsl:text>}</xsl:text>
		</common>
		<!--
			For HTML, strip out any raw HTML formatting (e.g., emphasis), as this is not interpreted within the <title> tag, resulting in raw HTML markup in the window title. Ick. We do this by switching to "strip" mode.
		-->
		<common formats="/html/xhtml/">
			<xsl:if test="( /document/@class = 'tutorial' ) or ( /document/@class = 'laboratory' ) or ( /document/@class = 'assignment' )">
				<xsl:if test="$showanswers='yes'">
					<xsl:choose>
						<xsl:when test="( /document/@class = 'tutorial' ) or ( /document/@class = 'laboratory' )">
							<xsl:text>Selected Answers for </xsl:text>
						</xsl:when>
						<xsl:when test="/document/@class = 'assignment'">
							<xsl:text>Sample Solution for </xsl:text>
						</xsl:when>
					</xsl:choose>
				</xsl:if>
				<xsl:call-template name="PaperCode" />
				<xsl:choose>
					<xsl:when test="/document/@class = 'tutorial'">
						<xsl:text> Tutorial </xsl:text>
					</xsl:when>
					<xsl:when test="/document/@class = 'laboratory'">
						<xsl:text> Lab </xsl:text>
					</xsl:when>
					<xsl:when test="/document/@class = 'assignment'">
						<xsl:text> Assignment </xsl:text>
					</xsl:when>
				</xsl:choose>
				<xsl:value-of select="/document/@sequence-number" />
				<xsl:text>: </xsl:text>
			</xsl:if>
			<xsl:apply-templates mode="strip" />
		</common>
	</template>

	<template name="preamble-author" match="document/author" mode="preamble">
		<common formats="/latex/xelatex/">\author{<xsl:apply-templates />}</common>
	</template>

	<template name="preamble-date" match="document/date" mode="preamble">
		<common formats="/latex/xelatex/">\date{<xsl:apply-templates />}</common>
	</template>

	<template name="document-title" match="document/title">
		<!-- Need to do something sensible for LaTeX here. -->
		<common formats="/latex/xelatex/">
			<!--
				Under the LaTeX framework, the rest of the chapter title text is generated by LaTeX macros, so this is pretty simple.
				I think this is broken?
				
				In fact, I think that for LaTeX documents, this template isn't called at all?? Looking at xml2xslt.xsl, if the document's standalone, "preamble-title" is used, and otherwise, "chapter-title" is used.
			-->
			<xsl:if test="/document/@standalone = 'yes'"><xsl:apply-templates /></xsl:if>
		</common>
		<common formats="/html/xhtml/">
			<h1>
				<xsl:if test="( /document/@class = 'tutorial' ) or ( /document/@class = 'laboratory' ) or ( /document/@class = 'assignment' )">
					<xsl:if test="$showanswers='yes'">
						<xsl:choose>
							<xsl:when test="( /document/@class = 'tutorial' ) or ( /document/@class = 'laboratory' )">
								<xsl:text>Selected Answers for </xsl:text>
							</xsl:when>
							<xsl:when test="/document/@class = 'assignment'">
								<xsl:text>Sample Solution for </xsl:text>
							</xsl:when>
						</xsl:choose>
					</xsl:if>
					<xsl:call-template name="PaperCode" />
					<xsl:choose>
						<xsl:when test="/document/@class = 'tutorial'">
							<xsl:text> Tutorial </xsl:text>
						</xsl:when>
						<xsl:when test="/document/@class = 'laboratory'">
							<xsl:text> Lab </xsl:text>
						</xsl:when>
						<xsl:when test="/document/@class = 'assignment'">
							<xsl:text> Assignment </xsl:text>
						</xsl:when>
					</xsl:choose>
					<xsl:value-of select="/document/@sequence-number" />
					<xsl:text>: </xsl:text>
				</xsl:if>
				<xsl:apply-templates />
			</h1>
		</common>
	</template>

	<!--
		New template for tutorials and labs, which are essentially chapters when included in a course book, but are marked up as documents in themselves.
	-->
	<template name="chapter-title" match="document/title" mode="chapter">
		<!--
			TODO: For LaTeX, filling in the "INFO XXX Tutorial", etc., is currently done in the LaTeX layer in the infrastructure surrounding the \lab and \tutorial macros (i.e., it's magic). This derives from the historical origins of the handbook, and should be moved here for consistency. An initial attempt to just replace calls to \tutorial, etc., with \chapter didn't work properly, as these macros do other things as well, including internal munging of chapter handling. This Will Be Complicated :(.
		-->
		<common formats="/latex/xelatex/">
			<xsl:choose>
				<xsl:when test="/document/@class = 'tutorial'">
					<xsl:text>\tutorial{</xsl:text>
				</xsl:when>
				<xsl:when test="/document/@class = 'laboratory'">
					<xsl:text>\lab{</xsl:text>
				</xsl:when>
				<xsl:otherwise>
					<!-- maybe we should assume that we're in a book documentclass and issue a \chapter here? -->
					<xsl:text>\general{</xsl:text>
				</xsl:otherwise>
			</xsl:choose>
			<xsl:apply-templates />
			<xsl:text>}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<xsl:choose>
				<xsl:when test="/document/@class = 'tutorial'">
					<h1><xsl:call-template name="PaperCode" /> Tutorial <xsl:value-of select="/document/@sequence-number" /><xsl:if test="$showanswers='yes'"> Sample Answers</xsl:if>: <br /><xsl:apply-templates /></h1>
				</xsl:when>
				<xsl:when test="/document/@class = 'laboratory'">
					<h1><xsl:call-template name="PaperCode" /> Lab <xsl:value-of select="/document/@sequence-number" /><xsl:if test="$showanswers='yes'"> Sample Answers</xsl:if>: <br /><xsl:apply-templates /></h1>
				</xsl:when>
				<xsl:otherwise>
					<h1><xsl:apply-templates /></h1>
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>
	
	<template name="document-author" match="document/author">
		<common formats="/html/xhtml/"><p><xsl:apply-templates /></p></common>
	</template>
	
	<template name="document-date" match="document/date" />

	<!--
		Generate some number of "sub"s so we can produce, e.g., "subsubsection" for LaTeX.
		
		$depth: the number of repetitions (0 to 2, which maps to 1 to 3 below due to counting ancestor section elements coming out one more than expected).
	-->
	<template name="generate-subs">
		<common formats="/latex/xelatex/">
			<xsl:param name="depth">1</xsl:param>
			<xsl:if test="$depth &gt; 1">
				<xsl:if test="$depth &lt; 4">
					<xsl:text>sub</xsl:text>
				</xsl:if>
				<xsl:call-template name="generate-subs">
					<xsl:with-param name="depth" select="$depth - 1" />
				</xsl:call-template>
			</xsl:if>
		</common>
	</template>
	
	<!--
		Generate section title with nested numbering, e.g., 1.1.3.
	-->
	<template name="section-title" match="section/title">
		<common formats="/latex/xelatex/">
			<xsl:param name="label" />
			<xsl:text>\</xsl:text>
			<!-- Generate the correct number of "sub"s for LaTeX. -->
			<xsl:call-template name="generate-subs">
				<xsl:with-param name="depth" select="count( ancestor::section )" />
			</xsl:call-template>
			<xsl:text>section</xsl:text>
			<!--
				Unnumbered section. We reference the @number attribute of the parent section element. (We are guaranteed that the parent is a section element by the match context for this template.)
			-->
			<xsl:if test="../@number = 'no'">
				<xsl:text>*</xsl:text>
			</xsl:if>
			<xsl:text>{</xsl:text>
			<xsl:apply-templates /><xsl:text>}</xsl:text>
			<xsl:if test="$label != 'THERE_IS_NO_LABEL'">
				\label{<xsl:value-of select="$label" />}
			</xsl:if>
		</common>
		<common formats="/html/xhtml/">
			<!-- The depth is used in a couple of places, so we pre-calculate it. -->
			<xsl:variable name="depth">
				<xsl:number value="1 + count(ancestor::section)" />
				<xsl:if test="1 + count(ancestor::section) &gt; 6">6</xsl:if>
			</xsl:variable>
			<xsl:text disable-output-escaping="yes">&lt;h</xsl:text><xsl:number value="$depth" /><xsl:text disable-output-escaping="yes">&gt;</xsl:text>
			<!--
				Unnumbered section, as per above. Note that the sense of the test is reversed: with LaTeX we output _additional_ text to get an unnumbered section, where as with HTML, we _suppress_ the additional text (i.e., the section number, which is generated here). We also only count sections that _are_ numbered.
			-->
			<xsl:if test="not( ../@number ) or ( ../@number != 'no' )">
				<xsl:number count="section[not( @number ) or ( @number != 'no' )]" level="multiple" format="1.1.1.1.1.1" />
				<xsl:text> </xsl:text>
			</xsl:if>
			<xsl:apply-templates />
			<xsl:text disable-output-escaping="yes">&lt;/h</xsl:text><xsl:number value="$depth" /><xsl:text disable-output-escaping="yes">&gt;</xsl:text>
		</common>
	</template>


	<!--
		A quotation.
		
		@align: The alignment of the quotation paragraph.
			'left' [default]
			'center' | 'centre'
			'right'
	-->
	<template name="quotation" match="quotation">
		<common formats="/latex/xelatex/">
			<xsl:choose>
				<xsl:when test="(@align = 'left') or (@align = 'right')">
					<xsl:text>\begin{flush</xsl:text>
					<xsl:value-of select="@align" />
					<xsl:text>}\itshape </xsl:text>
					<xsl:apply-templates />
					<xsl:text>\end{flush</xsl:text>
					<xsl:value-of select="@align" />
					<xsl:text>}</xsl:text>
				</xsl:when>
				<xsl:when test="(@align = 'center') or (@align = 'centre')">
					<xsl:text>\begin{center}\itshape </xsl:text>
					<xsl:apply-templates />
					<xsl:text>\end{center}</xsl:text>
				</xsl:when>
				<xsl:otherwise>
					<xsl:text>\begin{quote}\itshape </xsl:text>
					<xsl:apply-templates />
					<xsl:text>\end{quote}</xsl:text>
				</xsl:otherwise>
			</xsl:choose>
		</common>
		<!-- Nominally we should use <blockquote>, but it doesn't have alignment. -->
		<common formats="/html/xhtml/">
			<p>
				<xsl:if test="@align">
					<xsl:attribute name="align">
						<xsl:value-of select="@align" />
					</xsl:attribute>
				</xsl:if>
				<i><xsl:apply-templates /></i>
			</p>
		</common>
	</template>
	
	
	<!--
		Anything inside a <metadata> is ignored completely. (More
		accurately, we pick bits out of it manually as required; it's
		only ignored by apply-templates.)

		If we move to using attributes of "document" for all metadata, this will become redundant.
	-->
	<template name="metadata" match="metadata">
		<common>
			<xsl:message><xsl:text>Use of metadata element obsolete!</xsl:text></xsl:message>
		</common>
	</template>
	
	
	<!--
		Anything inside an <omit> is also ignored completely.
	-->
	<template name="omit" match="omit" />

	<!--
		...and the legacy id tags inside figures.
	-->
	<template match="figure/id" />
	<template match="figure/label" />

	
	<!--
		Comments are not quite ignored completely, as they're carried through to the output document (kind of: "It is an error if instantiating the content of xsl:comment creates nodes other than text nodes.")
	-->
	<template name="comment" match="comment">
		<common formats="/latex/xelatex/">
			<xsl:text>
\begin{comment}</xsl:text>
				<xsl:apply-templates />
				<xsl:text>\end{comment}
</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<xsl:comment>
				<xsl:apply-templates />
			</xsl:comment>
		</common>
	</template>
	
	
	<!--
		Meta-element for items that are not yet completed.
	-->
	<template name="todo" match="todo|to-do|incomplete|check">
		<common formats="/latex/xelatex/">
			<xsl:text>\fbox{\textbf{!!</xsl:text>
			<xsl:apply-templates />
			<xsl:text>!!}}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<strong style="border: 1px solid black;">!!<xsl:apply-templates />!!</strong>
		</common>
	</template>


	<!--
		Tabular structures (LaTeX {tabular}, HTML <table>).
		
		@align: The alignment of the table as a whole.
			'left' [default]
			'center' | 'centre'
			'right'
		
		@valign (LaTeX only): Vertical alignment of the tabular within
		the paragraph. 
			'top'
			'center' | 'centre' [default]
			'bottom'
		
		@border: Width of cell border for HTML tables.
		
		@scale (LaTeX only): Scaling factor for the tabular.
		
		@rotate (LaTeX only): Rotation angle of tabular in degrees
		anti-clockwise.
	-->
	<template name="tabular" match="tabular">
		<common formats="/latex/xelatex/">
			<!-- spacing -->
			<xsl:text>
			
			</xsl:text>
			
			<!-- Overall tabular alignment. -->
			<xsl:if test="@align">
				<xsl:text>\begin{</xsl:text>
				<xsl:choose>
					<xsl:when test="(@align = 'left') or (@align = 'right')">
						<xsl:text>flush</xsl:text><xsl:value-of select="@align" />
					</xsl:when>
					<xsl:when test="(@align = 'center') or (@align = 'centre')">
						<xsl:text>center</xsl:text>
					</xsl:when>
				</xsl:choose>
				<xsl:text>}</xsl:text>
			</xsl:if>

			<!-- tabular rotation -->
			<xsl:if test="@rotate">
				<xsl:text>\rotatebox{</xsl:text>
				<xsl:value-of select="@rotate" />
				<xsl:text>}{</xsl:text>
			</xsl:if>

			<!-- tabular scaling -->
			<xsl:if test="@scale">
				<xsl:text>\scalebox{</xsl:text>
				<xsl:value-of select="@scale" />
				<xsl:text>}{</xsl:text>
			</xsl:if>

			<xsl:text>\begin{tabular}</xsl:text>
			<!-- vertical alignment -->
			<xsl:if test="@valign = 'top' or @valign = 'bottom'">
				<xsl:text>[</xsl:text>
				<xsl:value-of select="substring(@valign, 1, 1)" />
				<xsl:text>]</xsl:text>
			</xsl:if>
			<xsl:text>{</xsl:text>
			<xsl:apply-templates select="tabular-columns" />
			<xsl:text>}</xsl:text>
				<xsl:apply-templates select="tabular-header" />
				<xsl:apply-templates select="tabular-body" />
				<xsl:apply-templates select="tabular-footer" />
			<xsl:text>\end{tabular}</xsl:text>

			<xsl:if test="@scale"><xsl:text>}</xsl:text></xsl:if>

			<xsl:if test="@rotate"><xsl:text>}</xsl:text></xsl:if>

			<xsl:if test="@align">
				<xsl:text>\end{</xsl:text>
				<xsl:choose>
					<xsl:when test="(@align = 'left') or (@align = 'right')">
						<xsl:text>flush</xsl:text><xsl:value-of select="@align" />
					</xsl:when>
					<xsl:when test="(@align = 'center') or (@align = 'centre')">
						<xsl:text>center</xsl:text>
					</xsl:when>
				</xsl:choose>
				<xsl:text>}</xsl:text>
			</xsl:if>

			<!-- spacing -->
			<xsl:text>

			</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<table>
				<xsl:attribute name="border">
					<xsl:value-of select="@border" />
					<xsl:if test="not(@border)">0</xsl:if>
				</xsl:attribute>
				<xsl:attribute name="cellspacing">0</xsl:attribute>
				<xsl:attribute name="style">
					<xsl:text>border-collapse: collapse; </xsl:text>
					<xsl:choose>
						<xsl:when test="@align='center'">
							<xsl:text>margin-left:auto; margin-right: auto; </xsl:text>
						</xsl:when>
						<xsl:when test="@align='right'">
							<xsl:text>margin-left:auto; </xsl:text>
						</xsl:when>
						<xsl:otherwise />
					</xsl:choose>
				</xsl:attribute>
				<!--
					Note different ordering of tabular components:
					HTML requires THEAD and TFOOT to precede TBODY.
				-->
				<xsl:apply-templates select="tabular-header" />
				<xsl:apply-templates select="tabular-footer" />
				<xsl:apply-templates select="tabular-body" />
			</table>
		</common>
	</template>
	
	<!--
		Specify column formatting, mainly for LaTeX, although
		HTML does get <td> ALIGN values from here.
		
		@align: The alignment of this particular column.
			'left' [default]
			'center' | 'centre'
			'right'
		
		@left-border: Set to '|' to include a column separator to the
		left of this column.

		@right-border: Set to '|' to include a column separator to the
		right of this column.
		
		Careful: including a right-border on a cell and a left-border on
		the next cell will produce '||', not '|'. BUT, when doing
		multi-column or multi-row cells, always include both borders if
		required, because \multicolumn overrides the default border
		specification.
	-->
	<template name="aligned-tabular-column" match="tabular-columns/column[@align]">
		<common formats="/latex/xelatex/">
			<xsl:value-of select="@left-border" />
			<xsl:value-of select="substring(@align, 1, 1)" />
			<xsl:value-of select="@right-border" />
		</common>
	</template>

	<template name="unaligned-tabular-column" match="tabular-columns/column[not(@align)]">
		<common formats="/latex/xelatex/">
			<xsl:value-of select="@left-border" />
			<xsl:text>l</xsl:text>
			<xsl:value-of select="@right-border" />
		</common>
	</template>
	
	<template name="tabular-header" match="tabular-header">
		<common formats="/latex/xelatex/"><xsl:apply-templates /></common>
		<common formats="/html/xhtml/">
			<thead>
				<xsl:apply-templates />
			</thead>
		</common>
	</template>

	<template name="tabular-footer" match="tabular-footer">
		<common formats="/latex/xelatex/"><xsl:apply-templates /></common>
		<common formats="/html/xhtml/">
			<tfoot>
				<xsl:apply-templates />
			</tfoot>
		</common>
	</template>

	<template name="tabular-body" match="tabular-body">
		<common formats="/latex/xelatex/"><xsl:apply-templates /></common>
		<common formats="/html/xhtml/">
			<tbody>
				<xsl:apply-templates />
			</tbody>
		</common>
	</template>

	<!--
		@no-page-break: Inhibit page breaks after this row (LaTeX only).
	-->
	<template name="row" match="row">
		<common formats="/latex/xelatex/">
			<xsl:apply-templates />
			<!-- TODO: Don't put a \\ on the last row of a tabular. -->
			<xsl:text> \\</xsl:text>
			<xsl:if test="@no-page-break = 'yes'">*</xsl:if>
			<xsl:text> </xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<tr>
				<xsl:if test="@valign">
					<xsl:attribute name="valign"><xsl:value-of select="@valign" /></xsl:attribute>
				</xsl:if>
				<xsl:apply-templates />
			</tr>
		</common>
	</template>

	<!--
		Horizontal rules (LaTeX only).
		
		@columns: The column range to draw the rule across. Specify as
		you would for a \cline in LaTeX, e.g., '3-5'. If omitted, the
		rule is drawn across all columns.
		
		@weight: The weight of the rule. Note that double weight isn't
		available for partial rules in LaTeX, because repeated \cline
		macros simply draw over the top of each other.
			'single' [default]
			'double' = a double rule
	-->
	<template name="row-rule-full" match="row-rule[not(@columns)]">
		<common formats="/latex/xelatex/">
			<xsl:text>\hline</xsl:text>
			<xsl:if test="@weight = 'double'"><xsl:text>\hline</xsl:text></xsl:if>
			<xsl:text> </xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<tr>
				<td>
					<xsl:attribute name="style">
						<xsl:text>border-bottom: 1px solid black; </xsl:text>
						<!--
							This is a bit of a hack to get a double border,
							as some browsers don't support the "double" border
							style yet. It looks slightly ugly, but works.
						-->
						<xsl:if test="@weight = 'double'">
							<xsl:text>border-top: 1px solid black; </xsl:text>
						</xsl:if>
					</xsl:attribute>
					<xsl:attribute name="colspan">
						<xsl:value-of select="count(ancestor::tabular/tabular-columns/column)" />
					</xsl:attribute>
				</td>
			</tr>
		</common>
	</template>

	<template name="row-rule-partial" match="row-rule[@columns]">
		<common formats="/latex/xelatex/">
			<!-- Tokenise the column specifications for later reference. -->
			<xsl:variable name="column-specs" select="tokenize(@columns, ',')" />
			<xsl:for-each select="$column-specs">
				<xsl:text>\cline{</xsl:text>
				<xsl:value-of select="." />
				<!-- Normalise the value to a range if necessary. -->
				<xsl:if test="not(contains(., '-'))">
					<xsl:text>-</xsl:text>
					<xsl:value-of select="." />
				</xsl:if>
				<xsl:text>}</xsl:text>
			</xsl:for-each>
		</common>
		<common formats="/html/xhtml/">
			<!-- Tokenise the column specifications for later reference. -->
			<xsl:variable name="column-specs" select="tokenize(@columns, '[-,]')" />
			
			<!--
				We need to store the value of @weight, because the context will
				be changed by the for-each loop below. Default to "single" in
				any case.
			-->
			<xsl:variable name="weight">
				<xsl:value-of select="@weight" />
				<xsl:if test="not(@weight)">
					<xsl:text>single</xsl:text>
				</xsl:if>
			</xsl:variable>
			
			<tr>
				<!--
					Loop through all of the columns in the table, testing to
					see whether the column index exists in $column-specs. If
					so, add a border to the cell. Note that this loop changes
					the current context!
				-->
				<xsl:for-each select="1 to count(ancestor::tabular/tabular-columns/column)">
					<td>
						<xsl:if test="exists(index-of($column-specs, . cast as xs:string))">
							<xsl:attribute name="style">
								<xsl:text>border-bottom: 1px solid black; </xsl:text>
								<xsl:if test="$weight = 'double'">
									<xsl:text>border-top: 1px solid black; </xsl:text>
								</xsl:if>
							</xsl:attribute>
						</xsl:if>
					</td>
				</xsl:for-each>
			</tr>
		</common>
	</template>
	
	<!--
		Hmm, the multi-row stuff is somewhat broken in LaTeX, oops.
		Need to insert missing columns (as was done in the calendar
		XSL) when a multi-row cell is encountered.
		
		Also need to sort out \hlines in the presence of multi-row cells
		and also what happens to vertical cell borders :(
		
		This probably needs reworking.
	-->
	
	<!--
		Multi-row cells (LaTeX only, as this is pretty trivial to
		achieve in HTML).
		
		@rows: The number of rows this cell spans.
		@header: Is this a header cell? [yes, NO]
	-->
	<template name="multirow-cell" match="cell" mode="latex-multi-row">
		<common formats="/latex/xelatex/">
			<xsl:text>\multirow{</xsl:text>
			<xsl:value-of select="@rows" />
			<xsl:text>}{*}{</xsl:text>
			<xsl:if test="@header = 'yes'"><xsl:text>\textbf{</xsl:text></xsl:if>

			<!-- check for embedded line breaks, if so, embed another tabular inside this one -->
			<xsl:if test="count(child::br) != 0">
				<xsl:text>\begin{tabular}{@{}</xsl:text>
				<xsl:choose>
					<xsl:when test="@align">
						<xsl:value-of select="substring(@align, 1, 1)" />
					</xsl:when>
					<xsl:otherwise>
						<xsl:text>l</xsl:text>
					</xsl:otherwise>
				</xsl:choose>
				<xsl:text>@{}}</xsl:text>
			</xsl:if>

			<xsl:apply-templates />

			<xsl:if test="count(child::br) != 0">
				<xsl:text>\end{tabular}
			</xsl:text></xsl:if>
			<xsl:if test="@header = 'yes'"><xsl:text>}</xsl:text></xsl:if>
			<xsl:text>}</xsl:text>
		</common>
	</template>
	
	<!--
		Multi-column cells (LaTeX only, as this is pretty trivial to
		achieve in HTML).
		
		$num-columns: The number of rows this cell spans.
		@header: Is this a header cell? [yes, NO]
	-->
	<template name="multicolumn-cell" match="cell" mode="latex-multi-column">
		<common formats="/latex/xelatex/">
			<xsl:param name="num-columns">1</xsl:param>
			<xsl:text>\multicolumn{</xsl:text>
			<xsl:value-of select="$num-columns" />
			<xsl:text>}{</xsl:text>
			<xsl:value-of select="@left-border" />
			<xsl:choose>
				<xsl:when test="@align">
					<xsl:value-of select="substring(@align, 1, 1)" />
				</xsl:when>
				<xsl:otherwise>
					<xsl:text>l</xsl:text>
				</xsl:otherwise>
			</xsl:choose>
			<xsl:value-of select="@right-border" />
			<xsl:text>}{</xsl:text>
			<xsl:choose>
				<xsl:when test="@rows">
					<xsl:apply-templates select="." mode="multi-row" />
				</xsl:when>
				<xsl:otherwise>
					<xsl:if test="@header = 'yes'"><xsl:text>\textbf{</xsl:text></xsl:if>

					<!-- check for embedded line breaks, if so, embed another tabular inside this one -->
					<xsl:if test="count(child::br) != 0">
						<xsl:text>\begin{tabular}{@{}</xsl:text>
						<xsl:choose>
							<xsl:when test="@align">
								<xsl:value-of select="substring(@align, 1, 1)" />
							</xsl:when>
							<xsl:otherwise>
								<xsl:text>l</xsl:text>
							</xsl:otherwise>
						</xsl:choose>
						<xsl:text>@{}}</xsl:text>
					</xsl:if>

					<xsl:apply-templates />

					<xsl:if test="count(child::br) != 0">
						<xsl:text>\end{tabular}
					</xsl:text></xsl:if>
					<xsl:if test="@header = 'yes'"><xsl:text>}</xsl:text></xsl:if>
				</xsl:otherwise>
			</xsl:choose>
			<xsl:text>}</xsl:text>
		</common>
	</template>
	
	<!--
		Top-level template for generating cells.
		
		@columns: The number of columns this cell spans.
		@rows: The number of rows this cell spans.
		@align: The alignment of this cell. [LEFT, center, right]
		@header: Is this a header cell? [yes, NO]
	-->
	<template match="cell">
		<common>
			<!-- position() doesn't seem to work very well in this context. -->
			<xsl:variable name="column-no"><xsl:number /></xsl:variable>
		</common>
		<!--
			Doing this sensibly for LaTeX is actually pretty ugly,
			because different attribute combinations produce different
			code :(
			
			This is the sort of algorithm that can only really be
			clearly described by a flow chart :)
		-->
		<common formats="/latex/xelatex/">
			<xsl:choose>
				<xsl:when test="@columns">
					<xsl:apply-templates select="." mode="latex-multi-column">
						<xsl:with-param name="num-columns" select="@columns" />
					</xsl:apply-templates>
				</xsl:when>
				<xsl:when test="@align">
					<xsl:apply-templates select="." mode="latex-multi-column" />
				</xsl:when>
				<xsl:when test="@rows">
					<xsl:apply-templates select="." mode="latex-multi-row" />
				</xsl:when>
				<xsl:otherwise>
					<xsl:if test="@header = 'yes'"><xsl:text>\textbf{</xsl:text></xsl:if>

					<!-- check for embedded line breaks, if so, embed another tabular inside this one -->
					<xsl:if test="count(child::br) != 0">
						<xsl:text>\begin{tabular}{@{}</xsl:text>
						<xsl:choose>
							<xsl:when test="@align">
								<xsl:value-of select="substring(@align, 1, 1)" />
							</xsl:when>
							<xsl:otherwise>
								<xsl:text>l</xsl:text>
							</xsl:otherwise>
						</xsl:choose>
						<xsl:text>@{}}</xsl:text>
					</xsl:if>

					<xsl:apply-templates />

					<xsl:if test="count(child::br) != 0">
						<xsl:text>\end{tabular}
					</xsl:text></xsl:if>
					<xsl:if test="@header = 'yes'"><xsl:text>}</xsl:text></xsl:if>
				</xsl:otherwise>
			</xsl:choose>
			<xsl:if test="$column-no != last()"> &amp; </xsl:if>
		</common>
		<!--
			It's much easier in HTML, because a <td> is a <td> is a
			<td>, regardless of the attributes supplied.
		-->
		<common formats="/html/xhtml/">
			<!--
				Hmm, how to generate either a TD or TH as required,
				including attributes, without repeating code?
				
				Aha, the answer is attribute value templates!
			-->
			<xsl:variable name="celltype">
				<xsl:choose>
					<xsl:when test="@header = 'yes'">th</xsl:when>
					<xsl:otherwise>td</xsl:otherwise>
				</xsl:choose>
			</xsl:variable>
			<xsl:element name="{$celltype}">
				<xsl:attribute name="align">
					<xsl:value-of select="@align" />
					<xsl:if test="not(@align)">
						<xsl:value-of select="ancestor::tabular/tabular-columns/column[position() = $column-no]/@align" />
						<xsl:if test="not(ancestor::tabular/tabular-columns/column[position() = $column-no]/@align)">left</xsl:if>
					</xsl:if>
				</xsl:attribute>
				<xsl:attribute name="valign">
					<xsl:value-of select="@valign" />
					<xsl:if test="not(@valign)">middle</xsl:if>
				</xsl:attribute>
				<xsl:attribute name="colspan">
					<xsl:value-of select="@columns" />
					<xsl:if test="not(@columns)">1</xsl:if>
				</xsl:attribute>
				<xsl:attribute name="rowspan">
					<xsl:value-of select="@rows" />
					<xsl:if test="not(@rows)">1</xsl:if>
				</xsl:attribute>
				<xsl:apply-templates />
			</xsl:element>
		</common>
	</template>
	
	
	<!--
		Hyperlinks. The content of the element is the hyperlink text.
		
		@label: A label that the hyperlink links to. The value should
		be an acceptable label in both LaTeX and HTML. [optional]
		
		@url: A URL that the hyperlink links to. If no link text is
		provided, the URL is used as the link text. [optional]
	-->
	<template name="hyperlink-label" match="hyperlink[@label and node()]">
		<common formats="/latex/xelatex/">\hyperref[<xsl:value-of select="@label" />]{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><a href="#{@label}"><xsl:apply-templates /></a></common>
	</template>

	<template name="empty-hyperlink-label" match="hyperlink[@label and not(node())]">
		<common>
			<xsl:message terminate="yes">&lt;hyperlink&gt; with @label must include link text.</xsl:message>
		</common>
	</template>

	<template name="hyperlink-url" match="hyperlink[@url and node()]">
		<common formats="/latex/xelatex/">\href{<xsl:value-of select="@url" />}{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><a href="{@url}"><xsl:apply-templates /></a></common>
	</template>

	<template name="empty-hyperlink-url" match="hyperlink[@url and not(node())]">
		<!-- Note: not safe to use the url package here because \url{...} is fragile. -->
		<common formats="/latex/xelatex/">\url{<xsl:value-of select="@url" />}</common>
		<common formats="/html/xhtml/"><a href="{@url}"><code><xsl:value-of select="@url" /></code></a></common>
	</template>

	<template name="hyperlink-bogus" match="hyperlink[@url and @label]" priority="2">
		<common>
			<xsl:message terminate="yes">Cannot use both @url and @label in &lt;hyperlink&gt;.</xsl:message>
		</common>
	</template>

	<!-- Internal parameterised hyperlink template 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/">\href{<xsl:value-of select="$url" />}{<xsl:apply-templates select="exsl:node-set($label)" />}</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/">\url{<xsl:value-of select="$url" />}</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">
		<!--
			Hmm, \url{...} appears to turn the URL into a non-functional
			link in PDF output (probably an interaction with hyperref).
			Not really what we want (as the link aspect is already dealt
			with by the <hyperlink> templates), so we'll just use
			\texttt{...}.
		-->
		<common formats="/latex/xelatex/">\nolinkurl{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><code><xsl:apply-templates /></code></common>
	</template>
	


	<!--
		References. Note the distinction betwen these and hyperlinks: a reference is merely something like "see Section 2.3", and doesn't necessarily imply a hyperlink, or vice versa.
		
		@label: The label of the item that we're referencing. It must be a valid label in both LaTeX and HTML. [required]
		
		@include-pageref: If "yes", also append a page reference (LaTeX only; this is handled by the "item-page-reference" template below).
	-->
	<template name="reference" match="reference[@label]">
		<common>
			<!-- Find the element whose label is the same as our label. -->
			<xsl:apply-templates select="//*[@label = current()/@label]" mode="reference" />
			<xsl:if test="@include-pageref = 'yes'">
				<xsl:apply-templates select="//*[@label = current()/@label]" mode="page-reference" />
			</xsl:if>
		</common>
	</template>
	
	<template name="broken-reference" match="reference[not( @label )]">
		<common>
			<xsl:message terminate="yes">Reference elements must include a label attribute.</xsl:message>
		</common>
	</template>
	
	<!-- Do a separate template for each type of referenced item; easier. -->
	<template name="section-reference" match="section" mode="reference">
		<!-- It's probably more consistent to just use \ref* and insert "Section" ourselves rather than let LaTeX do it. -->
		<common formats="/latex/xelatex/">
			<xsl:text>Section~\ref*{</xsl:text>
			<xsl:value-of select="@label" />
			<xsl:text>}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<xsl:text disable-output-escaping="yes">Section&amp;nbsp;</xsl:text>
			<xsl:number count="section" level="multiple" format="1.1.1.1.1.1" />
		</common>
	</template>
	
	<template name="figure-reference" match="figure" mode="reference">
		<common formats="/latex/xelatex/">
			<xsl:text>Figure~\ref*{</xsl:text>
			<xsl:value-of select="@label" />
			<xsl:text>}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<xsl:text disable-output-escaping="yes">Figure&amp;nbsp;</xsl:text>
			<xsl:choose>
				<xsl:when test="$showanswers='yes'">
					<xsl:number count="figure" level="any" format="1" />
				</xsl:when>
				<xsl:otherwise>
					<xsl:number count="figure[not(ancestor::answer) and not(ancestor::omit) and not(ancestor::comment)]" level="any" format="1" />
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>
	
	<template name="table-reference" match="table" mode="reference">
		<common formats="/latex/xelatex/">
			<xsl:text>Table~\ref*{</xsl:text>
			<xsl:value-of select="@label" />
			<xsl:text>}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<xsl:text disable-output-escaping="yes">Table&amp;nbsp;</xsl:text>
			<xsl:choose>
				<xsl:when test="$showanswers='yes'">
					<xsl:number count="table" level="any" format="1" />
				</xsl:when>
				<xsl:otherwise>
					<xsl:number count="table[not(ancestor::answer) and not(ancestor::omit) and not(ancestor::comment)]" level="any" format="1" />
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>
	
	<!--
		Standalone direct reference to a page (i.e., not associated with some other item like a figure or table). This only really makes sense in LaTeX, as HTML doesn't have page numbers. For HTML, we fudge things by inserting the string "here", which will make sense if the reference is wrapped with a hyperlink (as they usually are).
	-->
	<template name="page-reference" match="page[@label]" mode="reference">
		<common formats="/latex/xelatex/">
			<xsl:text>page~\pageref{</xsl:text>
			<xsl:value-of select="@label" />
			<xsl:text>}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<xsl:text disable-output-escaping="yes">here</xsl:text>
		</common>
	</template>
	
	<!--
		Common template for appended page references, as they're identical for all items except for standalone page references, which aren't included in this template. The include-pageref attribute is therefore ignored on standalone page references.
	-->
	<template name="item-page-reference" match="section|figure|table" mode="page-reference">
		<common formats="/latex/xelatex/">
			<xsl:text> on page~\pageref{</xsl:text>
			<xsl:value-of select="@label" />
			<xsl:text>}</xsl:text>
		</common>
	</template>
	
	<!--
		Generate a standalone label for use in direct page references.
		
		TODO: Hmm, this seems to generate the correct page number in LaTeX but the hyperlink is to the wrong page (one lower?). Something to worry about later.
		
		@label: The label to be inserted. It must be a valid label in both LaTeX and HTML. [required]
	-->
	<template name="page" match="page[@label]">
		<common formats="/latex/xelatex/">
			<xsl:text>\label{</xsl:text>
			<xsl:value-of select="@label" />
			<xsl:text>}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<a id="{@label}"></a>
		</common>
	</template>
	
	<template name="broken-page" match="page[not( @label )]">
		<common>
			<xsl:message terminate="yes">Page elements must include a label attribute.</xsl:message>
		</common>
	</template>
	
	
	<!--
		Figures & tables (in the LaTeX sense, i.e., "floating" items).
		
		@border-placement: The style of border to place around the figure or table.
			'none' [default]
			'box'
			or: any combination of 'top', 'left', 'bottom', 'right', e.g., 'bottom, left' (not all options may be available)
	-->
	<template name="figure" match="figure">
		<common formats="/latex/xelatex/">
			\begin{figure}<xsl:if test="@latex-placement">[<xsl:value-of select="@latex-placement" />]</xsl:if>
				\centering
				<xsl:choose>
					<xsl:when test="@border-placement = 'box'">
						<xsl:text>\fbox{</xsl:text>
					</xsl:when>
					<xsl:when test="contains( @border-placement, 'top' )">
						<xsl:text>\hrule\medskip</xsl:text>
					</xsl:when>
				</xsl:choose>
				<xsl:apply-templates select="*[not(self::caption)]" />
				<xsl:choose>
					<xsl:when test="@border-placement = 'box'">
						<xsl:text>}</xsl:text>
					</xsl:when>
					<xsl:when test="contains( @border-placement, 'bottom' )">
						<xsl:text>\medskip\hrule</xsl:text>
					</xsl:when>
				</xsl:choose>
				<xsl:if test="count(caption) != 0">
					\caption{<xsl:apply-templates select="caption" />}
					<xsl:if test="@label">\label{<xsl:value-of select="@label" />}</xsl:if>
					<xsl:if test="count(id) != 0">\label{<xsl:value-of select="id" />}</xsl:if>
				</xsl:if>
			\end{figure}
		</common>
		<common formats="/html/xhtml/">
			<div class="figure" style="text-align: center; margin-top: 2em; margin-bottom: 2em;">
				<div>
					<xsl:attribute name="style">
						<xsl:if test="@border-placement = 'box'">
							<xsl:text>border: 1px solid black; padding: 1em; </xsl:text>
						</xsl:if>
						<xsl:if test="contains( @border-placement, 'top' )">
							<xsl:text>border-top: 1px solid black; padding-top: 1em; </xsl:text>
						</xsl:if>
						<xsl:if test="contains( @border-placement, 'left' )">
							<xsl:text>border-left: 1px solid black; padding-left: 1em; </xsl:text>
						</xsl:if>
						<xsl:if test="contains( @border-placement, 'bottom' )">
							<xsl:text>border-bottom: 1px solid black; padding-bottom: 1em; </xsl:text>
						</xsl:if>
						<xsl:if test="contains( @border-placement, 'right' )">
							<xsl:text>border-right: 1px solid black; padding-right: 1em; </xsl:text>
						</xsl:if>
					</xsl:attribute>
					<xsl:if test="@label"><a id="{@label}"></a></xsl:if>
					<xsl:if test="count(id) != 0"><a id="{id}"></a></xsl:if>
					<xsl:apply-templates select="*[not(self::caption)]" />
				</div>
				<xsl:if test="count(caption) != 0">
					<br />
					<xsl:apply-templates select="caption" />
				</xsl:if>
			</div>
		</common>
	</template>
	
	<template name="table" match="table">
		<common formats="/latex/xelatex/">
			\begin{table}<xsl:if test="@latex-placement">[<xsl:value-of select="@latex-placement" />]</xsl:if>
				\centering
				<xsl:choose>
					<!-- TODO: test this with embedded tabulars. It might not work! -->
					<xsl:when test="@border-placement = 'box'">
						<xsl:text>\fbox{</xsl:text>
					</xsl:when>
					<xsl:when test="contains( @border-placement, 'top' )">
						<xsl:text>\hrule\medskip</xsl:text>
					</xsl:when>
				</xsl:choose>
				<xsl:apply-templates select="*[not(self::caption)]" />
				<xsl:choose>
					<xsl:when test="@border-placement = 'box'">
						<xsl:text>}</xsl:text>
					</xsl:when>
					<xsl:when test="contains( @border-placement, 'bottom' )">
						<xsl:text>\medskip\hrule</xsl:text>
					</xsl:when>
				</xsl:choose>
				<xsl:if test="count(caption) != 0">
					\caption{<xsl:apply-templates select="caption" />}
					<xsl:if test="@label">\label{<xsl:value-of select="@label" />}</xsl:if>
				</xsl:if>
			\end{table}
		</common>
		<common formats="/html/xhtml/">
			<div class="table" style="text-align: center; margin-top: 2em; margin-bottom: 2em;">
				<div>
					<xsl:attribute name="style">
						<xsl:if test="@border-placement = 'box'">
							<xsl:text>border: 1px solid black; padding: 1em; </xsl:text>
						</xsl:if>
						<xsl:if test="contains( @border-placement, 'top' )">
							<xsl:text>border-top: 1px solid black; padding-top: 1em; </xsl:text>
						</xsl:if>
						<xsl:if test="contains( @border-placement, 'left' )">
							<xsl:text>border-left: 1px solid black; padding-left: 1em; </xsl:text>
						</xsl:if>
						<xsl:if test="contains( @border-placement, 'bottom' )">
							<xsl:text>border-bottom: 1px solid black; padding-bottom: 1em; </xsl:text>
						</xsl:if>
						<xsl:if test="contains( @border-placement, 'right' )">
							<xsl:text>border-right: 1px solid black; padding-right: 1em; </xsl:text>
						</xsl:if>
					</xsl:attribute>
					<xsl:if test="@label"><a id="{@label}"></a></xsl:if>
					<xsl:if test="count(id) != 0"><a id="{id}"></a></xsl:if>
					<xsl:apply-templates select="*[not(self::caption)]" />
				</div>
				<xsl:if test="@label"><a id="{@label}"></a></xsl:if>
				<xsl:apply-templates select="*[not(self::caption)]" />
				<xsl:if test="count(caption) != 0">
					<br />
					<xsl:apply-templates select="caption" />
				</xsl:if>
			</div>
		</common>
	</template>
	
	<template name="multipart-table" match="table[count(part) &gt; 0]">
		<common formats="/latex/xelatex/">
			<xsl:for-each select="part">
				\begin{table}[p]
					\centering
					<xsl:choose>
						<!-- TODO: test this with embedded tabulars. It might not work! -->
						<xsl:when test="../@border-placement = 'box'">
							<xsl:text>\fbox{</xsl:text>
						</xsl:when>
						<xsl:when test="contains( ../@border-placement, 'top' )">
							<xsl:text>\hrule\medskip</xsl:text>
						</xsl:when>
					</xsl:choose>
					<xsl:apply-templates />
					<xsl:choose>
						<xsl:when test="../@border-placement = 'box'">
							<xsl:text>}</xsl:text>
						</xsl:when>
						<xsl:when test="contains( ../@border-placement, 'bottom' )">
							<xsl:text>\medskip\hrule</xsl:text>
						</xsl:when>
					</xsl:choose>
					<xsl:if test="count(../caption) != 0">
						<xsl:text>\caption{</xsl:text>
						<xsl:apply-templates select="../caption" />
						<xsl:choose>
							<xsl:when test="position() &gt; 1">
								<xsl:text> \emph{(continued)}}</xsl:text>
							</xsl:when>
							<xsl:otherwise>
								<xsl:text> \emph{(continues over)}}</xsl:text>
								<xsl:if test="../@label">\label{<xsl:value-of select="../@label" />}</xsl:if>
							</xsl:otherwise>
						</xsl:choose>
						<!-- Consider the possibility of labels for each part? -->
						<!-- <xsl:if test="@label">\label{<xsl:value-of select="@label" />}</xsl:if> -->
					</xsl:if>
				\end{table}
				\addtocounter{table}{-1}
				\clearpage
			</xsl:for-each>
			\stepcounter{table}
		</common>
	</template>
	
	<template name="figure-caption" match="figure/caption">
		<common formats="/latex/xelatex/"><xsl:apply-templates /></common>
		<common formats="/html/xhtml/">
			<p style="text-align: center;">
				<strong>
					<xsl:text>Figure </xsl:text>
					<xsl:choose>
						<xsl:when test="$showanswers='yes'">
							<xsl:number count="figure" level="any" format="1" />
						</xsl:when>
						<xsl:otherwise>
							<xsl:number count="figure[not(ancestor::answer) and not(ancestor::omit) and not(ancestor::comment)]" level="any" format="1" />
						</xsl:otherwise>
					</xsl:choose>
					<xsl:text>. </xsl:text>
				</strong>
				<xsl:apply-templates />
			</p>
		</common>
	</template>
	
	<template name="table-caption" match="table/caption">
		<common formats="/latex/xelatex/"><xsl:apply-templates /></common>
		<common formats="/html/xhtml/">
			<p style="text-align: center;">
				<strong>
					<xsl:text>Table </xsl:text>
					<xsl:choose>
						<xsl:when test="$showanswers='yes'">
							<xsl:number count="table" level="any" format="1" />
						</xsl:when>
						<xsl:otherwise>
							<xsl:number count="table[not(ancestor::answer) and not(ancestor::omit) and not(ancestor::comment)]" level="any" format="1" />
						</xsl:otherwise>
					</xsl:choose>
					<xsl:text>. </xsl:text>
				</strong>
				<xsl:apply-templates />
			</p>
		</common>
	</template>
	
	
	<!--
		Images. Includes a scaling factor for LaTeX.
		
		To do: alternatively, allow defining the scaling factor by specifying what proportion of the page width the image should occupy (a la LaTeX [width] parameter).
		How about a <latex-attributes> element that can be used to specify \includegraphics arguments?
			<width keepaspectratio="yes">0.5\columnwidth</width>
			<height>2cm</height>
			<scale>0.5</scale>
			etc.
		
		To do: if no description is given, use the basename as the content of the ALT element.
		Ideally, I think we should be able to define two image formats (PDF, EPS, PNG, ...) when marking up an image: one for LaTeX output, another for HTML.  Mind you, if the generation of the various formats from a single master is handled outside of the XSLT processing...?
	-->
	
	<!-- LaTeX images are always handled the same way regardless. -->
	<template name="latex-image" match="image" mode="latex">
		<common formats="/latex/xelatex/">
			<xsl:text>\includegraphics</xsl:text>
			<xsl:if test="count(latex-scaling) != 0">
				<xsl:message terminate="no">&lt;latex-scaling&gt; element is deprecated in &lt;image&gt;; please use latex-options attribute instead.</xsl:message>
				<xsl:text>[scale=</xsl:text>
				<xsl:value-of select="latex-scaling" />
				<xsl:text>]</xsl:text>
			</xsl:if>
			<!-- Adding general-purpose latex pass-through arguments for \includegraphics; this should eventually subsume the "scale"-only handler above. -->
			<!-- If providing multiple arguments, these should be comma-separated in the source XML, but do not need the enclosing square brackets. -->
			<xsl:if test="@latex-options">
				<xsl:text>[</xsl:text>
				<xsl:value-of select="@latex-options" />
				<xsl:text>]</xsl:text>
			</xsl:if>
			<xsl:text>{</xsl:text>
			<!--
				Work out the full path specification for the file to be included = base-path + location (if specified) + basename.
			-->
			<xsl:value-of select="$base-path" />
			<xsl:text>/</xsl:text>	
			
			<!-- Check whether the location attribute is included. -->
			<xsl:if test="@location">
				<xsl:value-of select="@location" />
				<xsl:text>/</xsl:text>
			</xsl:if>

			<!-- need to phase out "basename" as an element and switch to using an attribute -->
			<xsl:if test="count(basename) != 0">
				<xsl:message terminate="no">&lt;basename&gt; element is deprecated in &lt;image&gt;; please use basename attribute instead.</xsl:message>
				<xsl:value-of select="basename" />
			</xsl:if>
			<xsl:if test="@basename">
				<xsl:value-of select="@basename" />
			</xsl:if>
			<xsl:text>-print.</xsl:text>
			
			<!-- Figure out the image format. -->
			<xsl:choose>
				<xsl:when test="count(format) != 0">
					<xsl:message terminate="no">&lt;format&gt; element is deprecated in &lt;image&gt;; please use format attribute instead.</xsl:message>
					<xsl:value-of select="format" />
				</xsl:when>
				<xsl:when test="@format">
					<xsl:value-of select="@format" />
				</xsl:when>
				<xsl:otherwise>
					<xsl:value-of select="$image-format" />
				</xsl:otherwise>
			</xsl:choose>
			<xsl:text>}</xsl:text>
		</common>
	</template>
	
	<template name="normal-image" match="image[count(provide-large-version) = 0]">
		<common formats="/latex/xelatex/"><xsl:apply-templates select="." mode="latex" /></common>
		<common formats="/html/xhtml/">
			<img class="padded" style="border-style: none;">
				<xsl:attribute name="src">
					<!--
						Work out the full path specification for the file
						to be included = base-path + location (if specified) + basename.
					-->
					<xsl:value-of select="$base-path" />
					<xsl:text>/</xsl:text>	
					
					<!-- Check whether the location attribute is included. -->
					<xsl:if test="@location">
						<xsl:value-of select="@location" />
						<xsl:text>/</xsl:text>
					</xsl:if>

					<xsl:value-of select="basename|@basename" />
					<xsl:text>-web.</xsl:text>

					<xsl:choose>
						<!-- CME: oops, I'd originally used the "format" tag to identify the format used in the LaTeX version, not the HTML! -->
						<xsl:when test="count(format) != 0">
							<xsl:message terminate="no">&lt;format&gt; element is deprecated in &lt;image&gt;; please use format attribute instead.</xsl:message>
							<xsl:value-of select="format" />
						</xsl:when>
						<xsl:when test="@format">
							<xsl:value-of select="@format" />
						</xsl:when>
						<xsl:otherwise>
							<xsl:value-of select="$image-format" />
						</xsl:otherwise>
					</xsl:choose>
				</xsl:attribute>
				<xsl:attribute name="alt"><xsl:apply-templates select="description" /></xsl:attribute>
			</img>
		</common>
	</template>

	<template name="zoomable-image" match="image[count(provide-large-version) != 0]">
		<common formats="/latex/xelatex/"><xsl:apply-templates select="." mode="latex" /></common>
		<common formats="/html/xhtml/">
			<a>
				<xsl:attribute name="href">
					<!--
						Work out the full path specification for the file
						to be included = base-path + location (if specified) + basename.
					-->
					<xsl:value-of select="$base-path" />
					<xsl:text>/</xsl:text>	
					
					<!-- Check whether the location attribute is included. -->
					<xsl:if test="@location">
						<xsl:value-of select="@location" />
						<xsl:text>/</xsl:text>
					</xsl:if>

					<xsl:value-of select="basename|@basename" />
					<xsl:text>-web-zoom.</xsl:text>
					
					<xsl:choose>
						<!-- CME: oops, I'd originally used the "format" tag to identify the format used in the LaTeX version, not the HTML! -->
						<xsl:when test="count(format) != 0">
							<xsl:message terminate="no">&lt;format&gt; element is deprecated in &lt;image&gt;; please use format attribute instead.</xsl:message>
							<xsl:value-of select="format" />
						</xsl:when>
						<xsl:when test="@format">
							<xsl:value-of select="@format" />
						</xsl:when>
						<xsl:otherwise>
							<xsl:value-of select="$image-format" />
						</xsl:otherwise>
					</xsl:choose>
				</xsl:attribute>
				<img class="padded" style="border-style: none;">
					<xsl:attribute name="src">
						<!--
							Work out the full path specification for the file
							to be included = base-path + location (if specified) + basename.
						-->
						<xsl:value-of select="$base-path" />
						<xsl:text>/</xsl:text>	
						
						<!-- Check whether the location attribute is included. -->
						<xsl:if test="@location">
							<xsl:value-of select="@location" />
							<xsl:text>/</xsl:text>
						</xsl:if>
	
						<xsl:value-of select="basename|@basename" />
						<xsl:text>-web.</xsl:text>
						
						<xsl:choose>
							<!-- CME: oops, I'd originally used the "format" tag to identify the format used in the LaTeX version, not the HTML! -->
							<xsl:when test="count(format) != 0">
								<xsl:message terminate="no">&lt;format&gt; element is deprecated in &lt;image&gt;; please use format attribute instead.</xsl:message>
								<xsl:value-of select="format" />
							</xsl:when>
							<xsl:when test="@format">
								<xsl:value-of select="@format" />
							</xsl:when>
							<xsl:otherwise>
								<xsl:value-of select="$image-format" />
							</xsl:otherwise>
						</xsl:choose>
					</xsl:attribute>
					<xsl:attribute name="alt">
						<xsl:apply-templates select="description" />
					</xsl:attribute>
				</img>
				<br clear="right" />
				<xsl:text>(Larger version)</xsl:text>
			</a>
		</common>
	</template>
	
	
	<!--
		Include another XML/HTML/LaTeX document into the current one. If
		you don't specify @type, it assumes the type of document that
		you're currently generating (HTML or LaTeX).
		
		LaTeX documents are simply included using \input{...}. The old
		<latex-input> element is now deprecated.

		HTML documents are a little trickier, as there's no equivalent
		of \input{} in HTML, plus the XSLT processor always seems to
		generate a DOCTYPE when producing HTML, whether you want it or
		not, which means that you can only really include entire HTML
		documents, rather than HTML fragments (maybe you can turn this
		off?). The workaround currently is to embed the HTML document
		inside an <object>.

		A similar argument applies for plain text documents (such as
		code listings) that we want to include, but are externally
		generated and so can't just be embedded in the source XML.

		@type: The type of the document to be included. [optional] Valid
		values are:
			"xml"
			"html" [default for HTML]
			"latex" [default for LaTeX]
			"plain" (as in text/plain)
		
		@basename: Name of file to include (including suffix!).
		[required]
		
		@location: Path to file to include. Note that this gets a /
		appended to it. However, this shouldn't make any difference in
		normal usage. [optional]
	-->
	<template name="include-document" match="include-document">
		<common>
			<!--
				Work out the full path specification for the file
				to be included = base-path + location + basename.
			-->
			<xsl:variable name="file">
				<xsl:value-of select="$base-path" />
				<xsl:text>/</xsl:text>			
				<xsl:if test="@location">
					<xsl:value-of select="@location" />
					<xsl:text>/</xsl:text>
				</xsl:if>
				<xsl:value-of select="@basename" />
			</xsl:variable>
		</common>
		<common formats="/html/xhtml/">
			<div>
				<xsl:attribute name="align">
					<xsl:choose>
						<xsl:when test="@align"><xsl:value-of select="@align" /></xsl:when>
						<xsl:otherwise>left</xsl:otherwise>
					</xsl:choose>
				</xsl:attribute>
				
				<object data="{$file}">
					<!-- Output text/html or text/plain as appropriate. -->
					<xsl:attribute name="type">
						<xsl:text>text/</xsl:text>
						<xsl:choose>
							<xsl:when test="@type"><xsl:value-of select="@type" /></xsl:when>
							<xsl:otherwise><xsl:text>html</xsl:text></xsl:otherwise>
						</xsl:choose>
					</xsl:attribute>
					<xsl:attribute name="width">
						<xsl:choose>
							<xsl:when test="@width"><xsl:value-of select="@width" /></xsl:when>
							<xsl:otherwise><xsl:text>100%</xsl:text></xsl:otherwise>
						</xsl:choose>
					</xsl:attribute>
					<xsl:attribute name="height">
						<xsl:choose>
							<xsl:when test="@height"><xsl:value-of select="@height" /></xsl:when>
							<xsl:otherwise><xsl:text>100%</xsl:text></xsl:otherwise>
						</xsl:choose>
					</xsl:attribute>
				</object>
			</div>
		</common>
		<common formats="/latex/xelatex/">
			<xsl:text>\</xsl:text>
			<!--
				Note that input text files are currently verbatim'd in
				LaTeX. We may want to change this in future?
			-->
			<xsl:if test="@type = 'plain'">
				<xsl:text>verbatim</xsl:text>
			</xsl:if>
			<xsl:text>input{</xsl:text>
			<xsl:value-of select="$file" />
			<xsl:text>}</xsl:text>
		</common>
	</template>
	
	<!--
		Note that including XML documents is currently problematic,
		as the document() function expects a valid XML document. 
		Including XML fragments is impossible. XInclude will fix this,
		once it is widely supported (not yet). Best to avoid this
		completely for now.
	-->
	<template name="include-xml" match="include-document[@type='xml']">
		<common>
			<xsl:variable name="file">
				<xsl:value-of select="$base-path" />
				<xsl:text>/</xsl:text>
				<xsl:if test="@location">
					<xsl:value-of select="@location" />
					<xsl:text>/</xsl:text>
				</xsl:if>
				<xsl:value-of select="@basename" />
			</xsl:variable>
			<xsl:apply-templates select="document($file,/)" />
		</common>
	</template>
	

	<!--
		Environment setup. This enables you to define environment settings
		(e.g., required LaTeX packages, etc.). We normally explicitly call
		the sub-elements within this, so this template is empty to prevent
		unwanted stuff accidentally being included in the output.
	-->
	<template name="environment" match="environment" />

	<!--
		Load a LaTeX package.
		
		@options: Any arguments to the package. [optional]
	-->
	<template name="latex-package" match="latex-packages/package">
		<common formats="/latex/xelatex/">\usepackage<xsl:if test="@options">[<xsl:value-of select="@options" />]</xsl:if>{<xsl:value-of select="." />}</common>
	</template>
		
	<!--
		Execute a preamble LaTeX command. Use to set up things like
		counters, fonts, hyperref options, etc.
	-->
	<template name="latex-command" match="latex-commands/command">
		<common formats="/latex/xelatex/"><xsl:value-of select="." /></common>
	</template>
	
	
	<!--
		LaTeX hyphenation. A space-delimited list of hyphenated words.
	-->
	<template name="latex-hyphenation" match="latex-commands/hyphenation">
		<common formats="/latex/xelatex/">\hyphenation{<xsl:value-of select="." />}</common>
	</template>
	

	<!--
		Hmm, the following may be more complex than I thought...
		External environment files sort of stuff it up. Perhaps
		LaTeX document class stuff should be in attributes of the
		document element?
	-->
	<!--
		Specify LaTeX document class and options. The master stylesheet
		specifies \documentclass[a4paper,12pt]{article}. Anything you
		specify here will override that completely, so be sure to set
		a4paper and 12pt if that's what you want.
		
		@options: The required document class options. [optional]
	-->
	<template name="latex-documentclass" match="latex-documentclass|documentclass">
		<common formats="/latex/xelatex/">\documentclass[<xsl:value-of select="@options" />]{<xsl:value-of select="." />}</common>
	</template>
	<template name="latex-documentclass-options" match="latex-documentclass[@options]|documentclass[@options]">
		<common formats="/latex/xelatex/">\documentclass[<xsl:value-of select="@options" />]{<xsl:value-of select="." />}</common>
	</template>
	
	<!--
		Specify additional LaTeX document class options (i.e., in
		addition to the defaults). These should be a comma-separated
		list of the required options. These will be appended to the
		standard defaults (a4paper, 12pt).
	-->
	<template name="latex-document-options" match="latex-document-options">
		<common formats="/latex/xelatex/"><xsl:apply-templates /></common>
	</template>
	
	
	<!--
		Sometimes we might need to embed raw code to handle something tricky.
	-->
	<template name="raw-latex" match="raw-code[@format = 'latex']|raw-latex">
		<common formats="/latex/xelatex/"><xsl:apply-templates /></common>
	</template>
		
	<!--
		This can be a tricky if the document being processed declares any
		namespaces, as they generally end up attached to the first element
		of the raw HTML. I haven't discovered a workaround yet :(.
	-->
	<template name="raw-html" match="raw-code[@format = 'html']|raw-html">
		<common formats="/html/xhtml/"><xsl:copy-of select="*" /></common>
	</template>
		
	<!-- Generate a LaTeX \input{} macro. -->
	<template name="latex-input" match="latex-input">
		<common formats="/latex/xelatex/">
			<xsl:message>Use of latex-input is deprecated. Please use include-document instead.</xsl:message>
			\input{<xsl:value-of select="." />}
		</common>
	</template>

	
	<!--
		Conditional processing depending on the format. It may appear redundant to have two templates, but this is the only way to ensure that the LaTeX template is empty in the HTML style sheet, and vice versa.
		
		Note the assumption that all LaTeX format names include the string 'latex' and all HTML format names include the string 'html'.
		
		@format: the format under which this XML is to be processed. [required]
	-->
	<template name="process-when-latex" match="process-when[ contains( @format, 'latex' ) ]">
		<common formats="/latex/xelatex/"><xsl:apply-templates /></common>
	</template>
	
	<template name="process-when-html" match="process-when[ contains( @format, 'html' ) ]">
		<common formats="/html/xhtml/"><xsl:apply-templates /></common>
	</template>
	
	
	<!--
		Basic maths stuff. Anything more complicated is... complicated.
		We should probably be using MathML, but we still have to mangle
		it into HTML regardless.
		
		@style: How to format the maths expression. Valid values are:
			'inline' [default] display expression inline
			'display' display expression in its own paragraph
	-->
	<template name="math-inline" match="math|math[@style='inline']">
		<common formats="/latex/xelatex/">\(<xsl:apply-templates />\)</common>
		<common formats="/html/xhtml/"><xsl:apply-templates /></common>
	</template>
	
	<template name="math-display" match="math[@style='display']">
		<common formats="/latex/xelatex/">\[<xsl:apply-templates />\]</common>
		<common formats="/html/xhtml/"><p style="text-align: center;"><xsl:apply-templates /></p></common>
	</template>

	
	<!-- Equation arrays -->
	
	<template name="equation-array" match="equation-array">
		<common formats="/latex/xelatex/">
			<xsl:text>\begin{eqnarray*}
</xsl:text>
			<xsl:apply-templates />
			<xsl:text>\end{eqnarray*}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<table class="equation" border="0" style="margin-left: auto; margin-right: auto;"><xsl:apply-templates /></table>
		</common>
	</template>


	<!-- Hmm, LaTeX uses "&" as separators: how do we know if there's another cell coming?  Ah, but the LaTeX eqnarray can have no more than three columns, so there's no need to generalise. -->
	<template match="equation-array/row">
		<common formats="/latex/xelatex/">
			<xsl:apply-templates select="left" /><xsl:text disable-output-escaping="yes">	&amp;	</xsl:text><xsl:apply-templates select="middle" /><xsl:text disable-output-escaping="yes">	&amp;	</xsl:text><xsl:apply-templates select="right" /><xsl:text>	\\
\\
</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<tr><td align="right"><xsl:apply-templates select="left" /></td><td align="center"><xsl:apply-templates select="middle" /></td><td align="left"><xsl:apply-templates select="right" /></td></tr>
		</common>
	</template>
	

	<!-- Roman (upright) text inside math environments.  \mathrm sounds like it's probably more correct, but doesn't retain spaces (which \textup does). -->
	<template name="math-text" match="text">
		<common formats="/latex/xelatex/">\textup{<xsl:apply-templates />}</common>
		<common formats="/html/xhtml/"><xsl:apply-templates /></common>
	</template>
	
	<!--
		Calligraphic letters (upper case only for LaTeX).
	-->
	<template name="calligraphic-text" match="calligraphic|cursive">
		<common formats="/latex/xelatex/">\ensuremath{\mathcal{<xsl:apply-templates />}}</common>
		<common formats="/html/xhtml/"><font face="cursive"><xsl:apply-templates /></font></common>
	</template>
	
	<!-- Digit grouping separator character for large numbers.  SI conventions say this should be a space (but we could make it a comma if desired). -->
	<template name="digit-group-separator" match="digit-group-separator|digitsep">
		<common><xsl:call-template name="thin-space" /></common>
	</template>

	<!-- Mathematical super- and subscript. -->
	<template name="superscript-math" match="math//superscript">
		<common formats="/latex/xelatex/">\ensuremath{^{<xsl:apply-templates />}}</common>
		<common formats="/html/xhtml/"><sup><xsl:apply-templates /></sup></common>
	</template>
	
	<template name="subscript-math" match="math//subscript">
		<common formats="/latex/xelatex/">\ensuremath{_{<xsl:apply-templates />}}</common>
		<common formats="/html/xhtml/"><sub><xsl:apply-templates /></sub></common>
	</template>
	
	<!--
		The equivalent of LaTeX's "log-like functions".
		
		@name: The name of the function. We assume the names used by
		LaTeX here, as they work out correct anyway. There's actually
		nothing to stop you using any name you like, except that it'll
		probably die horribly in LaTeX :) [required]
	-->
	<template name="log-like-function" match="function">
		<common formats="/latex/xelatex/">\ensuremath{\<xsl:value-of select="@name" />}</common>
		<common formats="/html/xhtml/"><xsl:value-of select="@name" /></common>
	</template>
	
	<!-- Any mathematical variable names. -->
	<template name="math-variable" match="variable|var">
		<common formats="/latex/xelatex/">\ensuremath{\mathit{<xsl:apply-templates />}}</common>
		<common formats="/html/xhtml/"><i><xsl:apply-templates /></i></common>
	</template>
	
	<!-- A displayed fraction. Is there a nicer way of doing this in HTML? -->
	<template name="math-fraction" match="fraction">
		<common formats="/latex/xelatex/">\ensuremath{\frac{<xsl:apply-templates select="numerator" />}{<xsl:apply-templates select="denominator" />}}</common>
		<html>
			<sup><xsl:apply-templates select="numerator" /></sup>
			<xsl:text disable-output-escaping="yes">&amp;frasl;</xsl:text>
			<sub><xsl:apply-templates select="denominator" /></sub>
		</html>
		<xhtml>
			<sup><xsl:apply-templates select="numerator" /></sup>
			<span class="unicode">
				<!-- U+2044 FRACTION SLASH -->
				<xsl:text>⁄</xsl:text>
			</span>
			<sub><xsl:apply-templates select="denominator" /></sub>
		</xhtml>
	</template>
	
	
	<!--
		Format a University paper code. These normally appear in the form
		"SPOD 123", i.e., a space between the subject code and the paper
		number.
	-->
	<template name="paper" match="paper">
		<common>
			<xsl:apply-templates select="subject-code" />
			<xsl:text> </xsl:text>
			<xsl:apply-templates select="paper-number" />
		</common>
	</template>
	
	<template name="subject-code" match="paper/subject-code">
		<common><xsl:apply-templates /></common>
	</template>
		
	<template name="paper-number" match="paper/paper-number">
		<common><xsl:apply-templates /></common>
	</template>
	
	
	<!--
		Create a layout of multiple columns across the page. By default,
		columns are of equal width, but may be varied on a
		column-by-column basis. Each column is totally independent of
		the others, i.e., you can't have text automatically flowing from
		one column to the next (yet).
		
		@vspace: The amount of vertical space to put around the
		multi-column elements. [small, medium, big, LaTeX length, NONE]
		
		@align: Overall alignment of the columns (only relevant if the
		total width of the columns is less than the page width). [LEFT,
		center, right]
		
		@width: Total width of the column set, expressed as a fraction
		of the usable page width between 0 and 1 (this will be
		multiplied by 100 for HTML). Individual column widths are then
		expressed as a fraction of this total width. [default is 1]
	-->
	<template name="multi-column" match="multi-column">
		<common formats="/latex/xelatex/">
			<xsl:variable name="total-width">
				<xsl:value-of select="1" />
				<xsl:if test="@width"><xsl:value-of select="@width" /></xsl:if>
			</xsl:variable>
			<xsl:choose>
				<xsl:when test="@vspace = 'small'">\smallskip</xsl:when>
				<xsl:when test="@vspace = 'medium'">\medskip</xsl:when>
				<xsl:when test="@vspace = 'big'">\bigskip</xsl:when>
				<xsl:when test="@vspace">\vskip<xsl:value-of select="@vspace" /></xsl:when>
			</xsl:choose>
			\noindent
			<xsl:if test="@align">
				<xsl:text>\begin{</xsl:text>
				<xsl:choose>
					<xsl:when test="(@align = 'left') or (@align = 'right')">
						<xsl:text>flush</xsl:text><xsl:value-of select="@align" />
					</xsl:when>
					<xsl:when test="(@align = 'center') or (@align = 'centre')">
						<xsl:text>center</xsl:text>
					</xsl:when>
				</xsl:choose>
				<xsl:text>}</xsl:text>
			</xsl:if>
			<xsl:apply-templates>
				<xsl:with-param name="default-width">
					<xsl:value-of select="format-number($total-width div count(column),'0.00')" />
				</xsl:with-param>
			</xsl:apply-templates>
			<xsl:if test="@align">
				<xsl:text>\end{</xsl:text>
				<xsl:choose>
					<xsl:when test="(@align = 'left') or (@align = 'right')">
						<xsl:text>flush</xsl:text><xsl:value-of select="@align" />
					</xsl:when>
					<xsl:when test="(@align = 'center') or (@align = 'centre')">
						<xsl:text>center</xsl:text>
					</xsl:when>
				</xsl:choose>
				<xsl:text>}</xsl:text>
			</xsl:if>
			<xsl:choose>
				<xsl:when test="@vspace = 'small'">\smallskip</xsl:when>
				<xsl:when test="@vspace = 'medium'">\medskip</xsl:when>
				<xsl:when test="@vspace = 'big'">\bigskip</xsl:when>
				<xsl:when test="@vspace">\vskip<xsl:value-of select="@vspace" /></xsl:when>
			</xsl:choose>
		</common>
		<common formats="/html/xhtml/">
			<xsl:variable name="total-width">
				<xsl:value-of select="100" />
				<xsl:if test="@width"><xsl:value-of select="@width * 100" /></xsl:if>
			</xsl:variable>
			<xsl:if test="@vspace"><br /></xsl:if>
			<table border="0" width="{$total-width}%">
				<xsl:if test="@align">
					<xsl:attribute name="align">
						<xsl:value-of select="@align" />
					</xsl:attribute>
				</xsl:if>
				<tr>
					<xsl:apply-templates>
						<xsl:with-param name="default-width">
							<xsl:value-of select="round($total-width div count(column))" />
						</xsl:with-param>
					</xsl:apply-templates>
				</tr>
			</table>
			<xsl:if test="@vspace"><br /></xsl:if>
		</common>
	</template>
	
	<!--
		A column within a multi-column element.
		
		$default-width: The default width of the column, expressed as a
		fraction of the total column set width. This is calculated by
		the <multi-column> template and should be 1/n of the column set
		width, where n is the number of columns.
		
		@width: The width of this particular column (overrides the
		default). This should be expressed as a fraction between 0 and 1
		(which is then multipled by 100 for HTML). Make sure that all
		widths add up!
		
		@align: How each individual column is to be aligned internally.
	-->
	<template name="multi-column-column" match="multi-column/column">
		<common formats="/latex/xelatex/">
			<xsl:param name="default-width">1</xsl:param>
			<xsl:text>\begin{minipage}{</xsl:text>
			<xsl:choose>
				<xsl:when test="@width"><xsl:value-of select="@width" /></xsl:when>
				<xsl:otherwise><xsl:value-of select="$default-width" /></xsl:otherwise>
			</xsl:choose>
			<xsl:text>\columnwidth}</xsl:text>
			<xsl:if test="@align">
				<xsl:text>\begin{</xsl:text>
				<xsl:choose>
					<xsl:when test="(@align = 'left') or (@align = 'right')">
						<xsl:text>flush</xsl:text><xsl:value-of select="@align" />
					</xsl:when>
					<xsl:when test="(@align = 'center') or (@align = 'centre')">
						<xsl:text>center</xsl:text>
					</xsl:when>
				</xsl:choose>
				<xsl:text>}</xsl:text>
			</xsl:if>
			<xsl:apply-templates />
			<xsl:if test="@align">
				<xsl:text>\end{</xsl:text>
				<xsl:choose>
					<xsl:when test="(@align = 'left') or (@align = 'right')">
						<xsl:text>flush</xsl:text><xsl:value-of select="@align" />
					</xsl:when>
					<xsl:when test="(@align = 'center') or (@align = 'centre')">
						<xsl:text>center</xsl:text>
					</xsl:when>
				</xsl:choose>
				<xsl:text>}</xsl:text>
			</xsl:if>
			<xsl:text>\end{minipage}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<xsl:param name="default-width">100</xsl:param>
			<td>
				<xsl:attribute name="width">
					<xsl:choose>
						<xsl:when test="@width"><xsl:value-of select="@width * 100" /></xsl:when>
						<xsl:otherwise><xsl:value-of select="$default-width" /></xsl:otherwise>
					</xsl:choose>
					<xsl:text>%</xsl:text>
				</xsl:attribute>
				<xsl:if test="@align">
					<xsl:attribute name="align">
						<xsl:value-of select="@align" />
					</xsl:attribute>
				</xsl:if>
				<xsl:apply-templates />
			</td>
		</common>
	</template>
	
	
	<!--
		Center stuff on the page.
	-->
	<template name="center" match="center|centering|centre|centring">
		<common formats="/latex/xelatex/">
			\begin{center}
				<xsl:apply-templates />
			\end{center}
		</common>
		<common formats="/html/xhtml/">
			<div style="text-align: center;">
				<xsl:apply-templates />
			</div>
		</common>
	</template>
	
	
	<!--
		Simple numbered bibliographies and reference lists (equivalent
		to LaTeX "plain" style biblipgraphies). We could go the whole
		hog and try to do something BibTeX-like, but I can't be bothered
		:)  This is essentially similar to manually creating a LaTeX
		bibliography, so it's up to the writer to ensure that items are
		correctly sorted and formatted. An important point to note is
		that all items will be included, regardless of whether they are
		cited or not. This should suffice for most of what we want to do
		for teaching, though.
		
		@name: The name of the section as it should appear in print.
		"References" is used if not specified.
		
	-->
	<template name="bibliography" match="bibliography">
		<common formats="/latex/xelatex/">
			<xsl:if test="@name">
				\renewcommand{\refname}{<xsl:value-of select="@name" />}
			</xsl:if>
			\bibliographystyle{plain}
			\begin{thebibliography}{99}
			<xsl:apply-templates />
			\end{thebibliography}
		</common>
		<common formats="/html/xhtml/">
			<h1>
				<xsl:value-of select="@name" />
				<xsl:if test="not(@name)">References</xsl:if>
			</h1>
			<ol>
				<xsl:apply-templates />
			</ol>
		</common>
	</template>
	
	<!--
		An item within a bibliography.
		
		@label: The unique label of the bibliography item, so it can
		be cited. [REQUIRED]
	-->
	<template name="bibitem" match="bibliography/item">
		<common formats="/latex/xelatex/">\bibitem{<xsl:value-of select="@label" />} <xsl:apply-templates /></common>
		<common formats="/html/xhtml/">
			<li><a id="{@label}"></a><xsl:apply-templates /></li>
		</common>
	</template>
	
	<!--
		A citation. To cater for multiple cited items, the items are
		specified using nested <item> elements rather than a "label"
		attribute. There must be at least one item. Each item must have
		a "label" attribute.
	-->
	<template name="citation" match="cite">
		<common formats="/latex/xelatex/">\cite{<xsl:apply-templates select="item" />}</common>
		<common formats="/html/xhtml/">
			<xsl:variable name="id">
				<xsl:value-of select="@label" />
			</xsl:variable>
			<xsl:text> [</xsl:text>
			<xsl:apply-templates select="item" />
			<xsl:text>]</xsl:text>
		</common>
	</template>
	
	<!--
		A cited item.
		
		@label: The unique label of the cited item. [REQUIRED]
	-->
	<template name="citation-item" match="cite/item">
		<common formats="/latex/xelatex/">
			<xsl:value-of select="@label" />
			<xsl:if test="position() != last()"><xsl:text>,</xsl:text></xsl:if>
		</common>
		<common formats="/html/xhtml/">
			<xsl:variable name="id">
				<xsl:value-of select="@label" />
			</xsl:variable>
			<a href="#{@label}"><xsl:value-of select="1 + count(//bibliography/item[@label = $id]/preceding-sibling::*)" /></a>
			<xsl:if test="position() != last()"><xsl:text>, </xsl:text></xsl:if>
		</common>
	</template>
	
	
	<!--
		Format numbers.
	-->
	<include href="modules/number-formatting.xml" />
	

</stylesheet>