Re: [Firebird-docs] Improve TOC and searchability of Firebird Language Reference

[Paul V. <pa...@vi...>]

Hi all,

>> I will look into the TOC issue this week. IIRC (it's been a while since
>> I did any extensive work on the transformation stylesheets) TOCs are
>> relatively easy to add and configure.

Presence and appearance of ToCs in the output are controlled by a number of XSLT parameters, the most important of which are:

- toc.section.depth
  determines the deepest section level that can appear in a ToC

- toc.max.depth
  determines the maximum depth (= number of levels) in any ToC
 
- generate.section.toc.level
  determines up to (or rather down to) which section level ToCs will be generated
  (for levels above section, like chapter and book, ToCs are always generated - at least by default)

Note: if generate.section.toc.level >= toc.section.depth, ToCs will be generated for that level, even though the child sections listed therein exceed toc.section.depth. Such ToCs will always be 1 level deep - i.e. they will only list the immediate subsections - regardless of toc.max.depth.

Please see http://firebird.vinkenoog.nl for a couple of alternatives.


Cheers,
Paul