WIP: RTD stub

Author: thewtex

.github/workflows/Doxygen.yml

@@ -9,28 +9,56 @@ on:
 jobs:
   doxygen:
 
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
 
     steps:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
+
       - name: Build Docker Image for Doxygen
         run: |
           docker build -f Dockerfile -t itk-doxygen .
+
       - name: Docker Doxygen generation
         run: |
           docker run --name itk-dox itk-doxygen
           mkdir -p artifacts
           docker cp itk-dox:/ITKDoxygen.tar.gz artifacts/ITKDoxygen-${GITHUB_SHA}.tar.gz
           docker cp itk-dox:/ITKDoxygenXML.tar.gz artifacts/ITKDoxygenXML-${GITHUB_SHA}.tar.gz
+
       - name: Archive Doxygen Artifacts
         uses: actions/upload-artifact@v4
         with:
           name: doxygen
           path: |
             artifacts/ITKDoxygenXML-*.tar.gz
             artifacts/ITKDoxygen-*.tar.gz
+
+      - name: Publish to latest GitHub Release
+        if: github.ref == 'refs/heads/main'
+        run: |
+          sudo apt install -y zstd
+
+          pushd artifacts
+
+          cp ITKDoxygen-*.tar.gz InsightDoxygenDocHtml-latest.tar.gz
+          gunzip InsightDoxygenDocHtml-latest.tar.gz
+          zstd -f -10 -T6 --long=31 InsightDoxygenDocHtml-latest.tar -o InsightDoxygenDocHtml-latest.tar.zst
+          gzip -9 InsightDoxygenDocHtml-latest.tar
+
+          cp ITKDoxygenXML-*.tar.gz InsightDoxygenDocXml-latest.tar.gz
+          gunzip InsightDoxygenDocXml-latest.tar.gz
+          zstd -f -10 -T6 --long=31 InsightDoxygenDocXml-latest.tar -o InsightDoxygenDocXml-latest.tar.zst
+          gzip -9 InsightDoxygenDocXml-latest.tar
+
+          popd
+
+          gh release delete -R thewtex/ITKDoxygen --cleanup-tag latest --yes
+          gh release create latest --notes="ITK Doxygen documentation built from the ITK master branch." --prerelease --title "ITKDoxygen Latest" -R thewtex/ITKDoxygen ./artifacts/InsightDoxygen*
+        env:
+          GH_TOKEN: ${{ secrets.github_token }}
+
       - name: Update gh-pages
         if: github.ref == 'refs/heads/main'
         run: |

.readthedocs.yaml

@@ -0,0 +1,22 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the OS, Python version, and other tools you might need
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "mambaforge-23.11"
+
+  commands:
+    # Write down your commands here to:
+    #
+    #  - Install the dependencies of your project
+    #  - Build the documentation
+    #  - Save the generated files in $READTHEDOCS_OUTPUT/html
+    - mamba remove --force --name rtd --all
+    - mamba env create -f rtd-environment.yml
+    - mamba run -n rtd zstd --version
+    - ./rtd-download.sh

rtd-download.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+
+set -eox
+
+DOC_VERSION=$(if [[ "${READTHEDOCS_GIT_IDENTIFIER}" == *v* ]]; then echo "${READTHEDOCS_GIT_IDENTIFIER}"; else echo "latest"; fi)
+DOC_VERSION_NO_V=${DOC_VERSION//v/}
+curl -LO https://github.com/thewtex/ITKDoxygen/releases/download/${DOC_VERSION}/InsightDoxygenDocHtml-${DOC_VERSION_NO_V}.tar.zst
+
+unzstd --long=31 ./InsightDoxygenDocHtml-${DOC_VERSION_NO_V}.tar.zst
+mkdir -p $READTHEDOCS_OUTPUT/html
+tar xf \
+  ./InsightDoxygenDocHtml-${DOC_VERSION_NO_V}.tar \
+  --strip-components=1 \
+  -C $READTHEDOCS_OUTPUT/html
+

rtd-environment.yml

@@ -0,0 +1,5 @@
+name: rtd
+channels:
+  - conda-forge
+dependencies:
+  - zstd