Current File : //usr/share/yelp-xsl/xslt/docbook/common/db-chunk.xsl
<?xml version='1.0' encoding='UTF-8'?><!-- -*- indent-tabs-mode: nil -*- -->
<!--
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option) any
later version.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
details.
You should have received a copy of the GNU Lesser General Public License
along with this program; see the file COPYING.LGPL. If not, see <http://www.gnu.org/licenses/>.
-->
<!DOCTYPE xsl:stylesheet [
<!ENTITY % selectors SYSTEM "db-selectors.mod">
%selectors;
]>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:db="http://docbook.org/ns/docbook"
xmlns:set="http://exslt.org/sets"
xmlns:exsl="http://exslt.org/common"
extension-element-prefixes="exsl"
exclude-result-prefixes="db set"
version="1.0">
<!--!!==========================================================================
DocBook Chunking
REMARK: Describe this module
-->
<!--@@==========================================================================
db.chunk.max_depth
The maximum depth for chunking sections.
REMARK: Describe what this does
-->
<xsl:param name="db.chunk.max_depth">
<xsl:choose>
<xsl:when test="number(processing-instruction('db.chunk.max_depth'))">
<xsl:value-of
select="number(processing-instruction('db.chunk.max_depth'))"/>
</xsl:when>
<xsl:when test="/book | /db:book">
<xsl:value-of select="2"/>
</xsl:when>
<xsl:otherwise>
<xsl:value-of select="1"/>
</xsl:otherwise>
</xsl:choose>
</xsl:param>
<!--@@==========================================================================
db.chunk.basename
The base filename of the output file, without an extension.
REMARK: Describe what this does
-->
<xsl:param name="db.chunk.basename">
<xsl:choose>
<xsl:when test="/*/@xml:id">
<xsl:value-of select="/*/@xml:id"/>
</xsl:when>
<xsl:when test="/*/@id">
<xsl:value-of select="/*/@id"/>
</xsl:when>
<xsl:otherwise>
<xsl:text>index</xsl:text>
</xsl:otherwise>
</xsl:choose>
</xsl:param>
<!--@@==========================================================================
db.chunk.extension
The default file extension for new output documents.
REMARK: Describe what this does
-->
<xsl:param name="db.chunk.extension"/>
<!--**==========================================================================
db.chunk.depth-in-chunk
Determines the depth of an element in the containing chunk.
[xsl:params]
$node: The element to determine the depth of
REMARK: Explain how this works
-->
<xsl:template name="db.chunk.depth-in-chunk">
<xsl:param name="node" select="."/>
<xsl:variable name="divs" select="count($node/ancestor-or-self::&db_chunks;)"/>
<xsl:choose>
<xsl:when test="$divs < ($db.chunk.max_depth + 1)">
<xsl:value-of select="count($node/ancestor-or-self::*) - $divs"/>
</xsl:when>
<xsl:otherwise>
<xsl:value-of select="count($node/ancestor::*) - $db.chunk.max_depth"/>
</xsl:otherwise>
</xsl:choose>
</xsl:template>
<!--**==========================================================================
db.chunk.depth-of-chunk
Determines the depth of the containing chunk in the document.
[xsl:params]
$node: The element to determine the depth of
REMARK: Explain how this works
-->
<xsl:template name="db.chunk.depth-of-chunk">
<xsl:param name="node" select="."/>
<xsl:variable name="divs" select="$node/ancestor-or-self::&db_chunks;"/>
<xsl:choose>
<xsl:when test="count($divs) - 1 < $db.chunk.max_depth">
<xsl:value-of select="count($divs) - 1"/>
</xsl:when>
<xsl:otherwise>
<xsl:value-of select="$db.chunk.max_depth"/>
</xsl:otherwise>
</xsl:choose>
</xsl:template>
<!--**==========================================================================
db.chunk.chunk-id
Determines the id of the chunk that contains an element.
[xsl:params]
$id: The id of the element to determine the chunk id of
$node: The element to determine the chunk id of
$depth_in_chunk: The depth of $node in the containing chunk
REMARK: Explain how this works
-->
<xsl:template name="db.chunk.chunk-id">
<xsl:param name="id" select="@id | @xml:id"/>
<xsl:param name="node" select="key('db.id.key', $id)"/>
<xsl:param name="depth_in_chunk">
<xsl:call-template name="db.chunk.depth-in-chunk">
<xsl:with-param name="node" select="$node"/>
</xsl:call-template>
</xsl:param>
<xsl:param name="chunk" select="$node/ancestor-or-self::*[$depth_in_chunk + 1]"/>
<xsl:choose>
<xsl:when test="set:has-same-node($chunk, /*)">
<xsl:value-of select="$db.chunk.basename"/>
</xsl:when>
<xsl:when test="$chunk/@id">
<xsl:value-of select="string($chunk/@id)"/>
</xsl:when>
<xsl:when test="$chunk/@xml:id">
<xsl:value-of select="string($chunk/@xml:id)"/>
</xsl:when>
<xsl:otherwise>
<xsl:value-of select="generate-id($chunk)"/>
</xsl:otherwise>
</xsl:choose>
</xsl:template>
<!--**==========================================================================
db.chunk.chunk-id.axis
Determines the id of the first chunk along a specified axis.
[xsl:params]
$node: The base element
$node: The axis along which to find the first chunk
$depth_in_chunk: The depth of $node in the containing chunk
$depth_of_chunk: The depth of the containing chunk in the document
REMARK: Explain how this works, and what the axes are
-->
<xsl:template name="db.chunk.chunk-id.axis">
<xsl:param name="node" select="."/>
<xsl:param name="axis"/>
<xsl:param name="depth_in_chunk">
<xsl:call-template name="db.chunk.depth-in-chunk">
<xsl:with-param name="node" select="$node"/>
</xsl:call-template>
</xsl:param>
<xsl:param name="depth_of_chunk">
<xsl:call-template name="db.chunk.depth-of-chunk">
<xsl:with-param name="node" select="$node"/>
</xsl:call-template>
</xsl:param>
<xsl:choose>
<xsl:when test="depth_in_chunk != 0">
<xsl:call-template name="db.chunk.chunk-id.axis">
<xsl:with-param name="node" select="$node/ancestor::*[$depth_in_chunk]"/>
<xsl:with-param name="axis" select="$axis"/>
<xsl:with-param name="depth_in_chunk" select="0"/>
<xsl:with-param name="depth_of_chunk" select="$depth_of_chunk"/>
</xsl:call-template>
</xsl:when>
<!-- following -->
<xsl:when test="$axis = 'following'">
<xsl:variable name="divs"
select="$node/following-sibling::&db_chunks;"/>
<xsl:choose>
<xsl:when test="$divs">
<xsl:call-template name="db.chunk.chunk-id">
<xsl:with-param name="node" select="$divs[1]"/>
<xsl:with-param name="depth_in_chunk" select="0"/>
<xsl:with-param name="chunk" select="$divs[1]"/>
</xsl:call-template>
</xsl:when>
<xsl:when test="$node/..">
<xsl:call-template name="db.chunk.chunk-id.axis">
<xsl:with-param name="node" select="$node/.."/>
<xsl:with-param name="axis" select="'following'"/>
<xsl:with-param name="depth_in_chunk" select="0"/>
<xsl:with-param name="depth_of_chunk" select="$depth_of_chunk - 1"/>
</xsl:call-template>
</xsl:when>
</xsl:choose>
</xsl:when>
<!-- last-descendant -->
<xsl:when test="$axis = 'last-descendant'">
<xsl:variable name="divs" select="$node/&db_chunks;"/>
<xsl:choose>
<xsl:when test="($depth_of_chunk >= $db.chunk.max_depth)">
<xsl:call-template name="db.chunk.chunk-id">
<xsl:with-param name="node" select="$node"/>
<xsl:with-param name="depth_in_chunk" select="0"/>
<xsl:with-param name="chunk" select="$node"/>
</xsl:call-template>
</xsl:when>
<xsl:when test="($depth_of_chunk + 1 = $db.chunk.max_depth) and $divs">
<xsl:call-template name="db.chunk.chunk-id">
<xsl:with-param name="node" select="$divs[last()]"/>
<xsl:with-param name="depth_in_chunk" select="0"/>
<xsl:with-param name="chunk" select="$divs[last()]"/>
</xsl:call-template>
</xsl:when>
<xsl:when test="$divs">
<xsl:call-template name="db.chunk.chunk-id.axis">
<xsl:with-param name="node" select="$divs[last()]"/>
<xsl:with-param name="axis" select="'last-descendant'"/>
<xsl:with-param name="depth_in_chunk" select="0"/>
<xsl:with-param name="depth_of_chunk" select="$depth_of_chunk + 1"/>
</xsl:call-template>
</xsl:when>
<xsl:otherwise>
<xsl:call-template name="db.chunk.chunk-id">
<xsl:with-param name="node" select="$node"/>
<xsl:with-param name="depth_in_chunk" select="0"/>
<xsl:with-param name="chunk" select="$node"/>
</xsl:call-template>
</xsl:otherwise>
</xsl:choose>
</xsl:when>
<!-- next -->
<xsl:when test="$axis = 'next'">
<xsl:variable name="divs" select="$node/&db_chunks;"/>
<xsl:choose>
<xsl:when test="($depth_of_chunk < $db.chunk.max_depth) and $divs">
<xsl:call-template name="db.chunk.chunk-id">
<xsl:with-param name="node" select="$divs[1]"/>
<xsl:with-param name="depth_in_chunk" select="0"/>
<xsl:with-param name="chunk" select="$divs[1]"/>
</xsl:call-template>
</xsl:when>
<xsl:otherwise>
<xsl:call-template name="db.chunk.chunk-id.axis">
<xsl:with-param name="node" select="$node"/>
<xsl:with-param name="axis" select="'following'"/>
<xsl:with-param name="depth_in_chunk" select="$depth_in_chunk"/>
<xsl:with-param name="depth_of_chunk" select="$depth_of_chunk"/>
</xsl:call-template>
</xsl:otherwise>
</xsl:choose>
</xsl:when>
<!-- previous -->
<xsl:when test="$axis = 'previous'">
<xsl:variable name="divs" select="$node/preceding-sibling::&db_chunks;"/>
<xsl:choose>
<xsl:when test="$divs and ($depth_of_chunk < $db.chunk.max_depth)">
<xsl:call-template name="db.chunk.chunk-id.axis">
<xsl:with-param name="node" select="$divs[last()]"/>
<xsl:with-param name="axis" select="'last-descendant'"/>
<xsl:with-param name="depth_in_chunk" select="$depth_in_chunk"/>
<xsl:with-param name="depth_of_chunk" select="$depth_of_chunk"/>
</xsl:call-template>
</xsl:when>
<xsl:when test="$divs">
<xsl:call-template name="db.chunk.chunk-id">
<xsl:with-param name="node" select="$divs[last()]"/>
<xsl:with-param name="depth_in_chunk" select="0"/>
<xsl:with-param name="chunk" select="$divs[last()]"/>
</xsl:call-template>
</xsl:when>
<xsl:when test="$node/..">
<xsl:call-template name="db.chunk.chunk-id">
<xsl:with-param name="node" select="$node/.."/>
<xsl:with-param name="depth_in_chunk" select="0"/>
<xsl:with-param name="chunk" select="$node/.."/>
</xsl:call-template>
</xsl:when>
</xsl:choose>
</xsl:when>
<!-- unsupported -->
<xsl:otherwise>
<xsl:message>
<xsl:text>Unsupported axis: </xsl:text>
<xsl:value-of select="$axis"/>
</xsl:message>
</xsl:otherwise>
</xsl:choose>
</xsl:template>
</xsl:stylesheet>
Mini Shell