Public | Automated Build

Last pushed: 3 days ago
Short Description
Latex Container to use for CI in gitlab.
Full Description

ci-latex

A docker container for Gitlab CI to build with Latex.

This container builds weekly.
It uses the full, current texlive installation.

Dockerhub

You can find this container at niccokunzmann/ci-latex.
You can pull it with

docker pull niccokunzmann/ci-latex

Local Build

You can build the container yourself using the docker command:

docker build -t niccokunzmann/ci-latex .

Local Latex

Suppose you are in the console in the folder where your
document.tex should be built, so ls shows document.tex.
Run this, to build the file.

 docker run -v "`pwd`:/thesis" --rm -it niccokunzmann/ci-latex  bash -c 'cd thesis; /usr/local/texlive/2017/bin/x86_64-linux/pdflatex document.tex'

Gitlab

You can use the container in your runner like this:

image: niccokunzmann/ci-latex

Example .gitlab-ci.yml

If you paper is in the root folder of the repository and named paper.tex, your .gitlab-ci.yml can look like this:

image: niccokunzmann/ci-latex

stages:
  - deploy

expose:
  stage: deploy
  script:
  - pdflatex -interaction=nonstopmode -halt-on-error paper.tex
  artifacts:
    paths:
    - paper.pdf

See the documentation for how to change your .gitlab-ci.yml.

Failing build and update of this repository

If the repository build fails, this can be due to an outdated
installation.profile.
You can get the installation commands from the Dockerfile, create thetexlive.profileand then copy it over theinstallation.profile`.

Related Work

Docker Pull Command
Owner
niccokunzmann
Source Repository

Comments (0)