أخطاء إزاحة YAML الشائعة

في YAML، لا تُعد المسافات للزينة. فالمسافة البادئة وحدها تحدد العناصر المتداخلة تحت غيرها، ولذلك يمكن لمسافة واحدة في غير موضعها أن تعيد تشكيل البيان بأكمله. 😬

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

يحظر YAML استخدام علامات التبويب للمسافات البادئة، بلا استثناء. تؤدي علامة تبويب عارضة إلى خطأ تحليل مربك، لذا اضبطوا محرركم لإدراج المسافات.

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

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

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

تستخدم معظم المخططات nindent بدلًا من ذلك. فهي تضيف سطرًا جديدًا في البداية أولًا، ثم تضيف المسافات البادئة، فتبدأ الكتلة بصورة سليمة في سطر مستقل.

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

عندما تصبح قيمة قالب قائمة، يحتاج كل عنصر إلى شرطة في مستوى المسافة البادئة الصحيح. ويتولى toYaml مع nindent ذلك عادةً بطريقة سليمة.

تكون أخطاء المسافات البادئة غير مرئية في المصدر، لكنها واضحة في الناتج. صيّروا المخطط وافحصوا YAML الخام لاكتشاف الكتل غير المحاذاة بسرعة. 👀

شغّلوا helm lint لاكتشاف كثير من مشكلات YAML والمسافات البادئة قبل أن تحاولوا تثبيت المخطط على عنقود.

تستمر الكتلة التي حقنتموها في الالتصاق بمفتاح YAML الموجود فوقها.

يمكنكم الآن تجنب المشكلات الشائعة: لا تستخدموا علامات التبويب، واستخدموا nindent للكتل السليمة، وصيّروا YAML أو شغّلوا lint للتحقق منه دائمًا. 🎯