[REMOVE LATER] Trigger errors when HTML style comments are used

python/MooseDocs/extensions/comment.py

@@ -9,6 +9,9 @@
 import re
 from ..base import components, Extension
 from ..tree import tokens
+import logging
+
+LOG = logging.getLogger(__name__)
 
 def make_extension(**kwargs):
     return CommentExtension(**kwargs)
@@ -25,6 +28,7 @@ def defaultConfig():
         return config
 
     def extend(self, reader, renderer):
+        reader.addInline(HTMLCommentBlock(), location='_begin')
         reader.addInline(CommentInline(), location='_begin')
         reader.addBlock(CommentBlock(), location='_begin')
 
@@ -37,6 +41,18 @@ def createToken(self, parent, info, page, settings):
         Comment(parent, content=info['content'])
         return parent
 
+class HTMLCommentBlock(components.ReaderComponent):
+    """
+    HTML style comments (deprecated)
+    """
+    # TODO: Remove this in favor of !!! version
+    RE = re.compile(r'<!--(?P<content>.*?)-->', flags=re.UNICODE|re.MULTILINE|re.DOTALL)
+
+    def createToken(self, parent, info, page, settings):
+        LOG.error("Use of HTML style comments detected on page %s!", page)
+        Comment(parent, content=info['content'])
+        return parent
+
 class CommentBlock(components.ReaderComponent):
     """
     Block comments begin and end with !!! that start a line to !!! that end a line.