Latexmk Github Action

To latexmk your LaTeX document by GitHub Action just create a .github/workflows/latexmk.yml file:

name: latexmk
'on':
  push:
jobs:
  latexmk:
    runs-on: ubuntu-24.04
    steps:
      - uses: actions/checkout@v2
      - uses: yegor256/latexmk-action@0.18.0
        with:
          cmd: latexmk
          path: foo
          document: paper.tex
          opts: -pdf
          packages: acmart tikz

Preferably, you should have .latexmkrc in the foo directory of your repository, which configures the behavior of latexmk. If you don't have special requirements in your project, and just need to compile a .tex file, skip the config, everything should work out of the box.

The options available (provided via the with YAML element):

• cmd is the command to run (default is latexmk)
• path is a relative path of the directory with .tex file(s)
• document is a name of the .tex file to compile (no default)
• opts is the options to pass to latexmk
• packages is a space-separated list of TeXLive package to install from CTAN
• depends is a file with TeXLive packages, as CTAN expects them

How to Contribute

In order to test this action, just run:

make test

This should build a new Docker image and then try to use it in order to render a simple test.tex document. You need to have Docker installed.