نام (NAME)

texi2dvi - چاپ و کامپایل اسناد Texinfo به فرمت DVI یا PDF

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

texi2dvi [OPTION]... FILE...
texi2pdf [OPTION]... FILE...
pdftexi2dvi [OPTION]... FILE...

توضیحات (DESCRIPTION)

هر FILE متنی Texinfo یا (La)TeX را به نوبت توسط TeX پردازش و اجرا می‌کند تا تمامی ارجاعات متقابل (cross-references) حل شده و همهٔ نمایه‌ها (indices) ساخته شوند. دایرکتوری حاوی هر FILE برای یافتن فایل‌های ضمیمه‌شده جستجو می‌شود. پسوند FILE برای تعیین زبان آن ((La)TeX یا Texinfo) به کار می‌رود. برای پردازش فایل‌های (e)plain TeX، متغیر محیطی LATEX=tex را تنظیم کنید.

هنگامی که با نام `texi2pdf' فراخوانی شود یا گزینهٔ --pdf داده شود، خروجی PDF تولید می‌کند؛ در غیر این صورت، خروجی DVI تولید می‌شود.

گزینه‌ها (OPTIONS)

گزینه‌های عمومی:

-D, --debug: فعال کردن اشکال‌زدایی شل (تنظیم -x)
-h, --help: نمایش این راهنما و خروج موفقیت‌آمیز
-o, --output=OFILE: قرار دادن خروجی در OFILE؛ تنها یک FILE ورودی مجاز است
-q, --quiet: عدم تولید خروجی مگر در صورت بروز خطا
-v, --version: نمایش اطلاعات نسخه و خروج موفقیت‌آمیز
-V, --verbose: گزارش دادن کارهای انجام‌شده
--max-iterations=N: عدم پردازش فایل‌ها بیش از N بار [7]
--mostly-clean: حذف فایل‌ها یا دایرکتوری‌های کمکی حاصل از اجراهای قبلی (به استثنای فایل خروجی)

قالب خروجی:

--dvi: تولید یک فایل DVI [پیش‌فرض]
--dvipdf: تولید یک فایل PDF از طریق DVI (با استفاده از یک برنامهٔ dvi-to-pdf)
-p, --pdf: استفاده از pdftex یا pdflatex برای پردازش
--ps: تولید یک فایل PostScript از طریق DVI (با استفاده از dvips)

تنظیم TeX:

-E, --expand: بسط ماکروها با استفاده از makeinfo
-I DIR: جستجوی DIR برای یافتن فایل‌های Texinfo
-l, --language=LANG: مشخص کردن LANG برای FILE، به صورت latex یا texinfo
--no-line-error: ارسال نکردن --file-line-error به TeX
--shell-escape: ارسال --shell-escape به TeX
--src-specials: ارسال --src-specials به TeX
--translate-file=FILE: استفاده از فایل تبدیل مجموعه نویسهٔ (charset) داده‌شده برای TeX
-t, --command=CMD: درج CMD در رونوشت فایل ورودی

حالت‌های ساخت:

--build=MODE: مشخص کردن نحوهٔ مدیریت فایل‌های کمکی [local]
--tidy: مشابه --build=tidy
-c, --clean: مشابه --build=clean
--build-dir=DIR: مشخص کردن مکانی که کامپایل tidy در آن انجام می‌شود؛ مستلزم --tidy است

مقدار MODE مشخص می‌کند کامپایل TeX در کجا انجام شود و در نتیجه فایل‌های کمکی چگونه مدیریت شوند.

مقادیر معتبر برای MODE عبارتند از:

`local': کامپایل در دایرکتوری جاری و باقی گذاشتن تمام فایل‌های کمکی در همان‌جا؛ این روش سنتی استفاده از TeX است.
`tidy': کامپایل در یک دایرکتوری محلی *.t2d که فایل‌های کمکی در آنجا باقی می‌مانند. فایل‌های خروجی مجدداً به مکان فایل اصلی کپی می‌شوند.
`clean': مشابه `tidy'، اما دایرکتوری کمکی پس از اتمام کار حذف می‌شود. بنابراین، هر کامپایل به چرخهٔ کامل نیاز دارد.

حالت ساخت را می‌توان با استفاده از متغیر محیطی TEXI2DVI_BUILD_MODE نیز تنظیم کرد. دایرکتوری ساخت tidy را نیز می‌توان با استفاده از متغیر محیطی TEXI2DVI_BUILD_DIRECTORY مشخص نمود.

در صورت تنظیم بودن، مقادیر این متغیرهای محیطی برای اجرای دستورات متناظر استفاده می‌شوند:

: BIBER BIBTEX DVIPDF DVIPS EGREP LATEX MAKEINDEX MAKEINFO PDFLATEX PDFTEX SED TEX TEXINDEX TEXINDY THUMBPDF_CMD

در رابطه با --dvipdf، چنانچه DVIPDF در محیط تنظیم نشده باشد، برنامه‌های زیر (به این ترتیب) جستجو می‌شوند: dvipdfmx dvipdfm dvipdf dvi2pdf dvitopdf.

اگر Texinfo در سیستم شما نصب شده است، دستور

: info texi2dvi

باید دسترسی به مستندات بیشتری را برای شما فراهم کند.

گزارش باگ‌ها (REPORTING BUGS)

گزارش‌های باگ را به bug-texinfo@gnu.org، و سوالات عمومی و گفتگوها را به help-texinfo@gnu.org ارسال کنید.
صفحه خانگی GNU Texinfo: https://www.gnu.org/software/texinfo
راهنمای عمومی استفاده از نرم‌افزارهای گنو: http://www.gnu.org/gethelp

حق نشر (COPYRIGHT)

حق نشر © 2026 Free Software Foundation, Inc. مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر https://gnu.org/licenses/gpl.html
این نرم‌افزار آزاد است: شما در ویرایش و بازتوزیع آن آزاد هستید. هیچ‌گونه ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.

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

مستندات کامل برای texi2dvi به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های info و texi2dvi به‌درستی روی سیستم شما نصب شده باشند، دستور

: info texi2dvi

باید دسترسی شما به راهنمای کامل را فراهم کند.