نام (NAME)

pdfjadetex - تولید خروجی PDF از JadeTeX

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

pdfjadetex [options] [commands]

توضیحات (DESCRIPTION)

این صفحه راهنما از صفحه راهنمای pdfTeX برگرفته شده است و هدف آن جامع و کامل بودن نیست. مستندات کامل برای این نسخه از TeX را می‌توان در فایل info یا دفترچه راهنمای Web2C: A TeX implementation یافت.

دستور pdfjadeTeX نسخه‌ای از TeX است که علاوه بر فایل‌های DVI، می‌تواند فایل‌های PDF را نیز ایجاد کند.

کاربرد معمول pdfjadeTeX همراه با فرمت‌های از پیش تولیدشده‌ای است که خروجی PDF در آن‌ها فعال شده است. دستور pdfjadetex از معادل فرمت ساده JadeTeX استفاده می‌کند.

مدیریت آرگومان‌های خط فرمان در pdfjadeTeX مشابه با LaTeX است.

گزینه‌ها (OPTIONS)

این نسخه از pdfjadeTeX گزینه‌های خط فرمان زیر را می‌پذیرد.

--fmt format: استفاده از format به عنوان نام فرمت مورد استفاده، به جای نامی که pdfjadeTeX با آن فراخوانی شده است یا یک خط %&.
--help: نمایش پیام راهنما و خروج.
--ini: عمل کردن در حالت pdfinitex برای استخراج و ذخیره (dump) فرمت‌ها؛ اگر برنامه با نام pdfinitex فراخوانی شود، این گزینه به صورت ضمنی برقرار است.
--interaction mode: تنظیم حالت تعاملی. این حالت می‌تواند یکی از موارد batchmode، nonstopmode، scrollmode و errorstopmode باشد. معنای این حالت‌ها مشابه دستورات (\commands) متناظر است.
--ipc: ارسال خروجی DVI یا PDF به یک سوکت علاوه بر فایل خروجی معمول. در دسترس بودن این گزینه به انتخاب نصاب برنامه بستگی دارد.
--ipc-start: مانند --ipc، به همراه راه‌اندازی سرور در طرف مقابل. در دسترس بودن این گزینه به انتخاب نصاب برنامه بستگی دارد.
--kpathsea-debug bitmask: تنظیم فلگ‌های اشکال‌زدایی جستجوی مسیر با توجه به ماسک بیتی (bitmask). برای جزئیات به راهنمای Kpathsea مراجعه کنید.
--maketex fmt: فعال‌سازی mktexfmt، که در آن fmt باید یکی از موارد tex یا tfm باشد.
--no-maketex fmt: غیرفعال‌سازی mktexfmt، که در آن fmt باید یکی از موارد tex یا tfm باشد.
--output-comment string: استفاده از string برای توضیحات درون فایل DVI به جای تاریخ.
--progname name: تغییر نام ظاهری برنامه به name. این گزینه هم بر فرمت مورد استفاده و هم بر مسیرهای جستجو تأثیر می‌گذارد.
--shell-escape: فعال‌سازی ساختار \write18{command} است. دستور command می‌تواند هر دستور پوسته Bourne باشد. این ساختار معمولاً به دلایل امنیتی غیرمجاز است.
--version: نمایش اطلاعات نسخه و خروج.

محیط (ENVIRONMENT)

برای جزئیات دقیق درباره نحوه استفاده از متغیرهای محیطی، به مستندات کتابخانه Kpathsea (گره «Path specifications») مراجعه کنید. از ابزار kpsewhich می‌توان برای پرس‌وجوی مقادیر این متغیرها استفاده کرد.

یک نکته مهم: در بیشتر فرمت‌های pdfjadeTeX نمی‌توانید از علامت ~ در نام فایلی که مستقیماً به pdfjadeTeX می‌دهید استفاده کنید، زیرا ~ یک نویسه فعال است و بنابراین بسط داده می‌شود و به عنوان بخشی از نام فایل در نظر گرفته نمی‌شود. برنامه‌های دیگر، مانند Metafont، این مشکل را ندارند.

TEXMFOUTPUT: به طور معمول، pdfjadeTeX فایل‌های خروجی خود را در دایرکتوری جاری قرار می‌دهد. اگر باز کردن هر فایل خروجی در آنجا ممکن نباشد، تلاش می‌کند آن را در دایرکتوری مشخص‌شده در متغیر محیطی TEXMFOUTPUT باز کند. هیچ مقدار پیش‌فرضی برای این متغیر وجود ندارد. برای مثال، اگر دستور tex paper را اجرا کنید و دایرکتوری جاری قابل نوشتن نباشد، چنانچه TEXMFOUTPUT دارای مقدار /tmp باشد، آنگاه pdfjadeTeX تلاش می‌کند فایل /tmp/paper.log (و در صورت تولید خروجی، /tmp/paper.pdf) را ایجاد کند.
TEXINPUTS: مسیر جستجو برای فایل‌های \input و \openin. این مسیر معمولاً باید با «.» شروع شود تا فایل‌های کاربر پیش از فایل‌های سیستمی پیدا شوند.
TEXFONTS: مسیر جستجو برای فایل‌های متریک قلم (.tfm).
TEXFORMATS: مسیر جستجو برای فایل‌های فرمت.
TEXPOOL: مسیر جستجو برای رشته‌های داخلی pdfinitex.
TEXEDIT: الگوی دستوری برای تغییر به ویرایشگر متن. مقدار پیش‌فرض که معمولاً vi است، هنگام کامپایل pdfjadeTeX تنظیم می‌شود.

فایل‌ها (FILES)

محل فایل‌های ذکرشده در زیر از سیستمی به سیستم دیگر متفاوت است. از ابزار kpsewhich برای یافتن مکان آن‌ها استفاده کنید.

pdfjadetex.pool: متن کدگذاری‌شده پیام‌های pdfjadeTeX.
texfonts.map: تعاریف نگاشت نام فایل‌ها.
*.tfm: فایل‌های متریک برای قلم‌های pdfjadeTeX.
*.fmt: فایل‌های فرمت از پیش پردازش‌شده (.fmt) متعلق به pdfjadeTeX.

اشکالات (BUGS)

این نسخه از pdfjadeTeX در به دام انداختن سرریز محاسباتی هنگام جمع یا تفریق ابعاد ناتوان است. مواردی که این وضعیت رخ می‌دهد نادر هستند، اما در صورت وقوع، فایل DVI تولیدشده نامعتبر خواهد بود.

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

jadetex(1), tex(1), mf(1), undump(1).

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

نویسنده pdfjadeTeX سباستین رایتز (Sebastian Rahtz) است.

این صفحه راهنما توسط مارکوس برینکمن (Marcus Brinkmann) برای توزیع دبیان از روی صفحه راهنمای pdfTeX در توزیع teTeX اثر توماس اسر (Thomas Esser) برگرفته شده است.