عرض أدوات المستندات

قائمة مراجعة الموضوع

تم تصميم هذا العرض التوضيحي لاختبار الميزات المختلفة لتجاوزات سمة BeeWare MkDocs Material. يرجى قراءة وتحقق من أن كل ما هو مدرج في هذه الصفحة والصفحات التالية موجود ويعمل كما هو موضح في الوصف.

شريط العنوان

يوجد شريط عنوان رمادي متوسط على الصفحة. تم تطبيق قالب السمة هذا.

رمز الرأس

تم عرض رمز الرأس في أعلى اليسار. وهذا يؤكد أن القالب يمكنه الرجوع إلى موارد خارجية.

رمز الشريط الجانبي للصفحة الرئيسية

تم عرض رمز الشعار في الشريط الجانبي الأيسر. يجب أن يكون عرض الشعار مساوياً لعرض الشريط الجانبي وارتفاعه مساوياً لارتفاع الشريط الجانبي. يجب عرض عنوان الموقع أسفل الشعار بخط أكبر قليلاً من باقي الشريط الجانبي، مع عرض رقم الإصدار أسفل العنوان بخط أصغر.

هذا يؤكد أن الشريط الجانبي سيتم عرضه بشكل صحيح على المواقع المستهدفة.

خط العنوان

يتم عرض العناوين بخط Cutive. وهذا يؤكد أن موضوع CSS المخصص لـ BeeWare قد تم تطبيقه.

رمز مضمن

يتم عرض الكود المضمن بنفس لون الخط المحيط به. وهذا يؤكد أن السمة لم تسبب أي تغييرات غير مرغوب فيها.

هذا نص يحتوي على inline code هنا وinline code هنا.

رمز المحتوى المبوب

الرمز بلون مغاير للخلفية. يجب أن ينسخ زر النسخ الأوامر فقط؛ ولا يجب تضمين الموجه.

هذا يؤكد أن السمة لم تسبب أي تغييرات غير مرغوب فيها، وكذلك أن زر النسخ يعمل كما هو متوقع.

macOSLinuxWindows

$ git clone https://github.com/beeware/beeware-theme.git

$ git clone https://github.com/beeware/beeware-theme.git

C:\...>git clone https://github.com/beeware/beeware-theme.git

سلوك زر نسخ الكود

يجب أن يؤدي زر النسخ الموجود في كتلة الكود التالية إلى نسخ from pathlib import Path إلى الحافظة.

من pathlib استيراد Path

يجب أن يؤدي زر النسخ الموجود في كتلة الكود التالية إلى نسخ ls beeware-docs-tools إلى الحافظة. لا يجب تضمين موجه الأوامر والنتائج.

(venv) $ ls beeware-docs-tools
_build locales requirements.dev.txt  tox.ini
docs pyproject.toml    requirements.docs.txt
LICENSE README.md    src

روابط الشريط الجانبي

توجد روابط في الشريط الجانبي، وتشير إلى مستودع beeware-docs-tools. وهذا يؤكد أن محتوى الشريط الجانبي قد تم تحميله، وأن project-name قد تم تعيينه في ملف تكوين MkDocs، وأن رقم الإصدار قد تم حسابه وإضافته.

ألوان الروابط

يجب أن يكون هذا الرابط إلى موقع BeeWare الرئيسي باللون الأزرق في كل من الوضع الفاتح والوضع الداكن.

يجب أن تكون الروابط الموجودة في الشريطين الجانبيين الأيمن والأيسر زرقاء اللون في كلا الوضعين.

عند التمرير لأسفل الصفحة، يجب أن يكون رابط العنوان النشط في الشريط الجانبي الأيمن باللون الأزرق الفاتح في الوضع المظلم، وباللون الأزرق الداكن في الوضع الفاتح.

ترجمة التحذير

يجب أن تظهر النسخة الإنجليزية من هذا المستند التحذير "تتوفر ترجمات" أدناه. يجب أن تظهر الترجمة الفرنسية التحذير "هذه ترجمة آلية!". يجب أن تظهر الترجمة الألمانية التحذير "هذه ترجمة!" للترجمات البشرية.

هذه ترجمة آلية!

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

صفحة 404 مخصصة

أضف nopage إلى نهاية عنوان URL في متصفحك للتحقق من وجود صفحة 404، والتي تتضمن النص "Brutus لا يمكنه العثور على ما تبحث عنه". لا تعرض صفحة 404 الحالية الصور دائمًا بسبب مشكلة في MkDocs.

تفشل عمليات إنشاء MkDocs مع الروابط الداخلية غير المعترف بها، لذا عليك التحقق يدويًا من ذلك عن طريق تعديل عنوان URL في متصفحك.

الشيكات التالية

الرابط التالي سيأخذك إلى قسم العرض التوضيحي الأول لأدوات BeeWare Docs. تم تضمينه للتحقق من الربط بين الصفحات.

انتقل إلى BeeWare Docs Tools Demo Section One لإجراء الفحوصات التالية.