convert modelchain.ipynb to rst, remove nbsphinx (#568)

* convert modelchain.ipynb to rst, remove nbsphinx

* some clean up

* remove ipywidgets and docutils from doc env

* remove outdated section

* hacks to make other pages compile

* other doc clean up

* 3 spaces for directive options

* use bare .. ipython:: (no python)

* enabled install option on rtd. now removing previously added output

Author: wholmgren

docs/environment.yml

@@ -13,13 +13,10 @@ dependencies:
     - ephem
     - numba
     - ipython=6.3
-    - ipywidgets
     - numpydoc
     - matplotlib=2.2.2
     - siphon=0.7.0
     - sphinx=1.7.2
     - netCDF4=1.3.1
     - hdf4=4.2.12
     - sphinx_rtd_theme
-    - docutils
-    - nbsphinx

docs/sphinx/source/conf.py

@@ -58,8 +58,7 @@ def __getattr__(cls, name):
     'numpydoc',
     'sphinx.ext.autosummary',
     'IPython.sphinxext.ipython_directive',
-    'IPython.sphinxext.ipython_console_highlighting',
-    'nbsphinx'
+    'IPython.sphinxext.ipython_console_highlighting'
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -312,7 +311,7 @@ def setup(app):
 
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {
-    'python': ('https://docs.python.org/3.5/', None),
+    'python': ('https://docs.python.org/3.7/', None),
     'pandas': ('http://pandas.pydata.org/pandas-docs/stable/', None),
     'numpy': ('http://docs.scipy.org/doc/numpy/', None),
 }