docbook2latex.xsl@ 96918

Last change on this file since 96918 was 96834, checked in by vboxsync, 2 years ago
doc/manual/docbook2latex.xsl: Improve frontmatter handling, eliminating the need to get the role hint. Also gets the page numbering right for the table of contents.
Property svn:eol-style set to `native` Property svn:keywords set to `Id Revision`
File size: 49.9 KB

Line
1	<?xml version="1.0"?>
2
3	<!--
4	docbook2latex.xslt:
5	translates a DocBook XML source into a LaTeX source file,
6	which can be processed with pdflatex to produce a
7	pretty PDF file.
8
9	Note: In the LaTeX output, this XSLT encodes all quotes
10	with \QUOTE{} commands, which are not defined in this
11	file. This is because XSLT does not support regular
12	expressions natively and therefore it is rather difficult
13	to implement proper "pretty quotes" (different glyphs for
14	opening and closing quotes) in XSLT. The doc/manual/
15	makefile solves this by running sed over the LaTeX source
16	once more, replacing all \QUOTE{} commands with
17	\OQ{} and \CQ{} commands, which _are_ defined to the
18	pretty quotes for English in the LaTeX output generated
19	by this XSLT (see below).
20	-->
21	<!--
22	Copyright (C) 2006-2022 Oracle and/or its affiliates.
23
24	This file is part of VirtualBox base platform packages, as
25	available from https://www.virtualbox.org.
26
27	This program is free software; you can redistribute it and/or
28	modify it under the terms of the GNU General Public License
29	as published by the Free Software Foundation, in version 3 of the
30	License.
31
32	This program is distributed in the hope that it will be useful, but
33	WITHOUT ANY WARRANTY; without even the implied warranty of
34	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
35	General Public License for more details.
36
37	You should have received a copy of the GNU General Public License
38	along with this program; if not, see <https://www.gnu.org/licenses>.
39
40	SPDX-License-Identifier: GPL-3.0-only
41	-->
42
43	<xsl:stylesheet
44	version="1.0"
45	xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
46	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
47	xmlns:str="http://xsltsl.org/string"
48	>
49
50	<xsl:import href="string.xsl"/>
51	<xsl:import href="common-formatcfg.xsl"/>
52
53	<xsl:variable name="g_nlsChapter">
54	<xsl:choose>
55	<xsl:when test="$TARGETLANG='de_DE'">Kapitel</xsl:when>
56	<xsl:when test="$TARGETLANG='fr_FR'">chapitre</xsl:when>
57	<xsl:when test="$TARGETLANG='en_US'">chapter</xsl:when>
58	<xsl:otherwise>
59	<xsl:message terminate="yes"><xsl:value-of select="concat('Invalid language ', $TARGETLANG)" /></xsl:message>
60	</xsl:otherwise>
61	</xsl:choose>
62	</xsl:variable>
63
64	<xsl:variable name="g_nlsPage">
65	<xsl:choose>
66	<xsl:when test="$TARGETLANG='de_DE'">auf Seite</xsl:when>
67	<xsl:when test="$TARGETLANG='fr_FR'">page</xsl:when>
68	<xsl:when test="$TARGETLANG='en_US'">page</xsl:when>
69	<xsl:otherwise>
70	<xsl:message terminate="yes"><xsl:value-of select="concat('Invalid language ', $TARGETLANG)" /></xsl:message>
71	</xsl:otherwise>
72	</xsl:choose>
73	</xsl:variable>
74
75	<xsl:variable name="g_nlsNote">
76	<xsl:choose>
77	<xsl:when test="$TARGETLANG='de_DE'">Hinweis</xsl:when>
78	<xsl:when test="$TARGETLANG='fr_FR'">Note</xsl:when>
79	<xsl:when test="$TARGETLANG='en_US'">Note</xsl:when>
80	<xsl:otherwise>
81	<xsl:message terminate="yes"><xsl:value-of select="concat('Invalid language ', $TARGETLANG)" /></xsl:message>
82	</xsl:otherwise>
83	</xsl:choose>
84	</xsl:variable>
85
86	<xsl:variable name="g_nlsWarning">
87	<xsl:choose>
88	<xsl:when test="$TARGETLANG='de_DE'">Warnung</xsl:when>
89	<xsl:when test="$TARGETLANG='fr_FR'">Avertissement</xsl:when>
90	<xsl:when test="$TARGETLANG='en_US'">Warning</xsl:when>
91	<xsl:otherwise>
92	<xsl:message terminate="yes"><xsl:value-of select="concat('Invalid language ', $TARGETLANG)" /></xsl:message>
93	</xsl:otherwise>
94	</xsl:choose>
95	</xsl:variable>
96
97	<!-- command synopsis -->
98	<xsl:variable name="arg.rep.repeat.str.tex">\ldots{}</xsl:variable>
99	<xsl:variable name="arg.or.sep.tex"> \|~</xsl:variable>
100
101	<xsl:output method="text"/>
102
103	<xsl:strip-space elements="*"/>
104	<xsl:preserve-space elements="para"/>
105
106	<xsl:template match="/book">
107	<xsl:text>
108	\documentclass[oneside,a4paper,10pt,DIV10]{scrbook}
109	\usepackage{geometry}
110	\geometry{top=3cm,bottom=4cm}
111	\usepackage[T1]{fontenc}
112	\usepackage{tabulary}
113	\usepackage[pdftex,
114	a4paper,
115	colorlinks=true,
116	linkcolor=blue,
117	urlcolor=darkgreen,
118	bookmarksnumbered,
119	bookmarksopen=true,
120	bookmarksopenlevel=0,
121	hyperfootnotes=false,
122	plainpages=false,
123	pdfpagelabels
124	]{hyperref}
125
126	\usepackage{nameref}
127	\usepackage{graphicx}
128	\usepackage{hyperref}
129	\usepackage{fancybox}
130	\usepackage{alltt}
131	\usepackage{color}
132	\usepackage{scrextend}
133	\definecolor{darkgreen}{rgb}{0,0.6,0}
134	\tymin=21pt
135
136	</xsl:text>
137	<xsl:if test="$TARGETLANG='de_DE'">\usepackage[ngerman]{babel} \PrerenderUnicode{ü}</xsl:if>
138	<!-- <xsl:if test="$TARGETLANG='fr_FR'">\usepackage[french]{babel} \FrenchItemizeSpacingfalse \renewcommand{\FrenchLabelItem}{\textbullet}</xsl:if>
139	this command is no longer understood by TexLive2008
140	-->
141	<xsl:text>
142
143	% use Palatino as serif font:
144	% \usepackage{mathpazo}
145	\usepackage{charter}
146	% use Helvetica as sans-serif font:
147	\usepackage{helvet}
148
149	% use Bera Mono (a variant of Bitstream Vera Mono) as typewriter font
150	% (requires texlive-fontsextra)
151	\usepackage[scaled]{beramono}
152	% previously: use Courier as typewriter font:
153	% \usepackage{courier}
154
155	\definecolor{colNote}{rgb}{0,0,0}
156	\definecolor{colWarning}{rgb}{0,0,0}
157	\definecolor{colScreenFrame}{rgb}{0,0,0}
158	\definecolor{colScreenText}{rgb}{0,0,0}
159
160	% number headings down to this level
161	\setcounter{secnumdepth}{3}
162	% more space for the section numbers
163	\makeatletter
164	\renewcommand*\l@section{\@dottedtocline{1}{1.5em}{2.9em}}
165	\renewcommand*\l@subsection{\@dottedtocline{2}{4.4em}{3.8em}}
166	\renewcommand*\l@subsubsection{\@dottedtocline{3}{8.2em}{3.8em}}
167	\renewcommand*\@pnumwidth{1.7em}
168	\renewcommand*\@tocrmarg{5.0em}
169	\makeatother
170
171	% more tolerance at 2nd wrap stage:
172	\tolerance = 1000
173	% allow 3rd wrap stage:
174	\emergencystretch = 10pt
175	% no Schusterjungen:
176	\clubpenalty = 10000
177	% no Hurenkinder:
178	\widowpenalty = 10000
179	\displaywidowpenalty = 10000
180	% max pdf compression:
181	\pdfcompresslevel9
182
183	% opening and closing quotes: the OQ and CQ macros define this (and the makefile employs some sed magic also)
184	</xsl:text>
185	<xsl:choose>
186	<xsl:when test="$TARGETLANG='de_DE'">
187	<xsl:text>\newcommand\OQ{\texorpdfstring{\glqq}{"}} \newcommand\CQ{\texorpdfstring{\grqq}{"}} </xsl:text>
188	</xsl:when>
189	<xsl:when test="$TARGETLANG='fr_FR'">
190	<xsl:text>\newcommand\OQ{\texorpdfstring{``}{"}} \newcommand\CQ{\texorpdfstring{''}{"}} </xsl:text>
191	</xsl:when>
192	<xsl:when test="$TARGETLANG='en_US'">
193	<xsl:text>\newcommand\OQ{\texorpdfstring{``}{"}} \newcommand\CQ{\texorpdfstring{''}{"}} </xsl:text>
194	</xsl:when>
195	<xsl:otherwise>
196	<xsl:message terminate="yes"><xsl:value-of select="concat('Invalid language ', $TARGETLANG)" /></xsl:message>
197	</xsl:otherwise>
198	</xsl:choose>
199
200	<xsl:apply-templates />
201
202	<xsl:text>
203	\end{sloppypar}
204	\end{document}
205	</xsl:text>
206
207	</xsl:template>
208
209	<xsl:template match="bookinfo">
210	<xsl:apply-templates />
211	<xsl:text> \newcommand\docbookbookinfocopyright{Copyright \copyright{} \docbookbookinfocopyrightyear{} \docbookbookinfocopyrightholder{}}
212	\author{ \docbooktitleedition \\ %
213	\\ %
214	</xsl:text>
215	<xsl:if test="//bookinfo/address">
216	<xsl:text>\docbookbookinfoaddress \\ %
217	\\ %
218	</xsl:text>
219	</xsl:if>
220	<xsl:text>\docbookbookinfocopyright \\ %
221	}
222
223	\title{\docbooktitle \\
224	\docbooksubtitle}
225	% \subtitle{\docbooksubtitle}
226	\hypersetup{pdfauthor=\docbookcorpauthor}
227	\hypersetup{pdftitle=\docbooktitle{} \docbooksubtitle{}}
228
229	\hyphenation{da-ta-ba-ses}
230	\hyphenation{deb-conf}
231	\hyphenation{VirtualBox}
232
233	\begin{document}
234	\frontmatter
235	% bird/2018-05-14: Use sloppypar so we don't push path names and other long words
236	% thru the right margin. TODO: Find better solution? microtype?
237	\begin{sloppypar}
238	% \maketitle
239	%\begin{titlepage}
240	\thispagestyle{empty}
241	\begin{minipage}{\textwidth}
242	\begin{center}
243	\includegraphics[width=4cm]{images/vboxlogo.png}
244	\end{center}%
245	\vspace{10mm}
246
247	{\fontsize{40pt}{40pt}\selectfont\rmfamily\bfseries%
248	\begin{center}
249	\docbooktitle
250	\end{center}%
251	\vspace{10mm}
252	}
253
254	{\fontsize{30pt}{30pt}\selectfont\rmfamily\bfseries%
255	\begin{center}
256	\docbooksubtitle
257	\end{center}%
258	\vspace{10mm}
259	}
260
261	{\fontsize{16pt}{20pt}\selectfont\rmfamily%
262	\begin{center}
263	</xsl:text>
264	<xsl:if test="//bookinfo/othercredit">
265	<xsl:text>\docbookbookinfoothercreditcontrib{}: \docbookbookinfoothercreditfirstname{} \docbookbookinfoothercreditsurname
266
267	\vspace{8mm}
268	</xsl:text>
269	</xsl:if>
270	<xsl:text>\docbooktitleedition
271
272	\vspace{2mm}
273
274	\docbookbookinfocopyright
275
276	\vspace{2mm}
277
278	\docbookbookinfoaddress
279	\end{center}%
280	}
281
282	%\end{titlepage}
283	\end{minipage}
284
285	\tableofcontents
286	</xsl:text>
287	</xsl:template>
288
289	<xsl:template match="subtitle">
290	<xsl:choose>
291	<xsl:when test="name(..)='bookinfo'">
292	<xsl:text>\newcommand\docbooksubtitle{</xsl:text>
293	<xsl:apply-templates />
294	<xsl:text>}</xsl:text>
295	</xsl:when>
296	</xsl:choose>
297	</xsl:template>
298
299	<!-- Determins the section depth, returning a number 1,2,3,4,5,6,7,... -->
300	<xsl:template name="get-section-level">
301	<xsl:param name="a_Node" select=".."/>
302	<xsl:for-each select="$a_Node"> <!-- makes it current -->
303	<xsl:choose>
304	<xsl:when test="self::sect1"><xsl:text>1</xsl:text></xsl:when>
305	<xsl:when test="self::sect2"><xsl:text>2</xsl:text></xsl:when>
306	<xsl:when test="self::sect3"><xsl:text>3</xsl:text></xsl:when>
307	<xsl:when test="self::sect4"><xsl:text>4</xsl:text></xsl:when>
308	<xsl:when test="self::sect5"><xsl:text>5</xsl:text></xsl:when>
309	<xsl:when test="self::section">
310	<xsl:value-of select="count(ancestor::section) + 1"/>
311	</xsl:when>
312	<xsl:when test="self::simplesect">
313	<xsl:variable name="tmp">
314	<xsl:call-template name="get-section-level">
315	<xsl:with-param name="a_Node" select="parent::*"/>
316	</xsl:call-template>
317	</xsl:variable>
318	<xsl:value-of select="$tmp + 1"/>
319	</xsl:when>
320	<xsl:when test="self::preface"><xsl:text>0</xsl:text></xsl:when>
321	<xsl:when test="self::chapter"><xsl:text>0</xsl:text></xsl:when>
322	<xsl:when test="self::appendix"><xsl:text>0</xsl:text></xsl:when>
323	<xsl:when test="self::article"><xsl:text>0</xsl:text></xsl:when>
324	<xsl:otherwise>
325	<xsl:message terminate="yes">get-section-level was called on non-section element: <xsl:value-of select="."/> </xsl:message>
326	</xsl:otherwise>
327	</xsl:choose>
328	</xsl:for-each>
329	</xsl:template>
330
331	<!--
332	Inserts \hypertarget{@id} that can be referenced via the /A "nameddest=@id"
333	command line or #nameddest=@id URL parameter.
334
335	TODO: The placement of the target could be improved on. The raisebox
336	stuff is a crude hack to make it a little more acceptable. -->
337	<xsl:template name="title-wrapper">
338	<xsl:param name="texcmd" select="concat('\',name(..))"/>
339	<xsl:param name="refid" select="../@id"/>
340	<xsl:param name="role" select="../@role"/>
341
342	<xsl:call-template name="xsltprocNewlineOutputHack"/>
343	<xsl:if test="$texcmd='\chapter' and name(../preceding-sibling::*[1])='preface'">
344	<xsl:text>\mainmatter </xsl:text>
345	</xsl:if>
346	<xsl:choose>
347	<xsl:when test="$refid">
348	<xsl:text> </xsl:text>
349	<xsl:value-of select="$texcmd"/>
350	<xsl:if test="not(contains($texcmd, '*'))">
351	<xsl:text>[</xsl:text> <!-- for toc -->
352	<xsl:apply-templates />
353	<xsl:text>]</xsl:text>
354	</xsl:if>
355	<xsl:text>{</xsl:text> <!-- for doc -->
356	<xsl:text>\raisebox{\ht\strutbox}{\hypertarget{</xsl:text>
357	<xsl:value-of select="$refid"/>
358	<xsl:text>}{}}</xsl:text>
359	<xsl:apply-templates />
360	<xsl:text>}</xsl:text>
361	</xsl:when>
362	<xsl:otherwise>
363	<xsl:text> </xsl:text><xsl:value-of select="$texcmd"/><xsl:text>{</xsl:text>
364	<xsl:apply-templates />
365	<xsl:text>}</xsl:text>
366	</xsl:otherwise>
367	</xsl:choose>
368	</xsl:template>
369
370	<xsl:template match="title">
371	<xsl:variable name="refid" select="../@id" />
372	<xsl:choose>
373	<xsl:when test="name(..)='bookinfo'">
374	<xsl:text>\newcommand\docbooktitle{</xsl:text>
375	<xsl:apply-templates />
376	<xsl:text>}</xsl:text>
377	</xsl:when>
378	<xsl:when test="name(..)='chapter'">
379	<xsl:call-template name="title-wrapper"/>
380	</xsl:when>
381	<xsl:when test="name(..)='preface'">
382	<xsl:call-template name="title-wrapper">
383	<xsl:with-param name="texcmd">\chapter</xsl:with-param>
384	</xsl:call-template>
385	</xsl:when>
386	<xsl:when test="name(..)='sect1'">
387	<xsl:call-template name="title-wrapper">
388	<xsl:with-param name="texcmd">\section</xsl:with-param>
389	</xsl:call-template>
390	</xsl:when>
391	<xsl:when test="parent::sect2[@role='not-in-toc'] or parent::refsect1 or (parent::section and count(ancestor::section) = 2)">
392	<xsl:call-template name="title-wrapper">
393	<xsl:with-param name="texcmd">\subsection*</xsl:with-param>
394	</xsl:call-template>
395	</xsl:when>
396	<xsl:when test="name(..)='sect2'">
397	<xsl:call-template name="title-wrapper">
398	<xsl:with-param name="texcmd">\subsection</xsl:with-param>
399	</xsl:call-template>
400	</xsl:when>
401	<xsl:when test="parent::sect3[@role='not-in-toc'] or parent::refsect2 or (parent::section and count(ancestor::section) = 3)">
402	<xsl:call-template name="title-wrapper">
403	<xsl:with-param name="texcmd">\subsubsection*</xsl:with-param>
404	</xsl:call-template>
405	</xsl:when>
406	<xsl:when test="name(..)='sect3'">
407	<xsl:call-template name="title-wrapper">
408	<xsl:with-param name="texcmd">\subsubsection</xsl:with-param>
409	</xsl:call-template>
410	</xsl:when>
411	<xsl:when test="parent::sect4[@role='not-in-toc'] or parent::refsect3 or (parent::section and count(ancestor::section) = 4)">
412	<xsl:call-template name="title-wrapper">
413	<xsl:with-param name="texcmd">\paragraph*</xsl:with-param>
414	</xsl:call-template>
415	</xsl:when>
416	<xsl:when test="name(..)='sect4'">
417	<xsl:call-template name="title-wrapper">
418	<xsl:with-param name="texcmd">\paragraph</xsl:with-param>
419	</xsl:call-template>
420	</xsl:when>
421	<xsl:when test="parent::sect5[@role='not-in-toc'] or parent::refsect4 or (parent::section and count(ancestor::section) = 5)">
422	<xsl:call-template name="title-wrapper">
423	<xsl:with-param name="texcmd">\subparagraph*</xsl:with-param>
424	</xsl:call-template>
425	</xsl:when>
426	<xsl:when test="name(..)='sect5'">
427	<xsl:call-template name="title-wrapper">
428	<xsl:with-param name="texcmd">\subparagraph</xsl:with-param>
429	</xsl:call-template>
430	</xsl:when>
431	<xsl:when test="name(..)='appendix'">
432	<xsl:call-template name="title-wrapper">
433	<xsl:with-param name="texcmd">\chapter</xsl:with-param>
434	</xsl:call-template>
435	</xsl:when>
436	<xsl:when test="name(..)='glossdiv'">
437	<xsl:call-template name="title-wrapper">
438	<xsl:with-param name="texcmd">\section*</xsl:with-param>
439	</xsl:call-template>
440	</xsl:when>
441
442	<xsl:when test="parent::simplesect">
443	<xsl:if test="../@role">
444	<xsl:message terminate="yes">Role not allowed with simplesect: <xsl:value-of select="../@role"/></xsl:message>
445	</xsl:if>
446	<xsl:variable name="level">
447	<xsl:call-template name="get-section-level">
448	<xsl:with-param name="a_Node" select=".."/>
449	</xsl:call-template>
450	</xsl:variable>
451	<xsl:choose>
452	<xsl:when test="$level = 1">
453	<xsl:call-template name="title-wrapper"><xsl:with-param name="texcmd">\section*</xsl:with-param></xsl:call-template>
454	</xsl:when>
455	<xsl:when test="$level = 2">
456	<xsl:call-template name="title-wrapper"><xsl:with-param name="texcmd">\subsection*</xsl:with-param></xsl:call-template>
457	</xsl:when>
458	<xsl:when test="$level = 3">
459	<xsl:call-template name="title-wrapper"><xsl:with-param name="texcmd">\subsubsection*</xsl:with-param></xsl:call-template>
460	</xsl:when>
461	<xsl:when test="$level = 4">
462	<xsl:call-template name="title-wrapper"><xsl:with-param name="texcmd">\paragraph*</xsl:with-param></xsl:call-template>
463	</xsl:when>
464	<xsl:when test="$level = 5">
465	<xsl:call-template name="title-wrapper"><xsl:with-param name="texcmd">\subparagraph*</xsl:with-param></xsl:call-template>
466	</xsl:when>
467	<xsl:otherwise>
468	<xsl:message terminate="yes">Unsupported simplesect/title depth: <xsl:value-of select="$level"/></xsl:message>
469	</xsl:otherwise>
470	</xsl:choose>
471	</xsl:when>
472
473	</xsl:choose>
474	<xsl:if test="$refid">
475	<xsl:value-of select="concat(' \label{', $refid, '}')" />
476	</xsl:if>
477	<xsl:text> </xsl:text>
478	</xsl:template>
479
480	<xsl:template match="edition">
481	<xsl:choose>
482	<xsl:when test="name(..)='bookinfo'">
483	<xsl:text>\newcommand\docbooktitleedition{</xsl:text>
484	<xsl:apply-templates />
485	<xsl:text>} </xsl:text>
486	</xsl:when>
487	</xsl:choose>
488	</xsl:template>
489
490	<xsl:template match="corpauthor">
491	<xsl:choose>
492	<xsl:when test="name(..)='bookinfo'">
493	<xsl:text>\newcommand\docbookcorpauthor{</xsl:text>
494	<xsl:apply-templates />
495	<xsl:text>} </xsl:text>
496	</xsl:when>
497	</xsl:choose>
498	</xsl:template>
499
500	<xsl:template match="address">
501	<xsl:choose>
502	<xsl:when test="name(..)='bookinfo'">
503	<xsl:text>\newcommand\docbookbookinfoaddress{</xsl:text>
504	<xsl:apply-templates />
505	<xsl:text>} </xsl:text>
506	</xsl:when>
507	</xsl:choose>
508	</xsl:template>
509
510	<xsl:template match="year">
511	<xsl:choose>
512	<xsl:when test="name(..)='copyright'">
513	<xsl:text>\newcommand\docbookbookinfocopyrightyear{</xsl:text>
514	<xsl:apply-templates />
515	<xsl:text>} </xsl:text>
516	</xsl:when>
517	</xsl:choose>
518	</xsl:template>
519
520	<xsl:template match="holder">
521	<xsl:choose>
522	<xsl:when test="name(..)='copyright'">
523	<xsl:text>\newcommand\docbookbookinfocopyrightholder{</xsl:text>
524	<xsl:apply-templates />
525	<xsl:text>} </xsl:text>
526	</xsl:when>
527	</xsl:choose>
528	</xsl:template>
529
530	<xsl:template match="firstname">
531	<xsl:choose>
532	<xsl:when test="name(..)='othercredit'">
533	<xsl:text>\newcommand\docbookbookinfoothercreditfirstname{</xsl:text>
534	<xsl:apply-templates />
535	<xsl:text>} </xsl:text>
536	</xsl:when>
537	</xsl:choose>
538	</xsl:template>
539
540	<xsl:template match="surname">
541	<xsl:choose>
542	<xsl:when test="name(..)='othercredit'">
543	<xsl:text>\newcommand\docbookbookinfoothercreditsurname{</xsl:text>
544	<xsl:apply-templates />
545	<xsl:text>} </xsl:text>
546	</xsl:when>
547	</xsl:choose>
548	</xsl:template>
549
550	<xsl:template match="contrib">
551	<xsl:choose>
552	<xsl:when test="name(..)='othercredit'">
553	<xsl:text>\newcommand\docbookbookinfoothercreditcontrib{</xsl:text>
554	<xsl:apply-templates />
555	<xsl:text>} </xsl:text>
556	</xsl:when>
557	</xsl:choose>
558	</xsl:template>
559
560	<xsl:template match="glossary">
561	<xsl:text> \backmatter \chapter{Glossary} </xsl:text>
562	<xsl:apply-templates />
563	</xsl:template>
564
565	<xsl:template match="para">
566	<xsl:if test="not(name(..)='footnote' or name(..)='note' or name(..)='warning' or name(..)='entry' or (name(../..)='varlistentry' and position()=1))">
567	<xsl:text> </xsl:text>
568	</xsl:if>
569	<xsl:apply-templates />
570	</xsl:template>
571
572	<xsl:template match="note">
573	<xsl:value-of select="concat(' \vspace{.2cm} \begin{center}\fbox{\begin{minipage}[c]{0.9\textwidth}\color{colNote}\textbf{', $g_nlsNote, ':} ')" />
574	<xsl:apply-templates />
575	<xsl:text>\end{minipage}}\end{center} \vspace{.2cm} </xsl:text>
576	</xsl:template>
577
578	<xsl:template match="warning">
579	<xsl:value-of select="concat(' \vspace{.2cm} \begin{center}\fbox{\begin{minipage}[c]{0.9\textwidth}\color{colWarning}\textbf{', $g_nlsWarning, ':} ')" />
580	<xsl:apply-templates />
581	<xsl:text>\end{minipage}}\end{center} \vspace{.2cm} </xsl:text>
582	</xsl:template>
583
584	<xsl:template match="screen">
585	<xsl:text> {\footnotesize\begin{alltt} </xsl:text>
586	<xsl:apply-templates />
587	<xsl:text> \end{alltt}} </xsl:text>
588	</xsl:template>
589
590	<xsl:template match="programlisting">
591	<xsl:text> {\small\begin{alltt} </xsl:text>
592	<xsl:apply-templates />
593	<xsl:text> \end{alltt}} </xsl:text>
594	</xsl:template>
595
596	<xsl:template match="footnote">
597	<xsl:text>\footnote{</xsl:text>
598	<xsl:apply-templates />
599	<xsl:text>}</xsl:text>
600	</xsl:template>
601
602	<xsl:template match="tgroup">
603	<xsl:choose>
604	<xsl:when test="@style='verywide'">
605	<xsl:text> {\small\begin{center} \begin{tabulary}{1.1\textwidth}[]</xsl:text>
606	</xsl:when>
607	<xsl:otherwise>
608	<xsl:text> {\small\begin{center} \begin{tabulary}{.9\textwidth}[]</xsl:text>
609	</xsl:otherwise>
610	</xsl:choose>
611	<xsl:text>{</xsl:text>
612	<xsl:choose>
613	<xsl:when test="@cols='1'">
614	<xsl:text>\|L\|</xsl:text>
615	</xsl:when>
616	<xsl:when test="@cols='2'">
617	<xsl:text>\|L\|L\|</xsl:text>
618	</xsl:when>
619	<xsl:when test="@cols='3'">
620	<xsl:text>\|L\|L\|L\|</xsl:text>
621	</xsl:when>
622	<xsl:when test="@cols='4'">
623	<xsl:text>\|L\|L\|L\|L\|</xsl:text>
624	</xsl:when>
625	<xsl:when test="@cols='5'">
626	<xsl:text>\|L\|L\|L\|L\|L\|</xsl:text>
627	</xsl:when>
628	<xsl:when test="@cols='6'">
629	<xsl:text>\|L\|L\|L\|L\|L\|L\|</xsl:text>
630	</xsl:when>
631	<xsl:otherwise>
632	<xsl:message terminate="yes">Unsupported number of columns (<xsl:value-of select="@cols"/>), fix document or converter</xsl:message>
633	</xsl:otherwise>
634	</xsl:choose>
635	<xsl:text>} \hline </xsl:text>
636	<xsl:apply-templates />
637	<xsl:text> \end{tabulary} \end{center}} </xsl:text>
638	</xsl:template>
639
640	<xsl:template match="row">
641	<xsl:apply-templates />
642	<xsl:text> \\ \hline </xsl:text>
643	</xsl:template>
644
645	<xsl:template match="entry">
646	<xsl:if test="not(position()=1)">
647	<xsl:text> & </xsl:text>
648	</xsl:if>
649	<xsl:apply-templates />
650	</xsl:template>
651
652	<xsl:template match="itemizedlist">
653	<xsl:call-template name="xsltprocNewlineOutputHack"/>
654	<xsl:text> \begin{itemize} </xsl:text>
655	<xsl:if test="@spacing = 'compact'">
656	<xsl:text> \setlength{\parskip}{0pt} </xsl:text>
657	<xsl:text> \setlength{\itemsep}{0pt} </xsl:text>
658	<xsl:text> \setlength{\topsep}{0pt} </xsl:text>
659	<xsl:text> \setlength{\parsep}{0pt} </xsl:text>
660	<xsl:text> \setlength{\partopsep}{0pt} </xsl:text>
661	</xsl:if>
662	<xsl:apply-templates />
663	<xsl:text> \end{itemize} </xsl:text>
664	</xsl:template>
665
666	<xsl:template match="orderedlist">
667	<xsl:call-template name="xsltprocNewlineOutputHack"/>
668	<xsl:text> \begin{enumerate} </xsl:text>
669	<xsl:if test="@spacing = 'compact'">
670	<xsl:text> \setlength{\parskip}{0pt} </xsl:text>
671	<xsl:text> \setlength{\itemsep}{0pt} </xsl:text>
672	<xsl:text> \setlength{\topsep}{0pt} </xsl:text>
673	<xsl:text> \setlength{\parsep}{0pt} </xsl:text>
674	<xsl:text> \setlength{\partopsep}{0pt} </xsl:text>
675	</xsl:if>
676	<xsl:apply-templates />
677	<xsl:text> \end{enumerate} </xsl:text>
678	</xsl:template>
679
680	<xsl:template match="variablelist">
681	<xsl:call-template name="xsltprocNewlineOutputHack"/>
682	<xsl:text> \begin{description} </xsl:text>
683	<xsl:if test="@spacing = 'compact'">
684	<xsl:text> \setlength{\parskip}{0pt} </xsl:text>
685	<xsl:text> \setlength{\itemsep}{0pt} </xsl:text>
686	<xsl:text> \setlength{\topsep}{0pt} </xsl:text>
687	<xsl:text> \setlength{\parsep}{0pt} </xsl:text>
688	<xsl:text> \setlength{\partopsep}{0pt} </xsl:text>
689	</xsl:if>
690	<xsl:apply-templates />
691	<xsl:text> \end{description} </xsl:text>
692	</xsl:template>
693
694	<xsl:template match="varlistentry">
695	<xsl:if test="not(./term) or not(./listitem) or count(./listitem) != 1">
696	<xsl:message terminate="yes">Expected at least one term and one listitem element in the varlistentry.</xsl:message>
697	</xsl:if>
698	<xsl:text> \item[{\parbox[t]{\linewidth}{\raggedright </xsl:text>
699	<xsl:apply-templates select="./term[1]"/>
700	<xsl:for-each select="./term[position() > 1]">
701	<xsl:text>\\ </xsl:text>
702	<xsl:apply-templates select="."/>
703	</xsl:for-each>
704	<xsl:text>}}]\hfill\\</xsl:text>
705	<xsl:apply-templates select="listitem/*"/>
706	</xsl:template>
707
708	<xsl:template match="listitem">
709	<xsl:text> \item </xsl:text>
710	<xsl:apply-templates />
711	<xsl:text> </xsl:text>
712	</xsl:template>
713
714	<xsl:template match="glossterm">
715	<xsl:variable name="refid" select="(@id)" />
716	<xsl:if test="$refid">
717	<xsl:value-of select="concat(' \label{', $refid, '}')" />
718	</xsl:if>
719	<xsl:text> \item[</xsl:text>
720	<xsl:apply-templates />
721	<xsl:text>]</xsl:text>
722	</xsl:template>
723
724	<xsl:template match="glosslist \| glossdiv">
725	<xsl:text> \begin{description} </xsl:text>
726	<xsl:apply-templates />
727	<xsl:text> \end{description} </xsl:text>
728	</xsl:template>
729
730	<xsl:template match="superscript">
731	<xsl:variable name="contents">
732	<xsl:apply-templates />
733	</xsl:variable>
734	<xsl:value-of select="concat('\texorpdfstring{\textsuperscript{', $contents, '}}{', $contents, '}')" />
735	</xsl:template>
736
737	<xsl:template match="emphasis">
738	<xsl:choose>
739	<xsl:when test="@role='bold'">
740	<xsl:text>\textbf{</xsl:text>
741	</xsl:when>
742	<xsl:otherwise>
743	<xsl:text>\textit{</xsl:text>
744	</xsl:otherwise>
745	</xsl:choose>
746	<xsl:apply-templates />
747	<xsl:text>}</xsl:text>
748	</xsl:template>
749
750	<xsl:template match="computeroutput \| code">
751	<xsl:text>\texttt{</xsl:text>
752	<xsl:apply-templates />
753	<xsl:text>}</xsl:text>
754	</xsl:template>
755
756	<xsl:template match="literal \| filename">
757	<xsl:text>\texttt{</xsl:text>
758	<xsl:apply-templates />
759	<xsl:text>}</xsl:text>
760	</xsl:template>
761
762	<xsl:template match="citetitle">
763	<xsl:text>\textit{</xsl:text>
764	<xsl:apply-templates />
765	<xsl:text>}</xsl:text>
766	</xsl:template>
767
768	<xsl:template match="lineannotation">
769	<xsl:text>\textit{</xsl:text>
770	<xsl:apply-templates />
771	<xsl:text>}</xsl:text>
772	</xsl:template>
773
774	<xsl:template match="ulink[@url!='' and not(text())]">
775	<xsl:text>\url{</xsl:text>
776	<xsl:value-of select="@url"/>
777	<xsl:text>}</xsl:text>
778	</xsl:template>
779
780	<xsl:template match="ulink[@url!='' and text()]">
781	<xsl:text>\href{</xsl:text>
782	<xsl:value-of select="@url"/>
783	<xsl:text>}{</xsl:text>
784	<xsl:apply-templates />
785	<xsl:text>}</xsl:text>
786	</xsl:template>
787
788	<xsl:template match="ulink[(@url='' or not(@url)) and text()]">
789	<xsl:text>\url{</xsl:text>
790	<xsl:apply-templates />
791	<xsl:text>}</xsl:text>
792	</xsl:template>
793
794	<xsl:template match="xref">
795	<xsl:choose>
796	<xsl:when test="@endterm">
797	<xsl:value-of select="concat('\hyperref[', @linkend, ']{\mbox{', @endterm, '}}')" />
798	</xsl:when>
799	<xsl:otherwise>
800	<xsl:value-of select="concat($g_nlsChapter, ' \ref{', @linkend, '}, \textit{\nameref{', @linkend, '}}, ', $g_nlsPage, ' \pageref{', @linkend, '}')" />
801	</xsl:otherwise>
802	</xsl:choose>
803	</xsl:template>
804
805	<xsl:template match="link">
806	<xsl:choose>
807	<xsl:when test="@endterm">
808	<xsl:value-of select="concat('\hyperref[', @linkend, ']{\mbox{', @endterm, '}}')" />
809	</xsl:when>
810	<xsl:when test="./text()">
811	<xsl:value-of select="concat('\hyperref[', @linkend, ']{\mbox{')" />
812	<xsl:apply-templates select="./text()"/>
813	<xsl:value-of select="'}}'" />
814	</xsl:when>
815	<xsl:otherwise>
816	<xsl:value-of select="concat($g_nlsChapter, ' \ref{', @linkend, '}, \textit{\nameref{', @linkend, '}}, ', $g_nlsPage, ' \pageref{', @linkend, '}')" />
817	</xsl:otherwise>
818	</xsl:choose>
819	</xsl:template>
820
821	<xsl:template match="trademark">
822	<xsl:apply-templates />
823	<xsl:text>\textsuperscript{\textregistered}</xsl:text>
824	</xsl:template>
825
826	<!-- for some reason, DocBook insists of having image data nested this way always:
827	mediaobject -> imageobject -> imagedata
828	but only imagedata is interesting -->
829	<xsl:template match="imagedata">
830	<xsl:if test="@align='center'">
831	<xsl:text>\begin{center}</xsl:text>
832	</xsl:if>
833	<xsl:value-of select="concat(' \includegraphics[width=', @width, ']{', @fileref, '} ')" />
834	<xsl:apply-templates />
835	<xsl:if test="@align='center'">
836	<xsl:text>\end{center}</xsl:text>
837	</xsl:if>
838	</xsl:template>
839
840	<!--
841	Turn the refsynopsisdiv part of a manpage into a named & indented paragraph.
842	-->
843	<xsl:template match="refsynopsisdiv">
844	<xsl:if test="name(*[1]) != 'cmdsynopsis'"><xsl:message terminate="yes">Expected refsynopsisdiv to start with cmdsynopsis</xsl:message></xsl:if>
845	<xsl:if test="title"><xsl:message terminate="yes">No title element supported in refsynopsisdiv</xsl:message></xsl:if>
846	<xsl:call-template name="xsltprocNewlineOutputHack"/>
847	<xsl:text> \subsection*{Synopsis} </xsl:text>
848	<xsl:apply-templates />
849	</xsl:template>
850
851	<!--
852	The refsect1 is used for 'Description' and such. Do same as with refsynopsisdiv
853	and turn it into a named & indented paragraph.
854	-->
855	<xsl:template match="refsect1">
856	<xsl:if test="name(*[1]) != 'title' or count(title) != 1">
857	<xsl:message terminate="yes">Expected exactly one title as the first refsect1 element (remarks goes after title!).</xsl:message>
858	</xsl:if>
859	<xsl:apply-templates/>
860	</xsl:template>
861
862	<!--
863	The refsect2 element will be turned into a subparagraph if it has a title,
864	however, that didn't work out when it didn't have a title and started with
865	a cmdsynopsis instead (subcommand docs). So, we're doing some trickery
866	here (HACK ALERT) for the non-title case to feign a paragraph.
867	-->
868	<xsl:template match="refsect2">
869	<xsl:if test="name(*[1]) != 'title' or count(title) != 1">
870	<xsl:message terminate="yes">Expected exactly one title as the first refsect2 element (remarks goes after title!).</xsl:message>
871	</xsl:if>
872	<xsl:apply-templates/>
873	<xsl:text> </xsl:text>
874	</xsl:template>
875
876
877	<!--
878	Command Synopsis elements.
879
880	We treat each command element inside a cmdsynopsis as the start of
881	a new paragraph. The DocBook HTML converter does so too, but the
882	manpage one doesn't.
883
884	sbr and linebreaks made by latex should be indented from the base
885	command level. This is done by the \hangindent3em\hangafter1 bits.
886
887	We exploit the default paragraph indentation to get each command
888	indented from the left margin. This, unfortunately, doesn't work
889	if we're the first paragraph in a (sub*)section. \noindent cannot
890	counter this due to when latex enforces first paragraph stuff. Since
891	it's tedious to figure out when we're in the first paragraph and when
892	not, we just do \noindent\hspace{1em} everywhere.
893	-->
894	<xsl:template match="sbr">
895	<xsl:if test="not(ancestor::cmdsynopsis)">
896	<xsl:message terminate="yes">sbr only supported inside cmdsynopsis (because of hangindent)</xsl:message>
897	</xsl:if>
898	<xsl:text>\newline</xsl:text>
899	</xsl:template>
900
901	<xsl:template match="refentry\|refnamediv\|refentryinfo\|refmeta\|refsect3\|refsect4\|refsect5\|synopfragment\|synopfragmentref\|cmdsynopsis/info">
902	<xsl:message terminate="yes"><xsl:value-of select="name()"/> is not supported</xsl:message>
903	</xsl:template>
904
905	<xsl:template match="cmdsynopsis">
906	<xsl:if test="preceding-sibling::cmdsynopsis">
907	<xsl:text>%cmdsynopsis</xsl:text>
908	</xsl:if>
909	<xsl:text> </xsl:text>
910	<xsl:text>\begin{flushleft}</xsl:text>
911	<xsl:if test="parent::remark[@role='VBoxManage-overview']">
912	<!-- Overview fontsize trick -->
913	<xsl:text>{\footnotesize</xsl:text>
914	</xsl:if>
915	<xsl:text>\noindent\hspace{1em}</xsl:text>
916	<xsl:text>\hangindent3em\hangafter1\texttt{</xsl:text>
917	<xsl:apply-templates />
918	<xsl:text>}</xsl:text>
919	<xsl:if test="following-sibling::*">
920	</xsl:if>
921
922	<!-- For refsect2 subcommand descriptions. -->
923	<xsl:if test="not(following-sibling::cmdsynopsis) and position() != last()">
924	<xsl:text>\linebreak</xsl:text>
925	</xsl:if>
926	<!-- Special overview trick for the current VBoxManage command overview. -->
927	<xsl:if test="parent::remark[@role='VBoxManage-overview']">
928	<xsl:text>\par}</xsl:text>
929	</xsl:if>
930	<xsl:text>\end{flushleft}</xsl:text>
931	</xsl:template>
932
933	<xsl:template match="command">
934	<xsl:choose>
935	<xsl:when test="ancestor::cmdsynopsis">
936	<!-- Trigger a line break if this isn't the first command in a synopsis -->
937	<xsl:if test="preceding-sibling::command">
938	<xsl:text>}\par%command </xsl:text>
939	<xsl:text>\noindent\hspace{1em}</xsl:text>
940	<xsl:text>\hangindent3em\hangafter1\texttt{</xsl:text>
941	</xsl:if>
942	<xsl:apply-templates />
943	</xsl:when>
944	<xsl:otherwise>
945	<xsl:text>\texttt{</xsl:text>
946	<xsl:apply-templates />
947	<xsl:text>}</xsl:text>
948	</xsl:otherwise>
949	</xsl:choose>
950	</xsl:template>
951
952	<xsl:template match="option">
953	<xsl:choose>
954	<xsl:when test="ancestor::cmdsynopsis">
955	<xsl:apply-templates />
956	</xsl:when>
957	<xsl:otherwise>
958	<xsl:text>\texttt{</xsl:text>
959	<xsl:apply-templates />
960	<xsl:text>}</xsl:text>
961	</xsl:otherwise>
962	</xsl:choose>
963	</xsl:template>
964
965	<!-- duplicated in docbook-refentry-to-C-help.xsl -->
966	<xsl:template match="arg\|group">
967	<!-- separator char if we're not the first child -->
968	<xsl:if test="position() > 1">
969	<xsl:choose>
970	<xsl:when test="parent::group"><xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.or.sep.tex"/><xsl:text>}</xsl:text></xsl:when>
971	<xsl:when test="ancestor-or-self::/@sepchar"><xsl:value-of select="ancestor-or-self::/@sepchar"/></xsl:when>
972	<xsl:otherwise><xsl:text> </xsl:text></xsl:otherwise>
973	</xsl:choose>
974	</xsl:if>
975
976	<!-- open wrapping -->
977	<xsl:choose>
978	<xsl:when test="not(@choice) or @choice = ''"> <xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.choice.def.open.str"/><xsl:text>}</xsl:text></xsl:when>
979	<xsl:when test="@choice = 'opt'"> <xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.choice.opt.open.str"/><xsl:text>}</xsl:text></xsl:when>
980	<xsl:when test="@choice = 'req'"> <xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.choice.req.open.str"/><xsl:text>}</xsl:text></xsl:when>
981	<xsl:when test="@choice = 'plain'"/>
982	<xsl:otherwise><xsl:message terminate="yes"><xsl:call-template name="error-prefix"/>Invalid arg choice: "<xsl:value-of select="@choice"/>"</xsl:message></xsl:otherwise>
983	</xsl:choose>
984
985	<xsl:apply-templates />
986
987	<!-- repeat indication -->
988	<xsl:choose>
989	<xsl:when test="@rep = 'norepeat' or not(@rep) or @rep = ''"/>
990	<xsl:when test="@rep = 'repeat'">
991	<!-- add space padding if we're in a repeating group -->
992	<xsl:if test="self::group">
993	<xsl:text> </xsl:text>
994	</xsl:if>
995	<xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.rep.repeat.str.tex"/><xsl:text>}</xsl:text>
996	</xsl:when>
997	<xsl:otherwise><xsl:message terminate="yes"><xsl:call-template name="error-prefix"/>Invalid rep choice: "<xsl:value-of select="@rep"/>"</xsl:message></xsl:otherwise>
998	</xsl:choose>
999
1000	<!-- close wrapping -->
1001	<xsl:choose>
1002	<xsl:when test="not(@choice) or @choice = ''"> <xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.choice.def.close.str"/><xsl:text>}</xsl:text></xsl:when>
1003	<xsl:when test="@choice = 'opt'"> <xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.choice.opt.close.str"/><xsl:text>}</xsl:text></xsl:when>
1004	<xsl:when test="@choice = 'req'"> <xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.choice.req.close.str"/><xsl:text>}</xsl:text></xsl:when>
1005	</xsl:choose>
1006
1007	<!-- add space padding if we're the last element in a nested arg -->
1008	<xsl:if test="parent::arg and not(following-sibling)">
1009	<xsl:text> </xsl:text>
1010	</xsl:if>
1011	</xsl:template>
1012
1013	<xsl:template match="replaceable">
1014	<xsl:choose>
1015	<xsl:when test="(not(ancestor::cmdsynopsis) and not(ancestor::option) and not(ancestor::screen)) or ancestor::arg">
1016	<xsl:text>\texttt{\textit{</xsl:text>
1017	<xsl:apply-templates />
1018	<xsl:text>}}</xsl:text>
1019	</xsl:when>
1020	<xsl:otherwise>
1021	<xsl:text>\textit{<</xsl:text>
1022	<xsl:apply-templates />
1023	<xsl:text>>}</xsl:text>
1024	</xsl:otherwise>
1025	</xsl:choose>
1026	</xsl:template>
1027
1028
1029	<!--
1030	Generic element text magic.
1031	-->
1032	<xsl:template match="//text()">
1033
1034	<!-- Do the translation of \ into \textbackslash{} in two steps, to avoid
1035	running into replacing {} as well which would be very wrong. -->
1036	<xsl:variable name="subst1">
1037	<xsl:call-template name="str:subst">
1038	<xsl:with-param name="text" select="." />
1039	<xsl:with-param name="replace" select="'\'" />
1040	<xsl:with-param name="with" select="'\textbackslash'" />
1041	<xsl:with-param name="disable-output-escaping" select="no" />
1042	</xsl:call-template>
1043	</xsl:variable>
1044	<xsl:variable name="subst2">
1045	<xsl:call-template name="str:subst">
1046	<xsl:with-param name="text" select="$subst1" />
1047	<xsl:with-param name="replace" select="'{'" />
1048	<xsl:with-param name="with" select="'\{'" />
1049	<xsl:with-param name="disable-output-escaping" select="no" />
1050	</xsl:call-template>
1051	</xsl:variable>
1052	<xsl:variable name="subst3">
1053	<xsl:call-template name="str:subst">
1054	<xsl:with-param name="text" select="$subst2" />
1055	<xsl:with-param name="replace" select="'}'" />
1056	<xsl:with-param name="with" select="'\}'" />
1057	<xsl:with-param name="disable-output-escaping" select="no" />
1058	</xsl:call-template>
1059	</xsl:variable>
1060	<xsl:variable name="subst4">
1061	<xsl:call-template name="str:subst">
1062	<xsl:with-param name="text" select="$subst3" />
1063	<xsl:with-param name="replace" select="'\textbackslash'" />
1064	<xsl:with-param name="with" select="'\textbackslash{}'" />
1065	<xsl:with-param name="disable-output-escaping" select="no" />
1066	</xsl:call-template>
1067	</xsl:variable>
1068
1069	<xsl:choose>
1070	<xsl:when test="(name(..) = 'computeroutput') or (name(../..) = 'computeroutput')
1071	or (name(..) = 'code') or (name(../..) = 'code')
1072	or (name(..) = 'arg') or (name(../..) = 'arg')
1073	or (name(..) = 'option') or (name(../..) = 'option')
1074	or (name(..) = 'command') or (name(../..) = 'command')
1075	or (name(..) = 'cmdsynopsis') or (name(../..) = 'cmdsynopsis')
1076	or (name(..) = 'replaceable') or (name(../..) = 'replaceable')
1077	or (name(..) = 'entry') or (name(../..) = 'entry')
1078	">
1079	<xsl:variable name="subst5">
1080	<xsl:call-template name="str:subst">
1081	<xsl:with-param name="text" select="translate(normalize-space(concat('',$subst4,'')),'','')" />
1082	<xsl:with-param name="replace" select="'--'" />
1083	<xsl:with-param name="with" select="'-{}-'" />
1084	<xsl:with-param name="disable-output-escaping" select="no" />
1085	</xsl:call-template>
1086	</xsl:variable>
1087	<xsl:variable name="subst6">
1088	<xsl:call-template name="str:subst">
1089	<xsl:with-param name="text" select="$subst5" />
1090	<xsl:with-param name="replace" select="'_'" />
1091	<xsl:with-param name="with" select="'\_'" />
1092	<xsl:with-param name="disable-output-escaping" select="no" />
1093	</xsl:call-template>
1094	</xsl:variable>
1095	<xsl:variable name="subst7">
1096	<xsl:call-template name="str:subst">
1097	<xsl:with-param name="text" select="$subst6" />
1098	<xsl:with-param name="replace" select="'$'" />
1099	<xsl:with-param name="with" select="'\$'" />
1100	<xsl:with-param name="disable-output-escaping" select="no" />
1101	</xsl:call-template>
1102	</xsl:variable>
1103	<xsl:variable name="subst8">
1104	<xsl:call-template name="str:subst">
1105	<xsl:with-param name="text" select="$subst7" />
1106	<xsl:with-param name="replace" select="'%'" />
1107	<xsl:with-param name="with" select="'\%'" />
1108	<xsl:with-param name="disable-output-escaping" select="no" />
1109	</xsl:call-template>
1110	</xsl:variable>
1111	<xsl:variable name="subst9">
1112	<xsl:call-template name="str:subst">
1113	<xsl:with-param name="text" select="$subst8" />
1114	<xsl:with-param name="replace" select="'#'" />
1115	<xsl:with-param name="with" select="'\#'" />
1116	<xsl:with-param name="disable-output-escaping" select="no" />
1117	</xsl:call-template>
1118	</xsl:variable>
1119	<xsl:variable name="subst10">
1120	<xsl:call-template name="str:subst">
1121	<xsl:with-param name="text" select="$subst9" />
1122	<xsl:with-param name="replace" select="'~'" />
1123	<xsl:with-param name="with" select="'\textasciitilde{}'" />
1124	<xsl:with-param name="disable-output-escaping" select="no" />
1125	</xsl:call-template>
1126	</xsl:variable>
1127	<xsl:variable name="subst11">
1128	<xsl:call-template name="str:subst">
1129	<xsl:with-param name="text" select="$subst10" />
1130	<xsl:with-param name="replace" select="'&'" />
1131	<xsl:with-param name="with" select="'\&'" />
1132	<xsl:with-param name="disable-output-escaping" select="no" />
1133	</xsl:call-template>
1134	</xsl:variable>
1135	<xsl:choose>
1136	<xsl:when test="parent::arg or parent::command">
1137	<xsl:variable name="subst12">
1138	<xsl:call-template name="str:subst">
1139	<xsl:with-param name="text" select="$subst10" />
1140	<xsl:with-param name="replace" select="' '" />
1141	<xsl:with-param name="with" select="'~'" />
1142	<xsl:with-param name="disable-output-escaping" select="no" />
1143	</xsl:call-template>
1144	</xsl:variable>
1145	<xsl:value-of select="$subst12" />
1146	</xsl:when>
1147	<xsl:otherwise>
1148	<xsl:value-of select="$subst11" />
1149	</xsl:otherwise>
1150	</xsl:choose>
1151	</xsl:when>
1152
1153	<xsl:when test="(name(..)='address') or (name(../..)='address')">
1154	<xsl:variable name="subst5">
1155	<xsl:call-template name="str:subst">
1156	<xsl:with-param name="text" select="$subst4" />
1157	<xsl:with-param name="replace" select="' '" />
1158	<xsl:with-param name="with" select="' \\'" />
1159	<xsl:with-param name="disable-output-escaping" select="no" />
1160	</xsl:call-template>
1161	</xsl:variable>
1162	<xsl:value-of select="$subst5" />
1163	</xsl:when>
1164
1165	<!-- <screen> and <programlisting>, which work with alltt environment. -->
1166	<xsl:otherwise>
1167	<xsl:variable name="subst5">
1168	<xsl:call-template name="str:subst">
1169	<xsl:with-param name="text" select="$subst4" />
1170	<xsl:with-param name="replace" select="'_'" />
1171	<xsl:with-param name="with" select="'\_'" />
1172	<xsl:with-param name="disable-output-escaping" select="no" />
1173	</xsl:call-template>
1174	</xsl:variable>
1175	<xsl:variable name="subst6">
1176	<xsl:call-template name="str:subst">
1177	<xsl:with-param name="text" select="$subst5" />
1178	<xsl:with-param name="replace" select="'$'" />
1179	<xsl:with-param name="with" select="'\$'" />
1180	<xsl:with-param name="disable-output-escaping" select="no" />
1181	</xsl:call-template>
1182	</xsl:variable>
1183	<xsl:variable name="subst7">
1184	<xsl:call-template name="str:subst">
1185	<xsl:with-param name="text" select="$subst6" />
1186	<xsl:with-param name="replace" select="'%'" />
1187	<xsl:with-param name="with" select="'\%'" />
1188	<xsl:with-param name="disable-output-escaping" select="no" />
1189	</xsl:call-template>
1190	</xsl:variable>
1191	<xsl:variable name="subst8">
1192	<xsl:call-template name="str:subst">
1193	<xsl:with-param name="text" select="$subst7" />
1194	<xsl:with-param name="replace" select="'#'" />
1195	<xsl:with-param name="with" select="'\#'" />
1196	<xsl:with-param name="disable-output-escaping" select="no" />
1197	</xsl:call-template>
1198	</xsl:variable>
1199	<xsl:variable name="subst9">
1200	<xsl:call-template name="str:subst">
1201	<xsl:with-param name="text" select="$subst8" />
1202	<xsl:with-param name="replace" select="'µ'" />
1203	<xsl:with-param name="with" select="'$\mu$'" />
1204	<xsl:with-param name="disable-output-escaping" select="no" />
1205	</xsl:call-template>
1206	</xsl:variable>
1207	<xsl:variable name="subst10">
1208	<xsl:call-template name="str:subst">
1209	<xsl:with-param name="text" select="$subst9" />
1210	<xsl:with-param name="replace" select="'®'" />
1211	<xsl:with-param name="with" select="'\texorpdfstring{\textregistered}{}'" />
1212	<xsl:with-param name="disable-output-escaping" select="no" />
1213	</xsl:call-template>
1214	</xsl:variable>
1215	<xsl:variable name="quote">"</xsl:variable>
1216	<!-- preparation for pretty quotes: replace all double quotes _outside_ screen
1217	sections with "\QUOTE{}" strings, which the makefile will then replace
1218	with pretty quotes by invoking sed a few times. Unfortunately there are
1219	no regular expressions in XSLT so there's no other way. -->
1220	<xsl:variable name="subst11">
1221	<xsl:choose>
1222	<xsl:when test="(name(..)='screen') or (name(../..)='screen')
1223	or (name(..)='programlisting') or (name(../..)='programlisting')
1224	or (name(..)='literal') or (name(../..)='literal')
1225	">
1226	<xsl:value-of select="$subst10" />
1227	</xsl:when>
1228	<xsl:otherwise>
1229	<xsl:call-template name="str:subst">
1230	<xsl:with-param name="text" select="$subst10" />
1231	<xsl:with-param name="replace" select="$quote" />
1232	<xsl:with-param name="with" select="'\QUOTE{}'" />
1233	<xsl:with-param name="disable-output-escaping" select="no" />
1234	</xsl:call-template>
1235	</xsl:otherwise>
1236	</xsl:choose>
1237	</xsl:variable>
1238	<xsl:variable name="subst12">
1239	<xsl:call-template name="str:subst">
1240	<xsl:with-param name="text" select="$subst11" />
1241	<xsl:with-param name="replace" select="'~'" />
1242	<xsl:with-param name="with" select="'\textasciitilde{}'" />
1243	<xsl:with-param name="disable-output-escaping" select="no" />
1244	</xsl:call-template>
1245	</xsl:variable>
1246	<xsl:variable name="subst13">
1247	<xsl:call-template name="str:subst">
1248	<xsl:with-param name="text" select="$subst12" />
1249	<xsl:with-param name="replace" select="'&'" />
1250	<xsl:with-param name="with" select="'\&'" />
1251	<xsl:with-param name="disable-output-escaping" select="no" />
1252	</xsl:call-template>
1253	</xsl:variable>
1254	<xsl:variable name="subst14">
1255	<xsl:call-template name="str:subst">
1256	<xsl:with-param name="text" select="$subst13" />
1257	<xsl:with-param name="replace" select="'→'" />
1258	<xsl:with-param name="with" select="'\ensuremath{\rightarrow}'" />
1259	<xsl:with-param name="disable-output-escaping" select="no" />
1260	</xsl:call-template>
1261	</xsl:variable>
1262	<xsl:variable name="subst15">
1263	<xsl:call-template name="str:subst">
1264	<xsl:with-param name="text" select="$subst14" />
1265	<xsl:with-param name="replace" select="'←'" />
1266	<xsl:with-param name="with" select="'\ensuremath{\leftarrow}'" />
1267	<xsl:with-param name="disable-output-escaping" select="no" />
1268	</xsl:call-template>
1269	</xsl:variable>
1270	<xsl:variable name="subst16">
1271	<xsl:call-template name="str:subst">
1272	<xsl:with-param name="text" select="$subst15" />
1273	<xsl:with-param name="replace" select="'↔'" />
1274	<xsl:with-param name="with" select="'\ensuremath{\leftrightarrow}'" />
1275	<xsl:with-param name="disable-output-escaping" select="no" />
1276	</xsl:call-template>
1277	</xsl:variable>
1278	<xsl:value-of select="$subst16" />
1279	</xsl:otherwise>
1280	</xsl:choose>
1281	</xsl:template>
1282
1283	<!--
1284	xsltprocNewlineOutputHack - emits a single new line.
1285
1286	Hack Alert! This template helps xsltproc split up the output text elements
1287	and avoid reallocating them into the MB range. Calls to this
1288	template is made occationally while generating larger output
1289	file. It's not necessary for small stuff like header.
1290
1291	The trick we're playing on xsltproc has to do with CDATA
1292	and/or the escape setting of the xsl:text element. It forces
1293	xsltproc to allocate a new output element, thus preventing
1294	things from growing out of proportions and slowing us down.
1295
1296	This was successfully employed to reduce a 18+ seconds run to
1297	around one second (possibly less due to kmk overhead).
1298	-->
1299	<xsl:template name="xsltprocNewlineOutputHack">
1300	<xsl:text disable-output-escaping="yes"><![CDATA[
1301	]]></xsl:text>
1302	</xsl:template>
1303
1304	</xsl:stylesheet>
1305

Note: See TracBrowser for help on using the repository browser.

source: vbox/trunk/doc/manual/docbook2latex.xsl@ 96918

Download in other formats: