نام (NAME)

mtx-context - مدیریت فرایند ConTeXt

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

mtxrun --script context [ OPTIONS ... ] [ FILENAMES ]

توضیحات (DESCRIPTION)

مدیریت فرایند ConTeXt

گزینه‌های پایه (OPTIONS: BASIC)

--run: پردازش (یک یا چند) فایل (عملکرد پیش‌فرض)
--make: ایجاد فرمت‌های context
--ctx=name: استفاده از فایل ctx (مشخصات مدیریت فرایند)
--noctx: نادیده گرفتن دستورالعمل‌ها (directives) و پرچم‌های ctx
--interface: استفاده از رابط کاربری مشخص‌شده (پیش‌فرض: en)
--autopdf: بستن فایل pdf در نمایشگر و اجرای مجدد نمایشگر pdf پس از اتمام کار
--purge: پاکسازی فایل‌ها در هر صورت پس از یک اجرا (--pattern=...)
--purgeall: پاکسازی تمام فایل‌ها در هر صورت پس از یک اجرا (--pattern=...)
--usemodule=list: بارگذاری پودمان (ماژول) یا شیوه (style) مشخص‌شده، که معمولاً بخشی از توزیع است
--environment=list: بارگذاری نخست فایل محیط (environment) داده‌شده (شیوه‌های سند)
--mode=list: فعال‌سازی حالت‌های مشخص‌شده (پردازش شرطی در شیوه‌ها)
--path=list: بررسی مسیرهای مشخص‌شده علاوه بر مسیرهای دیگر هنگام جست‌وجوی فایل‌ها
--arguments=list: تنظیم متغیرهایی که حین اجرا قابل ارجاع هستند (جفت‌های کلید/مقدار)
--randomseed=number: تنظیم بذر تصادفی (randomseed)
--result=name: تغییر نام فایل خروجی نهایی به نام مشخص‌شده
--trackers=list: تنظیم متغیرهای ردیاب (نمایش فهرست با --showtrackers)
--directives=list: تنظیم متغیرهای دستورالعمل (نمایش فهرست با --showdirectives)
--silent=list: غیرفعال کردن دسته‌بندی‌های لاگ (نمایش فهرست با --showlogcategories)
--strip: حذف کدهای زائد Lua (تنها مناسب برای محیط نهایی که در آن خطایی انتظار نمی‌رود)
--errors=list: نمایش خطاها در پایان اجرا، و خروج در صورت تطابق با فهرست (حتی در حالت --silent)
--htmlerrorpage: تولید صفحه خطای html به جای حالت عادی (اختیاری: =scite)
--noconsole: غیرفعال‌سازی ثبت لاگ در کنسول (فقط در فایل لاگ)
--nodummy: عدم ایجاد فایل صوری (dummy) (ممکن است نمایشگرهای pdf که فایل را باز نگه می‌دارند سردرگم کند)
--purgeresult: پاکسازی فایل نتیجه پیش از اجرا
--find=string: جست‌وجوی الگوی مشخص‌شده در منابع مستندات
--forcexml: اجبار به استفاده از ساختگی (stub) اکس‌ام‌ال (xml)
--forcecld: اجبار به استفاده از ساختگی (stub) cld (سند lua مربوط به context)
--forcelua: اجبار به استفاده از ساختگی (stub) lua (مانند texlua)
--forcemp: اجبار به استفاده از ساختگی (stub) mp
--arrange: اجرای یک دور اضافه برای چینش صفحات (imposition)، با فرض اینکه در شیوه تنظیم شده باشد
--noarrange: نادیده گرفتن تنظیمات چینش صفحات (imposition) در شیوه
--pages: گزارش شماره صفحاتِ صفحه‌های نام‌گذاری‌شده و ارجاعات فهرست (--page=... یا --page=...)
--jit: استفاده از luajittex با JIT خاموش (تنها استفاده از ماشین مجازی سریع‌تر)
--jiton: استفاده از luajittex با JIT روشن (در بیشتر موارد سریع‌تر نبوده و حتی کُندتر است)
--once: تنها یک‌بار اجرا شود (هیچ فایل داده چندگذر تولید نمی‌شود)
--runs: حداکثر به این تعداد دفعات پردازش شود
--forcedruns: اجبار به پردازش به این تعداد دفعات (مناسب برای اجراهای آزمایشی بهینه‌سازی)
--batchmode: اجرا بدون توقف و بدون نمایش پیام‌ها در کنسول
--nonstopmode: اجرا بدون توقف
--nocompactfonts: بازگشت به مقیاس‌بندی سنتی فونت (با کارایی کمتر)
--nosynctex: هرگز synctex را راه‌اندازی اولیه نمی‌کند (برای اجراهای نهایی)
--synctex: اجرا با synctex فعال (بهتر است از tupsynctex[state=start] استفاده شود)
--nodates: حذف تاریخ‌های زمان اجرا از فایل pdf (مقدار اختیاری: یک عدد (فاصله از مبدأ ۱۹۷۰) یا رشته "YYYY-MM-DD HH:MM")
--nocompression: غیرفعال کردن اجباری فشرده‌سازی در بخش پشتی (backend)
--trailerid: شناسه انتهایی (trailer id) جایگزین (یا یک شناسه ثابت)
--generate: تولید پایگاه داده فایل‌ها و غیره (همانند آنچه luatools انجام می‌دهد)
--paranoid: عدم ورود به پوشه‌های .. و ../..
--version: گزارش نسخه نصب‌شده context
--integrity: گزارش عدم تطابق میان فایل دودویی (binary) و انتظارات
--global: فرض بر اینکه فایل داده‌شده در جای دیگری وجود دارد
--nofile: استفاده از فایل صوری به عنوان jobname
--forceinput: استفاده از این فایل به عنوان فایل ورودی به جای فایل مشخص‌شده
--expert: نمایش گزینه‌های بیشتر

