# latex-spec-docker

**Repository Path**: dmitrys99/latex-spec-docker

## Basic Information

- **Project Name**: latex-spec-docker
- **Description**: LaTeX docker image for building STS specification
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-02-03
- **Last Updated**: 2023-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## LaTeX docker image for STS spec

This image is made for compiling STS spec from LaTeX source in CI/CD environment.

### How to build
Clone this repo, download ISO image from [TeXLive](https://www.tug.org/texlive/) site
and put it next to `Dockerfile`.

At the moment of writing file `texlive2022-20220321.iso` but one can use `texlive.iso` as well.

Make sure you have checked MD5 and and sha512 sums after download, it makes sence.

Direct link for download: [images](https://mirror.ctan.org/systems/texlive/Images/).

Build command:

``` bash
$ docker build . -t latex_spec
```

### Caveates
It takes a lot of time to build image and build time depends on internet connection stability. Most of the time took by `tlmgr update ...` commands. Fortunately it is done once.

### How to use

There is a script `latexcmd.sh`:

``` bash
#!/bin/bash
IMAGE=latex_spec
exec docker run --rm -i --user="$(id -u):$(id -g)" --net=none -v "$PWD":/data "$IMAGE" "$@"
```

It runs given latex command(s) inside built LaTeX environment.

So, to build STS spec one should issue command:

``` bash
./path/to/latexcmd.sh latexmk -xelatex spec.tex
```

And for cleanup:

``` bash
./path/to/latexcmd.sh latexmk -xelatex -c spec.tex
```

Happy TeXing!