From 39f179d8f9c3267ccb2445460ea1237d8b47b893 Mon Sep 17 00:00:00 2001 From: Martin Styk Date: Sun, 11 Feb 2024 10:57:07 +0100 Subject: [PATCH] Build LaTeX docs Signed-off-by: Martin Styk --- .github/workflows/build-docs.yaml | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/.github/workflows/build-docs.yaml b/.github/workflows/build-docs.yaml index 28b502d..e7f1b74 100644 --- a/.github/workflows/build-docs.yaml +++ b/.github/workflows/build-docs.yaml @@ -30,15 +30,26 @@ jobs: pushd beaker curl -o /etc/yum.repos.d/beaker-server.repo https://beaker-project.org/yum/beaker-server-RedHatEnterpriseLinux.repo yum-builddep beaker.spec -y + + # Hacks to get Sphinx LaTeX build working + yum install -y python2-pip texlive texlive-* + pip install sphinx==1.2.0 - name: Build docs run: | cd beaker echo "html_theme_path = ['../../beaker-project.org/sphinx-theme']" >>documentation/conf.py PYTHONPATH=Common:Server:Client/src python -c '__requires__ = ["CherryPy < 3.0"]; import pkg_resources; execfile("/usr/bin/sphinx-build")' -b html -D html_theme=beaker -A branch_warning="$branch_warning" documentation documentation/_build/html - # Latex documentation is currently unavailable + PYTHONPATH=Common:Server:Client/src python -c '__requires__ = ["CherryPy < 3.0"]; import pkg_resources; execfile("/usr/bin/sphinx-build")' -b latex documentation documentation/_build/latex + + make -C documentation/_build/latex all-pdf + + mkdir documentation/tree + cp -r documentation/_build/html/* documentation/tree/ + cp documentation/_build/latex/*.pdf documentation/tree/ + - name: Archive docs uses: actions/upload-artifact@v3 with: name: docs - path: beaker/documentation/_build/html/ + path: beaker/documentation/tree/