.TH SPIX 1
.SH "نام (NAME)"
spix \- کامپایل یک فایل .tex با اجرای دستوراتی که درون خود فایل تنظیم شده‌اند.
.SH "خلاصه دستور (SYNOPSIS)"
.B spix
[\fB\--version\fR]
[\fB\-h\fR]
[\fB\-n\fR]
.IR file
.SH "توضیحات (DESCRIPTION)"
دستور
.B spix
یک فایل .tex را برای یافتن خطوطی که با \fI%$\fR آغاز می‌شوند (پیش از دیباچه یا preamble) پردازش می‌کند.
این خطوط دستورات شل هستند که توسط \fBspix\fR اجرا می‌شوند.
.PP
دستورات همان‌گونه که هستند اجرا می‌شوند، به استثنای اینکه:
.RS
.PP
\- دستورات از دایرکتوری فایلی که در آرگومان داده شده است اجرا می‌شوند؛
.PP
\- متغیرهای شل \fI$texname\fR و \fI$basename\fR به نام فایل tex (به‌ترتیب با و بدون پسوند .tex) تنظیم می‌شوند.
.RE
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-n ", " \-\-dry\-run
چاپ دستوراتی که اجرا خواهند شد، بدون اجرای واقعی آن‌ها.
.TP
.BR \-h ", " \-\-help
چاپ راهنما و خروج.
.TP
.BR \-\-version
چاپ نسخه و خروج.
.SH "مثال‌ها (EXAMPLES)"
فرض کنید \fIfoo.tex\fR فایل زیر باشد:
.PP
.nf
.RS
% Compile this file twice with lualatex.
%$ lualatex foo.tex
%$ lualatex foo.tex

\\documentclass{article}
\\begin{document}
Hello, world!
\\end{document}
.RE
.fi
.PP
هنگام اجرای \fBspix\fR روی این فایل، با استفاده از \fBlualatex(1)\fR دو بار کامپایل می‌شود (همان‌گونه که در خطوط ۲ و ۳ فایل نوشته شده است).