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

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

Helen wrote:

>> My preference would be the second variant (2 - 2 - 2), where...

> I prefer the second version too.  It uses a bit more real estate but
> it means one doesn't have to keep reverting to the top-level TOC if
> browsing for a specific function while not knowing exactly the one you
> want.
>
> I guess time will tell, once we see the feature in action with the
> whole book and in the PDF.

The four HTML builds at firebird.vinkenoog.nl each comprise the entire
book.

But notice that the (local) changes I made only apply to multipage HTML.
Of course we can do the same for monohtml (as you use for the rlsnotes),
but we can also leave that build as-is or make other adjustments.

PDF is very different and already has the navigation pane, so local
ToCs are probably less useful there. However, we can do it if we want.
I've added a PDF with chapter ToCs to the above page as an example.

> Got your corrections for the BIN* functions, thanks.  I will probably
> defer a new build until I have the new template on board.

I'll commit the '2-2-2' variant then for now. But shall I do it just for
the refdocs set or for all our HTML docs?


Cheers,
Paul