forked from varia/varia.website
47 lines
1.3 KiB
Python
47 lines
1.3 KiB
Python
"""
|
|
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
|