|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
|
|
Packit Service |
76cb02 |
<section id="sec-xref">
|
|
Packit Service |
76cb02 |
<title>Using XRefsyle and Olinks</title>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para>Since version 0.2.7 you can use the <sgmltag>xrefstyle</sgmltag> attribute
|
|
Packit Service |
76cb02 |
like you would do with the DocBook Project stylesheets for HTML output.</para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para>Furthermore, you can also use <sgmltag>olink</sgmltag>s. Note that
|
|
Packit Service |
76cb02 |
Olinking is used in the PDF version of this manual,
|
|
Packit Service |
76cb02 |
in <xref linkend="sec-changelog"/>.</para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para>Actually, the common DocBook Project stylesheets version 1.72 are now
|
|
Packit Service |
76cb02 |
used by dblatex to handle all of these features.</para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para>These features are fully described in the <ulink url="http://www.sagehill.net/docbookxsl/index.html">DocBook XSL: The Complete Guide</ulink> book by Bob Stayton. In particular, the following sections cover these topics:
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<itemizedlist>
|
|
Packit Service |
76cb02 |
<listitem><para><ulink url="http://www.sagehill.net/docbookxsl/CustomXrefs.html"/> explains how to use <sgmltag>xrefstyle</sgmltag>.</para></listitem>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<listitem><para><ulink url="http://www.sagehill.net/docbookxsl/Olinking.html"/> explains how to use <sgmltag>olink</sgmltag>s.</para></listitem>
|
|
Packit Service |
76cb02 |
</itemizedlist>
|
|
Packit Service |
76cb02 |
</para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<section id="sec-ulink-style">
|
|
Packit Service |
76cb02 |
<title>Specific xrefstyle for <sgmltag>ulink</sgmltag></title>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para>Dblatex defines a template that can be applied through
|
|
Packit Service |
76cb02 |
the xrefstyle attribute to format an <sgmltag>ulink</sgmltag>. The template has
|
|
Packit Service |
76cb02 |
the following general form:
|
|
Packit Service |
76cb02 |
<literal>url[.{show|hide}][.{after|infoot}]</literal></para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para>The principle is that the <literal>show</literal> and
|
|
Packit Service |
76cb02 |
<literal>hide</literal> parts override locally for this ulink the
|
|
Packit Service |
76cb02 |
<parameter>ulink.show</parameter> parameter,
|
|
Packit Service |
76cb02 |
and the <literal>after</literal> and
|
|
Packit Service |
76cb02 |
<literal>infoot</literal> parts override locally the
|
|
Packit Service |
76cb02 |
<parameter>ulink.footnotes</parameter> parameter.</para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para>When only one part is defined, only one setup is overriden, and the other setup depends on the corresponding global parameter.</para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para>See <xref linkend="ulink.show"/> to have several examples of use of the ulink xrefstyle template.</para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
</section>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
</section>
|