Implemented cross-references to list items

nigel.stanger / XML

Browse code Implemented cross-references to list items • Added label attribute to <item> element. • Added cross-referencing to <item> labels. Note this only makes sense for enumerated lists, but this isn’t checked as there’s no clean way to do it. There’s also no check that the <item> is inside a list element, because there are about a billion different element variants that can be used to specify a list. master
1 parent ae061a1 commit 25904ad122cf824a76da9b5a767b99e9a01b5323 Nigel Stanger authored on 20 Feb 2019

Browse code

• Added label attribute to <item> element.
• Added cross-referencing to <item> labels.

Note this only makes sense for enumerated lists, but this isn’t checked
as there’s no clean way to do it. There’s also no check that the <item>
is inside a list element, because there are about a billion different
element variants that can be used to specify a list.

master

1 parent ae061a1 commit 25904ad122cf824a76da9b5a767b99e9a01b5323

Nigel Stanger authored on 20 Feb 2019

Patch

Showing 2 changed files

                Ignore Space
               Show notes
              View
            
          
          27 ■■■■■
          modules/cross-references.xml
 		</common>
	</template>
	
	
	<!--
	    List item reference.
	    
	    There are WAY too many different list element types to properly specify the match. Let's just stick with "item".
	    
	    Items don't have a corresponding "name", so the surrounding text will have to supply it. Make sure to include such text in any hyperlink associated with the reference.
	-->
	<template name="list-item-reference" match="item" mode="reference">
		<common formats="/latex/xelatex/">
			<xsl:text>\ref*{</xsl:text>
			<xsl:value-of select="@label" />
			<xsl:text>}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<xsl:choose>
				<xsl:when test="$showanswers = ('yes', 'y', 'true', 't', '1')">
				    <!-- it only really makes sense to count "item" elements within the same list -->
					<xsl:number count="item" level="single" format="1" />
				</xsl:when>
				<xsl:otherwise>
					<xsl:number count="item[not(ancestor::answer) and not(ancestor::omit) and not(ancestor::comment)]" level="single" format="1" />
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>
	
	
	<!--
		Common template for item page references, as they're identical for all items. Standalone page references (i.e., not to a specific item) are dealt with below. Only relevant to (Xe)LaTeX as (X)HTML doesn't have pages.
	-->
	<template name="item-page-reference" match="section|figure|table|exercise" mode="page-reference">

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

<!--
	Cross-references. Note the distinction betwen these and hyperlinks: a cross-reference is merely something like "see Section 2.3", and doesn't necessarily imply a hyperlink, or vice versa.
	
	The "reference" mode templates generate the main reference text, e.g., "see Section 2.3", "see Figure 1", etc. The "page-reference" mode template generate page reference text, e.g., "on page 23".
-->

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


	<!--
		Top level template for cross-references. There are separate templates below for each type of referenced item, as this is easier to implement.
		
		@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', 'y', 'true', 't', '1')">
				<xsl:apply-templates select="//*[@label = current()/@label]" mode="page-reference" />
			</xsl:if>
		</common>
	</template>
	
	
	<!-- ERROR: reference element with no label. -->
	<template name="broken-reference" match="reference[not( @label )]">
		<common>
			<xsl:message terminate="yes">Reference elements must include a label attribute.</xsl:message>
		</common>
	</template>
	
	
	<!-- Section reference. -->
	<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>
	
	
	<!-- Figure reference. -->
	<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', 'y', 'true', 't', '1')">
					<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>
	
	
	<!-- Table reference. -->
	<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', 'y', 'true', 't', '1')">
					<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>
	
	
	<!-- Exercise reference. -->
	<template name="exercise-reference" match="exercise" mode="reference">
		<common formats="/latex/xelatex/">
			<xsl:text>Exercise~\ref*{</xsl:text>
			<xsl:value-of select="@label" />
			<xsl:text>}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<xsl:text disable-output-escaping="yes">Exercise&amp;nbsp;</xsl:text>
			<xsl:choose>
				<xsl:when test="$showanswers = ('yes', 'y', 'true', 't', '1')">
					<xsl:number count="exercise" level="any" format="1" />
				</xsl:when>
				<xsl:otherwise>
					<xsl:number count="exercise[not(ancestor::answer) and not(ancestor::omit) and not(ancestor::comment)]" level="any" format="1" />
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>
	
	
	<!--
	    List item reference.
	    
	    There are WAY too many different list element types to properly specify the match. Let's just stick with "item".
	    
	    Items don't have a corresponding "name", so the surrounding text will have to supply it. Make sure to include such text in any hyperlink associated with the reference.
	-->
	<template name="list-item-reference" match="item" mode="reference">
		<common formats="/latex/xelatex/">
			<xsl:text>\ref*{</xsl:text>
			<xsl:value-of select="@label" />
			<xsl:text>}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<xsl:choose>
				<xsl:when test="$showanswers = ('yes', 'y', 'true', 't', '1')">
				    <!-- it only really makes sense to count "item" elements within the same list -->
					<xsl:number count="item" level="single" format="1" />
				</xsl:when>
				<xsl:otherwise>
					<xsl:number count="item[not(ancestor::answer) and not(ancestor::omit) and not(ancestor::comment)]" level="single" format="1" />
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>
	
	
	<!--
		Common template for item page references, as they're identical for all items. Standalone page references (i.e., not to a specific item) are dealt with below. Only relevant to (Xe)LaTeX as (X)HTML doesn't have pages.
	-->
	<template name="item-page-reference" match="section|figure|table|exercise" 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. Any content within the element is ignored.
		
		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>
	
	<!-- ERROR: page element with no label. -->
	<template name="broken-page" match="page[not( @label )]">
		<common>
			<xsl:message terminate="yes">Page elements must include a label attribute.</xsl:message>
		</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 should be).
	-->
	<template name="direct-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>
	
	
