TEXI2ANY(1)

الاسم
texi2any - يترجم مستندات Texinfo

موجز
makeinfo [الخيار]... ملف-TEXINFO...

الوصف
ترجمة وثائق المصدر من Texinfo إلى تنسيقات أخرى مختلفة، وملفات Info بشكل مبدئي تكون مناسبة للقراءة عبر الإنترنت باستخدام Emacs أو GNU Info المستقل.

يُثبّت هذا البرنامج عادةً باسمي `makeinfo' و `texi2any'؛ السلوك متطابق، ولا يعتمد على الاسم المثبت.

  خيارات عامة:

--document-language=STR الإعدادات المحلية (locale) لاستخدامها في ترجمة كلمات Texinfo المفتاحية
    لمستند الإخراج (المبدئي C)

--error-limit=NUM
    الخروج بعد عدد NUM من الأخطاء (المبدئي 100)

--force
    حفظ المخرجات حتى في حال وجود أخطاء

--help
    عرض هذه المساعدة والخروج

--no-validate
    تعطيل التحقق من صحة المراجع المتداخلة للعقد

--no-warn
    تعطيل التحذيرات (ولكن ليس الأخطاء)

--conf-dir=DIR
    البحث أيضاً عن ملفات التهيئة في DIR

--init-file=FILE
    تحميل FILE لتعديل السلوك المبدئي

-c، --set-customization-variable VAR=VAL
    ضبط متغير التخصيص VAR على القيمة VAL

--trace-includes
    طباعة أسماء الملفات المضمنة

-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. مع المخرجات المقسمة، يُنشأ DEST كدليل وتُوضع ملفات المخرجات هناك. مع المخرجات غير المقسمة، إذا كان DEST دليلاً بالفعل أو ينتهي بـ /، يُوضع ملف المخرجات هناك. وإلا، فإن DEST يسمى ملف المخرجات.

--disable-encoding
    عدم إخراج الحروف المشكولة والخاصة في مخرجات Info والنص المجرد بناءً على ترميز المستند

--enable-encoding
    تجاوز --disable-encoding (مبدئي)

  خيارات Info والنص المجرد:

--fill-column=NUM
    كسر أسطر Info عند عدد NUM من الأعمدة (المبدئي 72)

--footnote-style=STYLE
    إخراج الحواشي السفلية في Info وفقاً لـ STYLE: `separate' لوضعها في عقدتها الخاصة؛ `end' لوضعها في نهاية العقدة التي عُرّفت فيها (هذا هو المبدئي)

--paragraph-indent=VAL
    إزاحة فقرات Info بمقدار VAL من المسافات (المبدئي 3). إذا كان VAL هو `none'، فلا تزيح؛ إذا كان VAL هو `asis'، فاحتفظ بالإزاحة الموجودة.

--split-size=NUM
    تقسيم ملفات Info عند الحجم NUM (المبدئي 300000)

  خيارات HTML:

--css-include=FILE
    تضمين FILE في مخرجات HTML <style>؛ القراءة من المدخلات القياسية إذا كان FILE هو -

--css-ref=URL
    إنشاء مرجع CSS إلى URL

--internal-links=FILE
    إنتاج قائمة بالروابط الداخلية في FILE

--split=SPLIT
    التقسيم عند SPLIT، حيث يمكن أن يكون SPLIT هو `chapter' أو `section' أو `node'

--transliterate-file-names
    استخدام أسماء الملفات بنقل حرفي بترميز ASCII

--node-files
    إنتاج ملفات إعادة توجيه للعقد والمراسي (anchors)؛ يتم التفعيل مبدئياً فقط في حال التقسيم

  خيارات DVI/PS/PDF:

--Xopt=OPT
    تمرير OPT إلى texi2dvi؛ يمكن تكراره

  خيارات ملف المدخلات:

-D VAR
    تعريف المتغير VAR، كما هو الحال مع @set

-D 'VAR VAL'
    تعريف VAR كـ VAL (معامل صدفة واحد)

-I دليل
    إلحاق 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؛ على سبيل المثال، يُفعّل --ifhtml عند إخراج HTML. وأيضًا، عندما يكون --ifFORMAT مُفعّلًا، لا تُعالج نصوص @ifnotFORMAT.

    يمكن إضافة البادئة `--no-' لكل خيار --ifFORMAT لنفيه؛ على سبيل المثال، --no-ifhtml تعني عدم معالجة نصوص @ifhtml أو @html، ومعالجة نصوص @ifnothtml.

أمثلة

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 واحد مهما كبُر حجمه

التبليغ عن الأخطاء
أرسل تقارير الأخطاء بالبريد الإلكتروني إلى bug-texinfo@gnu.org، والأسئلة العامة والمناقشات إلى help-texinfo@gnu.org.
الصفحة الرئيسة لـ Texinfo: https://www.gnu.org/software/texinfo/

حقوق النسخ
حقوق النشر © 2026 لمؤسسة البرمجيات الحرة، المحدودة. رخصة GPLv3+: إصدار رخصة جنو العمومية 3 أو أحدث <https://gnu.org/licenses/gpl.html>
هذا برنامج حر: أنت حر في تغييره وإعادة توزيعه. لا يوجد أي ضمان، إلى المدى الذي يسمح به القانون.

انظر أيضًا
يُصان التوثيق الكامل لـ texi2any كدليل Texinfo. إذا كان برنامجا info و texi2any مُثبّتين بشكل صحيح في موقعك، فإن الأمر

    info texi2any

سيتيح لك الوصول إلى الدليل الكامل.

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.