From cc3456aab08d873c8da4921fe386d5488ad1f465 Mon Sep 17 00:00:00 2001 From: "Paul P.H. Wilson" Date: Mon, 24 Aug 2026 13:47:48 -0500 Subject: [PATCH 01/10] add first attempt at page building tests for CI --- .github/workflows/test_build.yml | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 .github/workflows/test_build.yml diff --git a/.github/workflows/test_build.yml b/.github/workflows/test_build.yml new file mode 100644 index 00000000..f61da2da --- /dev/null +++ b/.github/workflows/test_build.yml @@ -0,0 +1,17 @@ +name: Build Jekyll site +on: + pull_request: + workflow_dispatch: + +jobs: + build: + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v4 + - name: Setup Pages + uses: actions/configure-pages@v5 + - name: Build + uses: actions/jekyll-build-pages@v1 + - name: Upload artifact + uses: actions/upload-pages-artifact@v3 From 626811dff0f6199607cc4567deee446eacbca3af Mon Sep 17 00:00:00 2001 From: "Paul P.H. Wilson" Date: Mon, 24 Aug 2026 13:51:17 -0500 Subject: [PATCH 02/10] update versions --- .github/workflows/test_build.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/test_build.yml b/.github/workflows/test_build.yml index f61da2da..a8ddced7 100644 --- a/.github/workflows/test_build.yml +++ b/.github/workflows/test_build.yml @@ -8,10 +8,10 @@ jobs: runs-on: ubuntu-latest steps: - name: Checkout - uses: actions/checkout@v4 + uses: actions/checkout@v7 - name: Setup Pages - uses: actions/configure-pages@v5 + uses: actions/configure-pages@v6 - name: Build uses: actions/jekyll-build-pages@v1 - name: Upload artifact - uses: actions/upload-pages-artifact@v3 + uses: actions/upload-pages-artifact@v7 From 4146a2dc42b45559db1a5b350d76f6f601968d2a Mon Sep 17 00:00:00 2001 From: "Paul P.H. Wilson" Date: Mon, 24 Aug 2026 13:52:23 -0500 Subject: [PATCH 03/10] update versions better --- .github/workflows/test_build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/test_build.yml b/.github/workflows/test_build.yml index a8ddced7..41fa00a4 100644 --- a/.github/workflows/test_build.yml +++ b/.github/workflows/test_build.yml @@ -14,4 +14,4 @@ jobs: - name: Build uses: actions/jekyll-build-pages@v1 - name: Upload artifact - uses: actions/upload-pages-artifact@v7 + uses: actions/upload-pages-artifact@v5 From 991e81a89866a757751d009e286ec54db6beb091 Mon Sep 17 00:00:00 2001 From: "Paul P.H. Wilson" Date: Mon, 24 Aug 2026 14:32:08 -0500 Subject: [PATCH 04/10] try to post a comment with the artifact --- .github/workflows/test_build.yml | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/.github/workflows/test_build.yml b/.github/workflows/test_build.yml index 41fa00a4..07dd436b 100644 --- a/.github/workflows/test_build.yml +++ b/.github/workflows/test_build.yml @@ -6,6 +6,9 @@ on: jobs: build: runs-on: ubuntu-latest + permissions: + pull-requests: write + steps: - name: Checkout uses: actions/checkout@v7 @@ -15,3 +18,7 @@ jobs: uses: actions/jekyll-build-pages@v1 - name: Upload artifact uses: actions/upload-pages-artifact@v5 + - name: Post comment + uses: live-codes/pr-comment-from-artifact@v1 + with: + GITHUB_TOKEN: ${{ github.token }} From 6cedce245eb9008a1cf399a36ff3e092ae6685e1 Mon Sep 17 00:00:00 2001 From: "Paul P.H. Wilson" Date: Mon, 24 Aug 2026 14:42:54 -0500 Subject: [PATCH 05/10] undo post a comment with the artifact --- .github/workflows/test_build.yml | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/.github/workflows/test_build.yml b/.github/workflows/test_build.yml index 07dd436b..897c0ad2 100644 --- a/.github/workflows/test_build.yml +++ b/.github/workflows/test_build.yml @@ -6,8 +6,6 @@ on: jobs: build: runs-on: ubuntu-latest - permissions: - pull-requests: write steps: - name: Checkout @@ -18,7 +16,4 @@ jobs: uses: actions/jekyll-build-pages@v1 - name: Upload artifact uses: actions/upload-pages-artifact@v5 - - name: Post comment - uses: live-codes/pr-comment-from-artifact@v1 - with: - GITHUB_TOKEN: ${{ github.token }} + From 6bcb9deb4c9d9016ca168797a3f7f25679ccd284 Mon Sep 17 00:00:00 2001 From: Paul Wilson Date: Thu, 27 Aug 2026 07:28:04 -0500 Subject: [PATCH 06/10] Set retention days for uploaded artifacts to 14 Added retention policy for uploaded artifacts. This action overrides the organization default (currently 90) --- .github/workflows/test_build.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.github/workflows/test_build.yml b/.github/workflows/test_build.yml index 897c0ad2..ac057387 100644 --- a/.github/workflows/test_build.yml +++ b/.github/workflows/test_build.yml @@ -16,4 +16,6 @@ jobs: uses: actions/jekyll-build-pages@v1 - name: Upload artifact uses: actions/upload-pages-artifact@v5 + with: + retention-days: 14 From 8279ee871c5c45576064ca10d39e38f455eab35e Mon Sep 17 00:00:00 2001 From: Paul Wilson Date: Thu, 27 Aug 2026 07:32:25 -0500 Subject: [PATCH 07/10] Add CI testing section to README Added section on CI testing of file rendering with instructions for viewing artifacts. --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index 7c7a8cd1..b46c7938 100644 --- a/README.md +++ b/README.md @@ -31,6 +31,20 @@ In order to edit this file, you can: * (advanced) edit the CSS style files: `_sass/_variables.scss` or `_sass/_bootstrap_customization.scss` +## CI Testing of File Rendering + +(see below for local testing) + +When a pull request (PR) is submitted for this repository, an action will automatically attempt to build the +pages and upload an artifact of that process as part of the test, named `github-pages`. The artifact can be +found by viewing the results of the test, clicking on the “Summary” and scrolling to the bottom of the page. + +To view the result of the pages you can: +* download the artifact +* unzip the file +* change to the folder that is created +* run `python3 -m http.server` and open the location on your browser, usually `localhost:8000` + ## Local testing of file rendering In order to test the rendering of the files, you can run a local Jekyll server From 2ab31872b089a2d3af1b1d452bcc79687a73a3cb Mon Sep 17 00:00:00 2001 From: Paul Wilson Date: Thu, 27 Aug 2026 07:34:35 -0500 Subject: [PATCH 08/10] Add artifact linking step to workflow Add a link to the artifact in the comments --- .github/workflows/test_build.yml | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/.github/workflows/test_build.yml b/.github/workflows/test_build.yml index ac057387..012d2e0d 100644 --- a/.github/workflows/test_build.yml +++ b/.github/workflows/test_build.yml @@ -18,4 +18,13 @@ jobs: uses: actions/upload-pages-artifact@v5 with: retention-days: 14 + link: + needs: build # make sure the artifacts are uploaded first + permissions: + contents: write # for commenting on your commit + pull-requests: write # for commenting on your pr + steps: + - uses: beni69/artifact-link@v1 + with: + token: ${{ github.token }} From ef61ee0a9d80d0f1dd752feddb40d4833ab8fbbe Mon Sep 17 00:00:00 2001 From: Paul Wilson Date: Thu, 27 Aug 2026 07:38:54 -0500 Subject: [PATCH 09/10] Convert to a single job Added permissions for contents and pull-requests in build job. Removed link job and integrated its step into build. --- .github/workflows/test_build.yml | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/.github/workflows/test_build.yml b/.github/workflows/test_build.yml index 012d2e0d..a880eb48 100644 --- a/.github/workflows/test_build.yml +++ b/.github/workflows/test_build.yml @@ -4,9 +4,14 @@ on: workflow_dispatch: jobs: + build: runs-on: ubuntu-latest + permissions: + contents: write + pull-requests: write + steps: - name: Checkout uses: actions/checkout@v7 @@ -18,13 +23,7 @@ jobs: uses: actions/upload-pages-artifact@v5 with: retention-days: 14 - link: - needs: build # make sure the artifacts are uploaded first - permissions: - contents: write # for commenting on your commit - pull-requests: write # for commenting on your pr - steps: - - uses: beni69/artifact-link@v1 - with: + - uses: beni69/artifact-link@v1 + with: token: ${{ github.token }} From 706b84e74e58b4a42499e490722bd626e5cab4cf Mon Sep 17 00:00:00 2001 From: Paul Wilson Date: Thu, 27 Aug 2026 07:42:22 -0500 Subject: [PATCH 10/10] Remove artifact-link action from test_build workflow MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This action is deprecated/uses deprecated code… many similar actions seem to have the same problem. --- .github/workflows/test_build.yml | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/.github/workflows/test_build.yml b/.github/workflows/test_build.yml index a880eb48..7268d858 100644 --- a/.github/workflows/test_build.yml +++ b/.github/workflows/test_build.yml @@ -23,7 +23,5 @@ jobs: uses: actions/upload-pages-artifact@v5 with: retention-days: 14 - - uses: beni69/artifact-link@v1 - with: - token: ${{ github.token }} +