الاسم

terminal-colors.d - اضبط تلوين المخرجات لمختلف الأدوات المساعدة

موجز

/etc/terminal-colors.d/[name.|[name]@term.]type

الوصف

تحدد الملفات في هذا الدليل السلوك المبدئي للأدوات المساعدة عند تلوين المخرجات.

يمثل اسم اسم الأداة المساعدة. الاسم اختياري، وعند عدم تحديده، يُستخدم الملف لجميع الأدوات المساعدة غير المحددة.

إنّ term هو معرف محطة طرفية (متغير البيئة TERM). معرف المحطة الطرفية اختياري، وعندما لا يُحدد أي معرف، يُستخدم الملف لجميع المحطات الطرفية غير المحددة.

إنّ نوع هو نوع ملف. أنواع الملفات المتاحة هي:

disable

يوقف تلوين المخرجات لجميع الأدوات المتوافقة. انظر أيضاً متغير البيئة NO_COLOR أدناه.

enable

يشغل تلوين المخرجات؛ وتُتجاهل أي ملفات disable مطابقة.

scheme

يحدد الألوان المستخدمة للمخرجات. قد يكون تنسيق الملف خاصًا بالأداة، والتنسيق المبدئي موضح أدناه.

إذا وُجدت ملفات أكثر تطابق أداة ما، فإن الملف ذو اسم الملف الأكثر تحديداً يفوز. على سبيل المثال، اسم الملف @xterm.scheme له أولوية أقل من dmesg@xterm.scheme. الأولوية الأدنى تكون للملفات التي لا تملك اسم أداة ومعرف طرفية (مثل: "disable").

يتخطى $XDG_CONFIG_HOME/terminal-colors.d أو $HOME/.config/terminal-colors.d الخاص بالمستخدم الإعداد العام.

تنسيق ملفات التشكيلة المبدئي

العبارة التالية مُعرف بها:

الاسم تسلسل-الألوان

الاسم name هو اسم منطقي لتسلسل الألوان (على سبيل المثال: error). الأسماء محددة لكل أداة. لمزيد من التفاصيل، انظر دائماً قسم COLORS في صفحة الدليل للأداة.

The color-sequence can be a color name, an ANSI color sequence, or an escape sequence.

أسماء الألوان

Valid color names are: black, blink, blue, bold, brown, cyan, darkgray, gray, green, halfbright, lightblue, lightcyan, lightgray, lightgreen, lightmagenta, lightred, magenta, red, reset, reverse, and yellow.

تسلسلات ألوان ANSI

An ANSI color sequence is composed of sequences of numbers separated by semicolons. The most common codes are:

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

على سبيل المثال، لاستخدام خلفية حمراء لرسائل التنبيه في مخرجات dmesg(1)، استخدم:

echo 'alert 37;41' >> /etc/terminal-colors.d/dmesg.scheme

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

An escape sequence is needed to enter a space, backslash, caret, or any control character anywhere in a string, as well as a hash mark as the first character. These C-style backslash-escapes can be used:

\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)
\_	مسافة
\\	شرطة مائلة عكسية (\)
\^	علامة الإقحام (^)
\\#	علامة المربع (#)

ملاحظات

تُتجاهل الأسطر التي يكون فيها أول محرف غير فارغ هو # (مربع). أي استخدام آخر لمحرف المربع لا يُفسر على أنه مقدمة لتعليق.

البيئة

TERMINAL_COLORS_DEBUG=all

يفعّل مخرجات التنقيح.

NO_COLOR

إذا عُرّف، فإن هذا يعطل تلوين المخرجات ما لم يُفعّل صراحةً عبر خيار سطر الأوامر. انظر https://no-color.org/ لمزيد من التفاصيل. متاح منذ إصدار util-linux رقم 2.41.

الملفات

$XDG_CONFIG_HOME/terminal-colors.d

$HOME/.config/terminal-colors.d

/etc/terminal-colors.d

أمثلة

عطل الألوان لجميع الأدوات المتوافقة:

touch /etc/terminal-colors.d/disable

عطل الألوان لجميع الأدوات المتوافقة على محطة vt100 طرفية:

touch /etc/terminal-colors.d/@vt100.disable

عطل الألوان لجميع الأدوات المتوافقة عدا dmesg(1):

touch /etc/terminal-colors.d/disable
touch /etc/terminal-colors.d/dmesg.enable

التوافقية

The terminal-colors.d functionality is currently supported by all util-linux utilities which provide colorized output. For more details always see the COLORS section in the man page for the utility.

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

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

التوفر

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