table of contents
- trixie-backports 4.31.0-1~bpo13+1
- testing 4.31.0-1
- unstable 4.31.0-1
| nroff(1) | General Commands Manual | nroff(1) |
الاسم¶
nroff - تنسيق المستندات باستخدام groff لأجهزة الطرفية (“TTY”)
موجز¶
nroff |
[-abcCEhikpRStUVzZ] [-d ctext] [-d string=text] [-D fallback-input-encoding] [-I inclusion-directory] [-K input-encoding] [-m macro-package] [-M macro-directory] [-n page-number] [-o page-list] [-P postprocessor-argument] [-r cnumeric-expression] [-r register=numeric-expression] [-T output-device] [-w warning-category] [-W warning-category] [file ...] |
nroff |
--help |
nroff |
-v [other-nroff-option ...] |
nroff |
--version [other-nroff-option ...] |
الوصف¶
nroff ينسق المستندات المكتوبة بلغة groff(7) لأجهزة تشبه الآلة الكاتبة مثل محاكيات الطرفية. GNU nroff يحاكي أمر AT&T nroff باستخدام groff(1). nroff يولد المخرجات عبر grotty(1), برنامج تشغيل مخرجات الطرفية لـ groff، والذي يحتاج إلى معرفة مخطط ترميز الأحرف المستخدم من قبل الجهاز. وبالتالي، الوسائط المقبولة للخيار -T هي ascii و latin1 و utf8؛ أي وسائط أخرى يتم تجاهلها. إذا لم يحدد متغير البيئة GROFF_TYPESETTER ولا خيار سطر الأوامر -T (الذي يتجاوز متغير البيئة) جهازًا (صالحًا)، فإن nroff يرجع إلى الإعدادات المحلية لاختيار جهاز مخرجات مناسب. يحاول أولاً برنامج locale(1) ، ثم يفحص عدة متغيرات بيئة متعلقة بالإعدادات المحلية؛ انظر القسم “Environment” أدناه. إذا فشل كل ما سبق، يفترض nroff “-T ascii”.
الخيارات -a و -b و -c و -C و -d و -E و -i و -I و -m و -M و -n و -o و -r و -U و -w و -W و -z لها التأثيرات الموصوفة في troff(1). -c و -h يعنيان “-P -c” و “-P -h” على التوالي؛ -c له معنى أيضًا لـ troff نفسه. علاوة على ذلك، GNU nroff يتجاهل خيارات AT&T nroff -e و -q و -s. groff(1) يوثق الخيارات -D و -k و -K و -p و -P و -R و -t و -S و -Z. -V يتسبب في عرض nroff لأمر groff المُنشأ على تيار المخرجات القياسي، لكنه لا ينفذه. -v و --version يعرضان معلومات الإصدار عن nroff والبرامج التي يشغلها، بينما --help يعرض رسالة استخدام؛ جميعها تخرج بعد ذلك.
حالة الخروج¶
nroff يخرج بحالة 2 إذا كانت هناك مشكلة في تحليل وسائطه، وبحالة 0 إذا تم تحديد أي من الخيارات -V أو -v أو --version أو --help، وبحالة groff بخلاف ذلك.
البيئة¶
عادةً ما يكون فاصل المسارات في متغيرات البيئة التي تنتهي بـ PATH هو النقطتان الرأسيتان؛ وقد يختلف هذا حسب نظام التشغيل. على سبيل المثال، يستخدم ويندوز الفاصلة المنقوطة بدلاً من ذلك.
- GROFF_BIN_PATH
- تحديد موقع أوامر groff في هذه الأدلة، تليها تلك الموجودة في PATH. إذا لم يكن مضبوطا، يُبْحَث في دليل تثبيت ملفات GNU roff التنفيذية، /usr/bin، قبل PATH.
- GROFF_TYPESETTER
- يحدد جهاز المخرجات المبدئي لـ groff.
- LC_ALL
- LC_CTYPE
- LANG
- LESSCHARSET
- تتم مطابقة النمط بهذا الترتيب للمحتويات المطابقة لترميزات الأحرف القياسية المدعومة من groff في حالة عدم إعطاء خيار -T وعدم تعيين GROFF_TYPESETTER، أو إذا كانت القيم المحددة غير صالحة.
الملفات¶
- /usr/share/groff/1.24.1/tmac/tty-char.tmac
- يعرف تعريفات احتياطية للأحرف الخاصة لـ roff. هذه التعريفات تقارب بصريًا مخرجات التنضيد بشكل أضعف من تلك الموجودة في tty.tmac لصالح نقل المعلومات الدلالية. nroff يحمله آليًا.
ملاحظات¶
برامج التصفح مثل more(1) و less(1) قد تتطلب خيارات سطر أوامر لمعالجة بعض تسلسلات المخرجات بشكل صحيح؛ انظر grotty(1).
انظر أيضًا¶
ترجمة¶
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>
هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.
| 22 أبريل 2026 | groff 1.24.1 |