.TH ARARA 1 "30 June 2025" "v7.2.0"
.SH "نام (NAME)"
arara \- یک ابزار خودکارسازی TeX مبتنی بر قوانین و دستورالعمل‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.B arara
.RI [ options ]
.IR documents ...
.SH "توضیحات (DESCRIPTION)"
دستور \fBarara\fP یک ابزار خودکارسازی TeX مبتنی بر قوانین و دستورالعمل‌ها است. این ابزار
روشی را برای ارتقا و بهبود تجربه کار با TeX فراهم می‌کند. این ابزار تلاشی است برای
ارائه روشی مختصر جهت خودکارسازی گردش کار روزمره TeX هم برای کاربران و هم برای
نویسندگان بسته‌ها. کاربران می‌توانند در صورتی که قوانین ارائه‌شده کافی نباشند،
قوانین سفارشی خود را بنویسند.
.PP
دستور arara فهرستی از اسناد را به عنوان ورودی دریافت می‌کند. این اسناد مطابق با
دستورالعمل‌های درونشان پردازش خواهند شد. گزینه‌ها بر روند اجرای تمامی اسناد اعمال می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
.IP \fB--log\fP
تولید یک خروجی گزارش (log).
.IP \fB--verbose\fP / \fB--silent\fP
نمایش یا جلوگیری از نمایش خروجی دستور.
.IP \fB--dry-run\fP
طی کردن تمامی مراحل اجرای دستور بدون اجرای فراخوانی‌های واقعی.
.IP \fB--safe-run\fP
اجرا در حالت امن و غیرفعال‌سازی ویژگی‌های بالقوه آسیب‌رسان.
.IP \fB--whole-file\fP
استخراج دستورالعمل‌ها از سراسر فایل، و نه فقط از بخش سرآیند.
.IP \fB--preamble\fP name
تنظیم دیباچه (preamble) فایل بر اساس نام مشخص‌شده در فایل پیکربندی.
.IP \fB--timeout\fP milliseconds
تنظیم مهلت زمانی اجرا (بر حسب میلی‌ثانیه) برای فرایندهای فرزند ایجادشده.
.IP \fB--language\fP code
تنظیم بومی‌سازی برنامه روی زبان مشخص‌شده توسط code.
.IP \fB--max-loops\fP number
تنظیم تعداد تکرار (بزرگ‌تر از ۰) برای دستورالعمل‌های حلقه‌ای.
.IP \fB--working-directory\fP path
تنظیم دایرکتوری کاری برای کل فرآیند اجرا.
.IP \fB--call-property\fP value
ارسال یک ویژگی به‌صورت پارامتر \fCkey=value\fP به برنامه جهت استفاده در طول نشست.
.IP \fB--properties-file\fP value
ارسال یک فایل خصوصیات (properties file) به برنامه جهت استفاده در طول نشست.
.IP \fB--generate-completion\fP shell
تولید اسکریپت تکمیل خودکار (completion script) برای arara.
.IP \fB--version\fP
نمایش نسخه برنامه و خروج.
.IP \fB--help\fP
نمایش پیام راهنما و خروج.
.SH "گزارش باگ‌ها (BUGS)"
سامانه پیگیری اشکالات در
.UR https://gitlab.com/islandoftex/arara/-/issues
.UE .