Merge pull request #60 from skjnldsv/copilot/update-release-version-string

fix: use actual release version in PDF output instead of "latest"

Author: skjnldsv

.github/workflows/sphinxbuild.yml

@@ -85,8 +85,21 @@ jobs:
     - name: Build html documentation
       run: cd ${{ matrix.manual.directory }} && make ${{ matrix.manual.make_target }}
 
+    - name: Compute PDF release version
+      if: ${{ matrix.manual.build_pdf_path }}
+      id: pdf_version
+      run: |
+        branch="${GITHUB_REF#refs/heads/}"
+        if [[ "$branch" == stable* ]]; then
+          echo "release=${branch#stable}" >> $GITHUB_OUTPUT
+        else
+          echo "release=latest" >> $GITHUB_OUTPUT
+        fi
+
     - name: Build pdf documentation
       if: ${{ matrix.manual.build_pdf_path }}
+      env:
+        DOCS_RELEASE: ${{ steps.pdf_version.outputs.release }}
       run: |
         set -e
         cd ${{ matrix.manual.directory }}

conf.py

@@ -28,7 +28,8 @@
 # The short X.Y version.
 version = 'latest'
 # The full version, including alpha/beta/rc tags.
-release = version
+# Can be overridden via DOCS_RELEASE env var (used for PDF builds to show the actual version number)
+release = os.environ.get('DOCS_RELEASE', version)
 
 # RTD theme options
 html_theme_options = {