گزینه‌های پیشرفته (OPTIONS: EXPERT)

--touch: به‌روزرسانی شماره نسخه context (باید --expert و اختیاری --basepath نیز مشخص شود)
--nostatistics: عدم درج آمارهای زمان اجرا در پایان پردازش
--profile: پروفایل‌بندی کار (استفاده: mtxrun --script profile --analyze)
--timing: تولید نمای کلی از زمان‌بندی و آمارها
--keeptuc: نگه‌داشتن فایل‌های قبلی tuc (jobname-tuc-[run].tmp)
--keeppdf: نگه‌داشتن فایل‌های قبلی pdf (jobname-pdf-keep.tmp)
--keeplog: نگه‌داشتن فایل‌های قبلی log (jobname-log-[run].tmp)
--notuc: عدم نوشتن فایل tuc
--lmtx: اجبار به حالت lmtx (در صورت در دسترس بودن)
--overloadmode=error|warning|0--6|255: فعال‌سازی بررسی بازنویسی (overload) نام کنترل‌سکوئنس‌ها (csname)
--extra=name: پردازش اسکریپت جانبی (mtx-context-... در توزیع)
--extras: نمایش موارد جانبی (extras)
--ownerpassword: رمزگذاری فایل (pdf) با استفاده از این گذرواژه اصلی (master)
--userpassword: استفاده از یک گذرواژه اضافی برای باز کردن سند
--permissions: فهرستی از: print, modify, extract, add, fillin, assemble, quality
--wtpdf: افزودن داده تطابق wtpdf؛ اما بهتر است ابتدا بررسی شود که آیا کاربرد دارد یا خیر

گزینه‌های ویژه (OPTIONS: SPECIAL)

--luatex: پردازش فایل با luatex به جای luametatex
--pdftex: پردازش فایل با texexec با استفاده از pdftex
--xetex: پردازش فایل با texexec با استفاده از xetex
--mkii: پردازش فایل با texexec
--pipe: عدم بررسی فایل و ورود به حالت پیمایش (scroll mode) (--dummyfile=whatever.tmp)
--parallel: پردازش هم‌زمان چند فایل (می‌توانید تعداد پردازش‌ها را مشخص کنید، پیش‌فرض: ۸)
--parallellist: پردازش دستورها در این فایل (خطوطی که با 'context' شروع می‌شوند)
--sandbox: پردازش فایل در یک محیط محدود و ایزوله (sandbox)
--addbinarypath: افزودن مسیر باینری (یافت‌شده) به ابتدای مسیر اجراکننده‌ها

نویسندگان (AUTHORS)

اطلاعات بیشتر درباره ConTeXt و ابزارهای همراه آن را می‌توان در نشانی‌های زیر یافت:

فهرست پستی: ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context

وب‌گاه: http://www.pragma-ade.nl / http://tex.aanhet.net

ویکی: http://contextgarden.net