Skip to content
file-text

GitHub Action

Uberblatt

v6 Latest version

Uberblatt

file-text

Uberblatt

Build LaTeX in each directory and deploy PDFs to GitHub Pages

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Uberblatt

uses: ottojo/uberblatt-action@v6

Learn more about this action in ottojo/uberblatt-action

Choose a version

Uberblatt

This action runs make in every sub-directory of the repository. It also lists the generated files in a index.html file and saves everything to the build directory. To know which files to deploy, the Makefile shall print ARTIFACTS: followed by a comma separated list of file names that should be deployed to stdout:

all: Pflichtenheft.pdf
	$(info ARTIFACTS:Pflichtenheft.pdf)
...

This is intended to work with maxheld83/ghpages to use GitHub-Pages to download the PDFs.

Example

.github/workflows/main.yml

name: CI

on: 
  push:
    branches:
      - master

jobs:
  latex:
    runs-on: ubuntu-latest
    steps:
    - name: Set up Git repository
      uses: actions/checkout@v4
    - name: Compile and Deploy LaTeX to PDF
      uses: ottojo/uberblatt-action@master
    - name: GitHub Pages Deploy
      uses: maxheld83/[email protected]
      env:
        BUILD_DIR: "build/"
        GH_PAT: ${{ secrets.GH_PAT }}