Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Table of Contents - configurable heading depth #1521

Closed
BlueMM75 opened this issue Aug 3, 2024 · 1 comment · Fixed by #1726
Closed

Table of Contents - configurable heading depth #1521

BlueMM75 opened this issue Aug 3, 2024 · 1 comment · Fixed by #1726
Assignees
Labels
feature-request New feature or request released Available in a released installer

Comments

@BlueMM75
Copy link

BlueMM75 commented Aug 3, 2024

Problem to Solve

The ability to create a Table of Contents and also being able to refresh it is fantastic. But sometimes when I have a lot of headings and also a lot of depth to those headings (say Heading 1 to Heading 6), the TOC becomes huge and not easy to navigate.

New Feature/Solution

Provide the ability in the Table of Contents dialog, to specify the heading depth desired.
An example usage would be a user picking the depth (say a dropdown with each of the heading levels specified), selecting "2" and the TOC is generated with only Heading 1 and Heading 2 styles from the page.
Refreshing would also take into account the configuration of the TOC.
Bonus points would be for also taking into account the Title style, which I have seen before and sometimes use as a higher-level outline (the equivalent of Heading 0). So in the example above, the TOC would use all Title, Heading 1 and Heading 2 styles to outline. Happy to spin this off into a separate request if that's better.

Alternative Solutions

None that I can think of.

Additional Context

Similar to how MS Word works when inserting a TOC, the ability to only show levels to a certain depth:
image

@stevencohn stevencohn added the feature-request New feature or request label Aug 3, 2024
@oapy123
Copy link

oapy123 commented Sep 12, 2024

I also find it difficult to read the ToC when there are a lot of headings and levels. I think this would be a useful option to have. I also would like to have the ability to format the ToC to match the heading styles of the sections contained in the ToC (If not an exact formatting match, at least maybe adjust the formatting in some way - like Heading 1 levels would be largest font, Heading 2 slightly smaller, etc). I feel like this would make it easier to read and distinguish between each organizational level.

stevencohn added a commit that referenced this issue Dec 24, 2024
stevencohn added a commit that referenced this issue Dec 24, 2024
@stevencohn stevencohn self-assigned this Dec 24, 2024
@stevencohn stevencohn added the next-release Addressed but not yet released label Dec 24, 2024
@stevencohn stevencohn linked a pull request Dec 24, 2024 that will close this issue
@stevencohn stevencohn added released Available in a released installer and removed next-release Addressed but not yet released labels Dec 31, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
feature-request New feature or request released Available in a released installer
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants