xref: /freebsd/crypto/krb5/.github/workflows/doc.yml (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1name: Doc
2
3on:
4    push: {paths: [doc/**, src/doc/*, src/include/krb5/krb5.hin, .github/workflows/doc.yml]}
5    pull_request: {paths: [doc/**, src/doc/*, src/include/krb5/krb5.hin, .github/workflows/doc.yml]}
6
7jobs:
8    doc-older-sphinx:
9        runs-on: ubuntu-22.04
10        steps:
11            - name: Checkout repository
12              uses: actions/checkout@v1
13            - name: Linux setup
14              run: |
15                sudo apt-get update -qq
16                sudo apt-get install -y doxygen python3-lxml python3-pip python3-sphinx
17                pip3 install Cheetah3
18            - name: Build documentation
19              run: |
20                cd src/doc
21                make -f Makefile.in SPHINX_ARGS=-W htmlsrc
22    doc-newest-sphinx:
23        runs-on: ubuntu-latest
24        steps:
25            - name: Checkout repository
26              uses: actions/checkout@v1
27            - name: Linux setup
28              run: |
29                sudo apt-get update -qq
30                sudo apt-get install -y doxygen python3-lxml python3-pip
31                pip3 install Cheetah3 sphinx
32            - name: Build documentation
33              run: |
34                cd src/doc
35                make -f Makefile.in SPHINX_ARGS=-W htmlsrc
36            - name: Upload HTML
37              uses: actions/upload-artifact@v2
38              with:
39                  name: html
40                  path: doc/html
41                  retention-days: 7
42