Varia's website, varia.zone or vvvvvvaria.org
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

47 lines
1.3 KiB

"""
HTML Entities for reStructured Text
===================================
Allows user to use HTML entities (©, •, etc.) in RST documents.
Usage:
:html_entity:`copy`
:html_entity:`149`
:html_entity:`#149`
"""
from __future__ import unicode_literals
from docutils import nodes, utils
from docutils.parsers.rst import roles
from pelican.readers import PelicanHTMLTranslator
import six
class html_entity(nodes.Inline, nodes.Node):
# Subclassing Node directly since TextElement automatically appends the escaped element
def __init__(self, rawsource, text):
self.rawsource = rawsource
self.text = text
self.children = []
self.attributes = {}
def astext(self):
return self.text
def entity_role(typ, rawtext, text, lineno, inliner, options={}, content=[]):
text = utils.unescape(text)
entity_code = text
try:
entity_code = "#{}".format(six.u(int(entity_code)))
except ValueError:
pass
entity_code = "&{};".format(entity_code)
return [html_entity(text, entity_code)], []
def register():
roles.register_local_role('html_entity', entity_role)
PelicanHTMLTranslator.visit_html_entity = lambda self, node: self.body.append(node.astext())
PelicanHTMLTranslator.depart_html_entity = lambda self, node: None