.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH TEXI2DVI "1" "March 2026" "texi2dvi (GNU Texinfo 7.3)" "دستورات کاربر"
.SH "نام (NAME)"
texi2dvi \- چاپ و کامپایل اسناد Texinfo به فرمت DVI یا PDF
.SH "خلاصه دستور (SYNOPSIS)"
.B texi2dvi
[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR...
.br
.B texi2pdf
[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR...
.br
.B pdftexi2dvi
[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR...
.SH "توضیحات (DESCRIPTION)"
هر \fIFILE\fR متنی Texinfo یا (La)TeX را به نوبت توسط TeX پردازش و اجرا می‌کند تا تمامی ارجاعات متقابل (cross\-references) حل شده و همهٔ نمایه‌ها (indices) ساخته شوند. دایرکتوری حاوی هر \fIFILE\fR برای یافتن فایل‌های ضمیمه‌شده جستجو می‌شود. پسوند \fIFILE\fR برای تعیین زبان آن ((La)TeX یا Texinfo) به کار می‌رود. برای پردازش فایل‌های (e)plain TeX، متغیر محیطی LATEX=tex را تنظیم کنید.
.PP
هنگامی که با نام `texi2pdf' فراخوانی شود یا گزینهٔ
.B \-\-pdf
داده شود، خروجی PDF تولید می‌کند؛ در غیر این صورت، خروجی DVI تولید می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های عمومی:"
.TP
\fB\-D\fR, \fB\-\-debug\fR
فعال کردن اشکال‌زدایی شل (تنظیم \fB\-x\fR)
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این راهنما و خروج موفقیت‌آمیز
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,OFILE\/\fR
قرار دادن خروجی در OFILE؛ تنها یک FILE ورودی مجاز است
.TP
\fB\-q\fR, \fB\-\-quiet\fR
عدم تولید خروجی مگر در صورت بروز خطا
.TP
\fB\-v\fR, \fB\-\-version\fR
نمایش اطلاعات نسخه و خروج موفقیت‌آمیز
.TP
\fB\-V\fR, \fB\-\-verbose\fR
گزارش دادن کارهای انجام‌شده
.TP
\fB\-\-max\-iterations\fR=\fI\,N\/\fR
عدم پردازش فایل‌ها بیش از N بار [7]
.TP
\fB\-\-mostly\-clean\fR
حذف فایل‌ها یا دایرکتوری‌های کمکی حاصل از اجراهای قبلی (به استثنای فایل خروجی)
.SS "قالب خروجی:"
.TP
\fB\-\-dvi\fR
تولید یک فایل DVI [پیش‌فرض]
.TP
\fB\-\-dvipdf\fR
تولید یک فایل PDF از طریق DVI (با استفاده از یک برنامهٔ dvi\-to\-pdf)
.TP
\fB\-p\fR, \fB\-\-pdf\fR
استفاده از pdftex یا pdflatex برای پردازش
.TP
\fB\-\-ps\fR
تولید یک فایل PostScript از طریق DVI (با استفاده از dvips)
.SS "تنظیم TeX:"
.TP
\fB\-E\fR, \fB\-\-expand\fR
بسط ماکروها با استفاده از makeinfo
.TP
\fB\-I\fR DIR
جستجوی DIR برای یافتن فایل‌های Texinfo
.TP
\fB\-l\fR, \fB\-\-language\fR=\fI\,LANG\/\fR
مشخص کردن LANG برای FILE، به صورت latex یا texinfo
.TP
\fB\-\-no\-line\-error\fR
ارسال نکردن \fB\-\-file\-line\-error\fR به TeX
.TP
\fB\-\-shell\-escape\fR
ارسال \fB\-\-shell\-escape\fR به TeX
.TP
\fB\-\-src\-specials\fR
ارسال \fB\-\-src\-specials\fR به TeX
.TP
\fB\-\-translate\-file\fR=\fI\,FILE\/\fR
استفاده از فایل تبدیل مجموعه نویسهٔ (charset) داده‌شده برای TeX
.TP
\fB\-t\fR, \fB\-\-command\fR=\fI\,CMD\/\fR
درج CMD در رونوشت فایل ورودی
.SS "حالت‌های ساخت:"
.TP
\fB\-\-build\fR=\fI\,MODE\/\fR
مشخص کردن نحوهٔ مدیریت فایل‌های کمکی [local]
.TP
\fB\-\-tidy\fR
مشابه \fB\-\-build\fR=\fI\,tidy\/\fR
.TP
\fB\-c\fR, \fB\-\-clean\fR
مشابه \fB\-\-build\fR=\fI\,clean\/\fR
.TP
\fB\-\-build\-dir\fR=\fI\,DIR\/\fR
مشخص کردن مکانی که کامپایل tidy در آن انجام می‌شود؛ مستلزم \fB\-\-tidy\fR است
.PP
مقدار MODE مشخص می‌کند کامپایل TeX در کجا انجام شود و در نتیجه فایل‌های کمکی چگونه مدیریت شوند.
.SS "مقادیر معتبر برای MODE عبارتند از:"
.TP
`local'
کامپایل در دایرکتوری جاری و باقی گذاشتن تمام فایل‌های کمکی در همان‌جا؛ این روش سنتی استفاده از TeX است.
.TP
`tidy'
کامپایل در یک دایرکتوری محلی *.t2d که فایل‌های کمکی در آنجا باقی می‌مانند. فایل‌های خروجی مجدداً به مکان فایل اصلی کپی می‌شوند.
.TP
`clean'
مشابه `tidy'، اما دایرکتوری کمکی پس از اتمام کار حذف می‌شود. بنابراین، هر کامپایل به چرخهٔ کامل نیاز دارد.
.PP
حالت ساخت را می‌توان با استفاده از متغیر محیطی TEXI2DVI_BUILD_MODE نیز تنظیم کرد. دایرکتوری ساخت tidy را نیز می‌توان با استفاده از متغیر محیطی TEXI2DVI_BUILD_DIRECTORY مشخص نمود.
.PP
در صورت تنظیم بودن، مقادیر این متغیرهای محیطی برای اجرای دستورات متناظر استفاده می‌شوند:
.IP
BIBER BIBTEX DVIPDF DVIPS EGREP LATEX MAKEINDEX MAKEINFO
PDFLATEX PDFTEX SED TEX TEXINDEX TEXINDY THUMBPDF_CMD
.PP
در رابطه با
.BR \-\-dvipdf ،
چنانچه DVIPDF در محیط تنظیم نشده باشد، برنامه‌های زیر (به این ترتیب) جستجو می‌شوند: dvipdfmx dvipdfm dvipdf dvi2pdf dvitopdf.
.PP
اگر Texinfo در سیستم شما نصب شده است، دستور
.IP
info texi2dvi
.PP
باید دسترسی به مستندات بیشتری را برای شما فراهم کند.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش‌های باگ را به bug\-texinfo@gnu.org،
و سوالات عمومی و گفتگوها را به help\-texinfo@gnu.org ارسال کنید.
.br
صفحه خانگی GNU Texinfo: <https://www.gnu.org/software/texinfo>
.br
راهنمای عمومی استفاده از نرم‌افزارهای گنو: <http://www.gnu.org/gethelp>
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2026 Free Software Foundation, Inc.
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>
.br
این نرم‌افزار آزاد است: شما در ویرایش و بازتوزیع آن آزاد هستید.
هیچ‌گونه ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل برای
.B texi2dvi
به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های
.B info
و
.B texi2dvi
به‌درستی روی سیستم شما نصب شده باشند، دستور
.IP
.B info texi2dvi
.PP
باید دسترسی شما به راهنمای کامل را فراهم کند.