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

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


 

 

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

  
From: 
  Diane Larin 

  
To:  
  

  
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: 
  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