</stylesheet>

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

<!--
	Cross-references. Note the distinction betwen these and hyperlinks: a cross-reference is merely something like "see Section 2.3", and doesn't necessarily imply a hyperlink, or vice versa.
	
	The "reference" mode templates generate the main reference text, e.g., "see Section 2.3", "see Figure 1", etc. The "page-reference" mode template generate page reference text, e.g., "on page 23".
-->

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


	<!--
		Top level template for cross-references. There are separate templates below for each type of referenced item, as this is easier to implement.
		
		@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', 'y', 'true', 't', '1')">
				<xsl:apply-templates select="//*[@label = current()/@label]" mode="page-reference" />
			</xsl:if>
		</common>
	</template>
	
	
	<!-- ERROR: reference element with no label. -->
	<template name="broken-reference" match="reference[not( @label )]">
		<common>
			<xsl:message terminate="yes">Reference elements must include a label attribute.</xsl:message>
		</common>
	</template>
	
	
	<!-- Section reference. -->
	<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>
	
	
	<!-- Figure reference. -->
	<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', 'y', 'true', 't', '1')">
					<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>
	
	
	<!-- Table reference. -->
	<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', 'y', 'true', 't', '1')">
					<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>
	
	
	<!-- Exercise reference. -->
	<template name="exercise-reference" match="exercise" mode="reference">
		<common formats="/latex/xelatex/">
			<xsl:text>Exercise~\ref*{</xsl:text>
			<xsl:value-of select="@label" />
			<xsl:text>}</xsl:text>
		</common>
		<common formats="/html/xhtml/">
			<xsl:text disable-output-escaping="yes">Exercise&amp;nbsp;</xsl:text>
			<xsl:choose>
				<xsl:when test="$showanswers = ('yes', 'y', 'true', 't', '1')">
					<xsl:number count="exercise" level="any" format="1" />
				</xsl:when>
				<xsl:otherwise>
					<xsl:number count="exercise[not(ancestor::answer) and not(ancestor::omit) and not(ancestor::comment)]" level="any" format="1" />
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>
	
	
	<!--
		Common template for item page references, as they're identical for all items. Standalone page references (i.e., not to a specific item) are dealt with below. Only relevant to (Xe)LaTeX as (X)HTML doesn't have pages.
	-->
	<template name="item-page-reference" match="section|figure|table|exercise" 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. Any content within the element is ignored.
		
		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>
	
	<!-- ERROR: page element with no label. -->
	<template name="broken-page" match="page[not( @label )]">
		<common>
			<xsl:message terminate="yes">Page elements must include a label attribute.</xsl:message>
		</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 should be).
	-->
	<template name="direct-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>
	
	
</stylesheet>
 		</common>
 	</template>
