From 414d67b321e79b2f33d578a1e7fdf7dee726cdde Mon Sep 17 00:00:00 2001 From: Greg Hudson Date: Sun, 20 Sep 2020 16:41:08 -0400 Subject: [PATCH] Add doc build to Github Actions config Add a second workflow to build documentation, with the HTML output as a generated artifact. Skip the doc workflow if no documentation files were changed. Skip the existing build workflow if no source files were changed. --- .github/workflows/build.yml | 4 +++- .github/workflows/doc.yml | 27 +++++++++++++++++++++++++++ 2 files changed, 30 insertions(+), 1 deletion(-) create mode 100644 .github/workflows/doc.yml diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 2af7da2f4b..8d1042b7bf 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -1,6 +1,8 @@ name: Build -on: [push, pull_request] +on: + push: {paths: [src/**, .github/workflows/build.yml]} + pull_request: {paths: [src/**, .github/workflows/build.yml]} jobs: diff --git a/.github/workflows/doc.yml b/.github/workflows/doc.yml new file mode 100644 index 0000000000..292df4cfee --- /dev/null +++ b/.github/workflows/doc.yml @@ -0,0 +1,27 @@ +name: Doc + +on: + push: {paths: [doc/**, src/doc/*, src/include/krb5/krb5.hin, .github/workflows/doc.yml]} + pull_request: {paths: [doc/**, src/doc/*, src/include/krb5/krb5.hin, .github/workflows/doc.yml]} + +jobs: + doc: + runs-on: ubuntu-18.04 + steps: + - name: Checkout repository + uses: actions/checkout@v1 + - name: Linux setup + run: | + sudo apt-get update -qq + sudo apt-get install -y doxygen python3-lxml python3-pip python-sphinx + pip3 install Cheetah3 + - name: Build documentation + run: | + cd src/doc + make -f Makefile.in SPHINX_ARGS=-W htmlsrc + - name: Upload HTML + uses: actions/upload-artifact@v2 + with: + name: html + path: doc/html + retention-days: 7 -- 2.47.2