.TH LATEXMK 1 "15 June 2025" "" .SH "نام (NAME)" latexmk \- تولید و کامپایل خودکار اسناد LaTeX .SH "خلاصه دستور (SYNOPSIS)" .B latexmk [options] [file ...] .SH "توضیحات (DESCRIPTION)" .I Latexmk فرایند کامپایل یک سند LaTeX را کاملاً خودکار می‌کند. در واقع، این ابزار مانند خویشاوند تخصصی ابزار عمومی \fImake\fR است، اما وابستگی‌ها را به صورت خودکار تعیین می‌کند و ویژگی‌های بسیار کاربردی دیگری نیز دارد. در حالت پایه، نام فایل منبع اصلی سند به \fIlatexmk\fR داده می‌شود و این ابزار توالی مناسبی از دستورها را برای تولید نسخه .dvi، .ps، .pdf و/یا نسخه چاپی سند صادر می‌کند. .PP به‌طور پیش‌فرض، \fIlatexmk\fR دستورهای لازم برای تولید یک فایل .dvi را اجرا می‌کند؛ رفتاری که برگرفته از نسخه‌های اولیه، زمانی که تنها \fIlatex\fR در دسترس بود، است. .PP \fILatexmk\fR همچنین می‌تواند به گونه‌ای تنظیم شود که همراه با یک پیش‌نمایشگر مناسب، به‌طور مداوم اجرا شود. در این صورت، هر زمان که یکی از فایل‌های منبع تغییر کند، برنامه \fIlatex\fR (یا یکی از مشتقات آن) دوباره اجرا می‌شود و پیش‌نمایشگر نمای روی صفحه سند کامپایل‌شده را به‌طور خودکار به‌روزرسانی می‌کند. .PP \fILatexmk\fR با بررسی فایل لاگ (log) مشخص می‌کند که فایل‌های منبع کدامند. (به‌طور اختیاری، فهرست فایل‌های ورودی و خروجی تولیدشده توسط گزینه \fB-recorder\fR در نسخه‌های مدرن \fIlatex\fR (و \fIpdflatex\fR، \fIxelatex\fR، \fIlualatex\fR) را نیز بررسی می‌کند. مستندات مربوط به گزینه \fB-recorder\fR از \fIlatexmk\fR را در زیر ببینید.) هنگامی که \fIlatexmk\fR اجرا می‌شود، ویژگی‌های فایل‌های منبع را بررسی کرده و در صورتی که هر یک از آنها از زمان آخرین تولید سند تغییر کرده باشند، \fIlatexmk\fR برنامه‌های مختلف پردازش LaTeX را بر حسب نیاز اجرا می‌کند. به‌ویژه، اجرای \fIlatex\fR (یا برنامه مرتبط) را به تعداد کافی تکرار می‌کند تا تمام ارجاعات متقابل (cross references) حل شوند؛ این امر به بسته‌های ماکرو استفاده‌شده بستگی دارد. با برخی از بسته‌های ماکرو و کلاس‌های سند، ممکن است به چهار یا حتی تعداد دفعات بیشتری از اجرا نیاز باشد. در صورت لزوم، \fIlatexmk\fR همچنین \fIbibtex\fR، \fIbiber\fR و/یا \fImakeindex\fR را اجرا خواهد کرد. علاوه بر این، \fIlatexmk\fR می‌تواند برای تولید سایر فایل‌های ضروری نیز پیکربندی شود. به عنوان مثال، از یک فایل شکل (figure) به‌روزرسانی‌شده، می‌تواند به‌طور خودکار فایلی در قالب encapsulated postscript یا قالب مناسب دیگری برای خواندن توسط LaTeX تولید کند. .PP \fILatexmk\fR دارای دو گزینه مختلف برای پیش‌نمایش است. با گزینه ساده \fB-pv\fR، پس از تولید نسخه dvi، postscript یا pdf سند، یک پیش‌نمایشگر dvi، postscript یا pdf به‌طور خودکار اجرا می‌شود. نوع فایل برای مشاهده بر اساس تنظیمات پیکربندی و گزینه‌های خط فرمان انتخاب می‌شود. .PP گزینه دوم پیش‌نمایش، گزینه قدرتمند \fB-pvc\fR است (مخفف یادافزا: "preview continuously"). در این حالت، \fIlatexmk\fR به‌طور مداوم اجرا می‌شود و پیوسته تمام فایل‌های منبع را زیر نظر می‌گیرد تا تغییرات احتمالی آنها را بررسی کند. هر بار که تغییری تشخیص داده شود، \fIlatexmk\fR تمام برنامه‌های لازم برای تولید نسخه جدیدی از سند را اجرا می‌کند. سپس یک پیش‌نمایشگر خوب نمای خود را به‌طور خودکار به‌روزرسانی می‌کند. بنابراین کاربر می‌تواند به سادگی یک فایل را ویرایش کند و هنگامی که تغییرات روی دیسک ذخیره شدند، \fIlatexmk\fR چرخه به‌روزرسانی فایل .dvi (و/یا .ps و .pdf) و بازخوانی نمای پیش‌نمایشگر را کاملاً خودکار انجام می‌دهد. این حالت دقیقاً WYSIWYG نیست، اما به شکلی کارآمد به آن نزدیک است. .PP برای پیش‌نمایشگرهای دیگر، ممکن است کاربر مجبور باشد پیش‌نمایشگر را به‌صورت دستی مجبور به به‌روزرسانی نمای خود کند، که (برای مثال، در برخی نسخه‌های \fIxdvi\fR و \fIgsview\fR) می‌تواند به سادگیِ اجبار به بازترسیم نمایشگر آن باشد. .PP \fILatexmk\fR این قابلیت را دارد که هنگام ایجاد فایل postscript، یک نشان/بنر خاکستری را به صورت مورب در هر صفحه چاپ کند. همچنین می‌تواند در صورت لزوم، یک برنامه خارجی را برای انجام پس‌پردازش‌های دیگر بر روی فایل‌های dvi و postscript تولیدشده فراخوانی کند. (گزینه‌های \fB-dF\fR و \fB-pF\fR و مستندات مربوط به متغیرهای پیکربندی \fI$dvi_filter\fR و \fI$ps_filter\fR را ببینید.) این قابلیت‌ها از نسخه‌های قدیمی‌تر \fIlatexmk\fR باقی مانده‌اند، اما \fBدر حال حاضر غیرفعال هستند\fR. در نسخه‌های کنونی انعطاف‌پذیری بیشتری حاصل شده است، زیرا رشته‌های دستور برای اجرای \fI*latex\fR اکنون می‌توانند برای اجرای چندین دستور پیکربندی شوند. این امر همچنین امکان پس‌پردازش فایل‌های تولیدشده را گسترش می‌دهد. .PP \fILatexmk\fR هم از طریق خط فرمان و هم در فایل‌های پیکربندی بسیار قابل تنظیم است، به طوری که می‌تواند طیف گسترده‌ای از نیازهای کاربران و پیکربندی‌های سیستم را برآورده سازد. مقادیر پیش‌فرض بر اساس سیستم‌عامل تعیین می‌شوند، بنابراین \fIlatexmk\fR اغلب بدون پیکربندی خاصی در MS-Windows، cygwin، Linux، OS-X و سایر سیستم‌های UNIX کار می‌کند. بخش «Configuration/Initialization (rc) Files» و سپس بخش‌های بعدی شامل «How to Set Variables in Initialization Files»، «Format of Command Specifications»، «List of Configuration Variables Usable in Initialization Files»، «Custom Dependencies» و «Advanced Configuration» را ببینید. .PP یک پیچیدگی بسیار آزاردهنده که توسط \fIlatexmk\fR بسیار مطمئن مدیریت می‌شود، این است که LaTeX سیستمی چندمرحله‌ای (multiple pass) است. در هر اجرا، LaTeX اطلاعات تولیدشده در اجرای قبلی را برای مواردی مانند ارجاعات متقابل و نمایه‌سازی بازخوانی می‌کند. در ساده‌ترین حالت‌ها، اجرای دوم LaTeX کافی است و اغلب فایل لاگ حاوی پیامی درباره نیاز به یک مرحله دیگر است. با این حال، تنوع گسترده‌ای از بسته‌های ماکروی افزودنی برای LaTeX وجود دارد که رفتارهای متفاوتی دارند. نتیجه این است که تعیین ساده‌انگارانه تعداد دفعات اجرای لازم و اینکه چه برنامه‌هایی باید اجرا شوند را غیرممکن می‌سازد. \fILatexmk\fR راه‌حلی بسیار فراگیر و کارآمد برای این مسائل دارد. این راه‌حل شامل نگهداری اطلاعات فایل‌های منبع در بین اجراها است، و نمود بیرونی آن تولید یک فایل اضافی (به‌طور پیش‌فرض با پسوند \fI.fdb_latexmk\fR) توسط \fIlatexmk\fR است که اطلاعات فایل‌های منبع را در خود نگه می‌دارد. .SH "گزینه‌ها و آرگومان‌های LATEXMK در خط فرمان (LATEXMK OPTIONS AND ARGUMENTS ON COMMAND LINE)" به‌طور کلی، خط فرمان برای فراخوانی \fIlatexmk\fR به شکل زیر است: latexmk [options] [file] همه گزینه‌ها می‌توانند با یک یا دو نویسه "-" مشخص شوند، مانند "latexmk -help" یا "latexmk --help". \fBنکته ۱\fR: در این مستندات، '\fI*latex\fR' به معنای هر یک از موتورهای پشتیبانی‌شده است؛ یعنی در حال حاضر \fIlatex\fR، \fIlualatex\fR، \fIpdflatex\fR و \fIxelatex\fR. اشاره به یکی از آنها مشخصاً به همان موتور خاص اشاره دارد. نسخه‌های پیشین این مستندات چندان سازگار نبودند. اینکه کدام‌یک از اینها برای کامپایل سند استفاده شود، به پیکربندی و آرگومان‌های خط فرمان بستگی دارد. \fBنکته ۲\fR: \fBعلاوه بر گزینه‌های موجود در فهرست زیر، \fIlatexmk\fR تقریباً تمام گزینه‌هایی را که توسط برنامه‌های \fI*latex\fR در پیاده‌سازی‌های کنونی TeXLive و MiKTeX شناخته می‌شوند، شناسایی می‌کند. برخی از گزینه‌های این برنامه‌ها، اقدام یا رفتار خاصی را در \fIlatexmk\fR ایجاد می‌کنند که در این صورت توضیحات مشخصی در این سند دارند؛ در چنین شرایطی ممکن است آن گزینه‌ها به *latex نیز ارسال شوند یا نشوند. \fIlatexmk\fR را با گزینه \fB-showextraoptions\fR اجرا کنید تا فهرستی از گزینه‌هایی که \fIlatexmk\fR می‌پذیرد و صرفاً به \fI*latex\fR ارسال می‌کند را دریافت نمایید. همچنین برای اطلاعات بیشتر به توضیحات گزینه \fB-showextraoptions\fR مراجعه کنید. \fBتعریف گزینه‌ها و آرگومان‌ها\fR .TP .B file می‌توان یک یا چند فایل را مشخص کرد. اگر هیچ فایلی مشخص نشود، \fIlatexmk\fR به‌طور پیش‌فرض بر روی تمام فایل‌های دارای پسوند ".tex" در دایرکتوری کاری فعلی اجرا خواهد شد. این رفتار قابل تغییر است: توضیحات مربوط به متغیر \fI@default_files\fR در بخش "List of configuration variables usable in initialization files" را ببینید. اگر فایلی بدون پسوند مشخص شود، پسوند ".tex" دقیقاً همان‌طور که LaTeX عمل می‌کند، به‌طور خودکار اضافه می‌شود. بنابراین، اگر عبارت زیر را مشخص کنید: latexmk foo آنگاه \fIlatexmk\fR روی فایل "foo.tex" عمل خواهد کرد. محدودیت‌های خاصی در مورد نویسه‌های مجاز در نام فایل وجود دارد؛ برخی نویسه‌ها برای برنامه‌هایی مانند \fIlatex\fR ممنوع یا مشکل‌ساز هستند. این نویسه‌ها عبارتند از: "$"، "%"، "\\"، "~"، نویسه نقل‌قول دوتایی (double quote)، و نویسه‌های کنترلی null، tab، form feed، carriage return، line feed و delete. علاوه بر این، استفاده از "&" به عنوان اولین نویسه نام فایل ممنوع است. هنگامی که \fIlatexmk\fR هر یک از نویسه‌های فوق را در نام فایل(های) TeX مشخص‌شده در خط فرمان شناسایی کند، یک خطای مهلک (fatal error) صادر می‌کند. \fIبا این حال\fR، پیش از بررسی نویسه‌های غیرمجاز، \fIlatexmk\fR جفت‌های نقل‌قول دوتایی تطبیق‌یافته را از نام فایل حذف می‌کند. این رفتار مطابق با عملکرد \fIlatex\fR و غیره است و مشکلاتی را که گاه به دلیل نقل‌قول نادرست نام فایل‌ها در خط فرمان رخ می‌دهد برطرف می‌سازد. \fIعلاوه بر این\fR، در Microsoft Windows نویسه ممیز وارونه "\\" جداکننده دایرکتوری است، بنابراین \fIlatexmk\fR آن را با یک ممیز رو به جلو "/" که جداکننده معتبر دایرکتوری در ویندوز است و توسط \fIlatex\fR و برنامه‌های مشابه نیز پذیرفته می‌شود، جایگزین می‌کند. .TP .B -auxdir=FOO \fRor\fB -aux-directory=FOO دایرکتوری فایل‌های خروجی کمکیِ *latex (.aux، .log و غیره) را تعیین می‌کند. اینها همه فایل‌های تولیدشده هستند، به استثنای فایل‌های خروجی نهایی (.dvi، .ps، .pdf، .synctex.gz، .synctex). برای دایرکتوری‌های فایل‌های خروجی اصلی به گزینه \fB-outdir\fR/\fB-output-directory\fR و برای فایل‌های خروجی نهایی به گزینه \fB-out2dir\fR مراجعه کنید. اگر دایرکتوری مشخص‌شده برای گزینه \fB-aux\fR/\fB-aux-directory\fR خالی باشد، مقدار پیش‌فرض استفاده می‌شود که همان دایرکتوری خروجی است. اگر از گزینه \fB-cd\fR نیز استفاده کنید و دایرکتوری خروجی کمکی مشخص‌شده یک مسیر نسبی باشد، این مسیر نسبت به دایرکتوری سند تفسیر می‌شود. برای جزئیات بیشتر به بخش AUXILIARY AND OUTPUT DIRECTORIES مراجعه کنید. .TP .B -bibtex هنگامی که فایل منبع برای کتاب‌شناسی از فایل‌های bbl استفاده می‌کند، bibtex یا biber را بر حسب نیاز برای بازتولید فایل‌های bbl اجرا می‌کند. این ویژگی همچنین می‌تواند با تنظیم متغیر \fI$bibtex_use\fR بر روی مقدار 2 در یک فایل پیکربندی تنظیم شود. .TP .B -bibtex- هرگز bibtex یا biber را اجرا نمی‌کند. همچنین، همیشه با فایل‌های .bbl به عنوان فایل‌های ارزشمند رفتار می‌کند، یعنی در عملیات پاک‌سازی آن‌ها را حذف نمی‌کند. کاربرد رایج این گزینه زمانی است که سندی از یک منبع خارجی همراه با فایل(های) bbl کامل آن دریافت شده باشد و کاربر فایل‌های bib مربوطه را در اختیار نداشته باشد. در این شرایط، استفاده از گزینه \fB-bibtex-\fR مانع از تلاش \fIlatexmk\fR برای اجرای \fIbibtex\fR یا \fIbiber\fR می‌شود که می‌توانست منجر به بازنویسی و رونویسی روی فایل‌های bbl گردد. این ویژگی همچنین می‌تواند با تنظیم متغیر \fI$bibtex_use\fR بر روی مقدار 0 در یک فایل پیکربندی تنظیم شود..TP .B -bibtex-cond هنگامی که فایل مبدأ برای کتاب‌شناسی از یک فایل bbl استفاده می‌کند و برای تولید کتاب‌شناسی از \fIbibtex\fR استفاده می‌شود، \fIbibtex\fR را در صورت نیاز برای بازتولید فایل‌های bbl تنها در صورتی اجرا می‌کند که فایل(های) bib مربوطه وجود داشته باشند. بنابراین وقتی فایل(های) bib در دسترس نباشند، \fIbibtex\fR اجرا نمی‌شود و در نتیجه از بازنویسی فایل bbl جلوگیری می‌شود. همچنین، همیشه فایل‌های .bbl را به عنوان فایل‌های ارزشمند در نظر می‌گیرد، یعنی در عملیات پاک‌سازی آن‌ها را حذف نمی‌کند. این تنظیم پیش‌فرض است. همچنین می‌توان با تنظیم متغیر \fI$bibtex_use\fR روی 1 در یک فایل پیکربندی آن را فعال کرد. دلیل استفاده از این تنظیم، در وهله اول امکان جابه‌جایی خودکار بین استفاده و عدم استفاده از \fIbibtex\fR بسته به وجود یا عدم وجود فایل bib است. علاوه‌بر این، هنگام ارسال مقالات به مجلات علمی، معمول است که تنها فایل‌های .tex و .bbl (به همراه فایل‌های گرافیکی) ارسال شوند، و نه فایل .bib. از این رو اغلب مفید است که با فایل‌های .bbl مانند فایل‌های مبدأ واقعی رفتار شود، به گونه‌ای که در عملیات پاک‌سازی حفظ شوند. این ویژگی را می‌توان با تنظیم متغیر \fI$bibtex_use\fR روی 1 در فایل پیکربندی نیز تعیین کرد. \fBتوجه\fR داشته باشید که هنگام استفاده از \fBbiber\fR، اگر فایل bib وجود نداشته باشد، این گزینه مانع اجرای \fIbiber\fR نمی‌شود و ممکن است فایل bbl نادرست باشد. برای جزئیات بیشتر به مستندات \fI$bibtex_use\fR مراجعه کنید. با این حال، فایل bbl در عملیات پاک‌سازی به عنوان فایلی ارزشمند تلقی شده و حذف نمی‌شود. .TP .B -bibtex-cond1 مشابه با \fB-bibtex-cond\fR است، با این تفاوت که فایل‌های .bbl تنها در صورتی ارزشمند تلقی می‌شوند که یک یا چند فایل bib وجود نداشته باشد. بنابراین اگر تمام فایل‌های bib وجود داشته باشند، \fIbibtex\fR در صورت نیاز برای تولید فایل‌های .bbl اجرا می‌شود، و در این حالت حذف فایل‌های bbl در عملیات پاک‌سازی بلامانع است زیرا می‌توان آن‌ها را مجدداً بازتولید کرد. این ویژگی را می‌توان با تنظیم متغیر \fI$bibtex_use\fR روی 1.5 در یک فایل پیکربندی تنظیم کرد. \fBتوجه\fR داشته باشید که هنگام استفاده از \fBbiber\fR، اگر فایل bib وجود نداشته باشد، این گزینه مانع اجرای \fIbiber\fR نمی‌شود و ممکن است فایل bbl نادرست باشد. برای جزئیات بیشتر به مستندات \fI$bibtex_use\fR مراجعه کنید. با این حال، فایل bbl در عملیات پاک‌سازی ارزشمند تلقی می‌شود. .TP .B -bibtexfudge\fR یا\fB -bibfudge فعال کردن ترفند تغییر دایرکتوری (change-directory fudge) برای bibtex. برای جزئیات به مستندات \fI$bibtex_fudge\fR مراجعه کنید. .TP .B -bibtexfudge-\fR یا\fB -bibfudge- غیرفعال کردن ترفند تغییر دایرکتوری برای bibtex. برای جزئیات به مستندات \fI$bibtex_fudge\fR مراجعه کنید. .TP .B -bm یک پیام بنر (واترمارک) برای چاپ به صورت مورب در سراسر هر صفحه هنگام تبدیل فایل dvi به postscript. این پیام باید یک آرگومان منفرد در خط فرمان باشد، بنابراین در استفاده از نقل‌قول‌ها برای فاصله‌ها و موارد مشابه دقت کنید. توجه داشته باشید که با مشخص کردن گزینهٔ \fB-bm\fR، گزینهٔ \fB-ps\fR به صورت خودکار اعمال می‌شود. .TP .B -bi میزان تیرگی چاپ پیام بنر. یک عدد اعشاری بین 0 و 1. 0 به معنی سیاه و 1 به معنی سفید است. مقدار پیش‌فرض 0.95 است، که مناسب است مگر اینکه کارتریج تونر شما رو به اتمام باشد. .TP .B -bs یک عدد اعشاری که بزرگی اندازهٔ چاپ پیام بنر را تعیین می‌کند. برای به‌دست آوردن مقیاس مناسب برای پیامتان انجام آزمون و خطا لازم است؛ به عنوان یک قاعدهٔ تجربی، این مقیاس باید تقریباً برابر با 1100 تقسیم بر تعداد نویسه‌های پیام باشد. مقدار پیش‌فرض 220.0 است که برای پیام‌های 5 نویسه‌ای کاملاً مناسب است. .TP .B -commands نمایش فهرستی از دستورهای مورد استفاده توسط \fIlatexmk\fR برای پردازش فایل‌ها و سپس خروج. .TP .B -c پاک‌سازی (حذف) تمامی فایل‌های قابل بازتولید که توسط \fIlatex\fR و \fIbibtex\fR یا \fIbiber\fR تولید شده‌اند، به جز dvi، postscript و pdf. این فایل‌ها ترکیبی از فایل‌های log، فایل‌های aux، فایل پایگاه دادهٔ \fIlatexmk\fR از اطلاعات فایل مبدأ، و فایل‌هایی با پسوندهای مشخص‌شده در متغیر پیکربندی \fI@generated_exts\fR هستند. علاوه‌بر این، فایل‌های مشخص‌شده توسط متغیرهای پیکربندی \fI$clean_ext\fR و \fI@generated_exts\fR نیز حذف می‌شوند. این پاک‌سازی به جای یک فرآیند ساخت (make) معمولی انجام می‌شود. اگر می‌خواهید پاک‌سازی و سپس ساخت انجام شود، گزینهٔ \fB-gg\fR را ببینید. \fIنحوه برخورد با فایل‌های .bbl:\fR اگر \fI$bibtex_use\fR روی 0 یا 1 تنظیم شده باشد، فایل‌های bbl همواره به عنوان غیرقابل بازتولید در نظر گرفته می‌شوند. اگر \fI$bibtex_use\fR روی 1.5 تنظیم شده باشد، فایل‌های bbl به صورت مشروط به عنوان غیرقابل بازتولید به حساب می‌آیند: اگر فایل bib وجود داشته باشد، فایل‌های bbl قابل بازتولید هستند و در پاک‌سازی حذف می‌شوند. اما اگر \fI$bibtex_use\fR برابر 1.5 باشد و فایل bib وجود نداشته باشد، با فایل‌های bbl مانند فایل‌های غیرقابل بازتولید رفتار می‌شود و بنابراین حذف نمی‌شوند. در مقابل، اگر \fI$bibtex_use\fR روی 2 تنظیم شده باشد، با فایل‌های bbl همیشه به عنوان فایل‌های قابل بازتولید رفتار شده و در پاک‌سازی حذف می‌شوند. \fIنحوه برخورد با فایل‌های تولیدشده توسط وابستگی‌های سفارشی:\fR اگر \fI$cleanup_includes_cusdep_generated\fR غیرصفر باشد، فایل‌های قابل بازتولید شامل مواردی که توسط وابستگی‌های سفارشی تولید شده‌اند نیز خواهد بود و آن‌ها نیز حذف می‌شوند. در غیر این صورت این فایل‌ها حذف نمی‌شوند. .TP .B -C پاک‌سازی (حذف) تمامی فایل‌های قابل بازتولید تولیدشده توسط \fIlatex\fR و \fIbibtex\fR یا \fIbiber\fR. این گزینه مشابه گزینهٔ \fB-c\fR است، با این تفاوت که فایل‌های dvi، postscript و pdf و فایل‌های مشخص‌شده در متغیر پیکربندی \fI$clean_full_ext\fR را نیز در بر می‌گیرد. این پاک‌سازی به جای یک ساخت معمولی انجام می‌شود. اگر می‌خواهید پس از پاک‌سازی عملیات ساخت انجام شود، گزینهٔ \fB-gg\fR را ببینید. برای تعیین اینکه آیا فایل‌های .bbl به عنوان فایل‌های غیرقابل بازتولید یا قابل بازتولید در نظر گرفته می‌شوند یا خیر، گزینهٔ \fB-c\fR را ببینید. اگر \fI$cleanup_includes_cusdep_generated\fR غیرصفر باشد، فایل‌های قابل بازتولید شامل موارد تولیدشده توسط وابستگی‌های سفارشی نیز در نظر گرفته شده و آن‌ها نیز حذف می‌شوند. در غیر این صورت این فایل‌ها حذف نخواهند شد. .TP .B -CA (منسوخ‌شده). اکنون معادل گزینهٔ \fB-C\fR است. برای جزئیات بیشتر به آن گزینه مراجعه کنید. .TP .B -cd تغییر دایرکتوری به دایرکتوری حاوی فایل مبدأ اصلی پیش از پردازش آن. در این صورت تمامی فایل‌های تولیدشده (.aux، .log، .dvi، .pdf و غیره) به صورت نسبی با فایل مبدأ قرار خواهند گرفت. این گزینه به ویژه زمانی مفید است که \fIlatexmk\fR از یک واسط گرافیکی کاربر (GUI) فراخوانی شود که برای اجرای \fIlatexmk\fR با مسیر کامل فایل مبدأ پیکربندی شده است. این گزینه با تنظیم متغیر پیکربندی \fB$do_cd\fR روی یک (1) کار می‌کند؛ اگر می‌خواهید \fIlatexmk\fR را به گونه‌ای پیکربندی کنید که بدون مشخص کردن این گزینه در خط فرمان اثر گزینهٔ \fB-cd\fR را داشته باشد، می‌توانید آن متغیر را تنظیم کنید. مستندات مربوط به آن متغیر را ببینید. .TP .B -cd- قبل از پردازش فایل مبدأ اصلی، به دایرکتوری حاوی آن وارد \fBنشوید\fR. در این صورت تمامی فایل‌های تولیدشده (.aux، .log، .dvi، .pdf و غیره) به جای فایل مبدأ، نسبت به دایرکتوری جاری خواهند بود. این رفتار پیش‌فرض است و با رفتار برنامه‌های \fI*latex\fR مطابقت دارد. با این حال، زمانی که \fIlatexmk\fR توسط یک GUI پیکربندی‌شده برای فراخوانی \fIlatexmk\fR با مسیر کامل فایل مبدأ اجرا می‌شود، این رفتار مطلوب نیست. گزینهٔ \fB-cd\fR را ببینید. این گزینه با تنظیم متغیر پیکربندی \fB$do_cd\fR روی صفر کار می‌کند. برای اطلاعات بیشتر، مستندات آن متغیر را ببینید. .TP .B -CF حذف فایل حاوی پایگاه دادهٔ اطلاعات فایل مبدأ، پیش از انجام سایر اقدامات درخواستی. .TP .B -d تنظیم حالت پیش‌نویس (draft). این گزینه هنگام تبدیل فایل dvi به postscript، پیام بنر «DRAFT» را در سراسر صفحه چاپ می‌کند. اندازه و تیرگی را می‌توان با گزینه‌های \fB-bs\fR و \fB-bi\fR تغییر داد. گزینهٔ \fB-bm\fR این گزینه را بازنویسی خواهد کرد، زیرا این گزینه در واقع تنها راهی کوتاه برای مشخص کردن دستور زیر است: latexmk -bm DRAFT توجه داشته باشید که با مشخص شدن گزینهٔ \fB-d\fR، گزینهٔ \fB-ps\fR به صورت خودکار اعمال می‌شود. .TP .B -deps نمایش فهرستی از فایل‌های وابسته پس از پردازش. این خروجی به شکل یک فهرست وابستگی از همان نوعی است که توسط برنامهٔ \fImake\fR استفاده می‌شود، و بنابراین برای استفاده در یک Makefile مناسب است. این گزینه یک دید کلی از فایل‌ها، تا جایی که \fIlatexmk\fR قادر به تشخیص آن‌ها باشد، بدون فهرست کردن فایل‌های واسط ارائه می‌دهد. به طور پیش‌فرض، فهرست فایل‌های وابسته به خروجی استاندارد (stdout) فرستاده می‌شود (یعنی معمولاً به صفحه نمایش، مگر اینکه خروجی \fIlatexmk\fR را تغییر مسیر داده باشید). اما می‌توانید با استفاده از گزینهٔ \fB-deps-out=\fR نام فایلی را که فهرست به آن ارسال می‌شود تعیین کنید. برای مثالی از نحوهٔ استفاده از یک فهرست وابستگی با \fImake\fR، بخش «USING \fIlatexmk\fR WITH \fImake\fR» را ببینید. کاربران آشنا با GNU \fIautomake\fR و \fIgcc\fR درخواهند یافت که گزینهٔ \fB-deps\fR از نظر هدف و نتایج بسیار شبیه به گزینهٔ \fB-M\fR در \fIgcc\fR است. (در واقع، \fIlatexmk\fR دارای گزینه‌های \fB-M\fR، \fB-MF\fR و \fB-MP\fR نیز هست که رفتاری مشابه گزینه‌های متناظر در \fIgcc\fR دارند.).TP .B -dependents معادل \fB-deps\fR است. .TP .B -deps- عدم نمایش فهرست فایل‌های وابسته پس از پردازش. (این مقدار پیش‌فرض است.) .TP .B -dependents- معادل \fB-deps-\fR است. .TP .B -deps-escape= تعیین نوع گریزدهی (escaping) مورد استفاده برای فاصله‌ها در فهرست وابستگی. مقادیر ممکن عبارتند از "none" ،"unix" و "nmake" که به‌ترتیب با عدم گریزدهی، گریزدهی با "\\" مناسب برای make استاندارد Unix، و گریزدهی با "^" مناسب برای nmake مایکروسافت مطابقت دارند. .TP .B -deps-out=FILENAME تعیین نام فایلی که فهرست فایل‌های وابسته در آن نوشته می‌شود. اگر آرگومان FILENAME حذف شود یا روی "-" تنظیم گردد، خروجی به stdout ارسال می‌شود. استفاده از این گزینه همچنین خروجی فهرست فایل‌های وابسته را پس از پردازش فعال می‌کند. .TP .B -dF فیلتر کردن فایل dvi. آرگومان این گزینه فیلتری است که یک فایل dvi فیلترشده با پسوند ".dviF" تولید خواهد کرد. سپس تمام پردازش‌های اضافی (مانند تبدیل به postscript، پیش‌نمایش، چاپ) بر روی این فایل dvi فیلترشده انجام خواهد شد. مثال استفاده: برای استفاده از dviselect جهت انتخاب تنها صفحات زوج فایل dvi: latexmk -dF "dviselect even" foo.tex .TP .B -diagnostics چاپ اطلاعات عیب‌یابی دقیق در حین اجرا. این ممکن است برای اشکال‌زدایی مشکلات یا درک رفتار \fIlatexmk\fR در شرایط دشوار مفید باشد. .TP .B -dir-report به ازای هر فایل tex. پردازش‌شده، تنظیمات دایرکتوری‌های aux و out را پس از عادی‌سازی بر اساس مقادیر مشخص‌شده در زمان مقداردهی اولیه، فهرست می‌کند. برای جزئیات بیشتر به توضیحات متغیر \fB$aux_out_dir_report\fR مراجعه کنید. .TP .B -dir-report- عدم گزارش تنظیمات دایرکتوری‌های aux و out. (پیش‌فرض) .TP .B -dir-report-only پس از تکمیل تمام مراحل مقداردهی اولیه، تنظیمات دایرکتوری‌های aux و out را گزارش داده و سپس متوقف می‌شود. این گزینه اساساً برای اشکال‌زدایی مسائل پیکربندی استفاده می‌شود. .TP .B -dvi تولید نسخه dvi سند با استفاده از latex. (و لغو هرگونه درخواست ناسازگار.) .TP .B -dvilua تولید نسخه dvi سند با استفاده از lualatex به‌جای latex. (و لغو هرگونه درخواست ناسازگار.) .TP .B -dvi- غیرفعال کردن تولید نسخه dvi سند. (اگر فایل دیگری ایجاد شود که از فایل dvi تولید می‌گردد [مانند یک فایل ps.]، یا اگر درخواستی برای تولید هیچ فایلی نشده باشد، ممکن است این گزینه نادیده گرفته شود.) .TP .B -dvilualatex="COMMAND" رشته مشخص‌کننده دستور اجرای \fIdvi lualatex\fR را تعیین می‌کند. رفتاری مشابه با گزینه \fB-pdflatex\fR دارد، اما متغیر \fI$dvilualatex\fR را تنظیم می‌کند. \fIنکته: این گزینه هنگامی که به همراه آرگومان COMMAND ارائه شود، تنها دستور فراخوانی dvilualatex را تنظیم می‌کند؛ اما استفاده از dvilualatex را فعال نمی‌سازد. این کار توسط گزینه‌های دیگر یا در یک فایل مقداردهی اولیه انجام می‌شود.\fR .TP .B -e اجرای کد مقداردهی اولیه مشخص‌شده قبل از پردازش. این کد، یک کد \fIPerl\fR با همان ساختاری است که در فایل‌های مقداردهی اولیه \fIlatexmk\fR استفاده می‌شود. برای جزئیات بیشتر، اطلاعات مربوط به گزینه \fB-r\fR و بخش «Configuration/initialization (RC) files» را ببینید. این کد معمولاً دنباله‌ای از عبارت‌های انتساب است که با نقطه‌ویرگول (semicolon) از هم جدا شده‌اند. این کد زمانی اجرا می‌شود که در حین پردازش خط فرمان توسط \fIlatexmk\fR به گزینه \fB-e\fR برخورد شود. برای روش اجرای کد مقداردهی اولیه از یک فایل، گزینه \fB-r\fR را ببینید. بروز خطا باعث توقف \fIlatexmk\fR می‌شود. می‌توان از چندین نمونه از گزینه‌های \fB-r\fR و \fB-e\fR استفاده کرد و آن‌ها به ترتیبی که در خط فرمان ظاهر می‌شوند اجرا می‌گردند. برای نقل‌قول (quoting) صحیح نویسه‌های خاص در کد در خط فرمان، دقت لازم است. برای مثال، فرض کنید می‌خواهید دستور latex را طوری تنظیم کنید که از گزینه -shell-escape خود استفاده کند؛ در این صورت تحت UNIX/Linux می‌توانید از این خط استفاده کنید: latexmk -e '$latex=q/latex %O -shell-escape %S/' file.tex توجه داشته باشید که نقل‌قول‌های تکی (single quotes) مانع از آن می‌شوند که پوسته‌های دستوری عادی UNIX/Linux نویسه‌های درون نقل‌قول را ویژه تلقی کنند. (در این مثال، ساختار q/.../ یک اصطلاح \fIPerl\fR و معادل استفاده از نقل‌قول تکی است. این روش به شیوه‌ای مستقل از پوسته و سیستم‌عامل، از پیچیدگی‌های قرار دادن نویسه نقل‌قول در داخل یک رشته نقل‌قول‌شده جلوگیری می‌کند.) خط فرمان فوق در MS-Windows با cmd.exe یا command.com یا 4nt.exe کار نخواهد کرد. برای MS-Windows با این پوسته‌های دستوری می‌توانید از موارد زیر استفاده کنید: latexmk -e "$latex=q/latex %O -shell-escape %S/" file.tex یا latexmk -e "$latex='latex %O -shell-escape %S'" file.tex دو مثال آخر با پوسته‌های دستوری UNIX/Linux کار نخواهند کرد. (\fIنکته\fR: مثال‌های بالا برای نشان دادن چگونگی استفاده از \fB-e\fR جهت مشخص کردن کد مقداردهی اولیه برای اجرا هستند. اما اثر مورد نظر را می‌توان با استفاده از گزینه \fB-latex\fR با مشکلات کمتری در خصوص نقل‌قول نیز به‌دست آورد.) .TP .B -emulate-aux-dir شبیه‌سازی استفاده از یک دایرکتوری aux به‌جای واگذاری آن به برنامه‌های *latex. (برنامه MiKTeX از -aux-directory پشتیبانی می‌کند، اما TeXLive پشتیبانی نمی‌کند.) برای جزئیات بیشتر به بخش AUXILIARY AND OUTPUT DIRECTORIES مراجعه کنید. .TP .B -emulate-aux-dir- غیرفعال کردن شبیه‌سازی برای پیاده‌سازی یک دایرکتوری aux و واگذاری رسیدگی به حالتی که دایرکتوری aux با دایرکتوری خروجی متفاوت است به برنامه *latex. توجه داشته باشید که اگر از TeXLive استفاده می‌کنید که از -aux-directory پشتیبانی نمی‌کند، latexmk پس از اولین اجرای *latex شبیه‌سازی aux_dir را به‌طور خودکار فعال می‌کند، زیرا فایل log. را در مکان نادرستی پیدا خواهد کرد. .TP .B -f اجبار \fIlatexmk\fR به ادامه پردازش سند علیرغم خطاها. به‌طور معمول، هنگامی که \fIlatexmk\fR تشخیص می‌دهد LaTeX یا برنامه دیگری خطایی یافته است که با پردازش بیشتر برطرف نمی‌شود، هیچ پردازش بیشتری انجام نمی‌شود. نکته: منظور از «پردازش بیشتر»، اجرای برنامه‌های دیگر یا اجرای مجدد \fIlatex\fR (و غیره) است که در صورت عدم وقوع خطا انجام می‌شد. اگر در عوض، یا علاوه بر این، می‌خواهید برنامه \fIlatex\fR (و غیره) پس از بروز خطا برای ورودی کاربر مکث نکند، باید این کار را با گزینه‌ای که به برنامه ارسال می‌شود ترتیب دهید، برای مثال از طریق گزینه \fB-interaction=nonstopmode\fR در \fIlatexmk\fR (که \fIlatexmk\fR آن را به \fI*latex\fR ارسال می‌کند). .TP .B -f- غیرفعال کردن پردازش اجباری پس از خطاها که توسط گزینه \fB-f\fR تنظیم می‌شود. این گزینه می‌تواند برای نادیده گرفتن تنظیمی در یک فایل پیکربندی استفاده شود. .TP .B -g حالت پیشروی (Go mode): اجبار \fIlatexmk\fR به اجرای هر قاعده حداقل یک بار، حتی در شرایطی که \fIlatexmk\fR معمولاً تشخیص می‌دهد از زمان اجرای قبلی هیچ تغییری در فایل‌های منبع رخ نداده است. این گزینه برای مثال زمانی مفید است که پیکربندی را تغییر دهید و مایل باشید تمام فایل‌ها دوباره پردازش شوند. به‌طور معادل: همه قواعد در ابتدا باید منسوخ‌شده (out of date) در نظر گرفته شوند. این گزینه این عیب را دارد که برای مثال، اگر وابستگی‌های سفارشی بسیار زیادی برای ایجاد فایل‌های گرافیکی وجود داشته باشد، همه آن‌ها اجرا خواهند شد که می‌تواند بسیار زمان‌بر باشد. همچنین گزینه \fB-gt\fR را ببینید که فقط اجرای مجدد *latex را اجباری می‌کند. .TP .B -g- غیرفعال کردن \fB-g\fR. .TP .B -gg «حالت پیشروی فوق‌العاده» یا «ساخت پاکیزه»: پاک‌سازی فایل‌های تولیدشده همانند زمانی که گزینه \fB-C\fR داده شده باشد، و سپس انجام یک ساخت (make) معمولی. .TP .B -gt الزام به حداقل یک بار اجرای *latex. بدین معنا که پردازش به‌طور عادی انجام می‌شود، به جز این‌که حداقل یک بار اجرای قاعده *latex باید انجام گیرد، حتی زمانی که روش‌های معمول \fIlatexmk\fR به این نتیجه برسند که اجرای *latex لازم نیست. به‌طور معادل، قاعده *latex در ابتدا منسوخ‌شده در نظر گرفته می‌شود. توجه داشته باشید که \fIlatexmk\fR ممکن است به‌طور جداگانه با روش‌های معمول خود منسوخ بودن سایر قواعد را تشخیص دهد. اگر این قواعد معمولاً قبل از *latex اجرا می‌شوند، همچنان انجام خواهند شد. این گزینه به‌ویژه زمانی مفید است که تغییراتی در پیکربندی ایجاد شده باشد یا تحت شرایط خطای خاصی که در آن \fIlatexmk\fR نیاز به اجرای *latex را به‌درستی تشخیص نمی‌دهد، اما این اجرا ضروری است..TP .B -h \fRیا\fB -help چاپ اطلاعات راهنما. .TP .B -hnt تولید نسخه hnt (HINT) از سند با استفاده از hilatex. (و غیرفعال کردن هرگونه درخواست ناسازگار.) .TP .B -jobname=STRING تنظیم نام پایه (basename) فایل(های) خروجی روی STRING، به‌جای مقدار پیش‌فرض که نام پایه فایل TeX مشخص‌شده است. (در حال حاضر، STRING نباید شامل فاصله باشد.) این مانند همان گزینه در پیاده‌سازی‌های فعلی \fI*latex\fR است، و ارسال این گزینه به این برنامه‌ها بخشی از پیاده‌سازی \fB-jobname\fR در \fIlatexmk\fR است. یک بهبود وجود دارد: STRING می‌تواند حاوی جانگهدار '%A' باشد. این مقدار با نام پایه فایل TeX جایگزین خواهد شد. هدف اصلی زمانی است که چندین فایل در خط فرمان به \fIlatexmk\fR داده می‌شود و می‌خواهید برای هر فایل از یک jobname با مقدار وابسته به فایل متفاوتی استفاده کنید. برای نمونه، فرض کنید فایل‌های .tex با نام‌های test1.tex و test2.tex دارید و می‌خواهید نتایج کامپایل توسط \fI*latex\fR را با نتایج \fIxelatex\fR مقایسه کنید. در این صورت در یک سیستم‌عامل شبه‌یونیکس می‌توانید از خط فرمان زیر استفاده کنید: latexmk -pdf -jobname=%A-pdflatex *.tex latexmk -pdfxe -jobname=%A-xelatex *.tex سپس فایل‌های .aux، .log و .pdf حاصل از به‌کارگیری \fIpdflatex\fR دارای نام‌های پایه test1-pdflatex و test2-pdflatex خواهند بود، در حالی که از \fIxelatex\fR، نام‌های پایه test1-xelatex و test2-xelatex خواهند بود. در MS-Windows با cmd.exe، باید علامت درصد را دو برابر کنید تا نویسه درصد به latexmk ارسال شود، نه اینکه برای جایگزینی یک متغیر محیطی استفاده شود: latexmk -pdf -jobname=%%A-pdflatex *.tex latexmk -pdfxe -jobname=%%A-xelatex *.tex .TP .B -l اجرا در حالت افقی (landscape)، با استفاده از حالت افقی برای پیش‌نمایش‌گرها و تبدیل‌کننده‌های dvi به postscript. این گزینه امروزه معمولاً مورد نیاز نیست، زیرا پیش‌نمایش‌گرهای امروزی معمولاً این اطلاعات را به‌طور خودکار تشخیص می‌دهند. .TP .B -l- غیرفعال کردن \fB-l\fR. .TP .B -latex تولید فایل‌های dvi توسط \fIlatex\fR را فعال کرده، و تولید فایل‌های pdf و ps را غیرفعال می‌کند. \fIنکته: برای تنظیم \fRدستور\fI مورد استفاده هنگام مشخص شدن latex، گزینه \fB-latex="COMMAND"\fI را ببینید.\fR .TP .B -latex="COMMAND" رشته تعیین‌کننده دستور برای اجرای latex را تنظیم می‌کند و معمولاً برای افزودن گزینه‌های دلخواه به کار می‌رود. از آنجا که این رشته معمولاً شامل فاصله است، باید درون علامت نقل‌قول قرار گیرد، مانند: latexmk -latex="latex --shell-escape %O %S" foo.tex مشخصات محتویات این رشته مشابه متغیر پیکربندی \fI$latex\fR است. بسته به سیستم‌عامل شما و پوسته خط فرمانی که استفاده می‌کنید، ممکن است نیاز باشد نقل‌قول تکی را به نقل‌قول دوگانه (یا چیز دیگری) تغییر دهید. \fIنکته: این گزینه هنگامی که با آرگومان COMMAND ارائه می‌شود، صرفاً دستور فراخوانی latex را تنظیم می‌کند؛ و استفاده از latex را فعال نمی‌سازد. این کار توسط گزینه‌های دیگر یا در یک فایل مقداردهی اولیه انجام می‌شود.\fR برای تنظیم دستور اجرای \fIpdflatex\fR (به‌جای دستور برای \fIlatex\fR) گزینه \fB-pdflatex\fR را ببینید. .TP .B -logfilewarninglist .B -logfilewarnings پس از یک بار اجرای \fI*latex\fR، فهرستی از هشدارهای مربوط به ارجاعات و مراجع تعریف‌نشده ارائه می‌دهد (مگر اینکه حالت بی‌صدا فعال باشد). همچنین متغیر پیکربندی \fI$silence_logfile_warnings\fR را ببینید. .TP .B -logfilewarninglist- .B -logfilewarnings- پس از یک بار اجرای \fI*latex\fR، فهرستی از هشدارهای مربوط به ارجاعات و مراجع تعریف‌نشده ارائه نمی‌دهد. (پیش‌فرض) همچنین متغیر پیکربندی \fI$silence_logfile_warnings\fR را ببینید. .TP .B -lualatex استفاده از \fIlualatex\fR. بدین معنا که از \fIlualatex\fR برای پردازش فایل(های) مبدأ به pdf استفاده می‌کند. تولید فایل‌های dvi، hnt، postscript و xdv غیرفعال می‌شود. این گزینه معادل استفاده از مجموعه گزینه‌های زیر است: -pdflua -dvi- -ps- (\fIنکته\fR: توجه داشته باشید که روش پیاده‌سازی این گزینه، اما نه اثر مورد نظر آن، با برخی از نسخه‌های قبلی \fIlatexmk\fR تفاوت دارد.) .TP .B -lualatex="COMMAND" رشته تعیین‌کننده دستور برای اجرای \fIlualatex\fR را تنظیم می‌کند. رفتاری شبیه به گزینه \fB-pdflatex\fR دارد، اما متغیر \fI$lualatex\fR را تنظیم می‌کند. \fIنکته: این گزینه هنگامی که با آرگومان COMMAND ارائه می‌شود، صرفاً دستور فراخوانی lualatex را تنظیم می‌کند؛ و استفاده از lualatex را فعال نمی‌سازد. این کار توسط گزینه‌های دیگر یا در یک فایل مقداردهی اولیه انجام می‌شود.\fR .TP .B -M نمایش فهرست فایل‌های وابسته پس از پردازش. این معادل گزینه \fB-deps\fR است. .TP .B -MF file اگر فهرستی از وابستگی‌ها تهیه شود، \fB-MF\fR فایلی را که فهرست در آن نوشته شود مشخص می‌کند. .TP .B -MP اگر فهرستی از وابستگی‌ها تهیه شود، یک هدف ساختگی (phony target) برای هر فایل مبدأ لحاظ می‌کند. اگر از فهرست وابستگی‌ها در یک Makefile استفاده کنید، این قواعد ساختگی خطاهایی را که برنامه \fImake\fR در صورت حذف فایل‌های سرآیند بدون به‌روزرسانی متناظر Makefile می‌دهد، دور می‌زنند. .TP .B -makeindexfudge فعال کردن ترفند تغییر دایرکتوری (change-directory fudge) برای makeindex. برای جزئیات به مستندات \fI$makeindex_fudge\fR مراجعه کنید. .TP .B -makeindexfudge- غیرفعال کردن ترفند تغییر دایرکتوری برای makeindex. برای جزئیات به مستندات \fI$makeindex_fudge\fR مراجعه کنید. .TP .B $min_sleep_time [0.01] حداقل مقدار غیرصفر مجاز برای \fI$sleep_time\fR است. .TP .B -MSWinBackSlash این گزینه تنها زمانی اثر دارد که \fIlatexmk\fR در MS-Windows اجرا شود. بدین صورت که وقتی \fIlatexmk\fR دستوری را در MS-Windows اجرا می‌کند، جداکننده استاندارد دایرکتوری در ویندوز یعنی "\\" برای جدا کردن اجزای دایرکتوری در نام فایل استفاده می‌شود. در درون برنامه، \fIlatexmk\fR از "/" برای نویسه جداکننده دایرکتوری استفاده می‌کند که همان نویسه مورد استفاده در سیستم‌های شبه‌یونیکس است. این رفتار پیش‌فرض است. با این حال ممکن است مقدار پیش‌فرض توسط یک فایل پیکربندی (فایل latexmkrc) که \fI$MSWin_back_slash=0\fR را تنظیم کرده است بازنویسی شده باشد. .TP .B -MSWinBackSlash- این گزینه تنها زمانی اثر دارد که \fIlatexmk\fR در MS-Windows اجرا شود. بدین صورت که وقتی \fIlatexmk\fR دستوری را در MS-Windows اجرا می‌کند، جایگزینی "\\" به عنوان نویسه جداکننده بین اجزای دایرکتوری در نام فایل انجام \fIنمی‌شود\fR. در عوض از اسلش رو به جلو "/" استفاده می‌شود، همانند سیستم‌های شبه‌یونیکس. این در بیشتر شرایط در MS-Windows قابل قبول است، به شرطی که نام فایل‌ها به درستی درون نقل‌قول قرار گیرند، همان‌طور که \fIlatexmk\fR به‌طور پیش‌فرض این کار را انجام می‌دهد. برای جزئیات بیشتر به مستندات متغیر پیکربندی \fI$MSWin_back_slash\fR مراجعه کنید. .TP .B -new-viewer در حالت پیش‌نمایش مداوم، همیشه یک نمایش‌دهنده جدید برای مشاهده فایل تولیدشده باز می‌کند. به‌طور پیش‌فرض، \fIlatexmk\fR در حالت پیش‌نمایش مداوم، وجود یک پیش‌نمایش‌گر قبلی در حال اجرا را برای همان فایل بررسی می‌کند و در صورت اجرای پیش‌نمایش‌گر قبلی، مورد جدیدی را باز نمی‌کند. با این حال، این بررسی گاهی اوقات با شکست مواجه می‌شود (به‌ویژه اگر یک پیش‌نمایش‌گر از قبل در حال اجرا باشد که فایلی با همان نام فایل فعلی، اما در دایرکتوری متفاوتی را مشاهده می‌کند). این گزینه رفتار پیش‌فرض را غیرفعال می‌کند. .TP .B -new-viewer- معکوس گزینه \fB-new-viewer\fR. این گزینه \fIlatexmk\fR را به رفتار عادی خود بازمی‌گرداند که در حالت پیش‌نمایش مداوم وجود یک پیش‌نمایش‌گر در حال اجرا را بررسی می‌کند. .TP .B -nobibtex هرگز bibtex یا biber را اجرا نمی‌کند. معادل گزینه \fB-bibtex-\fR است..TP .B -nobibtexfudge \fRیا\fB -nobibfudge ترفند تغییر دایرکتوری را برای bibtex غیرفعال می‌کند. برای جزئیات به مستندات \fI$bibtex_fudge\fR مراجعه کنید. .TP .B -noemulate-aux-dir شبیه‌سازی aux_dir را غیرفعال می‌کند. مشابه \fI-emulate-aux-dir-\fR. .TP .B -nomakeindexfudge ترفند تغییر دایرکتوری را برای makeindex غیرفعال می‌کند. برای جزئیات به مستندات \fI$makeindex_fudge\fR مراجعه کنید. .TP .B -norc خواندن خودکار فایل‌های مقداردهی اولیه (rc) را غیرفعال می‌کند. نکته: در حالت عادی، فایل‌های مقداردهی اولیه خوانده شده و اجرا می‌شوند، و سپس گزینه‌های خط فرمان به ترتیبی که در خط فرمان قرار گرفته‌اند اعمال می‌گردند. اما \fB-norc\fR از این قاعده مستثنی است: بدون توجه به اینکه در کجای خط فرمان قرار دارد، ابتدا پردازش و اعمال می‌شود. .TP .B -outdir=FOO \fRیا\fB -output-directory=FOO دایرکتوری فایل‌های خروجی *latex را تعیین می‌کند. اگر دایرکتوری aux تعیین نشده باشد یا با دایرکتوری خروجی یکسان باشد، تمام فایل‌های خروجی *latex به دایرکتوری خروجی ارسال می‌شوند. اگر دایرکتوری aux تنظیم شده باشد (مثلاً توسط گزینه \fB-auxdir\fR) و با دایرکتوری خروجی برابر نباشد، تنها فایل‌های خروجی اصلی (.dvi، .ps، .pdf، .synctex، .synctex.gz) به دایرکتوری خروجی فرستاده می‌شوند. سایر فایل‌های تولیدشده به دایرکتوری aux منتقل می‌شوند. برای جزئیات بیشتر به بخش AUXILIARY AND OUTPUT DIRECTORIES مراجعه کنید. .TP .B -out2dir=FOO (\fIقابلیت جدید و آزمایشی.\fR) دایرکتوری فایل‌های خروجی نهایی حاصل از یک دور کامل کامپایل را تعیین می‌کند. استفاده از این دایرکتوری از جمله این مشکل را حل می‌کند که هنگام نیاز به اجرای چندباره *latex و برنامه‌های دیگر، فایل‌هایی مانند فایل اصلی pdf تولیدشده توسط pdflatex و غیره چندین بار تغییر می‌یابند. برنامه‌های نمایشگری مانند SumatraPDF که فایل را با تشخیص هرگونه تغییر مجدداً بارگذاری می‌کنند، توالی آزاردهنده‌ای از وضعیت‌های میانی فایل pdf را نمایش می‌دهند، نه فقط نسخه نهایی را پس از پایان کامل تمام اجراهای مکرر *latex. در عوض، هنگامی که یک دایرکتوری خروجی نهایی مجزا توسط گزینه \fB-out2dir\fR یا متغیر معادل \fI$out2_dir\fR تنظیم شود، نمایشگر فایل pdf (وغیره) را تنها پس از پایان توالی کامل اجراهای مکرر *latex مشاهده خواهد کرد. به‌طور پیش‌فرض، دایرکتوری خروجی نهایی همان دایرکتوری خروجی است (همان‌گونه که توسط گزینه \fB-outdir\fR یا متغیر پیکربندی \fI$out_dir\fR مشخص شده است). .TP .B -output-format=FORMAT این گزینه یکی از مواردی است که برای \fIlatex\fR، \fIlualatex\fR و \fIpdflatex\fR مجاز است. اما به این برنامه‌ها فرستاده نمی‌شود. در عوض، \fIlatexmk\fR آن را به شیوه‌ای متناسب با زمینه و جریان‌های کاری \fIlatexmk\fR شبیه‌سازی می‌کند. اگر FORMAT برابر dvi باشد، خروجی dvi فعال شده و خروجی‌های postscript، pdf و xdv غیرفعال می‌شوند. این معادل استفاده از گزینه‌های \fB-dvi -ps- -pdf- -xdv-\fR است. اگر FORMAT برابر pdf باشد، خروجی pdf فعال شده و خروجی‌های dvi، postscript و xdv غیرفعال می‌شوند. این معادل استفاده از گزینه‌های \fB-pdf -ps- -dvi- -xdv-\fR است. اگر FORMAT هر چیز دیگری باشد، \fIlatexmk\fR خطا می‌دهد. .TP .B -p چاپ سند. به‌طور پیش‌فرض فایلی که چاپ می‌شود اولین فایل موجود در لیست postscript، pdf و dvi است که در حال ساخته شدن است. اما می‌توانید از گزینه \fB-print=...\fR برای تغییر نوع فایل چاپی استفاده کنید، و می‌توانید این مورد را در یک فایل راه‌انداز (با تنظیم متغیر \fI$print_type\fR) پیکربندی کنید. با این حال، چاپ به‌طور پیش‌فرض تنها در سیستم‌های UNIX/Linux فعال است، جایی که پیش‌فرض استفاده از دستور lpr و فقط روی فایل‌های postscript است. به‌طور کلی، رفتار صحیح چاپ به نرم‌افزارهای سیستم شما بستگی دارد. به‌ویژه در MS-Windows باید برنامه‌(های) مناسبی در دسترس داشته باشید و دستورات چاپ مورد استفاده \fIlatexmk\fR را پیکربندی کرده باشید. این امر می‌تواند پیچیده باشد. برای مشاهده نحوه تنظیم دستورات چاپ، به مستندات متغیرهای پیکربندی \fI$lpr\fR، \fI$lpr_dvi\fR و \fI$lpr_pdf\fR مراجعه کنید. این گزینه با گزینه‌های \fB-pv\fR و \fB-pvc\fR ناسازگار است، بنابراین آن‌ها را غیرفعال می‌کند. .TP .B -pdf تولید نسخه pdf سند با استفاده از \fIpdflatex\fR. (و غیرفعال کردن هرگونه درخواست ناسازگار.) (اگر می‌خواهید از \fIlualatex\fR یا \fIxelatex\fR استفاده کنید، می‌توانید هرکدام از گزینه‌های مرتبط شامل \fB-pdflua\fR، \fB-pdfxe\fR، \fB-lualatex\fR یا \fB-xelatex\fR را به کار ببرید.) برای پیکربندی \fIlatexmk\fR جهت داشتن چنین رفتاری به‌طور پیش‌فرض، به بخش "Configuration/initialization (rc) files" مراجعه کنید. .TP .B -pdfdvi تولید فایل dvi و سپس تولید نسخه pdf سند از روی فایل dvi، به‌طور پیش‌فرض با استفاده از dvipdf. (و غیرفعال کردن هرگونه درخواست ناسازگار.) برنامه‌ای که به‌طور پیش‌فرض برای کامپایل سند به dvi استفاده می‌شود \fIlatex\fR است، اما این برنامه را می‌توان با استفاده از گزینه \fB-dvilua\fR یا با تنظیم \fI$dvi_mode\fR روی 2 به \fIdvilulatex\fR تغییر داد. .TP .B -pdflua تولید نسخه pdf سند با استفاده از \fIlualatex\fR. (و غیرفعال کردن هرگونه درخواست ناسازگار.) .TP .B -pdfps تولید فایل dvi، سپس فایل ps از روی فایل dvi، و در نهایت فایل pdf از روی فایل ps. (و غیرفعال کردن هرگونه درخواست ناسازگار.) برنامه‌ای که به‌طور پیش‌فرض برای کامپایل سند به dvi استفاده می‌شود \fIlatex\fR است، اما این برنامه را می‌توان با استفاده از گزینه \fB-dvilua\fR یا با تنظیم \fI$dvi_mode\fR روی 2 به \fIdvilulatex\fR تغییر داد. .TP .B -pdfxe تولید نسخه pdf سند با استفاده از \fIxelatex\fR. (و غیرفعال کردن هرگونه درخواست ناسازگار.) توجه داشته باشید که برای بهینه‌سازی زمان پردازش، \fIlatexmk\fR از \fIxelatex\fR برای ایجاد یک فایل .xdv به جای تولید مستقیم فایل pdf استفاده می‌کند. تنها پس از اجراهای احتمالاً مکرر برای ایجاد یک فایل .xdv کاملاً به‌روز، \fIlatexmk\fR ابزار \fIxdvipdfmx\fR را برای تولید فایل نهایی .pdf فراخوانی می‌کند. (\fIنکته:\fR دلیل اینکه \fIlatexmk\fR تمهیداتی به کار می‌برد تا \fIxelatex\fR به جای حالت پیش‌فرض خود (.pdf)، فایل .xdv بسازد این است: هنگامی که سند شامل فایل‌های گرافیکی بزرگ، به‌ویژه فایل‌های .png است، تولید فایل .pdf می‌تواند حتی زمانی که ایجاد فایل .xdv توسط \fIxelatex\fR سریع است، بسیار زمان‌بر باشد. بنابراین استفاده از فایل واسط .xdv می‌تواند به صرفه‌جویی قابل‌توجهی در زمان پردازش منجر شود، چرا که فایل .pdf تنها یک بار تولید می‌شود، نه در هر بار اجرای \fIxelatex\fR.) .TP .B -pdf- غیرفعال کردن تولید نسخه pdf سند. (این گزینه می‌تواند برای لغو تنظیمی در یک فایل پیکربندی به کار رود. اگر گزینه دیگری نیاز به تولید فایل pdf داشته باشد، ممکن است این حالت نادیده گرفته شود.) اگر پس از پردازش تمام گزینه‌ها، تولید pdf همچنان غیرفعال باشد، تولید فایل dvi فعال خواهد شد، و برنامه مورد استفاده برای کامپایل سند \fIlatex\fR خواهد بود (یا به‌طور دقیق‌تر، هر برنامه‌ای که در متغیر پیکربندی \fI$latex\fR تنظیم شده باشد). .TP .B -pdflatex تنظیم تولید فایل‌های pdf توسط \fIpdflatex\fR. (و غیرفعال کردن هرگونه درخواست ناسازگار.) \fIنکته: برای تنظیم \fRدستور\fI مورد استفاده هنگام مشخص شدن pdflatex، گزینه \fB-pdflatex="COMMAND"\fI را ببینید.\fR .TP .B -pdflatex="COMMAND" این گزینه رشته مشخص‌کننده دستور اجرای \fIpdflatex\fR را تعیین می‌کند، و معمولاً برای افزودن گزینه‌های مورد نظر استفاده می‌شود. از آنجا که این رشته معمولاً شامل فاصله است، باید درون علامت نقل‌قول قرار گیرد، مانند: latexmk -pdf -pdflatex="pdflatex --shell-escape %O %S" foo.tex مشخصات محتویات این رشته همانند متغیر پیکربندی \fI$pdflatex\fR است. (گزینه \fB-pdflatex\fR در واقع متغیر \fI$pdflatex\fR را مقداردهی می‌کند.) بسته به سیستم‌عامل و پوسته خط فرمانی که استفاده می‌کنید، ممکن است نیاز باشد نقل‌قول تکی را به نقل‌قول دوتایی (یا چیز دیگری) تغییر دهید. \fIنکته: این گزینه هنگامی که همراه با آرگومان COMMAND ارائه شود، تنها دستور فراخوانی pdflatex را مشخص می‌کند؛ استفاده از pdflatex را فعال نمی‌کند. این کار توسط گزینه‌های دیگر یا در یک فایل مقداردهی اولیه انجام می‌شود.\fR برای تنظیم دستور اجرای \fIlatex\fR (به جای دستور برای \fIpdflatex\fR) به گزینه \fB-latex\fR مراجعه کنید..TP .B -pdflualatex="COMMAND" معادل \fB-lualatex="COMMAND"\fR است. .TP .B -pdfxelatex="COMMAND" معادل \fB-xelatex="COMMAND"\fR است. .TP .B -pretex=CODE با فرض اینکه CODE مقداری کد TeX باشد، این گزینه آن کد را طوری تنظیم می‌کند که قبل از وارد کردن فایل منبع اجرا شود. این قابلیت تنها در صورتی کار می‌کند که دستور فراخوانی \fI*latex\fR مربوطه به شکل مناسب پیکربندی شده باشد. برای جزئیات بیشتر به مستندات متغیر \fI$pre_tex_code\fR و رشته‌های جایگزینی %P و %U مراجعه کنید. این گزینه با تنظیم متغیر \fI$pre_tex_code\fR عمل می‌کند. همچنین گزینهٔ \fB-usepretex\fR را ببینید. یک مثال: latexmk -pretex='\\AtBeginDocument{Message\\par}' -usepretex foo.tex اما بهتر است این‌گونه نوشته شود: latexmk -usepretex='\\AtBeginDocument{Message\\par}' foo.tex اگر از پیش دستور مناسبی پیکربندی کرده‌اید، فقط به این نیاز دارید: latexmk -pretex='\\AtBeginDocument{Message\\par}' foo.tex .TP .B -print=dvi\fR,\fB -print=ps\fR,\fB -print=pdf\fR,\fB -print=auto, نوع فایلی را که باید چاپ شود تعیین می‌کند. این گزینه همچنین اطمینان حاصل می‌کند که فایل مورد نیاز ساخته شود، و قابلیت چاپ را فعال می‌کند. حالت (پیش‌فرض) \fB-print=auto\fR نوع فایل چاپ را به‌طور خودکار از بین مجموعه فایل‌های در حال ساخت تعیین می‌کند. نخستین مورد از فهرست postscript،‏ pdf،‏ dvi که در میان فایل‌های در حال ساخت باشد، برای خروجی چاپ استفاده می‌شود. .TP .B -ps تولید نسخهٔ postscript سند. (و لغو هرگونه درخواست ناسازگار.) .TP .B -ps- خاموش کردن تولید نسخهٔ postscript سند. این گزینه می‌تواند برای بازنویسی تنظیمی در یک فایل پیکربندی استفاده شود. (ممکن است توسط گزینهٔ دیگری که به فایل postscript نیاز دارد، برای نمونه درخواستی برای چاپ، بازنویسی شود.) .TP .B -pF پالایش (فیلتر کردن) فایل Postscript. آرگومان این گزینه پالایه‌ای است که یک فایل postscript پالایش‌شده با پسوند «.psF» تولید می‌کند. تمام پردازش‌های اضافی (مانند پیش‌نمایش، چاپ) سپس روی این فایل postscript پالایش‌شده انجام خواهد شد. مثال کاربرد: استفاده از psnup برای چاپ دو صفحه در یک صفحه: latexmk -ps -pF 'psnup -2' foo.tex یا latexmk -ps -pF "psnup -2" foo.tex اینکه از نقل‌قول تکی استفاده شود یا دوتایی در اطراف "psnup -2"، به مفسر دستور شما، که توسط نسخهٔ خاص perl و سیستم‌عامل رایانهٔ شما استفاده می‌شود، بستگی خواهد داشت. .TP .B -pv اجرای پیش‌نمایش‌گر فایل. اگر از گزینهٔ \fB-view\fR استفاده شود، آن گزینه نوع فایلی که باید پیش‌نمایش داده شود (.pdf،‏ .ps یا .dvi) را انتخاب می‌کند. در غیر این صورت، نمایش‌گر «بالاترین» نوع فایل خروجی ساخته‌شده را نمایش می‌دهد که اولویت آن از بالا به پایین به صورت .pdf،‏ .ps،‏ .dvi است. این گزینه با گزینه‌های \fB-p\fR و \fB-pvc\fR ناسازگار است، بنابراین آن‌ها را خاموش می‌کند. .TP .B -pv- خاموش کردن \fB-pv\fR. .TP .B -pvc اجرای یک پیش‌نمایش‌گر فایل و به‌روزرسانی مداوم فایل‌های .dvi،‏ .ps و/یا .pdf هر زمان که تغییراتی در فایل‌های منبع ایجاد شود (بخش «توضیحات» در بالا را ببینید). اینکه کدام یک از این فایل‌ها تولید و کدام یک مشاهده می‌شود توسط گزینه‌های دیگر کنترل می‌گردد و مشابه گزینهٔ \fB-pv\fR است. گزینهٔ پیش‌نمایش مداوم \fB-pvc\fR تنها می‌تواند با یک فایل کار کند. بنابراین در این حالت شما معمولاً فقط یک نام فایل را در خط فرمان مشخص می‌کنید. این گزینه همچنین با گزینه‌های \fB-p\fR و \fB-pv\fR ناسازگار است، بنابراین این گزینه‌ها را خاموش می‌کند. گزینهٔ \fB-pvc\fR همچنین حالت اجباری (\fB-f\fR) را خاموش می‌کند، چرا که معمولاً برای حالت پیش‌نمایش مداوم بهترین وضعیت است. اگر واقعاً حالت اجباری را می‌خواهید، از گزینه‌ها به ترتیب \fB-pvc -f\fR استفاده کنید. با یک پیش‌نمایش‌گر مناسب، صفحه به‌طور خودکار به‌روزرسانی خواهد شد. (در \fIبرخی و نه همهٔ\fR نسخه‌های UNIX/Linux دستور "gv -watch" این کار را برای فایل‌های postscript انجام می‌دهد؛ این مورد می‌تواند توسط یک متغیر پیکربندی تنظیم شود. این قابلیت برای فایل‌های pdf نیز کار می‌کرد، به جز یک باگ ظاهری در gv که هنگام خواندن فایل pdf تازه به‌روزرسانی‌شده باعث بروز خطا می‌شود.) بسیاری از پیش‌نمایش‌گرهای دیگر به به‌روزرسانی دستی نیاز خواهند داشت. \fBنکتهٔ مهم\fR: برنامهٔ acroread در MS-Windows فایل pdf را قفل می‌کند و مانع از نوشته شدن نسخه‌های جدید می‌شود، بنابراین ایدهٔ بدی است که از acroread برای مشاهدهٔ فایل‌های pdf در حالت پیش‌نمایش مداوم استفاده کنید. بهتر است از نمایش‌گر متفاوتی استفاده شود: \fISumatraPDF\fR و \fIgsview\fR گزینه‌های مناسبی هستند. روش‌های دیگری نیز برای ترتیب دادن به‌روزرسانی وجود دارد که به‌ویژه برای بسیاری از نسخه‌های \fIxdvi\fR و \fIxpdf\fR کاربردی است. بهتر است این موارد در پیکربندی \fIlatexmk\fR تنظیم شوند؛ بخش‌های زیر را ببینید. توجه داشته باشید که اگر \fIlatexmk\fR متوقف شود یا توسط کاربر خاتمه یابد، پیش‌نمایش‌گر منشعب‌شده (forked) به اجرای خود ادامه خواهد داد. فراخوانی‌های متوالی با گزینهٔ \fB-pvc\fR پیش‌نمایش‌گرهای جدیدی ایجاد نخواهند کرد، بلکه \fIlatexmk\fR معمولاً از پیش‌نمایش‌گر موجود استفاده خواهد کرد. (دست‌کم این اتفاق زمانی رخ می‌دهد که \fIlatexmk\fR تحت سیستم‌عاملی اجرا شود که بداند چگونه در حال اجرا بودن یک پیش‌نمایش‌گر موجود را تشخیص دهد.) .TP .B -pvc- خاموش کردن \fB-pvc\fR. .TP .B -pvctimeout اعمال اتمام مهلت زمانی (timeout) در حالت pvc پس از یک دوره عدم فعالیت، که به‌طور پیش‌فرض ۳۰ دقیقه است. عدم فعالیت به معنای دوره‌ای است که \fIlatexmk\fR هیچ تغییر فایلی را تشخیص نداده و در نتیجه هیچ اقدامی مانند کامپایل کردن سند انجام نداده است. .TP .B -pvctimeout- عدم اعمال اتمام مهلت زمانی در حالت pvc پس از عدم فعالیت. .TP .B -pvctimeoutmins=