Scroll to navigation

nroff(1) General Commands Manual nroff(1)

الاسم

nroff - تنسيق المستندات باستخدام groff لأجهزة TTY (الطرفية)

موجز

nroff [-bcCEhikpRStUVz] [-d نص-مخصص] [-d سلسلة=نص] [-K ترميز-احتياطي] [-m حزمة-ماكرو] [-M دليل-ماكرو] [-n رقم-صفحة] [-o قائمة-صفحات] [-P وسيطة-معالج-لاحق] [-r تعبير-رقمي-مخصص] [-r مسجل=تعبير-رقمي] [-T جهاز-خرج] [-w فئة-تحذير] [-W فئة-تحذير] [ملف ...]
nroff --help
nroff -v
nroff --version

الوصف

nroff ينسق المستندات المكتوبة بلغة groff(7) لأجهزة تشبه الآلة الكاتبة مثل محاكيات الطرفية. GNU nroff يحاكي أمر AT&T nroff باستخدام groff(1). nroff يولد المخرجات عبر grotty(1), برنامج تشغيل مخرجات الطرفية لـ groff، والذي يحتاج إلى معرفة مخطط ترميز الأحرف المستخدم من قبل الجهاز. وبالتالي، الوسائط المقبولة للخيار -T هي ascii وlatin1 وutf8 وcp1047؛ أي وسائط أخرى تُتجاهل. إذا لم يحدد متغير البيئة GROFF_TYPESETTER ولا خيار سطر الأوامر -T (الذي يتجاوز متغير البيئة) جهازًا (صالحًا)، فإن nroff يرجع إلى الإعدادات المحلية لاختيار جهاز مخرجات مناسب. يحاول أولاً برنامج locale(1) ، ثم يفحص عدة متغيرات بيئة متعلقة بالإعدادات المحلية؛ انظر القسم “Environment” أدناه. إذا فشل كل ما سبق، يُفترض -Tascii.

الخيارات -b و-c و-C و-d و-E و-i و-m و-M و-n و-o و-r و-U و-w و-W و-z لها التأثيرات الموصوفة في troff(1). -c و-h يَستلزمان “-P-c” و“-P-h” على التوالي؛ -c يُفسر أيضًا مباشرة بواسطة troff. بالإضافة إلى ذلك، هذا التنفيذ يتجاهل خيارات AT&T nroff -e و-q و-s (التي لم تُنفذ في groff). الخيارات -k و-K و-p و-P و-R و-t و-S موثقة في groff(1). -V يتسبب في عرض nroff لأمر groff المُنشأ على تيار المخرجات القياسي، لكنه لا ينفذه. -v و--version يُظهران معلومات الإصدار عن nroff والبرامج التي يشغلها، بينما --help يعرض رسالة استخدام؛ جميعها تخرج بعد ذلك.

حالة الخروج

nroff يخرج بحالة خطأ 2 إذا كانت هناك مشكلة في تحليل وسائطه، بحالة 0 إذا تم تحديد أي من الخيارات -V أو -v أو --version أو --help، وبحالة groff فيما عدا ذلك.

البيئة

عادةً ما يكون فاصل المسارات في متغيرات البيئة التي تنتهي بـ PATH هو النقطتان الرأسيتان؛ وقد يختلف هذا حسب نظام التشغيل. على سبيل المثال، يستخدم ويندوز الفاصلة المنقوطة بدلاً من ذلك.

هي قائمة مفصولة بنقطتين من الأدلة التي يُبحث فيها عن الملف التنفيذي groff قبل البحث في PATH. إذا لم يُضبط، يُستخدم /usr/bin.
يحدد جهاز المخرجات المبدئي لـ groff.
تتم مطابقة النمط بهذا الترتيب للمحتويات المطابقة لترميزات الأحرف القياسية المدعومة من groff في حالة عدم إعطاء خيار -T وعدم تعيين GROFF_TYPESETTER، أو إذا كانت القيم المحددة غير صالحة.

الملفات

/usr/share/groff/1.23.0/tmac/tty-char.tmac
يعرف تعريفات احتياطية للأحرف الخاصة لـ roff. هذه التعريفات تقارب بصريًا مخرجات التنضيد بشكل أضعف من تلك الموجودة في tty.tmac لصالح نقل المعلومات الدلالية. nroff يحمله آليًا.

ملاحظات

برامج التصفح مثل more(1) و less(1) قد تتطلب خيارات سطر أوامر لمعالجة بعض تسلسلات المخرجات بشكل صحيح؛ انظر grotty(1).

انظر أيضًا

groff(1), troff(1), grotty(1), locale(1), roff(7)

ترجمة

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

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

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

2 مارس 2026 groff 1.23.0