[WIP] Docs CI (#109)

* Add test for docs build

* Install nbsphinx with pip

* Revert "Install nbsphinx with pip"

This reverts commit 527a731.

* Add pandoc to requirements-dev

* Install pypandoc

As per: https://sphinx-gallery.github.io/stable/configuration.html#using-pypandoc-to-convert-rst-to-markdown

* install pandoc with apt-get

* Update docs workflow

* fix ref

* Fix workflow

as per: ammaraskar/sphinx-action#33

* alphabetize requirements-dev.txt

.github/workflows/docs.yml

@@ -1,19 +1,26 @@
 name: docs
 on:
   push:
-    branches:
-    - main
     paths:
     - 'docs/**'
 
 jobs:
-  docs:
+  test:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v1
     - uses: ammaraskar/sphinx-action@master
       with:
-        pre-build-command: "apt-get update -y && apt-get install -y nbsphinx"
+        pre-build-command: "apt-get install -y pandoc && python -m pip install -r requirements-dev.txt"
+        docs-folder: "docs/"
+  docs:
+    runs-on: ubuntu-latest
+    needs: test
+    if: github.ref == 'refs/heads/main'
+    steps:
+    - uses: ammaraskar/sphinx-action@master
+      with:
+        pre-build-command: "apt-get install -y pandoc && python -m pip install -r requirements-dev.txt"
         docs-folder: "docs/"
     - name: Commit documentation changes
       run: |

docs/source/data-access/R.ipynb

@@ -8,6 +8,14 @@
     "# R"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "5fcf5fc0",
+   "metadata": {},
+   "source": [
+    "[R](https://www.rstudio.com/) is a common programming language for data analysis and visualization. R provides easy access to various statiscal analysis libraries. We are going to use the R libraries: [sf](https://cran.r-project.org/web/packages/sf/vignettes/sf1.html) to load features, [dplyr](https://dplyr.tidyverse.org/) for data manipulation, and"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "7c41f82e-3b80-4907-9da7-9d5e4f546b10",

docs/source/installation.rst

@@ -8,7 +8,7 @@ wis2box is built for easy installation across various operating systems and envi
 Requirements and dependencies
 -----------------------------
 
-wis2box requires `Python`_ 3 and `Docker`_ 1.13.
+wis2box requires `Python`_ 3 and `Docker`_ 1.13+.
 
 Core dependencies are installed as containers in the Docker Compose deployment of wis2box. This
 is true for the software wis2box itself, which runs as a container orchestrating the necessary

requirements-dev.txt

@@ -1,6 +1,7 @@
 flake8
 jupyter
 nbsphinx
+pypandoc
 pytest
 sphinx
 twine