YAML إلى JSON: تحويل البيانات وإنشاء الملفات وخطوط الأنابيب دون فقدان البيانات

قضيت فترة ما بعد الظهر من العام الماضي في تصحيح أخطاء ملف قيم هيلم الذي أقسم أحد الزملاء أنه صحيح. بدا كل مفتاح على ما يرام. رفضت الخدمة البدء. وتبين أن الجاني مكون من أربعة أحرف NO كرمز بلد، غير مقتبس، في قائمة المناطق. قرأها المحلل اللغوي YAML على أنها منطقية false، القالب المقدم false في الرأس، وتم رفض الطلب في اتجاه مجرى النهر مع رسالة خطأ لم تذكر YAML ولا النرويج. هذا الخطأ مشهور بما يكفي ليكون له اسم - مشكلة النرويج - وهو مجرد واحد من مجموعة من المفاجآت التي تنتظر بتنسيق يعامله معظمنا على أنه &quot؛ JSON مع مسافة بيضاء أجمل.&quot؛

ليرة تركية؛DR: ال محول يامل إلى جيسون يقوم بتوزيع مستند YAML وطباعة JSON المكافئ، وحل المراسي والأسماء المستعارة ومفاتيح الدمج والكميات القياسية على طول الطريق. إن رؤية التكوين الخاص بك كـ JSON يوضح لك بالضبط ما قرر المحلل اللغوي أن قيمك تعنيه - ما هي الأنواع التي استنتجها، وما هي المراجع التي قام بتوسيعها - قبل أن يصل هذا التفسير إلى مجموعة. يتم تشغيله بالكامل في متصفحك.

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

ماذا يفعل تحويل YAML إلى JSON بالفعل؟

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

الجزء الهيكلي غير مثير للاهتمام لأنه ميكانيكي. الجزء المثير للاهتمام هو كل ما تستطيع YAML التعبير عنه ولا تستطيع JSON التعبير عنه، لأن هذا هو المكان الذي يتعين على المحول اتخاذ قرار نيابة عنك

