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

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

परिचय

Intlayer क्या है?

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

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

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

.└── Components    └── MyComponent        ├── index.content.ts        └── index.tsx

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;

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) के साथ आता है जैसे:

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

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

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

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

शब्दकोश (Dictionary)

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

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

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

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

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

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

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

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

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

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

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

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

• Next.js 16 के साथ Intlayer
• Next.js 15 के साथ Intlayer
• Next.js 14 (App Router) के साथ Intlayer
• Next.js Page Router के साथ Intlayer
• React CRA के साथ Intlayer
• Vite + React के साथ Intlayer
• React Router v7 के साथ Intlayer
• Tanstack Start के साथ Intlayer
• React Native और Expo के साथ Intlayer
• Lynx और React के साथ Intlayer
• Vite + Preact के साथ Intlayer
• Vite + Vue के साथ Intlayer
• Nuxt के साथ Intlayer
• Vite + Svelte के साथ Intlayer
• SvelteKit के साथ Intlayer
• Express के साथ Intlayer
• NestJS के साथ Intlayer
• Hono के साथ Intlayer
• Angular के साथ Intlayer

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

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

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

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