YAMLصيغة الإعدادات المقروءة

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

JSON مريح للآلة وقاسٍ قليلًا على الإنسان. YAML هو البيانات نفسها بعد أن تخلّصت من الأقواس والاقتباسات والفواصل، لتصير شيئًا يستطيع شخص أن يكتبه بيده دون أن يخطئ كثيرًا. قارن:

{ "name": "سارة", "city": "الرياض", "orders": 3 }

name: سارة
city: الرياض
orders: 3

المعلومات واحدة، لكن الثانية تبدو كمذكرة كتبتها لنفسك.

الفرق إذًا في القارئ لا في المحتوى. JSON هو ما تتبادله البرامج فيما بينها. YAML هو ما يكتبه الإنسان حين يضبط شيئًا بيده. ولهذا ستقابله تحديدًا في ملفات الإعدادات: الملف الذي يخبر الأداة كيف تتصرف، وأي نموذج تستخدم، وأي خيارات تُفعَّل، كثيرًا ما يكون ملف YAML تفتحه أنت أو يعدّله الوكيل.

تنبيه واحد يوفّر عليك ساعة إحباط: في YAML المسافات في بداية السطر هي المعنى نفسه، لا زينة. سطر مُزاح بمسافة زائدة أو ناقصة يغيّر ما ينتمي إلى ما، فيرفض الملف أن يُحمَّل وهو يبدو لعينك سليمًا. حين يحدث هذا، افحص الإزاحة أولًا، وتأكد أنك لم تخلط بين المسافات وزر Tab.

لحظة من حياتك: تثبّت أداة ذكاء اصطناعي على حاسوبك فتقول التعليمات «غيّر اللغة في ملف config.yaml». تفتحه فتجد أسطرًا مثل language: en. تستبدل en بـ ar وتحفظ. لم تكتب كودًا؛ غيّرت قيمة في قائمة.