Add NumberSections - number each markdown document from 1 #896
Unanswered
72757373656c6c
asked this question in
Q&A
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
-
In the MySt-Parser documentation on github, the conf.py contains a section "Local Sphinx extensions".
There are at least two modules that are of interest:
Unlike
toctree numbered
andSphinx-multitoc-numbering
, I'm looking to number each autonomous markdown document starting at 1, similar to this and the myst-parser documentation itself.NumberSections
above is perfect. If it numbered the document headers in the "Secondary Sidebar" it would be more perfect 😄When I researched NumberSections I found a github entry. The issue is unrelated, but the author of the post showed an example of their documents' front-matter that contained "numberSections: true". They were referencing JupyterBooks, so I did a site search at jupyterbook.org, but there were no results. I tried it, and it did not number the document's headings and there was no error.
So I'm back to these modules, are these modules "standard" or is there a more official way?
Would it be a Feature Request to make NumberSections, as used in the MyST-Parser documentation, official? Same goes for MystExampleDirective?
Thank you in advance.
Environment: Sphinx + myst-parser + sphinx-book-theme
Beta Was this translation helpful? Give feedback.
All reactions