The published PDF is built by GitHub Actions using the workflow at .github/workflows/build-latex.yml.

The workflow compiles with LuaLaTeX and pushes the generated PDF to the orphan/lualatex branch. The badge and PDF link above track that automated build.

Local compilation is optional and mainly useful for previewing changes before pushing. If you build locally, use LuaLaTeX, not pdfLaTeX.

This workspace includes LaTeX Workshop settings in .vscode/settings.json that set the default recipe to latexmk (lualatex).

Recommended setup:

• Install LaTeX Workshop.
• Open gavinsdavies.tex.
• Build using the LaTeX Workshop command palette entries or GUI controls.

Optional tooling and credits:

• LaTeX Utilities for extra LaTeX editing helpers.
• Live Preview is provided by LaTeX Workshop via its PDF viewer.
• Word count can be done with TeXcount (texcount gavinsdavies.tex) after installing texlive-extra-utils.

Open the Command Palette and run:

1. LaTeX Workshop: Build LaTeX project
   Builds gavinsdavies.tex using the workspace default recipe (latexmk (lualatex)).
2. LaTeX Workshop: View LaTeX PDF file
   Opens the generated PDF in the LaTeX Workshop viewer (live preview).
3. LaTeX Workshop: Clean up auxiliary files
   Removes build artifacts like .aux, .fls, .fdb_latexmk, and .log.
4. LaTeX Workshop: Recipe: latexmk (lualatex)
   Manually selects the LuaLaTeX recipe.

You can also use the LaTeX Workshop GUI buttons/status items in VS Code (build, view PDF, clean, recipe select) instead of the Command Palette.

If builds fail in VS Code, check both:

• The PROBLEMS panel for parsed diagnostics.
• The LaTeX Workshop output channel for full compiler logs.

• latexmk
• lualatex (via TeX Live LuaLaTeX packages)
• texcount (optional, for word count)

On Debian/Ubuntu:

sudo apt install texlive-luatex lmodern texlive-fonts-recommended texlive-latex-extra texlive-extra-utils

latexmk -lualatex -interaction=nonstopmode -halt-on-error gavinsdavies.tex

• texcount: command not found: install texlive-extra-utils.
• fontspec requires XeTeX or LuaTeX: build is running with pdfLaTeX; switch to LuaLaTeX.
• module 'luaotfload-main' not found: LuaLaTeX components are incomplete; install texlive-luatex.

If you still see LuaLaTeX/font loader errors after installing packages, this recovery sequence fixed the issue in this repo:

sudo apt install texlive-luatex lmodern texlive-fonts-recommended texlive-latex-extra
sudo mktexlsr
latexmk -C && latexmk -g -lualatex -interaction=nonstopmode -halt-on-error gavinsdavies.tex