MAKEINFO(1) دستورات کاربر MAKEINFO(1)

makeinfo - ترجمه اسناد Texinfo به قالبهای خروجی گوناگون

makeinfo [OPTION]... TEXINFO-FILE...

ترجمه مستندات منبع Texinfo به قالب‌های متنوع دیگر؛ به‌طور پیش‌فرض فایل‌های Info مناسب برای خواندن آنلاین با Emacs یا برنامه مستقل GNU Info.

این برنامه معمولاً با هر دو نام `makeinfo' و `texi2any' نصب می‌شود؛ رفتار برنامه در هر دو حالت یکسان است و به نام نصب‌شده وابسته نیست.

تنظیم لوکال مورد استفاده برای ترجمه کلیدواژه‌های Texinfo در سند خروجی (پیش‌فرض C)
خروج پس از NUM خطا (پیش‌فرض ۱۰۰)
حفظ خروجی حتی در صورت وجود خطا
نمایش این راهنما و خروج
عدم اعتبارسنجی ارجاع متقابل گره‌ها (nodes)
نادیده گرفتن هشدارها (اما نه خطاها)
جستجوی فایل‌های راه‌اندازی (initialization) در DIR نیز
بارگذاری FILE برای تغییر رفتار پیش‌فرض
تنظیم متغیر سفارشی‌سازی VAR به مقدار VAL
چاپ نام فایل‌های ضمیمه‌شده (included)
توضیح عملیات در حال انجام (حالت پرجزئیات)
نمایش اطلاعات نسخه و خروج

تولید خروجی Docbook XML
تولید خروجی HTML
تولید خروجی EPUB 3
تولید خروجی LaTeX
تولید خروجی به صورت متن ساده به‌جای Info
تولید خروجی Texinfo XML
فراخوانی texi2dvi برای تولید خروجی مشخص‌شده، پس از بررسی اعتبار TEXINFO-FILE

ارسال منبع ماکروگسترش‌یافته به FILE، با نادیده گرفتن هرگونه @setfilename
حذف جداکننده‌های گره، خطوط Node: و منوها از خروجی Info (و در نتیجه تولید متن ساده) یا از HTML (و در نتیجه تولید خروجی کوتاه‌تر). همچنین در صورت تولید Info، خروجی به‌طور پیش‌فرض در خروجی استاندارد نوشته می‌شود.
جلوگیری از هرگونه تکه‌تکه شدن خروجی؛ تولید تنها یک فایل خروجی
--[no-]number-sections
شماره‌گذاری فصل‌ها و بخش‌ها؛ پیش‌فرض فعال است
--[no-]number-footnotes
شماره‌گذاری ترتیبی پاورقی‌ها؛ پیش‌فرض فعال است
ارسال خروجی به DEST. با خروجی تکه‌تکه (split)، پوشه DEST ایجاد شده و فایل‌های خروجی در آن قرار می‌گیرند. با خروجی یکپارچه (non-split)، اگر DEST از قبل یک پوشه باشد یا به / ختم شود، فایل خروجی در آنجا قرار می‌گیرد. در غیر این صورت، DEST نام فایل خروجی خواهد بود.
عدم تولید نویسه‌های نشانه‌دار و خاص در خروجی Info و متن ساده بر اساس کدگذاری سند
لغو و باطل‌سازی --disable-encoding (پیش‌فرض)

شکستن خطوط Info در ستون NUM (پیش‌فرض ۷۲)
تولید پاورقی‌ها در Info بر اساس STYLE: مقدار `separate' برای قرار دادن آن‌ها در گره اختصاصی خود؛ مقدار `end' برای قرار دادن آن‌ها در انتهای گره‌ای که در آن تعریف شده‌اند (پیش‌فرض)
دندانه‌دار کردن پاراگراف‌های Info به اندازه VAL فاصله (پیش‌فرض ۳). اگر VAL برابر `none' باشد، تورفتگی اعمال نمی‌شود؛ اگر `asis' باشد، تورفتگی موجود حفظ می‌شود.
تکه‌تکه کردن فایل‌های Info در اندازه NUM (پیش‌فرض ۳۰۰۰۰۰)

گنجاندن FILE در خروجی <style> در HTML؛ خواندن ورودی استاندارد در صورتی که FILE برابر - باشد
تولید ارجاع CSS به URL
تولید فهرستی از پیوندهای داخلی در FILE
تقسیم‌بندی خروجی در SPLIT، که SPLIT می‌تواند `chapter' (فصل)، `section' (بخش) یا `node' (گره) باشد
استفاده از نویسه‌گردانی اسکی (ASCII transliteration) برای نام فایل‌ها
تولید فایل‌های تغییر مسیر برای گره‌ها و لنگرها؛ پیش‌فرض تنها در صورت خروجی چندتکه‌ای فعال است

ارسال OPT به texi2dvi؛ این گزینه می‌تواند تکرار شود

تعریف متغیر VAR، همانند دستور @set
تعریف متغیر VAR با مقدار VAL (به عنوان یک آرگومان شل)
افزودن پوشه DIR به انتهای مسیر جستجوی @include
افزودن پوشه DIR به ابتدای مسیر جستجوی @include
لغو تعریف متغیر VAR، همانند دستور @clear

پردازش دستورهای @ifdocbook و @docbook
پردازش دستورهای @ifhtml و @html
پردازش دستور @ifinfo
پردازش دستورهای @iflatex و @latex
پردازش دستور @ifplaintext
پردازش دستورهای @iftex و @tex
پردازش دستورهای @ifxml و @xml
به‌طور پیش‌فرض، تنظیم یک --ifFORMAT تنها زمانی روشن است که قالب خروجی FORMAT باشد؛ برای مثال، هنگام تولید خروجی HTML گزینه --ifhtml فعال است. همچنین هنگامی که --ifFORMAT فعال باشد، متن‌های @ifnotFORMAT پردازش نمی‌شوند.
هر گزینه --ifFORMAT می‌تواند با پیشوند `--no-' نفی شود؛ برای نمونه، --no-ifhtml به این معنی است که متن‌های @ifhtml یا @html پردازش نشوند، و متن‌های @ifnothtml پردازش شوند.

نوشتن خروجی Info
نوشتن خروجی HTML
نوشتن خروجی Texinfo XML
نوشتن خروجی Docbook XML
نوشتن متن ساده در خروجی استاندارد
نوشتن خروجی PDF با استفاده از texi2dvi
نوشتن HTML بدون خطوط گره و منوها
نوشتن خروجی Info با بخش‌های شماره‌گذاری‌شده
نوشتن یک فایل Info منفرد بدون توجه به اندازه آن

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

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

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

info texi2any

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

March 2026 GNU texinfo 7.3