finish and publish "Gaydar Jamming"
[Ultimately_Untrue_Thought.git] / plugins / simple_footnotes.py
1 #!/usr/bin/env python
2 # -*- coding: utf-8 -*- #
3
4 # copied from getpelican/pelican-plugins@f15f42c6dba9
5
6 # with edits to add an <hr> and "Notes" header
7
8 from pelican import signals
9 import html5lib
10 import six
11
12 RAW_FOOTNOTE_CONTAINERS = ["code"]
13
14
15 def getText(node, recursive=False):
16     """Get all the text associated with this node.
17        With recursive == True, all text from child nodes is retrieved."""
18     L = [u'']
19     for n in node.childNodes:
20         if n.nodeType in (node.TEXT_NODE, node.CDATA_SECTION_NODE):
21             L.append(n.data)
22         else:
23             if not recursive:
24                 return None
25         L.append(getText(n, recursive))
26     return u''.join(L)
27
28
29 def sequence_gen(genlist):
30     for gen in genlist:
31         for elem in gen:
32             yield elem
33
34
35 def parse_for_footnotes(article_or_page_generator):
36     all_content = [
37         getattr(article_or_page_generator, attr, None) \
38         for attr in [u'articles', u'drafts', u'pages']]
39     all_content = [x for x in all_content if x is not None]
40     for article in sequence_gen(all_content):
41         if u"[ref]" in article._content and u"[/ref]" in article._content:
42             content = article._content.replace(u"[ref]", u"<x-simple-footnote>").replace(u"[/ref]",
43                                                                                          u"</x-simple-footnote>")
44             parser = html5lib.HTMLParser(tree=html5lib.getTreeBuilder(u"dom"))
45             dom = parser.parse(content)
46             endnotes = []
47             count = 0
48             for footnote in dom.getElementsByTagName(u"x-simple-footnote"):
49                 pn = footnote
50                 leavealone = False
51                 while pn:
52                     if pn.nodeName in RAW_FOOTNOTE_CONTAINERS:
53                         leavealone = True
54                         break
55                     pn = pn.parentNode
56                 if leavealone:
57                     continue
58                 count += 1
59
60                 short_slug = "-".join(article.slug.split('-')[:5])
61                 fnid = u"%s-note-%s" % (short_slug, count)
62                 fnbackid = u"%s-back" % (fnid,)
63                 endnotes.append((footnote, fnid, fnbackid))
64                 number = dom.createElement(u"sup")
65                 number.setAttribute(u"id", fnbackid)
66                 numbera = dom.createElement(u"a")
67                 numbera.setAttribute(u"href", u"#%s" % fnid)
68                 numbera.setAttribute(u"class", u"simple-footnote")
69                 numbera.appendChild(dom.createTextNode(six.text_type(count)))
70                 txt = getText(footnote, recursive=True).replace(u"\n", u" ")
71                 numbera.setAttribute(u"title", txt)
72                 number.appendChild(numbera)
73                 footnote.parentNode.insertBefore(number, footnote)
74             if endnotes:
75                 ol = dom.createElement(u"ol")
76                 ol.setAttribute(u"class", u"simple-footnotes")
77                 for e, fnid, fnbackid in endnotes:
78                     li = dom.createElement(u"li")
79                     li.setAttribute(u"id", fnid)
80                     while e.firstChild:
81                         li.appendChild(e.firstChild)
82                     backlink = dom.createElement(u"a")
83                     backlink.setAttribute(u"href", u"#%s" % fnbackid)
84                     backlink.setAttribute(u"class", u"simple-footnote-back")
85                     backlink.appendChild(dom.createTextNode(u'\u21a9'))
86                     li.appendChild(dom.createTextNode(u" "))
87                     li.appendChild(backlink)
88                     ol.appendChild(li)
89                     e.parentNode.removeChild(e)
90                 body = dom.getElementsByTagName(u"body")[0]
91                 body.appendChild(dom.createElement("hr"))
92                 notes_header = dom.createElement("p")
93                 notes_header.setAttribute("id", "notes-header")
94                 notes_header.appendChild(dom.createTextNode("Notes"))
95                 body.appendChild(notes_header)
96                 body.appendChild(ol)
97                 s = html5lib.serializer.HTMLSerializer(omit_optional_tags=False, quote_attr_values='legacy')
98                 output_generator = s.serialize(
99                     html5lib.treewalkers.getTreeWalker(u"dom")(dom.getElementsByTagName(u"body")[0]))
100                 article._content = u"".join(list(output_generator)).replace(
101                     u"<x-simple-footnote>", u"[ref]").replace(u"</x-simple-footnote>", u"[/ref]").replace(
102                     u"<body>", u"").replace(u"</body>", u"")
103
104
105 def register():
106     signals.article_generator_finalized.connect(parse_for_footnotes)
107     signals.page_generator_finalized.connect(parse_for_footnotes)