Symptom
In a book-mode project whose TOC mixes section: parts and section: appendices groups, the left sidebar nav renders each parts group with its own "Part N — …" header, but the appendices group's children are rendered flat, with no group header — so the appendix pages (A, B) appear nested under the last Part instead of as their own group.
Evidence that this is a nav-rendering bug (not a config issue)
The same TOC data renders correctly on the contents/landing page: there, "Appendices" appears as its own group containing "Mathematical Background" and "Solutions". Only the sidebar nav drops the group header and lets the appendix entries fall under the preceding Part. So the project config is correct; the inconsistency is in how the sidebar nav renders appendices vs parts.
Reproduce
QuantEcon/book-dp2 (mystmd-conversion branch), built with the qe-v8 fork. The relevant myst.yml TOC shape:
toc:
- title: General Theory
section: parts
children: [ ... ]
- title: Models and Applications
section: parts
children: [ ... ] # "Part II"
- title: Appendices
section: appendices
children:
- file: ch_math_foundations.md # Appendix A
- file: ch_solutions.md # Appendix B
In the deployed sidebar, "A Mathematical Background" and "B Solutions" render indented under "Part II — Models and Applications" rather than under an "Appendices" header.
Expected
The appendices group should render its own sidebar-nav header (parallel to the "Part N —" header used for parts), or otherwise visually separate appendix pages from the preceding part — matching how the contents page already groups them.
Notes
The only book-side workaround is to drop section: appendices, but that sacrifices the A/B (Alph) appendix numbering, so this needs to be addressed in the theme.
Reported downstream in QuantEcon/book-dp-public#29 and tracked in QuantEcon/book-dp2#162.
Symptom
In a book-mode project whose TOC mixes
section: partsandsection: appendicesgroups, the left sidebar nav renders eachpartsgroup with its own "Part N — …" header, but theappendicesgroup's children are rendered flat, with no group header — so the appendix pages (A, B) appear nested under the last Part instead of as their own group.Evidence that this is a nav-rendering bug (not a config issue)
The same TOC data renders correctly on the contents/landing page: there, "Appendices" appears as its own group containing "Mathematical Background" and "Solutions". Only the sidebar nav drops the group header and lets the appendix entries fall under the preceding Part. So the project config is correct; the inconsistency is in how the sidebar nav renders
appendicesvsparts.Reproduce
QuantEcon/book-dp2 (
mystmd-conversionbranch), built with theqe-v8fork. The relevantmyst.ymlTOC shape:In the deployed sidebar, "A Mathematical Background" and "B Solutions" render indented under "Part II — Models and Applications" rather than under an "Appendices" header.
Expected
The
appendicesgroup should render its own sidebar-nav header (parallel to the "Part N —" header used forparts), or otherwise visually separate appendix pages from the preceding part — matching how the contents page already groups them.Notes
The only book-side workaround is to drop
section: appendices, but that sacrifices the A/B (Alph) appendix numbering, so this needs to be addressed in the theme.Reported downstream in QuantEcon/book-dp-public#29 and tracked in QuantEcon/book-dp2#162.