[fpc-pascal] Docs - structural change

[Tomas Hajny]

On 2026-09-09 23:09, Michael Van Canneyt via fpc-pascal wrote:


Hi Michael,

> It always bothered me that it is cumbersome to navigate the docs - the
> standard tex4ht mechanism is too bare-bones.
> 
> So I added some postprocessing to add a (optional) sidebar:
> 
> https://www.freepascal.org/~michael/docs-demo/docs/sidebar/
> 
> Which makes navigation more comfortable.
> 
> It loads the sidebar at runtime with some javascript, to avoid bloating 
> every page with the same sidebar HTML.
> 
> Comments, suggestions welcome.
> 
> (site might be slow currently, seems we're being visited by some 
> bots...)

It looks nice and is certainly useful. There's just one caveat - could 
you please check whether HTML files created this way are still usable in 
our IDE? It isn't critical if not as long as the CHM version of all the 
help files is provided as an alternative (and it works correctly with 
that version), but if the direct HTML files aren't supported as the help 
in the IDE any longer, we should communicate it clearly (especially 
considering the fact that some users might have this configured for 
their existing installations, but also for new installations).

Tomas