CI: Build docs with GitHub Actions (#190)

.github/workflows/build_docs.yaml

@@ -0,0 +1,52 @@
+name: Publish Docs
+
+on:
+  push:
+    branches: [ master ]
+  release:
+    types: [ created ]
+
+jobs:
+  docs:
+    name: Publish Docs
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          persist-credentials: false
+
+      - name: Setup Conda
+        uses: s-weigand/setup-conda@v1
+        with:
+          activate-conda: false
+          python-version: 3.8
+          conda-channels: conda-forge
+
+      - name: Install and Build
+        shell: bash
+        run: |
+          conda create -n docs python=3.8 rasterio xarray scipy pyproj pandoc
+          source activate docs
+          python -m pip install -e .[doc]
+          sphinx-build -b html docs/ docs/_build/
+
+      - name: Deploy 🚀
+        uses: JamesIves/[email protected]
+        if: ${{ github.event_name == 'release' }}
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          BRANCH: gh-pages
+          FOLDER: docs/_build/
+          CLEAN: false
+          TARGET_FOLDER: ${{ github.ref }}
+
+      - name: Deploy 🚀
+        uses: JamesIves/[email protected]
+        if: ${{ github.event_name == 'push' }}
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          BRANCH: gh-pages
+          FOLDER: docs/_build/
+          CLEAN: false
+          TARGET_FOLDER: latest

setup.py

@@ -27,19 +27,19 @@ def get_version():
 requirements = ["rasterio", "scipy", "xarray", "pyproj>=2.2"]
 
 test_requirements = ["pytest>=3.6", "pytest-cov", "mock", "dask"]
+doc_requirements = ["sphinx-click==1.1.0", "nbsphinx", "sphinx_rtd_theme"]
 
 extras_require = {
+    "doc": doc_requirements,
     "dev": test_requirements
+    + doc_requirements
     + [
-        "sphinx-click==1.1.0",
-        "nbsphinx",
-        "sphinx_rtd_theme",
         "black",
         "flake8",
         "pylint",
         "isort",
         "pre-commit",
-    ]
+    ],
 }
 extras_require["all"] = list(chain.from_iterable(extras_require.values()))