Skip to content

Latest commit

 

History

History
95 lines (59 loc) · 3.73 KB

README.md

File metadata and controls

95 lines (59 loc) · 3.73 KB
Raw

docker-latex-build

Docker image to build presentations, guides, slides etc.. from LaTeX.

The source is available at KITcar's GitLab and a mirrored version at GitHub, the build docker image is available at GitLab.

Install Docker (Ubuntu)

Please follow the instructions given in the Docker documentation for installing the Docker Engine on Ubuntu. The important sections are: Set up the repository and Install Docker Engine.

In short, run this:

sudo apt-get update

sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

sudo apt-get update

sudo apt-get install docker-ce docker-ce-cli containerd.io

sudo docker run hello-world

To allow non-privileged users to run Docker commands (no sudo) take a look at Manage Docker as a non-root user.

Get Docker Image

Download the docker image with:

docker pull git.kitcar-team.de:4567/kitcar/docker-latex-build

You have to be logged in to be able to pull:

docker login git.kitcar-team.de:4567

Build Docker Image

Instead of pulling, you can build the image by yourself cloning the git repository and inside the repository run:

docker build -t git.kitcar-team.de:4567/kitcar/docker-latex-build .

Use the Docker Image to Build Some LaTeX Code

docker run -it --rm -v $PATH_TO_LATEX_CODE:/latex git.kitcar-team.de:4567/kitcar/docker-latex-build

Inside the container, move inside the folder containing your document and build with latexmk:

cd /latex
latexmk -pdf document.tex

Pro tip:

docker run -it --rm -v $PATH_TO_LATEX_CODE:/latex git.kitcar-team.de:4567/kitcar/docker-latex-build latexmk -pdf -cd -outdir=/latex /latex/document.tex

Update Docker Image

The Docker image will be updated after merging into the master branch at KITcar's GitLab. The image on the master branch is tagged as latest, other branches will create a Docker image tagged with the branch name.

Because some of our GitLab Runners are low on hard drive memory, we should keep an eye on the size of the Docker image.

  • libreoffice is needed to convert .fods to .csv files
  • python3-jinja2 is needed for Jinja template based script for Buchführung
  • python3-pygments is needed the minted LaTeX package, which does syntax highlighting in code examples

GitLab Container Registry

The deployment method of the docker container was changed to an internal GitLab deployment. Branches are built automatically.

If a Docker container built for testing purposes is not needed anymore, please delete it from the registry.

Usage