Plot building Github Action (#2377)

* implement conda package building

* paths

* need libtool

* PLATFORM check

* point to my PROJ feedstock for now

* point to PROJ repos

* plot building and artifact upload

* syntax

* add proj conda package for plotting

* retab

* no doxygen

* syntax

* update docs Makefile

* doc building

* needs

* consolidate doc/plots

* plot updates

* put updated plot output into docs

* register spelling module

* use v2 download-artifact

* artifact upload

1 files changed, 83 insertions, 11 deletions

diff --git a/.github/workflows/doc_build.yml b/.github/workflows/doc_build.yml
index 4a919fa8..fa4546b2 100644
--- a/.github/workflows/doc_build.yml
+++ b/.github/workflows/doc_build.yml
@@ -1,21 +1,93 @@
-name: Doc building
+name: Docs
 
 on: [push, pull_request]
 
 jobs:
-
-  doc_building:
+  plots:
+    name: Plots
     runs-on: ubuntu-latest
+    env:
+      PROJ_EXE: proj
     steps:
       - name: Checkout
         uses: actions/checkout@v2
-
-      - name: Install Requirements
+      - uses: goanpeca/setup-miniconda@v1
+        with:
+          channels: conda-forge
+          auto-update-conda: true
+      - name: Setup
+        shell: bash -l {0}
         run: |
-          sudo apt update
-          sudo apt install -y python3-pip python3-setuptools python3-dev python3-wheel doxygen gcc
-          sudo pip3 install sphinx sphinx-rtd-theme sphinxcontrib-bibtex breathe
-
-      - name: Build doc
+            conda update -n base -c defaults conda
+            conda install descartes shapely geopandas matplotlib proj
+      - name: Plot
+        shell: bash -l {0}
+        working-directory: ./docs/plot
         run: |
-            (cd docs; make html)
+            ./plot.sh
+
+      - uses: actions/upload-artifact@v2
+        with:
+          name: Images
+          path: docs/plot/images
+
+  docs:
+    name: Docs
+
+    needs: [plots]
+
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+    container: osgeo/proj-docs
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Print versions
+      shell: bash -l {0}
+      run: |
+          python3 --version
+          sphinx-build --version
+    - uses: actions/download-artifact@v2
+      name: Images
+      with:
+        name: Images
+        path: ./docs/source/operations/projections/images
+    - name: Lint .rst files
+      shell: bash -l {0}
+      run: |
+        if find . -name '*.rst' | xargs grep -P '\t'; then echo 'Tabs are bad, please use four spaces in .rst files.'; false; fi
+      working-directory: ./docs
+    - name: Doxygen
+      shell: bash -l {0}
+      run: |
+        mkdir -p docs/build
+        doxygen Doxyfile
+    - name: HTML
+      shell: bash -l {0}
+      run: |
+        make html
+      working-directory: ./docs
+    - name: PDF
+      shell: bash -l {0}
+      run: |
+        make latexpdf
+      working-directory: ./docs
+    - name: Spelling
+      shell: bash -l {0}
+      run: |
+        make spelling
+      working-directory: ./docs
+    - uses: actions/upload-artifact@v2
+      with:
+        name: PDF
+        path: docs/build/latex/proj.pdf
+    - uses: actions/upload-artifact@v2
+      with:
+        name: HTML
+        path: docs/build/html/*
+    - uses: actions/upload-artifact@v2
+      with:
+        name: Misspelled
+        path: docs/build/spelling/output.txt
+