.TH L3BUILD 1 "2025-12-24" "LaTeX" .SH "نام (NAME)" l3build \- موتور خودکارسازی تست و ساخت بسته‌های LaTeX .SH "خلاصه دستور (SYNOPSIS)" .B l3build .I [\fIoptions\fR] [\fInames\fR] .SH "توضیحات (DESCRIPTION)" .PP ماژول .B l3build برای پشتیبانی از توسعه کدهای باکیفیت LaTeX با ارائه قابلیت‌های زیر طراحی شده است: .IP \(bu 2 سیستم آزمون واحد (unit testing) .IP \(bu 2 حروف‌چینی خودکار کدهای منبع .IP \(bu 2 سیستم بسته‌بندی مطمئن برای انتشار در CTAN .PP این بسته از یک اسکریپت Lua برای اجرای وظایف و یک فایل .B .tex تشکیل شده است که محیط آزمون را فراهم می‌کند. این ابزارها در ابتدا برای پشتیبانی از توسعه LaTeX ایجاد شدند، اما به گونه‌ای طراحی شده‌اند که به آسانی توسط دیگران نیز قابل استفاده باشند. مستندات کامل برنامه در دسترس است. .SH "دستورات (COMMANDS)" .PP اهداف (targets) معتبر عبارتند از: .TP .B check اجرای تمام آزمون‌های خودکار. .TP .B clean پاک‌سازی درخت دایرکتوری ساخت. .TP .B ctan ایجاد آرشیو آماده برای انتشار در CTAN. .TP .B doc حروف‌چینی تمام فایل‌های مستندات. .TP .B install نصب فایل‌ها در درخت محلی texmf. .TP .B manifest ایجاد یک فایل مانیفست (فهرست محتویات بسته). .TP .B save ذخیره لاگ اعتبارسنجی آزمون. .TP .B tag به‌روزرسانی برچسب‌های انتشار در فایل‌ها. .TP .B uninstall حذف نصب فایل‌ها از درخت محلی texmf. .TP .B unpack استخراج فایل‌های منبع در درخت ساخت. .TP .B upload ارسال آرشیو به CTAN برای انتشار عمومی. .SH "گزینه‌ها (OPTIONS)" .PP گزینه‌های معتبر عبارتند از: .TP .BR \-\-config " | " \-c تنظیم پیکربندی(های) مورد استفاده برای اجرای آزمون‌ها. .TP .BR \-\-date " | " \-d تنظیم تاریخی که باید در فایل‌های منبع درج شود. .TP .B \-\-debug اجرای هدف در حالت اشکال‌زدایی (debug mode). .TP .B \-\-dev استفاده از فرمت در حال توسعه LaTeX. .TP .B \-\-dirty صرف‌نظر کردن از پاک‌سازی ناحیه آزمون. .TP .B \-\-dry\-run اجرای آزمایشی برای نصب یا بارگذاری بدون اعمال تغییرات واقعی. .TP .B \-\-email نشانی ایمیل بارگذاری‌کننده در CTAN. .TP .BR \-\-engine " | " \-e تنظیم موتور(های) مورد استفاده برای اجرای آزمون. .TP .B \-\-epoch تنظیم مبدا زمانی (epoch) برای آزمون‌ها و حروف‌چینی. .TP .BR \-\-file " | " \-F دریافت متن اطلاعیه بارگذاری از فایل مشخص‌شده. .TP .B \-\-first نام نخستین آزمونی که باید اجرا شود. .TP .B \-\-full نصب تمام فایل‌ها. .TP .BR \-\-halt\-on\-error " | " \-H توقف اجرای آزمون‌ها پس از نخستین شکست. .TP .BR \-\-help " | " \-h نمایش این پیام راهنما و خروج. .TP .B \-\-last نام آخرین آزمونی که باید اجرا شود. .TP .BR \-\-message " | " \-m متن پیام برای اطلاعیه بارگذاری. .TP .BR \-\-quiet " | " \-q عدم نمایش خروجی‌های TeX هنگام استخراج بسته‌ها. .TP .B \-\-rerun صرف‌نظر از راه‌اندازی اولیه: اجرای مستقیم مجدد آزمون‌ها. .TP .B \-\-show\-log\-on\-error نمایش لاگ کامل شکست هنگام استفاده از .BR \-\-halt\-on\-error . .TP .BR \-\-show\-saves " | " \-S نمایش دستور فراخوانی برای به‌روزرسانی فایل‌های ناموفق .BR .tlg . .TP .B \-\-shuffle بر هم زدن و تصادفی کردن ترتیب اجرای آزمون‌ها. .TP .BR \-\-stdengine " | " \-s اجرای آزمون‌ها با موتور استاندارد (بسته به پیکربندی). .TP .B \-\-texmfhome محل دایرکتوری درخت texmf کاربر. .TP .B \-\-version چاپ اطلاعات نسخه برنامه و خروج. .SH "همچنین ببینید (SEE ALSO)" .PP راهنمای کامل از طریق اجرای دستور .B 'texdoc l3build' در دسترس است. .PP مخزن پروژه: .PP سامانه پیگیری باگ: .SH "نویسندگان (AUTHORS)" حق نشر (C) 2014-2025 پروژه LaTeX (The LaTeX Project)