← Back to branch summary

~qbalazs/installation-guide/lp1030336

« back to all changes in this revision

Viewing changes to build/stylesheets/db2latex/para.mod.xsl

  • Committer: joeyh
  • Date: 2005-10-07 19:51:38 UTC
  • Revision ID: vcs-imports@canonical.com-20051007195138-c3d57b2617a79a4f
move manual to top-level directory, split out of debian-installer package

Show diffs side-by-side

added added

removed removed

Lines of Context:
build/stylesheets/db2latex/para.mod.xsl
 
1
<?xml version='1.0'?>
 
2
<!DOCTYPE xsl:stylesheet [ <!ENTITY % xsldoc.ent SYSTEM "./xsldoc.ent"> %xsldoc.ent; ]>
 
3
<!--############################################################################# 
 
4
|       $Id: para.mod.xsl,v 1.16 2004/01/13 14:17:45 j-devenish Exp $
 
5
|- #############################################################################
 
6
|       $Author: j-devenish $
 
7
|                                                                                                               
 
8
|   PURPOSE:
 
9
+ ############################################################################## -->
 
10
<xsl:stylesheet
 
11
        xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 
12
        xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
 
13
        exclude-result-prefixes="doc" version='1.0'>
 
14
 
 
15
 
 
16
        <!--############################################################################# -->
 
17
        <!-- DOCUMENTATION                                                                -->
 
18
        <doc:reference id="para" xmlns="">
 
19
                <referenceinfo>
 
20
                        <releaseinfo role="meta">
 
21
                                $Id: para.mod.xsl,v 1.16 2004/01/13 14:17:45 j-devenish Exp $
 
22
                        </releaseinfo>
 
23
                        <authorgroup>
 
24
                                &ramon;
 
25
                                &james;
 
26
                        </authorgroup>
 
27
                        <copyright>
 
28
                                <year>2000</year> <year>2001</year> <year>2002</year> <year>2003</year>
 
29
                                <holder>Ramon Casellas</holder>
 
30
                        </copyright>
 
31
                        <revhistory>
 
32
                                <doc:revision rcasver="1.8">&rev_2003_05;</doc:revision>
 
33
                        </revhistory>
 
34
                </referenceinfo>
 
35
                <title>Paragraphs <filename>para.mod.xsl</filename></title>
 
36
                <partintro>
 
37
                        <para>The file <filename>para.mod.xsl</filename> contains the
 
38
                        XSL template for <doc:db>para</doc:db>, <doc:db>simpara</doc:db> and <doc:db>formalpara</doc:db>.</para>
 
39
                        <doc:variables>
 
40
                                <itemizedlist>
 
41
                                        <listitem><simpara><xref linkend="param.latex.use.parskip"/></simpara></listitem>
 
42
                                        <listitem><simpara><xref linkend="param.latex.formalpara.title.style"/></simpara></listitem>
 
43
                                </itemizedlist>
 
44
                        </doc:variables>
 
45
                </partintro>
 
46
        </doc:reference>
 
47
 
 
48
        <doc:template xmlns="">
 
49
                <refpurpose>Use normal paragraph spacing instead of parskip spacing</refpurpose>
 
50
                <doc:description>
 
51
                        <para>
 
52
                                Uses <function condition="latex">docbooktolatexnoparskip</function>.
 
53
                        </para>
 
54
                </doc:description>
 
55
                <doc:variables>
 
56
                        <itemizedlist>
 
57
                                <listitem><simpara><xref linkend="param.latex.use.parskip"/></simpara></listitem>
 
58
                        </itemizedlist>
 
59
                </doc:variables>
 
60
                <doc:notes>
 
61
                        &essential_preamble;
 
62
                </doc:notes>
 
63
        </doc:template>
 
64
        <xsl:template name="latex.noparskip">
 
65
                <xsl:if test="$latex.use.parskip=1">
 
