.\" -*- coding: UTF-8 -*-
.de  Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.\" Automatically generated by Pod::Man (Pod::Simple)
.\"
.\" Standard preamble:
.\" ========================================================================
.de  Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de  Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie  n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.de  IX
..
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.nr rF 0
.if  \n(.g .if rF .nr rF 1
.if  (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" fudge factors for nroff and troff
.    
.if  n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.if  t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.\" simple accents for nroff and troff
.    
.if  n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if  t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.\" troff and (daisy-wheel) nroff accents
.    
.ds : \k:\h'-(\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \k:\h'-(\n(.wu+\w'\(de'u\-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\fI\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.\" corrections for vroff
.    
.if  v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if  v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.\" for low resolution devices (crt and lpr)
.    
.if  \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "POD2TEXI 1"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH POD2TEXI 1 "9 يناير 2025" perl "توثيق Perl المساهم به من المستخدمين"
.if  n .ad l
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.nh
.SH الاسم
pod2texi \- تحويل Pod إلى Texinfo
.SH موجز
.IX Header موجز
.Vb 1
\&  pod2texi [خيار]... POD...
.Ve
.SH الوصف
.IX Header الوصف
ترجمة ملفات Pod إلى Texinfo. يوجد وضعان أساسيان للتشغيل. أولاً، مبدئيًا،
يُترجم كل Pod إلى دليل Texinfo مستقل.
.PP
ثانيًا، إذا ضُبط \f(CW\*(C`\-\-base\-level\*(C'\fP على قيمة أعلى من 0، يُترجم كل
Pod إلى ملف مناسب لـ \f(CW@include\fP، ويُولد ملف إضافي بقائمة رئيس وكل
\f(CW@include\fP.
.SH الخيارات
.IX Header الخيارات
.IP \fB\-\-appendix\-sections\fP 4
.IX Item \-\-appendix\-sections
استخدام أوامر تقسيم الملحق (\f(CW@appendix\fP، ...) بدلاً من أوامر Texinfo
@\-المرقمة المبدئية (\f(CW@chapter\fP، \&\f(CW@section\fP، ...).
.IP \fB\-\-base\-level\fP=\fIرقم|اسم\fP 4
.IX Item \-\-base\-level=رقم|اسم
يضبط مستوى أوامر \f(CW\*(C`head1\*(C'\fP. قد يكون عددًا صحيحًا أو أمر تقسيم
Texinfo (بدون \f(CW\*(C`@\*(C'\fP): 1 يقابل مستوى
\&\f(CW@chapter\fP/\f(CW@unnumbered\fP، 2 يقابل مستوى \f(CW@section\fP، وهكذا. المبدئي
هو 0، مما يعني أن أوامر \f(CW\*(C`head1\*(C'\fP تُخرج كفصول، لكن المخرجات تُرتب
كدليل مستقل.
.Sp
إذا لم يكن المستوى 0، يُعرض ملف Pod كجزء من دليل Texinfo مناسب لـ
\f(CW@include\fP. في هذه الحالة، لكل ملف Pod أمر تقسيم إضافي يغطي الملف بأكمله،
بمستوى واحد أعلى من قيمة \f(CW\*(C`\-\-base\-level\*(C'\fP. لذلك، لجعل كل ملف Pod
فصلًا في دليل كبير، يجب استخدام \f(CW\*(C`section\*(C'\fP كمستوى أساس.
.Sp
لمثال عن إنشاء Texinfo من توثيق Perl نفسه، انظر
\f(CW\*(C`contrib/perldoc\-all\*(C'\fP في توزيعة مصدر Texinfo.
.IP \fB\-\-debug\fP=\fI\s-1رقم\s0\fP 4
.IX Item \-\-debug=رقم
ضبط مستوى التصحيح إلى \fI\s-1رقم\s0\fP.
.IP \fB\-\-generate\-setfilename\fP 4
.IX Item \-\-generate\-setfilename
توليد سطر \f(CW@setfilename\fP للأدلة المستقلة. يمكن نفيه باستخدام
\f(CW\*(C`\-\-no\-generate\-setfilename\*(C'\fP. يُتجاهل إذا لم يكن
\f(CW\*(C`\-\-base\-level\*(C'\fP يساوي 0.
.IP \fB\-\-headings\-as\-sections\fP 4
.IX Item \-\-headings\-as\-sections
استخدام أوامر العناوين (\f(CW@heading\fP، ...) بدلاً من أوامر Texinfo @\-المرقمة
المبدئية (\f(CW@chapter\fP، \&\f(CW@section\fP، ...). أمر التقسيم الذي يغطي مخرجات
الملف بأكمله لكل ملف Pod إذا لم يكن \fB\-\-base\-level\fP يساوي 0 هو أمر مرقم.
.IP \fB\-\-help\fP 4
.IX Item \-\-help
عرض المساعدة والخروج.
.IP \fB\-\-menus\fP 4
.IX Item \-\-menus
إخراج قوائم العقد. إذا كان هناك دليل رئيس، فسيتم دائمًا إخراج قائمة عقدته
العليا، حيث يتم إنشاء قائمة رئيسية. لا يتم إخراج قوائم العقد الأخرى في
الحالة المبدئية.
.IP \fB\-\-outdir\fP=\fI\s-1NAME\s0\fP 4
.IX Item \-\-outdir=NAME
إذا كان هناك دليل رئيس مع ملفات تضمين (كل منها يقابل ملف Pod مدخل)، فسيتم
وضع ملفات Texinfo المُنشأة في الدليل \fI\s-1NAME\s0\fP.  المبدئي يعتمد على
\f(CW\*(C`\-\-subdir\*(C'\fP.
.IP \fB\-\-output\fP=\fI\s-1NAME\s0\fP 4
.IX Item \-\-output=NAME
اسم الدليل الأول، أو الدليل الرئيس إذا كان هناك دليل رئيس.  المبدئي هو
الكتابة إلى المخرج القياسي.
.IP \fB\-\-no\-section\-nodes\fP 4
.IX Item \-\-no\-section\-nodes
استخدام مراسي للأقسام بدلاً من العقد.
.IP \fB\-\-no\-fill\-section\-gaps\fP 4
.IX Item \-\-no\-fill\-section\-gaps
لا تملأ فجوات التقسيم بملفات \f(CW@unnumbered\fP فارغة.  عادةً، من الجيد الحفاظ
على التسلسل الهرمي للتقسيم سليمًا.
.IP \fB\-\-preamble\fP=\fI\s-1STR\s0\fP 4
.IX Item \-\-preamble=STR
إدراج \fI\s-1STR\s0\fP كنص قياسي علوي قبل القائمة والتضمينات.  إذا تم تعيين
\fI\s-1STR\s0\fP إلى \f(CW\*(C`\-\*(C'\fP, اقرأ النص القياسي العلوي من المدخل
القياسي.  النص القياسي العلوي المبدئي هو بداية بسيطة لوثيقة Texinfo.
.IP \fB\-\-setfilename\fP=\fI\s-1STR\s0\fP 4
.IX Item \-\-setfilename=STR
استخدام \fI\s-1STR\s0\fP في النص القياسي العلوي قبل القائمة والتضمينات لـ
\f(CW@setfilename\fP للدليل الرئيس، إذا لم يتم تعيين \f(CW\*(C`\-\-base\-level\*(C'\fP
إلى 0.  يتم تجاهله إذا كان \&\f(CW\*(C`\-\-base\-level\*(C'\fP هو 0.  لا يتم إخراج
\f(CW@setfilename\fP في الحالة المبدئية للدليل الرئيس.
.IP \fB\-\-subdir\fP=\fI\s-1NAME\s0\fP 4
.IX Item \-\-subdir=NAME
إذا كان هناك دليل رئيس مع ملفات تضمين (كل منها يقابل ملف Pod مدخل)، فسيتم
تضمين ملفات التضمين هذه من \fI\s-1NAME\s0\fP.
.Sp
إذا تم تعيين \f(CW\*(C`\-\-outdir\*(C'\fP، فيجب عمومًا تعيين \fI\s-1NAME\s0\fP إلى
الدليل النسبي بين الدليل الرئيس ووسيطة \f(CW\*(C`\-\-outdir\*(C'\fP.
.IP \fB\-\-unnumbered\-sections\fP 4
.IX Item \-\-unnumbered\-sections
استخدام أوامر تقسيم غير مرقمة (\f(CW@unnumbered\fP, ...) بدلاً من أوامر Texinfo
@\-commands للتقسيم المرقم المبدئية (\f(CW@chapter\fP, \&\f(CW@section\fP, ...).
.IP \fB\-\-top\fP=\fI\s-1TOP\s0\fP 4
.IX Item \-\-top=TOP
اسم عنصر \f(CW@top\fP للدليل الرئيس.  قد يحتوي على كود Texinfo.
.IP \fB\-\-version\fP 4
.IX Item \-\-version
يعرض معلومات الإصدار ويخرج
.SH "انظر أيضًا"
.IX Header "انظر أيضًا"
Pod::Simple::Texinfo.  perlpod.  دليل Texinfo.  الصفحة الرئيسية لـ Texinfo:
<https://www.gnu.org/software/texinfo/>
.SH "حقوق النشر والترخيص"
.IX Header "حقوق النشر والترخيص"
حقوق النشر 2012\-2026 مؤسسة البرمجيات الحرة، المحدودة.
.PP
هذا البرنامج هو برمجيات حرة؛ يمكنك إعادة توزيعه و/أو تعديله بموجب شروط رخصة
\s-1GNU\s0 العمومية العامة كما تنشرها مؤسسة البرمجيات الحرة؛ إما الإصدار 3
من الرخصة، أو (حسب اختيارك) أي إصدار لاحق.
.PP
لا يوجد \s-1أي ضمان،\s0 إلى الحد المسموح به قانونًا.
.SH المؤلف
.IX Header المؤلف
باتريس دوماس <bug\-texinfo@gnu.org>.
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .