الاسم¶

soelim - استيفاء متكرر لطلبات المصدر في ملفات roff أو ملفات نصية أخرى

موجز¶

الوصف¶

GNU soelim هو معالج مسبق لنظام تنسيق المستندات groff(7) يعمل soelim كمرشح لإزالة طلبات المصدر في ملفات إدخال roff(7) ؛ أي أنه يستبدل الأسطر من الشكل “.so ملف-مضمن” داخل كل ملف-إدخال نصي بمحتويات ملف-مضمن، بشكل متكرر. بشكل مبدئي، يكتب طلبات lf أيضًا لتسجيل اسم ورقم سطر كل ملف-إدخال وملف-مضمن، بحيث يمكن تتبع أي تشخيصات ينتجها المعالجة اللاحقة بدقة إلى الإدخال الأصلي. تسمح الخيارات بقمع هذه المعلومات (-r) أو توفيرها في تعليقات TeX بدلاً من ذلك (-t). في غياب وسائط ملف-إدخال، يقرأ soelim تيار الإدخال المعياري. يُكتب المخرَج إلى تيار الإخراج المعياري.

إذا كان اسم ملف-ماكرو يحتوي على شرطة مائلة عكسية، استخدم \\ أو \e لتضمينها. لتضمين مسافة، اكتب “\ ” (شرطة مائلة عكسية متبوعة بمسافة). أي تسلسل هروب آخر في ملف-ماكرو، بما في ذلك “\[rs]”، يمنع soelim من استبدال طلب المصدر.

يجب أن تكون النقطة في بداية سطر ويجب أن يتبعها “so” بدون مسافات أو علامات تبويب متداخلة ليعالجها soelim. تسمح هذه الاتفاقية بحماية طلبات المصدر من المعالجة بواسطة soelim، على سبيل المثال كجزء من تعريفات الماكرو أو طلبات “if”.

يجب أيضًا وجود مسافة واحدة على الأقل بين “so” ووسيط ملف-ماكرو الخاص به. يتجاوز الخيار -C هذا المطلب.

ما سبق هو حد فهم soelim للغة roff؛ فهو لا يستبدل، على سبيل المثال، سطر الإدخال

.if 1 .so otherfile

صُمم soelim للتعامل مع المواقف حيث يتطلب هدف طلب مصدر roff معالجًا مسبقًا مثل eqn(1), pic(1), refer(1), أو tbl(1). تسلسل المعالجة المعتاد لـ groff(1) هو كما يلي.

          input        sourced


          file          file


            ⎪             ⎪


            ↓             ↓


        preprocessor ⎯→ troff ⎯→ postprocessor


                                      ⎪


                                      ↓


                                   output


                                    file

أي أن الملفات المصدرة بـ “so” تُقرأ عادةً فقط بواسطة المنسق، troff. soelim ليس مطلوبًا لـ troff لاستيراد الملفات.

إذا كان يجب أيضًا معالجة ملف سَيُسْتَوْرَدُ مسبقًا، فيجب أن يُقْرَأَ قبل أن يمر ملف الإدخال عبر المعالج المسبق. يتولى soelim، الذي يُستدعى عادةً عبر خيار -s الخاص بـ groff، معالجة هذا.

          input


          file


            ⎪


            ↓


          soelim ⎯→ preprocessor ⎯→ troff ⎯→ postprocessor


            ↑                                     ⎪


            ⎪                                     ↓


         sourced                               output


          file                                  file

الخيارات¶

يعرض --help رسالة استخدام، بينما يعرض -v و--version معلومات الإصدارة؛ وتخرج جميعها بعد ذلك.

-C

تعرف على سطر إدخال يبدأ بـ .so حتى لو تبعه حرف غير مسافة أو سطر جديد.

-I دليل

ابحث في مسار الدليل dir عن ملفات-إدخال وملفات-مضمنة. يمكن تحديد -I أكثر من مرة؛ يُبحث كل dir بالترتيب المعطى. للبحث في دليل العمل الحالي قبل الآخرين، أضف “-I .” في المكان المطلوب؛ وإلا يُبحث عنه أخيرًا.

-r

اكتب الملفات “خام”؛ لا تُضف طلبات lf.

-t

أصدر سطور تعليقات TeX تبدأ بـ “%” تشير إلى الملف الحالي ورقم السطر، بدلاً من طلبات lf لنفس الغرض.

إذا أُعْطِيَ كل من -r و -t، فإن آخر واحد محدد يتحكم.

انظر أيضًا¶

groff(1)

ترجمة¶

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

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

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