conditional_convert_via_pandoc.yml

name: conditional_convert_via_pandoc
#
# A script to check for changed and added .md files in content/ and convert those with pandoc (except for _index.md)
#
# Thanks to Gérald Barré aka. meziantou for the basic template of the condition check
# Written by Marcel Kaiser
#
# published: 2024-10-29
# last edit: 2024-10-29
#
on:
  push:
    branches:
      - 'main' # Do the work exclusively for the branch deploying the website

jobs:
  # Seperate jobs to be able to possibly use condition_check_files for other tasks as well
  condition_check_files:
    runs-on: 'ubuntu-22.04'
    # Declare outputs for next jobs
    outputs:
      bool_files_changed: ${{ steps.check_file_changed.outputs.bool_files_changed }}
      list_changed_files: ${{ steps.check_file_changed.outputs.list_changed_files }}
    steps:
    - uses: actions/checkout@v4
      with:
        # Checkout as many commits as needed for the diff
        fetch-depth: 1
    - shell: pwsh
      id: check_file_changed
      run: |
        # Look only for changed files (A - added, M - modified) and return their names (the specific changes are irrelevant)
        $diff = git diff --name-only --diff-filter=AM HEAD^ HEAD

        # Filter the files under content/ with the .md extension excluding the Hugo associated _index.md files
        $SourceDiff = $diff | Where-Object { $_ -match '^content/' -and $_ -match '.md$' -and -not ($_ -match '_index.md') }
        $HasDiff = $SourceDiff.Length -gt 0

        # Set the output named "bool_files_changed"
        echo "{bool_files_changed}={$HasDiff}" >> $GITHUB_OUTPUT
        echo "{list_changed_files}={$SourceDiff}" >> $GITHUB_OUTPUT

  # Run the job only with 'bool_files_changed' equals 'True'
  conditional_pandoc:
    runs-on: 'ubuntu-22.04'
    needs: [ condition_check_files ]
    if: needs.condition_check_files.outputs.bool_files_changed == 'True'
    steps:
    - uses: docker://pandoc/latex:3.5
    - shell: pwsh
      run: |
        # List types which will only use --standalone. You can easily add more extensions if you're fine with this setting
        $ONLY_STANDALONE_OUTPUT_TYPES = "latex pdf html docx odt"
        # Use as many cores as available to be as fast as possible
        parallel --jobs 0 \
          # Pandoc creates an AST (Abstract Syntax Tree); reuse this by saving/reading from txt
          pandoc --from markdown --to native {} -o {.}.txt ';'\
          for i in $ONLY_STANDALONE_OUTPUT_TYPES';' do \
            pandoc --from native {.}.txt --standalone -o '{.}.$i' ';' \
          done';' \
          # You can easily add individual conversion rules by using pandoc after the 'done' part. Keep in mind to finish all non-comment lines with backslash
          rm {.}.txt ::: needs.condition_changed_files.outputs.list_changed_files