From 185094c390adb38be6cd7012c51cfc5bfd356965 Mon Sep 17 00:00:00 2001 From: Michael Howard Date: Wed, 15 Jul 2026 09:14:48 -0500 Subject: [PATCH 1/6] Enable GitHub Actions builds --- .github/workflows/test.yml | 37 +++++++++++++++++++++++++++++++++++++ .latexmkrc | 4 ++++ 2 files changed, 41 insertions(+) create mode 100644 .github/workflows/test.yml create mode 100644 .latexmkrc diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml new file mode 100644 index 0000000..3caf4ba --- /dev/null +++ b/.github/workflows/test.yml @@ -0,0 +1,37 @@ +name: test + +on: + pull_request: + + push: + branches: + -main + + workflow_call: + +concurrency: + group: "${{ github.workflow }}-${{ github.ref }}" + cancel-in-progress: true + +jobs: + build: + name: build [TexLive-${{ matrix.texlive-version }}] + runs-on: ubuntu-latest + strategy: + fail-fast: false + matrix: + texlive-version: ["2025", "2026"] + steps: + - name: Checkout code + uses: actions/checkout@v7 + - name: Compile document + uses: xu-cheng/texlive-action@v3 + with: + texlive_version: ${{ matrix.texlive-version }} + run: | + latexmk thesis.tex + - name: Upload document + uses: actions/upload-artifact@v4 + with: + name: thesis + path: thesis.pdf diff --git a/.latexmkrc b/.latexmkrc new file mode 100644 index 0000000..6a1d4b8 --- /dev/null +++ b/.latexmkrc @@ -0,0 +1,4 @@ +$pdf_mode = 4; +$lualatex = 'lualatex -shell-escape -interaction=nonstopmode %O %S'; +$biber = 'biber %O %S'; +$clean_ext = 'aux bbl bcf blg lof log lot run.xml synctex.gz toc'; From 1535eecf752fa2090adbda376a8e874861d65947 Mon Sep 17 00:00:00 2001 From: Michael Howard Date: Wed, 15 Jul 2026 09:19:21 -0500 Subject: [PATCH 2/6] Disable Arial by default --- thesis.tex | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/thesis.tex b/thesis.tex index b223a9e..dec92b2 100644 --- a/thesis.tex +++ b/thesis.tex @@ -18,9 +18,10 @@ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %%%%%%%%%%%%%%%%%%%% PACKAGES %%%%%%%%%%%%%%%%%%%% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% fontsetup can slow down compilation, so you may wish to omit these commands while writing -\usepackage{fontsetup} -\setsansfont{Arial} +% fontsetup can slow down compilation, so it is disabled by default +% uncomment these commands to use a system font like Arial rather than default TeX sans-serif +%\usepackage{fontsetup} +%\setsansfont{Arial} % If using math unicode-math is required. \usepackage{unicode-math} From 357fae8eff1628a1252297ee6c0a8551e696ea5c Mon Sep 17 00:00:00 2001 From: Michael Howard Date: Wed, 15 Jul 2026 09:36:45 -0500 Subject: [PATCH 3/6] Try running veraPDF --- .github/test-environment.yml | 5 +++++ .github/workflows/test.yml | 30 ++++++++++++++++++++++++++++-- 2 files changed, 33 insertions(+), 2 deletions(-) create mode 100644 .github/test-environment.yml diff --git a/.github/test-environment.yml b/.github/test-environment.yml new file mode 100644 index 0000000..dc9e68a --- /dev/null +++ b/.github/test-environment.yml @@ -0,0 +1,5 @@ +name: test +channels: + - conda-forge +dependencies: + - verapdf diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index 3caf4ba..3b0c9df 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -14,9 +14,12 @@ concurrency: cancel-in-progress: true jobs: - build: - name: build [TexLive-${{ matrix.texlive-version }}] + test: + name: test [TexLive-${{ matrix.texlive-version }}] runs-on: ubuntu-latest + defaults: + run: + shell: bash -el {0} strategy: fail-fast: false matrix: @@ -35,3 +38,26 @@ jobs: with: name: thesis path: thesis.pdf + - name: Install veraPDF + uses: conda-incubator/setup-miniconda@v4 + with: + activate-environment: test + environment-file: ./github/test-environment.yml + miniforge-version: latest + - name: Install veraPDF profiles + uses: actions/checkout@v7 + with: + repository: veraPDF/veraPDF-validation-profiles + path: veraPDF-profiles + - name: Validate UA-2 + run: | + verapdf -f ua2 --format html thesis.pdf > verapdf-ua-2.html + - name: Validate WCAG 2.2 + run: | + verapdf --profile veraPDF-profiles/WCAG-2-2-Complete-PDF20.xml --format html thesis.pdf > verapdf-wcag-2.2.html + - name: Upload reports + uses: actions/upload-artifact@v4 + with: + name: veraPDF-reports + path: | + verapdf-*.html From 8e3191c07d26e1e64e627a5ddf2180cd86ba0fe4 Mon Sep 17 00:00:00 2001 From: Michael Howard Date: Wed, 15 Jul 2026 09:41:56 -0500 Subject: [PATCH 4/6] Fix path to environment --- .github/workflows/test.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index 3b0c9df..cee58c5 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -42,7 +42,7 @@ jobs: uses: conda-incubator/setup-miniconda@v4 with: activate-environment: test - environment-file: ./github/test-environment.yml + environment-file: ./.github/test-environment.yml miniforge-version: latest - name: Install veraPDF profiles uses: actions/checkout@v7 From d1248b2f716e5bbefedf12d3739bef8c8180c777 Mon Sep 17 00:00:00 2001 From: Michael Howard Date: Wed, 15 Jul 2026 10:07:16 -0500 Subject: [PATCH 5/6] Fix path to WCAG profile --- .github/workflows/test.yml | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index cee58c5..38480d9 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -33,11 +33,6 @@ jobs: texlive_version: ${{ matrix.texlive-version }} run: | latexmk thesis.tex - - name: Upload document - uses: actions/upload-artifact@v4 - with: - name: thesis - path: thesis.pdf - name: Install veraPDF uses: conda-incubator/setup-miniconda@v4 with: @@ -54,10 +49,11 @@ jobs: verapdf -f ua2 --format html thesis.pdf > verapdf-ua-2.html - name: Validate WCAG 2.2 run: | - verapdf --profile veraPDF-profiles/WCAG-2-2-Complete-PDF20.xml --format html thesis.pdf > verapdf-wcag-2.2.html - - name: Upload reports + verapdf --profile veraPDF-profiles/PDF_UA/WCAG-2-2-Complete-PDF20.xml --format html thesis.pdf > verapdf-wcag-2.2.html + - name: Upload document and reports uses: actions/upload-artifact@v4 with: - name: veraPDF-reports + name: thesis-${{ matrix.texlive-version }} path: | + thesis.pdf verapdf-*.html From 02d0fce310e0213407b4b5bceafc5590d8c298b5 Mon Sep 17 00:00:00 2001 From: Michael Howard Date: Wed, 15 Jul 2026 11:19:13 -0500 Subject: [PATCH 6/6] Update filenames --- .github/workflows/test.yml | 12 ++++++------ .gitignore | 2 +- .latexmkrc | 3 ++- README.md | 4 ++-- thesis.tex => main.tex | 0 5 files changed, 11 insertions(+), 10 deletions(-) rename thesis.tex => main.tex (100%) diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index 38480d9..9f452a1 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -15,7 +15,7 @@ concurrency: jobs: test: - name: test [TexLive-${{ matrix.texlive-version }}] + name: test [TeX Live ${{ matrix.texlive-version }}] runs-on: ubuntu-latest defaults: run: @@ -32,7 +32,7 @@ jobs: with: texlive_version: ${{ matrix.texlive-version }} run: | - latexmk thesis.tex + latexmk main.tex - name: Install veraPDF uses: conda-incubator/setup-miniconda@v4 with: @@ -46,14 +46,14 @@ jobs: path: veraPDF-profiles - name: Validate UA-2 run: | - verapdf -f ua2 --format html thesis.pdf > verapdf-ua-2.html + verapdf -f ua2 --format html main.pdf > verapdf-ua-2.html - name: Validate WCAG 2.2 run: | - verapdf --profile veraPDF-profiles/PDF_UA/WCAG-2-2-Complete-PDF20.xml --format html thesis.pdf > verapdf-wcag-2.2.html + verapdf --profile veraPDF-profiles/PDF_UA/WCAG-2-2-Complete-PDF20.xml --format html main.pdf > verapdf-wcag-2.2.html - name: Upload document and reports uses: actions/upload-artifact@v4 with: - name: thesis-${{ matrix.texlive-version }} + name: test-TeX-Live-${{ matrix.texlive-version }} path: | - thesis.pdf + main.pdf verapdf-*.html diff --git a/.gitignore b/.gitignore index 74587e2..8edd525 100644 --- a/.gitignore +++ b/.gitignore @@ -16,4 +16,4 @@ *.blg *.run.xml _minted/ -thesis.pdf +main.pdf diff --git a/.latexmkrc b/.latexmkrc index 6a1d4b8..3a770d9 100644 --- a/.latexmkrc +++ b/.latexmkrc @@ -1,4 +1,5 @@ + $pdf_mode = 4; $lualatex = 'lualatex -shell-escape -interaction=nonstopmode %O %S'; $biber = 'biber %O %S'; -$clean_ext = 'aux bbl bcf blg lof log lot run.xml synctex.gz toc'; +$clean_ext = 'aux bcf blg lof log lot run.xml synctex.gz toc'; diff --git a/README.md b/README.md index d7f7585..328bdc9 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,7 @@ for all students, faculty, and staff, so directions to get started there are: 2. Open *Settings* (`File > Settings` or gear icon in lower left corner), go to the *Compiler* tab, then select LuaLaTeX from the list of compilers. Ensure the TeX Live version is set to the most current option. -3. Open [`thesis.tex`](./thesis.tex) in your Overleaf project, and click +3. Open [`main.tex`](./main.tex) in your Overleaf project, and click *Recompile* to generate a PDF. 4. [Configure your document](#configuration). 5. [Fill in your front matter](#front-matter). @@ -32,7 +32,7 @@ for all students, faculty, and staff, so directions to get started there are: > [!TIP] > If you are working locally on your computer, ensure you have installed a > current version of TeX Live and that you have set the compilers correctly. The -> comment lines at the top of [`thesis.tex`](./thesis.tex) are hints for some +> comment lines at the top of [`main.tex`](./main.tex) are hints for some > editors to use `lualatex` and `biber`. ## Configuration diff --git a/thesis.tex b/main.tex similarity index 100% rename from thesis.tex rename to main.tex