← Back to branch summary

~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs-xml/xslt/db2latex-xsl/xsl/sections.mod.xsl

  • Committer: Chuck Short
  • Date: 2010-09-28 20:38:39 UTC
  • Revision ID: zulcss@ubuntu.com-20100928203839-pgjulytsi9ue63x1
Initial version

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs-xml/xslt/db2latex-xsl/xsl/sections.mod.xsl
 
1
<?xml version='1.0'?>
 
2
<!DOCTYPE xsl:stylesheet [ <!ENTITY % xsldoc.ent SYSTEM "./xsldoc.ent"> %xsldoc.ent; ]>
 
3
<!--############################################################################# 
 
4
|       $Id: sections.mod.xsl,v 1.8 2004/01/03 12:19:15 j-devenish Exp $
 
5
|- #############################################################################
 
6
|       $Author: j-devenish $
 
7
+ ############################################################################## -->
 
8
 
 
9
<xsl:stylesheet
 
10
        xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 
11
        xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
 
12
        exclude-result-prefixes="doc" version='1.0'>
 
13
 
 
14
        <doc:reference id="sections" xmlns="">
 
15
                <referenceinfo>
 
16
                        <releaseinfo role="meta">
 
17
                                $Id: sections.mod.xsl,v 1.8 2004/01/03 12:19:15 j-devenish Exp $
 
18
                        </releaseinfo>
 
19
                        <authorgroup>
 
20
                                &ramon;
 
21
                                &james;
 
22
                        </authorgroup>
 
23
                        <copyright>
 
24
                                <year>2000</year><year>2001</year><year>2002</year><year>2003</year><year>2004</year>
 
25
                                <holder>Ramon Casellas</holder>
 
26
                        </copyright>
 
27
                        <revhistory>
 
28
                                <doc:revision rcasver="1.6">&rev_2003_05;</doc:revision>
 
29
                        </revhistory>
 
30
                </referenceinfo>
 
31
                <title>Sections <filename>sections.mod.xsl</filename></title>
 
32
                <partintro>
 
33
                        <para>The file <filename>sections.mod.xsl</filename> contains the
 
34
                        XSL templates for <doc:db>section</doc:db>, <doc:db>simplesect</doc:db>,
 
35
                        and <doc:db>sect1</doc:db>, etc.</para>
 
36
                </partintro>
 
37
        </doc:reference>
 
38
 
 
39
        <doc:template xmlns="">
 
40
                <refpurpose>Process explicitly-nested sections</refpurpose>
 
41
                <doc:description>
 
42
                        <para>
 
43
                                Formats a section's title (including numbering, if applicable)
 
44
                                then allows all child elements to be processed. The title
 
45
                                is formatted the using &LaTeX; mapping identified by the
 
46
                                element name (e.g. <doc:db>sect1</doc:db>, etc.).
 
47
                        </para>
 
48
                </doc:description>
 
49
                <doc:params>
 
50
                        <variablelist>
 
51
                                <varlistentry>
 
52
                                        <term>bridgehead</term>
 
53
                                        <listitem>
 
54
                                                <para>
 
55
 
 
56
                                                        If <literal>true()</literal>, the title is
 
57
                                                        processed like a <doc:db>bridgehead</doc:db> (that
 
58
                                                        is, the section is unnumbered and does not appear
 
59
                                                        in the <doc:db>toc</doc:db>). This parameter
 
60
                                                        defaults to <literal>false()</literal> unless the
 
61
                                                        section appears within a preface.
 
62
 
 
63
                                                </para>
 
64
                                        </listitem>
 
65
                                </varlistentry>
 
66
                        </variablelist>
 
67
                </doc:params>
 
68
                <doc:variables>
 
69
                        &no_var;
 
70
                </doc:variables>
 
71
                <doc:notes>
 
72
 
 
73
                        <para>Currently, <quote>info</quote> elements (e.g.
 
74
                        <doc:db>sect1info</doc:db>), <doc:db>subtitle</doc:db> and
 
75
                        <doc:db>titleabbrev</doc:db> are not honoured.</para>
 
76
 
 
77
                        <para>The use of special components such as <doc:db>toc</doc:db>,
 
78
                        <doc:db>lot</doc:db>, <doc:db>index</doc:db> and
 
79
                        <doc:db>glossary</doc:db> is unlikely to be successful.</para>
 
80
 
 
81
                </doc:notes>
 
82
                <doc:samples>
 
83
                        <simplelist type='inline'>
 
84
                                &test_article;
 
85
                                &test_book;
 
86
                        </simplelist>
 
87
                </doc:samples>
 
88
                <doc:seealso>
 
89
                        <itemizedlist>
 
90
                                <listitem><para>&mapping;</para></listitem>
 
91
                        </itemizedlist>
 
92
                </doc:seealso>
 
93
        </doc:template>
 
94
 
 
95
        <xsl:template match="sect1|sect2|sect3|sect4|sect5">
 
96
                <xsl:param name="bridgehead" select="ancestor::preface|ancestor::colophon|ancestor::dedication|ancestor::partintro"/>
 
97
                <xsl:variable name="template">
 
98
                        <xsl:value-of select="local-name(.)"/>
 
99
                        <xsl:if test="$bridgehead"><xsl:text>*</xsl:text></xsl:if>
 
