Intlayer कैसे काम करता है
अवलोकन
Intlayer की भूमिका JavaScript कंटेंट डिक्लरेशन फ़ाइलों को डिक्शनरी में इंटरप्रेट करना है।
इसके लिए, Intlayer कई चरणों से गुजरता है:
कंटेंट फ़ाइलों की घोषणा
- कंटेंट फ़ाइलें विभिन्न प्रारूपों में परिभाषित की जा सकती हैं, जैसे TypeScript, ECMAScript, CommonJS, या JSON।
- कंटेंट फ़ाइलें प्रोजेक्ट में कहीं भी परिभाषित की जा सकती हैं, जिससे बेहतर रखरखाव और स्केलेबिलिटी का अनुभव होता है। यह महत्वपूर्ण है कि कंटेंट फ़ाइलों के लिए फ़ाइल एक्सटेंशन की परंपराओं का पालन किया जाए। यह एक्सटेंशन डिफ़ॉल्ट रूप से *.content.{js|cjs|mjs|ts|tsx|json} है, लेकिन इसे कॉन्फ़िगरेशन फ़ाइल में संशोधित किया जा सकता है।
डिक्शनरी उत्पन्न करना
- डिक्शनरी कंटेंट फ़ाइलों से उत्पन्न होती हैं। डिफ़ॉल्ट रूप से, Intlayer की डिक्शनरी प्रोजेक्ट के .intlayer/dictionary निर्देशिका में उत्पन्न होती हैं।
- दो प्रकार की डिक्शनरी उत्पन्न की जा सकती हैं: Intlayer डिक्शनरी और i18n डिक्शनरी (बीटा)।
डिक्शनरी प्रकारों का उत्पादन
- डिक्शनरी प्रकार Intlayer डिक्शनरी से उत्पन्न होते हैं। डिफ़ॉल्ट रूप से, Intlayer डिक्शनरी प्रकार प्रोजेक्ट के types निर्देशिका में उत्पन्न होते हैं।
Intlayer मॉड्यूल संवर्द्धन का उत्पादन
- Intlayer मॉड्यूल संवर्द्धन एक TypeScript फीचर है जिसका उपयोग आप Intlayer के लिए अतिरिक्त प्रकार परिभाषित करने के लिए कर सकते हैं। इससे विकास अनुभव आसान होता है, उपलब्ध तर्कों या आवश्यक तर्कों का सुझाव देकर। उत्पन्न ऑनलाइन प्रकारों में, Intlayer डिक्शनरी प्रकार या यहां तक कि भाषा कॉन्फ़िगरेशन प्रकार types/intlayer.d.ts फ़ाइल में जोड़े जाते हैं, और अन्य पैकेजों द्वारा उपयोग किए जाते हैं। ऐसा करने के लिए आवश्यक है कि tsconfig.json फ़ाइल को प्रोजेक्ट के types निर्देशिका को शामिल करने के लिए कॉन्फ़िगर किया गया हो।
कंटेंट फ़ाइलों की निगरानी
- कंटेंट फ़ाइलों की निगरानी की जाती है ताकि उन्हें प्रत्येक बार संशोधित करने पर फिर से उत्पन्न किया जा सके।
डिक्शनरी व्याख्या
- अंत में डिक्शनरी को अनुप्रयोगों में उपयोग करने के लिए व्याख्या की जाती है।
पैकेज
Intlayer कई पैकेजों से बना है, प्रत्येक का अनुवाद प्रक्रिया में एक विशिष्ट भूमिका होती है। इस पैकेज की संरचना का ग्राफिकल प्रतिनिधित्व यहां है:
intlayer
intlayer पैकेज का उपयोग अनुप्रयोगों में कंटेंट फ़ाइलों में कंटेंट घोषित करने के लिए किया जाता है।
react-intlayer
react-intlayer पैकेज का उपयोग Intlayer डिक्शनरी को व्याख्या करने और उन्हें React अनुप्रयोगों में उपयोग करने योग्य बनाने के लिए किया जाता है।
next-intlayer
next-intlayer पैकेज का उपयोग react-intlayer के शीर्ष पर एक परत के रूप में किया जाता है ताकि Intlayer डिक्शनर को Next.js अनुप्रयोगों में उपयोगी बनाया जा सके। यह अनुवाद मिडलवेयर, राउटिंग, या next.config.js फ़ाइल कॉन्फ़िगरेशन जैसे आवश्यक सुविधाओं को शामिल करता है।
vite-intlayer
Intlayer को Vite बंडलर के साथ एकीकृत करने के लिए Vite प्लगइन शामिल करता है, साथ ही उपयोगकर्ता की पसंद के लोकल को पहचानने, कुकी प्रबंधन, और URL पुनर्निर्देशन को संभालने के लिए मिडलवेयर भी शामिल करता है।
react-scripts-intlayer
Create React App आधारित अनुप्रयोग के लिए Intlayer को एकीकृत करने के लिए react-scripts-intlayer कमांड और प्लगइन्स शामिल करता है। ये प्लगइन्स craco पर आधारित हैं और Webpack बंडलर के लिए अतिरिक्त कॉन्फ़िगरेशन शामिल करते हैं।
intlayer-editor
intlayer-editor पैकेज का उपयोग दृश्य संपादक का उपयोग करने की अनुमति देने के लिए किया जाता है। यह पैकेज, वैकल्पिक है और अनुप्रयोगों में स्थापित किया जा सकता है और react-intlayer पैकेज द्वारा उपयोग किया जाएगा। इसमें दो भाग होते हैं: सर्वर और क्लाइंट।
क्लाइंट में UI तत्व होते हैं जो react-intlayer द्वारा उपयोग किए जाएंगे।
सर्वर, Express पर आधारित है, संपादक दृश्य अनुरोध प्राप्त करने और कंटेंट फ़ाइलों को प्रबंधित या संशोधित करने के लिए उपयोग किया जाता है।
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 पैकेज का उपयोग 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 पैकेज का उपयोग कंटेंट फ़ाइलों की निगरानी करने और प्रत्येक संशोधन पर संशोधित डिक्शनरी को फिर से उत्पन्न करने के लिए किया जाता है।
हमारी स्मार्ट डॉक्यूमेंटेशन से बात करें
अगर आपके पास इस दस्तावेज़ को सुधारने के लिए कोई विचार है, तो कृपया GitHub पर एक पुल अनुरोध सबमिट करके योगदान देने में संकोच न करें।
दस्तावेज़ के लिए GitHub लिंक