docbook-refentry-link-replacement-xsl-gen.xsl@ 77809

Last change on this file since 77809 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	<!--
37	Output header and footer.
38	-->
39	<xsl:template match="/">
40	<xsl:text><?xml version="1.0"?>
41	<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" >
42	<xsl:output method="xml" version="1.0" encoding="utf-8" indent="yes" />
43	<xsl:template match="node()\|@*">
44	<xsl:copy>
45	<xsl:apply-templates select="node()\|@*"/>
46	</xsl:copy>
47	</xsl:template>
48
49	</xsl:text>
50	<xsl:apply-templates/>
51	<xsl:text>
52	</xsl:stylesheet>
53	</xsl:text>
54	</xsl:template>
55
56
57	<!--
58	Produce the transformation templates:
59	-->
60	<xsl:template match="chapter[@id]/title">
61	<xsl:text>
62	<xsl:template match="xref[@linkend='</xsl:text>
63	<xsl:value-of select="../@id"/><xsl:text>']">
64	<xsl:text>chapter </xsl:text><xsl:value-of select="count(../preceding-sibling::chapter) + 1"/><xsl:text> "</xsl:text>
65	<xsl:value-of select="normalize-space()"/>
66	<xsl:text>" in the user manual</xsl:text>
67	</xsl:template>
68	</xsl:text>
69	<xsl:apply-templates/>
70	</xsl:template>
71
72	<xsl:template match="sect1[@id]/title">
73	<xsl:text><xsl:template match="xref[@linkend='</xsl:text>
74	<xsl:value-of select="../@id"/><xsl:text>']">
75	<xsl:text>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> "</xsl:text>
79	<xsl:value-of select="normalize-space()"/><xsl:text>" of the user manual</xsl:text>
80	</xsl:template>
81	</xsl:text>
82	<xsl:apply-templates/>
83	</xsl:template>
84
85	<xsl:template match="sect2[@id]/title">
86	<xsl:text><xsl:template match="xref[@linkend='</xsl:text>
87	<xsl:value-of select="../@id"/><xsl:text>']">
88	<xsl:text>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> "</xsl:text>
93	<xsl:value-of select="normalize-space()"/><xsl:text>" of the user manual</xsl:text>
94	</xsl:template>
95	</xsl:text>
96	<xsl:apply-templates/>
97	</xsl:template>
98
99	<xsl:template match="sect3[@id]/title">
100	<xsl:text><xsl:template match="xref[@linkend='</xsl:text>
101	<xsl:value-of select="../@id"/><xsl:text>']">
102	<xsl:text>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> "</xsl:text>
108	<xsl:value-of select="normalize-space()"/><xsl:text>" of the user manual</xsl:text>
109	</xsl:template>
110	</xsl:text>
111	<xsl:apply-templates/>
112	</xsl:template>
113
114	<xsl:template match="preface[@id]/title">
115	<xsl:text><xsl:template match="xref[@linkend='</xsl:text>
116	<xsl:value-of select="../@id"/><xsl:text>']">
117	<xsl:text>"</xsl:text>
118	<xsl:value-of select="normalize-space()"/><xsl:text>" of the user manual</xsl:text>
119	</xsl:template>
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.

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

Download in other formats: