Re: [docbook-apps] Adding headings to a table of contents

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

Hi,

I looked into this, and it appears that this feature is not fully implemented.  In fact, the reference page for this param says just that:

 

http://docbook.sourceforge.net/release/xsl/current/doc/fo/bridgehead.in.toc.html

 

It seems to work in TOCs in HTML output, but with some oddities. For example, if section numbering is turned on, a bridgehead appears in the TOC with a section number that matches the section number of its *parent*, but the bridgehead in the text has no section number.

 

In FO output, bridgeheads only work in section TOCs.  That is, if your generate.toc parameter includes "section toc", so that you generate a toc for each section, then you will see the bridgeheads included in such section TOCs. But not at TOCs included at any other level. 

 

Looking at older stylesheets, I don't think this feature ever worked properly.  But I can't seem to find a bug report about it not working either.  As the reference page says, it should either be fixed or removed.

 

If you want to implement it yourself in a FO customization layer, take a look in html/autotoc.xsl and see how it is included in the select attribute for the variable whose name is "nodes".  That is where child nodes are selected for inclusion in a TOC.  You may experience unwanted numbering of bridgeheads, though, if the HTML example is any indication.

 

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

 

 

----- Original Message -----

From: Diane Larin

To: docbook-apps@lists.oasis-open.org

Cc: Diane Larin

Sent: Friday, September 10, 2010 6:32 AM

Subject: [docbook-apps] Adding headings to a table of contents

The following message had wrong subject. Sorry for the confusion.

- Diane Larin

On 09/09/2010 3:08 PM, Diane Larin wrote:

4C8930AD.6040608@inro.ca type="cite">Hi,

I am trying to include some "sub-headings" in the table of contents of a book using bridgehead elements. The sub-headings are formatted as desired but there is no entry in the TOC. I generated the fo file using:

 xsltproc -o mybook.fo  --stringparam bridgehead.in.toc "1"  ....

Is there any other way to include specific headings in a TOC?

I am using docbook-xsl-1.73.2 stylesheets.

Thanks in advance.

- Diane Larin