]> granicus.if.org Git - docbook-dsssl/commit
Added new param man.base.url.for.relative.links .. specifies a
authorMichael Smith <xmldoc@users.sourceforge.net>
Sat, 8 Mar 2008 17:50:28 +0000 (17:50 +0000)
committerMichael Smith <xmldoc@users.sourceforge.net>
Sat, 8 Mar 2008 17:50:28 +0000 (17:50 +0000)
commitb24b092a909b23368a3e147dd64f7980cfadf049
tree77f9f8b6c3acf5af474ed9c3fe43ba39407554eb
parent938f090b6f9467f358f0ae81ef254ede4b8bd010
Added new param man.base.url.for.relative.links .. specifies a
base URL for relative links (for ulink, @xlink:href, imagedata,
audiodata, videodata) shown in the generated NOTES section of
man-page output. The value of man.base.url.for.relative.links is
prepended to any relative URI that is a value of ulink url,
xlink:href, or fileref attribute.

If you use relative URIs in link sources in your DocBook refentry
source, and you leave man.base.url.for.relative.links unset, the
relative links will appear "as is" in the NOTES section of any
man-page output generated from your source. That's probably not
what you want, because such relative links are only usable in the
context of HTML output. So, to make the links meaningful and
usable in the context of man-page output, set a value for
man.base.url.for.relative.links that points
to the online version of HTML output generated from your DocBook
refentry source. For example:

  <xsl:param name="man.base.url.for.relative.links"
  >http://www.kernel.org/pub/software/scm/git/docs/</xsl:param>
xsl/manpages/endnotes.xsl
xsl/manpages/param.ent
xsl/manpages/param.xweb
xsl/params/man.base.url.for.relative.links.xml [new file with mode: 0644]