Scroll to navigation

dir_colors(5) File Formats Manual dir_colors(5)

الاسم

dir_colors - ملف ضبط dircolors(1)

الوصف

يستخدم البرنامج ls(1) متغير البيئة LS_COLORS لتحديد الألوان التي ستُعرض بها أسماء الملفات. عادة ما يُعين متغير البيئة هذا بواسطة أمر مثل

eval `dircolors some_path/dir_colors`

الموجود في ملف تهيئة الصدفة المبدئي للنظام، مثل /etc/profile أو /etc/csh.cshrc. (انظر أيضًا dircolors(1).) عادةً، الملف المستخدم هنا هو /etc/DIR_COLORS ويمكن تجاوزه بملف .dir_colors في الدليل المنزلي للمستخدم.

يتكون ملف الضبط هذا من عدة عبارات، واحدة في كل سطر. يُعامل أي شيء على يمين علامة الهاش (#) كتعليق، إذا كانت علامة الهاش في بداية السطر أو تسبقها مسافة بيضاء واحدة على الأقل. تُتجاهل السطور الفارغة.

يتكون القسم العام من الملف من أي عبارة تسبق عبارة TERM الأولى. وتُعتبر أي عبارة في القسم العام من الملف صالحة لجميع أنواع الطرفيات. يلي القسم العام قسم واحد أو أكثر خاص بالطرفية، وتسبقه عبارة TERM واحدة أو أكثر تُحدد أنواع الطرفيات (كما يعطيها متغير البيئة TERM) التي تنطبق عليها التصريحات التالية. من الممكن دائمًا تجاوز التصريح العام بتصريح لاحق خاص بالطرفية.

العبارات التالية مدعومة؛ وحالة الأحرف غير مهمة:

يبدأ قسمًا خاصًا بالطرفية ويحدد الطرفية التي ينطبق عليها. يمكن استخدام عبارات TERM متعددة لإنشاء قسم ينطبق على عدة أنواع من الطرفيات.
(في سلاكوير فقط؛ ويتجاهله GNU dircolors(1).) يحدد وجوب تفعيل التلوين دائمًا (yes أو all)، أو عدم تفعيله مطلقًا (no أو none)، أو تفعيله فقط إذا كان المخرج طرفية (tty). الخيار المبدئي هو no.
(في سلاكوير فقط؛ ويتجاهله GNU dircolors(1).) يحدد وجوب تفعيل محارف ISO/IEC 8859 ذات الثماني بتات مبدئيًا. لأسباب تتعلق بالتوافق، يمكن أيضًا تحديد هذا كـ 1 لـ yes أو 0 لـ no. الخيار المبدئي هو no.
(في سلاكوير فقط؛ ويتجاهله GNU dircolors(1).) يضيف خيارات سطر الأوامر إلى سطر أوامر ls المبدئي. يمكن أن تكون الخيارات أي خيارات سطر أوامر صالحة لـ ls، ويجب أن تتضمن علامة الناقص البادئة. لاحظ أن dircolors لا يتحقق من صحة هذه الخيارات.
يحدد اللون المستخدم للنص العادي (غير اسم الملف).
مرادف: NORM.
يحدد اللون المستخدم للملف العادي.
يحدد اللون المستخدم للأدلة.
يحدد اللون المستخدم للوصلة الرمزية.
مرادفات: LNK، ‏SYMLINK.
يحدد اللون المستخدم لوصلة رمزية يتيمة (التي تشير إلى ملف غير موجود). إذا لم يُحدد هذا، فسيستخدم ls لون LINK بدلاً من ذلك.
يحدد اللون المستخدم لملف مفقود (ملف غير موجود ومع ذلك توجد وصلة رمزية تشير إليه). إذا لم يُحدد هذا، فسيستخدم ls لون FILE بدلاً من ذلك.
يحدد اللون المستخدم لـ FIFO (أنبوب مسمى).
مرادف: PIPE.
يحدد اللون المستخدم للمقبس.
(مدعوم منذ fileutils 4.1) يحدد اللون المستخدم للباب (Solaris 2.5 وأحدث).
يحدد اللون المستخدم لملف خاص بجهاز كتلي.
مرادف: BLOCK.
يحدد اللون المستخدم لملف خاص بجهاز محرفي.
مرادف: CHAR.
يحدد اللون المستخدم لملف عُينت له سمة القابلية للتنفيذ.
يحدد اللون المستخدم لملف عُينت له سمة معرف المستخدم المعين (set-user-ID).
مرادف: SETUID.
يحدد اللون المستخدم لملف عُينت له سمة معرف المجموعة المعين (set-group-ID).
مرادف: SETGID.
يحدد اللون المستخدم لدليل عُينت له سمة الالتصاق (sticky).
يحدد اللون المستخدم لدليل قابل للكتابة من الآخرين وعُينت له سمة القابلية للتنفيذ.
مرادف: OWT.
يحدد اللون المستخدم لدليل قابل للكتابة من الآخرين ولم تُعين له سمة القابلية للتنفيذ.
مرادف: OWR.
يحدد الترميز الأيسر لطرفيات غير ISO/IEC 6429 (انظر أدناه).
مرادف: LEFT.
يحدد الترميز الأيمن لطرفيات غير ISO/IEC 6429 (انظر أدناه).
مرادف: RIGHT.
يحدد ترميز النهاية لطرفيات غير ISO/IEC 6429 (انظر أدناه).
مرادف: END.
*extension color-sequence
يحدد اللون المستخدم لأي ملف ينتهي بـ الامتداد.
.extension color-sequence
نفس *.الامتداد. يحدد اللون المستخدم لأي ملف ينتهي بـ .الامتداد. لاحظ أن النقطة مضمنة في الامتداد، مما يجعل من المستحيل تحديد امتداد لا يبدأ بنقطة، مثل ~ لملفات النسخ الاحتياطي لـ emacs. ينبغي اعتبار هذا الشكل مهجورًا.

تسلسلات ألوان ISO/IEC 6429 (ANSI)

تستخدم معظم طرفيات ASCII القادرة على عرض الألوان اليوم تسلسلات ألوان ISO/IEC 6429 (ANSI)، والعديد من الطرفيات الشائعة التي لا تملك قدرة على عرض الألوان، بما في ذلك xterm والطرفية DEC VT100 واسعة الاستخدام والمستنسخة، ستتعرف على ترميزات ألوان ISO/IEC 6429 وتزيلها من المخرج دون ضرر أو تحاكيها. يستخدم ls ترميزات ISO/IEC 6429 مبدئيًا، بافتراض أن التلوين مفعل.

تتكون تسلسلات ألوان ISO/IEC 6429 من تسلسلات من الأرقام تفصل بينها فاصلة منقوطة. الترميزات الأكثر شيوعًا هي:

0 لاستعادة اللون المبدئي
1 لألوان أكثر سطوعًا
4 لنص تحته خط
5 لنص وامض
30 لخلفية نص سوداء
31 لخلفية نص حمراء
32 لخلفية نص خضراء
33 لخلفية نص صفراء (أو بنية)
34 لخلفية نص زرقاء
35 لخلفية نص أرجوانية
36 لخلفية نص سماوية
37 لخلفية نص بيضاء (أو رمادية)
40 لخلفية سوداء
41 لخلفية حمراء
42 لخلفية خضراء
43 لخلفية صفراء (أو بنية)
44 لخلفية زرقاء
45 لخلفية أرجوانية
46 لخلفية سماوية
47 لخلفية بيضاء (أو رمادية)

لن تعمل جميع الأوامر على جميع الأنظمة أو أجهزة العرض.

يستخدم ls القيم المبدئية التالية:

NORMAL 0 نص عادي (ليس اسم ملف)
FILE 0 ملف منتظم
DIR 32 الدليل
LINK 36 وصلة رمزية
ORPHAN غير محدد وصلة رمزية يتيمة
MISSING غير محدد ملف مفقود
FIFO 31 أنبوب مسمى (FIFO)
SOCK 33 مقبس
BLK 44;37 جهاز كتلي
CHR 44;37 جهاز محرفي
EXEC 35 ملف تنفيذي

لا تتعرف بعض برامج الطرفيات على القيمة المبدئية بشكل صحيح. إذا لُوّن النص بأكمله بعد سرد محتويات دليل، فغيّر رمزي NORMAL و FILE إلى الرموز العددية للألوان الأمامية والخلفية العادية لديك.

أنواع الطرفيات الأخرى (ضبط متقدم)

إذا كان لديك طرفية (أو طابعة!) تدعم الألوان (أو تمييز النصوص بأي شكل آخر) وتستخدم مجموعة رموز مختلفة، فلا يزال بإمكانك توليد إعداد مناسب. للقيام بذلك، سيتعين عليك استخدام تعريفات LEFTCODE و RIGHTCODE و ENDCODE.

عند كتابة اسم ملف، يولد ls تسلسل المخرجات التالي: LEFTCODE typecode RIGHTCODE filename ENDCODE، حيث يكون typecode هو تسلسل الألوان الذي يعتمد على نوع الملف أو اسمه. إذا كان ENDCODE غير محدد، فسيُستخدم التسلسل LEFTCODE NORMAL RIGHTCODE بدلاً منه. الغرض من الرموز اليسارية واليمينية هو مجرد تقليل كمية الكتابة اللازمة (وإخفاء رموز الهروب القبيحة عن المستخدم). إذا كانت غير مناسبة لطرفيتك، فيمكنك إلغاؤها بتحديد الكلمة المفتاحية المعنية في سطر منفرد بذاته.

ملاحظة: إذا حُدد ENDCODE في القسم العام من ملف الإعداد، فلا يمكن إلغاء تحديده في قسم خاص بطرفية معينة من الملف. هذا يعني أن أي تعريف لـ NORMAL لن يكون له أي تأثير. ومع ذلك، يمكن تحديد ENDCODE مختلف، والذي سيكون له التأثير نفسه.

تسلسلات الهروب

لتحديد أحرف التحكم أو الأحرف الفارغة في تسلسلات الألوان أو امتدادات أسماء الملفات، يمكن استخدام إما صيغة الهروب \ على غرار لغة C أو صيغة ^ على غرار stty. تتضمن صيغة لغة C الأحرف التالية:

\a الجرس (ASCII 7)
\b مسافة للخلف (ASCII 8)
\e هروب (ASCII 27)
\f تلقيم الصفحة (ASCII 12)
\n سطر جديد (ASCII 10)
\r رجوع الحامل (ASCII 13)
\t جدولة (ASCII 9)
\v جدولة عمودية (ASCII 11)
\? حذف (ASCII 127)
\nnn أي محرف (تدوين ثماني)
\xnnn أي محرف (تدوين ست عشري)
\_ مسافة
\\ شرطة مائلة عكسية (\)
\^ علامة إقحام (^)
\# علامة المربع (#)

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

الملفات

/etc/DIR_COLORS
ملف إعداد على مستوى النظام. (في Slackware و SuSE و RedHat فقط؛ يتجاهله GNU dircolors(1) وبالتالي يتجاهله Debian.)
~/.dir_colors
(في Slackware و SuSE و RedHat only؛ يتجاهله GNU dircolors(1) وبالتالي يتجاهله Debian.) ملف إعداد خاص بكل مستخدم.

تصف هذه الصفحة تنسيق ملف dir_colors كما هو مستخدم في حزمة fileutils-4.1؛ وقد تختلف الإصدارات الأخرى قليلاً.

ملاحظات

تعريفات LEFTCODE و RIGHTCODE المبدئية، والتي تستخدمها طرفيات ISO/IEC 6429 هي:

LEFTCODE \e[
RIGHTCODE m

قيمة ENDCODE المبدئية غير محددة.

انظر أيضًا

dircolors(1), ls(1), stty(1), xterm(1)

ترجمة

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

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

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

8 فبراير 2026 صفحات دليل لينكس 6.18