]> granicus.if.org Git - docbook-dsssl/commit
Implemented out-of-line handling of URLs for links (Ulinks).
authorMichael Smith <xmldoc@users.sourceforge.net>
Mon, 11 Jul 2005 10:29:58 +0000 (10:29 +0000)
committerMichael Smith <xmldoc@users.sourceforge.net>
Mon, 11 Jul 2005 10:29:58 +0000 (10:29 +0000)
commit3e2d2508272d8ed90d71aeee9a9ac38cea62602c
tree68bb15138b6a82ee00e3308e292b50151e262061
parent5ea24dcbf83ee4234b1ee6055222ff3ca8304823
Implemented out-of-line handling of URLs for links (Ulinks).
(Closes #1234711 and #1233909)

For display of links, this implementation gives users three choices:

  1. Number & list links. Each link is numbered and a numbered
     list of all links is added to the end of the document.

     or

  2. Only list links. Links are not numbered, but an (unnumbered)
     list of links is added to the end of the document.

     or

  3. Suppress links. Don't number links and don't add any list of
     links to the end of the document

Users can also choose whether links should be underlined.

Default is "the works" -- list, number, and underline links. The
man.links.* parameters can be used to change the defaults.

The default heading for the link list is REFERENCES. That can be
changed using the man.links.list.heading param.

There is a performance hit for listing and numbering links. But it
is not an unreasonable one.

The code currently only checks for Ulinks. It can be updated later
(possibly) to deal with DocBook NG linking. But come to think of
it, DocBook NG links get converted by the strip-ns template. So
DocBook NG users will just need to run that first. Or, if I can
ever manage to get the single-pass conversion process to work with
manpages, it will get done automatically.
xsl/manpages/docbook.xsl
xsl/manpages/inline.xsl
xsl/manpages/links.xsl [new file with mode: 0644]
xsl/manpages/param.ent
xsl/manpages/param.xweb