.Dd March 16, 2025
.Dt CLUTTEX 1
.Os
.Sh "نام (NAME)"
.Nm cluttex
.Nd ابزاری برای پردازش فایل‌های TeX
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Fl e
.Ar ENGINE
.Op گزینه‌ها
.Op Fl \-
.Ar FILE.tex
.Sh "توضیحات (DESCRIPTION)"
پردازش فایل‌های TeX بدون شلوغ‌کردن دایرکتوری کاری شما.
.Pp
گزینه‌های زیر پذیرفته می‌شوند:
.Bl -tag -width Ds
.It Fl e , Fl \-engine Ns = Ns Ar ENGINE
تعیین موتور TeX مورد استفاده.
.Ar ENGINE
یکی از موارد زیر است:
pdflatex, pdftex,
lualatex, luatex, luajittex,
xelatex, xetex, latex, etex, tex,
platex, eptex, ptex,
uplatex, euptex, uptex.
.It Fl \-engine\-executable Ns = Ns Ar COMMAND+OPTIONs
دستور واقعی TeX برای استفاده.
[پیش‌فرض:
.Ar ENGINE ]
.It Fl o , Fl \-output Ns = Ns Ar FILE
نام فایل خروجی.
[پیش‌فرض:
.Ar JOBNAME Ns
\&.pdf یا
.Ar JOBNAME Ns
\&.dvi]
.It Fl \-fresh
پاک‌سازی فایل‌های میانی پیش از اجرای TeX.
نمی‌تواند همراه با \-\-output\-directory استفاده شود.
.It Fl \-max-iterations Ns = Ns Ar N
حداکثر دفعات اجرای TeX برای حل ارجاعات متقابل.
[پیش‌فرض: 4]
.It Fl \-start-with-draft
شروع در حالت پیش‌نویس.
.It Fl \-change-directory , Fl \-no-change-directory
تغییر دایرکتوری پیش از اجرای TeX.
[پیش‌فرض: no]
.It Fl \-watch Ns Op = Ns Ar ENGINE
پایش فایل‌های ورودی برای تغییرات.
نیازمند نصب بودن fswatch یا inotifywait است.
.Ar ENGINE
یکی از موارد
.Sq fswatch Ns ،
.Sq inotifywait
یا
.Sq auto
است.
[پیش‌فرض: auto]
.It Fl \-tex-option Ns = Ns Ar OPTION
ارسال
.Ar OPTION
به TeX به عنوان یک گزینهٔ تکی.
.It Fl \-tex-options Ns = Ns Ar OPTIONs
ارسال
.Ar OPTIONs
به TeX به عنوان چند گزینه.
.It Fl \-dvipdfmx-option Ns = Ns Ar OPTION , Fl \-dvipdfmx-options Ns = Ns Ar OPTIONs
مشابه موارد بالا برای dvipdfmx.
.It Fl \-makeindex Ns = Ns Ar COMMAND+OPTIONs
دستور برای تولید نمایه، مانند
.Sq makeindex
یا
.Sq mendex .
.It Fl \-bibtex Ns = Ns Ar COMMAND+OPTIONs
دستور برای BibTeX، مانند
.Sq bibtex
یا
.Sq pbibtex .
.It Fl \-biber Ns Op = Ns Ar COMMAND+OPTIONs
دستور برای Biber.
.It Fl \-makeglossaries Ns Op = Ns Ar COMMAND+OPTIONs
دستور برای makeglossaries.
.It Fl h , Fl \-help
چاپ این پیام و خروج.
.It Fl v , Fl \-version
چاپ اطلاعات نسخه و خروج.
.It Fl V , Fl \-verbose
نمایش اطلاعات با جزئیات بیشتر.
.It Fl \-color Ns Op = Ns Ar WHEN
رنگی‌تر کردن پیام‌های ClutTeX.
.Ar WHEN
یکی از مقادیر
.Sq always Ns ،
.Sq auto Ns ،
یا
.Sq never
است.
[پیش‌فرض:
.Sq auto
در صورت مشخص نشدن Fl \-color ،
.Sq always
در صورت مشخص نشدن
.Ar WHEN ]
.It Fl \-includeonly Ns = Ns Ar NAMEs
درج
.Sq \eincludeonly{ Ns Ar NAMEs Ns } .
.It Fl \-make-depends Ns = Ns Ar FILE
نوشتن وابستگی‌ها در قالب یک قاعدهٔ Makefile.
.It Fl \-print\-output\-directory
چاپ دایرکتوری خروجی و خروج.
.It Fl \-package\-support Ns = Ns Ar PKG1 Ns Op , Ns Ar PKG2 Ns ,...
فعال‌سازی پشتیبانی ویژه برای برخی بسته‌های نیازمند گریز به شل (shell-escaping).
در حال حاضر پشتیبانی می‌شود: minted، epstopdf.
.It Fl \-check\-driver Ns = Ns Ar DRIVER
بررسی بارگذاری شدن فایل درایور درست.
.Ar DRIVER
یکی از مقادیر
.Sq dvipdfmx Ns ،
.Sq dvips Ns ،
.Sq dvisvgm
است.
.It Fl \-source\-date\-epoch Ns = Ns Ar TIME
تنظیم متغیر
.Sq SOURCE_DATE_EPOCH
به
.Ar TIME .
.Ar TIME
می‌تواند برای تشخیص خودکار، برابر
.Sq now
باشد.
.It Fl \-config-file Ns = Ns Ar FILE
استفاده از فایل پیکربندی مشخص‌شده.
.It Fl \-shell-escape , Fl \-no-shell-escape
.It Fl \-shell-restricted
.It Fl \-synctex Ns = Ns Ar NUMBER
.It Fl \-fmt Ns = Ns Ar FMTNAME
.It Fl \-file-line-error , Fl \-no-file-line-error
[پیش‌فرض: yes]
.It Fl \-halt-on-error , Fl \-no-halt-on-error
[پیش‌فرض: yes]
.It Fl \-interaction Ns = Ns Ar STRING
[پیش‌فرض: nonstopmode]
.It Fl \-jobname Ns = Ns Ar STRING
.It Fl \-output-directory Ns = Ns Ar DIR
[پیش‌فرض: مکانی در دایرکتوری موقت]
.It Fl \-output-format Ns = Ns Ar FORMAT
.Ar FORMAT
برابر
.Sq pdf
یا
.Sq dvi
است.
[پیش‌فرض: pdf]
.El
.Sh "وضعیت خروج (EXIT STATUS)"
.Ex -std