move manual to top-level directory, split out of debian-installer package

1 files changed, 282 insertions, 0 deletions

diff --git a/build/stylesheets/db2latex/latex.mapping.xsl b/build/stylesheets/db2latex/latex.mapping.xsl
new file mode 100644
index 000000000..a1dc5dbf2
--- /dev/null
+++ b/build/stylesheets/db2latex/latex.mapping.xsl
@@ -0,0 +1,282 @@
+<?xml version='1.0'?>
+<!DOCTYPE xsl:stylesheet [ <!ENTITY % xsldoc.ent SYSTEM "./xsldoc.ent"> %xsldoc.ent; ]>
+<!--#############################################################################
+|      $Id: latex.mapping.xsl,v 1.18 2004/01/14 14:54:32 j-devenish Exp $
+|- #############################################################################
+|      $Author: j-devenish $
+|
+|   PURPOSE:
++ ############################################################################## -->
+
+<xsl:stylesheet
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+    xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
+    exclude-result-prefixes="doc" version='1.0'>
+
+	<!--############################################################################# -->
+	<!-- DOCUMENTATION                                                                -->
+	<doc:reference id="latex.mapping" xmlns="">
+		<referenceinfo>
+			<releaseinfo role="meta">
+			$Id: latex.mapping.xsl,v 1.18 2004/01/14 14:54:32 j-devenish Exp $
+			</releaseinfo>
+			<authorgroup>
+				&ramon; &james;
+			</authorgroup>
+			<copyright>
+			<year>2000</year> <year>2001</year> <year>2002</year> <year>2003</year>
+			<holder>Ramon Casellas</holder>
+			</copyright>
+			<revhistory>
+				<doc:revision rcasver="1.11">&rev_2003_05;</doc:revision>
+			</revhistory>
+		</referenceinfo>
+		<title>The &DB2LaTeX; mapping system <filename>latex.mapping.xsl</filename></title>
+		<partintro>
+			<section><title>Introduction</title>
+			<para>The &DB2LaTeX; mapping system centralises the mapping
+			of &DocBook; tags (e.g. <doc:db>chapter</doc:db>)
+			to &LaTeX; commands (e.g. <function condition="latex">chapter</function>).
+			It uses an auxiliary file, <filename>latex.mapping.xml</filename>,
+			to define the start and end of each mapping.
+			You can override this <quote>mapping file</quote>
+			in order to customise &DB2LaTeX;.</para>
+			</section>
+		</partintro>
+	</doc:reference>
+	<!--############################################################################# -->
+
+	<doc:param name="latex.mapping.xml">
+		<refpurpose>The primary mapping file</refpurpose>
+		<doc:description>
+			<para>
+				&DB2LaTeX; will search for mappings in this file.
+				The value of this variable must be an XML document.
+				If mappings cannot be found in this file, &DB2LaTeX; will
+				search the <link linkend="param.latex.mapping.xml.default">default mapping file</link>.
+			</para>
+		</doc:description>
+		<doc:samples>
+			<simplelist type='inline'>
+				&test_mapping;
+			</simplelist>
+		</doc:samples>
+	</doc:param>
+    <xsl:param name="latex.mapping.xml" select="document('latex.mapping.xml')"/>
+
+	<doc:param name="latex.mapping.xml.default">
+		<refpurpose>The default mapping file</refpurpose>
+		<doc:description>
+			<para>
+				Defines the mapping file that &DB2LaTeX; will search
+				when it cannot find a template in the
+				<link linkend="param.latex.mapping.xml">primary mapping file</link>.
+				The value of this variable must be an XML document.
+			</para>
+		</doc:description>
+	</doc:param>
+    <xsl:param name="latex.mapping.xml.default" select="document('latex.mapping.xml')"/>
+
+	<doc:template xmlns="">
+		<refpurpose>Perform &DocBook; to &LaTeX; mapping</refpurpose>
+		<doc:description>
+			
+			
+			
+		</doc:description>
+		<doc:variables>
+			&no_var;
+		</doc:variables>
+		<doc:seealso>
+			<itemizedlist>
+				<listitem><simpara><xref linkend="param.latex.mapping.xml"/></simpara></listitem>
+				<listitem><simpara><xref linkend="param.latex.mapping.xml.default"/></simpara></listitem>
+			</itemizedlist>
+		</doc:seealso>
+	</doc:template>
+	<xsl:template name="latex.mapping">
+		<xsl:param name="object" select="."/>
+		<xsl:param name="keyword" select="local-name($object)"/>
+		<xsl:param name="role" select="begin"/>
+		<xsl:param name="string">
+			<xsl:call-template name="extract.object.title">
+				<xsl:with-param name="object" select="$object"/>
+			</xsl:call-template>
+		</xsl:param>
+		<xsl:variable name="id">
+			<xsl:call-template name="generate.label.id">
+				<xsl:with-param name="object" select="$object"/>
+			</xsl:call-template>
+		</xsl:variable>
+		<xsl:variable name="title">
+			<xsl:choose>
+			<xsl:when test="starts-with(local-name($object),'informal')">
+				<xsl:if test="$string!=''">
+					<xsl:message>Ignoring title for <xsl:value-of select="local-name($object)"/>.</xsl:message>
+				</xsl:if>
+			</xsl:when>
+			<xsl:when test="$string=''">
+				<xsl:call-template name="gentext.element.name"/>
+			</xsl:when>
+			<xsl:otherwise>
+				<xsl:value-of select="normalize-space($string)"/>
+			</xsl:otherwise>
+			</xsl:choose>
+		</xsl:variable>
+		<xsl:variable name="local.mapping" select="$latex.mapping.xml/latexbindings/latexmapping[@role=$role]/mapping[@key=$keyword]"/>
+		<xsl:variable name="default.mapping" select="$latex.mapping.xml.default/latexbindings/latexmapping[@role=$role]/mapping[@key=$keyword]"/>
+		
+		<xsl:choose>
+			<xsl:when test="$local.mapping and ($local.mapping/@text!='' or not($local.mapping/line))">
+				<xsl:call-template name="string-replace">
+					<xsl:with-param name="to"><xsl:value-of select="$id"/></xsl:with-param>
+					<xsl:with-param name="from">%id%</xsl:with-param>
+					<xsl:with-param name="string">
+						<xsl:call-template name="string-replace">
+							<xsl:with-param name="to"><xsl:value-of select="$title"/></xsl:with-param>
+							<xsl:with-param name="from">%title%</xsl:with-param>
+							<xsl:with-param name="string">
+								<xsl:value-of select="$local.mapping/@text"/>
+							</xsl:with-param>
+						</xsl:call-template>
+					</xsl:with-param>
+				</xsl:call-template>
+			</xsl:when>
+
+			<xsl:when test="$local.mapping/line">
+				<xsl:for-each select="$local.mapping/line">
+					<xsl:call-template name="string-replace">
+						<xsl:with-param name="to"><xsl:value-of select="$id"/></xsl:with-param>
+						<xsl:with-param name="from">%id%</xsl:with-param>
+						<xsl:with-param name="string">
+							<xsl:call-template name="string-replace">
+								<xsl:with-param name="to"><xsl:value-of select="$title"/></xsl:with-param>
+								<xsl:with-param name="from">%title%</xsl:with-param>
+								<xsl:with-param name="string" select="."/>
+							</xsl:call-template>
+						</xsl:with-param>
+					</xsl:call-template>
+				</xsl:for-each>
+			</xsl:when>
+
+			<xsl:when test="$default.mapping/@text!=''">
+				<xsl:call-template name="string-replace">
+					<xsl:with-param name="to"><xsl:value-of select="$id"/></xsl:with-param>
+					<xsl:with-param name="from">%id%</xsl:with-param>
+					<xsl:with-param name="string">
+						<xsl:call-template name="string-replace">
+							<xsl:with-param name="to"><xsl:value-of select="$title"/></xsl:with-param>
+							<xsl:with-param name="from">%title%</xsl:with-param>
+							<xsl:with-param name="string">
+								<xsl:value-of select="$default.mapping/@text"/>
+							</xsl:with-param>
+						</xsl:call-template>
+					</xsl:with-param>
+				</xsl:call-template>
+			</xsl:when>
+
+			<xsl:when test="$default.mapping">
+			<xsl:for-each select="$default.mapping/line">
+				<xsl:call-template name="string-replace">
+					<xsl:with-param name="to"><xsl:value-of select="$id"/></xsl:with-param>
+					<xsl:with-param name="from">%id%</xsl:with-param>
+					<xsl:with-param name="string">
+						<xsl:call-template name="string-replace">
+							<xsl:with-param name="to"><xsl:value-of select="$title"/></xsl:with-param>
+							<xsl:with-param name="from">%title%</xsl:with-param>
+							<xsl:with-param name="string" select="."/>
+						</xsl:call-template>
+					</xsl:with-param>
+				</xsl:call-template>
+			</xsl:for-each>
+
+			</xsl:when>
+				<xsl:otherwise>
+					<xsl:message terminate="no">
+						<xsl:text>Warning: Unable to find LaTeX mapping for &#10;</xsl:text>
+						<xsl:text>KEYWORD:</xsl:text><xsl:value-of select="$keyword"/><xsl:text>&#10;</xsl:text>
+						<xsl:text>ROLE:</xsl:text><xsl:value-of select="$role"/><xsl:text>&#10;</xsl:text>
+					</xsl:message>
+				</xsl:otherwise>
+		</xsl:choose>
+	</xsl:template>
+
+
+
+
+    <xsl:template name="map.begin">
+	<xsl:param name="object"  select="."/>
+	<xsl:param name="keyword" select="local-name($object)"/>
+	<xsl:param name="string">
+		<xsl:call-template name="extract.object.title">
+			<xsl:with-param name="object" select="$object"/>
+		</xsl:call-template>
+	</xsl:param>
+	<xsl:call-template name="latex.mapping">
+	    <xsl:with-param name="keyword" select="$keyword"/>
+	    <xsl:with-param name="role">begin</xsl:with-param>
+	    <xsl:with-param name="string" select="$string"/>
+	</xsl:call-template>
+    </xsl:template>
+
+    <xsl:template name="map.end">
+	<xsl:param name="object"  select="."/>
+	<xsl:param name="keyword" select="local-name($object)"/>
+	<xsl:param name="role" 	  select="begin"/>
+	<xsl:param name="string">
+		<xsl:call-template name="extract.object.title">
+			<xsl:with-param name="object" select="$object"/>
+		</xsl:call-template>
+	</xsl:param>
+	<xsl:call-template name="latex.mapping">
+	    <xsl:with-param name="keyword" select="$keyword"/>
+	    <xsl:with-param name="string" select="$string"/>
+	    <xsl:with-param name="role">end</xsl:with-param>
+	</xsl:call-template>
+    </xsl:template>
+
+	<doc:template name="extract.object.title">
+		<refpurpose>Choose a title for an object</refpurpose>
+		<doc:description>
+			<para>
+				Processes the <sgmltag class="element">title</sgmltag> child
+				of the specified object. Uses the context node as the default object.
+			</para>
+		</doc:description>
+		<doc:variables>
+			<itemizedlist>
+				<listitem><simpara><xref linkend="param.latex.apply.title.templates"/></simpara></listitem>
+			</itemizedlist>
+		</doc:variables>
+		<doc:params>
+			<variablelist>
+				<varlistentry><term>object</term><listitem><simpara>The node for which a title is desired.</simpara></listitem></varlistentry>
+			</variablelist>
+		</doc:params>
+	</doc:template>
+	<xsl:template name="extract.object.title">
+		<xsl:param name="object"  select="."/>
+		<xsl:choose>
+			<xsl:when test="$latex.apply.title.templates='1'">
+				<xsl:apply-templates select="$object/title" mode="latex"/>
+			</xsl:when>
+			<xsl:otherwise>
+				<xsl:call-template name="normalize-scape">
+					<xsl:with-param name="string" select="$object/title"/>
+				</xsl:call-template>
+			</xsl:otherwise>
+		</xsl:choose>
+	</xsl:template>
+
+	<doc:template match="title" mode="latex">
+		<refpurpose>Process <doc:db>title</doc:db> elements</refpurpose>
+		<doc:description>
+			<para>Applies templates with no mode. This template is called by <xref linkend="template.extract.object.title"/>.</para>
+			<para>This differs from the modeless <doc:db>title</doc:db>
+			templates because they suppress the output of titles.</para>
+		</doc:description>
+	</doc:template>
+	<xsl:template match="title" mode="latex"><xsl:apply-templates/></xsl:template>
+
+</xsl:stylesheet>
+