JSON केही कडा नियमहरू भएको साधारण पाठ (plain text) हो। Notepad मा यसलाई सजिलै लेख्न सकिन्छ। धेरै मानिसहरूले बिगार्ने भनेको यसको सिन्ट्याक्स हो, टुल (औजार) होइन। यदि तपाईंले संरचना (structure) सहि तरिकाले मिलाउनुभयो भने, फाइल सेभ गर्ने काम एकदमै सजिलो छ।
Notepad मा .JSON फाइल कसरी बनाउने
JSON फाइल भनेको के हो?
JSON को पुरा अर्थ JavaScript Object Notation हो। यसले डेटालाई कर्ली ब्रेस ({ }) भित्र 'की-भ्यालु' (key-value) जोडीको रूपमा भण्डारण गर्छ, जसमा नेस्टेड अब्जेक्ट र एरेहरू राख्न सकिन्छ। एप्स, API र कन्फिग फाइलहरूले यसको प्रयोग गर्छन् किनकि यो हल्का हुन्छ र सबै प्रमुख प्रोग्रामिङ भाषाहरूले यसलाई पढ्न सक्छन्।
एउटा साधारण JSON फाइल यस्तो देखिन्छ:
{ "name": "John", "age": 28, "isActive": true, "skills": ["writing", "editing"]}स्टेप-बाइ-स्टेप: Notepad मा JSON फाइल बनाउनुहोस्
स्टेप १: Notepad खोल्नुहोस्
आफ्नो कम्प्युटरमा Notepad खोल्नुहोस्, वा कुनै पनि ब्राउजरबाट निःशुल्क अनलाइन नोटप्याड को प्रयोग गर्नुहोस्।
स्टेप २: सुरुको ब्रेसबाट सुरु गर्नुहोस्
प्रत्येक JSON फाइल अब्जेक्टका लागि { वा एरेका लागि [ बाट सुरु हुन्छ। धेरैजसो फाइलहरू अब्जेक्टबाट सुरु हुन्छन्।
स्टेप ३: आफ्नो की (key) र भ्यालु (value) थप्नुहोस्
प्रत्येक कीलाई डबल कोट्समा लेख्नुहोस्, त्यसपछि कोलन लगाउनुहोस् र भ्यालु राख्नुहोस्। प्रत्येक जोडीलाई कमा (comma) ले छुट्याउनुहोस्।
{ "title": "Sample File", "version": 1}स्टेप ४: फाइललाई सही तरिकाले बन्द गर्नुहोस्
प्रत्येक खुल्ला ब्रेस वा ब्र्याकेटलाई बन्द गर्ने ब्रेस वा ब्र्याकेटसँग मिलाउनुहोस्। अब्जेक्ट वा एरेको अन्तिम की-भ्यालु जोडी पछाडि कमा (comma) राख्नु हुँदैन।
स्टेप ५: .json एक्सटेन्सनका साथ सेभ गर्नुहोस्
File मा जानुहोस् र Save As मा क्लिक गर्नुहोस्। "Save as type" ड्रपडाउनमा 'All Files' छान्नुहोस्। फाइलको नामको अन्त्यमा .json जोड्नुहोस्, उदाहरणका लागि: data.json। यो ड्रपडाउन नबदली सेभ गर्दा फाइल .txt को रूपमा रहन्छ र त्यसलाई JSON को रूपमा पढ्न सकिँदैन।
स्टेप ६: प्रयोग गर्नु अघि भ्यालिडेट (Validate) गर्नुहोस्
फाइललाई कुनै पनि JSON एडिटर मा राखेर यो सही छ कि छैन भनी जाँच गर्नुहोस्। यसले पछि स्क्रिप्ट वा एपमा आउन सक्ने समस्याहरूबाट तपाईंलाई बचाउँछ।
याद राख्नुपर्ने JSON सिन्ट्याक्स नियमहरू
केवल डबल कोट्स (Double quotes)। की (Key) र स्ट्रिङ भ्यालुहरूमा डबल कोट्स आवश्यक छ, सिंगल कोट्स होइन।
अन्त्यमा कमा नराख्नुहोस्। अब्जेक्ट वा एरेको अन्तिम आइटम पछि कमा हुनु हुँदैन।
कमेन्ट राख्न पाइँदैन। स्ट्यान्डर्ड JSON ले फाइल भित्र // वा /* */ जस्ता नोट्सहरू सपोर्ट गर्दैन।
बुलियन (Booleans) सानो अक्षरमा हुन्छन्। True वा FALSE होइन, true र false को प्रयोग गर्नुहोस्।
नम्बरलाई कोट्सको आवश्यकता पर्दैन। यदि भ्यालु टेक्स्टको रूपमा राख्ने होइन भने, "28" होइन, २८ लेख्नुहोस्।
सामान्य त्रुटिहरू र तिनीहरूलाई कसरी हटाउने
समस्या: की-भ्यालु जोडीहरू बीच कमा छुटेको। समाधान: अन्तिम जोडी बाहेक हरेक जोडी पछि कमा हुनु आवश्यक छ।
समस्या: नमिलेका ब्र्याकेट वा ब्रेसहरू। समाधान: आफ्ना {} र [] जोडीहरू गन्नुहोस्। भ्यालिडेटरले तपाईंलाई कुन लाइनमा समस्या छ भन्ने कुरा प्रस्ट देखाइदिन्छ।
समस्या: स्ट्रिङ भित्र एस्केप नगरिएका कोट्स। समाधान: भित्री कोट्सहरूलाई ब्याकस्ल्यास (") को प्रयोग गरेर एस्केप गर्नुहोस्, जस्तै "He said \"hello\"".
समस्या: कोट्स बिनाको की (Key)। समाधान: प्रत्येक कीलाई डबल कोट्स भित्र राख्नु अनिवार्य छ, चाहे त्यो id वा name जस्तै साधारण नै किन नहोस्।
निष्कर्ष
एउटा JSON फाइल भनेको केवल एउटा यस्तो टेक्स्ट हो जसले कडा ढाँचा पालना गर्छ। आफ्नो की र भ्यालुहरूलाई डबल कोट्समा लेख्नुहोस्, ब्र्याकेटहरू मिलाउनुहोस्, अन्तिम कमा हटाउनुहोस् र यसलाई .json एक्सटेन्सनका साथ सेभ गर्नुहोस्। प्रयोग गर्नु अघि एक पटक भ्यालिडेटरमा जाँच गर्नुहोस्, यति गरेपछि तपाईंको काम सकियो।