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