Scroll to navigation

TEXI2ANY(1) أوامر المستخدم TEXI2ANY(1)

الاسم

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

موجز

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

الوصف

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

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

خيارات عامة:

لمستند المخرجات (المبدئي C).
الخروج بعد NUM من الأخطاء (المبدئي 100).
الحفاظ على المخرجات حتى في حالة وجود أخطاء.
يعرض هذه المساعدة ويخرج.
كبح التحقق من المراجع الترافقية للعقد.
كبح التحذيرات (لكن ليس الأخطاء).
البحث أيضًا عن ملفات التهيئة في DIR.
تحميل FILE لتعديل السلوك المبدئي.
ضبط متغير التخصيص VAR على القيمة VAL.
شرح ما يجري القيام به.
يعرض معلومات الإصدار ويخرج.

اختيار تنسيق المخرجات (المبدئي هو إنتاج Info):

إخراج Docbook XML.
إخراج HTML.
إخراج EPUB 3.
إخراج LaTeX.
إخراج نص صِرْف بدلاً من Info.
إخراج Texinfo XML.
استدعاء texi2dvi لتوليد المخرجات المعطاة، بعد التحقق من صحة TEXINFO-FILE.

خيارات المخرجات العامة:

إخراج المصدر الموسع بالماكرو إلى FILE، مع تجاهل أي @setfilename.
تعطيل فواصل العقد، وأسطر Node:، والقوائم من مخرجات Info (مما ينتج نصاً مجرداً) أو من HTML (مما ينتج مخرجات أقصر). أيضاً، في حال إنتاج Info، الكتابة إلى المخرجات القياسية بشكل مبدئي.
كبح أي تقسيم للمخرجات؛ توليد ملف مخرجات واحد فقط.
--[no-]number-sections
إخراج أرقام الفصول والأقسام؛ الخيار مُفعّل مبدئيًا.
إخراج إلى DEST. مع المخرجات المقسمة، يُنشأ DEST كدليل وتُوضع ملفات المخرجات هناك. مع المخرجات غير المقسمة، إذا كان DEST دليلاً بالفعل أو ينتهي بـ /، يُوضع ملف المخرجات هناك. وإلا، فإن DEST يسمى ملف المخرجات.
عدم إخراج الحروف المنبورة والخاصة في مخرجات Info والنص الصِرْف بناءً على ترميز المستند.
تجاوز --disable-encoding (مبدئي).

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

كسر أسطر Info عند NUM من الأعمدة (المبدئي 72).
إخراج الحواشي السفلية في Info وفقاً لـ STYLE: ‏`separate' لوضعها في عقدتها الخاصة؛ `end' لوضعها في نهاية العقدة التي عُرّفت فيها (هذا هو المبدئي).
إزاحة فقرات Info بمقدار VAL من المسافات (المبدئي 3). إذا كان VAL هو `none'، فلا تزيح؛ إذا كان VAL هو `asis'، فاحتفظ بالإزاحة الموجودة.
تقسيم ملفات Info عند الحجم NUM (المبدئي 300000).

خيارات HTML:

تضمين FILE في مخرجات <style> لـ HTML؛ القراءة من stdin إذا كان FILE هو -.
توليد مرجع CSS إلى URL.
إنتاج قائمة بالروابط الداخلية في FILE.
التقسيم عند SPLIT، حيث يمكن أن يكون SPLIT هو `chapter' أو `section' أو `node'.
استخدام أسماء الملفات في ترجمة ASCII الصوتية.
إنتاج ملفات إعادة توجيه للعقد والمرتكزات؛ يُضبط المبدئي فقط في حالة التقسيم.

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

تمرير OPT إلى texi2dvi؛ يمكن تكراره.

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

تعريف المتغير VAR، كما هو الحال مع @set.
تعريف VAR كـ VAL (وسيط صدفة واحد).
إلحاق DIR بمسار البحث @include.
إضافة DIR إلى بداية مسار البحث @include.
إلغاء تعريف المتغير VAR، كما هو الحال مع @clear.

المعالجة الشرطية في المدخلات:

معالجة @ifdocbook و @docbook حتى لو لم يُولّد Docbook.
معالجة @ifhtml و @html حتى لو لم يُولّد HTML.
معالجة @ifinfo حتى لو لم يُولّد Info.
معالجة @iflatex و @latex.
معالجة @ifplaintext حتى لو لم يُولّد نص صِرْف.
معالجة @iftex و @tex.
معالجة @ifxml و @xml.
عدم معالجة نصوص @ifdocbook و @docbook.
لا تعالج نص @ifhtml و @html.
لا تعالج نص @ifinfo.
لا تعالج نص @iflatex و @latex.
لا تعالج نص @ifplaintext.
لا تعالج نص @iftex و @tex.
لا تعالج نص @ifxml و @xml.

وأيضًا، لخيارات --no-ifFORMAT، عالج نص @ifnotFORMAT.

تعتمد القيم المبدئية للشرطيات @if...‎ على تنسيق المخرجات: فإذا وُلد Docbook، يُفعّل --ifdocbook وتُعطل البقية؛ وإذا وُلد HTML، يُفعّل --ifhtml وتُعطل البقية؛ وإذا وُلد Info، يُفعّل --ifinfo وتُعطل البقية؛ وإذا وُلد نص صرف، يُفعّل --ifplaintext وتُعطل البقية؛ وإذا وُلد LaTeX، يُفعّل --iflatex وتُعطل البقية؛ وإذا وُلد XML، يُفعّل --ifxml وتُعطل البقية.

أمثلة

اكتب Info إلى @setfilename الخاص بـ foo
اكتب HTML إلى @setfilename
اكتب Texinfo XML إلى @setfilename
اكتب Docbook XML إلى @setfilename
كتابة نص صِرْف إلى المخرجات القياسية
كتابة PDF باستخدام texi2dvi
كتابة html بدون خطوط العقد والقوائم
كتابة Info بأقسام مرقمة
كتابة ملف Info واحد مهما كبُر حجمه

التبليغ عن الأخطاء

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

حقوق النسخ

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

انظر أيضًا

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

info texi2any

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

ترجمة

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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

سبتمبر 2024 GNU texinfo 7.1.1