Why Does the Table of Contents Or Page Tree Macro Not Show in the Help Center Theme?
The help center theme disables Confluence’s table of contents macro and page tree macro by default as the theme already comes with a global table of contents and page tree feature that should make those macros redundant in your site.
Read on to understand the benefits of these features over the corresponding macros.
The Table of Contents in the Help Center Theme
Scroll Sites' help center theme already comes with a global table of contents feature on every article page. You can enable it from Site settings → Look and feel → Pages → Article Page → Table of contents.
We deliberately disable the table of contents macro on your help center articles, so that you don’t end up with any duplicates on the page. Our TOC feature has advantages over the macro, for example:
Once enabled, it’s automatically shown on all your articles. With the macro you have to insert it on all pages one by one
It’s visible even when the user scrolls down on a long page. In contrast, the macro is only visible if the user is on top of the page. That means, it’s easier for a user to navigate to specific sections, no matter where they are on the page.
We recommend to get rid of the macro on your page and simply rely on the TOC that we generate for you on the right-hand site of every article page.
The page tree in the Help Center Theme
All articles pages in the Help Center theme will always show an article navigation on the left hand side of the page.
The help center theme deliberately disables the page tree macro on your pages, so that you don’t end up with a duplicate navigation on the page. The help center theme’s article navigation has advantages over the macro, for example:
It’s automatically shown on all your articles. With the macro you have to insert it on all pages one by one
It’s visible even when the user scrolls down on a long page. In contrast, the macro is only visible if the user is on top of the page. That means, it’s easier for a user to navigate to specific pages, no matter where they are on the page.
It’s optimized to the look and feel of the Help Center
We recommend to get rid of the macro on your page and simply rely on the article navigation that we generate for you on the left-hand site.
If you would like to show only a few selected pages, not the whole page tree, we recommend using the Filter by label macro (formally content by label macro).