Merge branch 'main' into release/0.2

Author: RobPasMue

.github/workflows/ci_cd.yml

@@ -45,7 +45,7 @@ jobs:
 
       - name: Install packages for documentation build
         run: |
-          sudo apt-get install xvfb pandoc
+          sudo apt-get install xvfb pandoc texlive-latex-extra latexmk
           pip install --upgrade build
           pip install .[doc]
 
@@ -56,17 +56,28 @@ jobs:
           sleep 10
           cd -
 
-      - name: Build the documentation
+      - name: Build the documentation (HTML)
         run: |
           xvfb-run make -C doc html
 
+      - name: Build the documentation (PDF)
+        run: |
+          xvfb-run make -C doc pdf
+
       - name: Upload HTML documentation
         uses: actions/upload-artifact@v3
         with:
           name: documentation-html
           path: doc/_build/html
           retention-days: 7
 
+      - name: Upload PDF documentation
+        uses: actions/upload-artifact@v3
+        with:
+          name: documentation-pdf
+          path: doc/_build/latex/*.pdf
+          retention-days: 7
+
       - name: Upload the server logs
         if: always()
         uses: actions/upload-artifact@v3

doc/Makefile

@@ -3,7 +3,7 @@
 
 # You can set these variables from the command line, and also
 # from the environment for the first two.
-SPHINXOPTS    = -j auto -W --color
+SPHINXOPTS    = -j auto
 SPHINXBUILD   = sphinx-build
 SOURCEDIR     = source
 BUILDDIR      = _build
@@ -27,4 +27,4 @@ clean:
 pdf:
 	@$(SPHINXBUILD) -M latex "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 	cd $(BUILDDIR)/latex && latexmk -r latexmkrc -pdf *.tex -interaction=nonstopmode || true
-	(test -f $(BUILDDIR)/latex/*.pdf && echo pdf exists) || exit 1
+	(test -f $(BUILDDIR)/latex/*.pdf && echo pdf exists) || exit 1