diff options
Diffstat (limited to 'doc/manual/docbook-refentry-link-replacement-xsl-gen.xsl')
| -rw-r--r-- | doc/manual/docbook-refentry-link-replacement-xsl-gen.xsl | 154 |
1 files changed, 154 insertions, 0 deletions
diff --git a/doc/manual/docbook-refentry-link-replacement-xsl-gen.xsl b/doc/manual/docbook-refentry-link-replacement-xsl-gen.xsl new file mode 100644 index 00000000..364f8698 --- /dev/null +++ b/doc/manual/docbook-refentry-link-replacement-xsl-gen.xsl @@ -0,0 +1,154 @@ +<?xml version="1.0"?> +<!-- + docbook-refentry-link-replacement-xsl-gen.xsl.xsl: + XSLT stylesheet for generate a stylesheet that replaces links + to the user manual in the manpages. + + Copyright (C) 2006-2020 Oracle Corporation + + This file is part of VirtualBox Open Source Edition (OSE), as + available from http://www.virtualbox.org. This file is free software; + you can redistribute it and/or modify it under the terms of the GNU + General Public License (GPL) as published by the Free Software + Foundation, in version 2 as it comes in the "COPYING" file of the + VirtualBox OSE distribution. VirtualBox OSE is distributed in the + hope that it will be useful, but WITHOUT ANY WARRANTY of any kind. +--> + +<xsl:stylesheet + version="1.0" + xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + > + + <xsl:output method="text" version="1.0" encoding="utf-8" indent="yes"/> + <xsl:strip-space elements="*"/> + + +<!-- Default operation is to supress output --> +<xsl:template match="node()|@*"> + <xsl:apply-templates/> +</xsl:template> + + +<!-- Remove all remarks. --> +<xsl:template match="remark"/> + +<!-- +Output header and footer. +--> +<xsl:template match="/"> + <xsl:text><?xml version="1.0"?> +<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" > +<xsl:output method="xml" version="1.0" encoding="utf-8" indent="yes" /> +<xsl:template match="node()|@*"> + <xsl:copy> + <xsl:apply-templates select="node()|@*"/> + </xsl:copy> +</xsl:template> + +</xsl:text> + <xsl:apply-templates/> + <xsl:text> +</xsl:stylesheet> +</xsl:text> +</xsl:template> + + +<!-- +Produce the transformation templates: +--> +<xsl:template match="chapter[@id]/title"> + <xsl:text> +<xsl:template match="xref[@linkend='</xsl:text> + <xsl:value-of select="../@id"/><xsl:text>']"> + <xsl:text>chapter </xsl:text><xsl:value-of select="count(../preceding-sibling::chapter) + 1"/><xsl:text> "</xsl:text> + <xsl:value-of select="normalize-space()"/> + <xsl:text>" in the user manual</xsl:text> +</xsl:template> +</xsl:text> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="sect1[@id]/title"> + <xsl:text><xsl:template match="xref[@linkend='</xsl:text> + <xsl:value-of select="../@id"/><xsl:text>']"> + <xsl:text>section </xsl:text> + <xsl:value-of select="count(../../preceding-sibling::chapter) + 1"/><xsl:text>.</xsl:text> + <xsl:value-of select="count(../preceding-sibling::sect1) + 1"/> + <xsl:text> "</xsl:text> + <xsl:value-of select="normalize-space()"/><xsl:text>" of the user manual</xsl:text> +</xsl:template> +</xsl:text> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="sect2[@id]/title"> + <xsl:text><xsl:template match="xref[@linkend='</xsl:text> + <xsl:value-of select="../@id"/><xsl:text>']"> + <xsl:text>section </xsl:text> + <xsl:value-of select="count(../../../preceding-sibling::chapter) + 1"/><xsl:text>.</xsl:text> + <xsl:value-of select="count(../../preceding-sibling::sect1) + 1"/><xsl:text>.</xsl:text> + <xsl:value-of select="count(../preceding-sibling::sect2) + 1"/> + <xsl:text> "</xsl:text> + <xsl:value-of select="normalize-space()"/><xsl:text>" of the user manual</xsl:text> +</xsl:template> +</xsl:text> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="sect3[@id]/title"> + <xsl:text><xsl:template match="xref[@linkend='</xsl:text> + <xsl:value-of select="../@id"/><xsl:text>']"> + <xsl:text>section </xsl:text> + <xsl:value-of select="count(../../../../preceding-sibling::chapter) + 1"/><xsl:text>.</xsl:text> + <xsl:value-of select="count(../../../preceding-sibling::sect1) + 1"/><xsl:text>.</xsl:text> + <xsl:value-of select="count(../../preceding-sibling::sect2) + 1"/><xsl:text>.</xsl:text> + <xsl:value-of select="count(../preceding-sibling::sect3) + 1"/> + <xsl:text> "</xsl:text> + <xsl:value-of select="normalize-space()"/><xsl:text>" of the user manual</xsl:text> +</xsl:template> +</xsl:text> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="preface[@id]/title"> + <xsl:text><xsl:template match="xref[@linkend='</xsl:text> + <xsl:value-of select="../@id"/><xsl:text>']"> + <xsl:text>"</xsl:text> + <xsl:value-of select="normalize-space()"/><xsl:text>" of the user manual</xsl:text> +</xsl:template> +</xsl:text> + <xsl:apply-templates/> +</xsl:template> + +<!-- + Debug/Diagnostics: Return the path to the specified node (by default the current). + --> +<xsl:template name="get-node-path"> + <xsl:param name="Node" select="."/> + <xsl:for-each select="$Node"> + <xsl:for-each select="ancestor-or-self::node()"> + <xsl:choose> + <xsl:when test="name(.) = ''"> + <xsl:text>text()</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="concat('/', name(.))"/> + <xsl:choose> + <xsl:when test="@id"> + <xsl:text>[@id=</xsl:text> + <xsl:value-of select="@id"/> + <xsl:text>]</xsl:text> + </xsl:when> + <xsl:when test="position() > 1"> + <xsl:text>[</xsl:text><xsl:value-of select="position()"/><xsl:text>]</xsl:text> + </xsl:when> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> + </xsl:for-each> + </xsl:for-each> +</xsl:template> + +</xsl:stylesheet> + |