+	<!--
+	    List item reference.
+	    There are WAY too many different list element types to properly specify the match. Let's just stick with "item".
+	    Items don't have a corresponding "name", so the surrounding text will have to supply it. Make sure to include such text in any hyperlink associated with the reference.
+	-->
+	<template name="list-item-reference" match="item" mode="reference">
+		<common formats="/latex/xelatex/">
+			<xsl:text>\ref*{</xsl:text>
+			<xsl:value-of select="@label" />
+			<xsl:text>}</xsl:text>
+		</common>
+		<common formats="/html/xhtml/">
+			<xsl:choose>
+				<xsl:when test="$showanswers = ('yes', 'y', 'true', 't', '1')">
+				    <!-- it only really makes sense to count "item" elements within the same list -->
+					<xsl:number count="item" level="single" format="1" />
+				</xsl:when>
+				<xsl:otherwise>
+					<xsl:number count="item[not(ancestor::answer) and not(ancestor::omit) and not(ancestor::comment)]" level="single" format="1" />
+				</xsl:otherwise>
+			</xsl:choose>
+		</common>
+	</template>
 	<!--
 		Common template for item page references, as they're identical for all items. Standalone page references (i.e., not to a specific item) are dealt with below. Only relevant to (Xe)LaTeX as (X)HTML doesn't have pages.
 	-->
 	<template name="item-page-reference" match="section|figure|table|exercise" mode="page-reference">

                Ignore Space
               Show notes
              View
            
          
          35 ■■■■■
          modules/lists.xml
 		</common>
	</template>
 
 
	<!-- List items for non-definition lists. -->
	<!--
	    List items for non-definition lists.
	    
		@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. This is really only applicable to enumerated lists.
	-->
	<template name="list-item" match="item" mode="normal">
		<common formats="/latex/xelatex/">
			<xsl:text>\item </xsl:text>
			<xsl:if test="@label">
			    <xsl:text>\label{</xsl:text>
			    <xsl:value-of select="@label" />
			    <xsl:text>}</xsl:text>
			</xsl:if>
			<xsl:apply-templates />
			<xsl:call-template name="newline-internal" />
		</common>
		<common formats="/html/xhtml/">
				<!--
					Otherwise, insert <p> tags surrounding the item content so that the item spacing looks OK.
				-->
				<xsl:otherwise>
					<li><p><xsl:apply-templates /></p></li>
					<li>
                        <xsl:if test="@label">
                            <xsl:element name="a">
                                <xsl:attribute name="name">
                    			    <xsl:value-of select="@label" />
                    			</xsl:attribute>
                    		</xsl:element>
                        </xsl:if>
					    <p><xsl:apply-templates /></p>
					</li>
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>

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

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

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


	<!-- Unordered lists -->
	
	<template name="itemised-list" match="itemised-list|itemize|unordered-list|bulleted-list|bullet-list|bullet-points|UL|ul">
		<common formats="/latex/xelatex/">
			<xsl:call-template name="newline-internal" />
			<xsl:text>\begin{itemize}</xsl:text>
			<xsl:call-template name="newline-internal" />
			<xsl:apply-templates select="item" mode="normal" />
			<xsl:call-template name="newline-internal" />
			<xsl:text>\end{itemize}</xsl:text>
			<xsl:call-template name="newline-internal" />
		</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/">
			<xsl:call-template name="newline-internal" />
			<xsl:text>\begin{enumerate}</xsl:text>
			<xsl:call-template name="newline-internal" />
			<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).
				-->
				<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" />
			<xsl:call-template name="newline-internal" />
			<xsl:text>\end{enumerate}</xsl:text>
			<xsl:call-template name="newline-internal" />
		</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/">
			<xsl:call-template name="newline-internal" />
			<xsl:text>\begin{description}</xsl:text>
			<xsl:call-template name="newline-internal" />
			<xsl:apply-templates select="item" mode="definition-list" />
			<xsl:call-template name="newline-internal" />
			<xsl:text>\end{description}</xsl:text>
			<xsl:call-template name="newline-internal" />
		</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 items for non-definition lists.
	    
		@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. This is really only applicable to enumerated lists.
	-->
	<template name="list-item" match="item" mode="normal">
		<common formats="/latex/xelatex/">
			<xsl:text>\item </xsl:text>
			<xsl:if test="@label">
			    <xsl:text>\label{</xsl:text>
			    <xsl:value-of select="@label" />
			    <xsl:text>}</xsl:text>
			</xsl:if>
			<xsl:apply-templates />
			<xsl:call-template name="newline-internal" />
		</common>
		<common formats="/html/xhtml/">
			<xsl:choose>
				<!--
					Check whether there are actual paragraphs or things that should be treated like paragraphs inside the item (there are rather a lot of these!). If so, let them worry about inserting the <p> tags.
				-->
				<xsl:when test="count(paragraph|para|p|question|answer|code-block|itemised-list|itemize|unordered-list|bulleted-list|bullet-list|bullet-points|UL|ul|enumerated-list|enumerate|ordered-list|numbered-list|question-list|OL|ol|definition-list|description-list|DL|dl) ne 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>
                        <xsl:if test="@label">
                            <xsl:element name="a">
                                <xsl:attribute name="name">
                    			    <xsl:value-of select="@label" />
                    			</xsl:attribute>
                    		</xsl:element>
                        </xsl:if>
					    <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:call-template name="newline-internal" />
			<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 (there are rather a lot of these!). If so, let them worry about inserting the <p> tags.
				-->
				<xsl:when test="count(paragraph|para|p|question|answer|code-block|itemised-list|itemize|unordered-list|bulleted-list|bullet-list|bullet-points|UL|ul|enumerated-list|enumerate|ordered-list|numbered-list|question-list|OL|ol|definition-list|description-list|DL|dl) ne 0">
					<li value="{@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 value="{@value}">
						<p><xsl:apply-templates /></p>
					</li>
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>
	
	<!-- Normally numbered enumerated item. -->
	<template name="enumerated-item" match="item[not( @value )]" mode="enumerated-list">
		<common>
			<xsl:apply-templates select="." mode="normal" />
		</common>
	</template>
	

	<!-- List items for definition lists. -->
	<template name="definition-item" match="item" mode="definition-list">
		<common formats="/latex/xelatex/">
			<xsl:apply-templates select="keyword|term|topic|DT|dt" mode="definition-list" />
			<xsl:apply-templates select="definition|description|discourse|DD|dd" mode="definition-list" />
			<xsl:call-template name="newline-internal" />
		</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>
	
	<!--
		We need to use a mode here as, e.g., <term> is also a standalone element.
		
		@linebreak: If "yes", insert a line break after the item label. [default "no"]
		    This attribute really only makes sense for the keyword elements of definition lists.
	-->
	<template name="keyword" match="keyword|term|topic|DT|dt" mode="definition-list">
		<common formats="/latex/xelatex/">
			<xsl:text>\item[</xsl:text>
			<xsl:apply-templates />
			<xsl:text>] </xsl:text>
			<xsl:if test="@linebreak">
			    <xsl:text>\mbox{}\newline</xsl:text>
			</xsl:if>
		</common>
		<common formats="/html/xhtml/">
			<strong><xsl:apply-templates /></strong>
            <xsl:if test="@linebreak">
                <br />
            </xsl:if>
		</common>
	</template>
	
	<!--
		Need to provide some context here as, e.g., <description> is also used within <image>.
	-->
	<template name="definition" match="definition|description|discourse|DD|dd" mode="definition-list">
		<common>
			<xsl:apply-templates />
		</common>
	</template>


