Add option to hide toc

[cdervis]

Hi @mgks,

first off, thanks for building this excellent documentation tool. Very easy to set up and accomplishes its "it just works" goal. 👏

I may have overlooked it, or is it not yet possible to hide the table of contents for specific pages?
If so, I think a good fit for this might be the frontmatter, where one could specify one of three values:

• toc: visible: Shows the toc fully, just as it does now. So this would be the default if not specified in the frontmatter.
• toc: none: Hides the toc & its sidebar completely. So the <div class="toc-sidebar"> would not be generated.
• toc: sidebar: Only suppresses the generation of the <div class="toc-container">.

The reason I'm proposing three options instead of just toc: true and toc: false is so that the toc-sidebar could still be used for other elements in the future, as a general sidebar.

However, if you don't see a point in keeping that sidebar, it might just as well be a toc: true / toc: false.
Would this simply be an adjustment to this line?

Thanks!

[mgks]

Hey! I'm really glad you liked the project, thanks for the kind words.

You haven’t overlooked anything, hiding the ToC per page isn’t implemented yet. Your suggestion makes a lot of sense though, and I like the idea of having flexible options for it instead of a simple true/false. That would give us room to extend the sidebar for other purposes in the future.

I’ve added this to the roadmap and start exploring how we can integrate it cleanly. It should just be a matter of adjusting the generation logic where you pointed, but I’ll make sure it’s done in a way that doesn’t break existing setups.

Thanks again for the thoughtful input, this is exactly the kind of feedback that makes docmd better. 🙌

[mgks]

Little late with the update, been busy with a lot of other stuff, new release 0.2.5 has toc custom frontmatter that can be configured for individual pages now. Not sure now, but if needed we may add site wide toc config in future releases.

Let me know if it is working fine as expected.

[cdervis]

Thanks for implementing this. Works as intended.