Author:
    Creation:2025-08-23Last update:2026-09-06

    Intlayer दस्तावेज़ीकरण

    आधिकारिक Intlayer दस्तावेज़ीकरण में आपका स्वागत है! यहाँ, आपको अपने सभी अंतर्राष्ट्रीयकरण (i18n) आवश्यकताओं के लिए Intlayer को एकीकृत (integrate), कॉन्फ़िगर और मास्टर करने के लिए आवश्यक सब कुछ मिलेगा, चाहे आप Next.js, React, Vite, Express, या किसी अन्य JavaScript वातावरण के साथ काम कर रहे हों।

    परिचय

    Intlayer क्या है?

    Intlayer एक अंतर्राष्ट्रीयकरण (internationalization) लाइब्रेरी है जिसे विशेष रूप से JavaScript डेवलपर्स के लिए डिज़ाइन किया गया है। यह आपके कोड में कहीं भी आपके कंटेंट को डिक्लेयर करने की अनुमति देता है। यह बहुभाषी कंटेंट के डिक्लेरेशन को आपके कोड में आसानी से एकीकृत करने के लिए संरचित शब्दकोशों (structured dictionaries) में परिवर्तित करता है। TypeScript का उपयोग करके, Intlayer आपके विकास को मजबूत और अधिक कुशल बनाता है।

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

    उपयोग का उदाहरण

    bash
    .
    └── Components
        └── MyComponent
            ├── index.content.ts
            └── index.tsx
    
    src/components/MyComponent/index.content.ts
    import { t, type Dictionary } from "intlayer";
    
    const componentContent = {
      key: "component-key",
      content: {
        myTranslatedContent: t({
          en: "Hello World",
          es: "Hola Mundo",
          fr: "Bonjour le monde",
          hi: "नमस्ते दुनिया",
        }),
      },
    } satisfies Dictionary;
    
    export default componentContent;
    
    src/components/MyComponent/index.tsx
    import type { FC } from "react";
    import { useIntlayer } from "react-intlayer";
    
    export const MyComponent: FC = () => {
      const { myTranslatedContent } = useIntlayer("component-key");
    
      return <span>{myTranslatedContent}</span>;
    };
    

    विकल्पों के स्थान पर Intlayer क्यों?

    next-intl या i18next जैसे मुख्य समाधानों की तुलना में, Intlayer एक ऐसा समाधान है जो एकीकृत अनुकूलन (optimizations) के साथ आता है जैसे:

    अपने पृष्ठों में बड़े JSON फ़ाइलों को लोड करने के बजाय, केवल आवश्यक कंटेंट को लोड करें। Intlayer आपके बंडल और पृष्ठ के आकार को 50% तक कम करने में मदद करता है।

    अपने एप्लिकेशन के कंटेंट को स्कोप करना बड़े पैमाने के एप्लिकेशनों के लिए रखरखाव को आसान बनाता है। आप अपने संपूर्ण कंटेंट कोडबेस की समीक्षा करने के मानसिक बोझ के बिना एक सिंगल फीचर फ़ोल्डर को डुप्लिकेट या हटा सकते हैं। इसके अतिरिक्त, आपके कंटेंट की सटीकता सुनिश्चित करने के लिए Intlayer पूरी तरह से टाइप (fully typed) किया गया है।

    कंटेंट का सह-स्थान (Co-locating) बड़े भाषा मॉडल (LLMs) द्वारा आवश्यक संदर्भ को कम करता है। Intlayer AI एजेंटों के लिए डेवलपर अनुभव (DX) को और भी सुगम बनाने के लिए लापता अनुवादों का परीक्षण करने के लिए CLI, LSP, MCP और agent skills जैसे उपकरणों के एक सूट के साथ आता है।

    अपने AI प्रदाता की लागत पर अपनी पसंद के LLM का उपयोग करके अपने CI/CD पाइपलाइन में अनुवाद करने के लिए स्वचालन का उपयोग करें। Intlayer कंटेंट निष्कर्षण को स्वचालित करने के लिए एक कंपाइलर (compiler) और पृष्ठभूमि में अनुवाद करने में मदद करने के लिए एक वेब प्लेटफ़ॉर्म भी प्रदान करता है।

    विशाल JSON फ़ाइलों को घटकों (components) से जोड़ने से प्रदर्शन और प्रतिक्रिया (reactivity) संबंधी समस्याएं हो सकती हैं। Intlayer निर्माण के समय (build time) आपके कंटेंट के लोडिंग को अनुकूलित करता है।

    केवल एक i18n समाधान से अधिक, Intlayer आपके बहुभाषी कंटेंट को रीयल-टाइम में प्रबंधित करने में मदद करने के लिए एक सेल्फ-होस्टेड विज़ुअल एडिटर और एक पूर्ण CMS प्रदान करता है, जिससे अनुवादकों, कॉपीराइटरों और टीम के अन्य सदस्यों के साथ सहज सहयोग संभव हो जाता है। कंटेंट को स्थानीय और/या दूरस्थ रूप से संग्रहीत किया जा सकता है।

    मुख्य विशेषताएँ

    Intlayer आधुनिक वेब विकास की आवश्यकताओं को पूरा करने के लिए तैयार की गई विभिन्न सुविधाएँ प्रदान करता है। नीचे विस्तृत दस्तावेज़ीकरण के लिंक के साथ प्रमुख सुविधाएँ दी गई हैं:

    • अंतर्राष्ट्रीयकरण समर्थन: अंतर्राष्ट्रीयकरण के लिए अंतर्निहित समर्थन के साथ अपने एप्लिकेशन की वैश्विक पहुँच को बढ़ाएँ।
    • विज़ुअल एडिटर: Intlayer के लिए डिज़ाइन किए गए एडिटर प्लगइन्स के साथ अपने विकास वर्कफ़्लो में सुधार करें। विज़ुअल एडिटर गाइड देखें।
    • कॉन्फ़िगरेशन का लचीलापन: कॉन्फ़िगरेशन गाइड में विस्तृत रूप से कॉन्फ़िगरेशन विकल्पों के साथ अपने सेटअप को अनुकूलित करें।
    • उन्नत CLI उपकरण: Intlayer के कमांड लाइन इंटरफ़ेस का उपयोग करके अपने प्रोजेक्ट्स को कुशलतापूर्वक प्रबंधित करें। CLI उपकरण दस्तावेज़ीकरण में क्षमताओं का अन्वेषण करें।

    मुख्य अवधारणाएँ

    शब्दकोश (Dictionary)

    हर चीज़ को सुसंगत और बनाए रखने योग्य रखने के लिए अपने बहुभाषी कंटेंट को अपने कोड के करीब व्यवस्थित करें।

    • शुरुआत (Get Started)
      Intlayer में अपने कंटेंट की घोषणा करने की मूल बातें सीखें।

    • अनुवाद (Translation)
      समझें कि आपके एप्लिकेशन में अनुवाद कैसे उत्पन्न, संग्रहीत और उपयोग किए जाते हैं।

    • गणना (Enumeration)
      विभिन्न भाषाओं में दोहराए गए या निश्चित डेटासेट को आसानी से प्रबंधित करें।

    • स्थिति (Condition)
      गतिशील कंटेंट बनाने के लिए Intlayer में सशर्त तर्क का उपयोग करना सीखें।

    • सम्मिलन (Insertion)
      सम्मिलन प्लेसहोल्डर का उपयोग करके स्ट्रिंग में मान डालने का तरीका खोजें।

    • फ़ंक्शन प्राप्त करना (Function Fetching)
      देखें कि अपने प्रोजेक्ट के वर्कफ़्लो से मेल खाने के लिए कस्टम तर्क के साथ कंटेंट को गतिशील रूप से कैसे प्राप्त करें।

    • मार्कडाउन (Markdown)
      समृद्ध कंटेंट बनाने के लिए Intlayer में मार्कडाउन का उपयोग करना सीखें।

    • फ़ाइल एम्बेडिंग (File embeddings)
      खोजें कि कंटेंट एडिटर में उनका उपयोग करने के लिए Intlayer में बाहरी फ़ाइलों को कैसे एम्बेड करें।

    • नेस्टिंग (Nesting)
      जटिल संरचनाएं बनाने के लिए Intlayer में कंटेंट को नेस्ट करना समझें।

    वातावरण और एकीकरण

    हमने लचीलेपन को ध्यान में रखते हुए Intlayer का निर्माण किया है, जो लोकप्रिय फ्रेमवर्क और बिल्ड टूल्स में सहज एकीकरण की पेशकश करता है:

    प्रत्येक एकीकरण गाइड में Intlayer की सुविधाओं का उपयोग करने के सर्वोत्तम अभ्यास (best practices) शामिल हैं, जैसे सर्वर-साइड रेंडरिंग (SSR), डायनामिक रूटिंग, या क्लाइंट-साइड रेंडरिंग, ताकि आप एक तेज़, SEO-अनुकूल और उच्च स्केलेबल एप्लिकेशन बनाए रख सकें।

    योगदान और प्रतिक्रिया

    हम ओपन-सोर्स और समुदाय-संचालित (community-driven) विकास की शक्ति को महत्व देते हैं। यदि आप सुधारों का प्रस्ताव देना चाहते हैं, एक नई गाइड जोड़ना चाहते हैं, या हमारे दस्तावेज़ों में किसी भी समस्या को ठीक करना चाहते हैं, तो बेझिझक पुल अनुरोध (Pull Request) सबमिट करें या हमारे GitHub रिपॉजिटरी पर एक समस्या (Issue) खोलें।

    क्या आप अपने एप्लिकेशन का तेज़ी से और अधिक कुशलता से अनुवाद करने के लिए तैयार हैं? आज ही Intlayer का उपयोग शुरू करने के लिए हमारे दस्तावेज़ों में गोता लगाएँ। अंतर्राष्ट्रीयकरण के लिए एक मजबूत, सुव्यवस्थित दृष्टिकोण का अनुभव करें जो आपके कंटेंट को व्यवस्थित रखता है और आपकी टीम को अधिक उत्पादक बनाता है।

    अक्सर पूछे जाने वाले प्रश्न

    Intlayer JavaScript और TypeScript अनुप्रयोगों के लिए एक अंतर्राष्ट्रीयकरण (i18n) लाइब्रेरी है। आप घटक की सामग्री को .content.ts फ़ाइल में ठीक घटक के बगल में घोषित करते हैं, Intlayer उन घोषणाओं को बिल्ड समय पर टाइप किए गए शब्दकोशों में संकलित करता है, और आपके घटक उन्हें useIntlayer जैसे हुक के माध्यम से पढ़ते हैं। इसमें अनुवाद, बहुवचन नियम, लिंग, Markdown, लोकेल-जागरूक रूटिंग, SEO मेटाडेटा, AI-सहायता प्राप्त अनुवाद और गैर-डेवलपर्स के लिए विज़ुअल एडिटर शामिल हैं।

    नेमस्पेस-आधारित सेटअपों की तुलना में बहुत कम, क्योंकि एक पृष्ठ कभी भी उस कैटलॉग को डाउनलोड नहीं करता है जिसे वह रेंडर नहीं करता है। सर्वर पर रेंडर किया गया मार्कअप सर्वर पर ही अपनी सामग्री को हल करता है, और बिल्ड-टाइम कंपाइलर useIntlayer कॉल को घटक द्वारा उपयोग की जाने वाली सटीक शब्दकोश प्रविष्टियों से बदल देता है, इसलिए अप्रयुक्त कुंजियों और भाषाओं को हटा दिया जाता है। गतिशील शब्दकोश शेष को प्रति लोकेल विभाजित करते हैं। पारंपरिक विकल्पों की तुलना में, Intlayer बंडल और पृष्ठ आकार को 50% तक कम करता है। बंडल अनुकूलन और बेंचमार्क देखें।

    हाँ, और इसके दो रास्ते हैं। आप i18next माइग्रेशन गाइड या next-intl माइग्रेशन गाइड के साथ सामग्री को धीरे-धीरे स्थानांतरित कर सकते हैं। या आप अपने वर्तमान API को पूरी तरह से बनाए रख सकते हैं: संगतता एडेप्टर i18next, react-i18next, next-intl, next-i18next, react-intl, use-intl, vue-i18n और Lingui के समान API प्रदान करते हैं, लेकिन Intlayer शब्दकोशों द्वारा संचालित होते हैं, जिससे केवल आयात बदलते हैं और घटक कोड समान रहता है।

    हाँ। sync JSON plugin आपकी /messages/{locale}/{namespace}.json फ़ाइलों को सत्य का स्रोत बनाए रखता है और दोनों दिशाओं में उनसे Intlayer dictionaries बनाता है। sync PO plugin gettext catalogs के लिए भी ऐसा ही करता है, और per locale files आपको locales को एक फ़ाइल में समूहीकृत करने के बजाय भाषा के अनुसार content को विभाजित करने देते हैं।

    नहीं। npx intlayer extract चलाएं और Intlayer आपकी source files को पढ़ता है, user facing strings को निकालता है और प्रत्येक के बगल में एक .content file लिखता है, इसलिए आप strings को एक catalog में एक-एक करके कॉपी करने के बजाय एक diff की समीक्षा करते हैं। extract command देखें।

    पूरी तरह से स्वचालित वर्कफ़्लो के लिए, Intlayer Compiler JSX, TSX, Vue और Svelte कोड पर निर्माण समय के दौरान भी यही करता है, प्रत्येक परिवर्तन पर शब्दकोश उत्पन्न करता है जिससे कुंजियों को मैन्युअल रूप से बनाए रखने की आवश्यकता समाप्त हो जाती है।

    पाँच उपकरण, सभी वैकल्पिक:

    • VS Code extension: useIntlayer कुंजी से उसे घोषित करने वाली सामग्री फ़ाइल पर जाएं, घटकों से सामग्री निकालें, और कमांड पैलेट या Intlayer टैब से build, fill, test, push और pull चलाएं।
    • LSP server: LSP का समर्थन करने वाले किसी भी संपादक में समान सुविधा, परिभाषा पर जाएं, अनुवादित मान का पूर्वावलोकन देखें, और कुंजी पूर्णता प्राप्त करें। i18next, react-i18next, next-intl और use-intl कॉल का भी समर्थन करता है।
    • MCP server: Cursor, VS Code, Claude Desktop, Claude Code और ChatGPT के लिए Intlayer दस्तावेज़ और CLI प्रदान करता है।
    • Agent skills: केंद्रित कौशल जैसे intlayer-config, intlayer-cli और intlayer-content
    • ESLint plugin: no-raw-text नियम हार्डकोडेड स्ट्रिंग्स को चिह्नित करता है।