nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

TOC in sidebar

Administrateur SI

This question is in reference to Atlassian Documentation: Table of Contents Macro

Hi,

As explained in the Table of Contents Macro documentation, I tried to configure a TOC in the sidebar using this :

{toc:printable=false|style=none|indent=20px|type=list|outline=true|absoluteURL=true}

It creates a great TOC but when I want to access a link of this TOC, I get a "page not found" error...

I'm using Confluence 5.10.1

Accepted answers

Administrateur SI

Hi,

This issue has been recognised and accepted by Atlassian team : it is tracked by the ticket CONF-43090

Thanks to all for your concern and your answers

All comments

Rodney Hughes

Putting it in the sidebar makes no real sense to me. The side bar is for navigating TO a page.

The TOC macro is supposed to be put in the main body of the page as it is only relevant to THAT page, i.e. for jumping to headings within the page.

Administrateur SI

Thanks for your answer. I understand your point of view but it's not mine : I found no easy way to have an always visible TOC whatever the position in the page. The easiest way I found is to put it in the sidebar.

Moreover, as it is described in a confluence documentation page (https://confluence.atlassian.com/doc/table-of-contents-macro-182682099.html), it seems not that ridiculous to me to use it as it is described.

Rodney Hughes

Well, what I am saying is I don't think the functionality of the TOC macro would work properly in the side pane as it is intended as an "on page" thing - if you try to use a screwdriver as a hammer you end up with difficulties because you are using the wrong tool

What you might want to investigate is putting the TOC macro into the page header and then make that the default or selectable page template (I have a standard header and footer in my pages https://ideology.atlassian.net/wiki/x/AgBv ) ... but obviously that would make the header gets bigger and bigger as more and more headings are added in the page... so you could put an Expand macro in the header and put the TOC inside the Expand so it normally looks like a single line smile

Administrateur SI

Thanks a lot for your quick answer.

The problem with the TOC macro into the page header is that when the page is scrolled, the TOC disapear, when the sidebar is still available.

The thing is that we use Confluence to create technical docs (like specification docs). Thus, pages can be very long and we really need to have a TOC always available...

Are you telling me that there is no way to make toc macro work in the sidebar ?

Administrateur SI

Hi,

This issue has been recognised and accepted by Atlassian team : it is tracked by the ticket CONF-43090

Thanks to all for your concern and your answers

Sharon Metzger

This process used to work for me, but now doesn't. I didn't notice if it was at a particular version upgrade. We're on 6.6.1 now.

On the page itself, I have anchors for every section, and then added references to each anchor in the sidebar (Space tools > Look and Feel > Sidebar, header and footer). In the Sidebar, I used this format:

[#first-anchor]
[#second-anchor]

and so on. Now that I think about it, it seems insufficient because there's no page name (there's only one page in this space), but this used to work to jump to a specific spot on the page. Now I get a Page Not Found error.

Andra Vasiliu

If you wish to have a floating TOC (that scrolls with the page) you can use a CSS class to define it.

First define the CSS in Space Tools > Look and Feel > Stylesheet and then cite it in the TOC macro in the sections "CSS Class Name".

Like in these answers

Michael Yang - Shinetech Software

Here is a floating TOC free plugin you can use (for server).

https://marketplace.atlassian.com/1221271

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

confluence

table-of-contents