Re: [docbook-apps] Re: authors in refentry

["Bob Stayton" <bobs@sagehill.net>]

I agree with Mauritz that the default output for refentry should not be in 
the style of Unix man pages, with their separate sections for authors and 
copyright.  Those are not common sections for non-man-page references that 
I've seen.  Adding them to the default refentry output would expose 
information that currently is not exposed.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net


----- Original Message ----- 
From: "Mauritz Jeanson" <mj@johanneberg.com>
To: "'Sam Steingold'" <sds@gnu.org>
Cc: <docbook-apps@lists.oasis-open.org>
Sent: Wednesday, September 10, 2008 12:38 PM
Subject: RE: [docbook-apps] Re: authors in refentry


>> -----Original Message-----
>> From: Sam Steingold
>>
>> this merely puts the header from the <book> in the beginning
>> of the man page.
>> this is certainly not what I need.
>> what I want is the AUTHORS and COPYRIGHT sections in the html
>> manual (these
>> sections are already present in the nroff manual).
>> I think the absence of these sections in the html output is a bug.
>
>
> OK, now I understand a little better (I hope). In nroff output, you get
> AUTHORS and COPYRIGHT section headings. In HTML, you don't get these
> headings (but you do get the author and copyright information).
>
> Whether this is a bug or not can be debated. I don't think that the HTML
> output from refentry sources was ever meant to be a verbatim emulation of
> the nroff (man page) output.
>
> Below are two simple customizations that generate "Authors" and 
> "Copyright"
> headings in HTML (the original templates are in titlepage.xsl). They may 
> not
> be exactly what you want, but I hope they can be of some help.
>
> Mauritz
>
>
> -----
> <xsl:template match="authorgroup" mode="titlepage.mode">
>  <div>
>    <xsl:if test="parent::refentryinfo">
>      <h2>Authors</h2>
>    </xsl:if>
>
>    <xsl:apply-templates select="." mode="class.attribute"/>
>    <xsl:call-template name="anchor"/>
>    <xsl:apply-templates mode="titlepage.mode"/>
>  </div>
> </xsl:template>
>
>
> <xsl:template match="copyright" mode="titlepage.mode">
>
>  <!-- Output only one heading -->
>  <xsl:if test="generate-id() = generate-id(//refentryinfo/copyright[1])">
>    <h2>Copyright</h2>
>  </xsl:if>
>
>  <p>
>    <xsl:apply-templates select="." mode="class.attribute"/>
>    <xsl:call-template name="gentext">
>      <xsl:with-param name="key" select="'Copyright'"/>
>    </xsl:call-template>
>    <xsl:call-template name="gentext.space"/>
>    <xsl:call-template name="dingbat">
>      <xsl:with-param name="dingbat">copyright</xsl:with-param>
>    </xsl:call-template>
>    <xsl:call-template name="gentext.space"/>
>    <xsl:call-template name="copyright.years">
>      <xsl:with-param name="years" select="year"/>
>      <xsl:with-param name="print.ranges" select="$make.year.ranges"/>
>      <xsl:with-param name="single.year.ranges"
>                      select="$make.single.year.ranges"/>
>    </xsl:call-template>
>    <xsl:call-template name="gentext.space"/>
>    <xsl:apply-templates select="holder" mode="titlepage.mode"/>
>  </p>
> </xsl:template>
> -----
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>
>
>