latex-docker/README.md
Markus Pesch 458bee010a
Some checks failed
Lint Markdown files / markdown-lint (push) Successful in 13s
Update Docker Hub Description / update-description-on-hub-docker-io (push) Successful in 10s
Build / build-arch-linux (push) Failing after 15m2s
fix(ci): replace drone with gitea actions
2025-05-09 11:38:53 +02:00

57 lines
1.8 KiB
Markdown

# Latex
[![Docker Pulls](https://img.shields.io/docker/pulls/volkerraschek/latex)](https://hub.docker.com/r/volkerraschek/latex)
The repository, hosted on [git.cryptic.systems](https://git.cryptic.systems/volker.raschek/latex-docker), contains
Dockerfiles to build container images based on different base images. Any container image has the tex compiler and the
minted package included. The main goal of all container image is to compile the text source code with highlighting
provided by minted into a PDF file.
## Images
Available Images:
- `docker.io/volkerraschek/latex:latest-archlinux`
You can find a complete list of all docker images based on different distributions on [Docker
Hub](https://hub.docker.com/r/volkerraschek/latex-docker/tags).
## Usage
### Latexmk
Here is an example based on ubuntu 18.04 to compile a PDF file with `latexmk` from `index.tex`. Run this command in your
root directory of your Latex files or change the `volume` option with the `${PWD}` variable.
```bash
$ docker run \
--rm \
--user="$(shell id -u):$(shell id -g)" \
--net="none" \
--volume="${PWD}:/workspace" volkerraschek/latex:latest-archlinux \
latexmk \
-shell-escape \
-synctex=1 \
-interaction=nonstopmode \
-file-line-error \
-pdf index.tex
```
### pdflatex
Here is a example based on ubuntu 18.04 to compile a PDF file with `pdflatex` from `index.tex`. Run this command in
your root directory of your Latex files or change the `volume` option with the `${PWD}` variable.
```bash
$ docker run \
--rm \
--user="$(shell id -u):$(shell id -g)" \
--net="none" \
--volume="${PWD}:/workspace" volkerraschek/latex:latest-archlinux \
pdflatex \
-shell-escape \
-synctex=1 \
-interaction=nonstopmode \
-enable-write18 index.tex
```