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

Reduce the size of the chunked HTML manual main table of contents #746

Closed
wants to merge 1 commit into from

Conversation

cjmayo
Copy link
Contributor

@cjmayo cjmayo commented Sep 28, 2023

Since [1] reference entries have been included in the main table of contents as level 2 information. Stop this by setting the TOC depth to 1.

[1]
acdfda8 ("Convert PostGIS manual to DocBook 5.0", 2023-07-14)

Since [1] reference entries have been included in the main table of
contents as level 2 information. Stop this by setting the TOC depth to
1.

[1]
acdfda8 ("Convert PostGIS manual to DocBook 5.0", 2023-07-14)
@cjmayo
Copy link
Contributor Author

cjmayo commented Sep 29, 2023

This does also remove the level 2 entries from other parts of the TOC, but that does help reduce the size too.

@strk
Copy link
Member

strk commented Oct 2, 2023

As part as the docbook version upgrade all "sect#" elements (numbered) were converted to "section" (unnumbered) so now depth level is the only indication. I'm happy with less noise in the TOC but would let @robe2 decide :)

@robe2
Copy link
Member

robe2 commented Oct 12, 2023

As part as the docbook version upgrade all "sect#" elements (numbered) were converted to "section" (unnumbered) so now depth level is the only indication. I'm happy with less noise in the TOC but would let @robe2 decide :)

I'm fine with that too as long as it doesn't break anything

@strk
Copy link
Member

strk commented Oct 13, 2023

@cjmayo how does generate.section.toc.level differ from toc.section.depth ?

@cjmayo
Copy link
Contributor Author

cjmayo commented Oct 15, 2023

generate.section.toc.level controls which sections will have TOCs

https://cdn.docbook.org/release/xsl/snapshot/doc/html/generate.section.toc.level

toc.section.depth controls which sections will appear in the TOC

https://cdn.docbook.org/release/xsl/snapshot/doc/html/toc.section.depth

@strk
Copy link
Member

strk commented Oct 16, 2023

Pushed as 0750de7 thank you

@strk strk closed this Oct 16, 2023
@cjmayo cjmayo deleted the toc-depth branch January 3, 2024 19:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
3 participants