.\" -*- coding: UTF-8 -*-
'\" p
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH \%soelim 1 "15 مارس 2026" "groff 1.24.1" 
.SH الاسم
\%soelim \- استيفاء متكرر لطلبات المصدر في ملفات \fIroff\fP أو ملفات نصية أخرى
.
.
.\" ====================================================================
.\" Legal Terms
.\" ====================================================================
.\"
.\" Copyright (C) 1989-2024 Free Software Foundation, Inc.
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of
.\" this manual under the conditions for verbatim copying, provided that
.\" the entire resulting derived work is distributed under the terms of
.\" a permission notice identical to this one.
.\"
.\" Permission is granted to copy and distribute translations of this
.\" manual into another language, under the above conditions for
.\" modified versions, except that this permission notice may be
.\" included in translations approved by the Free Software Foundation
.\" instead of in the original English.
.
.
.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr *groff_soelim_1_man_C \n[.cp]
.cp 0
.
.\" Define fallback for groff 1.23's MR macro if the system lacks it.
.nr do-fallback 0
.if  !\n(.f           .nr do-fallback 1 \" mandoc
.if   \n(.g .if !d MR .nr do-fallback 1 \" older groff
.if  !\n(.g           .nr do-fallback 1 \" non-groff *roff
.if  \n[do-fallback]  \{\
.  de MR
.    ie \\n(.$=1 \
.      I \%\\$1
.    el \
.      IR \%\\$1 (\\$2)\\$3
.  .
.\}
.rr do-fallback
.\" Man pages are seldom preprocessed with pic(1).
.mso pic.tmac
.
.
.\" ====================================================================
.\" Definitions
.\" ====================================================================
.
.ie  t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
.el   .ds tx TeX
.
.
.\" ====================================================================
.SH موجز
.\" ====================================================================
.
.SY \%soelim
[\fB\-Crt\fP] [\fB\-I\fP \fIdir\fP] [\fIملف_إدخال\ \fP.\|.\|.]
.YS
.
.
.P
.SY \%soelim
\fB\-\-help\fP
.YS
.
.
.P
.SY \%soelim
\fB\-v\fP
.YS
.
.SY \%soelim
\fB\%\-\-version\fP
.YS
.
.
.\" ====================================================================
.SH الوصف
.\" ====================================================================
.
.\" GNU
GNU \fIsoelim\fP هو معالج مسبق لنظام تنسيق المستندات
.MR groff 7
.
.
\fI\%soelim\fP يلغي طلبات المصدر في
.MR roff 7
وملفات نصية أخرى؛ أي يستبدل
الأسطر من الشكل \[lq]\fB.so\fP \fIملف\-مضمن\fP\[rq] داخل كل \fIملف\-إدخال\fP نصي
بمحتويات \fIملف\-مضمن\fP بشكل تكراري، مسطحاً شجرة من المستندات.
.
بشكل مبدئي، يكتب طلبات \fIroff\fP \fBlf\fP أيضًا لتسجيل اسم ورقم سطر كل
\fIملف\-إدخال\fP و\fIملف\-مضمن\fP، بحيث يمكن تتبع أي تشخيصات ينتجها المعالجة اللاحقة
بدقة إلى الإدخال الأصلي.
.
تسمح الخيارات بقمع هذه المعلومات (\fB\-r\fP) أو توفيرها في تعليقات \*[tx] بدلاً
من ذلك (\fB\-t\fP).
.
في غياب وسائط \fIملف\-إدخال\fP، يقرأ \fI\%soelim\fP تيار الإدخال المعياري.
.
يكتب البرنامج إلى تيار الإخراج القياسي.
.
.
.PP
.\" GNU
يقرأ \fI\%soelim\fP وسيطة \fIملف\-مضمن\fP كما يفعل GNU \fItroff\fP.
.
يتجاهل المسافات مباشرة بعد \[lq]so\[rq]; لتضمين تسلسل من مسافة أو أكثر بادئة
في الوسيطة، اسبق التسلسل بعلامة اقتباس مزدوجة محايدة (\fB\[dq]\fP).
.
تُفسر المسافات غير البادئة حرفياً.
.
.\" GNU
شرطة مائلة عكسية متبوعة بمسافة (\[lq]\fB\[rs]\ \fP\[rq]) ترمز أيضًا لمسافة،
للتوافق مع إصدارات أقدم من GNU \fIsoelim\fP.
.
إذا تطلب اسم الملف المضمن شرطة مائلة عكسية، استخدم \fB\[rs]\[rs]\fP أو
\fB\[rs]e\fP لتضمينها.
.
أي تسلسل هروب آخر في \fIملف\-مضمن\fP، بما في ذلك \[lq]\fB\[rs][rs]\fP\[rq]، يمنع
\fI\%soelim\fP من استبدال طلب المصدر.
.
إصدارات AT&T والسليلة من \fIsoelim\fP لا تملك وسيلة لتضمين مسافات في أسماء
الملفات؛ تستبدل أول مسافة تصادفها بسطر جديد وتتوقف عن تفسير الطلب.
.
.
.PP
يجب أن تكون النقطة في بداية سطر ويجب أن يتبعها \[lq]\fBso\fP\[rq] بدون مسافات
أو علامات تبويب متداخلة ليعالجها \fI\%soelim\fP.
.
يسمح هذا الاصطلاح لطلبات المصدر بأن تكون \[lq]محمية\[rq] من المعالجة بواسطة
\fI\%soelim\fP، مثلاً كجزء من تعريفات الماكرو أو طلبات \[lq]\fBif\fP\^\[rq].
.
.
.PP
يجب أيضًا وجود مسافة واحدة على الأقل بين \[lq]\fBso\fP\[rq] ووسيطتها
\fIملف\-مضمن\fP.
.
يتجاوز الخيار \fB\-C\fP هذا المطلب.
.
.
.PP
ما سبق هو حد فهم \fI\%soelim\fP للغة \fIroff\fP؛ فهو لا يستبدل، على سبيل المثال،
سطر الإدخال
.
.RS
.EX
\&.if 1 .so otherfile
.EE
.RE
.
بمحتويات \fIotherfile\fP.
.
مع خيارها \fB\-r\fP، لذلك، يمكن استخدام \fI\%soelim\fP لمعالجة الملفات النصية بشكل
عام.
.
.
.PP
.\" generic
.\" generic
صُمم \fIsoelim\fP للتعامل مع المواقف حيث يتطلب هدف طلب مصدر \fIroff\fP معالجًا
مسبقًا مثل
.MR \%eqn 1 ,
.MR \%pic 1 ,
.MR \%refer 1 ,
أو
.MR \%tbl 1 .
.
تسلسل المعالجة المعتاد لـ
.MR groff 1
هو كما يلي.
.
.if  !'\%'\%' \{\
In the diagrams below,
the traditional names for
.I soelim
and
.I troff
are used;
on this system,
the GNU versions are installed as
.I \%soelim
and
.IR \%troff .
.\}
.\" Does this groff installation use a command prefix?  In installed
.\" pages, this comparison will not look like it needs to be dynamically
.\" decided.
.\"
.\" This is done so that the box sizes (in the pic(1) diagram) and arrow
.\" alignments (in the text alternative) can remain fixed.
.
.
.PP
.ie  t \{\
.PS
.ps 10
.vs 12
box invisible width 0.5 height 0.4 "input" "file";
move to last box .bottom;
down;
arrow 0.3;
box invisible width 0.8 height 0.2 "preprocessor";
move to last box .right
right;
arrow 0.3;
A: box invisible width 0.35 height 0.2 "troff";
move to last box .top;
up;
move 0.3;
box invisible width 0.6 height 0.4 "sourced" "file";
line <- up 0.3 from A.top;
move to A.right;
right;
arrow 0.3;
box invisible width 0.85 height 0.2 "postprocessor";
move to last box .bottom;
down;
arrow 0.3;
box invisible width 0.5 height 0.4 "output" "file"
.ps
.vs
.PE
.\}
.el \{\
.EX
          input        sourced
          file          file
            \[bv]             \[bv]
            \[da]             \[da]
        preprocessor \[an]\[->] troff \[an]\[->] postprocessor
                                      \[bv]
                                      \[da]
                                   output
                                    file
.EE
.\}
.PP
أي، الملفات المصدرة بـ \[lq]\fBso\fP\[rq] تُقرأ عادة \fIفقط\fP بواسطة المنسق،
.MR \%troff 1 .
.
\fI\%soelim\fP \fIليس\fP مطلوبًا لـ \fI\%troff\fP لاستيراد الملفات.
.
.
.br
.ne 2v
.P
إذا كان ملف سيتم مصدره يجب أيضًا معالجته مسبقاً، يجب أن يُقرأ \fIقبل\fP أن يمر
الإدخال عبر المعالج المسبق.
.
يتولى \fI\%soelim\fP، الذي يُستدعى عادةً عبر خيار \fB\-s\fP الخاص بـ \fIgroff\fP،
معالجة هذا.
.
.
.PP
.ie  t \{\
.PS
.ps 10
.vs 12
box invisible width 0.5 height 0.4 "input" "file";
move to last box .bottom;
down;
arrow 0.3;
A: box invisible width 0.5 height 0.2 "soelim";
line <- 0.3;
box invisible width 0.5 height 0.4 "sourced" "file";
move to A.right;
right;
arrow 0.3;
box invisible width 0.8 height 0.2 "preprocessor";
arrow 0.3;
box invisible width 0.35 height 0.2 "troff";
arrow 0.3
box invisible width 0.85 height 0.2 "postprocessor";
move to last box .bottom;
down;
arrow 0.3;
box invisible width 0.5 height 0.4 "output" "file"
.ps
.vs
.PE
.\}
.el \{\
.EX
          input
          file
            \[bv]
            \[da]
          soelim \[an]\[->] preprocessor \[an]\[->] troff \[an]\[->] \
postprocessor
            \[ua]                                     \[bv]
            \[bv]                                     \[da]
         sourced                               output
          file                                  file
.EE
.\}
.
.
.\" ====================================================================
.SH الخيارات
.\" ====================================================================
.
يعرض \fB\-\-help\fP رسالة الاستخدام، بينما يعرض \fB\-v\fP و \fB\%\-\-version\fP معلومات
الإصدار؛ ويخرج الجميع بعد ذلك.
.
.
.\" "-I dir" + 2n
.TP  8n 
\fB\-C\fP
تعرف على سطر إدخال يبدأ بـ \fB.so\fP حتى لو تبعه حرف غير مسافة أو سطر جديد.
.
.TP 
\fB\-I\ \fP\fIدليل\fP
ابحث في الدليل \fIدليل\fP عن \fIملفات\-إدخال\-\fP و\fIملفات\-مضمنة.\fP
.
إذا حُدد أكثر من مرة، يُبحث كل \fIدليل\fP بالترتيب المعطى.
.
للبحث في دليل العمل الحالي قبل الآخرين، أضف \[lq]\fB\-I .\&\fP\[rq] في المكان
المطلوب؛ وإلا يُبحث عنه أخيرًا.
.
.
.TP 
\fB\-r\fP
اكتب الملفات \[lq]خام\[rq]؛ لا تُضف طلبات \fBlf\fP.
.
.
.TP 
\fB\-t\fP
أصدر سطور تعليقات \*[tx] تبدأ بـ \[lq]\fB%\fP\[rq] تشير إلى الملف الحالي ورقم
السطر، بدلاً من طلبات \fBlf\fP لنفس الغرض.
.
.
.PP
إذا أُعْطِيَ كل من \fB\-r\fP و \fB\-t\fP، فإن آخر واحد محدد يتحكم.
.
.
.\" ====================================================================
.SH "حالة الخروج"
.\" ====================================================================
.
يخرج \fI\%soelim\fP بحالة\ \fB0\fP عند التشغيل الناجح، وحالة\ \fB2\fP إذا لم يستطع
البرنامج تفسير وسيطات سطر الأوامر، وحالة\ \fB1\fP إذا واجه خطأ أثناء التشغيل.
.
.
.\" ====================================================================
.SH "انظر أيضًا"
.\" ====================================================================
.
.MR groff 1
.
.
.\" Clean up.
.rm tx
.
.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[*groff_soelim_1_man_C]
.do rr *groff_soelim_1_man_C
.
.
.\" Local Variables:
.\" fill-column: 72
.\" mode: nroff
.\" End:
.\" vim: set filetype=groff textwidth=72:
.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 .