.\" -*- coding: UTF-8 -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH LESSPIPE.SH 1 "أبريل 2026" lesspipe.sh "أوامر المستخدم" .SH الاسم lesspipe.sh \- مرشح لـ less .SH موجز \fBlesspipe.sh\fP [\fIملف[ات]\fP]... .SH الوصف .PP الهدف من \fBlesspipe.sh\fP هو تحسين مخرجات \fBless\fP. يعتمد اختيار القواعد المطبقة لتعديل المخرجات على محتويات الملف. يُراعى امتداد الملف فقط كملاذ أخير. عادةً يُستدعى \fBlesspipe.sh\fP كمرشح إدخال لـ \fBless\fP. .PP بمساعدة هذا المرشح، يعرض \fBless\fP المحتويات غير المضغوطة للملفات المضغوطة (\fIgzip, bzip2, compress, zstd, lz4, lzip, xz, lzma, zlib أو brotli\fP). للملفات التي تحتوي على أرشيفات وأدلة، يُعرض جدول محتويات (\fItar, ar, zip, 7\-zip, rar, jar, cpio, rpm, deb ms\-cabinet, iso, dmg, appimage وصيغ snap\fP). تُعاد تنسيق العديد من الملفات الأخرى للعرض. يتضمن ذلك صيغ \fIpdf, dvi, markdown, Office (MS و Openoffice)\fP، وصيغ \fINetCDF, matlab, device tree blob, html, xml\fP وصيغ \fIالوسائط (صورة، صوت وفيديو)\fP. يتطلب هذا تثبيت برامج مساعدة. .PP يمكن أيضًا تطبيق المرشح بشكل متكرر لاستخراج وعرض الملفات في الأرشيفات أثناء التشغيل. يعمل هذا حتى عمق 6 حيث يُعتبر تطبيق خوارزمية فك الضغط مستوى منفصلًا. .PP إذا أبلغت أداة الملف عن نص بترميز مختلف عن المستخدم في الطرفية، يُحول النص باستخدام \fIiconv\fP إلى الترميز المبدئي. يفترض هذا أن أمر \fIfile\fP يحصل على ترميز الملف بشكل صحيح، وهو ما قد يكون خاطئًا في بعض الحالات. يؤدي إلحاق نقطتين باسم الملف إلى منع التحويل. .PP عند استخدام البرامج \fBgit\fP أو \fBvim\fP أو \fBmutt\fP، يمكن تمكينها لقراءة الملفات غير النصية باستخدام lesspipe.sh. هذا موصوف في الويكي على \fIhttps://github.com/wofr06/lesspipe/wiki\fP. .SH "تفعيل المرشح" يُستدعى المرشح من \fBless\fP بشرط ضبط المتغير البيئي \fBLESSOPEN\fP بشكل صحيح. للأصداف المشابهة لـ ksh (\fIbash, zsh\fP)، الأمر .RS \fILESSOPEN="|lesspipe.sh %s"; export LESSOPEN\fP .RE يفعل المرشح لـ less. استخدم المسار الكامل إذا لم يكن \fBlesspipe.sh\fP في مسار البحث. يمكن أيضًا عرض الأمر لضبط \fBLESSOPEN\fP باستدعاء \fBlesspipe.sh\fP بدون وسائط. يمكن استخدام هذا حتى لضبط \fBLESSOPEN\fP مباشرة: .EX .RS \fIeval `lesspipe.sh`\fP (bash) or \fIlesspipe.sh|source /dev/stdin\fP (zsh) .RE .EE تعمل الأوامر أعلاه فقط بالطريقة الموصوفة إذا كان اسم الملف هو \fBlesspipe.sh\fP. إذا تم تثبيته باسم مختلف، فإن استدعاءه بدون وسيطة يعمل كمرشح مع ضبط \fBLESSQUIET\fP وتوقع إدخال من STDIN. .PP بعد ضبط المتغير البيئي كما هو موصوف أعلاه، يعرض \fBless\fP معلومات نصية لمجموعة واسعة من صيغ الملفات. .PP لا يُستدعى المرشح عادةً إذا تم توجيه الإدخال إلى less كما في .RS \fIcat somefile | less\fP .RE كما هو موصوف في دليل less، يمكن فرض الترشيح في أنبوب ببدء \fBLESSOPEN\fP بالأحرف \fI|\-\fP. .PP إذا فشلت الأوامر داخل \fBlesspipe.sh\fP، في بعض الحالات تُعرض رسائل الخطأ، هذا يُعتبر سلوكًا معيبًا ويجب الإبلاغ عنه. .PP لقمع الرسائل غير الرسمية في السطر الأول من مخرجات المرشح، يمكن ضبط المتغير البيئي \fBLESSQUIET\fP إلى قيمة غير فارغة. .PP لفصل المرشح مؤقتًا، يمكن إلحاق نقطتين باسم الملف. إذا كان اسم الملف يحتوي على نقطتين، فيجب استخدام علامة يساوي بدلاً من ذلك. .SH "ملفات HTML و XML و Perl POD" تُعرض الملفات بصيغة \fIhtml\fP و \fIperl pod\fP دائمًا. لكن في بعض الأحيان يجب عرض المحتويات الأصلية للملف بدلاً من ذلك. كما ذُكر سابقًا، يمكن تحقيق ذلك بإلحاق نقطتين باسم الملف. إذا تبعه نوع الملف الصحيح (\fIhtml\fP، \fIpod\fP)، يمكن تلوين المخرجات (انظر أيضًا القسم أدناه). .PP .RS مثال: \fBless\fP \fIindex.html:html\fP .RE .PP إذا تم تثبيت الثنائي \fIxmq\fP، يُعرض \fIxml\fP بشكل مختلف، بحيث يُتعرف على بنية xml بشكل أفضل. يُحقق عرض مماثل لمحتويات \fIhtml\fP باستخدام \fIxmq\fP بإلحاق نقطتين باسم الملف. للحصول على محتويات ملف html الأصلية، يلزم نقطتان في هذه الحالة. .SH "تلوين المخرجات" المرشح قادر على إجراء تمييز نحوي لمجموعة واسعة من أنواع الملفات. إذا تم تثبيته، يُستخدم \fInvimpager\fP لتلوين المخرجات. إذا لم يكن، تُجرب \fIbat\fP/\fIbatcat\fP و \fIpygmentize\fP و \fIe2ansi\-cat\fP و \fIsource\-highlight\fP و \fIvimcolor\fP و \fIcode2color\fP بدورها. لـ bat/batcat، يُضبط السمة إلى \fIansi\fP والنمط إلى \fIplain\fP الذي يقترب من المخرجات غير المرشحة لـ \fBless\fP. يمكن تغيير هذه الإعدادات في \fI~/.config/bat/config\fP أو بواسطة المتغيرات البيئية \fBBAT_STYLE\fP و \fBBAT_THEME\fP. .PP يمكن تلوين محتويات ملفات السجل إذا تم تثبيت برنامج \fItspin\fP وتم إلحاق السلسلة ":log" باسم الملف أو كان امتداد الملف هو "log". .PP بين الملونات، يمكن فرض مفضل للتلوين بضبط المتغير البيئي \fBLESSCOLORIZER\fP إلى اسم الملون. لـ \fIpygmentize\fP و \fIbat\fP/\fIbatcat\fP، يُسمح بإعدادات خيارات مقيدة كما يلي: .EX .RS \fILESSCOLORIZER='pygmentize \-O style=foo' # \-P allowed as well\fP \fILESSCOLORIZER='bat \-\-style=foo \-\-theme=bar' # default: theme=ansi, style=plain\fP .RE .EE يُفعّل تظليل الصياغة إذا وُجد متغير البيئة \fBLESS\fP واحتوى على الخيار \fI\-R\fP أو استُدعي less بهذا الخيار. يضمن هذا تحويل تسلسلات الهروب إلى ألوان دون تشويه العرض. لا يُوصى باستخدام الخيار \fI\-r\fP، لأن تخطيط الشاشة قد يكون خاطئًا إذا وُجدت أسطر طويلة في المخرجات. .PP يمكن إيقاف تظليل الصياغة بإلحاق نقطتين بعد اسم الملف، إذا كانت المخرجات ملونة. إذا اختيرت لغة خاطئة لتظليل الصياغة، فيمكن فرض لغة أخرى بإلحاق نقطتين ولاحقة باسم الملف. يمكن طباعة قائمة اللواحق واللغات المدعومة باستخدام أوامر الملون التالية: .EX .RS \fIbat \-\-list\-languages\fP \fIbatcat \-\-list\-languages\fP \fIpygmentize \-L lexers\fP \fIM\-x \-mode [TAB] within emacs\fP \fIsource\-highlight \-\-lang\-list\fP \fIcode2color \-h\fP \fIvimcolor \-L (both for vimcolor and nvimpager)\fP .RE .EE .PP في أنبوب لا يمكن استخدام تلك الطريقة. كمخرج يمكن إضافة وسيطة أخيرة تُفحص بواسطة \fBlesspipe.sh\fP. نقطتان مفردة (إلغاء المرشح) أو :extension (فرض لغة) ممكنة كما في مثال .RS \fIcommand that generates c code | less \- :c\fP .RE .PP عند استيفاء شروط تظليل الصياغة، تُلون قوائم الدلائل وقوائم محتويات ملفات tar أيضًا. .PP بما أن \fBless\fP يُستخدم كمتصفح مبدئي في برامج أخرى (مثل \fIman\fP و\fIgit\fP و\fIperldoc\fP) فقد يُشرك \fBlesspipe.sh\fP ويُغير مخرجات تلك البرامج. .SH "مراقبة الملفات المتنامية" قد تُفقد القدرة على مراقبة الملفات المتنامية (المطلوبة عادة لملفات السجل مثل syslog) (باستخدام أمر F داخل less أو استدعاء less بالخيار +F) إذا خزّن \fBlesspipe.sh\fP الإدخال في ملف مؤقت لمزيد من المعالجة. يمكن إصلاح ذلك بإضافة نقطتين كوسيطة أخيرة لـ \fBless\fP مثل .RS \fBless\fP\fI /var/log/syslog :\fP .RE أو إذا بدأ LESSOPEN بـ |\- واستُدعي less في أنبوب .RS \fBcat\fP\fI /var/log/syslog | less +F \- :\fP .RE .SH "استخدام متقدم" تسمح لك هذه النسخة من \fBlesspipe.sh\fP بعرض ملفات فردية محتواة في أرشيف ملفات، والذي قد يكون هو نفسه محتوى في أرشيف آخر. .PP الترميز لعرض الملفات في أرشيفات متعددة الملفات هو .RS \fBless\fP \fIarchive_file\fP:\fIcontained_file\fP .RE أو حتى .RS \fBless\fP \fIsuper_archive\fP:\fIarchive_file\fP:\fIcontained_file\fP .RE لعرض آخر ملف في السلسلة بصيغة خام، يجب إلحاق نقطتين (\fI:\fP) باسم الملف. إذا احتوى على نقطتين، فيجب استخدام حرف الفاصل البديل علامة المساواة (\fI=\fP). .PP مرة أخرى، لا تعمل هذه الطريقة لاستخراج وعرض الملفات إذا استُدعي \fBless\fP في أنبوب مخرجات وبدأ \fBLESSOPEN\fP بالحرفين \fB|\-\fP. كما هو الحال مع تظليل الصياغة، الحل هو استخدام وسيطة ثانية تبدأ بنقطتين. عندها يُكتب الأمر أعلاه كالتالي .RS \fBcat \fP\fIsuper_archive\fP\fB | less \- :\fP\fIarchive\fP\fB:\fP\fIcontained_file\fP .RE .PP .SH "آلية الإكمال لمحتويات الأرشيف" باستخدام ملف \fIlesscomplete\fP المقدم (لـ \fBzsh\fP و\fBbash\fP) والملفات \fI_less\fP (لـ \fBzsh\fP) و\fIless\fP (لـ \fBbash\fP) المولدة أثناء التثبيت، يمكن تحقيق إكمال بعلامة التبويب للملفات في الأرشيفات. إدخال نقطتين (:) أو علامة مساواة (=) بعد اسم ملف أرشيف ثم الضغط على مفتاح التبويب يُشغل آلية الإكمال. يعمل هذا أيضًا في الأرشيفات المتسلسلة. تُثبت الملفات المطلوبة لخوارزمية الإكمال في الدلائل وفقًا للخيارات المتخذة أثناء التثبيت (نص configure). يجب أن يكون ملف \fIlesscomplete\fP في أحد الدلائل المدرجة في \fB$PATH\fP والدالة \fI_less\fP لـ \fBzsh\fP في دليل مدرج بواسطة \fI$fpath\fP. يجب استيراد ملف \fIless\fP مع تعليمات الإكمال لـ bash داخل نص تهيئة bash، مثل \fI~/.bashrc\fP. يمكن إضافة دلائل جديدة مثل \fI~/scripts\fP و\fI~/.fpath\fP (لـ zsh) باستخدام الأوامر .RS \fBPATH\fP=\fI~/scripts:$PATH\fP # (lesspipe.sh, less) و\fBfpath\fP=\fI(~/.fpath $fpath)\fP # (_less، zsh فقط) .RE .PP في \fBzsh\fP، يجب استدعاء \fIcompinit\fP وتعيين خيار menucomplete إذا لم يُفعل بعد. يمكن تحقيق ذلك بالأوامر .EX .RS \fIautoload compinit\fP \fIcompinit \-Uz\fP \fIsetopt menucomplete\fP .RE .EE .PP في \fBbash\fP، يجب تثبيت \fIbash\-completion\fP (عادة حزمة بهذا الاسم) .SH "الترشيح المعرف من قبل المستخدم" يمكن استبدال أو تحسين ترشيح lesspipe.sh بواسطة برنامج معرف من قبل المستخدم. يجب أن يُسمى هذا البرنامج إما \fB.lessfilter\fP (ويوضع في الدليل الرئيسي للمستخدم)، أو \fBlessfilter\fP (ويكون قابلاً للوصول من دليل مذكور في \fB$PATH\fP). يجب أن يكون قابلاً للتنفيذ وينتهي برمز خروج 0 إذا تم الترشيح داخل هذا السكريبت. وإلا، فإن رمز الخروج غير الصفري يعني أن الترشيح يُترك لـ lesspipe.sh. .PP يمكن استخدام هذه الآلية لإضافة ترشيح لتنسيقات جديدة أو مثلاً تثبيط الترشيح لأنواع ملفات معينة. يمكن أن يبدو نموذج .lessfilter كالتالي: .EX \fI#!/usr/bin/env bash\fP \fIcase $1 in\fP \fI*.md|*.MD|*.mkd|*.markdown|*.rst)\fP \fI# if the python module rich.markdown is not found then\fP \fI# the exit code is not null and lesspipe.sh is called\fP \fIpython3 \-m rich.markdown \-c $1 ;;\fP \fI*.html|*.htm)\fP \fI# call your favorite html beautifier, cat \-b is just a boring example\fP \fIcat \-b $1 ;;\fP \fI*)\fP \fIexit 1;;\fP \fIesac\fP .EE .SH المؤلف Wolfgang Friebel .SH "التبليغ عن الأخطاء" أبلغ عن الأخطاء إلى . .SH "حقوق النسخ" حقوق النشر \(co 2005\-2026 Wolfgang Friebel .br هذا برنامج حر؛ انظر المصدر لشروط النسخ. لا يوجد أي ضمان؛ ولا حتى ضمان قابلية التسويق أو الملاءمة لغرض معين. .SH "انظر أيضًا" less(1) .PP يمكن أيضًا العثور على وصف لـ \fBlesspipe.sh\fP في ملف README المضمن في حزمة الشيفرة المصدرية .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .