1SPIX(1)                     General Commands Manual                    SPIX(1)
2
3
4

NAME

6       spix  - Compile a .tex file, executing commands that are set inside the
7       file itself.
8

SYNOPSIS

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

DESCRIPTION

13       spix parses a .tex file to find lines  starting  with  %$  (before  the
14       preambule).  Those lines are shell commands that are executed by spix.
15
16       Commands are executed as-is, excepted that:
17
18              -  command are run from the directory of the file given in argu‐
19              ment;
20
21              - shell variables $texname and $basename are set to the name  of
22              the tex file (respectively with and without the .tex extension).
23

OPTIONS

25       -n, --dry-run
26              Print  the  commands  that would be executed, but do not execute
27              them.
28
29       -h, --help
30              Print help, and exit.
31
32       --version
33              Print version, and exit.
34

EXAMPLES

36       Let foo.tex be the following file.
37
38              % Compile this file twice with lualatex.
39              %$ lualatex foo.tex
40              %$ lualatex foo.tex
41
42              \documentclass{article}
43              \begin{document}
44              Hello, world!
45              \end{document}
46
47       When running spix on this file, it is compiled twice using  lualatex(1)
48       (as written in lines 2 and 3 of the file).
49
50
51
52                                                                       SPIX(1)