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 terminal-type
    يبدأ قسمًا خاصًا بالطرفية ويحدد الطرفية التي ينطبق عليها. يمكن استخدام عبارات TERM متعددة لإنشاء قسم ينطبق على عدة أنواع من الطرفيات.

COLOR yes|all|no|none|tty
    (في سلاكوير فقط؛ ويتجاهله GNU dircolors(1).) يحدد وجوب تفعيل التلوين دائمًا (yes أو all)، أو عدم تفعيله مطلقًا (no أو none)، أو تفعيله فقط إذا كان المخرج طرفية (tty). الخيار المبدئي هو no.

EIGHTBIT yes|no
    (في سلاكوير فقط؛ ويتجاهله GNU dircolors(1).) يحدد وجوب تفعيل محارف ISO/IEC 8859 ذات الثماني بتات مبدئيًا. لأسباب تتعلق بالتوافق، يمكن أيضًا تحديد هذا كـ 1 لـ yes أو 0 لـ no. الخيار المبدئي هو no.

OPTIONS options
    (في سلاكوير فقط؛ ويتجاهله GNU dircolors(1).) يضيف خيارات سطر الأوامر إلى سطر أوامر ls المبدئي. يمكن أن تكون الخيارات أي خيارات سطر أوامر صالحة لـ ls، ويجب أن تتضمن علامة الناقص البادئة. لاحظ أن dircolors لا يتحقق من صحة هذه الخيارات.

NORMAL تسلسل_ألوان
    يحدد اللون المستخدم للنص العادي (غير اسم الملف).

    مرادف: NORM.

FILE تسلسل_ألوان
    يحدد اللون المستخدم للملف العادي.

DIR تسلسل_ألوان
    يحدد اللون المستخدم للأدلة.

LINK تسلسل_ألوان
    يحدد اللون المستخدم للوصلة الرمزية.

    مرادفات: LNK، ‏SYMLINK.

ORPHAN تسلسل_ألوان
    يحدد اللون المستخدم لوصلة رمزية يتيمة (التي تشير إلى ملف غير موجود). إذا لم يُحدد هذا، فسيستخدم ls لون LINK بدلاً من ذلك.

MISSING تسلسل_ألوان
    يحدد اللون المستخدم لملف مفقود (ملف غير موجود ومع ذلك توجد وصلة رمزية تشير إليه). إذا لم يُحدد هذا، فسيستخدم ls لون FILE بدلاً من ذلك.

FIFO تسلسل_ألوان
    يحدد اللون المستخدم لـ FIFO (أنبوب مسمى).

    مرادف: PIPE.

SOCK تسلسل_ألوان
    يحدد اللون المستخدم للمقبس.

DOOR تسلسل_ألوان
    (مدعوم منذ fileutils 4.1) يحدد اللون المستخدم للباب (Solaris 2.5 وأحدث).

BLK تسلسل_ألوان
    يحدد اللون المستخدم لملف خاص بجهاز كتلي.

    مرادف: BLOCK.

CHR تسلسل_ألوان
    يحدد اللون المستخدم لملف خاص بجهاز محرفي.

    مرادف: CHAR.

EXEC تسلسل_ألوان
    يحدد اللون المستخدم لملف عُينت له سمة القابلية للتنفيذ.

SUID تسلسل_ألوان
    يحدد اللون المستخدم لملف عُينت له سمة معرف المستخدم المعين (set-user-ID).

    مرادف: SETUID.

SGID تسلسل_ألوان
    يحدد اللون المستخدم لملف عُينت له سمة معرف المجموعة المعين (set-group-ID).

    مرادف: SETGID.

STICKY تسلسل_ألوان
    يحدد اللون المستخدم لدليل عُينت له سمة الالتصاق (sticky).

STICKY_OTHER_WRITABLE تسلسل_ألوان
    يحدد اللون المستخدم لدليل قابل للكتابة من الآخرين وعُينت له سمة القابلية للتنفيذ.

    مرادف: OWT.

OTHER_WRITABLE تسلسل_ألوان
    يحدد اللون المستخدم لدليل قابل للكتابة من الآخرين ولم تُعين له سمة القابلية للتنفيذ.

    مرادف: OWR.

LEFTCODE تسلسل_ألوان
    يحدد الترميز الأيسر لطرفيات غير ISO/IEC 6429 (انظر أدناه).

    مرادف: LEFT.

RIGHTCODE تسلسل_ألوان
    يحدد الترميز الأيمن لطرفيات غير ISO/IEC 6429 (انظر أدناه).

    مرادف: RIGHT.

ENDCODE تسلسل_ألوان
    يحدد ترميز النهاية لطرفيات غير 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
    ملف ضبط على مستوى النظام.

~/.dir_colors
    ملف ضبط لكل مستخدم.

تصف هذه الصفحة تنسيق ملف 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 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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