الاسم¶

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 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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