oceanhackweek.github.io/.github/workflows/check_sphinx_build.yml at source · oceanhackweek/oceanhackweek.github.io · 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
38
39
40
41
42
43
44
45
name: Check Sphinx Build

on:
  pull_request:
    branches: [master, source]

jobs:
  build-docs:
    name: Sphinx  build of web pages
    runs-on: ubuntu-latest
    defaults:
      run:
        shell: bash -l {0}

    steps:
      - name: Checkout
        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683  # v4.2.2
        with:
          submodules: true

      - uses: prefix-dev/setup-pixi@v0.8.14
        with:
          pixi-version: v0.51.0
          cache: true

      - name: Build documentation
        shell: bash -l {0}
        run: |
          pixi run html

      # - name: Check links
      #   shell: bash -l {0}
      #   run: |
      #     pixi run linkcheck

      # workaround https://github.com/actions/upload-artifact/issues/38
      - name: tarball
        run: tar czf site.tar.gz ./_build/html/

      # https://github.com/actions/upload-artifact
      - name: Upload Website artifact
        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02  # 4.6.2
        with:
          name: Website
          path: site.tar.gz