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

अवलोकन

Intlayer का कार्य JavaScript सामग्री घोषणा फ़ाइलों को शब्दकोशों में अनुवाद करना है।

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

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

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

2. शब्दकोशों की पीढ़ी

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

3. शब्दकोश प्रकारों की पीढ़ी

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

4. Intlayer मॉड्यूल वृद्धि की पीढ़ी

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

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

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

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

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

पैकेज

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

intlayer

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

react-intlayer

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

next-intlayer

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

vite-intlayer

Vite बंडलर के साथ Intlayer को एकीकृत करने के लिए Vite प्लगइन शामिल करता है, साथ ही उपयोगकर्ता की पसंदीदा भाषा का पता लगाने, कुकीज़ प्रबंधित करने और URL पुनर्निर्देशन को संभालने के लिए मिडलवेयर।

react-scripts-intlayer

react-scripts-intlayer कमांड और प्लगइन्स शामिल करता है जो Intlayer को Create React App आधारित अनुप्रयोग के साथ एकीकृत करते हैं। ये प्लगइन्स craco पर आधारित हैं और Webpack बंडलर के लिए अतिरिक्त कॉन्फ़िगरेशन शामिल करते हैं।

intlayer-editor

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

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

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

intlayer-cli

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

@intlayer/core

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

@intlayer/config

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

@intlayer/webpack

@intlayer/webpack पैकेज का उपयोग Webpack आधारित अनुप्रयोग के साथ Intlayer को काम करने के लिए Webpack कॉन्फ़िगरेशन प्रदान करने के लिए किया जाता है। यह पैकेज एक मौजूदा Webpack अनुप्रयोग में जोड़ने के लिए एक प्लगइन भी प्रदान करता है।

@intlayer/cli

@intlayer/cli पैकेज एक NPM पैकेज है जिसका उपयोग intlayer कमांड लाइन इंटरफेस से संबंधित स्क्रिप्ट को घोषित करने के लिए किया जाता है। यह सभी intlayer CLI कमांड की एकरूपता सुनिश्चित करता है। यह पैकेज विशेष रूप से intlayer-cli, और intlayer पैकेजों द्वारा उपयोग किया जाता है।

@intlayer/dictionaries-entry

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

@intlayer/chokidar

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

@intlayer/editor

@intlayer/editor पैकेज शब्दकोश संपादक से संबंधित उपयोगिताओं को प्रदान करता है। इसमें विशेष रूप से Intlayer संपादक के साथ एक अनुप्रयोग को इंटरफेस करने के लिए API और शब्दकोशों को हेरफेर करने के लिए उपयोगिताएँ शामिल हैं। यह पैकेज क्रॉस-प्लेटफ़ॉर्म है।

@intlayer/editor-react

@intlayer/editor-react पैकेज React अनुप्रयोग को Intlayer संपादक के साथ इंटरफेस करने के लिए राज्यों, संदर्भों, हुक और घटकों को प्रदान करता है।

हमारी स्मार्ट डाक्यूमेंटेशन के साथ चैट करें

• हमारी स्मार्ट डाक्यूमेंटेशन से अपने सवाल पूछें