check-links.yml

# Check links in plaintext files in the repository
#
# This workflow runs the lychee tool to check all links in plaintext files. It will
# create an issue if broken links are found.
#
# It is scheduled to run weekly at 12 noon every Sunday.
#
name: Check Links

on:
  # Uncomment the 'pull_request' line below to trigger the workflow in PR
  # pull_request:
  workflow_dispatch:
  # Schedule runs on 12 noon every Sunday
  schedule:
    - cron: '0 12 * * 0'

jobs:
  check_links:
    name: Check Links
    runs-on: ubuntu-latest
    if: github.repository == 'GenericMappingTools/gmt'

    steps:
    - name: Checkout the repository
      uses: actions/checkout@v4.1.4

    - name: Link Checker
      id: lychee
      uses: lycheeverse/lychee-action@v1.10.0
      with:
        # 429: Too many requests
        args: >
          --accept 429
          --exclude ^ftp:https://
          --exclude ^https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$
          --exclude ^https://download1.rpmfusion.org/free/el/rpmfusion-free-release-$
          --exclude ^http:https://maps.google.com/mapfiles/kml/$
          --exclude ^http:https://aa.usno.navy.mil/faq/docs/lawyers.php$
          --exclude ^uhttp:https://my.server.com/images$
          --exclude ^-W@weight.png$
          --exclude ^http:https://topex.ucsd.edu/marine_grav/mar_grav.html
          --exclude ^https://topex.ucsd.edu/sandwell/
          --exclude ^http:https://topex.ucsd.edu
          --exclude ^https://doi.org
          --exclude ^https://www.researchgate.net/
          --exclude ^http:https://www.eumetsat.int
          --exclude ^http:https://nsis.sourceforge.io
          --exclude ^https://www.ethnologue.com
          --exclude ^https://linux.die.net/man/3/printf
          --verbose
          **/*.rst
          **/*.rst_
          **/*.md

    - name: Get current date
      id: date
      run: echo "date=$(date +'%Y-%m-%d')" >> $GITHUB_OUTPUT

    - name: Create Issue From File
      if: env.lychee_exit_code != 0
      run: |
        title="Link Checker Report on ${{ steps.date.outputs.date }}"
        gh issue create --title "$title" --body-file ./lychee/out.md
      env:
        GH_TOKEN: ${{secrets.GITHUB_TOKEN}}