इसका इस्तेमाल कैसे करें
- एक JSON ऑब्जेक्ट JSON ऑब्जेक्ट में चिपकाएँ। पूरा टेक्स्ट एक ऑब्जेक्ट होना चाहिए, सबसे ऊपर {} के साथ।
- जाँच पढ़ें। हरा मतलब है कि ऑब्जेक्ट बदल गया; लाल नाम बताता है कि समस्या कहाँ है और क्यों।
- TOML का परिणाम फ़ाइल में कॉपी करें, या config.toml के रूप में डाउनलोड करें।
TOML का ढाँचा कैसे बनता है
हर टेबल के सादे मान पहले लिखे जाते हैं, और उसकी उप-टेबल बाद में आती हैं। TOML को यही क्रम चाहिए, क्योंकि किसी टेबल के मान उसकी उप-टेबल खोलने वाले हेडर से पहले आने चाहिए। नाम JSON वाले क्रम में रहते हैं।
- ऑब्जेक्ट के अंदर का ऑब्जेक्ट अपने हेडर वाली टेबल बनता है, जैसे [owner], और उसके मान हेडर के बाद आते हैं।
- ऑब्जेक्ट की सूची टेबल की सरणी बनती है: हर ऑब्जेक्ट के लिए एक हिस्सा, जिसका हेडर दोहरे ब्रैकेट में होता है।
- संख्याओं या टेक्स्ट की सूची एक लाइन पर वर्गाकार ब्रैकेट में रहती है, जिसकी TOML अनुमति देता है।
- जिस संख्या में बिंदु या घात हो, वह फ़्लोट के रूप में लिखी जाती है, इसलिए 1.0 वैसा ही रहता है। जिसमें यह न हो, वह पूर्णांक लिखी जाती है।
TOML क्या नहीं रख सकता
- null। TOML में null नहीं होता, इसलिए null वाला नाम बदलाव रोकता है और संदेश में उसका नाम लिखा जाता है। नाम हटाएँ या उसे कोई मान दें।
- 64-बिट की सीमा से बाहर का पूर्णांक। JSON किसी भी आकार की संख्या देता है, पर TOML 9223372036854775807 पर रुकता है।
- सबसे ऊपर की सूची या अकेला मान। TOML दस्तावेज हमेशा एक टेबल होता है, इसलिए JSON एक ऑब्जेक्ट होना चाहिए।
उद्धरण चाहने वाले नाम
सिर्फ अक्षरों, अंकों, अंडरस्कोर और डैश से बना नाम जैसा है वैसा लिखा जाता है। कोई और नाम, जैसे स्पेस या बिंदु वाला, दोहरे उद्धरण चिह्नों में लिखा जाता है, और खाली नाम भी। टेक्स्ट में उद्धरण चिह्न, बैकस्लैश और कंट्रोल अक्षर उसी तरह एस्केप होते हैं जैसा TOML माँगता है।
उदाहरण: एक सूची, एक फ़्लोट और एक ऑब्जेक्ट
नीचे JSON में टूल के लिखे हर प्रकार का एक मान है। हर पंक्ति JSON मान और वह TOML लाइन देती है जो वह बनता है।
| JSON मान | TOML लाइन |
|---|---|
| "ports": [8000, 8001] | ports = [8000, 8001] |
| "ratio": 1.0 | ratio = 1.0 |
| "owner": {"name": "रीना"} | [owner], फिर name = "रीना" |
अक्सर पूछे जाने वाले सवाल
किसी टेबल के मान उसकी उप-टेबल से पहले क्यों आते हैं?
TOML को चाहिए कि हर टेबल के अपने मान उसकी उप-टेबल के हेडर से पहले आएँ। टूल पहले मान लिखता है, इसलिए फ़ाइल सही पढ़ी जाती है और वैसी दिखती है जैसी इंसान हाथ से लिखता।
एक संख्या 1.0 और दूसरी 1 क्यों लिखी गई?
JSON की वह संख्या जिसमें बिंदु या घात हो, जैसे 1.0 या 2e3, TOML में फ़्लोट होती है, और जिसमें न हो वह पूर्णांक होती है। टूल यह फर्क रखता है, इसलिए फ़्लोट कभी पूर्णांक नहीं लिखा जाता।
null बदलाव क्यों रोकता है?
TOML में null मान नहीं होता, इसलिए टूल उसे बिना डेटा बदले नहीं लिख सकता। null वाला नाम हटाएँ, या उसे कोई मान दें, जैसे खाली टेक्स्ट, और फिर से बदलें।
क्या JSON की तारीख TOML की तारीख बनती है?
नहीं। JSON में तारीख एक स्ट्रिंग है, और स्ट्रिंग स्ट्रिंग ही रहती है, इसलिए TOML में तारीख उद्धरण चिह्नों में रहती है। अगर TOML फ़ाइल को असली तारीख चाहिए, तो उद्धरण हाथ से हटाकर उसे तारीख बनाएँ।
क्या मेरा चिपकाया JSON कहीं भेजा जाता है?
नहीं। बदलने का काम आपके ब्राउज़र में होता है, और जो आप चिपकाते हैं वह न सहेजा जाता है, न हमें भेजा जाता है। फिर भी किसी ऐसे पेज पर पासवर्ड या टोकन न चिपकाएँ जिस पर आपको भरोसा न हो।
स्रोत
- TOML v1.0.0 specification (अंग्रेजी में)
- RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format (अंग्रेजी में)
आँकड़े और टेक्स्ट आखिरी बार बुधवार, 11 नवंबर 2026 को जाँचे गए।