Fixes fossasia#311 Add support for markdown constructs not in commonmark

modules/scripts/markdown.py

@@ -0,0 +1,21 @@
+import re
+from recommonmark.parser import CommonMarkParser
+from md2rst import md2rst
+
+
+MARKDOWN_PLUS_REGEX = re.compile('<!--\s+markdown\+\s+-->(.*?)<!--\s+endmarkdown\+\s+-->', re.DOTALL)
+EVAL_RST_TEMPLATE = "```eval_rst\n{content}\n```"
+
+
+def preprocess_markdown(inputstring):
+    def callback(match_object):
+        text = match_object.group(1)
+        return EVAL_RST_TEMPLATE.format(content=md2rst(text))
+
+    return re.sub(MARKDOWN_PLUS_REGEX, callback, inputstring)
+
+
+class MarkdownParser(CommonMarkParser):
+    def parse(self, inputstring, document):
+        content = preprocess_markdown(inputstring)
+        CommonMarkParser.parse(self, content, document)

modules/templates/conf.py_t

@@ -38,14 +38,14 @@ import os
 import sys
 import mock
 import pkg_resources
-from recommonmark.parser import CommonMarkParser
 from recommonmark.transform import AutoStructify
 
 # Adding scripts and extensions directory to sys.path
 sys.path.insert(0, os.path.abspath('scripts'))
 sys.path.insert(0, os.path.join(os.path.abspath('scripts'), 'extensions'))
 
 from config.serializer import deserialize
+from markdown import MarkdownParser
 
 {% if autoapi_python == true %}
 for (dirpath, dirnames, filenames) in os.walk('{{ root_dir }}'):
@@ -107,7 +107,7 @@ templates_path = ['{{ dot }}templates']
 
 # The parser(s) of source files
 source_parsers = {
-    '.md': CommonMarkParser,
+    '.md': MarkdownParser,
 }
 
 # The suffix(es) of source filenames.