File: build-docs.yml

package info (click to toggle)
changie 1.24.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 2,068 kB
  • sloc: makefile: 40; ruby: 38; javascript: 32
file content (58 lines) | stat: -rw-r--r-- 1,253 bytes parent folder | download
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
50
51
52
53
54
55
56
57
58
name: build-docs

on:
  pull_request:
    branches: [ main ]
    paths:
    - '.github/workflows/**'
    - 'docs/**'
    - 'cmd/**'
    - 'core/**'
    - '*/CHANGELOG.md'
    - 'requirements.txt'
  workflow_dispatch:
    inputs:
      deploy:
        description: 'deploy the built docs'
        type: boolean
        default: false
        required: false

jobs:
  build:
    name: Build Docs
    runs-on: ubuntu-latest
    steps:

    - name: Setup Go
      uses: actions/setup-go@v6
      with:
        go-version-file: 'go.mod'

    - name: Check out code
      uses: actions/checkout@v6

    - uses: actions/setup-python@v6
      with:
        python-version: 3.x
    - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV 
    - uses: actions/cache@v4
      with:
        key: mkdocs-material-${{ env.cache_id }}
        path: .cache
        restore-keys: |
          mkdocs-material-

    - name: Build docs
      run: |
        go run main.go gen
        pip install -r requirements.txt
        mkdocs build

    - name: Deploy Docs
      if: "${{ github.event.inputs.deploy }}"
      uses: peaceiris/actions-gh-pages@v4.0.0
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        publish_dir: ./site
        cname: changie.dev