Skip to content

Number only the four course chapters, starting at 1 - #5

Merged
shorttle merged 1 commit into
mainfrom
toc-numbering
Oct 8, 2026
Merged

shorttle merged 1 commit into
mainfrom
toc-numbering

Conversation

@shorttle

@shorttle shorttle commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

The contents list numbered every top-level entry, so the Course Overview
took number 1 and the four course chapters ran 2-5, one out of step with
both their (C1)-(C4) titles and the 01_ .. 04_ directory prefixes.

Sphinx numbers each toctree independently and has no option to start from
a value other than 1, so split the single toctree into three parts: front
matter and reference material unnumbered, the four course chapters numbered.
The file list and its order are unchanged.

Course Overview (unnumbered)

  1. Origin of Planets (C1)
  2. Origin of Habitable Environments (C2)
  3. Origin and detection of life (C3)
  4. Biospheres (C4)
    Glossary (unnumbered)

Co-Authored-By: Claude Opus 5 (1M context) noreply@anthropic.com

The contents list numbered every top-level entry, so the Course Overview
took number 1 and the four course chapters ran 2-5, one out of step with
both their (C1)-(C4) titles and the 01_ .. 04_ directory prefixes.

Sphinx numbers each toctree independently and has no option to start from
a value other than 1, so split the single toctree into three parts: front
matter and reference material unnumbered, the four course chapters numbered.
The file list and its order are unchanged.

Course Overview        (unnumbered)
1. Origin of Planets                  (C1)
2. Origin of Habitable Environments   (C2)
3. Origin and detection of life       (C3)
4. Biospheres                         (C4)
Glossary               (unnumbered)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@shorttle
shorttle merged commit 74e6a73 into main Oct 8, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant