منصوبے کے بارے میں

Primer CSS، GitHub کے Primer Design System کا CSS نفاذ ہے، جسے npm پر `@primer/css` کے طور پر شائع کیا گیا ہے۔ یہ Primer کی اسٹائلنگ لیئر فراہم کرتا ہے: یوٹیلیٹی کلاسز اور کمپوننٹ اسٹائلز جنہیں ٹیمیں انٹرفیس کو بصری طور پر مستقل رکھنے کے لیے دوبارہ استعمال کر سکتی ہیں۔ اس میں کیا شامل ہے - SCSS سنٹیکس میں لکھی گئی Sass سورس، جسے مکمل طور پر یا ماڈیول کے طور پر امپورٹ کیا جا سکتا ہے۔ - مختلف سیاق و سباق کے لیے الگ انٹری پوائنٹس: `core`، `product` اور `marketing`، تاکہ کوئی پروجیکٹ صرف وہی اسٹائلنگ حاصل کر سکے جس کی اسے ضرورت ہے۔ - ایک دستاویزی تھیم اور کمپوننٹ سیٹ، جس کی تفصیل پروجیکٹ کی ڈاکومنٹیشن سائٹ primer.style/css پر موجود ہے، جس میں آغاز، کمپوننٹس، تھیمنگ اور ڈیزائن کے اصول شامل ہیں۔ انسٹالیشن اور استعمال 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") موڈ میں ہے۔ ہدایت یہ ہے کہ جہاں ضرورت ہو وہاں موجودہ یوٹیلیٹی کلاسز کا استعمال جاری رکھیں، لیکن زیادہ مکمل پیٹرنز کے لیے جو اسٹائلنگ کو مارک اپ کے ساتھ جوڑتے ہیں، سفارش یہ ہے کہ primer/react، یا جہاں ضروری ہو، primer/view_components پر منتقل ہو جائیں۔ دوسرے الفاظ میں، Primer CSS اپنی یوٹیلیٹی کلاسز کے لیے دستیاب اور سپورٹڈ ہے، جبکہ نئے پیٹرن کے کام کو React اور ViewComponents کے نفاذ کی طرف موڑ دیا گیا ہے۔ ترقی اور شراکت ریپوزٹری میں ڈویلپمنٹ ڈاکومنٹیشن کے لیے DEVELOP.md، اور GitHub اسٹاف کے لیے ریلیز کے عمل کا احاطہ کرنے والی RELEASING.md شامل ہے۔ کنٹینیوس انٹیگریشن GitHub Actions کے ذریعے چلتی ہے، اور ریلیز میٹا ڈیٹا npm اور GitHub بیجز (پیکیج ورژن، بلڈ اسٹیٹس، کنٹری بیوٹرز، آخری کمنٹ اور لائسنس) کے ذریعے ظاہر کیا جاتا ہے۔ لائسنس پروجیکٹ MIT لائسنس کے تحت جاری کیا گیا ہے، جس کا کاپی رائٹ GitHub کے پاس ہے۔