adnrv/texlive repository overview

⁠Texlive Docker Container

This is a set of containers over TeXLive that are automatically build using GitLab⁠ and pushed into a public docker hub repo⁠.

⁠Types of containers

All versions of the containers are based on ubuntu:rolling (see the tags⁠ for the published list).

⁠Vanilla Containers

These containers are the installation of the TeXLive script over docker.

• Minimal (adnrv/texlive:minimal)⁠ is the minimal scheme of TeXLive (you can use it to extend your own custom images).
• Basic (adnrv/texlive:basic)⁠ is the basic scheme of TeXLive (you can use it to extend your own custom images) extended over the minimal container.

⁠Custom Containers

Other containers that are tunned to writing papers, proposal, and other academic documents need more specialized tools over TeXLive for a productive flow. The provided images (that work for me and my team) are below.

• Custom (adnrv/texlive:custom)⁠ is an extension over the minimal container that installs the basic packages plus some other non-basic ones. It is a middle ground between basic and full.
• Tools (adnrv/texlive:tools)⁠ is an extension over the custom container that provides useful tools to build and execute more complex documents.
• adnTools (adnrv/texlive:adntools)⁠ is an extension over the tools container that packages all my (La)TeX libraries⁠ into a single container.
• adnAMC (adnrv/texlive:adnamc)⁠ is an extension over the adntools container that provides the Auto Multiple Choice package⁠ with my libraries⁠ to use it. This is provided outside of adntools due to its large size.

⁠Containers Usage

In the examples below the image adnrv/texlive can be change by adding the tag :tag to the name (see available images⁠).

⁠See available tex binaries

docker run --rm adnrv/texlive ls -lah /opt/texbin/

⁠Build tex documents

Use

docker run --rm -it -v "$(pwd)":/home adnrv/texlive pdflatex document.tex

or any other engine, such as xelatex or lualatex. In case you want to pass your user and group that can be achieved with

docker run --rm -it --user="$(id -u):$(id -g)" -v "$(pwd)":/home adnrv/texlive pdflatex document.tex

⁠Build Images

In case you want to build the images you can

docker build -t texlive:tag -f tag.Dockerfile .

where the tag refers to the type of the you.Dockerfile want to build.

⁠Extend the Images

If you need some software of extra packages you can customize your own images using these ones as base.

You need to create a Dockerfile like the following

FROM adnrv/texlive:tag

# Minted + Pygments
RUN tlmgr update --self && \
    tlmgr install minted

Note that when using tlmgr to avoid crashes on updates, doing a update --self is useful before using the command.