DVIPDFMX(1) General Commands Manual DVIPDFMX(1)

dvipdfmx, xdvipdfmx, dvipdfm - تولید مستقیم فایل‌های PDF از فایل‌های DVI

dvipdfmx یا dvipdfm [options] file[.dvi]

برنامهٔ dvipdfmx یک فایل PDF را از یک فایل DVI تولید می‌کند. فایل‌های DVI خروجی‌های تولید‌شده توسط TeX هستند. groff نیز می‌تواند با استفاده از grodvi(-Tdvi) فایل‌های DVI تولید کند.

در TeX Live، dvipdfm به جای اینکه یک برنامهٔ مستقل باشد، جلوهٔ دیگری از dvipdfmx است. تلاش شده است تا سازگاری به بهترین نحو ممکن حفظ شود.

xdvipdfmx جلوهٔ دیگری از این برنامه است. این ابزار به‌عنوان پسانه (back end) برای xetex(1) به‌کار می‌رود و برای فراخوانی مستقیم در نظر گرفته نشده است.

dvipdfmx چندین دستور پرکاربرد \special را که افزونه‌هایی برای قالب DVI هستند، شناسایی می‌کند. به‌طور خاص، این ابزار دستورهای ویژهٔ رنگ (color specials)، اندازهٔ کاغذ (papersize specials)، دستورهای tpic (که امکان استفاده از آن را با pic فراهم می‌کند)، دستورهای hypertex و برخی از دستورهای ویژهٔ PostScript را درک می‌کند. این افزونه‌ها امکان گنجاندن رنگ، اشکال و پیوندها را در اسناد فراهم می‌کنند. این برنامه تا حد امکان تلاش می‌کند رفتار dvips را شبیه‌سازی کند تا بسیاری از بسته‌های ماکرو که برای استفاده با dvips تولید شده‌اند، با dvipdfmx نیز کار کنند. علاوه بر این، dvipdfmx دستورهای \special اختصاصی خود را درک می‌کند تا امکان دسترسی به ویژگی‌های PDF مانند یادداشت‌ها (annotations) و نشانک‌ها (bookmarks) فراهم شود.

از دسامبر ۲۰۱۸، یکی از این دستورهای ویژهٔ اختصاصی برای dvipdfmx دستور pdf:trailerid است که /ID را در تریلر (trailer) سند PDF مشخص می‌کند. نحوهٔ استفاده از آن (در سطح TeX) بدین‌صورت است:
\special{pdf:trailerid [ (0123456789abcdef) (01234567890abcdef) ]}
بدین معنا که این دستور ویژه، یک آرایه (کروشه‌ها) شامل دو رشتهٔ ۱۶ بایتی PDF (پرانتزها) دریافت می‌کند. این همان ساختار نحویِ \pdfvariable trailerid در LuaTeX است، در حالی که با \pdftrailerid در pdfTeX تفاوت دارد. این دستور حتماً باید در نخستین صفحهٔ خروجی بیاید، در غیر این صورت نادیده گرفته خواهد شد.

دستورهای ویژهٔ ناشناخته پیام‌های هشدار تولید خواهند کرد. بسته‌هایی که ممکن است به گزینهٔ راه‌انداز dvipdfm یا dvipdfmx نیاز داشته باشند شامل geometry، hyperref، bookmark، graphicx و xcolor هستند.

برای مسائل مربوط به کادرهای مرزی (bounding boxes) (و در نتیجه اندازهٔ تصاویر)، به extractbb(1) مراجعه کنید..SH "گزینه‌ها (OPTIONS)" برخلاف بسیاری از برنامه‌های دیگر، مقادیر آرگومان‌ها باید با یک فاصله از نام گزینه‌ها جدا شوند، نه با علامت =؛ نام گزینه‌ها نمی‌توانند کوتاه شوند؛ و - و -- نمی‌توانند به‌جای یکدیگر استفاده شوند.

