DiscoTOC - automatic table of contents

[NateDhaliwal]

Hi there, are you referring to the contents? You can click on the button in the topic timeline:

[pHneutre]

Hi, it would be really great that clicking on a TOC item modifies the URL of the page to the matching heading anchor, just like when one clicks on the anchor link on the left of the heading.
That way, one could share a specific subject to another person even though they’re not aware of the left anchor link.
Has it been considered?

[newbit1337]

Hi, quick question:
Is the level of nesting limited to 5, or did I do anything wrong?

[tobiaseigen]

That’s interesting - I just tested and can confirm that only five levels are supported in the table of contents, while six levels are supported in markdown. I suspect this was an intentional decision, as six levels might be cumbersome to navigate.

[Hasimir (Alex)]

Are there known compatibility issues between DiscoToC and the Documentation Categories plugin?
ToC works perfectly on my normal topics, but not at all in my Doc ones

[Honeyxilia]

Hello - I’ve noticed a quirk regarding the topic translation swap button with DiscoTOC on

Indeed, a button was added in order to swap between the translation of a topic in the client’s language, and the original topic text

Here’s the basic translated topic disposition without DiscoTOC

And here’s the disposition with the DiscoTOC lateral panel

While it was not an issue to miss the settings button, since the same features are found at the bottom of the topic, the translation swap cannot be achieved in the same way…

Could it be possible to see into showing the button even with DiscoTOC, as it’s a default Discourse theme button ?

[one1]

@Discourse

In order for the links in the toc to work, headings must have id attributes. The component will check if the headings already have ids and if they do, then they are respected. This is handy if you ever manually created a toc.

Can someone please explain how you put an id attribute on a heading? I tried the method here: Extended Syntax | Markdown Guide putting {#custom-id} at the end of a heading line. I also just used html h1 tags and added an id. None of that worked.

Is the documentation no longer correct? If it is possible to add my own ids, that would fix the issue I’m having over here assuming those ids worked through the various situations of anchor tags.

[awesomerobot (Kris)]

yeah no longer correct (I’ll remove it), the component uses anchor links rather than heading ids now… when adding headings to posts Discourse automatically creates anchor links and those get used for the table of contents

[one1]

Thanks!

I realize this may not be strictly related to the toc component, but do you know if there is any way to get permanent ids to headings? The ids that are automatically generated are extremely fragile. Even just putting another heading in the document can change all the ids.

Also… Is there any way with this plugin to set toc text that is different from the heading in the document? The use case is when the heading in the document is long and an abbreviated entry would be better in the toc. There is a similar feature in the docs plugin where in the category index you can have custom text. Totally different system, there though.