> https://learn.abdulosama.com/qamoos/yaml
# YAMLصيغة الإعدادات المقروءة
## ما هو YAML؟
YAML يكتب المعلومات نفسها كقائمة مُزاحة ومرتّبة يقرأها الإنسان بسهولة.
## ما معنى YAML بالعربي؟
الاسم المعتمد الآن هو «**صيغة الإعدادات المقروءة** ». ولأن كثيرًا من المصطلحات لم يستقرّ لها اسم عربي واحد، يكتب هذا القاموس قرّاؤه: صوّت للاسم الذي تراه أوضح، أو اقترح اسمًا أفضل. نراجع الأصوات في كل جولة ونعتمد ما يختاره الناس.
1. صيغة الإعدادات المقروءة الاسم المعتمد اسم القاموس
2. يامل النطق الشائع لاسم الصيغة
3. ملف الإعدادات وصف لاستخدامه الأشهر
صوت واحد لكل قارئ في كل مصطلح، وتستطيع نقله إلى اسم آخر. حين يتجاوز اسمٌ الاسمَ المعتمد ويصل إلى 5 أصوات على الأقل، نعرضه للاعتماد في الجولة التالية.
اقترح اسمًا عربيًا أفضل هل الشرح غير واضح أو فيه خطأ؟
على اللوح الأول جدار كثيف من الأقواس وعلامات الاقتباس والفواصل، صحيح تمامًا، لكن عينك تتعب قبل أن تفهمه. على الورقة المجاورة المعلومات نفسها مكتوبة كقائمة مرتّبة: كل سطر عنوان ونقطتان وقيمة، وما ينتمي إلى شيء يُزاح تحته بمسافات قليلة. هذه الورقة هي YAML.
[JSON](https://learn.abdulosama.com/qamoos/json) مريح للآلة وقاسٍ قليلًا على الإنسان. YAML هو البيانات نفسها بعد أن تخلّصت من الأقواس والاقتباسات والفواصل، لتصير شيئًا يستطيع شخص أن يكتبه بيده دون أن يخطئ كثيرًا. قارن:
```
{ "name": "سارة", "city": "الرياض", "orders": 3 }
```
```
name: سارة
city: الرياض
orders: 3
```
المعلومات واحدة، لكن الثانية تبدو كمذكرة كتبتها لنفسك.
الفرق إذًا في القارئ لا في المحتوى. JSON هو ما تتبادله البرامج فيما بينها. YAML هو ما يكتبه الإنسان حين يضبط شيئًا بيده. ولهذا ستقابله تحديدًا في ملفات الإعدادات: الملف الذي يخبر الأداة كيف تتصرف، وأي نموذج تستخدم، وأي خيارات تُفعَّل، كثيرًا ما يكون ملف YAML تفتحه أنت أو يعدّله الوكيل.
تنبيه واحد يوفّر عليك ساعة إحباط: في YAML المسافات في بداية السطر هي المعنى نفسه، لا زينة. سطر مُزاح بمسافة زائدة أو ناقصة يغيّر ما ينتمي إلى ما، فيرفض الملف أن يُحمَّل وهو يبدو لعينك سليمًا. حين يحدث هذا، افحص الإزاحة أولًا، وتأكد أنك لم تخلط بين المسافات وزر Tab.
لحظة من حياتك: تثبّت أداة ذكاء اصطناعي على حاسوبك فتقول التعليمات «غيّر اللغة في ملف config.yaml». تفتحه فتجد أسطرًا مثل `language: en`. تستبدل `en` بـ `ar` وتحفظ. لم تكتب كودًا؛ غيّرت قيمة في قائمة.
## لماذا يهمك YAML؟
ستتوقف عن الخوف من ملفات الإعدادات، لأنها قوائم مقروءة لا برامج. وتستطيع تغيير قيمة أو تفعيل خيار بنفسك دون انتظار المطوّر، ما دمت تحترم المسافات.
## متى ستسمع كلمة YAML؟
يقول لك المطوّر: «الإعدادات كلها في ملف YAML واحد، عدّل فيه ما تريد وأرسله لي».
## كلمات قريبة
- [JSON · صيغة تبادل البيانات](https://learn.abdulosama.com/qamoos/json)
- [Schema · المخطّط](https://learn.abdulosama.com/qamoos/schema)
- [Markdown · تنسيق Markdown](https://learn.abdulosama.com/qamoos/markdown)
- [Env File · ملف البيئة](https://learn.abdulosama.com/qamoos/env-file)
## حمّل القاموس كاملًا بصيغة PDF
قاموس التقنية بالعربي: 101 مصطلحًا في كتاب واحد مصوّر، تقرؤه على هاتفك أو تطبعه. اكتب اسمك ورقم واتساب، وتنضمّ إلى قائمة عبدول على واتساب، ويظهر لك رابط التحميل فورًا.
**تمّ.** انضممت إلى القائمة، وهذا رابط القاموس. يعمل الرابط سبعة أيام، فاحفظ الملف على جهازك.
تحميل القاموس (PDF)
لن نشارك رقمك مع أحد. يمكنك الخروج من القائمة في أي وقت.
## تريد إضافته إلى موقعك؟
أداة مجانية لموقعك أو مدونتك: يظهر خط منقّط تحت مصطلحات القاموس في مقالاتك، ومن يمرّ عليها يرى اسمها العربي ومعناها، ورابطًا للشرح الكامل في صفحة جديدة. لا تجمع أي بيانات عن زوّارك.
1. **الصق هذا السطر** قبل نهاية صفحات موقعك (قبل ``):
`