[Discussion] Numbered sections behaviour for sphinx-external-toc

[mmcky]

With jupyter-book@sphinx-external-toc coming down the pipeline I have done some testing against the new syntax that allows you to specify numbered: true/false for each part in the format: jb-book schema.

This numbering flag switches numbers on and off for the part when not using sphinx-multitoc-numbering. When using sphinx-multitoc-numbering extension it works (except for the cached regression discussed below) and the numbers skip the un-numbered sections and continue at the next numbered parts.

• Is this the desired behaviour or should be use global numbering and have numbers visible as controlled by the numbered: true/false setting?
• maybe we could add numbered: true as a global across parts in jb-book

Cached Sphinx Builds:

You can get conditions due to the sphinx cache where switching numbered: false in some sections appear to take no affect as those pages are not rebuilt as no content has changed (according to sphinx). Perhaps when there are config keys are altered in _toc.yml we should consider those files as changed and inform sphinx?

• this is an issue for https://github.com/executablebooks/sphinx-external-toc