Merge pull request #531 from xylar/fix_the_docs_master

Update ReadTheDocs on master

Author: xylar

README.md

@@ -262,7 +262,9 @@ to be generated and is set up properly.
 
 To generate the `sphinx` documentation, run:
 ```bash
-conda install sphinx sphinx_rtd_theme numpydoc m2r tabulate
+conda env create -f docs/environment.yml
+conda activate mpas-analysis-docs
+python setup.py install
 cd docs
 make html
 ```

docs/conf.py

@@ -16,8 +16,13 @@
 import sys
 import m2r
 from glob import glob
-sys.path.insert(0, os.path.abspath('..'))
 import mpas_analysis
+# a hack to get basemap to work
+on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
+if on_rtd:
+    os.environ['PROJ_LIB'] = '{}/{}/share/proj'.format(
+            os.environ['CONDA_ENVS_PATH'], os.environ['CONDA_DEFAULT_ENV'])
+from mpas_analysis.__main__ import add_task_and_subtasks
 from docs.parse_table import build_rst_table_from_xml, build_obs_pages_from_xml
 from docs.parse_quick_start import build_quick_start
 

docs/environment.yml

@@ -2,7 +2,7 @@ name: mpas-analysis-docs
 channels:
   - conda-forge
 dependencies:
-  - python=3.6
+  - python=3.7
   - pytest
   - numpy
   - scipy
@@ -24,3 +24,4 @@ dependencies:
   - numpydoc
   - tabulate >= 0.8.2
   - m2r
+  - shapely

readthedocs.yml

@@ -1,10 +1,10 @@
 conda:
     file: docs/environment.yml
 build:
-    image: latest
+   image: latest
 python:
-   version: 3.6
-   setup_py_install: false
+   version: 3.7
+   setup_py_install: true
 # Build PDF
 formats:
     - pdf