add ModelChain tutorial, nbsphinx extension (#362)

* add modelchain.ipynb using nbsphinx

* fix code block overrun

* update whatsnew

* fix some references, minor edits

Author: wholmgren

docs/environment.yml

@@ -22,3 +22,4 @@ dependencies:
     - hdf4=4.2.12
     - sphinx_rtd_theme
     - docutils
+    - nbsphinx

docs/sphinx/source/conf.py

@@ -59,6 +59,7 @@ def __getattr__(cls, name):
     'sphinx.ext.autosummary',
     'IPython.sphinxext.ipython_directive',
     'IPython.sphinxext.ipython_console_highlighting',
+    'nbsphinx'
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -100,7 +101,7 @@ def __getattr__(cls, name):
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = ['whatsnew/*']
+exclude_patterns = ['whatsnew/*', '**.ipynb_checkpoints']
 
 # The reST default role (used for this markup: `text`) to use for all
 # documents.
@@ -316,3 +317,4 @@ def setup(app):
     'numpy': ('http://docs.scipy.org/doc/numpy/', None),
 }
 
+nbsphinx_allow_errors = True

docs/sphinx/source/index.rst

@@ -74,6 +74,7 @@ Contents
    whatsnew
    installation
    contributing
+   modelchain
    timetimezones
    clearsky
    forecasts