question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Optionally numbered sections

See original GitHub issue

Is your feature request related to a problem? Please describe.

I’d like to have numbered sections/chapters in general, but not for the landing page which is just a short preface. Right now, the landing page gets numbered as 1, and the first content section is 2. Not a huge deal, but a little awkward.

Describe the solution you’d like

It’d be great if individual sections could be optionally un-numbered, or if that’s not possible, if we could start the numbering at 0.

Similarly, I have an appendix, that is currently unnumbered, but would be awesome if it could start at A.

Forgive me if this is already possible, but I wasn’t able to find a way to do it.

Describe alternatives you’ve considered

Living in a cruel, 1-based world.

Additional context

Basically I want TeX’s \section*{foo} and/or explicit control over numbering.

Issue Analytics

  • State:closed
  • Created 3 years ago
  • Comments:5 (3 by maintainers)

github_iconTop GitHub Comments

1reaction
choldgrafcommented, Jul 14, 2020

I think this will change in the way you describe when https://github.com/executablebooks/jupyter-book/pull/768 is merged, though I should note that this will also slightly change how you trigger numbering (in the _toc.yml file with :numbered: true)

0reactions
choldgrafcommented, Feb 23, 2022

I don’t believe that it is currently possible with Sphinx - there’s an issue about it here: https://github.com/sphinx-doc/sphinx/issues/6614

Since this issue is now resolved, I’ll close it and open a new one to specifically cover changing numbering styles: https://github.com/executablebooks/jupyter-book/issues/1646

Read more comments on GitHub >

github_iconTop Results From Across the Web

[Optionally] Specifying arbitrary numbers for sections and ...
A syntax that resembles \section[12(e)]{Fermat's Last Theorem} , where the custom number is in brackets. I'm imagining that I'd ignore the normal section...
Read more >
Mixing numbered and unnumbered sections - Google Groups
Is it possible to mix numbered and unnumbered sections? I'd like to add an unnumbered *References* section at the end of a numbered-sections...
Read more >
How can I use numbered sections in documents?
Numbering inside items. If you include a list of items, and the items contain text boxes, the headings will NOT be numbered or...
Read more >
Report Writing Guidelines
Section numbering. It's not necessary to number the section headings in your report, but if you do so using a decimal system, the...
Read more >
Dewey Decimal Classification glossary - OCLC Support
Find a comprehensive listing of Dewey Decimal Classification terms accompanied by definitions.
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found