66
                        <xsl:text>\docbooktolatexnoparskip&#10;</xsl:text>
 
67
                </xsl:if>
 
68
        </xsl:template>
 
69
 
 
70
        <doc:template xmlns="">
 
71
                <refpurpose>Use parkip spacing, if user desires it</refpurpose>
 
72
                <doc:description>
 
73
                        <para>
 
74
                                Uses <function condition="latex">docbooktolatexrestoreparskip</function>.
 
75
                        </para>
 
76
                </doc:description>
 
77
                <doc:variables>
 
78
                        <itemizedlist>
 
79
                                <listitem><simpara><xref linkend="param.latex.use.parskip"/></simpara></listitem>
 
80
                        </itemizedlist>
 
81
                </doc:variables>
 
82
                <doc:notes>
 
83
                        &essential_preamble;
 
84
                </doc:notes>
 
85
        </doc:template>
 
86
        <xsl:template name="latex.restoreparskip">
 
87
                <xsl:if test="$latex.use.parskip=1">
 
88
                        <xsl:text>\docbooktolatexrestoreparskip&#10;</xsl:text>
 
89
                </xsl:if>
 
90
        </xsl:template>
 
91
 
 
92
        <doc:template basename="para" match="para|simpara" xmlns="">
 
93
                <refpurpose>Process <doc:db>para</doc:db> and <doc:db>simpara</doc:db> elements</refpurpose>
 
94
                <doc:description>
 
95
                        <para>
 
96
                                Starts new lines above and below its contents.
 
97
                                Thus, consecutive <doc:db basename="para">paras</doc:db> will have
 
98
                                one blank line between them.
 
99
                        </para>
 
100
                </doc:description>
 
101
                <doc:variables>
 
102
                        <itemizedlist>
 
103
                                <listitem><simpara><xref linkend="param.latex.use.parskip"/></simpara></listitem>
 
104
                        </itemizedlist>
 
105
                </doc:variables>
 
106
                <doc:notes>
 
107
                        <para>In &latex;, there is no distinction between <doc:db>para</doc:db> and <doc:db>simpara</doc:db>.</para>
 
108
                        <para>The accuracy of block elements within <sgmltag basename="para">paras</sgmltag> is unknown.</para>
 
109
                        <para><doc:todo>The use of <sgmltag>para</sgmltag> within <doc:db basename="footnote">footnotes</doc:db> is unproven.</doc:todo></para>
 
110
                </doc:notes>
 
111
                <doc:samples>
 
112
                        <simplelist type='inline'>
 
113
                                &test_blocks;
 
114
                        </simplelist>
 
115
                </doc:samples>
 
116
                <doc:seealso>
 
117
                        <itemizedlist>
 
118
                                <listitem><simpara><xref linkend="template.para-noline"/></simpara></listitem>
 
119
                        </itemizedlist>
 
120
                </doc:seealso>
 
121
        </doc:template>
 
122
        <xsl:template match="para|simpara">
 
123
                <xsl:text>&#10;</xsl:text>
 
124
                <xsl:apply-templates/>
 
125
                <xsl:text>&#10;</xsl:text>
 
126
        </xsl:template>
 
127
 
 
128
        <doc:template match="formalpara" xmlns="">
 
129
                <refpurpose>Process <doc:db>formalpara</doc:db> elements</refpurpose>
 
130
                <doc:description>
 
131
                        <para>
 
132
                                Starts new lines above and below its contents.
 
133
                        </para>
 
134
                </doc:description>
 
135
                <doc:variables>
 
136
                        <itemizedlist>
 
137
                                <listitem><simpara>The <doc:db>title</doc:db> is typeset using <xref linkend="param.latex.formalpara.title.style"/></simpara></listitem>
 
138
                        </itemizedlist>
 
139
                </doc:variables>
 
140
                <doc:notes>
 
141
                        <para>The accuracy of block elements within <doc:db basename="formalpara">formalparas</doc:db> is unknown.</para>
 
