aboutsummaryrefslogtreecommitdiff
path: root/.github/workflows/doc.yml
diff options
context:
space:
mode:
Diffstat (limited to '.github/workflows/doc.yml')
-rw-r--r--.github/workflows/doc.yml35
1 files changed, 35 insertions, 0 deletions
diff --git a/.github/workflows/doc.yml b/.github/workflows/doc.yml
new file mode 100644
index 00000000..4055b9f3
--- /dev/null
+++ b/.github/workflows/doc.yml
@@ -0,0 +1,35 @@
+name: doc
+
+on: [push, pull_request]
+
+permissions:
+ contents: read
+
+jobs:
+ build:
+ # Use Ubuntu 20.04 because doxygen 1.8.13 from Ubuntu 18.04 is broken.
+ runs-on: ubuntu-20.04
+
+ steps:
+ - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0
+
+ - name: Add ubuntu mirrors
+ run: |
+ # Github Actions caching proxy is at times unreliable
+ # see https://github.com/actions/runner-images/issues/7048
+ printf 'http://azure.archive.ubuntu.com/ubuntu\tpriority:1\n' | sudo tee /etc/apt/mirrors.txt
+ curl http://mirrors.ubuntu.com/mirrors.txt | sudo tee --append /etc/apt/mirrors.txt
+ sudo sed -i 's~http://azure.archive.ubuntu.com/ubuntu/~mirror+file:/etc/apt/mirrors.txt~' /etc/apt/sources.list
+
+ - name: Create Build Environment
+ run: |
+ sudo apt update
+ sudo apt install doxygen python3-virtualenv
+ sudo npm install -g less clean-css
+ cmake -E make_directory ${{runner.workspace}}/build
+
+ - name: Build
+ working-directory: ${{runner.workspace}}/build
+ env:
+ KEY: ${{secrets.KEY}}
+ run: $GITHUB_WORKSPACE/support/build-docs.py