Add table of content pane

[marszub]

On the most common screen resolution i.e. 1920x1080 there is plenty of space on the sides of current content. Auto-generated table of content (TOC) that floats while scrolling the actual content would be very useful for navigation. It can be another toggle in server configuration. Since <!-- TOC --> tag is already supported, the TOC on the side can be generated the same way including links to headers. The TOC files should not be saved in the documentation dir to not create mess.

[DannyBen]

I will look into it. If implemented, it would probably be a setting to determine the position of the HTML snippet generated with <!-- TOC -->. Most likely be a CSS class added to this block that will make it float instead of part of the page.

[DannyBen]

I have looked into this, it is less straight forward than I thought, since the inline table of contents is added as markdown, and not as HTML (therefore, I cannot apply an HTML class to it to let it float at will).

We can keep this issue open for now, but at this point, I do not see it happening.