VirtualBox

source: vbox/trunk/doc/manual/docbook-refentry-link-replacement-xsl-gen.xsl@ 78377

Last change on this file since 78377 was 77354, checked in by vboxsync, 6 years ago

doc/manual: Replace xref in man and --help output with chapter/section numbers+names to avoid having to wrap these in hacky <remark role=help-manual> elements.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 5.3 KB
Line 
1<?xml version="1.0"?>
2<!--
3 docbook-refentry-link-replacement-xsl-gen.xsl.xsl:
4 XSLT stylesheet for generate a stylesheet that replaces links
5 to the user manual in the manpages.
6
7 Copyright (C) 2006-2019 Oracle Corporation
8
9 This file is part of VirtualBox Open Source Edition (OSE), as
10 available from http://www.virtualbox.org. This file is free software;
11 you can redistribute it and/or modify it under the terms of the GNU
12 General Public License (GPL) as published by the Free Software
13 Foundation, in version 2 as it comes in the "COPYING" file of the
14 VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15 hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16-->
17
18<xsl:stylesheet
19 version="1.0"
20 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
21 >
22
23 <xsl:output method="text" version="1.0" encoding="utf-8" indent="yes"/>
24 <xsl:strip-space elements="*"/>
25
26
27<!-- Default operation is to supress output -->
28<xsl:template match="node()|@*">
29 <xsl:apply-templates/>
30</xsl:template>
31
32
33<!-- Remove all remarks. -->
34<xsl:template match="remark"/>
35
36<!--
37Output header and footer.
38-->
39<xsl:template match="/">
40 <xsl:text>&lt;?xml version="1.0"?&gt;
41&lt;xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" &gt;
42&lt;xsl:output method="xml" version="1.0" encoding="utf-8" indent="yes" /&gt;
43&lt;xsl:template match="node()|@*"&gt;
44 &lt;xsl:copy&gt;
45 &lt;xsl:apply-templates select="node()|@*"/&gt;
46 &lt;/xsl:copy&gt;
47&lt;/xsl:template&gt;
48
49</xsl:text>
50 <xsl:apply-templates/>
51 <xsl:text>
52&lt;/xsl:stylesheet&gt;
53</xsl:text>
54</xsl:template>
55
56
57<!--
58Produce the transformation templates:
59-->
60<xsl:template match="chapter[@id]/title">
61 <xsl:text>
62&lt;xsl:template match="xref[@linkend='</xsl:text>
63 <xsl:value-of select="../@id"/><xsl:text>']"&gt;
64 &lt;xsl:text&gt;chapter </xsl:text><xsl:value-of select="count(../preceding-sibling::chapter) + 1"/><xsl:text> &quot;</xsl:text>
65 <xsl:value-of select="normalize-space()"/>
66 <xsl:text>&quot; in the user manual&lt;/xsl:text&gt;
67&lt;/xsl:template&gt;
68</xsl:text>
69 <xsl:apply-templates/>
70</xsl:template>
71
72<xsl:template match="sect1[@id]/title">
73 <xsl:text>&lt;xsl:template match="xref[@linkend='</xsl:text>
74 <xsl:value-of select="../@id"/><xsl:text>']"&gt;
75 &lt;xsl:text&gt;section </xsl:text>
76 <xsl:value-of select="count(../../preceding-sibling::chapter) + 1"/><xsl:text>.</xsl:text>
77 <xsl:value-of select="count(../preceding-sibling::sect1) + 1"/>
78 <xsl:text> &quot;</xsl:text>
79 <xsl:value-of select="normalize-space()"/><xsl:text>&quot; of the user manual&lt;/xsl:text&gt;
80&lt;/xsl:template&gt;
81</xsl:text>
82 <xsl:apply-templates/>
83</xsl:template>
84
85<xsl:template match="sect2[@id]/title">
86 <xsl:text>&lt;xsl:template match="xref[@linkend='</xsl:text>
87 <xsl:value-of select="../@id"/><xsl:text>']"&gt;
88 &lt;xsl:text&gt;section </xsl:text>
89 <xsl:value-of select="count(../../../preceding-sibling::chapter) + 1"/><xsl:text>.</xsl:text>
90 <xsl:value-of select="count(../../preceding-sibling::sect1) + 1"/><xsl:text>.</xsl:text>
91 <xsl:value-of select="count(../preceding-sibling::sect2) + 1"/>
92 <xsl:text> &quot;</xsl:text>
93 <xsl:value-of select="normalize-space()"/><xsl:text>&quot; of the user manual&lt;/xsl:text&gt;
94&lt;/xsl:template&gt;
95</xsl:text>
96 <xsl:apply-templates/>
97</xsl:template>
98
99<xsl:template match="sect3[@id]/title">
100 <xsl:text>&lt;xsl:template match="xref[@linkend='</xsl:text>
101 <xsl:value-of select="../@id"/><xsl:text>']"&gt;
102 &lt;xsl:text&gt;section </xsl:text>
103 <xsl:value-of select="count(../../../../preceding-sibling::chapter) + 1"/><xsl:text>.</xsl:text>
104 <xsl:value-of select="count(../../../preceding-sibling::sect1) + 1"/><xsl:text>.</xsl:text>
105 <xsl:value-of select="count(../../preceding-sibling::sect2) + 1"/><xsl:text>.</xsl:text>
106 <xsl:value-of select="count(../preceding-sibling::sect3) + 1"/>
107 <xsl:text> &quot;</xsl:text>
108 <xsl:value-of select="normalize-space()"/><xsl:text>&quot; of the user manual&lt;/xsl:text&gt;
109&lt;/xsl:template&gt;
110</xsl:text>
111 <xsl:apply-templates/>
112</xsl:template>
113
114<xsl:template match="preface[@id]/title">
115 <xsl:text>&lt;xsl:template match="xref[@linkend='</xsl:text>
116 <xsl:value-of select="../@id"/><xsl:text>']"&gt;
117 &lt;xsl:text&gt;&quot;</xsl:text>
118 <xsl:value-of select="normalize-space()"/><xsl:text>&quot; of the user manual&lt;/xsl:text&gt;
119&lt;/xsl:template&gt;
120</xsl:text>
121 <xsl:apply-templates/>
122</xsl:template>
123
124<!--
125 Debug/Diagnostics: Return the path to the specified node (by default the current).
126 -->
127<xsl:template name="get-node-path">
128 <xsl:param name="Node" select="."/>
129 <xsl:for-each select="$Node">
130 <xsl:for-each select="ancestor-or-self::node()">
131 <xsl:choose>
132 <xsl:when test="name(.) = ''">
133 <xsl:text>text()</xsl:text>
134 </xsl:when>
135 <xsl:otherwise>
136 <xsl:value-of select="concat('/', name(.))"/>
137 <xsl:choose>
138 <xsl:when test="@id">
139 <xsl:text>[@id=</xsl:text>
140 <xsl:value-of select="@id"/>
141 <xsl:text>]</xsl:text>
142 </xsl:when>
143 <xsl:when test="position() > 1">
144 <xsl:text>[</xsl:text><xsl:value-of select="position()"/><xsl:text>]</xsl:text>
145 </xsl:when>
146 </xsl:choose>
147 </xsl:otherwise>
148 </xsl:choose>
149 </xsl:for-each>
150 </xsl:for-each>
151</xsl:template>
152
153</xsl:stylesheet>
154
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette