ci.yml

name: "CI"

on:
  workflow_dispatch:
  push:
    branches:
      - "main"
      - "preview"
  pull_request:

permissions:
  contents: "write"
  pull-requests: "write"
  statuses: "write"
  deployments: "write"

concurrency:
  group: "ci-${{ github.event_name }}-${{ github.ref_name }}-${{ github.event.pull_request.event.number || github.sha }}"
  cancel-in-progress: true

jobs:

  build-docs:
    name: "Build docs"
    runs-on: "ubuntu-latest"

    steps:
      - name: "Checkout"
        uses: "actions/checkout@v4"
        with:
          fetch-depth: 0

      - name: "Install Flox"
        uses: "flox/install-flox-action@main"

      - name: "Build"
        uses: "flox/activate-action@main"
        with:
          command: |
            mkdocs build
            mkdir -p ./public/docs
            cp -R ./site/* ./public/docs/
            chmod -R +w ./public/docs
            cp netlify.toml ./public/

      - name: "Check markdown lint"
        uses: "flox/activate-action@main"
        with:
          command: "markdownlint-cli2 docs/**/*.md"

      - name: "Check external links"
        uses: "flox/activate-action@main"
        with:
          command: "./check_links.sh"

      - name: "Publish to Netlify"
        if: ${{ github.repository_owner == 'flox' }}
        uses: "nwtgck/actions-netlify@v3.0"
        env:
          NETLIFY_AUTH_TOKEN: "${{ secrets.MANAGED_NETLIFY_TOKEN }}"
          NETLIFY_SITE_ID:    "${{    vars.MANAGED_NETLIFY_FLOXDOCS_ID }}"
        with:
          github-token:       "${{ secrets.GITHUB_TOKEN }}"
          deploy-message:     "Published from GitHub Actions"
          publish-dir:        "public"

          enable-pull-request-comment: true
          overwrites-pull-request-comment: false
          enable-commit-comment: false
          enable-commit-status: true

          production-branch: "main"
          production-deploy: ${{ github.event_name == 'push' && github.ref_name == 'main' }}

          alias: ${{ github.event_name == 'push' && github.ref_name || (github.event.pull_request.head.sha || github.sha) }}

          enable-github-deployment: ${{ github.event_name == 'push' && 'true' || 'false' }}
          github-deployment-environment: ${{ github.event_name == 'push' && github.ref_name || format('pull-request-{0}', github.event.number) }}