هيكل مستودع للعينات المحظورة

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

دروس تطبيقية حول الترميز

الدروس التطبيقية حول الترميز هي برامج تعليمية تفاعلية تتم كتابتها بلغة Markdown ويتم نشرها على blocklycodelabs.dev. وتستفيد الدروس التطبيقية من الترميز بمزيج من اللغات الطبيعية وعيّنات التعليمات البرمجية ولقطات الشاشة لتقديم تجربة تعليمية أكثر إثارة للاهتمام. يتابع المستخدم المستهدف التعليمات البرمجية ويشغلها أثناء قراءته.

يتضمّن دليل الدرس التطبيقي حول الترميز نموذجًا ومجلدًا واحدًا لكل تمرين تطبيقي حول الترميز. يحتوي كل مجلد حول الترميز على ملف markdown وجميع الأصول (pngs، وgifs، وغيرها) للدرس التطبيقي حول الترميز.

أمثلة

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

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

يتضمن دليل الأمثلة مجلدًا واحدًا لكل مثال. يمكن تنفيذ كل مثال باستخدام npm install && npm run start، ويحتوي على ملف README.md مع سياق إضافي أو تعليمات إضافية.

المكوّنات الإضافية

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

يتضمّن دليل المكوّنات الإضافية مجلدًا واحدًا لكل مكوّن إضافي. ويحتوي كل مكوّن إضافي على دليل src حيث يتم تضمين الرمز، ودليل test حيث توجد صفحة تجريبية. وتحتوي أيضًا على ملف README.md الذي يوفر للمطورين معلومات حول وظيفة المكون الإضافي وكيفية استخدامه.

صفحات GitHub

تحتوي النماذج المحظورة على صفحة ويب تتوفر فيها العديد من المكوّنات الإضافية والعروض التوضيحية في بيئة تشغيل. تتم استضافة هذه الصفحة على صفحات GitHub، ويظهر الرمز البرمجي لهذا الموقع الإلكتروني في دليل gh-pages الخاص بالنماذج المجمّعة. يحتوي هذا الدليل على قوالب للصفحات على الموقع. يتم إنشاء محتوى الموقع الفعلي بناءً على هذه النماذج والبيانات الوصفية من كل مكون إضافي أو مثال تتم استضافته.