Using ulink

[Paul W. Frields]

(Possibly) helpful tip for the day:

FDP standard usage for the DocBook XML tag <ulink> is to always use the
link URL as the text for the link itself.  In other words, instead of
this:

<ulink url="http://some.link.to/somewhere/">A good link</ulink>

...use this:

<ulink
url="http://some.link.to/somewhere/">http://some.link.to/somewhere/</ulink>

But wait!  It gets easier.  DocBook XML specifies that when the XML tag
closes itself (i.e. you don't provide any link text), the link itself is
used as the text for any rendering process.  So what you should probably
do instead, for better XML readability, is this:

<ulink url="http://some.link.to/somewhere/"/>

Isn't that a lot easier?  I think so.  Remember the tag-closing slash
after closing the quotes for the URL, or xmlto will give you a hard time
when you attempt to build your document. :-)

-- 
Paul W. Frields, RHCE                          http://paul.frields.org/
  gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20050817/da13355e/attachment.sig>