python/.github/workflows/deploy-documentation.yml at develop · boostorg/python · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
name: deploy documentation

on: [push]

jobs:
  deploy:
    runs-on: ubuntu-24.04
    steps:
    - uses: actions/checkout@v5
    - name: setup
      run: |
        sudo apt-get update
        sudo apt-get install \
          libboost-tools-dev \
          python3 \
          python3-numpy \
          python3-sphinx \
          xsltproc \
          docbook-xsl
        sudo python3 -m pip install --upgrade pip
        sudo python3 -m pip install faber
    - name: build
      run: |
        sed -e "s/\$PYTHON/python3/g" .ci/faber > ~/.faber
        faber --builddir=build doc.html
        if [ "${GITHUB_REF##*/}" == master ]; then
          echo "destination_dir=doc/html" >> $GITHUB_ENV
        else
          echo "destination_dir=doc/develop/html" >> $GITHUB_ENV
        fi
    - name: deploy
      uses: peaceiris/actions-gh-pages@v4
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        publish_dir: build/doc/html
        destination_dir: ${{ env.destination_dir }}
        keep_files: true