e91bda7e5e
* refactor: isolate bleach code * refactor: move html fns to html.py * refactor: lose the bleach.py module; refactor * refactor: sanitize_document -> clean_html Drops <meta charset="utf-8"> addition after cleaning. * fix: disambiguate import * feat: restore <meta charset="utf-8"> tag * chore: comments * chore(deps): drop lxml_html_clean package * refactor: on second thought, no meta charset * refactor: sanitize_fragment -> clean_html * test: remove check for charset * chore: fix lint
70 lines
1.9 KiB
Python
70 lines
1.9 KiB
Python
# Copyright The IETF Trust 2021, All Rights Reserved
|
|
# -*- coding: utf-8 -*-
|
|
"""Markdown wrapper
|
|
|
|
Use this instead of importing markdown directly to guarantee consistent extensions / options through
|
|
the datatracker.
|
|
"""
|
|
import markdown as python_markdown
|
|
from markdown.extensions import Extension
|
|
from markdown.postprocessors import Postprocessor
|
|
|
|
from django.utils.safestring import mark_safe
|
|
|
|
from ietf.doc.templatetags.ietf_filters import urlize_ietf_docs
|
|
from .html import clean_html, liberal_clean_html
|
|
from .text import linkify
|
|
|
|
|
|
|
|
class LinkifyExtension(Extension):
|
|
"""
|
|
Simple Markdown extension inspired by https://github.com/daGrevis/mdx_linkify,
|
|
but using our own linker directly. Doing the linkification on the converted
|
|
Markdown output introduces artifacts.
|
|
"""
|
|
|
|
def extendMarkdown(self, md):
|
|
md.postprocessors.register(LinkifyPostprocessor(md), "linkify", 50)
|
|
# disable automatic links via angle brackets for email addresses
|
|
md.inlinePatterns.deregister("automail")
|
|
# "autolink" for URLs does not seem to cause issues, so leave it on
|
|
|
|
|
|
class LinkifyPostprocessor(Postprocessor):
|
|
def run(self, text):
|
|
return urlize_ietf_docs(linkify(text))
|
|
|
|
|
|
def markdown(text):
|
|
return mark_safe(
|
|
clean_html(
|
|
python_markdown.markdown(
|
|
text,
|
|
extensions=[
|
|
"extra",
|
|
"nl2br",
|
|
"sane_lists",
|
|
"toc",
|
|
LinkifyExtension(),
|
|
],
|
|
)
|
|
)
|
|
)
|
|
|
|
def liberal_markdown(text):
|
|
return mark_safe(
|
|
liberal_clean_html(
|
|
python_markdown.markdown(
|
|
text,
|
|
extensions=[
|
|
"extra",
|
|
"nl2br",
|
|
"sane_lists",
|
|
"toc",
|
|
LinkifyExtension(),
|
|
],
|
|
)
|
|
)
|
|
)
|