Merge pull request #69 from dib-lab/fix/doc_build

Fix release notes generation; add recommonmark dependency

Makefile

@@ -15,6 +15,7 @@ all:
 
 install-dependencies:
 	pip install --upgrade $(DEVPKGS) || pip2 install --upgrade $(DEVPKGS)
+	pip install --upgrade --requirement doc/requirements.txt
 
 install: FORCE
 	./setup.py build install

doc/conf.py

@@ -15,6 +15,8 @@
 import sys
 import os
 
+from recommonmark.parser import CommonMarkParser
+
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
@@ -32,8 +34,12 @@
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
+source_parsers = {
+    '.md': CommonMarkParser,
+}
+
 # The suffix of source filenames.
-source_suffix = '.rst'
+source_suffix = ['.rst', '.md']
 
 # The encoding of source files.
 # source_encoding = 'utf-8-sig'

doc/release-notes/index.rst

@@ -8,5 +8,7 @@ Contents:
 .. toctree::
    :maxdepth: 1
 
-   RELEASE-0.5
+   RELEASE-1.0
+   RELEASE-0.9
    RELEASE-0.8
+   RELEASE-0.5

doc/requirements.txt

@@ -0,0 +1 @@
+recommonmark==0.4.0