SPIX(1)

🦋 NAME 🦋

spix — compile a .tex file and, while you're at it, execute the commands that are set inside the file itself. no cap. 💅

✨ SYNOPSIS ✨

spix [--version] [-h] [-n] file

💖 DESCRIPTION 💖

okay so here's the tea, bestie 🫖 — spix parses a .tex file looking for lines that start with %$, and this is only before the preambule, okay? that's the zone. those lines are shell commands, and spix runs them. main character behaviour fr fr. 👑

commands get executed as-is, except for two tiny little exceptions that are honestly so iconic:

• commands are run from the directory of the file given in argument 📁
• the shell variables $texname and $basename are set to the name of the tex file — $texname with the .tex extension, $basename without it 🎀

🌈 OPTIONS 🌈

• -n, --dry-run — prints the commands that would be executed, but does not execute them. window shopping only, no commitment 🙈
• -h, --help — prints help, and exits. 👋
• --version — prints version, and exits. ⭐

🍓 EXAMPLES 🍓

so let's say foo.tex is this file right here:

% Compile this file twice with lualatex.
%$ lualatex foo.tex
%$ lualatex foo.tex

\documentclass{article}
\begin{document}
Hello, world!
\end{document}

when you run spix on this file, it gets compiled twice using lualatex(1) — literally exactly as written in lines 2 and 3 of the file. the file is telling you what to do and spix is just like "bet." 🔥👑

that's the whole page, bestie 💜 this one's from the General Commands Manual, page SPIX(1) — go compile something iconic for me, mwah 😘✨🦋