help with ulink in xml file
Matthew East
mdke at ubuntu.com
Tue Dec 4 13:39:52 UTC 2007
Hi,
On 04/12/2007, Adam Sommer <asommer70 at gmail.com> wrote:
> > Use xref when linking to a section in the same document (as in this
> > case), but ulink when linking to a section in another document.
> >
> > xref tags should be relatively straightforward (the only thing to
> > remember is never to use the xreflabel attribute - as you've done in
> > the patch - because this is untranslatable. Instead just leave them
> > out and the link will use the title of the section you're linking to).
> >
> > ulink tags should be used with ghelp urls (in the case of documents to
> > be viewed in yelp) or other "language-neutral" urls (in the case of
> > documents to be viewed with other file viewers). After we convert the
> > xml to html, we have a custom script (fix-urls.sh) that goes through
> > all the documents and substitutes the ".xml" links with ".html" links.
> > In the case of your bug, we missed one...
> >
> Ah... that makes sense. Thanks Matt for the explanation. I think there are
> other <xrefs> linking to other chapters throughout the Server Guide (some I
> may have added) so I'll go through and convert them. That should take care
> of the bug as well.
Hang on - xrefs linking to other chapters in the server guide complies
with the guidelines in my earlier email, so you don't need to convert
them... Are you sure that you're clear on the distinction?
--
Matthew East
http://www.mdke.org
gnupg pub 1024D/0E6B06FF
More information about the ubuntu-doc
mailing list