कैसे Intlayer काम करता है

अवलोकन

Intlayer की भूमिका जावास्क्रिप्ट सामग्री घोषणा फ़ाइलों को शब्दकोशों में व्याख्यायित करना है।

इसके लिए, Intlayer कई चरणों से गुजरता है:

1. सामग्री फ़ाइलों की घोषणा

   • सामग्री फ़ाइलें विभिन्न स्वरूपों में परिभाषित की जा सकती हैं, जैसे TypeScript, ECMAScript, CommonJS, या JSON।
   • सामग्री फ़ाइलें परियोजना में कहीं भी परिभाषित की जा सकती हैं, जो बेहतर रखरखाव और मापनीयता की अनुमति देती हैं। सामग्री फ़ाइलों के लिए फ़ाइल एक्सटेंशन मानकों का सम्मान करना महत्वपूर्ण है। यह एक्सटेंशन डिफ़ॉल्ट रूप से *.content.{js|cjs|mjs|ts|tsx|json} है, लेकिन इसे कॉन्फ़िगरेशन फ़ाइल में संशोधित किया जा सकता है।

2. शब्दकोशों का निर्माण

   • शब्दकोश सामग्री फ़ाइलों से उत्पन्न होते हैं। डिफ़ॉल्ट रूप से, intlayer शब्दकोश परियोजना के .intlayer/dictionary डायरेक्टरी में उत्पन्न होते हैं।
   • दो प्रकार के शब्दकोश उत्पन्न किए जा सकते हैं: intlayer शब्दकोश और i18n शब्दकोश (बीटा)।

3. शब्दकोश प्रकारों का निर्माण

   • शब्दकोश प्रकार intlayer शब्दकोशों से उत्पन्न होते हैं। डिफ़ॉल्ट रूप से, intlayer शब्दकोश प्रकार परियोजना के .intlayer/types डायरेक्टरी में उत्पन्न होते हैं।

4. Intlayer मॉड्यूल वृद्धि का निर्माण

   • Intlayer मॉड्यूल वृद्धि एक TypeScript विशेषता है जो आपको Intlayer के लिए अतिरिक्त प्रकारों को परिभाषित करने की अनुमति देती है। यह विकास अनुभव को आसान बनाता है, उपलब्ध तर्कों या आवश्यक तर्कों का सुझाव देकर। उत्पन्न प्रकारों में, intlayer शब्दकोश प्रकार या यहां तक कि भाषा कॉन्फ़िगरेशन प्रकारों को types/intlayer.d.ts फ़ाइल में जोड़ा जाता है, और अन्य पैकेजों द्वारा उपयोग किया जाता है। ऐसा करने के लिए, आवश्यक है कि tsconfig.json फ़ाइल को परियोजना के .intlayer/types डायरेक्टरी को शामिल करने के लिए कॉन्फ़िगर किया जाए।

5. सामग्री फ़ाइल निगरानी

   • सामग्री फ़ाइलों की निगरानी की जाती है ताकि उन्हें प्रत्येक बार संशोधित करने पर फिर से उत्पन्न किया जा सके।

6. शब्दकोश व्याख्या

   • अंततः शब्दकोशों की व्याख्या की जाती है ताकि उन्हें अनुप्रयोगों में उपयोग किया जा सके।

पैकेज

Intlayer कई पैकेजों से मिलकर बना है, प्रत्येक का अनुवाद प्रक्रिया में विशिष्ट भूमिका है। इस पैकेज की संरचना का एक ग्राफिकल प्रतिनिधित्व यहां दिया गया है:

intlayer

intlayer पैकेज का उपयोग अनुप्रयोगों में सामग्री को सामग्री फ़ाइलों में घोषित करने के लिए किया जाता है।

react-intlayer

react-intlayer पैकेज का उपयोग intlayer शब्दकोशों की व्याख्या करने और उन्हें React अनुप्रयोगों में उपयोग योग्य बनाने के लिए किया जाता है।

next-intlayer

next-intlayer पैकेज का उपयोग react-intlayer के शीर्ष पर एक परत के रूप में किया जाता है ताकि intlayer शब्दकोशों को Next.js अनुप्रयोगों में उपयोग योग्य बनाया जा सके। यह Intlayer को Next.js वातावरण में काम करने के लिए आवश्यक सुविधाओं को एकीकृत करता है, जैसे अनुवाद मध्यवर्ती, राउटिंग, या next.config.js फ़ाइल कॉन्फ़िगरेशन।

intlayer-editor

intlayer-editor पैकेज का उपयोग दृश्य संपादक के उपयोग की अनुमति देने के लिए किया जाता है। यह पैकेज, वैकल्पिक रूप से अनुप्रयोगों में स्थापित किया जा सकता है और इसका उपयोग react-intlayer पैकेज द्वारा किया जाएगा। इसमें दो भाग होते हैं: सर्वर और क्लाइंट।

क्लाइंट में UI तत्व होते हैं जिन्हें react-intlayer द्वारा उपयोग किया जाएगा।

सर्वर, एक्सप्रेस पर आधारित, संपादक दृश्य अनुरोधों को प्राप्त करने और सामग्री फ़ाइलों का प्रबंधन या संशोधन करने के लिए उपयोग किया जाता है।

intlayer-cli

intlayer-cli पैकेज का उपयोग npx intlayer build कमांड का उपयोग करके शब्दकोश बनाने के लिए किया जा सकता है। यदि intlayer पहले से स्थापित है, तो CLI स्वचालित रूप से स्थापित हो जाता है और यह पैकेज आवश्यक नहीं है।

@intlayer/core

@intlayer/core पैकेज मुख्य Intlayer पैकेज है। इसमें अनुवाद और शब्दकोश प्रबंधन कार्य होते हैं। @intlayer/core बहु- प्लेटफार्म है और शब्दकोशों की व्याख्या करने के लिए अन्य पैकेजों द्वारा उपयोग किया जाता है।

@intlayer/config

@intlayer/config पैकेज का उपयोग Intlayer सेटिंग्स कॉन्फ़िगर करने के लिए किया जाता है, जैसे उपलब्ध भाषाएँ, Next.js मध्यवर्ती पैरामीटर या एकीकृत संपादक सेटिंग्स।

@intlayer/webpack

@intlayer/webpack पैकेज का उपयोग Next.js और React के लिए संकलन प्लगइन्स जोड़ने के लिए किया जाता है।

@intlayer/cli

@intlayer/cli पैकेज का उपयोग सभी intlayer CLI कमांडों की एकरूपता सुनिश्चित करने के लिए किया जाता है।

@intlayer/dictionaries-entry

@intlayer/dictionaries-entry पैकेज एक ऐसा पैकेज है जो केवल intlayer शब्दकोशों के प्रवेश मार्ग को वापस करता है। चूंकि ब्राउज़र से फ़ाइल प्रणाली खोज असंभव है, शब्दकोशों के प्रवेश मार्ग को पुनः प्राप्त करने के लिए बंडलर जैसे Webpack या Rollup का उपयोग करना संभव नहीं है। इस पैकेज का उद्देश्य अभिकर्ता होना है।

@intlayer/chokidar

@intlayer/chokidar पैकेज का उपयोग सामग्री फ़ाइलों की निगरानी करने और प्रत्येक परिवर्तन पर संशोधित शब्दकोश को फिर से उत्पन्न करने के लिए किया जाता है।