.TH PDFTEX 1 "14 February 2026" "Web2C 2026"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.10m'\\v'0.17v'E\\v'-0.17v'\\h'-0.06m'X\fP
.if n .ds TX TeX
.ie t .ds OX \fIT\h'-0.17m'\v'+0.21m'E\v'-0.21m'\h'-0.04m'X\fP
.el .ds OX TeX
.\" LX definition must follow TX so LX can use TX
.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s+2\\h'-0.15m'\\v'0.15v'\fP\*(TX
.if n .ds LX LaTeX
.\"=====================================================================
.SH "نام (NAME)"
pdftex, pdfetex \- خروجی PDF از TeX
.SH "خلاصه دستور (SYNOPSIS)"
.B pdftex
.RI [ options ]
.RI [ \fB&\fPformat ]
\h'.25' [ \fIfile\fP [ \fImore-input\fP ] \h'.5'|\h'.5' [ \fB\e\fP\fImore-input\fP ]
.\"=====================================================================
.SH "توضیحات (DESCRIPTION)"
حروف‌چین pdf\*(TX را روی
.IR file [.tex]
اجرا می‌کند که معمولاً
.IR file.pdf
را ایجاد می‌نماید. اگر آرگومان file فاقد پسوند باشد، ".tex" به آن افزوده خواهد شد. برای جزئیات تجزیه خط فرمان،
.BR tex (1)
را ببینید.
.PP
نرم‌افزار pdf\*(TX از نوادگان \*(TX است که می‌تواند هم فایل‌های pdf را مستقیماً بسازد و هم فایل‌های dvi (که با مقدار پارامتر اولیه‌ی \epdfoutput تعیین می‌شود). این برنامه شامل گسترش‌های
.BR etex (1)
بوده و گسترش‌های فراوان دیگری را نیز از جانب خود می‌افزاید. در حالت dvi، نرم‌افزار pdf\*(TX می‌تواند به عنوان یک جایگزین سازگار رو به جلو برای موتور \*(TX استفاده شود.
.PP
استفاده معمول از pdf\*(TX همراه با فرمت‌های از پیش‌تولید‌شده‌ی \*(TX (فایل‌های \fI.fmt\fP) است که معمولاً خروجی pdf در آن‌ها فعال می‌باشد. برای نمونه، دستور
.B pdftex
از فرمت plain \*(TX استفاده می‌کند، و دستور
.BR pdflatex (1)
از فرمت \*(LX بهره می‌برد. همان‌گونه که در
.BR etex (1)
توضیح داده شده است، گسترش‌های e-\*(TX هنگام ساخت فایل \fI.fmt\fP فعال می‌شوند.
.PP
.B فرمت‌های تصویر پشتیبانی‌شده
.PP
در حالت pdf، ابزار pdf\*(TX می‌تواند فرمت‌های گرافیکی
.IR pdf ،
.IR jpg ،
.IR jbig2
و
.I png
را به‌طور بومی مدیریت و پردازش کند. این برنامه نمی‌تواند فایل‌های گرافیکی PostScript یا Encapsulated PostScript (eps) را وارد کند؛ شما می‌توانید آن‌ها را برای مثال با استفاده از
.BR epstopdf (1)
به pdf تبدیل کنید. فایل‌های PostScript خروجیِ
.BR mpost (1)
که در استفاده از قابلیت‌های PostScript بسیار محدود هستند، می‌توانند مستقیماً با استفاده از ماکروهای \fIsupp-pdf.tex\fP مدیریت شوند، یا توسط
.BR mptopdf (1)
به pdf تبدیل گردند.
.PP
.B گونه‌های برنامه
.PP
از نسخه 1.40 به بعد (حدود سال ۲۰۰۷)، pdf\*(TX گسترش‌های e-\*(TX را در خود ادغام کرد و فایل‌های اجرایی
.B pdfetex
و
.B etex
به پیوندهای نمادین به فایل باینری
.B pdftex
تبدیل شدند. فایل اجرایی
.B etex
به‌طور پیش‌فرض فایل‌های dvi تولید می‌کند؛ \fBpdfetex\fP رفتاری یکسان با \fBpdftex\fP دارد.
.PP
.B هم موتور و هم درایور
.PP
هنگام تولید خروجی pdf، نرم‌افزار pdf\*(TX باید تمام اطلاعات قلم و دستگاه مورد نیاز را در اختیار داشته باشد و بنابراین مانند یک راه‌انداز دستگاه با خروجی dvi عمل می‌کند، مشابه
.BR dvips (1).
به همین دلیل دستورات اولیه‌ی مختلفی برای تعیین اطلاعات دستگاه از جمله ارتفاع، پهنا، وضوح و غیره وجود دارد. همچنین، pdf\*(TX اطلاعات گلیف را برای قلم‌های استفاده‌شده، به عنوان مثال از فایل‌های بیت‌مپ Type\~1 یا PK می‌خواند. ابزار pdf\*(TX از قلم‌های TrueType نیز پشتیبانی می‌کند، اما پیش از استفاده از آن‌ها تعریف یک کدگذاری الزامی است (به مراجع مراجعه کنید). قلم‌های OpenType پشتیبانی نمی‌شوند.
.\"=====================================================================
.SH "گزینه‌ها (OPTIONS)"
برای گزینه‌های متداول خط فرمان \*(TX و نحوه‌ی کارکرد آن‌ها، به
.BR tex (1)
مراجعه کنید. گزینه‌های زیر که مختص pdf\*(TX هستند نیز پشتیبانی می‌شوند:
.\" from Master/tlpkg/bin/tloptdiff.
.TP
.B -draftmode
حالت \epdfdraftmode را فعال می‌کند که در آن pdf\*(TX خروجی pdf نمی‌نویسد و هیچ‌یک از تصاویر واردشده را نمی‌خواند، که این امر سرعت اجرا را بالا می‌برد.
.TP
.B -etex
گسترش‌های e-\*(TX را فعال می‌کند. این گزینه تنها در ترکیب با
.BR -ini
مؤثر است. این قابلیت معمولاً به‌صورت ضمنی، با قرار دادن یک "*" در ابتدای نام فایل مقداردهی اولیه‌ی فرمت فعال می‌شود، همان‌طور که در
.BR etex (1)
توصیف شده است.
.TP
.BI -output-format \ format
حالت فرمت خروجی را تنظیم می‌کند؛
.I format
باید ``pdf'' یا ``dvi'' باشد.
.TP
.BI -synctex \ number
داده‌های Sync\*(TX را بر اساس بیت‌های \fInumber\fP برای پیش‌نمایش‌گرها تولید می‌کند.
.BR synctex (1)
را ببینید.
.\"=====================================================================
.SH "محیط (ENVIRONMENT)"
.BR tex (1)
را ببینید.
همچنین این متغیر محیطی مختص pdf\*(TX است:
.TP
.B TEXMF_DEBUG_PNG_COPY
اگر روی "1" تنظیم شود، pdf\*(TX ویژگی‌های گوناگون هر تصویر png را، از جمله کپی شدن مستقیم آن، گزارش می‌دهد. این ویژگی زمانی مفید است که یک سند از تصاویر png فراوانی استفاده می‌کند، زیرا بازکدگذاری (به‌جای کپی کردن مستقیم) می‌تواند زمان قابل توجهی ببرد. برای اطلاعات بیشتر، فصل Graphics را در راهنمای pdf\*(TX ببینید.
.PP
همچنین، این متغیرهای محیطی برای تمام موتورها به جز \*(TX اصلی در نظر گرفته می‌شوند:
.TP
.B SOURCE_DATE_EPOCH
اگر تنظیم شود، مقدار آن بر حسب ثانیه‌های مبدأ تاریخ (epoch-seconds) برای برچسب‌های زمانی در خروجی PDF، نظیر کلیدهای CreationDate و ModDate استفاده خواهد شد. این متغیر برای ایجاد ساخت‌های بازتولیدپذیر کاربرد دارد.
.TP
.B FORCE_SOURCE_DATE
اگر روی مقدار "1" تنظیم شود، دستورات اولیه‌ی مربوط به زمان در \*(TX
.RI ( \eyear ،
.IR \emonth ،
.IR \eday ،
.IR \etime )
نیز از مقدار SOURCE_DATE_EPOCH مقداردهی اولیه می‌شوند. در صورت وجود هرگونه راهکار دیگر، استفاده از این روش توصیه نمی‌شود.
.br
ابزار pdf\*(TX همچنین چندین دستور اولیه برای پشتیبانی از ساخت‌های بازتولیدپذیر دارد؛ به راهنما مراجعه کنید.
.\"=====================================================================
.SH "فایل‌ها (FILES)"
.BR tex (1)
را ببینید.
همچنین:
.TP
.I $TEXMFMAIN/tex/plain/config/etex.ini
فایل راه‌اندازی که فایل‌های فرمت plain را برای pdf\*(TX، یعنی \fIpdftex.fmt\fP و \fIpdfetex.fmt\fP در \*(TX Live می‌سازد.
.TP
.I $TEXMFMAIN/tex/plain/config/pdftexmagfix.tex
باعث می‌شود \emagnification طبق انتظار در pdf\*(TX کار کند. در فایل‌های فرمت گنجانده شده است.
.TP
.I $TEXMFMAIN/tex/generic/tex-ini-files/pdftexconfig.tex
تنظیمات مشترک pdf را تعریف می‌کند، مانند نسخه‌ی پیش‌فرض pdf، ارتفاع و پهنای pdf و غیره.
.TP
.I $TEXMF[SYS]CONFIG/tex/generic/tex-ini-files/pdftexconfig.tex
نسخه‌ی وابسته به نصب فایل بالا (در \*(TX Live)، زیرا اندازه‌ی پیش‌فرض کاغذ توسط نصب تعیین می‌شود.
.TP
.I $TEXMF[SYS]VAR/fonts/map/pdftex/updmap/pdftex.map
نگاشت فایل‌های tfm به قلم‌های Type\~1؛ معمولاً به‌صورت خودکار در \*(TX Live نگهداری می‌شود.
.\"=====================================================================
.SH "گزارش باگ‌ها (BUGS)"
.BR tex (1)
را ببینید.
.\"=====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.BR epstopdf (1),
.BR etex (1),
.BR luatex (1),
.BR mptopdf (1),
.BR tex (1).
.PP
Micro-typographic extensions to the \*(TX typesetting system، نوشته‌ی
H\[`a]n The Th\[`a]nh
(پایان‌نامه‌ای در شرح ویژگی‌های عمده و جدید حروف‌چینی در pdf\*(TX):
https://tug.org/TUGboat/tb21-4
.br
A closer look at TrueType fonts and pdf\*(TX، نوشته‌ی
H\[`a]n The Th\[`a]nh (درباره‌ی استفاده از قلم‌های TrueType با \*(TX):
https://tug.org/TUGboat/tb30-1/tb94thanh.pdf
.br
صفحه خانگی pdf\*(TX: https://www.pdftex.org
.br
صفحه بسته در CTAN: https://ctan.org/pkg/pdftex
.br
راهنمای pdf\*(TX: https://mirror.ctan.org/systems/doc/pdftex/manual/pdftex-a.pdf
.br
راهنمای Web2c: https://tug.org/web2c
.br
راهنمای Kpathsea: https://tug.org/kpathsea
.br
سورس‌های برنامه‌های نویسه‌وار دنیای \*(TX به صورت pdf:
https://ctan.org/pkg/knuth-pdf
.\"=====================================================================
.SH "نویسندگان (AUTHORS)"
سامانه \*(TX توسط Donald E. Knuth خلق شد. نویسنده‌ی اصلی بهبودهای pdf\*(TX، هان ته تان (H\[`a]n The Th\[`a]nh) است، با مشارکت‌های عمده از Petr Sojka، Jiri Zlatuska و Peter Breitenlohner (e-\*(TX).
.\" the double accent 0x1EBF in Thanh's name is not easily available.
.PP
فهرست گفتگوی عمومی برای مسائل خاص pdf\*(TX:
https://lists.tug.org/pdftex
.br
فهرست گفتگوی عمومی برای \*(TX Live:
https://lists.tug.org/tex-live
.br
فهرست گفتگوی عمومی برای تمام موارد \*(TX (و \*(LX):
https://lists.tug.org/texhax