</stylesheet>

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

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

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


	<!-- Unordered lists -->
	
	<template name="itemised-list" match="itemised-list|itemize|unordered-list|bulleted-list|bullet-list|bullet-points|UL|ul">
		<common formats="/latex/xelatex/">
			<xsl:call-template name="newline-internal" />
			<xsl:text>\begin{itemize}</xsl:text>
			<xsl:call-template name="newline-internal" />
			<xsl:apply-templates select="item" mode="normal" />
			<xsl:call-template name="newline-internal" />
			<xsl:text>\end{itemize}</xsl:text>
			<xsl:call-template name="newline-internal" />
		</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/">
			<xsl:call-template name="newline-internal" />
			<xsl:text>\begin{enumerate}</xsl:text>
			<xsl:call-template name="newline-internal" />
			<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).
				-->
				<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" />
			<xsl:call-template name="newline-internal" />
			<xsl:text>\end{enumerate}</xsl:text>
			<xsl:call-template name="newline-internal" />
		</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/">
			<xsl:call-template name="newline-internal" />
			<xsl:text>\begin{description}</xsl:text>
			<xsl:call-template name="newline-internal" />
			<xsl:apply-templates select="item" mode="definition-list" />
			<xsl:call-template name="newline-internal" />
			<xsl:text>\end{description}</xsl:text>
			<xsl:call-template name="newline-internal" />
		</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 items for non-definition lists. -->
	<template name="list-item" match="item" mode="normal">
		<common formats="/latex/xelatex/">
			<xsl:text>\item </xsl:text>
			<xsl:apply-templates />
			<xsl:call-template name="newline-internal" />
		</common>
		<common formats="/html/xhtml/">
			<xsl:choose>
				<!--
					Check whether there are actual paragraphs or things that should be treated like paragraphs inside the item (there are rather a lot of these!). If so, let them worry about inserting the <p> tags.
				-->
				<xsl:when test="count(paragraph|para|p|question|answer|code-block|itemised-list|itemize|unordered-list|bulleted-list|bullet-list|bullet-points|UL|ul|enumerated-list|enumerate|ordered-list|numbered-list|question-list|OL|ol|definition-list|description-list|DL|dl) ne 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:call-template name="newline-internal" />
			<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 (there are rather a lot of these!). If so, let them worry about inserting the <p> tags.
				-->
				<xsl:when test="count(paragraph|para|p|question|answer|code-block|itemised-list|itemize|unordered-list|bulleted-list|bullet-list|bullet-points|UL|ul|enumerated-list|enumerate|ordered-list|numbered-list|question-list|OL|ol|definition-list|description-list|DL|dl) ne 0">
					<li value="{@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 value="{@value}">
						<p><xsl:apply-templates /></p>
					</li>
				</xsl:otherwise>
			</xsl:choose>
		</common>
	</template>
	
	<!-- Normally numbered enumerated item. -->
	<template name="enumerated-item" match="item[not( @value )]" mode="enumerated-list">
		<common>
			<xsl:apply-templates select="." mode="normal" />
		</common>
	</template>
	

	<!-- List items for definition lists. -->
	<template name="definition-item" match="item" mode="definition-list">
		<common formats="/latex/xelatex/">
			<xsl:apply-templates select="keyword|term|topic|DT|dt" mode="definition-list" />
			<xsl:apply-templates select="definition|description|discourse|DD|dd" mode="definition-list" />
			<xsl:call-template name="newline-internal" />
		</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>
	
	<!--
		We need to use a mode here as, e.g., <term> is also a standalone element.
		
		@linebreak: If "yes", insert a line break after the item label. [default "no"]
		    This attribute really only makes sense for the keyword elements of definition lists.
	-->
	<template name="keyword" match="keyword|term|topic|DT|dt" mode="definition-list">
		<common formats="/latex/xelatex/">
			<xsl:text>\item[</xsl:text>
			<xsl:apply-templates />
			<xsl:text>] </xsl:text>
			<xsl:if test="@linebreak">
			    <xsl:text>\mbox{}\newline</xsl:text>
			</xsl:if>
		</common>
		<common formats="/html/xhtml/">
			<strong><xsl:apply-templates /></strong>
            <xsl:if test="@linebreak">
                <br />
            </xsl:if>
		</common>
	</template>
	
	<!--
		Need to provide some context here as, e.g., <description> is also used within <image>.
	-->
	<template name="definition" match="definition|description|discourse|DD|dd" mode="definition-list">
		<common>
			<xsl:apply-templates />
		</common>
	</template>


