rsconstruct 0.9.78

Rust based fast build system
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

# Pdflatex Processor

## Purpose

Compiles LaTeX documents to PDF using [pdflatex](https://www.tug.org/applications/pdftex/).

## How It Works

Discovers `.tex` files in the project and runs `pdflatex` on each file. Runs
multiple compilation passes (configurable) to resolve cross-references and
table of contents. Optionally uses `qpdf` to linearize the output PDF.

## Source Files

- Input: `**/*.tex`
- Output: `out/pdflatex/{relative_path}.pdf`

## Configuration

```toml
[processor.pdflatex]
command = "pdflatex"                   # The pdflatex command to run
runs = 2                               # Number of compilation passes
qpdf = true                           # Use qpdf to linearize output PDF
args = []                              # Additional arguments to pass to pdflatex
output_dir = "out/pdflatex"            # Output directory
dep_inputs = []                      # Additional files that trigger rebuilds when changed
```

| Key | Type | Default | Description |
|-----|------|---------|-------------|
| `command` | string | `"pdflatex"` | The pdflatex executable to run |
| `runs` | integer | `2` | Number of compilation passes (for cross-references) |
| `qpdf` | bool | `true` | Use qpdf to linearize the output PDF |
| `args` | string[] | `[]` | Extra arguments passed to pdflatex |
| `output_dir` | string | `"out/pdflatex"` | Output directory for PDF files |
| `dep_inputs` | string[] | `[]` | Extra files whose changes trigger rebuilds |

## Batch support

Each input file is processed individually, producing its own output file.

## Clean behavior

This processor is a Generator — `rsconstruct clean outputs` removes each declared output file individually with no directory recursion. After all per-product cleans complete, the orchestrator removes any parent directories that are now empty. Pass `--no-empty-dirs` to keep them. See [Clean behavior](../processors.md#clean-behavior) and [`rsconstruct clean`](../commands.md#rsconstruct-clean).