ميزة YAML	ما يحصل عليه JSON	لماذا يهم
التعليقات (# ...)	أسقطت	ليس لدى JSON بناء جملة للتعليق؛ الوثائق الموجودة في التكوين الخاص بك لا تبقى على قيد الحياة
المراسي والأسماء المستعارة (&base، *base)	نسخ موسعة	لا يحتوي JSON على بناء جملة مرجعي، لذلك يتم تكرار الكتل المشتركة
دمج المفاتيح (<<: *base)	تسطيح في الكائن	تتجاوز المفاتيح الصريحة المفاتيح المدمجة، وفقًا لمواصفات مفتاح الدمج
كتلة العددية (`	, &gt؛`)	سلسلة واحدة مع الهروب
وثائق متعددة (---)	مجموعة من الوثائق	تصبح حزمة Kubernetes مصفوفة JSON، عنصر واحد لكل مورد
الكتابة الضمنية	الأنواع التي تم حلها	غير مقتبس 8080 يصبح رقما، true منطقية، null لاغية

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

لماذا تتسبب الكتابة الضمنية لـ YAML&#39؛ في انقطاع حقيقي

يقوم المخطط الأساسي YAML 1.2 بحل عددية غير مقتبسة حسب النمط. تصبح الأرقام أعدادا صحيحة. تصبح الأرقام ذات العلامة العشرية أو الأس عائمة. true و false تصبح منطقية. null و ~ تصبح فارغة. كل شيء آخر هو سلسلة.

يبدو ذلك مرتبًا حتى تلبي القيم التي تبدو كنوع واحد والمقصود بها كنوع آخر

• المنافذ والمعرفات. port: 08080 ليس الرقم 8080. الصفر البادئ يجعله عددًا صحيحًا غير صالح ضمن المخطط الأساسي، لذلك يقوم معظم المحللين بإعادة السلسلة، ويفسرها بعض المحللين الأقدم على أنها ثماني. الرموز البريدية وأرقام الهواتف ومعرفات الحسابات ذات الأصفار البادئة لها نفس المشكلة.
• الإصدارات. version: 1.10 هل تعويم 1.1. لقد اختفى الصفر الزائد، ولم يحذرك أي محلل. قارن ذلك بعلامة الحاوية وفشل البحث.
• رموز البلد واللغة. ضمن YAML 1.1 - الذي لا يزال PyYAML يتبعه افتراضيًا، إلى جانب الكثير من أدوات Ruby وJava الأقدم - y، n، yes، no، on، و off هي منطقية. NO، ON، و NA هي رموز عادية تمامًا مكونة من حرفين في العالم الحقيقي.
• الأوقات والصور الستينية. YAML 1.1 يوزع أيضًا 12:30 كرقم أساسي 60، وهو 750. يمكن أن تختفي السلاسل الشبيهة بـ Cron أو السلاسل الشبيهة بالمدة إلى أعداد صحيحة.

كل واحد من هذه البيانات عبارة عن تلف صامت للبيانات، وليس خطأ في التحليل. المستند صالح، وخط الأنابيب أخضر، والقيمة خاطئة. المحول &#39؛س احتفظ بالسلاسل يوجد خيار لهذه الفئة من الاستقصاء بالضبط: قم بتشغيله وسيعود كل عدد عادي كسلسلة، حتى تتمكن من مقارنة التحويلين جنبًا إلى جنب ومعرفة القيم التي كان المحلل اللغوي يعيد تفسيرها بدقة. كل ما يعرضه JSON بدون هذا الخيار هو ما يفعله محلل الإنتاج الخاص بك على الأرجح اليوم.

الإصلاح في YAML المصدر الخاص بك هو نفسه دائمًا: اقتبس أي شيء معناه نصي. port: "8080"، version: "1.10"، region: "NO". لا تكلف عروض الأسعار شيئًا وتزيل فئة الخطأ بأكملها. إذا قمت بإنشاء YAML من JSON بدلاً من كتابته، فإن محول JSON إلى YAML يطبق هذا الاقتباس تلقائيًا على القيم الغامضة.

كيف يتم تحويل المراسي والأسماء المستعارة ودمج المفاتيح

المراسي هي YAML&#39؛s إجابة التكرار. قمت بوضع علامة على العقدة باستخدام &nameثم قم بالإشارة إليه لاحقًا بـ *name:

defaults: &defaults
  restartPolicy: Always
  terminationGracePeriodSeconds: 30

web:
  <<: *defaults
  replicas: 3

worker:
  <<: *defaults
  terminationGracePeriodSeconds: 120

ليس لدى JSON طريقة لقول &quot؛ نفس القيمة الموجودة هناك.&quot؛ لذلك يقوم المحول بتوسيع كل مرجع إلى نسخة كاملة. يصبح الإخراج أعلاه ثلاثة كائنات، كل منها يحمل كائنه الخاص restartPolicy، وJSON أطول من YAML الذي أنتجه. هذا ليس عيبًا في التحويل - هذا ما يعنيه YAML، مكتوبًا.

مفتاح الدمج << يستحق ملاحظته الخاصة لأنه من السهل الرجوع إلى الوراء لقاعدة الأسبقية الخاصة به. المفاتيح المكتوبة بشكل صريح في التعيين الفرعي تفوز بالمفاتيح التي تم سحبها بواسطة الدمج. في المثال، worker وينتهي بفترة سماح تبلغ 120، وليس 30، بغض النظر عما إذا كان خط الدمج يظهر أعلى أو أسفل المفتاح الصريح. ينفذ المحول هذه القاعدة، لذلك يوضح لك JSON التكوين الفعال بعد الدمج - وهو عادةً الشيء الذي تريد فحصه بالفعل.

يتبع من هذا استخدامان عمليان. أولاً، عندما يستخدم التكوين تثبيتًا ثقيلًا، فإن التحويل إلى JSON هو أسرع طريقة للإجابة والاقتباس؛ ما الذي تحل به هذه البيئة فعليًا؟&quot؛ بدون تشغيل النشر. ثانيًا، إذا لم يكن للاسم المستعار مرساة مطابقة - وهي نتيجة شائعة لتقسيم ملف كبير إلى عدة ملفات - يقوم المحول بالإبلاغ عنه على أنه خطأ في رقم السطر، بدلاً من إنتاج قيمة فارغة بصمت.

كيف يتم تحويل الكميات القياسية

لدى YAML طريقتان لتضمين نص متعدد الأسطر، ويتصرفان بشكل مختلف

• حرفي (|) يحافظ على كل فاصل أسطر كما هو مكتوب تمامًا. استخدمه في البرامج النصية Shell وشهادات PEM وSQL وأي شيء حساس للمسافات البيضاء.
• مطوية (>) ينضم إلى أسطر متتالية بمسافة واحدة ويتعامل مع السطر الفارغ على أنه فاصل فقرة. استخدمه للنثر الذي تريد تغليفه في الملف المصدر ولكنك انضم إلى القيمة.

كلاهما يقبل مؤشر القضم الذي يتحكم في الأسطر الجديدة اللاحقة. الافتراضي، المسمى القطع، يحتفظ بخط جديد واحد بالضبط. ناقص (|-) يجرد كل الخطوط الجديدة الزائدة. زائد (|+) يحتفظ بكل واحد منهم.

في JSON، ينهار كل هذا في سلسلة واحدة مع \n يهرب. وهذا سبب آخر يجعل وجهة نظر JSON مفيدة: فهي لا لبس فيها. أ | كتلة تم وضع مسافة بادئة لسطرها الأخير عن طريق الخطأ، أو > إن حظر الخطين المتصلين بالطي الذي كنت تنوي الاحتفاظ به منفصلين، أمر واضح في JSON وغير مرئي تقريبًا في YAML. يتعامل المحول أيضًا مع الحالة التي تلتقط التطبيقات الساذجة - أ # الحرف الموجود داخل الكتلة الحرفية هو محتوى، وليس تعليقًا، وهو أمر مهم في اللحظة التي تقوم فيها بتضمين نص Shell يبدأ بـ shebang.

كيفية استخدام محول YAML إلى JSON

الخطوة 1: لصق المستند

الصق أي YAML في لوحة الإدخال: بيان Kubernetes، أ docker-compose.yml، سير عمل إجراءات GitHub، قواعد تشغيل Ansible، أ .gitlab-ci.yml، أو تكوين التطبيق. ملفات متعددة المستندات مع --- الفواصل جيدة - يتم تحليل كل مستند بشكل مستقل. انقر تحميل العينة للبدء من عملية نشر واقعية تمارس الخرائط المتداخلة والتسلسلات والمجموعة الفارغة والكتلة العددية الحرفية.

الشيء الوحيد الذي لن يتم تحليله هو المسافة البادئة بأحرف علامة التبويب. يحظر YAML علامات التبويب تمامًا، ويقول المحول ذلك مع رقم السطر المخالف بدلاً من التخمين. المحررون الذين يقومون بإدراج علامة تبويب على Enter هم المصدر المعتاد؛ معظمها لديه &quot؛ تحويل المسافة البادئة إلى مسافات واقتباس؛ الأمر الذي يصلح الملف بأكمله مرة واحدة.

الخطوة 2: اختر شكل الإخراج

يختار 2 مساحات، 4 مساحات، أو مصغر. Minified هو ما تريده عندما تكون على وشك لصق النتيجة في ملف curl الجسم أو متغير البيئة. الإخراج ذو المسافة البادئة هو ما تريده عندما يتعين على الإنسان قراءته.

فرز المفاتيح يعيد كتابة مفاتيح الكائنات أبجديًا على كل مستوى. وهذا لا يقدر بثمن عند مقارنة نسختين من التكوين: ملفان يختلفان فقط في ترتيب المفاتيح ينتجان JSON متطابقًا تم فرزه، لذلك يظهر الفرق تغييرات حقيقية فقط. قم بتغذية كلا المخرجين في فرق JSON الأداة وستحصل على مقارنة هيكلية دقيقة بدلاً من المقارنة سطرًا تلو الآخر.

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

الخطوة 3: تحويل وقراءة الأخطاء

انقر اغتصب. إذا كان المستند جيد التكوين، فسيظهر JSON أدناه مع عدد الأسطر وعدد المفاتيح وحجم البايت و- بالنسبة لتدفقات المستندات المتعددة - عدد المستندات التي تم العثور عليها.

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

الخطوة 4: انسخ أو قم بتنزيل أو استمر

انسخ JSON إلى الحافظة الخاصة بك أو قم بتنزيله كـ .json ملف. من هناك، الخطوات التالية الشائعة هي الطباعة الجميلة والتحقق من صحتها باستخدام تنسيق JSON، إنشاء أنواع لمحمل التكوين مع json إلى TypeScript، أو استخلاص عقد للتحقق من صحة CI مع مولد مخطط JSON.

سير العمل الحقيقي يناسب هذا

تصحيح أخطاء البيان الذي &quot؛ يبدو جيدًا وحاصلًا؛

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

البرمجة النصية ضد التكوين

تتعامل البرامج النصية Shell وNode مع JSON محليًا؛ يحتاج YAML إلى التبعية. عندما أحتاج إلى سحب كل علامة صورة من مجموعة من البيانات، والتحويل إلى JSON أولاً ثم المرور عبرها jq أسرع من إضافة مكتبة YAML إلى برنامج نصي مهم. إن دعم المستندات المتعددة للمحول &#39؛ مهم هنا - تصبح حزمة Kubernetes المكونة من ستة موارد مصفوفة JSON يمكنك تكرارها.

تركيبات اختبار البناء

غالبًا ما تحتاج اختبارات التكامل إلى كائن تكوين بدلاً من ملف تكوين. يمنحك تحويل البيان الحقيقي إلى JSON أداة تثبيت مضمونة لمطابقة شكل الإنتاج، وهي نقطة بداية أفضل بكثير من الكائن الذي كتبته من الذاكرة. إقرانه مع json إلى TypeScript والتركيب الخاص بك يأتي مع أنواع.

مراجعة التكوين في طلب السحب

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

الترحيل بين الأدوات

تقبل الكثير من الأنظمة الأساسية JSON ولكن ليس YAML، أو العكس. عادةً ما يكون التحويل هو الترحيل بأكمله. عندما تحتاج إلى العودة في الاتجاه الآخر - JSON في متناول اليد، يتطلب YAML - محول JSON إلى YAML يغلق الحلقة، و مدقق يمل يؤكد توزيعات النتائج قبل الالتزام بها.

مقارنة YAML وJSON

البعد	YAML	JSON
تعليقات	نعم	لا
التحرير البشري	تعتمد على المسافة البادئة، وسهلة التصفح	علامات الترقيم ثقيلة، مطولة
تحليل الآلة	موزعون أبطأ وأكبر حجمًا، وحالات أكثر حافة	محللون سريعون وصغيرون في كل مكان
اكتب الاستدلال	ضمني، يعتمد على المخطط	صريح من بناء الجملة
مراجع	المراسي والأسماء المستعارة ودمج المفاتيح	لا أحد
وثائق متعددة لكل ملف	نعم عبر ---	لا
منزل نموذجي	تكوين الملفات وخطوط أنابيب CI والبيانات	واجهات برمجة التطبيقات، تبادل البيانات، التخزين

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

الخصوصية: لماذا يتم تشغيل هذا في متصفحك

تعد ملفات التكوين من بين أكثر عناصر النص العادي حساسية لدى الفريق. إنها تحمل أسماء المضيفين الداخلية، وأسماء المجموعات، ومسارات التسجيل، وحسابات الخدمة، ومعرفات قاعدة البيانات، و- على الرغم من أفضل نوايا الجميع &#39؛ - بيانات الاعتماد العرضية التي لم تصل إلى مدير سري بعد.

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

حدود تستحق المعرفة

لا يوجد محول يناسب علامة تبويب المتصفح ينفذ كل ركن من أركان مواصفات YAML، ومن المفيد أن تكون محددًا بشأن الحواف بدلاً من الإشارة إلى عدم وجودها.

مفاتيح التعيين المعقدة - الصريحة ? key النموذج الذي يكون فيه المفتاح في حد ذاته تسلسلًا أو تعيينًا - غير مدعوم، لأن مفاتيح كائن JSON يجب أن تكون سلاسل. اكتب علامات مثل !!binary أو مخصص !MyType لا يتم تفسير التوجيهات؛ تأتي القيمة كنص. القيم العائمة الخاصة .inf، -.inf، و .nan يتم الاحتفاظ بها كسلاسل، نظرًا لأن JSON ليس لها أي حرف حرفي وتتحول بصمت إلى null سوف تفقد معلومات أكثر مما تحفظ. توجيهات مثل %YAML 1.2 يتم تجاهلها بدلا من التصرف بناء عليها.

لا يظهر أي منها في ملفات Kubernetes أو Compose أو Actions أو Ansible العادية. إذا قمت بالضغط على واحد، فأنت تعمل مع مستند مكتوب للغة معينة &#39؛s مكتبة YAML، وتلك المكتبة &#39؛s شاحنة قلابة خاصة بها هي الأداة الصحيحة.

أسئلة وأجوبة

كيف يمكنني تحويل YAML إلى JSON عبر الإنترنت؟

الصق YAML الخاص بك في لوحة الإدخال وانقر فوق تحويل. يقرأ المحلل اللغوي المستند ، ويحل المراسي وحظر المقاييس ، ويطبع JSON المنسقة التي يمكنك نسخها أو تنزيلها. كل شيء يحدث في متصفحك ، لذلك لا يتم تحميل أي ملف.

هل JSON مجموعة فرعية من YAML؟

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

كيف يتم تحويل مراسي وأسماء YAML إلى JSON؟

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

ماذا يحدث لدمج المفاتيح مثل قوس الزاوية المزدوجة؟

يتم دمج التعيين المشار إليه في الكائن الحالي. المفاتيح المكتوبة بشكل صريح في رسم خرائط الأطفال على المفاتيح المدمجة ، والتي تطابق سلوك مواصفات مفتاح دمج YAML و Kubernetes و Ansible Toolings.

لماذا فشل YAML الخاص بي بسبب خطأ علامات التبويب؟

يحظر YAML أحرف علامات التبويب للمسافة البادئة - تسمح المواصفات بالمسافات فقط. المحررون الذين يقومون بإدراج علامات التبويب على Enter هم السبب المعتاد. قم بتحويل علامات التبويب البادئة إلى مسافات، وهو ما يمكن لمعظم المحررين القيام به لملف كامل مرة واحدة، وسيقوم المستند بالتحليل.

هل يمكنني تحويل ملف YAML متعدد المستندات باستخدام فواصل المستندات؟

نعم. يتم تحليل كل مستند بين علامات الفاصل بشكل مستقل والنتيجة هي مصفوفة JSON تحتوي على عنصر واحد لكل مستند، بترتيب المصدر. يقوم ملف مستند واحد بإرجاع الكائن نفسه، وليس مصفوفة مكونة من عنصر واحد.

هل ستحتفظ أرقام المنافذ وسلاسل الإصدار بنوعها؟

يتم حل الكميات القياسية البسيطة بواسطة مخطط YAML الأساسي، لذلك يصبح الرقم 8080 غير المقتبس هو الرقم 8080 ويصبح الرقم 1.10 غير المقتبس 1.1. اقتبس القيمة الموجودة في YAML الخاص بك لإبقائها سلسلة، أو قم بتشغيل خيار الاحتفاظ بالسلاسل لإيقاف تشغيل كل الإكراه العددي.

كيف يتم تحويل الكميات القياسية الحرفية والمطويه؟

تحتفظ الكتلة الحرفية بكل سطر جديد، لذلك تصبح سلسلة JSON مع فواصل الأسطر التي تم تجاوزها. تربط الكتلة المطوية الأسطر المتتالية بمسافة وتعامل الأسطر الفارغة على أنها فواصل فقرات. يتم احترام مؤشرات Chomping: حيث يسقط الطرح السطر الجديد الزائد وتحتفظ علامة الزائد بكل سطر فارغ خلفي.

---