Skip to content

gh-139257: escape enumerator-like letters to support docutils 0.22 #140031

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
stefanor wants to merge 4 commits into from
Closed

gh-139257: escape enumerator-like letters to support docutils 0.22 #140031

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
799e7bb
gh-139257: docutils 0.22 support
stefanor Oct 13, 2025
220e71a
Replace the monkey patch to disable roman lists with an exception
stefanor Oct 13, 2025
85a5688
Use an explicitly named link
stefanor Oct 15, 2025
8e6c0cc
Render the FAQ local tables of contents for all media
stefanor Oct 15, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Replace the monkey patch to disable roman lists with an exception 
We don't have a single clean method to disable roman lists across
docutils versions, but we can blow up the bulid cleanly...
  • Loading branch information
@stefanor
stefanor committed Oct 15, 2025
commit 220e71a1d8beff48d9100843a30078a8b930ecd4
9 changes: 7 additions & 2 deletions Doc/tools/extensions/pyspecific.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,12 +24,17 @@
# Used in conf.py and updated here by python/release-tools/run_release.py
SOURCE_URI = 'https://github.com/python/cpython/tree/main/%s'

# monkey-patch reST parser to disable alphabetic and roman enumerated lists
# monkey-patch reST parser to detect any alphabetic and roman enumerated lists
# that need escaping. Sadly we don't get a location to point to.
from docutils.parsers.rst.states import Body
def disabled_converter(x):
raise Exception("Detected an alphabetic or Roman enumerated list. "
"It needs to be escaped.")

Body.enum.converters['loweralpha'] = \
Body.enum.converters['upperalpha'] = \
Body.enum.converters['lowerroman'] = \
Body.enum.converters['upperroman'] = lambda x: None
Body.enum.converters['upperroman'] = disabled_converter


class PyAwaitableMixin(object):
Expand Down