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