.TH PDFJADETEX 1 "12 July 1998" "Marcus Brinkmann"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
.if n .ds MF Metafont
.if t .ds MF M\s-2ETAFONT\s0
.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP\" for troff
.el .ds OX TeX\" for nroff
.\" the same but obliqued
.\" BX definition must follow TX so BX can use TX
.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
.if n .ds BX BibTeX
.\" LX definition must follow TX so LX can use TX
.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
.if n .ds LX LaTeX
.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX
.if n .ds AX AmSTeX
.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX
.if n .ds AY AmSLaTeX
.\"=====================================================================
.SH "نام (NAME)"
pdfjadetex \- تولید خروجی PDF از JadeTeX
.SH "خلاصه دستور (SYNOPSIS)"
.B pdfjadetex
.RI [ options ]
.RI [ commands ]
.\"=====================================================================
.SH "توضیحات (DESCRIPTION)"
این صفحه راهنما از صفحه راهنمای pdf\*(TX برگرفته شده است و هدف آن جامع و کامل
بودن نیست. مستندات کامل برای این نسخه از \*(TX را می‌توان در فایل info یا دفترچه راهنمای
.IR "Web2C: A TeX implementation"
یافت.
.PP
دستور pdfjade\*(TX نسخه‌ای از \*(TX است که علاوه بر فایل‌های
.IR DVI ،
می‌تواند فایل‌های
.I PDF
را نیز ایجاد کند.
.PP
کاربرد معمول pdfjade\*(TX همراه با فرمت‌های از پیش تولیدشده‌ای است که خروجی PDF
در آن‌ها فعال شده است. دستور
.B pdfjadetex
از معادل فرمت ساده Jade\*(TX استفاده می‌کند.
.PP
مدیریت آرگومان‌های خط فرمان در pdfjade\*(TX مشابه با
\*(LX
است.
.\"=====================================================================
.SH "گزینه‌ها (OPTIONS)"
این نسخه از pdfjade\*(TX گزینه‌های خط فرمان زیر را می‌پذیرد.
.TP
.BI --fmt \ format
.rb
استفاده از
.I format
به عنوان نام فرمت مورد استفاده، به جای نامی که pdfjade\*(TX با آن فراخوانی شده است یا یک خط
.IR %& .
.TP
.B --help
.rb
نمایش پیام راهنما و خروج.
.TP
.B --ini
.rb
عمل کردن در حالت
.BR pdfinitex
برای استخراج و ذخیره (dump) فرمت‌ها؛ اگر برنامه با نام
.B pdfinitex
فراخوانی شود، این گزینه به صورت ضمنی برقرار است.
.TP
.BI --interaction \ mode
.rb
تنظیم حالت تعاملی. این حالت می‌تواند یکی از موارد
.IR batchmode ،
.IR nonstopmode ،
.IR scrollmode
و
.I errorstopmode
باشد. معنای این حالت‌ها مشابه دستورات (\ecommands) متناظر است.
.TP
.B --ipc
.rb
ارسال خروجی DVI یا PDF به یک سوکت علاوه بر فایل خروجی معمول. در دسترس بودن این گزینه به انتخاب نصاب برنامه بستگی دارد.
.TP
.B --ipc-start
.rb
مانند
.BR --ipc ،
به همراه راه‌اندازی سرور در طرف مقابل. در دسترس بودن این گزینه به انتخاب نصاب برنامه بستگی دارد.
.TP
.BI --kpathsea-debug \ bitmask
.rb
تنظیم فلگ‌های اشکال‌زدایی جستجوی مسیر با توجه به ماسک بیتی (bitmask). برای جزئیات به راهنمای
.I Kpathsea
مراجعه کنید.
.TP
.BI --maketex \ fmt
.rb
فعال‌سازی
.RI mktex fmt ،
که در آن
.I fmt
باید یکی از موارد
.I tex
یا
.I tfm
باشد.
.TP
.BI --no-maketex \ fmt
.rb
غیرفعال‌سازی
.RI mktex fmt ،
که در آن
.I fmt
باید یکی از موارد
.I tex
یا
.I tfm
باشد.
.TP
.BI --output-comment \ string
.rb
استفاده از
.I string
برای توضیحات درون فایل DVI به جای تاریخ.
.TP
.BI --progname \ name
.rb
تغییر نام ظاهری برنامه به
.IR name .
این گزینه هم بر فرمت مورد استفاده و هم بر مسیرهای جستجو تأثیر می‌گذارد.
.TP
.B --shell-escape
.rb
فعال‌سازی ساختار
.BI \ewrite18{ command }
است. دستور
.I command
می‌تواند هر دستور پوسته Bourne باشد. این ساختار معمولاً به دلایل امنیتی غیرمجاز است.
.TP
.B --version
.rb
نمایش اطلاعات نسخه و خروج.
.\"=====================================================================
.SH "محیط (ENVIRONMENT)"
برای جزئیات دقیق درباره نحوه استفاده از متغیرهای محیطی، به مستندات کتابخانه Kpathsea (گره «Path specifications») مراجعه کنید.
از ابزار
.B kpsewhich
می‌توان برای پرس‌وجوی مقادیر این متغیرها استفاده کرد.
.PP
یک نکته مهم: در بیشتر فرمت‌های pdfjade\*(TX نمی‌توانید از علامت ~ در نام فایلی که مستقیماً به pdfjade\*(TX می‌دهید استفاده کنید، زیرا ~ یک نویسه فعال است و بنابراین بسط داده می‌شود و به عنوان بخشی از نام فایل در نظر گرفته نمی‌شود. برنامه‌های دیگر، مانند
\*(MF،
این مشکل را ندارند.
.PP
.TP
TEXMFOUTPUT
به طور معمول، pdfjade\*(TX فایل‌های خروجی خود را در دایرکتوری جاری قرار می‌دهد. اگر باز کردن هر فایل خروجی در آنجا ممکن نباشد، تلاش می‌کند آن را در دایرکتوری مشخص‌شده در متغیر محیطی TEXMFOUTPUT باز کند.
هیچ مقدار پیش‌فرضی برای این متغیر وجود ندارد. برای مثال، اگر دستور
.I tex paper
را اجرا کنید و دایرکتوری جاری قابل نوشتن نباشد، چنانچه TEXMFOUTPUT دارای مقدار
.I /tmp
باشد، آنگاه pdfjade\*(TX تلاش می‌کند فایل
.I /tmp/paper.log
(و در صورت تولید خروجی،
.IR /tmp/paper.pdf )
را ایجاد کند.
.TP
TEXINPUTS
مسیر جستجو برای فایل‌های
.I \einput
و
.IR \eopenin .
این مسیر معمولاً باید با «.» شروع شود تا فایل‌های کاربر پیش از فایل‌های سیستمی پیدا شوند.
.TP
TEXFONTS
مسیر جستجو برای فایل‌های متریک قلم
.RI ( .tfm ) .
.TP
TEXFORMATS
مسیر جستجو برای فایل‌های فرمت.
.TP
TEXPOOL
مسیر جستجو برای رشته‌های داخلی
.BR pdfinitex .
.TP
TEXEDIT
الگوی دستوری برای تغییر به ویرایشگر متن. مقدار پیش‌فرض که معمولاً
.B vi
است، هنگام کامپایل pdfjade\*(TX تنظیم می‌شود.
.\"=====================================================================
.SH "فایل‌ها (FILES)"
محل فایل‌های ذکرشده در زیر از سیستمی به سیستم دیگر متفاوت است. از ابزار
.B kpsewhich
برای یافتن مکان آن‌ها استفاده کنید.
.TP
.I pdfjadetex.pool
متن کدگذاری‌شده پیام‌های pdfjade\*(TX.
.TP
.I texfonts.map
تعاریف نگاشت نام فایل‌ها.
.TP
.I *.tfm
فایل‌های متریک برای قلم‌های pdfjade\*(TX.
.TP
.I *.fmt
فایل‌های فرمت از پیش پردازش‌شده (.\|fmt) متعلق به pdfjade\*(TX.
.br
.\"=====================================================================
.SH "اشکالات (BUGS)"
این نسخه از pdfjade\*(TX در به دام انداختن سرریز محاسباتی هنگام جمع یا تفریق ابعاد ناتوان است. مواردی که این وضعیت رخ می‌دهد نادر هستند، اما در صورت وقوع، فایل
.I DVI
تولیدشده نامعتبر خواهد بود.
.\"=====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.BR jadetex (1),
.BR tex (1),
.BR mf (1),
.BR undump (1).
.\"=====================================================================
.SH "نویسندگان (AUTHORS)"
نویسنده pdfjade\*(TX سباستین رایتز (Sebastian Rahtz) است.
.PP
این صفحه راهنما توسط مارکوس برینکمن (Marcus Brinkmann) برای توزیع دبیان از روی صفحه راهنمای pdf\*(TX در توزیع te\*(TX اثر توماس اسر (Thomas Esser) برگرفته شده است.