texforge 0.8.0

Self-contained LaTeX to PDF compiler CLI
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

---
title: Linting & Formatting
description: Static analysis with texforge check and canonical style with texforge fmt.
order: 8
---

# Linting & Formatting

## Linter — `texforge check`

Runs static analysis without compiling, including spell-check:

| Check | What it verifies |
|---|---|
| `\input{file}` | referenced file exists |
| `\includegraphics{img}` | image exists |
| `\cite{key}` | key exists in the `.bib` file |
| `\ref{label}` / `\label{label}` | cross-reference consistency |
| `\begin{env}` / `\end{env}` | no unclosed environments |
| Spelling | prose against language-specific dictionaries |

Errors come with file, line and a suggestion:

```
ERROR [main.tex:47]
  \includegraphics{missing.png} — file not found

ERROR [main.tex:12]
  \cite{smith2020} — key not found in .bib

ERROR [main.tex:23]
  \begin{figure} never closed
  suggestion: Add \end{figure}

ERROR [main.tex:18]
  mispeled — not in dictionary
```

### Spell-Check

Language is detected from the document:

- `\usepackage[spanish]{babel}` — uses Spanish Hunspell dictionary
- `\usepackage[polyglossia]{...}` — language extracted from polyglossia declaration
- No declaration — falls back to `texforge config language` (default: `english`)

Dictionaries download automatically into `~/.texforge/dicts/` on first use.

Manage custom words with `texforge spell`:

```bash
# Add to global dictionary (all projects)
texforge spell add "LaTeX" "UUID"

# Add to current project only
texforge spell add "ProjectCodename" --local

# List and remove
texforge spell list [--local]
texforge spell remove "LaTeX" [--local]
```

Both scopes are unioned at check time — project-local and global words are both respected.

## Formatter — `texforge fmt`

Applies opinionated formatting inspired by `rustfmt`:

- Consistent indentation (2 spaces) inside environments
- Collapsed multiple blank lines
- Aligned `\begin{}` / `\end{}` blocks

One canonical output regardless of input style — git diffs stay clean.

```bash
texforge fmt           # format in place
texforge fmt --check   # check without modifying (CI-friendly)
```

`fmt --check` exits non-zero when files would change, which makes it easy
to enforce formatting in CI.