Add markdown support, with example.

Signed-off-by: Tim Callahan <tcal@google.com>

docs/source/.gitattributes

@@ -0,0 +1,3 @@
+*.png binary
+*.gif binary
+*.jpg binary

docs/source/.gitignore

@@ -0,0 +1 @@
+_build

docs/source/conf.py

@@ -34,6 +34,8 @@
 import sys
 sys.path.insert(0, os.path.abspath('.'))
 
+from recommonmark.parser import CommonMarkParser
+
 # -- Project information -----------------------------------------------------
 
 project = u'CFU-Playground'
@@ -48,8 +50,16 @@
 extensions = [
     'sphinx_tabs.tabs',
     'sphinxcontrib.jinja',
+    'recommonmark',
 ]
 
+source_parsers = {
+    '.md': CommonMarkParser,
+}
+
+source_suffix = ['.rst', '.md']
+
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
@@ -73,8 +83,8 @@
 html_theme = 'sphinx_material'
 html_theme_options = {
     'nav_title': project,
-    'color_primary': 'deep-purple',
-    'color_accent': 'purple',
+    'color_primary': 'orange',
+    'color_accent': 'gray',
     'repo_name': "google/CFU-Playground",
     'repo_url': 'https://github.com/google/CFU-Playground',
     'globaltoc_depth': 2,

docs/source/index.rst

@@ -10,6 +10,8 @@ Welcome to CFU-Playground's documentation!
    :maxdepth: 2
    :caption: Contents:
 
+   md_example
+
 
 
 Indices and tables

docs/source/md_example.md

@@ -0,0 +1,35 @@
+
+# Markdown Example Title
+
+This file is written using Markdown.
+
+## Section Header
+
+Let's try some code:
+
+```python
+
+    def __init__(self, width=32):
+        super().__init__()
+        self.value = Signal(width)
+        self.set = Signal()
+
+    def elab(self, m):
+        m.d.sync += self.set.eq(0)
+        with m.If(self.start):
+            m.d.sync += self.value.eq(self.in0),
+            m.d.sync += self.set.eq(1),
+            m.d.comb += self.output.eq(self.value)
+            m.d.comb += self.done.eq(1)
+
+
+```
+
+### Subsection Header
+
+We have a list.
+
+* item1
+* item2
+* item3
+