عن المشروع

Primer CSS هو تنفيذ CSS لنظام تصميم Primer الخاص بـ GitHub، والمنشور على npm باسم `@primer/css`. وهو يوفر طبقة التنسيق لـ Primer: فئات مساعدة (utility classes) وأنماط مكونات يمكن للفرق إعادة استخدامها للحفاظ على اتساق الواجهات بصرياً. ما يحتويه - مصدر Sass مكتوب بصيغة SCSS، يمكن استيراده بالكامل أو حسب الوحدة. - نقاط دخول متميزة لسياقات مختلفة: `core` و `product` و `marketing` بحيث يمكن للمشروع سحب التنسيقات التي يحتاجها فقط. - مجموعة مكونات وثيم موثقة، مشروحة على موقع توثيق المشروع primer.style/css، والتي تغطي كيفية البدء، والمكونات، والتنسيق (theming)، ومبادئ التصميم. التثبيت والاستخدام بعد تثبيت npm، يمكن إضافة الحزمة إلى المشروع باستخدام `npm install --save @primer/css`. وبما أن المصادر هي SCSS، يجب أن يكون دليل `node_modules` الخاص بالمشروع ضمن مسارات تضمين (تحميل) Sass. من هناك، يمكن استيراد ورقة الأنماط الكاملة باستخدام `@import "@primer/css/index.scss";` أو استيراد وحدات فردية مباشرة، على سبيل المثال `@import "@primer/css/core/index.scss";` أو `@import "@primer/css/product/index.scss";` أو `@import "@primer/css/marketing/index.scss";`. حالة المشروع يشير تحذير في ملف README إلى أن المستودع في وضع KTLO ("keep the lights on" - الحفاظ على التشغيل الأساسي). والتوجيه هو الاستمرار في استخدام الفئات المساعدة الحالية عند الحاجة إليها، ولكن بالنسبة للأنماط الأكثر اكتمالاً التي تجمع بين التنسيق والتوصيف (markup)، فإن التوصية هي الانتقال إلى primer/react، أو عند الضرورة، primer/view_components. بعبارة أخرى، يظل Primer CSS متاحاً ومدعوماً لفئاته المساعدة، بينما يتم توجيه أعمال الأنماط الجديدة إلى تنفيذات React و ViewComponents. التطوير والمساهمة يتضمن المستودع ملف DEVELOP.md لتوثيق التطوير، وملف RELEASING.md يغطي عملية الإصدار لموظفي GitHub. يتم تشغيل التكامل المستمر (CI) من خلال GitHub Actions، ويتم عرض بيانات الإصدار الوصفية من خلال شارات npm و GitHub (إصدار الحزمة، حالة البناء، المساهمون، آخر التزام، والترخيص). الترخيص تم إصدار المشروع بموجب ترخيص MIT، وحقوق الطبع والنشر محفوظة لـ GitHub.