I filed this also as an RFE¹ but haven't gotten any feedback so far;
trying here instead.

What would be the most plausible way to generate automatic section
numbers with the following requirements:

- Not all sections are numbered. Multiple blocks of sections *are*
numbered, with the numbering restarting in between. (It seems Sphinx
already handles this case just fine by using multiple toctree
directives, so that's good.)

- Section numbers need to be preceded by other text, e.g. "Appendix".

- Different blocks of numbered sections need to use different numbering
schemes. In particular, the aforementioned appendices should use Roman
numerals (I, II, etc.).

Is there any way to accomplish this that doesn't require either a)
modifying the guts of Sphinx itself, or b) duplicating lots and lots of
low-level Sphinx code? (I initially tried to replicate how Sphinx
auto-numbering works, but it looked like I was going to have to
replicate significant parts of Sphinx for that approach to be feasible.)

If the right answer is to change Sphinx, what would be the recommended
way to implement these features such that they can be incorporated into
upstream? (And, on a related note, is there a way in Python, or even
better, already in Sphinx itself, to translate integers to Kanji
numbers, Hebrew numbers, etc.?)

(¹ See also https://github.com/sphinx-doc/sphinx/issues/4133.)

-- 
Matthew

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Reply via email to