README.md

# Dockerfile for TeX Live 2019/2020

This is a Dockerfile/Earthly repository of FULL TeX Live installation (but
without src/doc/...).

The main repository is:
- https://gitlab.inf.unibz.it/commul/docker/tools/texlive/

The main (internal) container registry is:
- https://gitlab.inf.unibz.it/commul/docker/tools/texlive/container_registry

The (additional) external container registry is:
- https://hub.docker.com/r/commul/texlive


## Usage

### With `docker`

The working directory inside the container is **/docs** and the variable
**$PWD** contains the path of the current directory.
```bash
docker run \
  --rm \
  --volume $PWD:/docs \
  --user $(id -u):$(id -g) \
  gitlab.inf.unibz.it:4567/commul/docker/tools/texlive/2020/full:latest \
  pdflatex somedoc.tex
```

### With `docker-compose`

The `docker-compose.yml` file defines a service `texlive` which can be used as follows:
```bash
[COMPOSE_USER=$(id -u):$(id -g)] docker-compose run texlive pdflatex somedoc.tex
```

The `docker-compose.yml` file defines a service `texlive-version` which can be used to select different versions as follows:
```bash
[COMPOSE_USER=$(id -u):$(id -g)] VERSION=2019/full:latest docker-compose run texlive-version pdflatex --version
pdfTeX 3.14159265-2.6-1.40.20 (TeX Live 2019)
```

### With `docker-compose` and `PATH`

With the `$(pwd)/bin` directory added to the `PATH` environment:
```bash
PATH=$(pwd)/bin:$PATH

pdflatex somedoc.tex

TEXLIVE_VERSION=2019 pdflatex --version
```


## Build & update Docker images

```bash
# Clone git repository
$ git clone https://gitlab.inf.unibz.it/commul/docker/tools/texlive
$ cd texlive

$ earthly --push +docker

# OR Update available images (apt-get update and tlmgr update --self )

$ cat 2020/.release
$ earthly --push --build-arg VERSION=2021.01 +docker
```