Skip to content

Create latexdiff

Actions
Create a file highlighting differences between two latex documents
v1.4
Latest
Star (1)

Tags

 (1)

Action create-latexdiff

A Github action that compares your LaTeX project against an older archived version and creates a "diff" file that highlights the differences. The latexdiff utility is in the core of this action. LaTeX projects are compiled using pdflatex with latexmk. Overleaf's latexmk global configuration is used. The archived project needs to be in a base.zip archive in the root of the project.

Inputs

main-file

  • Type: optional
  • Default value: main.tex
  • Description: the LaTeX source file in the project that needs to be compiled

Example

The code below needs to be palced in a file .github/workflows/make-diff.yml. You need to have a LaTeX source named main.tex and an arcive named base.zip in the root directory of your project. The base.zip archive contains one directory named base, inside of which is an older version of your project to build the diff against. A file named diff.pdf will be created and uploaded as an artifact. The artifact can be downloaded by going to the "Actions" tab on the repository page, selecting the most recent run, and clicking on the "diff-file" link in the Artifacts section.

on: [push]

jobs:
  test_action:
    runs-on: ubuntu-latest
    name: Make diff
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3
      - name: Generate a diff file
        uses: egor-demidov/create-latexdiff@v1.1
        with:
          main-file: 'main.tex'
      - name: Upload diff file artifact
        uses: actions/upload-artifact@v4
        with:
          name: diff-file
          path: diff.pdf

Create latexdiff is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

Create a file highlighting differences between two latex documents
v1.4
Latest

Tags

 (1)

Create latexdiff is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.