activitysim/.github/workflows/rebuild-docs.yml at 8f42457a246a2bac83751cab4da0502b8d263c0f · driftlesslabs/activitysim · 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
46
47
48
49
name: rebuild docs
on:
    workflow_dispatch:
        inputs:
            commit:
                description: 'Commit SHA or branch/tag to build docs from'
                required: true
                type: string
            version:
                description: 'Version number to publish docs as'
                required: true
                type: string

jobs:
    docbuild:
        name: ubuntu-latest py3.9
        runs-on: ubuntu-latest
        defaults:
            run:
                shell: bash -l {0}
        steps:
            - uses: actions/checkout@v4
              with:
                  ref: ${{ github.event.inputs.commit }}
            - name: Install uv
              uses: astral-sh/setup-uv@v5
              with:
                  version: "0.7.12"
                  enable-cache: true
                  cache-dependency-glob: "uv.lock"
            - name: "Set up Python"
              uses: actions/setup-python@v5
              with:
                  python-version-file: ".python-version"
            - name: Install activitysim
              run: |
                  uv sync --locked --dev
            - name: Build the docs
              run: |
                  cd docs
                  make clean
                  make html
            - name: Push to GitHub Pages
              uses: peaceiris/actions-gh-pages@v3.8.0
              with:
                  github_token: ${{ secrets.GITHUB_TOKEN }}
                  # Token is created automatically by Github Actions, no other config needed
                  publish_dir: ./docs/_build/html
                  destination_dir: ${{ github.event.inputs.version }}