Add separate github action to build & publish docs

Fix syntax in build script for python wrapper in conda recipe

Author: langmm

.github/workflows/test-suite.yml

@@ -168,10 +168,6 @@ jobs:
         run: |
           conda info
           conda list
-      - name: Install doxgen on unix systems
-        if: matrix.os != 'windows-latest'
-        run: |
-          conda install doxygen>=1.9.2 graphviz -y
       - name: Install compilers using conda on Linux/Mac
         if: matrix.os != 'windows-latest' && matrix.with-valgrind != true
         run: |
@@ -353,14 +349,6 @@ jobs:
         run: |
           pytest -sv tests/python
 
-      ###################################
-      # Docs tests
-      ###################################
-      - name: Build docs
-        if: matrix.os != 'windows-latest'
-        run: |
-          python scripts/devtasks.py docs --rebuild
-      
       ###################################
       # Coverage
       ###################################
@@ -372,3 +360,44 @@ jobs:
           token: ${{ secrets.CODECOV_TOKEN }}
           file: coverage/coverage.info
           functionalities: gcov
+
+  #######################################
+  # Build & Publish docs
+  #######################################
+  docs:
+    name: Build/Publish the Docs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: true
+      - name: Get tags required by setuptools_scm to generate version
+        run: |
+          git fetch --prune --unshallow
+          git fetch --depth=1 origin +refs/tags/*:refs/tags/*
+      - name: Set up miniconda test environment
+        if: matrix.with-mpi == false
+        uses: conda-incubator/setup-miniconda@v3
+        with:
+          activate-environment: ephoto
+          environment-file: environment.yml
+          auto-update-conda: true
+          channels: conda-forge
+          channel-priority: strict
+          miniforge-variant: Miniforge3
+          miniforge-version: latest
+          conda-remove-defaults: true
+      - name: Install doc dependencies
+        run: |
+          conda install -f environment_docs.yml
+      - name: Build docs
+        if: matrix.os != 'windows-latest'
+        run: |
+          python scripts/devtasks.py docs --rebuild
+      - name: Publish docs to Github pages
+        # if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags')
+        uses: JamesIves/github-pages-deploy-action@3.7.1
+        with:
+          # GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          BRANCH: gh-pages
+          FOLDER: build/doc/html/

recipe/meta.yaml

@@ -19,7 +19,7 @@ build:
 # TODO: Add Python wrapper as export?
 outputs:
   - name: ephotosynthesis
-    version:  {{ version }}
+    version: {{ version }}
     script: build_cpp.sh  # [unix]
     script: bld_cpp.bat  # [win]
     about:
@@ -55,8 +55,8 @@ outputs:
         - if not exist %LIBRARY_INC%\\ePhotosynthesis\\ePhotosynthesis.hpp exit 1  # [win]
         - if not exist %LIBRARY_BIN%\\ePhoto.exe exit 1  # [win]
   - name: pyphotosynthesis
-    version:  {{ version }}
-    script: '{{ PYTHON }} -m pip install . --no-deps --ignore-installed --no-cache-dir -vvv '
+    version: {{ version }}
+    script: python -m pip install . --no-deps --ignore-installed --no-cache-dir -vvv 
     about:
       summary:
       description: |