مهارات إنشاء السمات والكتل

شكرًا لك @BrianC!

بشأن بقاء النسخة الأصلية محدثة: يتبع مسار المهارات (skills track) واجهات برمجة التطبيقات (APIs) الخاصة بـ Discourse والمكونات (Blocks)، لذا طالما أننا نستخدمها بنشاط، فستظل متزامنة مع تطور واجهات برمجة التطبيقات. يُعد موضوع الأمثلة مجرد لقطة توضيحية للأنماط. إذا قمت بعمل نسخة فرعية (fork) منه، فإنك تملك نسختك الفرعية. ولكن يمكنك الرجوع إلى مسار المهارات أو الأمثلة الجديدة عند تحديث موضوعك.

تتمثل إحدى الأهداف الرئيسية لواجهة برمجة التطبيقات الخاصة بالمكونات (Blocks API) في توفير مساحة سطح مستقرة وصغيرة، تساعد في الحفاظ على مرونة التخصيصات عبر تحديثات Discourse. لذا، إذا كنت تضيف في الغالب مكونات مخصصة (كما يفعل موضوع الأمثلة)، فستعمل بالفعل ضمن بيئة مستقرة. الشيء الرئيسي الذي يجب مراقبته هو التغييرات في أسماء المنافذ (outlet names) أو توقيعات واجهة برمجة التطبيقات للمكونات. حاليًا، لا تزال واجهة برمجة التطبيقات تعتبر تجريبية، لذا قد تكون هناك تغييرات في الأسماء وما إلى ذلك.

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