olink.docbook-xsl.params.use.role.as.xrefstyle.xml Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of olink-maven-plugin Show documentation

There is a newer version: 1.2.6



use.role.as.xrefstyle
boolean


use.role.as.xrefstyle
Use role attribute for
xrefstyle on xref?








Description

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.



Example

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.