</stylesheet>
 		</common>
 	</template>
+	<!-- List items for non-definition lists. -->
+	<!--
+	    List items for non-definition lists.
+		@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. This is really only applicable to enumerated lists.
+	-->
 	<template name="list-item" match="item" mode="normal">
 		<common formats="/latex/xelatex/">
 			<xsl:text>\item </xsl:text>
+			<xsl:if test="@label">
+			    <xsl:text>\label{</xsl:text>
+			    <xsl:value-of select="@label" />
+			    <xsl:text>}</xsl:text>
+			</xsl:if>
 			<xsl:apply-templates />
 			<xsl:call-template name="newline-internal" />
 		</common>
 		<common formats="/html/xhtml/">
 				<!--
 					Otherwise, insert <p> tags surrounding the item content so that the item spacing looks OK.
 				-->
 				<xsl:otherwise>
+					<li><p><xsl:apply-templates /></p></li>
+					<li>
+                        <xsl:if test="@label">
+                            <xsl:element name="a">
+                                <xsl:attribute name="name">
+                    			    <xsl:value-of select="@label" />
+                    			</xsl:attribute>
+                    		</xsl:element>
+                        </xsl:if>
+					    <p><xsl:apply-templates /></p>
+					</li>
 				</xsl:otherwise>
 			</xsl:choose>
 		</common>
 	</template>

Show line notes below