انتقل إلى المحتوى

Labels

الـ label تصنيف ملوّن صغير تلصقه بالـ issue أو الـ pull request ليدلّ على نوعه أو حالته أو أولويته: bug، enhancement، help wanted. في ليڤانت غيت (LevantGit) تنشئ الـ labels في الـ repository أو في الـ organization كلها، وتجعلها متنافية بالـ scoped labels، وتصفّي بها القوائم — وهي أسرع طريقة لمعرفة ما الذي يجب أن تعمل عليه الآن حين يكبر المشروع.

إنشاء الـ labels

في repository

  1. افتح الـ repository واذهب إلى تبويب Issues.
  2. اضغط Labels أعلى القائمة.
  3. اضغط New Label.

لكل label:

  • اسم إلزامي.
  • لون إلزامي؛ اختر من الألوان المقترحة أو اكتب رمزًا سداسيًا مثل #e11d21.
  • وصف اختياري يظهر عند تمرير المؤشر فوق الـ label.
  • خيار Exclusive للـ scoped labels (انظر أدناه).

في organization

إن كنت owner لـ organization، تستطيع تعريف labels على مستوى الـ organization تظهر في كل الـ repositories التابعة لها، الموجودة منها والتي ستُنشأ لاحقًا. افتح صفحة الـ organization ثم Settings ثم Labels. هذا يوفّر عليك إعادة إنشاء bug وfeature في كل repository جديد.

عند إنشاء repository جديد

في نموذج New Repository ستجد حقل Issue Labels؛ اختر منه مجموعة جاهزة (مثل Default أو Advanced) فتُنشأ labels تلك المجموعة مع الـ repository مباشرة. هذه المجموعات يحدّدها مدير الخدمة، ولا تستطيع إضافة مجموعات جديدة إليها بنفسك، لكنك تستطيع تعديل أيّ label أو حذفه بعد إنشائه.

نصيحة

ابدأ بعدد قليل من الـ labels الواضحة. كثرتها تجعل الناس يتجاهلونها.

الـ scoped labels

أحيانًا تريد أن تقول إن الـ issue إمّا خطأ أو تحسين، لا الاثنين معًا. هنا يأتي دور الـ scoped labels: اكتب اسم الـ label بصيغة النطاق/القيمة، مثل kind/bug وkind/enhancement، وفعّل خيار Exclusive عند إنشائه.

النتيجة: لا يمكن أن تحمل الـ issue الواحدة أكثر من label من النطاق نفسه. إن وضعت kind/enhancement على issue تحمل kind/bug، يُزال الأخير تلقائيًا.

قواعد الاسم:

  • يجب أن يحتوي الاسم على /، وليس في أوله أو آخره.
  • النطاق هو كل ما قبل آخر /. فنطاق scope/subscope/item هو scope/subscope.

أمثلة شائعة: priority/high وpriority/low، أو status/in-progress وstatus/blocked.

التصفية بحسب الـ label

في قائمة الـ issues أو الـ pull requests اضغط قائمة Label واختر label أو أكثر:

  • اختيار عدة labels يعرض العناصر التي تحمل كل الـ labels المختارة معًا.
  • اضغط label مع الاستمرار بالضغط على مفتاح Alt (أو Option على ماك) لاستبعاد العناصر التي تحمله من القائمة.

تعديل الـ labels أو حذفها

من صفحة Labels اضغط Edit بجانب أيّ label لتغيير اسمه أو لونه أو وصفه؛ التغيير ينعكس فورًا على كل الـ issues التي تحمله. أما Delete فيزيل الـ label من كل الـ issues دون حذف الـ issues نفسها.

ملاحظة

labels الـ organization تُعدَّل وتُحذف من إعدادات الـ organization فقط، لا من داخل الـ repository.

ماذا بعد؟

هذه الصفحة مبنية على وثائق Gitea (رخصة MIT) بعد ترجمتها وتبسيطها.