TOC fully expanded

[stefansimik]

Is it possible to have TOC fully expanded and see all levels?
Now TOC automatically expands and collapses, based on where we click.

I am asking in general, but specially interested in HTML export format.

[mcanouil]

If you are looking for a toc-collapse option to be set to false, I am afraid, there isn't right now.

@dragonstyle Do you think this option could be added? (it exists in rmarkdown)
I looked at the codebase and if I am not mistaken, currently it is hardcoded.

quarto-cli/src/format/html/format-html-bootstrap.ts

Lines 306 to 320 in aeb98c4

	// default collapse non-top level TOC nodes
	const tocDepth = format.pandoc[kTocDepth] || 3;
	if (tocDepth > 1) {
	const ulSelector = "ul ".repeat(tocDepth - 1).trim();
	const nestedUls = toc.querySelectorAll(ulSelector);
	for (let i = 0; i < nestedUls.length; i++) {
	const ul = nestedUls[i] as Element;
	ul.classList.add("collapse");
	}
	}
	toc.remove();
	tocTarget.replaceWith(toc);
	} else {

[stefansimik]

That is exactly, what I am looking for 👍
It would be great and very useful, if this could be implemented 👌 .

[aborruso]

I think it's important to have it, great idea!

[fernandovmacedo]

I was wondering about this same question, and It would be great to have this option. While this doesn't happen, I have crafted a hack to make it work in the HTML format.

I have created a custom.scss file with the following rule:

/*-- scss:rules --*/
.sidebar nav[role="doc-toc"] ul {
  display: block;
}

And added after the default theme:

format: 
  html:
    toc: true
    theme:
      - default
      - custom.scss

With this, the TOC will always be expanded. I'm using that until the option become available.

[mcanouil]

The idea was to avoid setting a "weird" value such as 99 😅
For example, true would be 99 or whatever.

[dragonstyle]

Maybe I could rename it to toc-expandedwhich would make more sense like:

toc-expanded: true
toc-expanded: 3

What do you think?

[dragonstyle]

(the above should now be supported in the next pre-release build)

[mcanouil]

Maybe toc-expansion to follow the syntax of other toc-* keys.
With:

Specify the number of section levels to be expanded in the table of contents. The default is X.

Note that if set to true, all section levels will be expanded in the table of contents.

[dragonstyle]

I ended up with toc-expand: true or toc-expand: false or toc-expand: 3 :)