bourbon

تم إهماله اعتبارًا من 13 سبتمبر 2024

لم يعد هذا المشروع يتم الحفاظ عليه. نشجع الناس على الاستفادة من ميزات CSS الأصلية الحديثة بدلاً من هذه المكتبة. يمكنك الرجوع إلى منشور المدونة الخاص بنا حول كيفية استبدال أو إعادة التفكير في كل مساعد.

مجموعة أدوات SASS خفيفة الوزن

Bourbon هي مكتبة من Mixins Sass والوظائف المصممة لتجعلك مؤلف ورقة أنماط أكثر كفاءة.

إنها…

• خالية من التبعية: بوربون هو ساس نقي.
• القراءة البشرية: نحن نهدف إلى الوضوح على الإيجاز.
• خفيفة الوزن: صفر الإخراج بعد التثبيت وليس له رأي بصري.

روابط مفيدة

• الوثائق
• تغيير السجل
• تغريد
• مكدس فائض

جدول المحتويات

• متطلبات
• تثبيت
• واجهة سطر الأوامر
• دعم المتصفح
• المساهمة
• رخصة
• عن

متطلبات

• Sass 3.4+ أو Libsass 3.3+

تثبيت

1. قم بتثبيت جوهرة بوربون باستخدام مدير حزمة Rubygems:

   gem install bourbon

2. قم بتثبيت مكتبة بوربون في الدليل الحالي:

   bourbon install

   نصيحة للمحترفين: يمكنك استهداف التثبيت في دليل معين باستخدام علامة path :

   bourbon install --path my/custom/path/

3. استيراد بوربون في بداية ورقة الأنماط الخاصة بك:

    @import " bourbon/bourbon " ;

   لا ينصح بتعديل ملفات Bourbon مباشرة لأنها ستجعل التحديث إلى الإصدارات المستقبلية أمرًا صعبًا ، من خلال الكتابة فوق التغييرات المخصصة أو التسبب في تعارضات دمج.

التثبيت لروبي على القضبان 4.2+

1. أضف بوربون إلى gemfile الخاص بك:

    gem "bourbon"

2. ثم قم بالتشغيل:

   bundle install

3. أعد تشغيل الخادم الخاص بك وإعادة تسمية application.css إلى application.scss :

   mv app/assets/stylesheets/application.css app/assets/stylesheets/application.scss

4. احذف جميع توجيهات Sprockets في application.scss ( require ، require_tree و require_self ) واستخدام @import من Sass بدلاً من ذلك (لماذا؟).

5. استيراد بوربون في بداية application.scss . يجب استيراد أي أنماط مشروع تستخدم ميزات بوربون بعد بوربون.

    @import " bourbon " ;
   @import " home " ;
   @import " users " ;

التثبيت مع NPM واستخدام خط أنابيب الأصول القائم على العقدة

1. أضف بوربون باعتباره تبعية:

   npm install --save bourbon

2. إذا كنت تستخدم النظارات ، تخطي إلى الخطوة 3. وإلا ، ستحتاج إلى إضافة Bourbon إلى خيار includePaths العقدة. require("bourbon").includePaths مجموعة من الأدلة التي يجب أن تنقلها إلى العقدة. تعتمد كيفية القيام بذلك على كيفية دمج Node-Sass في مشروعك.

3. استيراد بوربون في ملفات SASS الخاصة بك:

    @import " bourbon " ;

تثبيت الإصدارات القديمة من بوربون

1. قم بإلغاء تثبيت أي إصدارات Bourbon GEM لديك بالفعل:

   gem uninstall bourbon

2. أعد تثبيت GEM Bourbon ، باستخدام علامة -v لتحديد الإصدار الذي تحتاجه:

   gem install bourbon -v 4.2.7

3. اتبع الإرشادات أعلاه لتثبيت بوربون في مشروعك.

واجهة سطر الأوامر

bourbon [options]

خيارات

خيار	وصف
-h ، --help	عرض المساعدة
-v ، --version	إظهار رقم الإصدار
--path	حدد مسارًا مخصصًا
--force	تثبيت القوة (الكتابة فوق)

الأوامر

يأمر	وصف
bourbon install	تثبيت بوربون في الدليل الحالي
bourbon update	الكتابة فوقها وتحديث بوربون في الدليل الحالي
bourbon help	عرض المساعدة

دعم المتصفح

يدعم Bourbon Internet Explorer 11+ وأحدث إصدارات Chrome و Firefox و Safari و Edge.

المساهمة

انظر الوثيقة المساهمة. شكرا لك ، المساهمين!

رخصة

بوربون هو حقوق الطبع والنشر © 2011 ThinkBot ، Inc. إنه برنامج مجاني ، ويمكن إعادة توزيعه بموجب الشروط المحددة في الترخيص.

حول Thoughtbot

يتم الحفاظ على هذا الريبو وتمويله من قبل ThinkBot ، Inc. أسماء وشعارات ThinkBot هي علامات تجارية لـ Thatbot ، Inc.

نحن نحب البرمجيات مفتوحة المصدر! انظر مشاريعنا الأخرى. نحن متاحون للتأجير.