نام (NAME)

arara - یک ابزار خودکارسازی TeX مبتنی بر قوانین و دستورالعمل‌ها

خلاصه دستور (SYNOPSIS)

arara [options] documents...

توضیحات (DESCRIPTION)

دستور arara یک ابزار خودکارسازی TeX مبتنی بر قوانین و دستورالعمل‌ها است. این ابزار روشی را برای ارتقا و بهبود تجربه کار با TeX فراهم می‌کند. این ابزار تلاشی است برای ارائه روشی مختصر جهت خودکارسازی گردش کار روزمره TeX هم برای کاربران و هم برای نویسندگان بسته‌ها. کاربران می‌توانند در صورتی که قوانین ارائه‌شده کافی نباشند، قوانین سفارشی خود را بنویسند.

دستور arara فهرستی از اسناد را به عنوان ورودی دریافت می‌کند. این اسناد مطابق با دستورالعمل‌های درونشان پردازش خواهند شد. گزینه‌ها بر روند اجرای تمامی اسناد اعمال می‌شوند.

گزینه‌ها (OPTIONS)

--log: تولید یک خروجی گزارش (log).
--verbose: نمایش یا جلوگیری از نمایش خروجی دستور.
--dry-run: طی کردن تمامی مراحل اجرای دستور بدون اجرای فراخوانی‌های واقعی.
--safe-run: اجرا در حالت امن و غیرفعال‌سازی ویژگی‌های بالقوه آسیب‌رسان.
--whole-file: استخراج دستورالعمل‌ها از سراسر فایل، و نه فقط از بخش سرآیند.
--preamble: تنظیم دیباچه (preamble) فایل بر اساس نام مشخص‌شده در فایل پیکربندی.
--timeout: تنظیم مهلت زمانی اجرا (بر حسب میلی‌ثانیه) برای فرایندهای فرزند ایجادشده.
--language: تنظیم بومی‌سازی برنامه روی زبان مشخص‌شده توسط code.
--max-loops: تنظیم تعداد تکرار (بزرگ‌تر از ۰) برای دستورالعمل‌های حلقه‌ای.
--working-directory: تنظیم دایرکتوری کاری برای کل فرآیند اجرا.
--call-property: ارسال یک ویژگی به‌صورت پارامتر key=value به برنامه جهت استفاده در طول نشست.
--properties-file: ارسال یک فایل خصوصیات (properties file) به برنامه جهت استفاده در طول نشست.
--generate-completion: تولید اسکریپت تکمیل خودکار (completion script) برای arara.
--version: نمایش نسخه برنامه و خروج.
--help: نمایش پیام راهنما و خروج.

گزارش باگ‌ها (BUGS)

سامانه پیگیری اشکالات در https://gitlab.com/islandoftex/arara/-/issues.