diff options
Diffstat (limited to 'docs-xml/xslt/db2latex-xsl/xsl/admonition.mod.xsl')
-rw-r--r-- | docs-xml/xslt/db2latex-xsl/xsl/admonition.mod.xsl | 283 |
1 files changed, 0 insertions, 283 deletions
diff --git a/docs-xml/xslt/db2latex-xsl/xsl/admonition.mod.xsl b/docs-xml/xslt/db2latex-xsl/xsl/admonition.mod.xsl deleted file mode 100644 index c42f040d9c..0000000000 --- a/docs-xml/xslt/db2latex-xsl/xsl/admonition.mod.xsl +++ /dev/null @@ -1,283 +0,0 @@ -<?xml version='1.0'?> -<!DOCTYPE xsl:stylesheet [ <!ENTITY % xsldoc.ent SYSTEM "./xsldoc.ent"> %xsldoc.ent; ]> -<!--############################################################################# -| $Id: admonition.mod.xsl,v 1.14 2004/01/03 09:48:34 j-devenish Exp $ -|- ############################################################################# -| $Author: j-devenish $ -+ ############################################################################## --> -<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'> - - <doc:reference name="admonition" xmlns=""> - <referenceinfo> - <releaseinfo role="meta"> - $Id: admonition.mod.xsl,v 1.14 2004/01/03 09:48:34 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.6">&rev_2003_05;</doc:revision> - </revhistory> - </referenceinfo> - <title>Admonitions <filename>admonition.mod.xsl</filename></title> - <partintro> - <para> - - &DocBook; includes admonitions (<doc:db>warning</doc:db>, - <doc:db>tip</doc:db>, <doc:db>important</doc:db>, - <doc:db>caution</doc:db>, <doc:db>note</doc:db>), which are set off - from the main text. &DB2LaTeX; places these in the normal text flow - but surrounds them with a box border. - - </para> - <doc:variables> - <itemizedlist> - <listitem><simpara><xref linkend="param.latex.use.fancybox"/></simpara></listitem> - <listitem><simpara><xref linkend="param.admon.graphics.path"/></simpara></listitem> - <listitem><simpara><xref linkend="param.latex.admonition.imagesize"/></simpara></listitem> - <listitem><simpara><xref linkend="param.latex.apply.title.templates.admonitions"/></simpara></listitem> - </itemizedlist> - </doc:variables> - </partintro> - </doc:reference> - - <doc:param xmlns=""> - <refpurpose> - Declares a new environment to be used for admonitions - </refpurpose> - <doc:description> - <para> - - This &LaTeX; environment is emitted during the preamble. That - environment has two mandatory parameters. Instances of the - environment are customised for each admonition via those - parameters. Instances will be typeset as boxed areas in the - document flow. - - </para> - <para> - - The first argument is the filename for graphics (e.g. - <filename>$admon.graphics.path/warning</filename>). - The second argument is the admonition title or the associated - generic text. - - </para> - - <example> - <title>Processing the <doc:db>warning</doc:db> admonition</title> - <para> When processing the admonition, the following code is generated: </para> - <programlisting> - <![CDATA[\begin{admonition}{figures/warning}{My WARNING} -... -\end{admonition}]]> - </programlisting> - </example> - </doc:description> - <doc:notes> - <!-- notes about spacing? --> - <para> - The environment uses graphics by default. This may generate errors or warnings - if &LaTeX; cannot find the graphics. If necessary, graphics may be disabled - via <xref linkend="param.admon.graphics.path"/>. - </para> - </doc:notes> - <!-- - <doc:seealso> - <itemizedlist> - <listitem><simpara><xref linkend="template.para"/></simpara></listitem> - </itemizedlist> - </doc:seealso> - --> - <doc:variables> - <itemizedlist> - <listitem><simpara><xref linkend="param.latex.use.fancybox"/></simpara></listitem> - <listitem><simpara><xref linkend="param.admon.graphics.path"/></simpara></listitem> - <listitem><simpara><xref linkend="param.latex.admonition.imagesize"/></simpara></listitem> - </itemizedlist> - </doc:variables> - </doc:param> - - <xsl:param name="latex.admonition.environment"> - <xsl:text>% ---------------------------------------------- </xsl:text> - <xsl:text>% Define a new LaTeX environment (adminipage) </xsl:text> - <xsl:text>% ---------------------------------------------- </xsl:text> - <xsl:text>\newenvironment{admminipage}% </xsl:text> - <xsl:text>{ % this code corresponds to the \begin{adminipage} command </xsl:text> - <xsl:text> \begin{Sbox}% </xsl:text> - <xsl:text> \begin{minipage}% </xsl:text> - <xsl:text>} %done </xsl:text> - <xsl:text>{ % this code corresponds to the \end{adminipage} command </xsl:text> - <xsl:text> \end{minipage} </xsl:text> - <xsl:text> \end{Sbox} </xsl:text> - <xsl:text> \fbox{\TheSbox} </xsl:text> - <xsl:text>} %done </xsl:text> - <xsl:text>% ---------------------------------------------- </xsl:text> - <xsl:text>% Define a new LaTeX length (admlength) </xsl:text> - <xsl:text>% ---------------------------------------------- </xsl:text> - <xsl:text>\newlength{\admlength} </xsl:text> - <xsl:text>% ---------------------------------------------- </xsl:text> - <xsl:text>% Define a new LaTeX environment (admonition) </xsl:text> - <xsl:text>% With 2 parameters: </xsl:text> - <xsl:text>% #1 The file (e.g. note.pdf) </xsl:text> - <xsl:text>% #2 The caption </xsl:text> - <xsl:text>% ---------------------------------------------- </xsl:text> - <xsl:text>\newenvironment{admonition}[2] </xsl:text> - <xsl:text>{ % this code corresponds to the \begin{admonition} command </xsl:text> - <xsl:text> \hspace{0mm}\newline\hspace*\fill\newline </xsl:text> - <xsl:text> \noindent </xsl:text> - <xsl:text> \setlength{\fboxsep}{5pt} </xsl:text> - <xsl:text> \setlength{\admlength}{\linewidth} </xsl:text> - <xsl:text> \addtolength{\admlength}{-10\fboxsep} </xsl:text> - <xsl:text> \addtolength{\admlength}{-10\fboxrule} </xsl:text> - <xsl:text> \admminipage{\admlength} </xsl:text> - <xsl:text> {\bfseries \sc\large{#2}}</xsl:text> - <xsl:text> \newline </xsl:text> - <xsl:text> \\[1mm] </xsl:text> - <xsl:text> \sffamily </xsl:text> - <!-- - If we cannot find the admon.graphics.path; - Comment out the next line (\includegraphics). - This tactic is to avoid deleting the \includegraphics - altogether, as that could confuse a person trying to - find the use of parameter #1 in the environment. - --> - <xsl:if test="$admon.graphics.path=''"> - <xsl:text>%</xsl:text> - </xsl:if> - <xsl:text> \includegraphics[</xsl:text> <xsl:value-of select="$latex.admonition.imagesize" /> <xsl:text>]{#1} </xsl:text> - <xsl:text> \addtolength{\admlength}{-1cm} </xsl:text> - <xsl:text> \addtolength{\admlength}{-20pt} </xsl:text> - <xsl:text> \begin{minipage}[lt]{\admlength} </xsl:text> - <xsl:text> \parskip=0.5\baselineskip \advance\parskip by 0pt plus 2pt </xsl:text> - <xsl:text>} %done </xsl:text> - <xsl:text>{ % this code corresponds to the \end{admonition} command </xsl:text> - <xsl:text> \vspace{5mm} </xsl:text> - <xsl:text> \end{minipage} </xsl:text> - <xsl:text> \endadmminipage </xsl:text> - <xsl:text> \vspace{.5em} </xsl:text> - <xsl:text> \par </xsl:text> - <xsl:text>} </xsl:text> - </xsl:param> - - <doc:template xmlns=""> - <refpurpose> Choose an admonition graphic </refpurpose> - <doc:description> - <para> - - For each admonition element - (<doc:db>warning</doc:db>, <doc:db>tip</doc:db>, <doc:db>important</doc:db>, <doc:db>caution</doc:db>, <doc:db>note</doc:db>), - this template chooses the graphics filename. If the admonition element is - not known, the <doc:db>note</doc:db> graphic is used. - - </para> - </doc:description> - <doc:params> - <variablelist> - <varlistentry> - <term>name</term> - <listitem> - <para> - - The name of the adminition. &DB2LaTeX; includes - different graphics for different adminitions. By - default, <literal>name</literal> defaults to the - XSLT <function - condition="xslt">local-name</function> of the - current node. - - </para> - </listitem> - </varlistentry> - </variablelist> - </doc:params> - </doc:template> - - <xsl:template name="admon.graphic"> - <xsl:param name="name" select="local-name(.)"/> - <xsl:choose> - <xsl:when test="$name='note'">note</xsl:when> - <xsl:when test="$name='warning'">warning</xsl:when> - <xsl:when test="$name='caution'">caution</xsl:when> - <xsl:when test="$name='tip'">tip</xsl:when> - <xsl:when test="$name='important'">important</xsl:when> - <xsl:otherwise>note</xsl:otherwise> - </xsl:choose> - </xsl:template> - - <doc:template xmlns=""> - <refpurpose> Process admonitions </refpurpose> - <doc:description> - <para> - - Invokes the environment provided by <xref - linkend="param.latex.admonition.environment"/> - and applies templates. - - </para> - <note><para>An admonition will look something like this <doc:db>note</doc:db>.</para></note> - </doc:description> - <doc:notes> - <para> - - There can be <quote>excessive</quote> whitespace between - the bottom of the admonition area and a subsequent paragraph. - - </para> - </doc:notes> - <doc:variables> - <itemizedlist> - <listitem><simpara><xref linkend="param.admon.graphics.path"/></simpara></listitem> - <listitem><simpara><xref linkend="param.latex.apply.title.templates.admonitions"/></simpara></listitem> - </itemizedlist> - </doc:variables> - <doc:samples> - <simplelist type='inline'> - &test_adm; - &test_bind; - &test_book; - </simplelist> - </doc:samples> - <doc:seealso> - <itemizedlist> - <listitem><para>&mapping;</para></listitem> - </itemizedlist> - </doc:seealso> - </doc:template> - - <xsl:template match="note|important|warning|caution|tip"> - <xsl:call-template name="map.begin"> - <xsl:with-param name="keyword">admonition</xsl:with-param> - <xsl:with-param name="string"> - <xsl:text>{</xsl:text> - <xsl:value-of select="$admon.graphics.path"/><xsl:text>/</xsl:text> - <xsl:call-template name="admon.graphic"/> - <xsl:text>}{</xsl:text> - <xsl:choose> - <xsl:when test="title and $latex.apply.title.templates.admonitions='1'"> - <xsl:call-template name="extract.object.title"> - <xsl:with-param name="object" select="."/> - </xsl:call-template> - </xsl:when> - <xsl:otherwise> - <xsl:call-template name="gentext.element.name"/> - </xsl:otherwise> - </xsl:choose> - <xsl:text>}</xsl:text> - </xsl:with-param> - </xsl:call-template> - <xsl:call-template name="content-templates"/> - <xsl:call-template name="map.end"> - <xsl:with-param name="keyword">admonition</xsl:with-param> - </xsl:call-template> - </xsl:template> - -</xsl:stylesheet> |