pages.yml

name: Documentation & Website

on: [push, pull_request]

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: "pages"
  cancel-in-progress: false

jobs:
  build-container:
    uses: ./.github/workflows/container.yml
    permissions:
      packages: write

  build:
    runs-on: ubuntu-latest
    needs: build-container
    permissions:
      contents: write

    container:
      image: ${{ needs.build-container.outputs.image }}
      options: ${{ needs.build-container.outputs.image_options }}

    steps:
      - name: Check out xdg-desktop-portal
        uses: actions/checkout@v4

      - name: Build docs
        run: |
          meson setup builddir -Ddocumentation=enabled
          ninja -C builddir doc/html

      - name: Build website
        uses: actions/jekyll-build-pages@v1
        with:
          source: ./doc/website
          destination: ./_site

      - name: Prepare docs
        working-directory: builddir/doc
        run: |
          mv ./html ../../_site/docs

      - name: Upload artifact
        uses: actions/upload-pages-artifact@v3

  # Deployment job
  deploy:
    runs-on: ubuntu-latest
    needs: build
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    if: ${{ (github.event_name == 'push' && github.ref == 'refs/heads/main') }}

    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4