nindent مقابل indent عمليًا

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

تضيف الدالة indent عددًا ثابتًا من المسافات إلى بداية كل سطر في سلسلة نصية، فتنقل كتلة كاملة إلى اليمين.

إليك الأمر المهم: تنقل indent كل سطر، لكنها لا تضيف سطرًا جديدًا في البداية. لذلك يستقر السطر الأول في الموضع الذي يوجد فيه الإجراء مباشرةً.

تجري الدالة nindent عملية الإزاحة نفسها، لكنها تطبع أولًا سطرًا جديدًا، فتبدأ الكتلة بنظافة في سطر جديد مستقل.

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

ستستخدم nindent غالبًا عند وضع كتلة toYaml تحت مفتاح، لأنها تضع الخريطة الناتجة أسفل المفتاح بشكل منظم.

حدّد العدد بعدّ المسافات بدءًا من المفتاح الأب، لا من العمود صفر. يحتاج العنصر المتداخل بمستويين عادةً إلى nindent 4.

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

تتدرج معظم بنى YAML بمقدار مسافتين. ويُعدّ الخطأ بمقدار مسافتين في عدد nindent السبب الأكثر شيوعًا لفشل المخطط في التحليل.

لا تخمّن المستوى أبدًا. شغّل helm template واقرأ الناتج الخام للتأكد من محاذاة أسطر الكتلة المدرجة تحت مفتاحها الأب.

تقرأ كلتا الدالتين المساعدتين السلسلة النصية من الأنبوب على يسارهما، لذا تتوافقان طبيعيًا مع toYaml لتنسيق خريطة كاملة داخل البيان.

تكتب {{ toYaml .Values.env | indent 4 }} مباشرةً بعد مفتاح في السطر نفسه، فيصبح YAML غير صالح.

تعرف الآن أن indent تضيف مسافات إلى كتلة، وأن nindent تضيف سطرًا جديدًا أولًا، وأن التصيير هو الطريقة الأوثق للتأكد من المستوى. 🧹