142
                        <para><doc:todo>The use of <sgmltag>formalpara</sgmltag> within <doc:db basename="footnote">footnotes</doc:db> is unproven.</doc:todo></para>
 
143
                        <para>Calls <xref linkend="template.generate.formalpara.title.delimiter"/>.</para>
 
144
                </doc:notes>
 
145
                <doc:samples>
 
146
                        <simplelist type='inline'>
 
147
                                &test_blocks;
 
148
                        </simplelist>
 
149
                </doc:samples>
 
150
        </doc:template>
 
151
        <xsl:template match="formalpara">
 
152
                <xsl:text>&#10;{</xsl:text>
 
153
                <xsl:value-of select="$latex.formalpara.title.style"/>
 
154
                <xsl:text>{{</xsl:text>
 
155
                <xsl:apply-templates select="title"/>
 
156
                <xsl:text>}</xsl:text>
 
157
                <xsl:call-template name="generate.formalpara.title.delimiter"/>
 
158
                <xsl:text>}}\ </xsl:text>
 
159
                <xsl:apply-templates select="node()[not(self::title)]"/>
 
160
                <xsl:text>&#10;</xsl:text>
 
161
        </xsl:template>
 
162
 
 
163
        <doc:template xmlns="">
 
164
                <refpurpose>Delimite a <doc:db>formalpara</doc:db>'s <doc:db>title</doc:db> from its <doc:db>para</doc:db></refpurpose>
 
165
                <doc:description>
 
166
                        <para>
 
167
                                Emits a full stop (period).
 
168
                        </para>
 
169
                </doc:description>
 
170
                <doc:variables>
 
171
                        &no_var;
 
172
                </doc:variables>
 
173
                <doc:notes>
 
174
                        <para>
 
175
 
 
176
                                This template can be used to emit any &LaTeX; sequence that you
 
177
                                desire. You can make the appearance be conditional upon some
 
178
                                attribute or document location, for instance. However, a
 
179
                                'space' will <emphasis>always</emphasis> be generated between
 
180
                                this delimiter and the subsequent <doc:db>para</doc:db>
 
181
                                contents.
 
182
 
 
183
                        </para>
 
184
                </doc:notes>
 
185
        </doc:template>
 
186
        <xsl:template name="generate.formalpara.title.delimiter">
 
187
                <xsl:text>.</xsl:text>
 
188
        </xsl:template>
 
189
 
 
190
        <doc:template basename="para" xmlns="">
 
191
                <refpurpose>Suppressed paragraphs</refpurpose>
 
192
                <doc:description>
 
193
                        <para>
 
194
                                These paragraphs are not separated like normal paragraphs.
 
195
                        </para>
 
196
                </doc:description>
 
197
                <doc:variables>
 
198
                        &no_var;
 
199
                </doc:variables>
 
200
                <doc:notes>
 
201
                        <para>This template exists to handle &latex; problems with
 
202
                        <function condition="latex">par</function> in certain contexts. <doc:todo>These
 
203
                        problems should be periodically reviewed by the &db2latex; team.</doc:todo></para>
 
204
                </doc:notes>
 
205
                <doc:samples>
 
206
                        <simplelist type='inline'>
 
207
                                &test_blocks;
 
208
                        </simplelist>
 
209
                </doc:samples>
 
210
        </doc:template>
 
211
        <xsl:template match="textobject/para|step/para|entry/para|question/para" name="para-noline">
 
212
                <xsl:if test="position()&gt;1">
 
213
                        <xsl:text> </xsl:text>
 
214
                </xsl:if>
 
215
                <xsl:apply-templates/>
 
216
                <xsl:if test="position()&lt;last()">
 
217
                        <xsl:text> </xsl:text>
 
218
                </xsl:if>
 
219
        </xsl:template>
 
220
 
 
221
</xsl:stylesheet>