منصة اختبار المحتوى المشترك

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

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

إذا كنت تقوم بإنشاء ملف توثيق مشترك جديد في الدليل shared-content، ولا يُقصد إدراجه في الدليل how-to, فقم بما يلي:

1. أنشئ ملفًا في content_test_bed يحمل نفس اسم ملف المحتوى الجديد الخاص بك، مع إضافة "_include" في النهاية.
   • بالنسبة إلى style_guide.md, يمكنك إضافة style_guide_include.md.
2. باستخدام صيغة Snippets، أضف اسم الملف إلى filename_include.md. صيغة Snippets لإدراج المحتوى هي -8<- "filename.md".
   • بالنسبة إلى style_guide.md, يمكنك إضافة -8<- "style_guide.md" إلى style_guide_include.md.
3. قم بتحديث القسم Shared content test bed في /docs/SUMMARY.md لتضمين الملف _include الجديد والمسار، بنفس مستوى المسافة البادئة للعناصر الأخرى في هذا القسم.
   • بالنسبة إلى style_guide_include.md, يمكنك إضافة - [Style guide](content_test_bed/style_guide_include.md).

بمجرد الانتهاء من هذه الخطوات، يمكنك إنشاء موقع الاختبار وعرض الوثائق الجديدة التي تم عرضها.