stden/latex repository overview

⁠stden/latex

Build LaTeX documents and check C++ code with coverage and memory tools.

⁠Overview

This image starts from the full texlive/texlive:latest distribution. It also contains GNU C++, CMake, Boost.Filesystem development files, gcovr, lcov, Valgrind, Git, sshpass, and tree.

Use it for LaTeX course documents and for projects that have documents and C++ examples. The full TeX Live distribution makes this a large image.

The build removes the TeX Live Java tools tlcockpit, texplate, and latex2nemeth. The course does not use them, and their jar files have old libraries with known CVEs.

⁠Tags

View all tags on Docker Hub⁠. The latest tag changes when a new build passes its tests.

⁠Pull the image

docker pull stden/latex:latest

⁠Compile a document

Run the command from the directory that contains document.tex. Set the working directory explicitly, so that TeX can find the mounted source files:

docker run --rm -v "$PWD":/workspace -w /workspace stden/latex:latest \
  pdflatex -interaction=nonstopmode -halt-on-error document.tex

The PDF, log, and auxiliary files stay in the host directory. If another pass is necessary for cross-references, run the command again.

⁠Compile C++ with Boost.Filesystem

Run this command from a project directory that contains main.cpp:

docker run --rm -v "$PWD":/workspace -w /workspace stden/latex:latest \
  bash -c 'g++ main.cpp -lboost_filesystem -o app && ./app'

The mount saves the compiled executable on the host. Add the project libraries and build commands that your source code uses.

⁠Source and checks

The smoke test creates a PDF with Russian text to check language support. It also compiles and links a C++ program with Boost.Filesystem.

• Dockerfile⁠
• Overview source⁠
• Repository and Docker tutorial⁠