[pull] main from gethomepage:main #505
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Docs | |
| on: | |
| push: | |
| tags: ["v*.*.*"] | |
| branches: ["main"] | |
| pull_request: | |
| merge_group: | |
| workflow_dispatch: | |
| permissions: | |
| contents: write | |
| jobs: | |
| pre-commit: | |
| name: Linting Checks | |
| runs-on: ubuntu-22.04 | |
| steps: | |
| - name: Checkout repository | |
| uses: actions/checkout@v6 | |
| - name: Install python | |
| uses: actions/setup-python@v6 | |
| with: | |
| python-version: 3.x | |
| - name: Check files | |
| uses: pre-commit/[email protected] | |
| test: | |
| name: Test Build Docs | |
| if: github.repository == 'gethomepage/homepage' && github.event_name == 'pull_request' | |
| runs-on: ubuntu-latest | |
| needs: | |
| - pre-commit | |
| steps: | |
| - 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- | |
| - run: sudo apt-get install pngquant | |
| - run: pip install mkdocs-material mkdocs-redirects "mkdocs-material[imaging]" | |
| - name: Test Docs Build | |
| run: MKINSIDERS=false mkdocs build | |
| deploy: | |
| name: Build & Deploy Docs | |
| if: github.repository == 'gethomepage/homepage' && github.event_name != 'pull_request' && github.ref == 'refs/heads/main' | |
| runs-on: ubuntu-latest | |
| needs: | |
| - pre-commit | |
| steps: | |
| - uses: actions/checkout@v6 | |
| - name: Configure Git Credentials | |
| run: | | |
| git config user.name github-actions[bot] | |
| git config user.email 41898282+github-actions[bot]@users.noreply.github.com | |
| - uses: actions/setup-python@v6 | |
| with: | |
| python-version: 3.x | |
| - run: echo "cache_id=${{github.sha}}" >> $GITHUB_ENV | |
| - uses: actions/cache@v4 | |
| with: | |
| key: mkdocs-material-${{ env.cache_id }} | |
| path: .cache | |
| restore-keys: | | |
| mkdocs-material- | |
| - run: sudo apt-get install pngquant | |
| - run: pip install git+https://${GH_TOKEN}@github.com/benphelps/mkdocs-material-insiders.git | |
| - run: pip install mkdocs-redirects "mkdocs-material[imaging]" | |
| - name: Docs Deploy | |
| run: MKINSIDERS=true mkdocs gh-deploy --force | |
| env: | |
| GH_TOKEN: ${{ secrets.GH_TOKEN }} |