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

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

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


Subject: Re: [docbook] Re: [docbook-apps] toc customization question


Hi Stefan,
Actually there is a <toc> element defined in DocBook 4 and 5. It can be populated with manually-written elements, or it can be empty with the expectation that the stylesheet will generate its content. The XSL stylesheets mostly support it, with a couple of params to control it:

http://docbook.sourceforge.net/release/xsl/current/doc/html/process.source.toc.html
http://docbook.sourceforge.net/release/xsl/current/doc/html/process.empty.source.toc.html

The default behavior is to generate a TOC local to the current element containing the toc element. Making it more global would require customization.

*But*, I just noticed that DocBook 5 does not allow a <toc> element at the beginning of a section element, only at the end. It does allow it at the beginning in DocBook 4, and it does in DocBook5 for chapter, appendix, preface, and topic (new to 5.1). I think this is a bug in DocBook 5, since putting a toc at the end of a section is rather odd. I've filed an RFE with the DocBook Technical Committee to get this looked at.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net


----- Original Message ----- From: "Stefan Seefeld" <stefan@seefeld.name>
To: <docbook-apps@lists.oasis-open.org>; "docbook" <docbook@lists.oasis-open.org>
Sent: Friday, June 01, 2012 6:34 AM
Subject: [docbook] Re: [docbook-apps] toc customization question


On 06/01/2012 09:18 AM, Tim Arnold wrote:
Hi Dick,
Thanks, I have been reading that section, but it's not that I want to
control the toc on every section, just one section that has a
particular attribute. My question wasn't clear that I do want section
tocs, just not for this particular section.

Allow me to jump in with a somewhat related request:

I have run into other situations where I'd like to be able to control
ToC generation explicitly. For example: In DocBook Slides, I'd like to
generate a ToC for each foilgroup (and highlight the current position).
So far I have done this by customizing the appropriate xsl templates.
However, I think it would be very convenient for authors to be able to
explicitly request a toc at a given place, for example using a "<toc>"
element, akin to "<index>". (This could be further tuned by adding
attributes to indicate whether this should be a toc for the local
subtree, or a global one.)

Does this sound reasonable ? I will cross-post this to the docbook list,
too, as it is essentially a request for the DB grammar itself.

Thanks,
       Stefan

--

     ...ich hab' noch einen Koffer in Berlin...


---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-help@lists.oasis-open.org






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