pdf-at-pr.yaml

# This workflow will install Python dependencies and generate PDF file at PR
name: Create offline documentation on PR

on:
  pull_request:
    types: [opened, reopened, synchronize, labeled]
  workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: [ 3.8 ]

    steps:
      - uses: actions/checkout@v4
        with:
          ref: ${{ github.event.pull_request.head.sha }}
          path: documentation

      - uses: actions/checkout@v4
        with:
          ref: www
          path: www

      - name: Set up Python ${{ matrix.python-version }}
        uses: actions/setup-python@v5
        with:
          python-version: ${{ matrix.python-version }}

      - name: Install dependencies
        run: |
          cd documentation
          python -m pip install --upgrade pip
          pip install setuptools wheel
          pip install -r requirements.txt

      - name: Run mkdocs --clean
        run: |

          cd documentation
          mkdocs build --clean

      - name: Push to web
        run: |

          cd www
          mkdir -p "${{ github.event.number }}"
          rsync -av ../documentation/site/. ${{ github.event.number }}
          git config user.name github-actions
          git config user.email github-actions@github.com
          git add . 
          git commit -m "Updating repo" || true
          git push origin www || true

      - uses: devindford/Append_PR_Comment@v1.1.3
        with:
          repo-token: "${{ secrets.GITHUB_TOKEN }}"
          body-template: |

            [![Create offline documentation on PR](https://github.com/armbian/documentation/actions/workflows/pdf-at-pr.yaml/badge.svg)](https://github.com/armbian/documentation/actions/workflows/pdf-at-pr.yaml)
            Documentation website preview will be available in few minutes:
            <a href=https://armbian.github.io/documentation/${{ github.event.number }}><kbd> <br> Open WWW preview <br> </kbd></a>
          body-update-action: 'suffix'