docbook-apps

  • 1.  man page output

    Posted 08-20-2006 02:57
    <refentryinfo>
    <author><firstname>Bruno</firstname><surname>Haible</surname>
    <otheraddr><ulink url="http://www.haible.de/bruno/"/></otheraddr>
    </author>
    <author><firstname>Sam</firstname><surname>Steingold</surname>
    <otheraddr><ulink url="http://www.podval.org/~sds/"/></otheraddr>
    </author>
    <copyright><year>1992-2006</year><holder>Bruno Haible</holder></copyright>
    <copyright><year>1998-2006</year><holder>Sam Steingold</holder></copyright>
    </refentryinfo>

    produces this in MAN page output:

    AUTHORS
    Bruno Haible

    Author.

    Sam Steingold

    Author.

    COPYRIGHT
    Copyright (C) 1992-2006 Bruno Haible
    Copyright (C) 1998-2006 Sam Steingold




    1. what do I do to replace "Author." in "AUTHORS" with the url?

    2. why is nothing like that produced in the HTML output?

    I am using http://docbook.sourceforge.net/release/xsl/snapshot/

    thanks!

    --
    Sam Steingold (http://www.podval.org/~sds) on Fedora Core release 5 (Bordeaux)
    http://mideasttruth.com http://dhimmi.com http://ffii.org http://truepeace.org
    http://israelnorthblog.livejournal.com http://palestinefacts.org
    Only adults have difficulty with child-proof caps.




  • 2.  Re: [docbook-apps] man page output

    Posted 08-20-2006 03:21
    Am Samstag, den 19.08.2006, 22:56 -0400 schrieb Sam Steingold:
    > <refentryinfo>
    > <author><firstname>Bruno</firstname><surname>Haible</surname>
    <otheraddr><ulink url="http://www.haible.de/bruno/"/></otheraddr>
    </author>
    > <author><firstname>Sam</firstname><surname>Steingold</surname>
    <otheraddr><ulink url="http://www.podval.org/~sds/"/></otheraddr>
    </author>
    > <copyright><year>1992-2006</year><holder>Bruno Haible</holder></copyright>
    > <copyright><year>1998-2006</year><holder>Sam Steingold</holder></copyright>
    > </refentryinfo>
    >
    > produces this in MAN page output:
    >
    > AUTHORS
    > Bruno Haible
    >
    > Author.
    >
    > Sam Steingold
    >
    > Author.

    With the empty line between the name and the contrib-sentence?

    > COPYRIGHT
    > Copyright (C) 1992-2006 Bruno Haible
    > Copyright (C) 1998-2006 Sam Steingold
    >
    >
    >
    >
    > 1. what do I do to replace "Author." in "AUTHORS" with the url?

    The "Author." string can be replaced by using the contrib-element:

    <author>
    <firstname>John</firstname>
    <surname>Doe</surname>
    <contrib><ulink url="http://domain.tld"/></contrib>
    </author>

    I think, this is not the intended usage of <contrib>, but if you really
    need the link there ...

    > 2. why is nothing like that produced in the HTML output?

    There is an open report at
    http://sourceforge.net/tracker/index.php?func=detail&aid=1446951&group_id=21935&atid=373750, which maybe fits, what you ask for.

    Regards, Daniel




  • 3.  Re: [docbook-apps] man page output

    Posted 08-21-2006 06:18
    Sam Steingold <sds@podval.org>, 2006-08-19 22:56 -0400:

    > <refentryinfo>
    > <author><firstname>Bruno</firstname><surname>Haible</surname>
    <otheraddr><ulink url="http://www.haible.de/bruno/"/></otheraddr>
    </author>
    >
    > produces this in MAN page output:
    >
    > AUTHORS
    > Bruno Haible
    >
    > Author.

    Not exactly. The blank line between "Bruno Haible" and "Author."
    is an artifact of your customization layer, not something produced
    by the stock stylesheets.

    > 1. what do I do to replace "Author." in "AUTHORS" with the url?

    Use the latest snapshot. I checked in a change that should give
    you what you want without you needing to make any change to your
    XML source or customization layer.

    > 2. why is nothing like that produced in the HTML output?

    Because HTML output from the DocBook XSL stylesheets is not
    intended to reproduce the look of man pages.

    --Mike



Related Content