Is there a way to display all sub wikis in an index page in gitlab?

Question

So in gitlab you can use [[_TOC_]] to display a table of contents for the current page - which works on headings.

But I want to have a heirachy in my wiki like:

<home-url>/Project1
<home-url>/Project1/Tools
<home-url>/Project1/Debugging
<home-url>/Project1/Debugging/GDB
<home-url>/Project1/Debugging/MSVS

Such that in the Project1 page I get an index (links) to each section similar to the table of contents layyout - e.g.:

 - Tools
 - Debugging
    - GDB
    - MSVS

I can do this manually, but that's a pain to maintain. Is there some automatic tool to do this for me like TOC?

Answer 1

The TOC support steams from issue 2494, and was implemented in issue 21901, which gave us the Markdown [[_TOC_]] syntax.

Even the current request to support [TOC] instead (issue 14193) does not mention any layout option to include a hierarchical display.

As mentioned in the first issue:

If you need more control, you can open a new issue at https://gitlab.com/gitlab-org/gitlab/issues and upvote it.

For example: issue 215988: "Add Gollum depth level support for Wikis Table of Contents [[_TOC_]]"

Having the ability to limit a [[TOC]] depth is useful to show a more synthetic view of a page while keeping its deeply nested structure.

---

See also GitLab 15.3 "Visualize table of contents in the WYSIWYG wiki editor".

Answer 2

Thanks to VonC for the actual answer - i.e. there is not such a feature at the moment (well, not quite as I want it) - but there is the side bar in gitlab wiki which shows you the pages within your wiki.

If you structure you wiki into folders and subfolders then you can navigate with this side bar "tree". Its not collapseable - so its just a bog-roll off text, but it is indented to aid navigation.
It works well enough for simple wikis with a few dozen pages - but probably if there are hundreds of pages it might start to breakdown - at that point you might want to break your wiki up into several wikis with a top-level links page or some such.

Here is (a crap) picture - it was the best I could see on google without looking too hard see here

You get this for free (without doing anything) so its decent for most cases.