use.role.as.xrefstyle
— Use role
attribute for
xrefstyle
on xref
?
In DocBook documents that conform to a schema older than V4.3, this parameter allows
role
to serve the purpose of specifying the cross reference style.
If non-zero, the role
attribute on
xref
will be used to select the cross reference style.
In DocBook V4.3, the xrefstyle
attribute was added for this purpose.
If the xrefstyle
attribute is present,
role
will be ignored, regardless of the setting
of this parameter.
The following small stylesheet shows how to configure the stylesheets to make use of the cross reference style:
<?xml version="1.0"?> <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> <xsl:import href="../xsl/html/docbook.xsl"/> <xsl:output method="html"/> <xsl:param name="local.l10n.xml" select="document('')"/> <l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0"> <l:l10n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" language="en"> <l:context name="xref"> <l:template name="chapter" style="title" text="Chapter %n, %t"/> <l:template name="chapter" text="Chapter %n"/> </l:context> </l:l10n> </l:i18n> </xsl:stylesheet>
With this stylesheet, the cross references in the following document:
<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> <book id="book"><title>Book</title> <preface> <title>Preface</title> <para>Normal: <xref linkend="ch1"/>.</para> <para>Title: <xref xrefstyle="title" linkend="ch1"/>.</para> </preface> <chapter id="ch1"> <title>First Chapter</title> <para>Irrelevant.</para> </chapter> </book>
will appear as:
Normal: Chapter 1.
Title: Chapter 1, First Chapter.