Build docs/ namespace

Signed-off-by: Martin Styk <[email protected]>

.github/workflows/build-docs.yaml

@@ -0,0 +1,45 @@
+name: Build docs
+
+on:
+  pull_request:
+  push:
+  workflow_dispatch:
+
+jobs:
+  build-docs:
+    runs-on: ubuntu-latest
+    container: centos:7
+
+    steps:
+      - name: Setup environment
+        run: |
+          yum install -y epel-release https://repo.ius.io/ius-release-el7.rpm
+          yum install -y make nodejs git236-core
+      - name: Checkout source code
+        uses: actions/checkout@v3
+      - name: Checkout beaker repository
+        uses: actions/checkout@v3
+        with:
+          repository: beaker-project/beaker
+          ref: 'master'
+          fetch-depth: 0
+          fetch-tags: true
+      - name: Install build dependencies
+        run: |
+          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
+      - name: Build docs
+        run: |
+          pushd 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
+          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/