Properly build

Author: Lisa Julia Nebel

.github/workflows/python_sphinx_docs.yml

@@ -18,47 +18,45 @@ jobs:
         - name: Checkout source code
           uses: actions/checkout@v4
           with:
-            fetch-depth: 0   # Fetch all history for all tags and branches
+            fetch-depth: 0
+
         - name: Set up Python
           uses: actions/setup-python@v5
           with:
             python-version: "3.11"
+
         - name: Install poetry
           uses: OPM/actions-poetry@master
-        - name: Install python dependencies
+
+        - name: Install Python dependencies
           run: |
             cd python/sphinx_docs
             poetry install
-        - name: Build documentation for all branches but master
-          # To add a new relase to this build system:
-          # - add the respective branch <your-new-release> on this repository
-          # - take a snapshot of https://raw.githubusercontent.com/OPM/opm-common/<your-new-release>/python/docstrings_common.json,
-          #   https://raw.githubusercontent.com/OPM/opm-simulators/<your-new-release>/python/docstrings_simulators.json and
-          #   https://raw.githubusercontent.com/OPM/opm-simulators/<your-new-release>/dune.module and put them
-          #   in the python folder on that branch
-          # - add the respective branch <your-new-release> in the command "poetry run sphinx-versioned -b ...." below
+
+        - name: Create output directory
+          run: |
+            mkdir -p python/gh-pages
+            touch python/gh-pages/.nojekyll
+
+        - name: Build docs for release/2025.04
           run: |
-            cd python
-            mkdir gh-pages
-            touch gh-pages/.nojekyll
-            cd sphinx_docs
-            poetry run sphinx-versioned -b "release/2025.04" --force --git-root ../../
-        - name: Get docstrings_common.json, docstrings_simulators.json and dune.module from master branches of opm-common and opm-simulators
+            cd python/sphinx_docs
+            poetry run sphinx-versioned -b "release/2025.04" --force --git-root ../../ --build-dir ../../gh-pages/release-2025.04
+
+        - name: Download files for master build
+          if: github.ref_name == 'master'
           run: |
             curl -L -o python/docstrings_common.json https://raw.githubusercontent.com/OPM/opm-common/master/python/docstrings_common.json
             curl -L -o python/docstrings_simulators.json https://raw.githubusercontent.com/OPM/opm-simulators/master/python/docstrings_simulators.json
             curl -L -o dune.module https://raw.githubusercontent.com/OPM/opm-simulators/master/dune.module
-        - name: Build documentation for master
+
+        - name: Build docs for master
+          if: github.ref_name == 'master'
           run: |
             cd python/sphinx_docs
-            poetry install
-            if [ "${{ github.ref_name }}" == "master" ]; then
-              poetry run sphinx-build -b html docs ../../gh-pages/master
-            fi
-        - name: Copy documentation to gh-pages
-          run: |
-            cp -r python/sphinx_docs/docs/_build/* python/gh-pages
-        - name: Deploy documentation for PR merge to master or push to master
+            poetry run sphinx-build -b html docs ../../gh-pages/master
+
+        - name: Deploy to GitHub Pages
           if: github.ref == 'refs/heads/master'
           uses: OPM/github-pages-deploy-action@releases/v4
           with: