Blob Blame History Raw
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
<section id="sec-xref">
<title>Using XRefsyle and Olinks</title>

<para>Since version 0.2.7 you can use the <sgmltag>xrefstyle</sgmltag> attribute
like you would do with the DocBook Project stylesheets for HTML output.</para>

<para>Furthermore, you can also use <sgmltag>olink</sgmltag>s. Note that
Olinking is used in the PDF version of this manual,
in <xref linkend="sec-changelog"/>.</para>

<para>Actually, the common DocBook Project stylesheets version 1.72 are now
used by dblatex to handle all of these features.</para>

<para>These features are fully described in the <ulink url="">DocBook XSL: The Complete Guide</ulink> book by Bob Stayton. In particular, the following sections cover these topics:

<listitem><para><ulink url=""/> explains how to use <sgmltag>xrefstyle</sgmltag>.</para></listitem>

<listitem><para><ulink url=""/> explains how to use <sgmltag>olink</sgmltag>s.</para></listitem>

<section id="sec-ulink-style">
<title>Specific xrefstyle for <sgmltag>ulink</sgmltag></title>

<para>Dblatex defines a template that can be applied through
the xrefstyle attribute to format an <sgmltag>ulink</sgmltag>. The template has
the following general form: 

<para>The principle is that the <literal>show</literal> and
<literal>hide</literal> parts override locally for this ulink the
<parameter></parameter> parameter,
and the <literal>after</literal> and
<literal>infoot</literal> parts override locally the
<parameter>ulink.footnotes</parameter> parameter.</para>

<para>When only one part is defined, only one setup is overriden, and the other setup depends on the corresponding global parameter.</para>

<para>See <xref linkend=""/> to have several examples of use of the ulink xrefstyle template.</para>