مدقّق DESIGN.md

يفحص مقدمة YAML (frontmatter)، واللون الأساسي (primary) المطلوب، وأن الألوان مكتوبة بتنسيق ألوان صحيح (hex أو rgb أو hsl أو oklch أو اسم لون وما شابه)، وأن أحجام الخطوط وأنصاف أقطار الحواف بوحدات px أو em أو rem، وخصائص الخطوط والطباعة، وخصائص المكونات ومراجعها إلى الرموز (بما في ذلك المراجع المكتوبة دون علامات اقتباس، التي لا يقرؤها YAML كنص)، وقائمة العناصر المحذوفة (omitted)، والأقسام المكررة أو الواردة بترتيب خاطئ، والتباين بين لون النص ولون الخلفية في كل مكوّن مقارنةً بالحد الأدنى في WCAG AA وهو 4.5:1. الأخطاء تجعل الملف غير صالح؛ أما التحذيرات فتنبّه إلى أمور تستحق الإصلاح.

لا. يجري التحقق بالكامل في متصفحك: النص الذي تلصقه أو الملف الذي تختاره لا يُرسل أبدًا إلى خوادمنا. الطلبات الوحيدة التي ترسلها المعاينة هي طلبات أوراق أنماط الخطوط: يجلبها خادمنا من Google Fonts، ولا تحمل سوى أسماء عائلات الخطوط الواردة في رموز الخطوط لديك.

تنسيق DESIGN.md من Google كما يستخدمه Stitch وكما هو منشور في مستودع google-labs-code/design.md. يطبّق المدقّق القواعد نفسها التي يستخدمها Design Extractor لفحص كل ملف DESIGN.md ينشئه، إضافةً إلى فحص التباين في ألوان المكونات.

يجب أن يشير مرجع مثل "{colors.brand}" إلى رمز موجود في مقدمة YAML (frontmatter)، وهو هنا عنصر brand ضمن colors. أضف الرمز الناقص أو اجعل المرجع يشير إلى رمز موجود. أبقِ المراجع بين علامتي اقتباس: يقرأ YAML المرجع {colors.brand} غير المقتبس على أنه mapping لا على أنه نص.

نعم. أداة سطر الأوامر مفتوحة المصدر من Google تفحص الملف ضمن مسار العمل لديك: شغّل npx @google/design.md lint DESIGN.md. تطبع تقريرًا بصيغة JSON وتنتهي برمز الخروج 1 عند العثور على أخطاء، فتفشل المهمة إذا كان الملف معطوبًا. تتداخل مجموعة قواعدها مع هذه الصفحة، لكن درجة خطورة بعض القواعد تختلف.