René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Documentation doesn't generate with docutils \u003e= 0.22","articleBody":"# Documentation\n\nThe html doc is not building with the new docutils \u003e= 0.22. It's not a problem yet, because the current Sphinx used (`sphinx~=8.2.0`) doesn't install the latest one, but it's something that should be fixed for the future.\n\nThe problem can be reproduced:\n\n```\n$ cd Doc\n$ python3 -m venv env\n$ source env/bin/activate\n$ pip install -r requirements.txt\n$ pip install -U docutils\n$ sphinx-build --pdb -b html . build/html\n[...]\n      File \"env/lib64/python3.13/site-packages/docutils/parsers/rst/states.py\", line 1494, in parse_enumerator\n        ordinal = int(self.enum.converters[sequence](text))\n    TypeError: int() argument must be a string, a bytes-like object or a real number, not 'NoneType'\n\n```\n\nThe actual problem is directly related to [this line in docutils](https://github.com/docutils/docutils/blob/master/docutils/docutils/parsers/rst/states.py#L1494), done as part as [this commit](https://github.com/docutils/docutils/commit/91f0dde5c35631918b17054d4ff9ed18b9be065d#diff-03d1bdebd24c00f33a6c8e1fdfebca24f772c26c3de9f1d1df2854d01090867aR1385).\n\nThey wrap the converters with `int` so the monkey patch done in [pyspecific.py](https://github.com/python/cpython/blob/main/Doc/tools/extensions/pyspecific.py#L27-L32) doesn't work anymore.\n\n```\n# monkey-patch reST parser to disable alphabetic and roman enumerated lists\nfrom docutils.parsers.rst.states import Body\nBody.enum.converters['loweralpha'] = \\\n    Body.enum.converters['upperalpha'] = \\\n    Body.enum.converters['lowerroman'] = \\\n    Body.enum.converters['upperroman'] = lambda x: None\n```\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-139258\n* gh-140031\n* gh-142090\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/danigm","@type":"Person","name":"danigm"},"datePublished":"2025-09-23T07:34:42.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":15},"url":"https://github.com/139257/cpython/issues/139257"}