Support markdown template for html editor

chrome/common/extensions/docs/server2/content_provider.py

 # Copyright 2013 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
-
+import logging
 import mimetypes
 import os
 
 from compiled_file_system import SingleFile
 from directory_zipper import DirectoryZipper
 from docs_server_utils import ToUnicode
+from file_system import FileNotFoundError
 from future import Gettable, Future
 from third_party.handlebar import Handlebar
+from third_party.markdown import markdown
 
 
 class ContentAndType(object):
   '''Return value from ContentProvider.GetContentAndType.
   '''
 
   def __init__(self, content, content_type):
     self.content = content
     self.content_type = content_type
 
@@ skipping 25 matching lines @@
     self._supports_templates = supports_templates
     if supports_zip:
       self._directory_zipper = DirectoryZipper(compiled_fs_factory, file_system)
     else:
       self._directory_zipper = None
 
   @SingleFile
   def _CompileContent(self, path, text):
     assert text is not None, path
     mimetype = mimetypes.guess_type(path)[0]
-    if mimetype is None:
+    if os.path.splitext(path)[1] == '.md':
+      # markdown extensions' introduction in the following url
+      # http://pythonhosted.org/Markdown/extensions/index.html

[not at google - send to devlin, 2013/12/20 11:50:41]

Thanks for linking to this! Reading through them, it sounds like we don't want
all of these? Maybe just extra, headerid, and sane_lists for now.

And use (...) not [...].

[hukun, 2013/12/23 05:12:58]

Done

+      content = markdown(ToUnicode(text), extensions=['extra',
+          'admonition', 'codehilite', 'headerid', 'meta', 'nl2br',
+          'sane_lists', 'toc', 'wikilinks'])
+      if self._supports_templates:
+        content = Handlebar(content, name=path)
+      mimetype = 'text/html'
+    elif mimetype is None:
       content = text
       mimetype = 'text/plain'
     elif mimetype == 'text/html':
       content = ToUnicode(text)
       if self._supports_templates:
         content = Handlebar(content, name=path)
     elif (mimetype.startswith('text/') or
           mimetype in ('application/javascript', 'application/json')):
       content = ToUnicode(text)
     else:
       content = text
     return ContentAndType(content, mimetype)
 
+  def _MaybeMarkdown(self, path):
+    if os.path.splitext(path)[1] != '.html':
+      return path
+
+    try:
+      self.file_system.ReadSingle(path).Get()

[not at google - send to devlin, 2013/12/20 11:50:41]

I would prefer not to implement this with exception catching, so like,

file_list = self.file_system.ReadSingle(os.path.dirname(path)).Get()
...

use file_list to check for the existence of both the html and md files.

[hukun, 2013/12/23 05:12:58]

Done

+      return path
+    except FileNotFoundError:
+      md_file_path = path.replace('html', 'md')
+      try:
+        self.file_system.ReadSingle(md_file_path).Get()
+        logging.info('%s not found, try markdown templates at %s' % (path,
+            md_file_path))

[not at google - send to devlin, 2013/12/20 11:50:41]

don't worry about logging or anything, just let the normal control flow fail
later (which is why to just return |path| if path isn't even found).

[hukun, 2013/12/23 05:12:58]

Done

+        return md_file_path
+      except FileNotFoundError:
+        return path
+
   def GetContentAndType(self, path):
     path = path.lstrip('/')
     base, ext = os.path.splitext(path)
 
     # Check for a zip file first, if zip is enabled.
     if self._directory_zipper and ext == '.zip':
       zip_future = self._directory_zipper.Zip(base)
       return Future(delegate=Gettable(
           lambda: ContentAndType(zip_future.Get(), 'application/zip')))
 
-    return self._content_cache.GetFromFile(path)
+    return self._content_cache.GetFromFile(self._MaybeMarkdown(path))
 
   def Cron(self):
     # Running Refresh() on the file system is enough to pull GitHub content,
     # which is all we need for now while the full render-every-page cron step
     # is in effect.
     # TODO(kalman): Walk over the whole filesystem and compile the content.
     return self.file_system.Refresh()
 
   def __repr__(self):
     return 'ContentProvider of <%s>' % repr(self.file_system)