POD2TEXI(1)

الاسم
pod2texi - تحويل Pod إلى Texinfo

موجز
  pod2texi [خيار]... POD...

الوصف
ترجمة ملفات Pod إلى Texinfo. يوجد وضعان أساسيان للتشغيل. أولاً، مبدئيًا، يُترجم كل Pod إلى دليل Texinfo مستقل.

ثانيًا، إذا ضُبط "--base-level" على قيمة أعلى من 0، يُترجم كل Pod إلى ملف مناسب لـ @include، ويُولد ملف إضافي بقائمة رئيس وكل @include.

الخيارات

--appendix-sections
    استخدام أوامر تقسيم الملحق (@appendix، ...) بدلاً من أوامر Texinfo @-المرقمة المبدئية (@chapter، @section، ...).

--base-level=رقم|اسم
    يضبط مستوى أوامر "head1". قد يكون عددًا صحيحًا أو أمر تقسيم Texinfo (بدون "@"): 1 يقابل مستوى @chapter/@unnumbered، 2 يقابل مستوى @section، وهكذا. المبدئي هو 0، مما يعني أن أوامر "head1" تُخرج كفصول، لكن المخرجات تُرتب كدليل مستقل.

    إذا لم يكن المستوى 0، يُعرض ملف Pod كجزء من دليل Texinfo مناسب لـ @include. في هذه الحالة، لكل ملف Pod أمر تقسيم إضافي يغطي الملف بأكمله، بمستوى واحد أعلى من قيمة "--base-level". لذلك، لجعل كل ملف Pod فصلًا في دليل كبير، يجب استخدام "section" كمستوى أساس.

    لمثال عن إنشاء Texinfo من توثيق Perl نفسه، انظر "contrib/perldoc-all" في توزيعة مصدر Texinfo.

--debug=رقم
    ضبط مستوى التصحيح إلى رقم.

--generate-setfilename
    توليد سطر @setfilename للأدلة المستقلة. يمكن نفيه باستخدام "--no-generate-setfilename". يُتجاهل إذا لم يكن "--base-level" يساوي 0.

--headings-as-sections
    استخدام أوامر العناوين (@heading، ...) بدلاً من أوامر Texinfo @-المرقمة المبدئية (@chapter، @section، ...). أمر التقسيم الذي يغطي مخرجات الملف بأكمله لكل ملف Pod إذا لم يكن --base-level يساوي 0 هو أمر مرقم.

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

--menus
    إخراج قوائم العقد. إذا كان هناك دليل رئيس، فسيتم دائمًا إخراج قائمة عقدته العليا، حيث يتم إنشاء قائمة رئيسية. لا يتم إخراج قوائم العقد الأخرى في الحالة المبدئية.

--outdir=NAME
    إذا كان هناك دليل رئيس مع ملفات تضمين (كل منها يقابل ملف Pod مدخل)، فسيتم وضع ملفات Texinfo المُنشأة في الدليل NAME. المبدئي يعتمد على "--subdir".

--output=NAME
    اسم الدليل الأول، أو الدليل الرئيس إذا كان هناك دليل رئيس. المبدئي هو الكتابة إلى المخرج القياسي.

--no-section-nodes
    استخدام مراسي للأقسام بدلاً من العقد.

--no-fill-section-gaps
    لا تملأ فجوات التقسيم بملفات @unnumbered فارغة. عادةً، من الجيد الحفاظ على التسلسل الهرمي للتقسيم سليمًا.

--preamble=STR
    إدراج STR كنص قياسي علوي قبل القائمة والتضمينات. إذا تم تعيين STR إلى "-", اقرأ النص القياسي العلوي من المدخل القياسي. النص القياسي العلوي المبدئي هو بداية بسيطة لوثيقة Texinfo.

--setfilename=STR
    استخدام STR في النص القياسي العلوي قبل القائمة والتضمينات لـ @setfilename للدليل الرئيس، إذا لم يتم تعيين "--base-level" إلى 0. يتم تجاهله إذا كان "--base-level" هو 0. لا يتم إخراج @setfilename في الحالة المبدئية للدليل الرئيس.

--subdir=NAME
    إذا كان هناك دليل رئيس مع ملفات تضمين (كل منها يقابل ملف Pod مدخل)، فسيتم تضمين ملفات التضمين هذه من NAME.

    إذا تم تعيين "--outdir"، فيجب عمومًا تعيين NAME إلى الدليل النسبي بين الدليل الرئيس ووسيطة "--outdir".

--unnumbered-sections
    استخدام أوامر تقسيم غير مرقمة (@unnumbered, ...) بدلاً من أوامر Texinfo @-commands للتقسيم المرقم المبدئية (@chapter, @section, ...).

--top=TOP
    اسم عنصر @top للدليل الرئيس. قد يحتوي على كود Texinfo.

--version
    يعرض معلومات الإصدار ويخرج

انظر أيضًا
Pod::Simple::Texinfo. perlpod. دليل Texinfo. الصفحة الرئيسية لـ Texinfo: <https://www.gnu.org/software/texinfo/>

حقوق النشر والترخيص
حقوق النشر 2012-2026 مؤسسة البرمجيات الحرة، المحدودة.

هذا البرنامج هو برمجيات حرة؛ يمكنك إعادة توزيعه و/أو تعديله بموجب شروط رخصة GNU العمومية العامة كما تنشرها مؤسسة البرمجيات الحرة؛ إما الإصدار 3 من الرخصة، أو (حسب اختيارك) أي إصدار لاحق.

لا يوجد أي ضمان، إلى الحد المسموح به قانونًا.

المؤلف
باتريس دوماس <bug-texinfo@gnu.org>.

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

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

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