محوّل جيسون إلى TOML

طريقة الاستخدام

1. الصق كائن JSON في كائن JSON. يجب أن يكون النص كله كائناً واحداً بأقواس معقوفة في الأعلى.
2. اقرأ الفحص. الأخضر يعني أن الكائن تحوّل، والأحمر يذكر الاسم الذي فيه المشكلة والسبب.
3. انسخ مخرج TOML إلى ملف، أو نزّله ملفاً باسم config.toml.

كيف يُكتب TOML

تُكتب قيم كل جدول أولاً، ثم تأتي جداوله الفرعية بعدها. وتحتاج TOML إلى هذا الترتيب، لأن قيم الجدول يجب أن تسبق الترويسات التي تفتح جداوله الفرعية. وتحتفظ الأسماء بترتيبها في JSON.

• الكائن داخل كائن يصبح جدولاً له ترويسة خاصة، مثل [owner]، وتأتي قيمه بعد الترويسة.
• قائمة الكائنات تصبح مصفوفة من الجداول: قسم لكل كائن، وترويسته بين قوسين مزدوجين.
• قائمة الأعداد أو النصوص تبقى في سطر واحد بين أقواس مربعة، وهذا ما تسمح به TOML.
• العدد الذي فيه نقطة أو أس يُكتب عدداً عشرياً، فيبقى 1.0 كما هو. والعدد الذي لا يحمل أياً منهما يُكتب عدداً صحيحاً.

ما الذي لا تستطيع TOML حمله

• القيمة null. لا تملك TOML قيمة null، لذلك يوقف الاسم الذي يحملها التحويل، ويُذكر في الرسالة. احذف الاسم أو أعطه قيمة.
• عدد صحيح خارج النطاق الموقّع 64 بت. يسمح JSON بأي حجم، لكن TOML تتوقف عند 9223372036854775807.
• مستوى أعلى يكون قائمة أو قيمة مفردة. مستند TOML دائماً جدول، لذلك يجب أن يكون JSON كائناً.

الأسماء التي تحتاج إلى علامات اقتباس

الاسم المكوّن من حروف وأرقام وشرطات سفلية وشرطات عادية يُكتب كما هو. أما أي اسم آخر، مثل اسم فيه مسافة أو نقطة، فيُكتب بين علامتي اقتباس مزدوجتين، وكذلك الاسم الفارغ. وتُهرَّب علامات الاقتباس والشرطات المائلة العكسية ورموز التحكم في النص كما تقتضي TOML.

الأسئلة الشائعة