OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [docbook-apps] Re: Questions about Refentries in an Appendix ...


On Mon, Sep 29, 2003 at 04:03:52PM +0200, Frédéric BOITEUX wrote:
> Bob Stayton <bobs@sco.com>  wrote:
> 
> > > - the title of the appendix isn't at the top of a page (no page break) as
> > >   the docbook documentation suggest it should
> > 
> >  Is this appendix in an article or book?  If it is in a book,
> >  you should get a new page sequence for each appendix.
> >  If it is in an article, then the stylesheets don't start
> >  a new page sequence for an appendix.
> 
> Yes, it's in an article.
> 
> > 
> >  There is a separate template with match="article/appendix"
> >  in fo/component.xsl to handle an appendix in a article.
> >  You could customize that to add a break-before="always"
> >  to its fo:block.
> > 
> Ok, thanks !
>  
> 
> >  > - I would like to have Refentries' titles in the toc :
> >  > how this could be done ?
> > 
> >  Refentries should already have entries in the TOC,
> >  using the refname element as the TOC text.
> 
> I don't have it : only the appendix title, no refentries' titles inside...
> perhaps also because it's an article and not a book ? 

Further investigation shows that I was mistaken.
I was looking at the PDF bookmarks, and the refentries
show there when they are in an article/appendix.  But such
refentries are not in the printed TOC.

The problem is in this template in fo/autotoc.xsl:

<xsl:template match="preface|chapter|appendix|article"
              mode="toc">
  ...
  <xsl:variable name="nodes" select="section|sect1"/>
  ...


The content of the appendix toc (the 'nodes' variable)
is selecting only section or sect1 elements.  This should
be expanded to include refentry and simplesect, which are
also allowed here.

I'll file a bug report on this so it gets fixed.
In the meantime, you can copy this template to
your customization and change that line to:

  <xsl:variable name="nodes" select="section|sect1|refsect"/>

-- 

Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
The SCO Group                               fax:   (831) 429-1887
                                            email: bobs@sco.com


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]