100
                </xsl:variable>
 
101
                <xsl:call-template name="map.begin">
 
102
                        <xsl:with-param name="keyword" select="$template"/>
 
103
                </xsl:call-template>
 
104
                <xsl:call-template name="content-templates"/>
 
105
                <xsl:call-template name="map.end">
 
106
                        <xsl:with-param name="keyword" select="$template"/>
 
107
                </xsl:call-template>
 
108
        </xsl:template>
 
109
 
 
110
        <doc:template xmlns="">
 
111
                <refpurpose>Process recursive and leaf sections</refpurpose>
 
112
                <doc:description>
 
113
                        <para>
 
114
                                Formats a section's title (including numbering, if applicable)
 
115
                                then allows all child elements to be processed. The title
 
116
                                is formatted the using &LaTeX; mapping identified by the
 
117
                                equivalent explicit element (e.g. <doc:db>sect1</doc:db>, etc.).
 
118
                        </para>
 
119
                </doc:description>
 
120
                <doc:params>
 
121
                        <variablelist>
 
122
                                <varlistentry>
 
123
                                        <term>bridgehead</term>
 
124
                                        <listitem>
 
125
                                                <para>
 
126
 
 
127
                                                        If <literal>true()</literal>, the title is
 
128
                                                        processed like a <doc:db>bridgehead</doc:db> (that
 
129
                                                        is, the section is unnumbered and does not appear
 
130
                                                        in the <doc:db>toc</doc:db>). This parameter
 
131
                                                        defaults to <literal>false()</literal> unless the
 
132
                                                        section appears within a preface.
 
133
 
 
134
                                                </para>
 
135
                                        </listitem>
 
136
                                </varlistentry>
 
137
                                <varlistentry>
 
138
                                        <term>level</term>
 
139
                                        <listitem>
 
140
                                                <para>
 
141
 
 
142
                                                The numeric nesting level of the section. This is
 
143
                                                automatically calculated as "one greater than the
 
144
                                                number of ancestor <doc:db>section</doc:db>s".
 
145
 
 
146
                                                </para>
 
147
                                        </listitem>
 
148
                                </varlistentry>
 
149
                        </variablelist>
 
150
                </doc:params>
 
151
                <doc:variables>
 
152
                        &no_var;
 
153
                </doc:variables>
 
154
                <doc:notes>
 
155
 
 
156
                        <para>Titles for sections nested beyond a depth of five are
 
157
                        formatted like <doc:db>sect5</doc:db>.</para>
 
158
 
 
159
                        <para>Currently, <quote>info</quote> elements (e.g.
 
160
                        <doc:db>sectioninfo</doc:db>), <doc:db>subtitle</doc:db> and
 
161
                        <doc:db>titleabbrev</doc:db> are not honoured.</para>
 
162
 
 
163
                        <para>The use of special components such as <doc:db>toc</doc:db>,
 
164
                        <doc:db>lot</doc:db>, <doc:db>index</doc:db> and
 
165
                        <doc:db>glossary</doc:db> is unlikely to be successful.</para>
 
166
 
 
167
                        <para>&LaTeX; makes no semantic distinction between
 
168
                        <doc:db>section</doc:db> and <doc:db>simplesect</doc:db>.</para>
 
169
 
 
170
                </doc:notes>
 
171
                <doc:samples>
 
172
                        <simplelist type='inline'>
 
173
                                &test_article;
 
174
                                &test_book;
 
175
                        </simplelist>
 
176
                </doc:samples>
 
177
                <doc:seealso>
 
178
                        <itemizedlist>
 
179
                                <listitem><para>&mapping;</para></listitem>
 
180
                        </itemizedlist>
 
181
                </doc:seealso>
 
182
        </doc:template>
 
183
        <xsl:template match="section|simplesect">
 
184
                <xsl:param name="bridgehead" select="ancestor::preface|ancestor::colophon|ancestor::dedication"/>
 
185
                <xsl:param name="level" select="count(ancestor::section)+1"/>
 
186
                <xsl:variable name="template">
 
187
                        <xsl:choose>
 
188
                                <xsl:when test='$level&lt;6'>
 
189
                                        <xsl:text>sect</xsl:text>
 
190
                                        <xsl:value-of select="$level"/>
 
191
                                </xsl:when>
 
192
                                <xsl:otherwise>
 
193
                                        <xsl:message>DB2LaTeX: recursive section|simplesect &gt; 5 not well supported.</xsl:message>
 
194
                                        <xsl:text>sect6</xsl:text>
 
195
                                </xsl:otherwise>
 
196
                        </xsl:choose>
 
197
                        <xsl:if test="$bridgehead"><xsl:text>*</xsl:text></xsl:if>
 
198
                </xsl:variable>
 
199
                <xsl:text>&#10;</xsl:text>
 
200
                <xsl:call-template name="map.begin">
 
201
                        <xsl:with-param name="keyword" select="$template"/>
 
202
                </xsl:call-template>
 
203
                <xsl:call-template name="content-templates"/>
 
204
                <xsl:call-template name="map.end">
 
205
                        <xsl:with-param name="keyword" select="$template"/>
 
206
                </xsl:call-template>
 
207
        </xsl:template>
 
208
 
 
209
</xsl:stylesheet>