1 | <?xml version="1.0"?>
|
---|
2 | <!--
|
---|
3 | docbook-refentry-link-replacement-xsl-gen.xsl:
|
---|
4 | XSLT stylesheet for generate a stylesheet that replaces links
|
---|
5 | to the user manual in the manpages.
|
---|
6 | -->
|
---|
7 | <!--
|
---|
8 | Copyright (C) 2006-2023 Oracle and/or its affiliates.
|
---|
9 |
|
---|
10 | This file is part of VirtualBox base platform packages, as
|
---|
11 | available from https://www.virtualbox.org.
|
---|
12 |
|
---|
13 | This program is free software; you can redistribute it and/or
|
---|
14 | modify it under the terms of the GNU General Public License
|
---|
15 | as published by the Free Software Foundation, in version 3 of the
|
---|
16 | License.
|
---|
17 |
|
---|
18 | This program is distributed in the hope that it will be useful, but
|
---|
19 | WITHOUT ANY WARRANTY; without even the implied warranty of
|
---|
20 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
---|
21 | General Public License for more details.
|
---|
22 |
|
---|
23 | You should have received a copy of the GNU General Public License
|
---|
24 | along with this program; if not, see <https://www.gnu.org/licenses>.
|
---|
25 |
|
---|
26 | SPDX-License-Identifier: GPL-3.0-only
|
---|
27 | -->
|
---|
28 |
|
---|
29 | <xsl:stylesheet
|
---|
30 | version="1.0"
|
---|
31 | xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
---|
32 | >
|
---|
33 |
|
---|
34 | <xsl:output method="text" version="1.0" encoding="utf-8" indent="yes"/>
|
---|
35 | <xsl:strip-space elements="*"/>
|
---|
36 |
|
---|
37 | <xsl:param name="g_sMode" select="not-specified"/>
|
---|
38 |
|
---|
39 | <!-- Translatable strings -->
|
---|
40 | <xsl:variable name="sChapter" select="'chapter'"/>
|
---|
41 | <xsl:variable name="sSection" select="'section'"/>
|
---|
42 | <xsl:variable name="sOfManual" select="'of the User Guide'"/>
|
---|
43 | <xsl:variable name="sInManual" select="'in the User Guide'"/>
|
---|
44 |
|
---|
45 |
|
---|
46 | <!-- Default operation is to supress output -->
|
---|
47 | <xsl:template match="node()|@*">
|
---|
48 | <xsl:apply-templates/>
|
---|
49 | </xsl:template>
|
---|
50 |
|
---|
51 |
|
---|
52 | <!-- Remove all remarks. -->
|
---|
53 | <xsl:template match="remark"/>
|
---|
54 |
|
---|
55 | <!--
|
---|
56 | Output header and footer.
|
---|
57 | -->
|
---|
58 | <xsl:template match="/">
|
---|
59 | <xsl:if test="$g_sMode = 'first'">
|
---|
60 | <xsl:text><?xml version="1.0"?>
|
---|
61 | <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" >
|
---|
62 | <xsl:output method="xml" version="1.0" encoding="utf-8" indent="yes" />
|
---|
63 | <xsl:template match="node()|@*">
|
---|
64 | <xsl:copy>
|
---|
65 | <xsl:apply-templates select="node()|@*"/>
|
---|
66 | </xsl:copy>
|
---|
67 | </xsl:template>
|
---|
68 |
|
---|
69 | </xsl:text>
|
---|
70 | </xsl:if>
|
---|
71 | <xsl:apply-templates/>
|
---|
72 | <xsl:if test="$g_sMode = 'last'">
|
---|
73 | <xsl:text>
|
---|
74 | </xsl:stylesheet>
|
---|
75 | </xsl:text>
|
---|
76 | </xsl:if>
|
---|
77 | </xsl:template>
|
---|
78 |
|
---|
79 |
|
---|
80 | <!--
|
---|
81 | Produce the transformation templates:
|
---|
82 | -->
|
---|
83 | <xsl:template match="chapter[@id]/title">
|
---|
84 | <xsl:text>
|
---|
85 | <xsl:template match="xref[@linkend='</xsl:text>
|
---|
86 | <xsl:value-of select="../@id"/><xsl:text>']">
|
---|
87 | <xsl:text></xsl:text><xsl:value-of select="$sChapter"/><xsl:text> </xsl:text>
|
---|
88 | <xsl:value-of select="count(../preceding-sibling::chapter) + 1"/><xsl:text> "</xsl:text>
|
---|
89 | <xsl:value-of select="normalize-space()"/>
|
---|
90 | <xsl:text>" </xsl:text><xsl:value-of select="$sInManual"/><xsl:text></xsl:text>
|
---|
91 | </xsl:template>
|
---|
92 | </xsl:text>
|
---|
93 | <xsl:apply-templates/>
|
---|
94 | </xsl:template>
|
---|
95 |
|
---|
96 | <xsl:template match="sect1[@id]/title">
|
---|
97 | <xsl:text><xsl:template match="xref[@linkend='</xsl:text>
|
---|
98 | <xsl:value-of select="../@id"/><xsl:text>']">
|
---|
99 | <xsl:text></xsl:text><xsl:value-of select="$sSection"/><xsl:text> </xsl:text>
|
---|
100 | <xsl:value-of select="count(../../preceding-sibling::chapter) + 1"/><xsl:text>.</xsl:text>
|
---|
101 | <xsl:value-of select="count(../preceding-sibling::sect1) + 1"/>
|
---|
102 | <xsl:text> "</xsl:text>
|
---|
103 | <xsl:value-of select="normalize-space()"/><xsl:text>" </xsl:text>
|
---|
104 | <xsl:value-of select="$sOfManual"/><xsl:text></xsl:text>
|
---|
105 | </xsl:template>
|
---|
106 | </xsl:text>
|
---|
107 | <xsl:apply-templates/>
|
---|
108 | </xsl:template>
|
---|
109 |
|
---|
110 | <xsl:template match="sect2[@id]/title">
|
---|
111 | <xsl:text><xsl:template match="xref[@linkend='</xsl:text>
|
---|
112 | <xsl:value-of select="../@id"/><xsl:text>']">
|
---|
113 | <xsl:text></xsl:text><xsl:value-of select="$sSection"/><xsl:text> </xsl:text>
|
---|
114 | <xsl:value-of select="count(../../../preceding-sibling::chapter) + 1"/><xsl:text>.</xsl:text>
|
---|
115 | <xsl:value-of select="count(../../preceding-sibling::sect1) + 1"/><xsl:text>.</xsl:text>
|
---|
116 | <xsl:value-of select="count(../preceding-sibling::sect2) + 1"/>
|
---|
117 | <xsl:text> "</xsl:text>
|
---|
118 | <xsl:value-of select="normalize-space()"/><xsl:text>" </xsl:text>
|
---|
119 | <xsl:value-of select="$sOfManual"/><xsl:text></xsl:text>
|
---|
120 | </xsl:template>
|
---|
121 | </xsl:text>
|
---|
122 | <xsl:apply-templates/>
|
---|
123 | </xsl:template>
|
---|
124 |
|
---|
125 | <xsl:template match="sect3[@id]/title">
|
---|
126 | <xsl:text><xsl:template match="xref[@linkend='</xsl:text>
|
---|
127 | <xsl:value-of select="../@id"/><xsl:text>']">
|
---|
128 | <xsl:text></xsl:text><xsl:value-of select="$sSection"/><xsl:text> </xsl:text>
|
---|
129 | <xsl:value-of select="count(../../../../preceding-sibling::chapter) + 1"/><xsl:text>.</xsl:text>
|
---|
130 | <xsl:value-of select="count(../../../preceding-sibling::sect1) + 1"/><xsl:text>.</xsl:text>
|
---|
131 | <xsl:value-of select="count(../../preceding-sibling::sect2) + 1"/><xsl:text>.</xsl:text>
|
---|
132 | <xsl:value-of select="count(../preceding-sibling::sect3) + 1"/>
|
---|
133 | <xsl:text> "</xsl:text>
|
---|
134 | <xsl:value-of select="normalize-space()"/><xsl:text>" </xsl:text>
|
---|
135 | <xsl:value-of select="$sOfManual"/><xsl:text></xsl:text>
|
---|
136 | </xsl:template>
|
---|
137 | </xsl:text>
|
---|
138 | <xsl:apply-templates/>
|
---|
139 | </xsl:template>
|
---|
140 |
|
---|
141 | <xsl:template match="preface[@id]/title">
|
---|
142 | <xsl:text><xsl:template match="xref[@linkend='</xsl:text>
|
---|
143 | <xsl:value-of select="../@id"/><xsl:text>']">
|
---|
144 | <xsl:text>"</xsl:text>
|
---|
145 | <xsl:value-of select="normalize-space()"/><xsl:text>" </xsl:text>
|
---|
146 | <xsl:value-of select="$sOfManual"/><xsl:text></xsl:text>
|
---|
147 | </xsl:template>
|
---|
148 | </xsl:text>
|
---|
149 | <xsl:apply-templates/>
|
---|
150 | </xsl:template>
|
---|
151 |
|
---|
152 | <xsl:template match="refentry[@id]/refentryinfo/title">
|
---|
153 | <xsl:text><xsl:template match="xref[@linkend='</xsl:text>
|
---|
154 | <xsl:value-of select="../../@id"/><xsl:text>']">
|
---|
155 | <xsl:text> "</xsl:text>
|
---|
156 | <xsl:value-of select="normalize-space()"/><xsl:text>"</xsl:text>
|
---|
157 | </xsl:template>
|
---|
158 | </xsl:text>
|
---|
159 | <xsl:apply-templates/>
|
---|
160 | </xsl:template>
|
---|
161 |
|
---|
162 | <xsl:template match="refsect2[@id]/title">
|
---|
163 | <xsl:text><xsl:template match="xref[@linkend='</xsl:text>
|
---|
164 | <xsl:value-of select="../@id"/><xsl:text>']">
|
---|
165 | <xsl:text>"</xsl:text>
|
---|
166 | <xsl:value-of select="normalize-space()"/><xsl:text>"</xsl:text>
|
---|
167 | </xsl:template>
|
---|
168 | </xsl:text>
|
---|
169 | <xsl:apply-templates/>
|
---|
170 | </xsl:template>
|
---|
171 |
|
---|
172 |
|
---|
173 | <!--
|
---|
174 | Debug/Diagnostics: Return the path to the specified node (by default the current).
|
---|
175 | -->
|
---|
176 | <xsl:template name="get-node-path">
|
---|
177 | <xsl:param name="Node" select="."/>
|
---|
178 | <xsl:for-each select="$Node">
|
---|
179 | <xsl:for-each select="ancestor-or-self::node()">
|
---|
180 | <xsl:choose>
|
---|
181 | <xsl:when test="name(.) = ''">
|
---|
182 | <xsl:text>text()</xsl:text>
|
---|
183 | </xsl:when>
|
---|
184 | <xsl:otherwise>
|
---|
185 | <xsl:value-of select="concat('/', name(.))"/>
|
---|
186 | <xsl:choose>
|
---|
187 | <xsl:when test="@id">
|
---|
188 | <xsl:text>[@id=</xsl:text>
|
---|
189 | <xsl:value-of select="@id"/>
|
---|
190 | <xsl:text>]</xsl:text>
|
---|
191 | </xsl:when>
|
---|
192 | <xsl:when test="position() > 1">
|
---|
193 | <xsl:text>[</xsl:text><xsl:value-of select="position()"/><xsl:text>]</xsl:text>
|
---|
194 | </xsl:when>
|
---|
195 | </xsl:choose>
|
---|
196 | </xsl:otherwise>
|
---|
197 | </xsl:choose>
|
---|
198 | </xsl:for-each>
|
---|
199 | </xsl:for-each>
|
---|
200 | </xsl:template>
|
---|
201 |
|
---|
202 | </xsl:stylesheet>
|
---|
203 |
|
---|