Index: third_party/Python-Markdown/markdown/extensions/admonition.py |
diff --git a/third_party/Python-Markdown/markdown/extensions/admonition.py b/third_party/Python-Markdown/markdown/extensions/admonition.py |
new file mode 100644 |
index 0000000000000000000000000000000000000000..76e0fb588c842f80164a8ca118bf13fd753bd568 |
--- /dev/null |
+++ b/third_party/Python-Markdown/markdown/extensions/admonition.py |
@@ -0,0 +1,96 @@ |
+""" |
+Admonition extension for Python-Markdown |
+======================================== |
+ |
+Adds rST-style admonitions. Inspired by [rST][] feature with the same name. |
+ |
+[rST]: http://docutils.sourceforge.net/docs/ref/rst/directives.html#specific-admonitions # noqa |
+ |
+See <https://pythonhosted.org/Markdown/extensions/admonition.html> |
+for documentation. |
+ |
+Original code Copyright [Tiago Serafim](http://www.tiagoserafim.com/). |
+ |
+All changes Copyright The Python Markdown Project |
+ |
+License: [BSD](http://www.opensource.org/licenses/bsd-license.php) |
+ |
+""" |
+ |
+from __future__ import absolute_import |
+from __future__ import unicode_literals |
+from . import Extension |
+from ..blockprocessors import BlockProcessor |
+from ..util import etree |
+import re |
+ |
+ |
+class AdmonitionExtension(Extension): |
+ """ Admonition extension for Python-Markdown. """ |
+ |
+ def extendMarkdown(self, md, md_globals): |
+ """ Add Admonition to Markdown instance. """ |
+ md.registerExtension(self) |
+ |
+ md.parser.blockprocessors.add('admonition', |
+ AdmonitionProcessor(md.parser), |
+ '_begin') |
+ |
+ |
+class AdmonitionProcessor(BlockProcessor): |
+ |
+ CLASSNAME = 'admonition' |
+ CLASSNAME_TITLE = 'admonition-title' |
+ RE = re.compile(r'(?:^|\n)!!!\ ?([\w\-]+)(?:\ "(.*?)")?') |
+ |
+ def test(self, parent, block): |
+ sibling = self.lastChild(parent) |
+ return self.RE.search(block) or \ |
+ (block.startswith(' ' * self.tab_length) and sibling is not None and |
+ sibling.get('class', '').find(self.CLASSNAME) != -1) |
+ |
+ def run(self, parent, blocks): |
+ sibling = self.lastChild(parent) |
+ block = blocks.pop(0) |
+ m = self.RE.search(block) |
+ |
+ if m: |
+ block = block[m.end() + 1:] # removes the first line |
+ |
+ block, theRest = self.detab(block) |
+ |
+ if m: |
+ klass, title = self.get_class_and_title(m) |
+ div = etree.SubElement(parent, 'div') |
+ div.set('class', '%s %s' % (self.CLASSNAME, klass)) |
+ if title: |
+ p = etree.SubElement(div, 'p') |
+ p.text = title |
+ p.set('class', self.CLASSNAME_TITLE) |
+ else: |
+ div = sibling |
+ |
+ self.parser.parseChunk(div, block) |
+ |
+ if theRest: |
+ # This block contained unindented line(s) after the first indented |
+ # line. Insert these lines as the first block of the master blocks |
+ # list for future processing. |
+ blocks.insert(0, theRest) |
+ |
+ def get_class_and_title(self, match): |
+ klass, title = match.group(1).lower(), match.group(2) |
+ if title is None: |
+ # no title was provided, use the capitalized classname as title |
+ # e.g.: `!!! note` will render |
+ # `<p class="admonition-title">Note</p>` |
+ title = klass.capitalize() |
+ elif title == '': |
+ # an explicit blank title should not be rendered |
+ # e.g.: `!!! warning ""` will *not* render `p` with a title |
+ title = None |
+ return klass, title |
+ |
+ |
+def makeExtension(*args, **kwargs): |
+ return AdmonitionExtension(*args, **kwargs) |