نادیده گرفتن (یا پذیرش) رنگ در \specials. به‌طور پیش‌فرض، \specialها رنگی به‌صورت عادی تفسیر می‌شوند (قابل تغییر در فایل پیکربندی). گزینهٔ -c می‌تواند برای تولید یک سند سیاه‌وسفید از سندی حاوی دستورهای رنگی TeX \special استفاده شود.
فعال‌سازی حالت شبیه‌سازی dvipdfm. اگر نام فایل اجرایی `dvipdfm` باشد، این حالت پیش‌فرض است.
تعیین تعداد ارقام اعشار در خروجی PDF؛ باید بین 0 و 5 باشد، پیش‌فرض 2 است.
نادیده گرفته می‌شود، برای (نیمه‌)سازگاری با dvipdfm.
خواندن فایل نگاشت فونت مشخص‌شده توسط map_file. فایل نگاشت پیش‌فرض در TeX Live، pdftex.map است، همان‌طور که در فایل پیکربندی تعریف شده است.
نمایش یک پیام راهنما و خروج موفقیت‌آمیز.
خواندن cfgfile به‌عنوان یک فایل الحاقی (include) دیگر، پس از خواندن فایل پیش‌فرض dvipdfmx.cfg.
واداشتن Kpathsea به چاپ اطلاعات اشکال‌زدایی؛ `-1` برای همه‌چیز (بسیار حجیم).
انتخاب حالت افقی (landscape). به‌بیان دیگر، جابه‌جا کردن ابعاد x و y کاغذ.
بزرگ‌نمایی سند ورودی به اندازهٔ mag.
تنظیم نام فایل خروجی PDF؛ برای stdout از `-` استفاده کنید. به‌طور پیش‌فرض، نام فایل خروجی از ورودی مشتق می‌شود، یعنی file.pdf.
انتخاب اندازهٔ کاغذ با نام (مانند letter، legal، ledger، tabloid، a3، a4، یا a5 )
فرض این‌که رشته‌های PDFMark در دستورهای \special با کدگذاری UTF-8 هستند.
حالت بی‌صدا.
تنظیم تفکیک‌پذیری فونت‌های بیت‌مپ به size نقطه در اینچ. فونت‌های بیت‌مپ توسط کتابخانهٔ Kpathsea تولید می‌شوند که از Metafont استفاده می‌کند. فونت‌های بیت‌مپ به‌صورت فونت‌های Type 3 در فایل خروجی PDF گنجانده می‌شوند. پیش‌فرض 600 است.
انتخاب صفحاتی از فایل DVI که باید پردازش شوند؛ پیش‌فرض `-` است، به‌معنای تمام صفحات. page_specifications شامل فهرستی جداشده با کاما از page_ranges است: 
page_specifications := page_specification[,page_specifications]
که در آن 
page_specification := single_page|page_range
page_range := [first_page]-[last_page]
یک first_page خالی به‌عنوان صفحهٔ نخست فایل DVI و یک last_page خالی به‌عنوان صفحهٔ پایانی فایل DVI در نظر گرفته می‌شود.

مثال‌ها:

شامل صفحه‌های 1، 3 و 5؛
شامل تمام صفحه‌ها؛
شامل دو نسخه از تمام صفحه‌ها در فایل DVI؛ و
شامل ده صفحهٔ نخست فایل DVI.
جستجو برای تصاویر بندانگشتی (thumbnail) هر صفحه در دایرکتوری مشخص‌شده توسط متغیر محیطی TMPDIR . تصاویر بندانگشتی باید با قالبی مشخص نام‌گذاری شده باشند: نام پایهٔ یکسان با فایل DVI و شمارهٔ صفحه به‌صورت پسوندِ نام فایل. dvipdfmx خود چنین بندانگشتی‌هایی را تولید نمی‌کند، اما همراه با یک برنامهٔ پوشش‌دهنده (wrapper) به نام dvipdft توزیع می‌شود که این کار را انجام می‌دهد.
نمایش یک پیام راهنما و خروج موفقیت‌آمیز.
افزایش پرگویی (verbosity). نتایج گزینهٔ -v تجمعی هستند (برای مثال، -vv پرگویی را به اندازهٔ دو واحد افزایش می‌دهد). حداکثر پرگویی چهار است.
تنظیم حاشیهٔ چپ روی x_offset. حاشیهٔ چپ پیش‌فرض 1.0in است. ابعاد می‌تواند در هر یک از واحدهای قابل درک برای TeX مشخص شود (مانند bp، pt، in، cm).
تنظیم حاشیهٔ بالا روی y_offset. حاشیهٔ بالای پیش‌فرض 1.0in است. ابعاد می‌تواند در هر یک از واحدهای قابل درک برای TeX مشخص شود (مانند bpt، pt، in، cm).
تنظیم سطح فشرده‌سازی روی compression_level. سطوح فشرده‌سازی از 0 (بدون فشرده‌سازی) تا 9 (بیشترین فشرده‌سازی) متغیر است و با مقادیر قابل فهم برای zlib مطابقت دارد؛ پیش‌فرض 9 است.
پرچم‌های متفرقهٔ گزینه؛ برای جزئیات به خروجی ‎--help مراجعه کنید.
الگوی خط فرمان برای تبدیل PostScript به PDF؛ مقدار پیش‌فرض از فایل پیکربندی گرفته می‌شود، که تمامی جزئیات را نیز شرح داده و چندین حالت ممکن را ذکر می‌کند.
همواره تلاش برای جاسازی فونت‌ها، با نادیده گرفتن پرچم‌های مجوز و غیره..TP 5 -I number طول عمر حافظهٔ موقت (کَش) تصویر به ساعت؛ مقدار پیش‌فرض -2 است، به این معنی که تصاویر اصلاً کَش نمی‌شوند. مقدار -1 یعنی پاک کردن تمام تصاویر قدیمی و همچنین تصاویر جدید؛ مقدار 0 یعنی پاک کردن تمام تصاویر قدیمی اما باقی گذاشتن تصاویر جدید.
طول کلید رمزنگاری؛ پیش‌فرض 40 است.
پردازش خروجی PostScript متعلق به MetaPost.
تنظیم بیشینهٔ عمق آیتم‌های باز نشانک‌ها؛ پیش‌فرض 0 است.
تنظیم پرچم‌های دسترسی برای رمزنگاری PDF؛ پیش‌فرض 0x003C است.
فعال‌سازی رمزنگاری PDF.
تنظیم نگارش فرعی PDF؛ پیش‌فرض 5 (از فایل پیکربندی) است.

