نام (NAME)

l3build - موتور خودکارسازی تست و ساخت بسته‌های LaTeX

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

l3build <target> [options] [names]

توضیحات (DESCRIPTION)

ماژول l3build برای پشتیبانی از توسعه کدهای باکیفیت LaTeX با ارائه قابلیت‌های زیر طراحی شده است:

سیستم آزمون واحد (unit testing)
حروف‌چینی خودکار کدهای منبع
سیستم بسته‌بندی مطمئن برای انتشار در CTAN

این بسته از یک اسکریپت Lua برای اجرای وظایف و یک فایل .tex تشکیل شده است که محیط آزمون را فراهم می‌کند. این ابزارها در ابتدا برای پشتیبانی از توسعه LaTeX ایجاد شدند، اما به گونه‌ای طراحی شده‌اند که به آسانی توسط دیگران نیز قابل استفاده باشند. مستندات کامل برنامه در دسترس است.

دستورات (COMMANDS)

اهداف (targets) معتبر عبارتند از:

check: اجرای تمام آزمون‌های خودکار.
clean: پاک‌سازی درخت دایرکتوری ساخت.
ctan: ایجاد آرشیو آماده برای انتشار در CTAN.
doc: حروف‌چینی تمام فایل‌های مستندات.
install: نصب فایل‌ها در درخت محلی texmf.
manifest: ایجاد یک فایل مانیفست (فهرست محتویات بسته).
save: ذخیره لاگ اعتبارسنجی آزمون.
tag: به‌روزرسانی برچسب‌های انتشار در فایل‌ها.
uninstall: حذف نصب فایل‌ها از درخت محلی texmf.
unpack: استخراج فایل‌های منبع در درخت ساخت.
upload: ارسال آرشیو به CTAN برای انتشار عمومی.

گزینه‌ها (OPTIONS)

گزینه‌های معتبر عبارتند از:

--config | -c: تنظیم پیکربندی(های) مورد استفاده برای اجرای آزمون‌ها.
--date | -d: تنظیم تاریخی که باید در فایل‌های منبع درج شود.
--debug: اجرای هدف در حالت اشکال‌زدایی (debug mode).
--dev: استفاده از فرمت در حال توسعه LaTeX.
--dirty: صرف‌نظر کردن از پاک‌سازی ناحیه آزمون.
--dry-run: اجرای آزمایشی برای نصب یا بارگذاری بدون اعمال تغییرات واقعی.
--email: نشانی ایمیل بارگذاری‌کننده در CTAN.
--engine | -e: تنظیم موتور(های) مورد استفاده برای اجرای آزمون.
--epoch: تنظیم مبدا زمانی (epoch) برای آزمون‌ها و حروف‌چینی.
--file | -F: دریافت متن اطلاعیه بارگذاری از فایل مشخص‌شده.
--first: نام نخستین آزمونی که باید اجرا شود.
--full: نصب تمام فایل‌ها.
--halt-on-error | -H: توقف اجرای آزمون‌ها پس از نخستین شکست.
--help | -h: نمایش این پیام راهنما و خروج.
--last: نام آخرین آزمونی که باید اجرا شود.
--message | -m: متن پیام برای اطلاعیه بارگذاری.
--quiet | -q: عدم نمایش خروجی‌های TeX هنگام استخراج بسته‌ها.
--rerun: صرف‌نظر از راه‌اندازی اولیه: اجرای مستقیم مجدد آزمون‌ها.
--show-log-on-error: نمایش لاگ کامل شکست هنگام استفاده از --halt-on-error.
--show-saves | -S: نمایش دستور فراخوانی برای به‌روزرسانی فایل‌های ناموفق .tlg.
--shuffle: بر هم زدن و تصادفی کردن ترتیب اجرای آزمون‌ها.
--stdengine | -s: اجرای آزمون‌ها با موتور استاندارد (بسته به پیکربندی).
--texmfhome: محل دایرکتوری درخت texmf کاربر.
--version: چاپ اطلاعات نسخه برنامه و خروج.

همچنین ببینید (SEE ALSO)

راهنمای کامل از طریق اجرای دستور 'texdoc l3build' در دسترس است.

مخزن پروژه: https://github.com/latex3/l3build

سامانه پیگیری باگ: https://github.com/latex3/l3build/issues