Made project buildable with rtd

- removed markdown support for documentation, because of import
difficulties.
- converted `intro.md` to restructured text `intro.rst`
- added requirements_rtd.txt that lists the required packages for rtd to
build the documentation.

Signed-off-by: Claudius Heine <ch@denx.de>

docs/conf.py

@@ -21,7 +21,6 @@
 #
 import os
 import sys
-from recommonmark.parser import CommonMarkParser
 
 # Add the project directory to the path, in order to include it:
 sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), "..")))
@@ -51,16 +50,12 @@ templates_path = ['_templates']
 # You can specify multiple suffix as a list of string:
 #
 # source_suffix = ['.rst', '.md']
-source_suffix = ['.rst', '.md']
+source_suffix = ['.rst']
 
 # The encoding of source files.
 #
 # source_encoding = 'utf-8-sig'
 
-source_parsers = {
-    '.md': CommonMarkParser,
-}
-
 # The master toctree document.
 master_doc = 'index'
 

docs/intro.rst

@@ -11,12 +11,14 @@ project configuration file and does the download and configuration
 phase.
 
 Currently supported Yocto versions:
+
 - 2.1 (Krogoth)
 - 2.2 (Morty)
 
 Older or newer versions may work as well but haven't been tested intensively.
 
 Key features provided by the build tool:
+
 - clone and checkout bitbake layers
 - create default bitbake settings (machine, arch, ...)
 - launch minimal build environment, reducing risk of host contamination

requirements_rtd.txt

@@ -0,0 +1,3 @@
+sphinx>=1.2.0
+CommonMark>=0.5.6
+sphinx-argparse>=0.2.1