Merge pull request #1228 from acrobat/docs-config-fixes

Doc config changes

docs/REAME.md

@@ -3,6 +3,18 @@ Documentation
 
 Project documentation is built using [Sphinx docs](http://sphinx-doc.org/), which uses [ReST](http://docutils.sf.net/rst.html) for markup.  This allows the docs to cover a vast amount of topics without using a thousand-line README file.
 
-Sphinx docs is pip-installable via `pip install sphinx`.  Once installed, open a command line in the docs folder and run `make html`; the output files will be placed in the `_build/html/` directory, and can be browsed (locally) with any browser.
+Sphinx docs is pip-installable via `pip install sphinx`.  Once installed, open a command line in the docs folder and run the following commands:
+
+```bash
+$ sudo pip install -r requirements.txt
+```
+
+This will install the requirements needed for the generating the docs. Afterwards you can run 
+
+```bash
+$ make html
+```
+
+The docs will be generated, the output files will be placed in the `_build/html/` directory, and can be browsed (locally) with any browser.
 
 The docs can also be found online at http://bootstrap-datepicker.readthedocs.org/.

docs/conf.py

@@ -22,7 +22,7 @@
 # The full version, including alpha/beta/rc tags.
 #release = ''
 
-
+import sphinx_rtd_theme
 
 # 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
@@ -105,7 +105,8 @@
 #html_theme_options = {}
 
 # Add any paths that contain custom themes here, relative to this directory.
-html_theme_path = ['_themes',]
+# html_theme_path = ['_themes',]
+html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".

docs/requirements.txt

@@ -0,0 +1 @@
+sphinx_rtd_theme