How do I do chapter numbering without numbering the index page?

[pancakereport]

The UC Berkeley Data 8 Textbook uses Jupyter Book 1 to deliver its content. The root page was not required to be in the table of contents displayed on the LHS.

While upgrading to Jupyter Book 2, I noticed that the chapter numbering is off by +1. Jupyter Book 2 requires that the first entry of toc in myst.yml does not have children (so I can't put the actual first chapter there, instead I must put the root page). And, setting hidden: true does not seem to take for the first entry, so I can't hide the root page to put the actual first chapter first.

We need the numbering to be consistent with the previous delivery of the textbook. We have 10 years of publicly available course materials that link to the textbook's original numbering.

I am requesting that there be a way to have more control over TOC numbering. For example, being able to choose if numbering starts at 0 or 1. If the root page must be shown in the TOC, we'd like it to be numbered with 0 instead of 1. Other workarounds that have to do with the restrictions on the first TOC entry (either having children or being able to hide the first entry) may also meet our needs.

Appreciate any and all help on this.

[rowanc1]

On the intro page you can turn on/off title numbering as well as set the start: 0. Docs are here:

https://mystmd.org/guide/cross-references#title-numbering

For your case, on the index page remove the title numbering:

---
numbering:
  title: false
---

Your content

Then turn it back on on your chapter 1:

---
numbering:
  title:
    enabled: true
    start: 0 # Might be 1...
---

Your content

There are a few other things like offset that you can use as well here depending on how your book is nested.

[pancakereport]

Thanks for the response. I was referencing the docs during the upgrade process. I did not see a mention of the start option looking at title numbering, but I'm now seeing this in the continuous numbering section (referring to figures). I am unable to set start: 0 (⛔️ myst.yml 'start' must be greater than or equal to 1: 0 (at myst.yml#config.project.numbering.start)) which does not help me with my issue.

Adjusting the numbering settings within a page's yaml does provide more flexibility. However from a quick look it appears that I will have to set numbering for every single page because of the weirdness introduced and pictured below (which is quite annoying for ~100 pages). Or am I missing something?

[rowanc1]

Playing around with your example:

In myst.yml

project:
  # ... existing stuff
  numbering:
    title: true

In the first index file chapters/intro.md:

---
title: 'Computational and Inferential Thinking: The Foundations of Data Science'
numbering:
  title: false
---

That should be it for the numbering changes.

---

However, some of the pages which are notebooks are not numbered because they do not have a title found, this is because the first cell is a code cell (which is hidden) and not a markdown cell.

Creating a script to reorganize your notebook cells to have the markdown be the first one results in:

Which I think is the same as your current setup.

The script I used to move the cells around is:
reorganize_notebooks.py

[pancakereport]

Ok got it. Weird that adding

---
numbering:
  title:
    enabled: true
    start: 1
---

to the second toc entry's file led to the weird numbering that I pictured.

And I'm not seeing any issues with numbering. I believe my PR already addressed notebooks without h1 headers at the start of the notebook.

Appreciate the insight.

[rowanc1]

Awesome, glad it is all fixed up!