PDFTEX(1) General Commands Manual PDFTEX(1)

pdftex, pdfetex - خروجی PDF از TeX

pdftex [options] [&format] [ file [ more-input ] | [ \more-input ]

حروف‌چین pdfTeX را روی file[.tex] اجرا می‌کند که معمولاً file.pdf را ایجاد می‌نماید. اگر آرگومان file فاقد پسوند باشد، ".tex" به آن افزوده خواهد شد. برای جزئیات تجزیه خط فرمان، tex(1) را ببینید.

نرم‌افزار pdfTeX از نوادگان TeX است که می‌تواند هم فایل‌های pdf را مستقیماً بسازد و هم فایل‌های dvi (که با مقدار پارامتر اولیه‌ی \pdfoutput تعیین می‌شود). این برنامه شامل گسترش‌های etex(1) بوده و گسترش‌های فراوان دیگری را نیز از جانب خود می‌افزاید. در حالت dvi، نرم‌افزار pdfTeX می‌تواند به عنوان یک جایگزین سازگار رو به جلو برای موتور TeX استفاده شود.

استفاده معمول از pdfTeX همراه با فرمت‌های از پیش‌تولید‌شده‌ی TeX (فایل‌های .fmt) است که معمولاً خروجی pdf در آن‌ها فعال می‌باشد. برای نمونه، دستور pdftex از فرمت plain TeX استفاده می‌کند، و دستور pdflatex(1) از فرمت LaTeX بهره می‌برد. همان‌گونه که در etex(1) توضیح داده شده است، گسترش‌های e-TeX هنگام ساخت فایل .fmt فعال می‌شوند.

فرمت‌های تصویر پشتیبانی‌شده

در حالت pdf، ابزار pdfTeX می‌تواند فرمت‌های گرافیکی pdf، jpg، jbig2 و png را به‌طور بومی مدیریت و پردازش کند. این برنامه نمی‌تواند فایل‌های گرافیکی PostScript یا Encapsulated PostScript (eps) را وارد کند؛ شما می‌توانید آن‌ها را برای مثال با استفاده از epstopdf(1) به pdf تبدیل کنید. فایل‌های PostScript خروجیِ mpost(1) که در استفاده از قابلیت‌های PostScript بسیار محدود هستند، می‌توانند مستقیماً با استفاده از ماکروهای supp-pdf.tex مدیریت شوند، یا توسط mptopdf(1) به pdf تبدیل گردند.

گونه‌های برنامه

از نسخه 1.40 به بعد (حدود سال ۲۰۰۷)، pdfTeX گسترش‌های e-TeX را در خود ادغام کرد و فایل‌های اجرایی pdfetex و etex به پیوندهای نمادین به فایل باینری pdftex تبدیل شدند. فایل اجرایی etex به‌طور پیش‌فرض فایل‌های dvi تولید می‌کند؛ pdfetex رفتاری یکسان با pdftex دارد.

هم موتور و هم درایور

هنگام تولید خروجی pdf، نرم‌افزار pdfTeX باید تمام اطلاعات قلم و دستگاه مورد نیاز را در اختیار داشته باشد و بنابراین مانند یک راه‌انداز دستگاه با خروجی dvi عمل می‌کند، مشابه dvips(1). به همین دلیل دستورات اولیه‌ی مختلفی برای تعیین اطلاعات دستگاه از جمله ارتفاع، پهنا، وضوح و غیره وجود دارد. همچنین، pdfTeX اطلاعات گلیف را برای قلم‌های استفاده‌شده، به عنوان مثال از فایل‌های بیت‌مپ Type 1 یا PK می‌خواند. ابزار pdfTeX از قلم‌های TrueType نیز پشتیبانی می‌کند، اما پیش از استفاده از آن‌ها تعریف یک کدگذاری الزامی است (به مراجع مراجعه کنید). قلم‌های OpenType پشتیبانی نمی‌شوند.

برای گزینه‌های متداول خط فرمان TeX و نحوه‌ی کارکرد آن‌ها، به tex(1) مراجعه کنید. گزینه‌های زیر که مختص pdfTeX هستند نیز پشتیبانی می‌شوند:

حالت \pdfdraftmode را فعال می‌کند که در آن pdfTeX خروجی pdf نمی‌نویسد و هیچ‌یک از تصاویر واردشده را نمی‌خواند، که این امر سرعت اجرا را بالا می‌برد.
گسترش‌های e-TeX را فعال می‌کند. این گزینه تنها در ترکیب با -ini مؤثر است. این قابلیت معمولاً به‌صورت ضمنی، با قرار دادن یک "*" در ابتدای نام فایل مقداردهی اولیه‌ی فرمت فعال می‌شود، همان‌طور که در etex(1) توصیف شده است.
حالت فرمت خروجی را تنظیم می‌کند؛ format باید ``pdf'' یا ``dvi'' باشد.
داده‌های SyncTeX را بر اساس بیت‌های number برای پیش‌نمایش‌گرها تولید می‌کند. synctex(1) را ببینید.

tex(1) را ببینید. همچنین این متغیر محیطی مختص pdfTeX است:

اگر روی "1" تنظیم شود، pdfTeX ویژگی‌های گوناگون هر تصویر png را، از جمله کپی شدن مستقیم آن، گزارش می‌دهد. این ویژگی زمانی مفید است که یک سند از تصاویر png فراوانی استفاده می‌کند، زیرا بازکدگذاری (به‌جای کپی کردن مستقیم) می‌تواند زمان قابل توجهی ببرد. برای اطلاعات بیشتر، فصل Graphics را در راهنمای pdfTeX ببینید.

همچنین، این متغیرهای محیطی برای تمام موتورها به جز TeX اصلی در نظر گرفته می‌شوند:

اگر تنظیم شود، مقدار آن بر حسب ثانیه‌های مبدأ تاریخ (epoch-seconds) برای برچسب‌های زمانی در خروجی PDF، نظیر کلیدهای CreationDate و ModDate استفاده خواهد شد. این متغیر برای ایجاد ساخت‌های بازتولیدپذیر کاربرد دارد.
اگر روی مقدار "1" تنظیم شود، دستورات اولیه‌ی مربوط به زمان در TeX (\year، \month، \day، \time) نیز از مقدار SOURCE_DATE_EPOCH مقداردهی اولیه می‌شوند. در صورت وجود هرگونه راهکار دیگر، استفاده از این روش توصیه نمی‌شود.
ابزار pdfTeX همچنین چندین دستور اولیه برای پشتیبانی از ساخت‌های بازتولیدپذیر دارد؛ به راهنما مراجعه کنید.

tex(1) را ببینید. همچنین:

$TEXMFMAIN/tex/plain/config/etex.ini
فایل راه‌اندازی که فایل‌های فرمت plain را برای pdfTeX، یعنی pdftex.fmt و pdfetex.fmt در TeX Live می‌سازد.
$TEXMFMAIN/tex/plain/config/pdftexmagfix.tex
باعث می‌شود \magnification طبق انتظار در pdfTeX کار کند. در فایل‌های فرمت گنجانده شده است.
$TEXMFMAIN/tex/generic/tex-ini-files/pdftexconfig.tex
تنظیمات مشترک pdf را تعریف می‌کند، مانند نسخه‌ی پیش‌فرض pdf، ارتفاع و پهنای pdf و غیره.
$TEXMF[SYS]CONFIG/tex/generic/tex-ini-files/pdftexconfig.tex
نسخه‌ی وابسته به نصب فایل بالا (در TeX Live)، زیرا اندازه‌ی پیش‌فرض کاغذ توسط نصب تعیین می‌شود.
$TEXMF[SYS]VAR/fonts/map/pdftex/updmap/pdftex.map
نگاشت فایل‌های tfm به قلم‌های Type 1؛ معمولاً به‌صورت خودکار در TeX Live نگهداری می‌شود.

tex(1) را ببینید.

epstopdf(1), etex(1), luatex(1), mptopdf(1), tex(1).

Micro-typographic extensions to the TeX typesetting system، نوشته‌ی Hàn The Thành (پایان‌نامه‌ای در شرح ویژگی‌های عمده و جدید حروف‌چینی در pdfTeX): https://tug.org/TUGboat/tb21-4
A closer look at TrueType fonts and pdfTeX، نوشته‌ی Hàn The Thành (درباره‌ی استفاده از قلم‌های TrueType با TeX): https://tug.org/TUGboat/tb30-1/tb94thanh.pdf
صفحه خانگی pdfTeX: https://www.pdftex.org
صفحه بسته در CTAN: https://ctan.org/pkg/pdftex
راهنمای pdfTeX: https://mirror.ctan.org/systems/doc/pdftex/manual/pdftex-a.pdf
راهنمای Web2c: https://tug.org/web2c
راهنمای Kpathsea: https://tug.org/kpathsea
سورس‌های برنامه‌های نویسه‌وار دنیای TeX به صورت pdf: https://ctan.org/pkg/knuth-pdf

سامانه TeX توسط Donald E. Knuth خلق شد. نویسنده‌ی اصلی بهبودهای pdfTeX، هان ته تان (Hàn The Thành) است، با مشارکت‌های عمده از Petr Sojka، Jiri Zlatuska و Peter Breitenlohner (e-TeX).

فهرست گفتگوی عمومی برای مسائل خاص pdfTeX: https://lists.tug.org/pdftex
فهرست گفتگوی عمومی برای TeX Live: https://lists.tug.org/tex-live
فهرست گفتگوی عمومی برای تمام موارد TeX (و LaTeX): https://lists.tug.org/texhax

14 February 2026 Web2C 2026