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