Spaces:
Paused
Paused
| # Python Markdown | |
| # A Python implementation of John Gruber's Markdown. | |
| # Documentation: https://python-markdown.github.io/ | |
| # GitHub: https://github.com/Python-Markdown/markdown/ | |
| # PyPI: https://pypi.org/project/Markdown/ | |
| # Started by Manfred Stienstra (http://www.dwerg.net/). | |
| # Maintained for a few years by Yuri Takhteyev (http://www.freewisdom.org). | |
| # Currently maintained by Waylan Limberg (https://github.com/waylan), | |
| # Dmitry Shachnev (https://github.com/mitya57) and Isaac Muse (https://github.com/facelessuser). | |
| # Copyright 2007-2023 The Python Markdown Project (v. 1.7 and later) | |
| # Copyright 2004, 2005, 2006 Yuri Takhteyev (v. 0.2-1.6b) | |
| # Copyright 2004 Manfred Stienstra (the original version) | |
| # License: BSD (see LICENSE.md for details). | |
| """ | |
| An extension to Python Markdown which implements legacy attributes. | |
| Prior to Python-Markdown version 3.0, the Markdown class had an `enable_attributes` | |
| keyword which was on by default and provided for attributes to be defined for elements | |
| using the format `{@key=value}`. This extension is provided as a replacement for | |
| backward compatibility. New documents should be authored using `attr_lists`. However, | |
| numerous documents exist which have been using the old attribute format for many | |
| years. This extension can be used to continue to render those documents correctly. | |
| """ | |
| from __future__ import annotations | |
| import re | |
| from markdown.treeprocessors import Treeprocessor, isString | |
| from markdown.extensions import Extension | |
| from typing import TYPE_CHECKING | |
| if TYPE_CHECKING: # pragma: no cover | |
| import xml.etree.ElementTree as etree | |
| ATTR_RE = re.compile(r'\{@([^\}]*)=([^\}]*)}') # {@id=123} | |
| class LegacyAttrs(Treeprocessor): | |
| def run(self, doc: etree.Element) -> None: | |
| """Find and set values of attributes ({@key=value}). """ | |
| for el in doc.iter(): | |
| alt = el.get('alt', None) | |
| if alt is not None: | |
| el.set('alt', self.handleAttributes(el, alt)) | |
| if el.text and isString(el.text): | |
| el.text = self.handleAttributes(el, el.text) | |
| if el.tail and isString(el.tail): | |
| el.tail = self.handleAttributes(el, el.tail) | |
| def handleAttributes(self, el: etree.Element, txt: str) -> str: | |
| """ Set attributes and return text without definitions. """ | |
| def attributeCallback(match: re.Match[str]): | |
| el.set(match.group(1), match.group(2).replace('\n', ' ')) | |
| return ATTR_RE.sub(attributeCallback, txt) | |
| class LegacyAttrExtension(Extension): | |
| def extendMarkdown(self, md): | |
| """ Add `LegacyAttrs` to Markdown instance. """ | |
| md.treeprocessors.register(LegacyAttrs(md), 'legacyattrs', 15) | |
| def makeExtension(**kwargs): # pragma: no cover | |
| return LegacyAttrExtension(**kwargs) | |