summaryrefslogtreecommitdiff
path: root/docs/docbook/xslt/db2latex/vars.mod.xsl
blob: e20fb59ce290921e86f9dc5cddfee94e639f86a6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
<?xml version='1.0'?>
<!--############################################################################# 
|- #############################################################################
|
|   PURPOSE: User and stylesheets XSL variables 
+ ############################################################################## -->

<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 id="vars" xmlns="">
	<referenceinfo>
	    <releaseinfo role="meta">
	    </releaseinfo>
	    <authorgroup>
		<author><surname>Casellas</surname><firstname>Ramon</firstname></author>
		<author><surname>Devenish</surname><firstname>James</firstname></author>
	    </authorgroup>
	    <copyright>
		<year>2000</year><year>2001</year><year>2002</year><year>2003</year>
		<holder>Ramon Casellas</holder>
	    </copyright>
	</referenceinfo>

	<title>XSL Variables and Parameters</title>

	<partintro>
	    <section><title>Introduction</title>

		<para>This is technical reference documentation for the DocBook XSL
		    Stylesheets. It documents (some of) the parameters, templates, and
		    other elements of the stylesheets.</para>
	    </section>
	</partintro>
    </doc:reference>


    <!--############################################################################# 
    |  COMMON VARIABLES
    |- #############################################################################
    |
    + ############################################################################## -->
    <xsl:variable name="default-classsynopsis-language">java</xsl:variable>

    <xsl:variable name="author.othername.in.middle" select="1"/>
    <xsl:variable name="refentry.xref.manvolnum" select="1"/>
    <xsl:variable name="funcsynopsis.style">kr</xsl:variable>
    <xsl:variable name="funcsynopsis.decoration" select="1"/>
    <xsl:variable name="function.parens">0</xsl:variable>
    <xsl:variable name="refentry.generate.name" select="1"/>

	<doc:param name="show.comments" xmlns="">
	<refpurpose> Display <sgmltag class="element">comment</sgmltag> elements? </refpurpose>
	<refdescription>
		<para>Control the display of <sgmltag class="element">comment</sgmltag>s and <sgmltag class="element">remark</sgmltag>s.</para>
	</refdescription>
	</doc:param>
	<xsl:param name="show.comments" select="1"/>

    <xsl:variable name="section.autolabel" select="1"/>
    <xsl:variable name="section.label.includes.component.label" select="0"/>
    <xsl:variable name="chapter.autolabel" select="1"/>
    <xsl:variable name="preface.autolabel" select="0"/>
    <xsl:variable name="part.autolabel" select="1"/>
    <xsl:variable name="qandadiv.autolabel" select="1"/>
    <xsl:variable name="autotoc.label.separator" select="'. '"/>
    <xsl:variable name="qanda.inherit.numeration" select="1"/>
    <xsl:variable name="qanda.defaultlabel">number</xsl:variable>
    <xsl:param name="biblioentry.item.separator">, </xsl:param>
	<doc:param name="toc.section.depth" xmlns="">
	<refpurpose> Cull table-of-contents entries that are deeply nested </refpurpose>
	<refdescription>
		<para>Specifies the maximum depth before sections are omitted from the table of contents.</para>
	</refdescription>
	</doc:param>
	<xsl:param name="toc.section.depth">4</xsl:param>

	<doc:param name="section.depth" xmlns="">
	<refpurpose> Control the automatic numbering of section, parts, and chapters </refpurpose>
	<refdescription>
		<para>
		Specifies the maximum depth before sections cease to be uniquely numbered.
		This is passed to LaTeX using the <literal>secnumdepth</literal> counter.
		Therefore, it is possible to use a value of <quote>0</quote> (zero) to disable section numbering.
		A value of <quote>-1</quote> will disable the numbering of parts and chapters, too.
		</para>
	</refdescription>
	</doc:param>
    <xsl:param name="section.depth">4</xsl:param>
    <xsl:variable name="graphic.default.extension"></xsl:variable>
    <xsl:variable name="check.idref">1</xsl:variable>
    <!--
    <xsl:variable name="link.mailto.url"></xsl:variable>
    <xsl:variable name="toc.list.type">dl</xsl:variable>
    -->

	<doc:param name="use.role.for.mediaobject" xmlns="">
	<refpurpose> Control <sgmltag class="element">mediaobject</sgmltag> selection methods </refpurpose>
	<refdescription>
		<para>This controls how DB2LaTeX behaves when a <sgmltag class="element">figure</sgmltag> contains
		multiple <sgmltag class="element">mediaobject</sgmltag>s. When enabled, DB2LaTeX will choose
		the mediaobject with the "LaTeX" or "TeX" role, if present. Otherwise, the first mediaobject
		is chosen.</para>
	</refdescription>
	</doc:param>
	<xsl:param name="use.role.for.mediaobject">1</xsl:param>

	<doc:param name="preferred.mediaobject.role" xmlns="">
	<refpurpose> Control <sgmltag class="element">mediaobject</sgmltag> selection methods </refpurpose>
	<refdescription>
		<para>When <xref linkend="param.use.role.for.mediaobject"/> is enabled, this variable
		can be used to specify the mediaobject role that your document uses for LaTeX output.
		DB2LaTeX will try to use this role before using the "LaTeX" or "TeX" roles.
		For example, some authors may choose to set this to "PDF".</para>
	</refdescription>
	</doc:param>
	<xsl:param name="preferred.mediaobject.role"></xsl:param>

	<doc:param name="formal.title.placement" xmlns="">
	<refpurpose> Specifies where formal object titles should occur </refpurpose>
	<refdescription>
		<para>
			Titles for the formal object types (figure, example, quation, table, and procedure)
			can be placed before or after those objects. The keyword <quote>before</quote>
			is recognised. All other strings qualify as <quote>after</quote>.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="formal.title.placement">
		figure not_before
		example before
		equation not_before
		table before
		procedure before
	</xsl:param>

	<doc:param name="insert.xref.page.number" xmlns="">
	<refpurpose> Control the appearance of page numbers in cross references </refpurpose>
	<refdescription>
		<para>
			When enabled, <sgmltag class="element">xref</sgmltag>s will include page
			numbers after their generated cross-reference text.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="insert.xref.page.number">0</xsl:param>

	<doc:param name="ulink.show" xmlns="">
	<refpurpose> Control the display of URLs after ulinks </refpurpose>
	<refdescription>
		<para>
		When this option is enabled, and a ulink has a URL that is different
		from the displayed content, the URL will be typeset after the content.
		If the URL and content are identical, only one of them will appear.
		Otherwise, the URL is hyperlinked and the content is not.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="ulink.show">0</xsl:param>

	<doc:param name="ulink.footnotes" xmlns="">
	<refpurpose> Control the generation of footnotes for ulinks </refpurpose>
	<refdescription>
		<para>
		When this option is enabled, a ulink that has content different to its
		URL will have an associated footnote. The contents of the footnote
		will be the URL. If the ulink is within a footnote, the URL is shown
		after the content.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="ulink.footnotes">0</xsl:param>

    <!--############################################################################# 
    | 	LaTeX VARIABLES
    |- #############################################################################
    |
    |   PURPOSE: User and stylesheets XSL variables 
    + ############################################################################## -->

	<doc:param name="latex.override" xmlns="">
	<refpurpose> Override DB2LaTeX's preamble with a custom preamble. </refpurpose>
	<refdescription>
		<para>
		When this variable is set, the entire DB2LaTeX premable will be superseded.
		<emphasis>You should not normally need or want to use this.</emphasis>
		It may cause LaTeX typesetting problems. This is a last resort or
		<quote>expert</quote> feature.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.override"></xsl:param>

	<doc:param name="latex.entities" xmlns="">
	<refpurpose> Control Unicode character handling. </refpurpose>
	<refdescription>
		<para>
		Normally, XSLT processors will convert SGML character entities into
		Unicode characters and DB2LaTeX doesn't have much chance to do anything
		toward converting them to LaTeX equivalents. We do not yet know how we
		can solve this problem best.
		</para>
		<para>
		Proposed values: 'catcode', 'unicode', 'extension'.
		Currently only 'catcode' is supported. All other values will
		cause no special handling except for certain mappings in MathML.
		In future, perhaps the 'unicode' LaTeX package could be of assistance.
		'Extension' could be an XSLT extension that handles the characters
		using a mapping table.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.entities"></xsl:param>

	<doc:param name="latex.alt.is.latex" xmlns="">
	<refpurpose> Control the escaping of <sgmltag class="element">alt</sgmltag> text </refpurpose>
	<refdescription>
		<para>
		Text within <sgmltag class="element">alt</sgmltag> elements is assumed to
		be valid LaTeX and is passed through unescaped by default. If this is not
		appropriate for your document, set this variable to something other than
		'1'.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.alt.is.latex">1</xsl:param>

	<doc:param name="latex.alt.is.preferred" xmlns="">
	<refpurpose> Control the use of <sgmltag class="element">alt</sgmltag> text </refpurpose>
	<refdescription>
		<para>
		By default, DB2LaTeX assumes that <sgmltag class="element">alt</sgmltag>
		text should be typeset in preference to any 
		<sgmltag class="element">mediaobject</sgmltag>s.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.alt.is.preferred">1</xsl:param>

	<!--
	<doc:variable name="latex.figure.position" xmlns="">
	<refpurpose> How to place floats. </refpurpose>
	<refdescription>
		<para>
		This variable is used as the positioning argument for floats.
		In future, this may be replaced by a dynamic mechanism that can
		honour DocBook placement attributes.
		</para>
	</refdescription>
	</doc:variable>
    <xsl:variable name="latex.figure.position">[hbt]</xsl:variable>
	-->

	<doc:param name="latex.apply.title.templates" xmlns="">
	<refpurpose> Whether to apply templates for section titles. </refpurpose>
	<refdescription>
		<para>
		Controls whether section titles will be generated by
		applying templates or by conversion to string values.
		When enabled, templates will be applied. This enables template
		expression in titles but may have problematic side-effects such
		as nested links.
		</para>
		<note>
			<para>
				This variable does not influence all <sgmltag class="element">title</sgmltag>
				elements. Some may have their own variables or not be configurable.
			</para>
		</note>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.apply.title.templates">1</xsl:param>





	<doc:param name="latex.apply.title.templates.admonitions" xmlns="">
	<refpurpose> Whether to apply templates for admonition titles. </refpurpose>
	<refdescription>
		<para>
		Controls whether admonition titles will be generated by
		applying templates or by conversion to string values.
		When enabled, templates will be applied.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.apply.title.templates.admonitions">1</xsl:param>






	<doc:param name="latex.graphics.formats" xmlns="">
	<refpurpose> Control <sgmltag class="element">imagedata</sgmltag> selection. </refpurpose>
	<refdescription>
		<para>This controls how DB2LaTeX behaves when a <sgmltag class="element">mediaobject</sgmltag> contains
		multiple <sgmltag class="element">imagedata</sgmltag>. When non-empty, DB2LaTeX will exclude
		imagedata that have a format no listed within this variable.</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.graphics.formats"></xsl:param>






	<doc:param name="latex.caption.swapskip" xmlns="">
	<refpurpose> Improved typesetting of captions  </refpurpose>
	<refdescription>
		<para>
		DB2LaTeX supports <link linkend="param.formal.title.placement">$formal.title.placement</link>
		as a mechanism for choosing whether captions will appear above or below the objects they describe.
		<!--
		($formal.title.placement is described in the <ulink
		url="http://docbook.sourceforge.net/release/xsl/current/doc/html/formal.title.placement.html">DocBook
		XSL Stylesheet HTML Parameter Reference</ulink>.)
		-->
		However, LaTeX will often produce an ugly result when captions occur
		above their corresponding content. This usually arises because of
		unsuitable \abovecaptionskip and \belowcaptionskip.
		</para>
		<para>
		This variable, when set to '1', authorises DB2LaTeX to swap the caption
		'skip' lengths when a caption is placed <emphasis>above</emphasis> its
		corresponding content. This is enabled by default.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.caption.swapskip">1</xsl:param>





	<doc:param name="latex.titlepage.file" xmlns="">
	<refpurpose> DB2LaTeX allows using an (externally generated) cover page  </refpurpose>
	<refdescription>
		<para>
		You may supply a LaTeX file that will supersede DB2LaTeX's default
		cover page or title. If the value of this variable is non-empty, the
		generated LaTeX code includes \input{filename}. Otherwise, it uses the
		\maketitle command.
		</para>
		<warning><para>
			Bear in mind that using an external cover page breaks the
			"encapsulation" of DocBook. Further revisions of these stylesheets
			will add chunking support, and the automation of the cover file
			generation.
		</para></warning>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.titlepage.file">title</xsl:param>




	<doc:param name="latex.documentclass" xmlns="">
	<refpurpose> DB2LaTeX document class </refpurpose>
	<refdescription>
		<para>
		This variable is normally empty and the stylesheets will determine
		the correct document class according to whether the document is a
		book or an article. If you wish to use your own document class,
		put its non-empty value in this variable. It will apply for both
		books and articles.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.documentclass"></xsl:param>

	<doc:param name="latex.documentclass.common" xmlns="">
	<refpurpose> DB2LaTeX document class options  </refpurpose>
	<refdescription>
		<para>
		These are the first options to be passed to <literal>\documentclass</literal>
		The common options are set to <literal>french,english</literal> by default.
		They will be augmented or superseded by article/book options (see $latex.documentclass.article and $latex.documentclass.book) and pdftex/dvips options (see $latex.documentclass.pdftex and $latex.documentclass.dvips).
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.documentclass.common">french,english</xsl:param>

	<doc:param name="latex.documentclass.article" xmlns="">
	<refpurpose> DB2LaTeX document class options for articles</refpurpose>
	<refdescription>
		<para>
		The article options are set to <literal>a4paper,10pt,twoside,twocolumn</literal> by default.
		These are the intermediate options to be passed to <literal>\documentclass</literal>,
		between the common options and the pdftex/dvips options.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.documentclass.article">a4paper,10pt,twoside,twocolumn</xsl:param>

	<doc:param name="latex.documentclass.book" xmlns="">
	<refpurpose> DB2LaTeX document class options for books</refpurpose>
	<refdescription>
		<para>
		The book options are set to <literal>a4paper,10pt,twoside,openright</literal> by default.
		These are the intermediate options to be passed to <literal>\documentclass</literal>,
		between the common options and the pdftex/dvips options.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.documentclass.book">a4paper,10pt,twoside,openright</xsl:param>

	<doc:param name="latex.documentclass.pdftex" xmlns="">
	<refpurpose> DB2LaTeX document class options for pdfTeX output</refpurpose>
	<refdescription>
		<para>
		The pdfTeX options are empty by default.
		These are the last options to be passed to <literal>\documentclass</literal>
		and override the common/article/book options.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.documentclass.pdftex"></xsl:param>

	<doc:param name="latex.documentclass.dvips" xmlns="">
	<refpurpose> DB2LaTeX document class options for dvips output</refpurpose>
	<refdescription>
		<para>
		The dvips options are empty by default.
		These are the last options to be passed to <literal>\documentclass</literal>
		and override the common/article/book options.
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.documentclass.dvips"></xsl:param>

	<doc:param name="latex.admonition.path" xmlns="">
	<refpurpose> LaTeX location for admonition graphics </refpurpose>
	<refdescription>
		<para>The file path that will be passed to LaTeX in order to find admonition graphics.</para>
		<para>An empty value suppresses the use of admonition graphics.</para>
		<para>If your figures are in <quote>the current directory</quote> then use a value of
		<quote>.</quote> (i.e. the full stop or period on its own) to signify this.</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.admonition.path">figures</xsl:param>


	<doc:param name="latex.admonition.imagesize" xmlns="">
	<refpurpose> DB2LaTeX graphics admonitions size</refpurpose>
	<refdescription>
		<para>
			Is passed as an optional parameter for <literal>\includegraphics</literal> and
			can take on any such legal values (or be empty).
		</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.admonition.imagesize">width=1cm</xsl:param>


	<!--
	<xsl:param name="latex.chapter.label">1</xsl:param>

    <doc:param name="latex.chapter.hypertarget" xmlns="">
	<refpurpose> Hypertarget Chapters  </refpurpose>
	<refdescription>
	    <para>
	    </para>
	</refdescription>
    </doc:param>
    <xsl:param name="latex.chapter.hypertarget">1</xsl:param>
	-->


	<doc:param name="latex.biblio.output" xmlns="">
	<refpurpose> Control which references are cited in the bibliography </refpurpose>
	<refdescription>
		<para>
		The DB2LaTeX generated bibliography (bibitems) may either
		include all biblioentries found in the document, or only thee ones explicitly
		cited with <sgmltag class="element">citation</sgmltag>.
		</para>
	    <para>Two values are possible: <quote>all</quote> or <quote>cited</quote>.</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.biblio.output">all</xsl:param>


	<doc:param name="latex.bibfiles" xmlns="">
	<refpurpose>
		Control the output of the \bibliography{.bib}.
	</refpurpose>
	<refdescription>
		<para>The value of this parameter is output.</para>
		<para>An example is <quote><filename>citations.bib</filename></quote>,
		if your BibTeX file has that name.</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.bibfiles"></xsl:param>


	<doc:param name="latex.bibwidelabel" xmlns="">
	<refpurpose> Adjust bibliography formatting </refpurpose>
	<refdescription>
		<para>The environment bibliography accepts a parameter that indicates
		the widest label, which is used to correctly format the bibliography
		output. The value of this parameter is output inside the
		<literal>\begin{thebibliography[]}</literal> LaTeX command.</para>
	</refdescription>
	</doc:param>
	<xsl:param name="latex.bibwidelabel">WIDELABEL</xsl:param>

	<!--
	<xsl:variable name="latex.dont.label">0</xsl:variable>
	<xsl:variable name="latex.dont.hypertarget">0</xsl:variable>
	-->

	<doc:param name="latex.use.ucs" xmlns="">
		<refpurpose> Choose whether to use the <productname>unicode</productname> LaTeX package</refpurpose>
		<refdescription><para>See the <productname>unicode</productname> documentation for details.</para></refdescription>
	</doc:param>
	<xsl:param name="latex.use.ucs">0</xsl:param>

	<doc:param name="latex.ucs.options" xmlns="">
		<refpurpose>Select the optional parameter(s) for the <productname>unicode</productname> LaTeX package</refpurpose>
		<refdescription><para>See the <productname>unicode</productname> documentation for details.</para></refdescription>
	</doc:param>
	<xsl:param name="latex.ucs.options"></xsl:param>

	<doc:param name="latex.babel.language" xmlns="">
		<refpurpose>Select the optional parameter for the <productname>babel</productname> LaTeX package</refpurpose>
		<refdescription><para>See the <productname>babel</productname> documentation for details.</para></refdescription>
	</doc:param>
	<xsl:param name="latex.babel.language">french</xsl:param>

	<doc:param name="latex.use.isolatin1" xmlns="">
		<refpurpose>Toggle the use of the <productname>isolatin1</productname> LaTeX package</refpurpose>
	</doc:param>
	<xsl:variable name="latex.use.isolatin1">1</xsl:variable>

	<doc:param name="latex.use.hyperref" xmlns="">
		<refpurpose>Toggle the use of the <productname>hyperref</productname> LaTeX package</refpurpose>
		<refdescription><para>This is used extensively for hyperlinking within documents.</para></refdescription>
	</doc:param>
	<xsl:variable name="latex.use.hyperref">1</xsl:variable>

	<doc:param name="latex.use.fancybox" xmlns="">
		<refpurpose>Toggle the use of the <productname>fancybox</productname> LaTeX package</refpurpose>
		<refdescription><para>This is essential for admonitions.</para></refdescription>
	</doc:param>
	<xsl:variable name="latex.use.fancybox">1</xsl:variable>

	<doc:param name="latex.use.fancyvrb" xmlns="">
		<refpurpose>Toggle the use of the <productname>fancyvrb</productname> LaTeX package</refpurpose>
		<refdescription><para>Provides support for tabbed whitespace in verbatim environments.
		See also <xref linkend="param.latex.fancyvrb.tabsize"/>.</para></refdescription>
	</doc:param>
	<xsl:param name="latex.use.fancyvrb">1</xsl:param>

	<doc:param name="latex.fancyvrb.tabsize" xmlns="">
		<refpurpose>Choose indentation for tabs in verbatim environments</refpurpose>
		<refdescription><para>When <xref linkend="param.latex.use.fancyvrb"/> is enabled,
		this variable sets the width of a tab in terms of an equivalent number of spaces.</para></refdescription>
	</doc:param>
	<xsl:param name="latex.fancyvrb.tabsize">3</xsl:param>

	<doc:param name="latex.use.fancyhdr" xmlns="">
		<refpurpose>Toggle the use of the <productname>fancyhdr</productname> LaTeX package</refpurpose>
		<refdescription><para>Provides page headers and footers. Disabling support for
		this package will make headers and footer go away.</para></refdescription>
	</doc:param>
	<xsl:param name="latex.use.fancyhdr">1</xsl:param>

	<doc:param name="latex.use.parskip" xmlns="">
		<refpurpose>Toggle the use of the <productname>parskip</productname> LaTeX package</refpurpose>
		<refdescription><para>Support a <quote>block</quote> paragraph style as opposed to
		<quote>indented</quote>.</para></refdescription>
	</doc:param>
	<xsl:param name="latex.use.parskip">0</xsl:param>

	<doc:param name="latex.use.subfigure" xmlns="">
		<refpurpose>Toggle the use of the <productname>subfigure</productname> LaTeX package</refpurpose>
		<refdescription><para>Used to provide nice layout of multiple mediaobjects in figures.</para></refdescription>
	</doc:param>
	<xsl:param name="latex.use.subfigure">1</xsl:param>

	<doc:param name="latex.use.rotating" xmlns="">
		<refpurpose>Toggle the use of the <productname>rotating</productname> LaTeX package</refpurpose>
	</doc:param>
	<xsl:param name="latex.use.rotating">1</xsl:param>

	<doc:param name="latex.use.tabularx" xmlns="">
		<refpurpose>Toggle the use of the <productname>tabularx</productname> LaTeX package</refpurpose>
		<refdescription><para>Used to provide certain table features. Has some incompatabilities
		with packages, but also solves some conflicts that the regular tabular
		environment has.</para></refdescription>
	</doc:param>
	<xsl:param name="latex.use.tabularx">1</xsl:param>

	<doc:param name="latex.use.umoline" xmlns="">
		<refpurpose>Toggle the use of the <productname>umoline</productname> LaTeX package</refpurpose>
		<refdescription><para>Provide underlining.</para></refdescription>
	</doc:param>
	<xsl:param name="latex.use.umoline">0</xsl:param>

	<doc:param name="latex.use.url" xmlns="">
		<refpurpose>Toggle the use of the <productname>url</productname> LaTeX package</refpurpose>
		<refdescription><para>Provide partial support for hyperlinks.</para></refdescription>
	</doc:param>
	<xsl:param name="latex.use.url">1</xsl:param>

	<doc:param name="latex.use.makeidx" xmlns="">
		<refpurpose>Toggle the use of the <productname>makeidx</productname> LaTeX package</refpurpose>
		<refdescription><para>Support index generation.</para></refdescription>
	</doc:param>
	<xsl:param name="latex.use.makeidx">1</xsl:param>

	<doc:param name="latex.hyphenation.tttricks" xmlns="">
	<refpurpose> DB2LaTeX hyphenation linebreak tricks </refpurpose>
	<refdescription>
		<para>
		Usually, LaTeX does not perform hyphenation in <quote>teletype</quote> (monospace)
		text. This can lead to formatting problems. But certain monospace texts, such as
		URLs and filenames, have <quote>natural</quote> breakpoints such as full stops
		and slashes. DB2LaTeX's <quote>tttricks</quote> exploit a hyphenation trick in
		order to provide line wrapping in the middle of monospace text. Set this to '1'
		to enable these tricks (they are not enabled by default). See also the FAQ.
		</para>
	</refdescription>
	</doc:param>
    <xsl:variable name="latex.hyphenation.tttricks">0</xsl:variable>

	<doc:param name="latex.hyperref.param.common" xmlns="">
	<refpurpose> DB2LaTeX hyperref options</refpurpose>
	<refdescription>
		<para>
		The hyperref options are set to <literal>bookmarksnumbered,colorlinks,backref, bookmarks, breaklinks, linktocpage</literal> by default.
		You may wish to specify additional options using <literal>latex.hyperref.param.pdftex</literal>
		or <literal>latex.hyperref.param.dvips</literal>.
		</para>
	</refdescription>
	</doc:param>
    <xsl:variable name="latex.hyperref.param.common">bookmarksnumbered,colorlinks,backref, bookmarks, breaklinks, linktocpage</xsl:variable>

	<doc:param name="latex.hyperref.param.pdftex" xmlns="">
	<refpurpose> DB2LaTeX hyperref options for pdfTeX output</refpurpose>
	<refdescription>
		<para>
		This variable is empty by default. See the hyperref documentation for further information.
		</para>
	</refdescription>
	</doc:param>
	<xsl:variable name="latex.hyperref.param.pdftex">pdfstartview=FitH</xsl:variable>

	<doc:param name="latex.hyperref.param.dvips" xmlns="">
	<refpurpose> DB2LaTeX hyperref options for dvips output</refpurpose>
	<refdescription>
		<para>
		This variable is empty by default. See the hyperref documentation for further information.
		</para>
	</refdescription>
	</doc:param>
	<xsl:variable name="latex.hyperref.param.dvips"></xsl:variable>

    <xsl:variable name="latex.fancyhdr.lh">Left Header</xsl:variable>
    <xsl:variable name="latex.fancyhdr.ch">Center Header</xsl:variable>
    <xsl:variable name="latex.fancyhdr.rh">Right Header</xsl:variable>
    <xsl:variable name="latex.fancyhdr.lf">Left Footer</xsl:variable>
    <xsl:variable name="latex.fancyhdr.cf">Center Footer</xsl:variable>
    <xsl:variable name="latex.fancyhdr.rf">Right Footer</xsl:variable>
	
    <doc:param name="latex.step.title.style" xmlns="">
	<refpurpose> Control the style of step titles  </refpurpose>
	<refdescription>
	    <para>Step titles are typeset in small caps but if
		this option is set to a LaTeX command, such as <literal>\itshape{}</literal>, then
		that command will precede the title and it will be typeset accordingly.</para>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.step.title.style">\bf</xsl:variable>

    <doc:param name="latex.book.article.title.style" xmlns="">
	<refpurpose> Control the style of article titles within books </refpurpose>
	<refdescription>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.book.article.title.style">\Large\textbf</xsl:variable>

    <doc:param name="latex.article.title.style" xmlns="">
	<refpurpose> Control the style of article titles </refpurpose>
	<refdescription>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.article.title.style">\textbf</xsl:variable>

    <doc:param name="latex.pagestyle" xmlns="">
	<refpurpose> Override DB2LaTeX's choice of LaTeX page numbering style </refpurpose>
	<refdescription>
	    <para>By default, DB2LaTeX will choose the 'plain' or 'fancy' page styles,
		depending on <xref linkend="param.latex.use.fancyhdr"/>. If non-empty, this
		variable overrides the automatic selection. An example would be the literal
		string 'empty', to eliminate headers and page numbers.</para>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.pagestyle"></xsl:variable>

    <doc:param name="latex.procedure.title.style" xmlns="">
	<refpurpose> Control the style of procedure titles  </refpurpose>
	<refdescription>
	    <para>Procedure titles are typeset in small caps but if
		this option is set to a LaTeX command, such as <literal>\itshape{}</literal>, then
		that command will precede the title and it will be typeset accordingly.</para>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.procedure.title.style">\sc</xsl:variable>

    <doc:param name="latex.figure.title.style" xmlns="">
	<refpurpose> Control the style of figure titles  </refpurpose>
	<refdescription>
	    <para>Figure titles are typeset in the default typeface (usually 'roman') but if
		this option is set to a LaTeX command, such as <literal>\itshape{}</literal>, then
		that command will precede the title and it will be typeset accordingly.</para>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.figure.title.style"></xsl:variable>

    <doc:param name="latex.pdf.support" xmlns="">
	<refpurpose> Controls the output of LaTeX commands to support the generation 
	    of PDF files.</refpurpose>
	<refdescription>
	    <para>If this parameter is set to 1, the stylesheets generate code to 
		detect if it is either <literal>latex</literal> or <literal>pdflatex</literal>
		the shell command that is being used to compile the LaTeX text file. Some
		packages (<literal>graphicx</literal>, <literal>hyperref</literal>) are used
		with the right parameters. Finally, the graphic extensions declared, to use in
		<literal>\includegraphics</literal> commands depends also on which command is
		being used. If this parameter is set to zero, such code is not generated (which 
		does not mean that the file cannot compile with pdflatex, but some strange issues 
		may appear). <emphasis>DEFAULT: 1</emphasis> Only more code is generated. 
	    </para>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.pdf.support">1</xsl:variable>



    <doc:param name="latex.thead.row.entry" xmlns="">
	<refpurpose> Format the output of tabular headings. </refpurpose>
	<refdescription>
	</refdescription>
    </doc:param>
    <xsl:template name="latex.thead.row.entry">
	<xsl:apply-templates/>
	</xsl:template>



    <doc:param name="latex.math.support" xmlns="">
	<refpurpose> Controls the output of LaTeX packages and commands to support 
	    documents with math commands and environments..</refpurpose>
	<refdescription>
	    <para>If this parameter is set to 1, the stylesheets generate code to 
		<emphasis>DEFAULT: 1</emphasis> Only more code is generated. 
	    </para>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.math.support">1</xsl:variable>



    <doc:param name="latex.output.revhistory" xmlns="">
	<refpurpose> Controls  if the revision history table is generated as the first document 
	    table.
	</refpurpose>
	<refdescription>
	    <para>If this parameter is set to 1, the stylesheets generate code to 
		<emphasis>DEFAULT: 1</emphasis> Only more code is generated. 
	    </para>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.output.revhistory">1</xsl:variable>




    <xsl:variable name="latex.book.preamble.pre">
    </xsl:variable>

    <xsl:variable name="latex.book.preamble.post">
    </xsl:variable>

    <doc:param name="latex.book.varsets" xmlns="">
	<refpurpose> 
	    All purpose commands to change text width, height, counters, etc.
		Defaults to a two-sided margin layout.
	</refpurpose>
	<refdescription>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.book.varsets">
	<xsl:text>\usepackage{anysize}&#10;</xsl:text>
	<xsl:text>\marginsize{3cm}{2cm}{1.25cm}{1.25cm}&#10;</xsl:text>
    </xsl:variable>

    <doc:param name="latex.book.begindocument" xmlns="">
	<refpurpose> 
	    Begin document command
	</refpurpose>
	<refdescription>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.book.begindocument">
	<xsl:text>\begin{document}&#10;</xsl:text>
    </xsl:variable>





    <doc:param name="latex.book.afterauthor" xmlns="">
	<refpurpose> 
	    LaTeX code that is output after the author (e.g. 
	    <literal>\makeindex, \makeglossary</literal>
	</refpurpose>
	<refdescription>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.book.afterauthor">
	<xsl:text>% --------------------------------------------&#10;</xsl:text>
	<xsl:text>\makeindex&#10;</xsl:text>
	<xsl:text>\makeglossary&#10;</xsl:text>
	<xsl:text>% --------------------------------------------&#10;</xsl:text>
    </xsl:variable>




    <doc:param name="latex.book.end" xmlns="">
	<refpurpose> 
	    LaTeX code that is output  at the end of the document
	    <literal>\end{document}</literal>
	</refpurpose>
	<refdescription>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.book.end">
	<xsl:text>% --------------------------------------------&#10;</xsl:text>
	<xsl:text>% End of document&#10;</xsl:text>
	<xsl:text>% --------------------------------------------&#10;</xsl:text>
	<xsl:text>\end{document}&#10;</xsl:text>
    </xsl:variable>



    <!--############################################################################# 
    | 	XSL VARIABLES FOR ARTICLES	
    |- #############################################################################
    |
    + ############################################################################## -->



    <xsl:variable name="latex.article.preamble.pre">
    </xsl:variable>

    <xsl:variable name="latex.article.preamble.post">
    </xsl:variable>

    <doc:param name="latex.article.begindocument" xmlns="">
	<refpurpose> The begin document </refpurpose>
	<refdescription>The value of this variable is output from the article template
	    <xref linkend="template.article"/> after the author command. The default value
	    (shown below) is just the begin document command. Users of the XSL LaTeX
	    stylesheet may override this parameter in order to output what they want.
	</refdescription>
	<refreturn><literal>\begin{document}</literal></refreturn>
    </doc:param>
    <xsl:variable name="latex.article.begindocument">
	<xsl:text>\begin{document}&#10;</xsl:text>
    </xsl:variable>


    <doc:param name="latex.article.varsets" xmlns="">
	<refpurpose> Controls what is output after the LaTeX preamble. </refpurpose>
	<refdescription>
	    <para>Default values decrease edge margins and allow a large quantity of figures to be set on each page. </para>
	</refdescription>
    </doc:param>

    <xsl:variable name="latex.article.varsets">
	<xsl:text>
		\usepackage{anysize}
		\marginsize{2cm}{2cm}{2cm}{2cm}
	    \renewcommand\floatpagefraction{.9}
	    \renewcommand\topfraction{.9}
	    \renewcommand\bottomfraction{.9}
	    \renewcommand\textfraction{.1}
	</xsl:text>
    </xsl:variable>




    <doc:param name="latex.maketitle" xmlns="">
	<refpurpose> The <literal>\maketitle</literal> for books and articles. </refpurpose>
	<refdescription>
		<para>Some users may wish to override or eliminate <literal>\maketitle</literal>.</para>
		<note><para>Does not apply to <sgmltag class="element">article</sgmltag>s within <sgmltag class="element">book</sgmltag>s.</para></note>
		<para>By default, uses LaTeX <literal>\maketitle</literal> with the 'empty' pagestyle
		for the first page. The page style of subsequent pages is determined by
		<xref linkend="template.generate.latex.pagestyle"/>.</para>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.maketitle">
	<xsl:text>{\maketitle</xsl:text>
	<xsl:call-template name="generate.latex.pagestyle"/>
	<xsl:text>\thispagestyle{empty}}&#10;</xsl:text>
    </xsl:variable>


    <doc:param name="latex.article.end" xmlns="">
	<refpurpose> Controls what is output at the end of the article. Basically the <literal>\end{document}</literal>
	    command, with some markup comments.	</refpurpose>
	<refdescription>
	</refdescription>
    </doc:param>
    <xsl:variable name="latex.article.end">
	<xsl:text>&#10;</xsl:text>
	<xsl:text>% --------------------------------------------&#10;</xsl:text>
	<xsl:text>% End of document&#10;</xsl:text>
	<xsl:text>% --------------------------------------------&#10;</xsl:text>
	<xsl:text>\end{document}&#10;</xsl:text>
    </xsl:variable>



</xsl:stylesheet>