Rework old TravisCI test config to GitHub actions

.github/workflows/continuous-integration.yaml

@@ -0,0 +1,38 @@
+name: Run Tests
+
+on: [push, pull_request]
+
+jobs:
+  runtests:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@ec02537da5712d66d4d50a0f33b7eb52773b5ed1
+      with:
+        bundler-cache: true
+        ruby-version: '3.1'
+    - name: Set up Python 3
+      uses: actions/setup-python@v4
+      with:
+        python-version: 3
+    - name: Install Python dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install pyenchant
+    - name: Checkout code
+      uses: actions/checkout@v3
+      with:
+        fetch-depth: 0
+    - name: Install Ruby gems
+      run: bundle install
+      env:
+          NOKOGIRI_USE_SYSTEM_LIBRARIES: true # speeds up installation of html-proofer
+    - name: Build with Jekyll
+      uses: actions/jekyll-build-pages@v1
+      with:
+        source: ./
+        destination: ./_site
+    - name: Check Spelling
+      run: .tests/spellchecker
+    - name: Check HTML
+      run: .tests/htmlproofer

.gitignore

@@ -1,6 +1,7 @@
 _site
 *~
 Gemfile.lock
+vendor/
 
 # Eclipse project
 .project

.travis-scripts/html-proofer → .tests/htmlproofer

@@ -38,13 +38,13 @@ done < "${url_ignore_file}"
 url_ignore_patterns=$(echo "${url_ignore_patterns}" | sed -e 's/^,//')
 if [ -n "${url_ignore_patterns}" ]
 then
-    url_ignore_option="--url-ignore ${url_ignore_patterns}"
+    url_ignore_option="--ignore-urls=${url_ignore_patterns}"
 fi
-echo "html-proofer url-ignore option: ${url_ignore_option}"
 
-bundle exec jekyll build
 set +e # do not halt script on error
-bundle exec htmlproofer --disable-external ${url_ignore_option} ${debug_option} --check-html ./_site
+cmd="bundle exec htmlproofer --disable-external ${url_ignore_option} ${debug_option} ./_site"
+echo "Running: $cmd"
+$cmd
 status=$?
 if [ ${status} -ne 0 -a -z "${debug_option}" ]
 then

.tests/spellchecker

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+set -e # halt script on error
+
+SCVERSION="1.4"
+
+wget https://github.com/stfc/markdown-spellchecker/archive/$SCVERSION.tar.gz -O /tmp/spellchecker.tar.gz
+(cd /tmp && tar -xvzf spellchecker.tar.gz)
+
+cp -f .tests/dictionary.txt /tmp/markdown-spellchecker-$SCVERSION/src/dict.txt
+
+echo
+echo spellchecker config:
+echo --------------------
+cat /tmp/markdown-spellchecker-$SCVERSION/src/config.ini
+echo --------------------
+echo
+
+# In a pull request, ${GITHUB_BASE_REF} contains the commit SHA of the PR base
+# Using it allows to test modified/added files of all PR commits and ensure that
+# deleted files are ignored (git diff provides the summary of all the modifications)
+if [[ -n "${GITHUB_BASE_REF}" ]]; then
+    commit_range="${GITHUB_BASE_REF}..${GITHUB_HEAD_REF}"
+    echo "Checking modified MD files in commit range ${commit_range}..."
+else
+    commit_range="HEAD~1..HEAD"
+    echo "Checking modified MD files in last commit..."
+fi
+
+# Ignore deleted files
+echo "Commit Range: ${commit_range}"
+
+md_files="$(git diff --name-only --diff-filter=d "${commit_range}" -- | grep '\.md$' | grep -v '^assets/' || true)"
+
+if [[ -n "$md_files" ]]; then
+    echo "Markdown files changed:"
+    #shellcheck disable=SC2001
+    echo "$md_files" | sed 's/^/  /g'
+    echo "Running markdown-spellchecker:"
+    python3 /tmp/markdown-spellchecker-$SCVERSION/src/spellchecker.py $md_files || exit 1
+    exit 0
+else
+    echo "No markdown files changed, nothing to do."
+    exit 0
+fi

Gemfile

@@ -1,9 +1,3 @@
 source 'https://rubygems.org'
-
-gem 'github-pages', '>= 175'
-gem 'jekyll-feed'
-gem 'jekyll-redirect-from'
-gem 'html-proofer', '~> 3'
-
-# Suggested by Jekyll
-gem 'wdm', '>= 0.1.0' if Gem.win_platform?
+ruby "~> 3"
+gem 'html-proofer', '~> 4'