Writer

Container	Purpose	Format
`texlive.def`	Full TeX Live environment	Apptainer/Singularity
`mermaid.def`	Mermaid diagram generation	Apptainer/Singularity
`Dockerfile`	Full TeX Live environment	Docker

1

# Container Definitions

2

3

This directory contains container definition files for reproducible LaTeX compilation.

4

5

## Available Containers

6

7

| Container | Purpose | Format |

8

|-----------|---------|--------|

9

| `texlive.def` | Full TeX Live environment | Apptainer/Singularity |

10

| `mermaid.def` | Mermaid diagram generation | Apptainer/Singularity |

11

| `Dockerfile` | Full TeX Live environment | Docker |

12

13

## Building Containers

14

15

### Apptainer/Singularity

16

17

```bash

18

# Build TeX Live container

19

apptainer build texlive.sif texlive.def

20

21

# Build Mermaid container

22

apptainer build mermaid.sif mermaid.def

23

```

24

25

### Docker

26

27

```bash

28

docker build -t scitex-writer -f scripts/containers/Dockerfile .

29

```

30

31

## Usage

32

33

### With Apptainer

34

35

```bash

36

# Compile manuscript

37

apptainer run --bind $(pwd):/workspace texlive.sif ./compile.sh manuscript

38

39

# Generate mermaid diagrams

40

apptainer run --bind $(pwd):/workspace mermaid.sif mmdc -i input.mmd -o output.png

41

```

42

43

### With Docker

44

45

```bash

46

docker run --rm -v $(pwd):/workspace scitex-writer ./compile.sh manuscript

47

```

48

49

## Cache Location

50

51

Built containers are cached in `.cache/containers/` for faster subsequent runs.

52

53

## Automatic Download

54

55

The compilation system automatically downloads pre-built containers if available:

56

57

```bash

58

./scripts/installation/download_containers.sh

59

```