This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
Re: [docbook-apps] Re: Questions about Refentries in an Appendix ...
- From: Bob Stayton <bobs at sco dot com>
- To: Frédéric BOITEUX <fboiteux at calistel dot com>
- Cc: docbook-apps at lists dot oasis-open dot org
- Date: Mon, 29 Sep 2003 09:56:14 -0700
- Subject: Re: [docbook-apps] Re: Questions about Refentries in an Appendix ...
- References: <20030929160352.2ff862b0.fboiteux@calistel.com>
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
To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org.