الاسم

pg - تصفح الملفات النصية صفحة بصفحة

موجز

pg -*قيمة *-p المحث -cefnrs +line +/pattern/ file_ ...

الوصف

يعرض pg ملفًا نصيًا على الشاشة بمقدار ملء الشاشة في المرة الواحدة. يُعرض محث بعد كل صفحة. يمكن للمستخدم حينها إما الضغط على مفتاح سطر جديد لعرض الصفحة التالية أو أحد المفاتيح الموضحة أدناه.

إذا لم يُعطَ اسم ملف في سطر الأوامر، يقرأ pg من الدخل القياسي. إذا لم يكن الخرج القياسي طرفية، سيعمل pg مثل cat(1) ولكنه يسبق كل ملف باسمه إذا وُجد أكثر من ملف.

إذا جاء الدخل من أنبوب، يخزن pg البيانات في ملف وسيط أثناء القراءة لجعل التنقل ممكنًا.

الخيارات

يقبل pg الخيارات التالية:

+رقم

ابدأ عند رقم السطر المحدد.

+/pattern*/*

ابدأ عند السطر الذي يحتوي على نمط التعبير النمطي الأساسي (pattern) المعطى.

-رقم

عدد السطور في الصفحة الواحدة. القيمة المبدئية هي عدد سطور CRT ناقص واحد.

-c

امسح الشاشة قبل عرض الصفحة، إذا كانت مدخلة terminfo الخاصة بالطرفية توفر هذه الإمكانية.

-e

لا تتوقف مؤقتًا وتُظهر (EOF) عند نهاية الملف.

-f

لا يفصل السطور الطويلة.

-n

دون هذا الخيار، يجب إنهاء الأوامر بمحرف سطر جديد.

مع هذا الخيار، يتقدم pg بمجرد إدخال حرف الأمر.

-p سلسلة_محارف

بدلاً من محث : المعتاد، يُعرض سلسلة_محارف. إذا احتوى سلسلة_محارف على %d، يُستبدل أول ظهور له برقم الصفحة الحالية.

-r

امنع الهروب إلى الـ صدفة.

-s

اطبع الرسائل في وضع standout، إذا كان إدخال terminfo الخاص بالطرفية يوفر هذه القدرة.

-h، --help

اعرض نص المساعدة ثم اخرج.

-V، --version

اعرض الإصدار واخرج.

الأوامر

يمكن إدخال الأوامر التالية عند المحث. تقبل الأوامر المسبوقة بـ i في هذا المستند رقمًا كمعامل، سواء كان موجبًا أو سالبًا. إذا بدأ هذا المعامل بـ + أو -، فسيُفسّر بالنسبة إلى الموضع الحالي في ملف المدخلات، وإلا فسيُفسّر بالنسبة إلى البداية.

i<Enter>

اعرض الصفحة التالية أو الصفحة المحددة.

id أو ^D

اعرض نصف الصفحة التالي. إذا أُعطي i، فسيُفسّر دائمًا بالنسبة للموضع الحالي.

il

اعرض السطر التالي أو السطر المحدد.

if

تخطّ صفحة للأمام. يجب أن يكون i رقمًا موجبًا ويُفسّر دائمًا بالنسبة للموضع الحالي.

iw أو iz

مثل <Enter> باستثناء أن i يصبح حجم الصفحة الجديد.

. أو ^L

أعد رسم الشاشة.

$

تقدم إلى السطر الأخير من ملف المدخلات.

i/pattern/

ابحث للأمام حتى يُعثر على التكرار الأول أو التكرار رقم i للـ pattern الخاص بالتعبير النمطي الأساسي. يبدأ البحث بعد الصفحة الحالية ويتوقف عند نهاية الملف. لا يجرى التواء (wrap-around). يجب أن يكون i رقمًا موجبًا.

i?pattern? أو ipattern

ابحث للخلف حتى يُعثر على التكرار الأول أو التكرار رقم i للـ pattern الخاص بالتعبير النمطي الأساسي. يبدأ البحث قبل الصفحة الحالية ويتوقف عند بداية الملف. لا يجرى التواء (wrap-around). يجب أن يكون i رقمًا موجبًا.

تقبل أوامر البحث حرفًا مضافًا. إذا أُعطي t، فسيُعرض السطر الذي يحتوي على النمط في أعلى الشاشة، وهو الوضع الـ مبدئي. يختار m وسط الشاشة و b أسفلها. يُستخدم الموضع المختار في عمليات البحث اللاحقة أيضًا.

in

تقدم إلى الملف التالي أو بمقدار i من الملفات للأمام.

ip

أعد قراءة الملف السابق أو بمقدار i من الملفات للخلف.

s اسم_ملف

احفظ الملف الحالي في الـ اسم_ملف المعطى.

h

اعرض ملخصًا للأوامر.

!أمر

نفّذ الـ أمر باستخدام الـ صدفة.

q أو Q

اخرج.

إذا ضغط المستخدم على مفتاح المقاطعة أو الخروج بينما يقرأ pg من ملف المدخلات أو يكتب على الطرفية، فسيقوم pg فورًا بعرض المحث. في جميع الحالات الأخرى، ستنهي هذه المفاتيح عمل pg.

البيئة

تؤثر متغيرات البيئة التالية على سلوك pg:

COLUMNS

يتجاوز عدد الأعمدة المزود من النظام إذا ضُبط.

LANG، LC_ALL، LC_COLLATE، LC_CTYPE، LC_MESSAGES

انظر locale(7).

LINES

يتجاوز عدد الأسطر المزود من النظام إذا ضُبط.

SHELL

يُستخدم بواسطة الأمر !.

TERM

يحدد نوع الطرفية.

ملاحظات

يتوقع pg أن تُضبط جدولة الطرفية كل ثمانية مواضع.

لا يمكن لـ pg عرض الملفات التي تتضمن محارف NUL.

انظر أيضاً

cat(1)، more(1)، sh(1p)، terminfo(5)، locale(7)، regex(7)، term(7)

التبليغ عن الأخطاء

لتقارير العِلل، استخدم مُتتبع المشكلات https://github.com/util-linux/util-linux/issues.

التوفر

الأمر pg جزء من حزمة util-linux التي يمكن تنزيلها من أرشيف نواة لينكس https://www.kernel.org/pub/linux/utils/util-linux/.