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

[Mark R. <ma...@la...>]

On 8-5-2016 03:32, Paul Vinkenoog wrote:
> 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.

I think I'd prefer the last one, "Max. levels in each ToC: 3 - Deepest 
section level in any ToC: 3 - Deepest section level for which ToCs are 
created: 2"

In the main TOC it gives a clear overview, and it allows for quick 
navigation to the right information.

Mark
-- 
Mark Rotteveel