aboutsummaryrefslogtreecommitdiff
path: root/.github/workflows/docs.yml
blob: 25311019c6c9df126b0ead7f2925aebb4ca3ad9c (plain)
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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
name: Generate Docs

permissions:
  contents: write

on:
  push:
    branches:
    - master
    - vitepress
    paths:
    - 'builddefs/docsgen/**'
    - 'tmk_core/**'
    - 'quantum/**'
    - 'platforms/**'
    - 'docs/**'
    - '.github/workflows/docs.yml'

defaults:
  run:
    shell: bash

jobs:
  generate:
    runs-on: ubuntu-latest
    container: ghcr.io/qmk/qmk_cli

    # protect against those who develop with their fork on master
    if: github.repository == 'qmk/qmk_firmware' || (github.repository == 'tzarc/qmk_firmware' && github.ref == 'refs/heads/vitepress')

    steps:
    - uses: actions/checkout@v4
      with:
        fetch-depth: 1

    - name: Install dependencies
      run: |
        apt-get update && apt-get install -y rsync doxygen curl
        # install nvm
        touch $HOME/.bashrc
        curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

    - name: Install node
      run: |
        source $HOME/.bashrc
        nvm install 20
        nvm use 20
        corepack enable
        npm install -g moxygen

    - name: Build docs
      run: |
        source $HOME/.bashrc
        nvm use 20
        qmk --verbose generate-docs
        touch '.build/docs/.nojekyll'

    - name: Set CNAME
      if: github.repository == 'qmk/qmk_firmware'
      run: |
        # Override target CNAME
        echo 'docs.qmk.fm' > .build/docs/CNAME

    - name: Override CNAME
      if: github.repository == 'tzarc/qmk_firmware'
      run: |
        # Temporarily override target CNAME during development
        echo 'vitepress.qmk.fm' > .build/docs/CNAME

    - name: Deploy
      if: github.repository == 'qmk/qmk_firmware'
      uses: JamesIves/[email protected]
      with:
          token: ${{ secrets.GITHUB_TOKEN }}
          branch: gh-pages
          folder: .build/docs
          git-config-name: QMK Bot
          git-config-email: [email protected]

    - name: Deploy
      if: github.repository == 'tzarc/qmk_firmware'
      uses: JamesIves/[email protected]
      with:
        branch: gh-pages
        folder: .build/docs