yui3

يوي 3: مكتبة واجهة مستخدم ياهو

Yui هو إطار JavaScript و CSS مجاني ومفتوح المصدر لبناء تطبيقات الويب التفاعلية الغنية. يتم توفير Yui بموجب ترخيص BSD وهو متاح على Github للتغذية والمساهمة.

الروابط

• الصفحة الرئيسية
• الوثائق
• مدونة
• أحدث إصدار إنتاج
• المنتديات
• رخصة
• معلومات المساهم
• القائمة البريدية المساهم
• الإبلاغ عن خطأ
• شيفتر ، لبناء يوي

معلومات المصدر

هذه هي شجرة مصدر العمل النشطة لـ Yui 3. إنها تحتوي على عمل مستمر نحو إصدارات Yui 3 التالية وقد تكون غير مستقرة.

نحن نشجعك على استخدام أحدث مصدر لأغراض التقييم ، واختبار ميزات جديدة وإصلاحات الأخطاء ، وتوفير ملاحظات حول وظائف جديدة. يرجى الرجوع إلى رابط "أحدث إصدار إنتاج" أعلاه إذا كنت تبحث عن أحدث إصدار مستقر من YUI الموصى به لاستخدام الإنتاج.

إذا كنت تخطط للمساهمة في YUI ، فيرجى الانضمام إلى "القائمة البريدية المساهم" المذكورة أعلاه ومراقبة "القائمة البريدية" المذكورة أعلاه. سيتم توفير معلومات حول المعالم وإغلاق الأشجار هناك.

معلومات الفرع

يحدث تطور يوي على خمسة فروع رئيسية. يصف ما يلي ما يمثله كل فروع من هذه التعليمات البرمجية:

• live-docs : يمثل أحدث إصدار من GA من YUI ، بالإضافة إلى أي تحديثات الوثائق فقط. تحدث أي تعديلات أو إضافات إلى مستندات لإصدار آخر في هذا الفرع ، وينعكس على الموقع الإلكتروني.

• master : (القراءة فقط) يحتوي على كل شيء في live-docs ، بالإضافة إلى تغييرات التعليمات البرمجية التي ستدخل في إصدار YUI التالي. إن تغييرات الكود في master هي إما إصلاحات الأخطاء أو التغييرات الصغيرة التي لا ينبغي أن تكسر توافق API. سيتم قطع إصدارات التصحيح من هذا الفرع. على سبيل المثال 3.6.x. اجتازت جميع الكود في هذا الفرع جميع اختبارات الوحدة ويجب أن تكون مستقرة.

• 3.x : (القراءة فقط) يمثل إصدار Yui الرئيسي التالي ؛ على سبيل المثال 3.7.0. هذا هو فرع التكامل الذي يحتوي على كل شيء في master ، بالإضافة إلى تغييرات الكود الأكبر والتي ستدخل في إصدار YUI في المستقبل. تتطلب التغييرات في 3.x زيادة في الإصدار البسيط قبل أن تكون جزءًا من الإصدار ، على سبيل المثال ، 3.7.0. سيتم قطع إصدارات المعاينة من هذا الفرع للمطورين للاختبار والتقييم. اجتازت جميع الكود في هذا الفرع جميع اختبارات الوحدة ويجب أن تكون مستقرة.

• dev-master و dev-3.x : فروع العمل الحالية التي تحتوي على رمز لم يمر عبر عملية CI. يتحقق المطورون من تغييراتهم في فروع التكامل هذه لنظام الاختبار الآلي للتحقق من صحة. بمجرد التحقق من صحة ، يتم دمج الكود في master و 3.x على التوالي. لا تدخل في master أو 3.x مباشرة.

• release-3.xx : فروع الإصدار قصيرة العمر حيث تتم إدارة Code Checkins بعناية للاختبار الواسع ونشر الإصدار.

شجرة المصدر

تتضمن شجرة مصدر Yui الدلائل التالية:

• build : بنيت ملفات مصدر يوي. يتم إنشاء الملفات المدمجة في وقت التطوير من محتويات دليل src . تقوم Build Step بإنشاء ملفات تصحيح الأخطاء (غير معجزة ومع التعليقات الكاملة والتسجيل) ، والملفات الأولية (غير محدلة ، ولكن دون تسجيل تصحيح الأخطاء) ، والملفات المصغرة (مناسبة لنشر الإنتاج واستخدامها).

• رمز المصدر src RAW غير المبني (JavaScript ، CSS ، أصول الصور ، ملفات ActionScript ، إلخ) للمكتبة. بدءًا من YUI 3.4.0 ، يحتوي دليل src أيضًا على جميع الوثائق والاختبارات والأمثلة الخاصة بالوحدة. يجب أن تحدث جميع التعديلات على المكتبة وتوثيقها في هذا الدليل.

الإعداد الأولي

1. شوكة المشروع على github (https://github.com/yui/yui3).
2. استنساخ الشوكة لبيئتك المحلية للتنمية.

افعل أشياء جيدة

1. إنشاء فرع ميزة لإيواء التغييرات الكود الذري. git checkout -b myfeature upstream/master --no-track
2. تلبية متطلبات المساهمة (انظر معايير مساهمة YUI).
3. ادفع التغييرات في شوكة
4. أرسل طلب سحب من شوكة الخاص بك إلى فرع live-docs أو dev-master أو dev-3.x للمراجعة.
5. دمج ملاحظات المجتمع.
6. ادفع التغييرات في شوكة الشوكة - سيتم تحديث طلب السحب تلقائيًا.
7. شطف وكرر.

يجب أن تستمر جميع التغييرات في فرع الميزات ؛ وبهذه الطريقة ، سيتم تحديث طلب السحب الذي ترسله تلقائيًا لتضمينها. تأكد من الحفاظ على فرع الميزات محدثًا بأحدث التغييرات من Master ، بحيث لا يختلف أثناء عملية التطوير الخاصة بك.

نصائح مهمة

• دائما العمل من فرع الميزة. نظرًا لأن جميع عمليات إرسال التعليمات البرمجية ستكون من خلال طلب سحب ، فإن فروع الميزات تعزل التغييرات عن تقديم إلى آخر.
• ابدأ دائمًا فرعك الجديد من الفرع الذي تريد إرساله إلى: git checkout -b myfeature dev-master
• تذكر أن ترسل طلب السحب الخاص بك إلى فرع dev- الصحيح وليس master أو 3.x

مبنى

لإنشاء مكونات YUI تثبيت شيفتر ( npm -g install shifter ) ثم ببساطة تشغيل shifter في دليل المكونات هذا.

يتيح لك Syfter أيضًا إعادة بناء شجرة Yui SRC بأكملها:

 cd yui3/src && shifter --walk