هنگام گنجاندن تصاویر با dvipdfmx، کادرهای احاطه‌کننده (bounding boxes) آن‌ها باید با اجرای extractbb تولید شوند. نتیجه در یک فایل .xbb قرار خواهد گرفت؛ اطلاعات xbb مشابه با قالب PDF است.

dvipdfmx از کتابخانهٔ kpathsea برای پیدا کردن فایل‌هایی که باز می‌کند استفاده می‌کند. بنابراین، متغیرهای محیطی مستند شده در مستندات Kpathsea library بر dvipdfmx تأثیر می‌گذارند. همچنین از مقدار متغیر محیطی TMPDIR به‌عنوان دایرکتوری جستجو برای تصاویر بندانگشتی هر صفحه استفاده می‌کند.

محل دقیق فایل‌های زیر با پیکربندی Kpathsea library تعیین می‌شود. مکان آن‌ها را می‌توان با استفاده از kpsewhich تعیین کرد، به‌عنوان مثال:

kpsewhich -progname=dvipdfmx -format='other text files' dvipdfmx.cfg
فایل پیکربندی پیش‌فرض
فایل پیکربندی که Ghostscript را بدون بررسی‌های امنیتی اجرا می‌کند؛ فقط برای فایل‌های منبع مورد اعتماد استفاده کنید. در حال حاضر برای استفاده از PSTricks با XeTeX لازم است: xetex -output-driver="xdvipdfmx -i dvipdfmx-unsafe.cfg -q -E" ...
فایل نگاشت قلم پیش‌فرض (این مورد می‌تواند در فایل پیکربندی تغییر کند).
*.tfm
سنجه‌های قلم TeX
*.vf
فایل‌های قلم مجازی TeX
*.pfb
فایل‌های قلم PostScript Type 1
فایل پیکربندی کتابخانهٔ Kpathsea. محل این فایل را می‌توان با تایپ دستور زیر پیدا کرد: 
kpsewhich texmf.cnf

dvipdft(1), extractbb(1),
tex(1), luatex(1), xetex(1), dvips(1),
groff(1), grodvi(1), pic(1), مستندات Info کتابخانهٔ Kpathsea (https://tug.org/kpathsea)، و راهنمای کاربر Dvipdfmx (در توزیع، و پیوند داده شده از https://tug.org/dvipdfmx)..SH "نویسندگان (AUTHORS)" در اصل توسط Mark A. Wicks؛ افزونه‌های dvipdfmx عمدتاً توسط Jin-Hwan Cho، Shunsaku Hirata و Matthias Franz. برای نسخهٔ موجود در TeX Live، لطفاً باگ‌ها و سایر گزارش‌ها را برای نگه‌دارندگان به نشانی dvipdfmx (at) tug.org (https://lists.tug.org/dvipdfmx) ارسال کنید.

این صفحهٔ راهنما برای TeX Live توسط Bob Tennent و دیگران ویرایش شده است. این صفحهٔ راهنما در مالکیت عمومی قرار دارد.

1 June 2021