summaryrefslogtreecommitdiff
path: root/.github/workflows/docs.yaml
blob: d1000e04203e622e1fdd224428af09b02ff8c4af (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
name: Docs

on:
  push:
    branches:
      - master


env:
  FORCE_COLOR: 1

permissions: {}
jobs:
  build:
    permissions:
      contents: write # to push pages branch (peaceiris/actions-gh-pages)

    runs-on: ubuntu-latest
    steps:
    - name: Setup Python
      uses: actions/setup-python@v4
      with:
        python-version: "3.x"
    - name: Checkout Pygments
      uses: actions/checkout@v3
    - name: Install tox
      run: pip install -r requirements.txt
    - name: Sphinx build
      run: |
        tox -e web-doc -- dirhtml
        touch doc/_build/dirhtml/.nojekyll
        echo -e 'pygments.org\nwww.pygments.org' > doc/_build/dirhtml/CNAME
        echo 'Automated deployment of docs for GitHub pages.' > doc/_build/dirhtml/README
    - name: Deploy to repo
      if: github.repository_owner == 'pygments'
      uses: peaceiris/actions-gh-pages@v3
      with:
        deploy_key: ${{ secrets.ACTIONS_DEPLOY_KEY }}
        external_repository: pygments/pygments.github.io
        publish_branch: master
        publish_dir: ./doc/_build/dirhtml