.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH MAKEINFO "1" "March 2026" "GNU texinfo 7.3" "دستورات کاربر"
.SH "نام (NAME)"
makeinfo \- ترجمه اسناد Texinfo به قالبهای خروجی گوناگون
.SH "خلاصه دستور (SYNOPSIS)"
.B makeinfo
[\fI\,OPTION\/\fR]... \fI\,TEXINFO-FILE\/\fR...
.SH "توضیحات (DESCRIPTION)"
ترجمه مستندات منبع Texinfo به قالب‌های متنوع دیگر؛ به‌طور پیش‌فرض
فایل‌های Info مناسب برای خواندن آنلاین با Emacs یا برنامه مستقل GNU Info.
.PP
این برنامه معمولاً با هر دو نام `makeinfo' و `texi2any' نصب می‌شود؛
رفتار برنامه در هر دو حالت یکسان است و به نام نصب‌شده وابسته نیست.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های عمومی:"
.TP
\fB\-\-document\-language\fR=\fI\,STR\/\fR
تنظیم لوکال مورد استفاده برای ترجمه کلیدواژه‌های Texinfo در سند خروجی (پیش‌فرض C)
.TP
\fB\-\-error\-limit\fR=\fI\,NUM\/\fR
خروج پس از NUM خطا (پیش‌فرض ۱۰۰)
.TP
\fB\-\-force\fR
حفظ خروجی حتی در صورت وجود خطا
.TP
\fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-\-no\-validate\fR
عدم اعتبارسنجی ارجاع متقابل گره‌ها (nodes)
.TP
\fB\-\-no\-warn\fR
نادیده گرفتن هشدارها (اما نه خطاها)
.TP
\fB\-\-conf\-dir\fR=\fI\,DIR\/\fR
جستجوی فایل‌های راه‌اندازی (initialization) در DIR نیز
.TP
\fB\-\-init\-file\fR=\fI\,FILE\/\fR
بارگذاری FILE برای تغییر رفتار پیش‌فرض
.TP
\fB\-c\fR, \fB\-\-set\-customization\-variable\fR VAR=VAL
تنظیم متغیر سفارشی‌سازی VAR به مقدار VAL
.TP
\fB\-\-trace\-includes\fR
چاپ نام فایل‌های ضمیمه‌شده (included)
.TP
\fB\-v\fR, \fB\-\-verbose\fR
توضیح عملیات در حال انجام (حالت پرجزئیات)
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.SS "انتخاب قالب خروجی (پیش‌فرض تولید Info است):"
.TP
\fB\-\-docbook\fR
تولید خروجی Docbook XML
.TP
\fB\-\-html\fR
تولید خروجی HTML
.TP
\fB\-\-epub3\fR
تولید خروجی EPUB 3
.TP
\fB\-\-latex\fR
تولید خروجی LaTeX
.TP
\fB\-\-plaintext\fR
تولید خروجی به صورت متن ساده به‌جای Info
.TP
\fB\-\-xml\fR
تولید خروجی Texinfo XML
.TP
\fB\-\-dvi\fR, \fB\-\-dvipdf\fR, \fB\-\-ps\fR, \fB\-\-pdf\fR
فراخوانی texi2dvi برای تولید خروجی مشخص‌شده، پس از بررسی اعتبار TEXINFO\-FILE
.SS "گزینه‌های عمومی خروجی:"
.TP
\fB\-E\fR, \fB\-\-macro\-expand\fR=\fI\,FILE\/\fR
ارسال منبع ماکروگسترش‌یافته به FILE، با نادیده گرفتن هرگونه @setfilename
.TP
\fB\-\-no\-headers\fR
حذف جداکننده‌های گره، خطوط Node: و منوها از خروجی Info (و در نتیجه تولید متن ساده) یا از HTML (و در نتیجه تولید خروجی کوتاه‌تر). همچنین در صورت تولید Info، خروجی به‌طور پیش‌فرض در خروجی استاندارد نوشته می‌شود.
.TP
\fB\-\-no\-split\fR
جلوگیری از هرگونه تکه‌تکه شدن خروجی؛ تولید تنها یک فایل خروجی
.TP
\fB\-\-[no\-]number\-sections\fR
شماره‌گذاری فصل‌ها و بخش‌ها؛ پیش‌فرض فعال است
.TP
\fB\-\-[no\-]number\-footnotes\fR
شماره‌گذاری ترتیبی پاورقی‌ها؛ پیش‌فرض فعال است
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,DEST\/\fR
ارسال خروجی به DEST.
با خروجی تکه‌تکه (split)، پوشه DEST ایجاد شده و فایل‌های خروجی در آن قرار می‌گیرند.
با خروجی یکپارچه (non\-split)، اگر DEST از قبل یک پوشه باشد یا به / ختم شود،
فایل خروجی در آنجا قرار می‌گیرد.
در غیر این صورت، DEST نام فایل خروجی خواهد بود.
.TP
\fB\-\-disable\-encoding\fR
عدم تولید نویسه‌های نشانه‌دار و خاص در خروجی Info و متن ساده بر اساس کدگذاری سند
.TP
\fB\-\-enable\-encoding\fR
لغو و باطل‌سازی \fB\-\-disable\-encoding\fR (پیش‌فرض)
.SS "گزینه‌های مربوط به Info و متن ساده:"
.TP
\fB\-\-fill\-column\fR=\fI\,NUM\/\fR
شکستن خطوط Info در ستون NUM (پیش‌فرض ۷۲)
.TP
\fB\-\-footnote\-style\fR=\fI\,STYLE\/\fR
تولید پاورقی‌ها در Info بر اساس STYLE:
مقدار `separate' برای قرار دادن آن‌ها در گره اختصاصی خود؛
مقدار `end' برای قرار دادن آن‌ها در انتهای گره‌ای که در آن تعریف شده‌اند (پیش‌فرض)
.TP
\fB\-\-paragraph\-indent\fR=\fI\,VAL\/\fR
دندانه‌دار کردن پاراگراف‌های Info به اندازه VAL فاصله (پیش‌فرض ۳).
اگر VAL برابر `none' باشد، تورفتگی اعمال نمی‌شود؛ اگر `asis' باشد، تورفتگی موجود حفظ می‌شود.
.TP
\fB\-\-split\-size\fR=\fI\,NUM\/\fR
تکه‌تکه کردن فایل‌های Info در اندازه NUM (پیش‌فرض ۳۰۰۰۰۰)
.SS "گزینه‌های مربوط به HTML:"
.TP
\fB\-\-css\-include\fR=\fI\,FILE\/\fR
گنجاندن FILE در خروجی <style> در HTML؛
خواندن ورودی استاندارد در صورتی که FILE برابر \- باشد
.TP
\fB\-\-css\-ref\fR=\fI\,URL\/\fR
تولید ارجاع CSS به URL
.TP
\fB\-\-internal\-links\fR=\fI\,FILE\/\fR
تولید فهرستی از پیوندهای داخلی در FILE
.TP
\fB\-\-split\fR=\fI\,SPLIT\/\fR
تقسیم‌بندی خروجی در SPLIT، که SPLIT می‌تواند `chapter' (فصل)،
`section' (بخش) یا `node' (گره) باشد
.TP
\fB\-\-transliterate\-file\-names\fR
استفاده از نویسه‌گردانی اسکی (ASCII transliteration) برای نام فایل‌ها
.TP
\fB\-\-node\-files\fR
تولید فایل‌های تغییر مسیر برای گره‌ها و لنگرها؛ پیش‌فرض تنها در صورت خروجی چندتکه‌ای فعال است
.SS "گزینه‌های مربوط به DVI/PS/PDF:"
.TP
\fB\-\-Xopt\fR=\fI\,OPT\/\fR
ارسال OPT به texi2dvi؛ این گزینه می‌تواند تکرار شود
.SS "گزینه‌های فایل ورودی:"
.TP
\fB\-D\fR VAR
تعریف متغیر VAR، همانند دستور @set
.TP
\fB\-D\fR 'VAR VAL'
تعریف متغیر VAR با مقدار VAL (به عنوان یک آرگومان شل)
.TP
\fB\-I\fR DIR
افزودن پوشه DIR به انتهای مسیر جستجوی @include
.TP
\fB\-P\fR DIR
افزودن پوشه DIR به ابتدای مسیر جستجوی @include
.TP
\fB\-U\fR VAR
لغو تعریف متغیر VAR، همانند دستور @clear
.SS "پردازش شرطی در ورودی:"
.TP
\fB\-\-ifdocbook\fR
پردازش دستورهای @ifdocbook و @docbook
.TP
\fB\-\-ifhtml\fR
پردازش دستورهای @ifhtml و @html
.TP
\fB\-\-ifinfo\fR
پردازش دستور @ifinfo
.TP
\fB\-\-iflatex\fR
پردازش دستورهای @iflatex و @latex
.TP
\fB\-\-ifplaintext\fR
پردازش دستور @ifplaintext
.TP
\fB\-\-iftex\fR
پردازش دستورهای @iftex و @tex
.TP
\fB\-\-ifxml\fR
پردازش دستورهای @ifxml و @xml
.IP
به‌طور پیش‌فرض، تنظیم یک \fB\-\-ifFORMAT\fR تنها زمانی روشن است که قالب خروجی
FORMAT باشد؛ برای مثال، هنگام تولید خروجی HTML گزینه \fB\-\-ifhtml\fR فعال است.
همچنین هنگامی که \fB\-\-ifFORMAT\fR فعال باشد، متن‌های @ifnotFORMAT پردازش نمی‌شوند.
.IP
هر گزینه \fB\-\-ifFORMAT\fR می‌تواند با پیشوند `\-\-no\-' نفی شود؛
برای نمونه، \fB\-\-no\-ifhtml\fR به این معنی است که متن‌های @ifhtml یا @html پردازش نشوند،
و متن‌های @ifnothtml پردازش شوند.
.SH "مثال‌ها (EXAMPLES)"
.TP
makeinfo foo.texi
نوشتن خروجی Info
.TP
makeinfo \-\-html foo.texi
نوشتن خروجی HTML
.TP
makeinfo \-\-xml foo.texi
نوشتن خروجی Texinfo XML
.TP
makeinfo \-\-docbook foo.texi
نوشتن خروجی Docbook XML
.TP
makeinfo \-\-plaintext foo.texi
نوشتن متن ساده در خروجی استاندارد
.TP
makeinfo \-\-pdf foo.texi
نوشتن خروجی PDF با استفاده از texi2dvi
.TP
makeinfo \-\-html \-\-no\-headers foo.texi
نوشتن HTML بدون خطوط گره و منوها
.TP
makeinfo \-\-number\-sections foo.texi
نوشتن خروجی Info با بخش‌های شماره‌گذاری‌شده
.TP
makeinfo \-\-no\-split foo.texi
نوشتن یک فایل Info منفرد بدون توجه به اندازه آن
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها را به bug\-texinfo@gnu.org،
و پرسش‌ها و گفتگوهای عمومی را به help\-texinfo@gnu.org ارسال کنید.
.br
صفحه اصلی Texinfo: <https://www.gnu.org/software/texinfo>
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2026 Free Software Foundation, Inc.
.br
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>
.br
این نرم‌افزار آزاد است: شما در ویرایش و بازتوزیع آن آزاد هستید.
هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل
.B texi2any
به صورت یک کتابچه راهنمای Texinfo نگهداری می‌شود. چنانچه برنامه‌های
.B info
و
.B texi2any
به‌درستی روی سیستم شما نصب شده باشند، دستور
.IP
.B info texi2any
.PP
باید دسترسی شما را به کتابچه راهنمای کامل فراهم کند.