Use tocify JS for dynamic TOC [upstream only]

Lennonka commented 1 week ago

Making the table of contents expandable and collapsible.

Improves UX for Foreman Docs. For long documents, it's more user friendly and we will be able to display level-3 headings.

Using the solution from StackOverflow: How to use tocify with asciidoctor for a dynamic toc? because asciidoctor does not support this natively.
Not sure about licensing when borrowed from StackOverflow.
It's not perfect, but better than a static TOC. What do you think?

Please cherry-pick my commits into:

github-actions[bot] commented 1 week ago

The PR preview for 667a96b9296b654544debed5ab8523ee0c66eba4 is available at theforeman-foreman-documentation-preview-pr-3453.surge.sh

The following output files are affected by this PR:

Lennonka commented 1 week ago

A few tweaks and increased levels of headings.

It's actually quite cool! :sunglasses:

Lennonka commented 1 week ago

Sourcing the JS libraries locally. And rebased.

They have the MIT license - is that compatible with us?

I hope I managed to get the JS path correctly.

theforeman / foreman-documentation