+++ /dev/null
-<refentry xmlns="http://docbook.org/ns/docbook"\r
- xmlns:xlink="http://www.w3.org/1999/xlink"\r
- xmlns:xi="http://www.w3.org/2001/XInclude"\r
- xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"\r
- xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
- version="5.0" xml:id="use.role.as.xrefstyle">\r
-<refmeta>\r
-<refentrytitle>use.role.as.xrefstyle</refentrytitle>\r
-<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
-</refmeta>\r
-<refnamediv>\r
-<refname>use.role.as.xrefstyle</refname>\r
-<refpurpose>Use <tag class="attribute">role</tag> attribute for\r
-<tag class="attribute">xrefstyle</tag> on <tag>xref</tag>?</refpurpose>\r
-</refnamediv>\r
-\r
-<refsynopsisdiv>\r
-<src:fragment xml:id="use.role.as.xrefstyle.frag">\r
-<xsl:param name="use.role.as.xrefstyle" select="1"/>\r
-</src:fragment>\r
-</refsynopsisdiv>\r
-\r
-<refsection><info><title>Description</title></info>\r
-\r
-<para>In DocBook documents that conform to a schema older than V4.3, this parameter allows \r
-<tag class="attribute">role</tag> to serve the purpose of specifying the cross reference style.</para>\r
-\r
-<para>If non-zero, the <tag class="attribute">role</tag> attribute on\r
-<tag>xref</tag> will be used to select the cross reference style.\r
-In DocBook V4.3, the <tag class="attribute">xrefstyle</tag> attribute was added for this purpose.\r
-If the <tag class="attribute">xrefstyle</tag> attribute is present, \r
-<tag class="attribute">role</tag> will be ignored, regardless of the setting\r
-of this parameter.</para>\r
-\r
-</refsection>\r
-\r
-<refsection><info><title>Example</title></info>\r
-\r
-<para>The following small stylesheet shows how to configure the\r
-stylesheets to make use of the cross reference style:</para>\r
-\r
-<programlisting><?xml version="1.0"?>\r
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
- version="1.0">\r
-\r
-<xsl:import href="../xsl/html/docbook.xsl"/>\r
-\r
-<xsl:output method="html"/>\r
-\r
-<xsl:param name="local.l10n.xml" select="document('')"/>\r
-<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0">\r
- <l:l10n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" language="en">\r
- <l:context name="xref">\r
- <l:template name="chapter" style="title" text="Chapter %n, %t"/>\r
- <l:template name="chapter" text="Chapter %n"/>\r
- </l:context>\r
- </l:l10n>\r
-</l:i18n>\r
-\r
-</xsl:stylesheet></programlisting>\r
-\r
-<para>With this stylesheet, the cross references in the following document:</para>\r
-\r
-<programlisting><?xml version="1.0" encoding="utf-8"?>\r
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"\r
- "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">\r
-<book id="book"><title>Book</title>\r
-\r
-<preface>\r
-<title>Preface</title>\r
-\r
-<para>Normal: <xref linkend="ch1"/>.</para>\r
-<para>Title: <xref xrefstyle="title" linkend="ch1"/>.</para>\r
-\r
-</preface>\r
-\r
-<chapter id="ch1">\r
-<title>First Chapter</title>\r
-\r
-<para>Irrelevant.</para>\r
-\r
-</chapter>\r
-</book></programlisting>\r
-\r
-<para>will appear as:</para>\r
-\r
-<informalexample>\r
-<para>Normal: Chapter 1.</para>\r
-<para>Title: Chapter 1, <emphasis>First Chapter</emphasis>.</para>\r
-</informalexample>\r
-</refsection>\r
-\r
-</refentry>\r