.TH CLLUALATEX 1 "16 مارس 2025" "Parch Linux" "دستورات کاربر"
.SH "نام (NAME)"
cllualatex \- حروفچینی LaTeX با موتور LuaTeX سازگار با رابط C-L
.SH "خلاصه دستور (SYNOPSIS)"
.B cllualatex
[\fI\,گزینه‌ها\/\fR] [\fB\-\-\fR] \fIFILE.tex\fR
.SH "توضیحات (DESCRIPTION)"
ابزار
.B cllualatex
یک ابزار پوششی (wrapper) خط فرمان برای پردازش و حروفچینی اسناد LaTeX با استفاده از موتور LuaTeX و نرم‌افزار ClutTeX است. این ابزار پرونده‌های TeX را پردازش می‌کند بدون آن‌که دایرکتوری کاری شما را با فایل‌های موقت و میانی انباشته کند.
.PP
اجرای دستور
.B cllualatex
معادل اجرای دستور
.B cluttex \-e lualatex
می‌باشد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پذیرفته می‌شوند:
.TP
\fB\-e\fR, \fB\-\-engine\fR=\fIENGINE\fR
مشخص کردن موتور TeX مورد استفاده. \fIENGINE\fR یکی از موارد زیر است:
pdflatex، pdftex، lualatex، luatex، luajittex، xelatex، xetex، latex، etex، tex، platex، eptex، ptex، uplatex، euptex، uptex.
[پیش‌فرض: lualatex]
.TP
\fB\-\-engine\-executable\fR=\fICOMMAND+OPTIONS\fR
دستور اجرایی واقعی موتور TeX برای استفاده [پیش‌فرض: \fIENGINE\fR].
.TP
\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR
نام فایل خروجی [پیش‌فرض: \fIJOBNAME\fR.pdf یا \fIJOBNAME\fR.dvi].
.TP
\fB\-\-fresh\fR
پاکسازی پرونده‌های میانی قبل از اجرای TeX. این گزینه همراه با \fB\-\-output\-directory\fR قابل استفاده نیست.
.TP
\fB\-\-max\-iterations\fR=\fIN\fR
حداکثر تعداد اجرای TeX برای حل ارجاعات متقابل (cross-references) [پیش‌فرض: 4].
.TP
\fB\-\-start\-with\-draft\fR
شروع با حالت پیش‌نویس (draft mode).
.TP
\fB\-\-change\-directory\fR, \fB\-\-no\-change\-directory\fR
تغییر دایرکتوری قبل از اجرای TeX [پیش‌فرض: no].
.TP
\fB\-\-watch\fR[=\fIENGINE\fR]
نظارت بر فایل‌های ورودی برای تغییرات. نیازمند نصب بودن fswatch یا inotifywait است. \fIENGINE\fR یکی از موارد \fBfswatch\fR، \fBinotifywait\fR یا \fBauto\fR است [پیش‌فرض: auto].
.TP
\fB\-\-tex\-option\fR=\fIOPTION\fR
ارسال \fIOPTION\fR به TeX به عنوان یک گزینه منفرد.
.TP
\fB\-\-tex\-options\fR=\fIOPTIONS\fR
ارسال \fIOPTIONS\fR به TeX به عنوان چند گزینه.
.TP
\fB\-\-dvipdfmx\-option\fR=\fIOPTION\fR, \fB\-\-dvipdfmx\-options\fR=\fIOPTIONS\fR
همانند موارد بالا برای dvipdfmx.
.TP
\fB\-\-makeindex\fR=\fICOMMAND+OPTIONS\fR
دستور تولید نمایه، مانند \fBmakeindex\fR یا \fBmendex\fR.
.TP
\fB\-\-bibtex\fR=\fICOMMAND+OPTIONS\fR
دستور برای BibTeX، مانند \fBbibtex\fR یا \fBpbibtex\fR.
.TP
\fB\-\-biber\fR[=\fICOMMAND+OPTIONS\fR]
دستور برای Biber.
.TP
\fB\-\-makeglossaries\fR[=\fICOMMAND+OPTIONS\fR]
دستور برای makeglossaries.
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ این پیام راهنما و خروج.
.TP
\fB\-v\fR, \fB\-\-version\fR
چاپ اطلاعات نسخه و خروج.
.TP
\fB\-V\fR, \fB\-\-verbose\fR
ارائه خروجی با جزئیات بیشتر.
.TP
\fB\-\-color\fR[=\fIWHEN\fR]
رنگی‌تر کردن پیام‌های ClutTeX. \fIWHEN\fR یکی از مقادیر \fBalways\fR، \fBauto\fR یا \fBnever\fR است [پیش‌فرض: \fBauto\fR در صورت حذف \fB\-\-color\fR، و \fBalways\fR در صورت حذف \fIWHEN\fR].
.TP
\fB\-\-includeonly\fR=\fINAMES\fR
درج \fB\eincludeonly{\fINAMES\fB}\fR.
.TP
\fB\-\-make\-depends\fR=\fIFILE\fR
نوشتن وابستگی‌ها به عنوان یک قاعده Makefile.
.TP
\fB\-\-print\-output\-directory\fR
چاپ دایرکتوری خروجی و خروج.
.TP
\fB\-\-package\-support\fR=\fIPKG1\fR[,\fIPKG2\fR,...]
فعال کردن پشتیبانی ویژه برای برخی بسته‌های نیازمند گریز به پوسته (shell-escape). در حال حاضر پشتیبانی می‌شود: minted، epstopdf.
.TP
\fB\-\-check\-driver\fR=\fIDRIVER\fR
بررسی بارگذاری صحیح فایل درایور. \fIDRIVER\fR یکی از مقادیر \fBdvipdfmx\fR، \fBdvips\fR یا \fBdvisvgm\fR است.
.TP
\fB\-\-source\-date\-epoch\fR=\fITIME\fR
تنظیم متغیر محیطی \fBSOURCE_DATE_EPOCH\fR با مقدار \fITIME\fR. \fITIME\fR می‌تواند برای تشخیص خودکار برابر \fBnow\fR باشد.
.TP
\fB\-\-config\-file\fR=\fIFILE\fR
استفاده از فایل پیکربندی مشخص‌شده.
.TP
\fB\-\-shell\-escape\fR, \fB\-\-no\-shell\-escape\fR
اجازه یا عدم اجازه اجرای دستورات پوسته از درون سند.
.TP
\fB\-\-shell\-restricted\fR
محدود کردن اجرای دستورات پوسته.
.TP
\fB\-\-synctex\fR=\fINUMBER\fR
فعال‌سازی و تنظیم سطح SyncTeX.
.TP
\fB\-\-fmt\fR=\fIFMTNAME\fR
مشخص کردن نام فرمت.
.TP
\fB\-\-file\-line\-error\fR, \fB\-\-no\-file\-line\-error\fR
نمایش خطاهای فایل و خط [پیش‌فرض: yes].
.TP
\fB\-\-halt\-on\-error\fR, \fB\-\-no\-halt\-on\-error\fR
توقف در صورت بروز خطا [پیش‌فرض: yes].
.TP
\fB\-\-interaction\fR=\fISTRING\fR
تنظیم حالت تعامل موتور [پیش‌فرض: nonstopmode].
.TP
\fB\-\-jobname\fR=\fISTRING\fR
تنظیم نام وظیفه (jobname).
.TP
\fB\-\-output\-directory\fR=\fIDIR\fR
تعیین مسیر دایرکتوری خروجی [پیش‌فرض: جایی در دایرکتوری موقت].
.TP
\fB\-\-output\-format\fR=\fIFORMAT\fR
\fIFORMAT\fR برابر \fBpdf\fR یا \fBdvi\fR است [پیش‌فرض: pdf].
.SH "وضعیت خروج (EXIT STATUS)"
در صورت موفقیت مقدار 0 و در صورت بروز خطا مقدار غیر صفر بازگردانده می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR cluttex (1),
.BR clxelatex (1),
.BR lualatex (1),
.BR latex (1),
.BR tex (1)
.PP
مخزن و مستندات رسمی:
<https://github.com/fumiyas/cluttex>
.SH "نویسندگان (AUTHORS)"
برنامه ClutTeX توسط SATOH Fumiyasu نوشته شده است.