Creating a link from your DocBook document to a website is easy. You use the ulink
element, putting the target URL in the ulink's url
attribute. For example:
For more information on DocBook, go to the <ulink url="https://sourceforge.net/projects/docbook/">DocBook SourceForge website</ulink> or to <ulink url="http://docbook.org"/>.
The first ulink
example is not empty, so its text content becomes the hot text in HTML output. The second ulink
is empty, so the stylesheet will automatically copy its URL to use as the hot text.
In HTML output, you can have the target document appear in a separate window if you set the ulink.target
parameter to a different window name. That adds a
target
attribute to the HTML
anchor tag. By default, the parameter's value is _top
, which loads the content into the topmost frame, which is
likely the same window.
For FO output, you can choose whether the url
attribute value for the ulink
is printed. If you just set the parameter ulink.show
to nonzero, then the URL appears in square brackets
after the ulink text. If you also set the parameter ulink.footnotes
to nonzero, then the URL becomes a footnote to the ulink
text. Regardless of the parameter settings, if the URL exactly
matches the ulink
text string (or the ulink element is empty, which produces the same
result), then the stylesheet does not repeat the same URL in brackets
or a footnote.
DocBook XSL: The Complete Guide - 3rd Edition | PDF version available | Copyright © 2002-2005 Sagehill Enterprises |