Hi Eric,
Actually, creating an xref to a title used to work in the stylesheets.
Currently it gets the generated text right, but the link is to the id of the
title element, and most title elements do not output an @id attribute, so the
link fails. It seems this feature was broken some time ago when the xref
templates were rewritten to support universal linking in DocBook 5.
This customization of the template named 'simple.xlink' from fo/inline.xsl
fixes the id problem. It only corrects the problem for @linkend references,
not for @xlink:href references used in universal linking, but it should suffice
for your needs. Search for 'linkend.candidate' to see where I made the changes.
<xsl:template name="simple.xlink">
<xsl:param name="node" select="."/>
<xsl:param name="content">
<xsl:apply-templates/>
</xsl:param>
<xsl:param name="linkend.candidate" select="$node/@linkend"/>
<xsl:param name="xhref" select="$node/@xlink:href"/>
<xsl:choose>
<xsl:when test="$xhref
and (not($node/@xlink:type) or
$node/@xlink:type='simple')">
<!-- Is it a local idref? -->
<xsl:variable name="is.idref">
<xsl:choose>
<!-- if the href starts with # and does not contain an "(" -->
<!-- or if the href starts with #xpointer(id(, it's just an ID -->
<xsl:when test="starts-with($xhref,'#')
and (not(contains($xhref,'('))
or starts-with($xhref,
'#xpointer(id('))">1</xsl:when>
<xsl:otherwise>0</xsl:otherwise>
</xsl:choose>
</xsl:variable>
<!-- Is it an olink ? -->
<xsl:variable name="is.olink">
<xsl:choose>
<!-- If xlink:role="http://docbook.org/xlink/role/olink" -->
<!-- and if the href contains # -->
<xsl:when test="contains($xhref,'#') and
@xlink:role = $xolink.role">1</xsl:when>
<xsl:otherwise>0</xsl:otherwise>
</xsl:choose>
</xsl:variable>
<xsl:choose>
<xsl:when test="$is.olink = 1">
<xsl:call-template name="olink">
<xsl:with-param name="content" select="$content"/>
</xsl:call-template>
</xsl:when>
<xsl:when test="$is.idref = 1">
<xsl:variable name="idref">
<xsl:call-template name="xpointer.idref">
<xsl:with-param name="xpointer" select="$xhref"/>
</xsl:call-template>
</xsl:variable>
<xsl:variable name="targets" select="key('id',$idref)"/>
<xsl:variable name="target" select="$targets[1]"/>
<xsl:call-template name="check.id.unique">
<xsl:with-param name="linkend" select="$idref"/>
</xsl:call-template>
<xsl:choose>
<xsl:when test="count($target) = 0">
<xsl:message>
<xsl:text>XLink to nonexistent id: </xsl:text>
<xsl:value-of select="$idref"/>
</xsl:message>
<xsl:copy-of select="$content"/>
</xsl:when>
<xsl:otherwise>
<fo:basic-link internal-destination="{$idref}">
<xsl:apply-templates select="." mode="simple.xlink.properties"/>
<xsl:copy-of select="$content"/>
</fo:basic-link>
</xsl:otherwise>
</xsl:choose>
</xsl:when>
<!-- otherwise it's a URI -->
<xsl:otherwise>
<fo:basic-link external-destination="url({$xhref})">
<xsl:apply-templates select="." mode="simple.xlink.properties"/>
<xsl:copy-of select="$content"/>
</fo:basic-link>
<!-- * Call the template for determining whether the URL for this -->
<!-- * hyperlink is displayed, and how to display it (either inline
or -->
<!-- * as a numbered footnote). -->
<xsl:call-template name="hyperlink.url.display">
<xsl:with-param name="url" select="$xhref"/>
</xsl:call-template>
</xsl:otherwise>
</xsl:choose>
</xsl:when>
<xsl:when test="$linkend.candidate">
<xsl:variable name="targets.candidate"
select="key('id',$linkend.candidate)"/>
<xsl:variable name="target.candidate" select="$targets.candidate[1]"/>
<xsl:variable name="target.id">
<xsl:choose>
<xsl:when test="$target.candidate/self::title and
$target.candidate/parent::*/@id">
<xsl:value-of select="$target.candidate/parent::*/@id"/>
</xsl:when>
<xsl:otherwise>
<xsl:value-of select="$target.candidate/@id"/>
</xsl:otherwise>
</xsl:choose>
</xsl:variable>
<xsl:variable name="targets" select="key('id',$target.id)"/>
<xsl:variable name="target" select="$targets[1]"/>
<xsl:variable name="linkend" select="$target/@id"/>
<xsl:call-template name="check.id.unique">
<xsl:with-param name="linkend" select="$linkend"/>
</xsl:call-template>
<xsl:choose>
<xsl:when test="count($target) = 0">
<xsl:message>
<xsl:text>XLink to nonexistent id: </xsl:text>
<xsl:value-of select="$linkend"/>
</xsl:message>
<xsl:copy-of select="$content"/>
</xsl:when>
<xsl:otherwise>
<fo:basic-link internal-destination="{$linkend}">
<xsl:apply-templates select="." mode="simple.xlink.properties"/>
<xsl:copy-of select="$content"/>
</fo:basic-link>
</xsl:otherwise>
</xsl:choose>
</xsl:when>
<xsl:otherwise>
<xsl:copy-of select="$content"/>
</xsl:otherwise>
</xsl:choose>
</xsl:template>
</xsl:stylesheet>
Bob Stayton
Sagehill Enterprises
b...@sagehill.net
From: Eric Nordlund
Sent: Thursday, April 04, 2013 6:00 PM
To: docbook-apps@lists.oasis-open.org
Subject: [docbook-apps] xrefs to <title> elements don't work
My company has a hundred or so books that were authored with Arbortext's
graphic XML editor. I'm having a problem processing these books with XSL-FO
because so many of the xrefs in these books are to title elements instead of
the parent procedure, section, example, table, etc., elements.
Is there a way to make these work in the XSL-FO output? I was thinking I could
have a template that could recognize when an xref/@linkend pointed to the id of
a title and then change the linkend to the id of the title's parent element,
but I don't really know how to do that.
Is there another way to do what I need to do?
Eric Nordlund
Customer Documentation and Training
Cray Inc.
901 5th Ave
Seattle, WA 98164
(206)701-2232