mirror of https://github.com/python/cpython
GH-121970: Remove ``escape4chm`` (#122065)
This commit is contained in:
parent
1bcc9eb862
commit
53e9e7de63
|
@ -5,7 +5,6 @@ line-length = 79
|
||||||
extend-exclude = [
|
extend-exclude = [
|
||||||
"includes/*",
|
"includes/*",
|
||||||
# Temporary exclusions:
|
# Temporary exclusions:
|
||||||
"tools/extensions/escape4chm.py",
|
|
||||||
"tools/extensions/pyspecific.py",
|
"tools/extensions/pyspecific.py",
|
||||||
]
|
]
|
||||||
|
|
||||||
|
|
|
@ -21,7 +21,6 @@ from pyspecific import SOURCE_URI
|
||||||
|
|
||||||
extensions = [
|
extensions = [
|
||||||
'c_annotations',
|
'c_annotations',
|
||||||
'escape4chm',
|
|
||||||
'glossary_search',
|
'glossary_search',
|
||||||
'lexers',
|
'lexers',
|
||||||
'pyspecific',
|
'pyspecific',
|
||||||
|
|
|
@ -1,58 +0,0 @@
|
||||||
"""
|
|
||||||
Escape the `body` part of .chm source file to 7-bit ASCII, to fix visual
|
|
||||||
effect on some MBCS Windows systems.
|
|
||||||
|
|
||||||
https://bugs.python.org/issue32174
|
|
||||||
"""
|
|
||||||
|
|
||||||
import pathlib
|
|
||||||
import re
|
|
||||||
from html.entities import codepoint2name
|
|
||||||
|
|
||||||
from sphinx.util.logging import getLogger
|
|
||||||
|
|
||||||
# escape the characters which codepoint > 0x7F
|
|
||||||
def _process(string):
|
|
||||||
def escape(matchobj):
|
|
||||||
codepoint = ord(matchobj.group(0))
|
|
||||||
|
|
||||||
name = codepoint2name.get(codepoint)
|
|
||||||
if name is None:
|
|
||||||
return '&#%d;' % codepoint
|
|
||||||
else:
|
|
||||||
return '&%s;' % name
|
|
||||||
|
|
||||||
return re.sub(r'[^\x00-\x7F]', escape, string)
|
|
||||||
|
|
||||||
def escape_for_chm(app, pagename, templatename, context, doctree):
|
|
||||||
# only works for .chm output
|
|
||||||
if getattr(app.builder, 'name', '') != 'htmlhelp':
|
|
||||||
return
|
|
||||||
|
|
||||||
# escape the `body` part to 7-bit ASCII
|
|
||||||
body = context.get('body')
|
|
||||||
if body is not None:
|
|
||||||
context['body'] = _process(body)
|
|
||||||
|
|
||||||
def fixup_keywords(app, exception):
|
|
||||||
# only works for .chm output
|
|
||||||
if getattr(app.builder, 'name', '') != 'htmlhelp' or exception:
|
|
||||||
return
|
|
||||||
|
|
||||||
getLogger(__name__).info('fixing HTML escapes in keywords file...')
|
|
||||||
outdir = pathlib.Path(app.builder.outdir)
|
|
||||||
outname = app.builder.config.htmlhelp_basename
|
|
||||||
with open(outdir / (outname + '.hhk'), 'rb') as f:
|
|
||||||
index = f.read()
|
|
||||||
with open(outdir / (outname + '.hhk'), 'wb') as f:
|
|
||||||
f.write(index.replace(b''', b'''))
|
|
||||||
|
|
||||||
def setup(app):
|
|
||||||
# `html-page-context` event emitted when the HTML builder has
|
|
||||||
# created a context dictionary to render a template with.
|
|
||||||
app.connect('html-page-context', escape_for_chm)
|
|
||||||
# `build-finished` event emitted when all the files have been
|
|
||||||
# output.
|
|
||||||
app.connect('build-finished', fixup_keywords)
|
|
||||||
|
|
||||||
return {'version': '1.0', 'parallel_read_safe': True}
|
|
Loading…
Reference in New Issue