@intlayer/docs 5.5.9 → 5.5.11

package/docs/hi/dictionary/condition.md

@@ -0,0 +1,233 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: शर्तों के साथ सामग्री
+description: Intlayer में शर्तीय सामग्री का उपयोग करके विशिष्ट शर्तों के आधार पर सामग्री को गतिशील रूप से प्रदर्शित करने का तरीका जानें। इस दस्तावेज़ का पालन करें और अपने प्रोजेक्ट में शर्तों को कुशलतापूर्वक लागू करें।
+keywords:
+  - शर्तों के साथ सामग्री
+  - गतिशील रेंडरिंग
+  - प्रलेखन
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - content
+  - condition
+---
+
+# Conditional Content / Condition in Intlayer
+
+## शर्त कैसे काम करती है
+
+Intlayer में, सशर्त सामग्री `cond` फ़ंक्शन के माध्यम से प्राप्त की जाती है, जो विशिष्ट शर्तों (आमतौर पर बूलियन मान) को उनकी संबंधित सामग्री से मैप करता है। यह दृष्टिकोण आपको दी गई शर्त के आधार पर सामग्री को गतिशील रूप से चुनने में सक्षम बनाता है। जब React Intlayer या Next Intlayer के साथ एकीकृत किया जाता है, तो रनटाइम पर प्रदान की गई शर्त के अनुसार उपयुक्त सामग्री स्वचालित रूप से चुनी जाती है।
+
+## सशर्त सामग्री सेट करना
+
+अपने Intlayer प्रोजेक्ट में सशर्त सामग्री सेट करने के लिए, एक सामग्री मॉड्यूल बनाएं जिसमें आपकी सशर्त परिभाषाएँ शामिल हों। नीचे विभिन्न प्रारूपों में उदाहरण दिए गए हैं।
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+import { cond, type Dictionary } from "intlayer";
+
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "मेरी सामग्री जब यह सत्य है",
+      false: "मेरी सामग्री जब यह असत्य है",
+      fallback: "मेरी सामग्री जब शर्त विफल होती है", // वैकल्पिक
+    }),
+  },
+} satisfies Dictionary;
+
+export default myConditionalContent;
+```
+
+```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+import { cond } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "मेरी सामग्री जब यह सत्य है",
+      false: "मेरी सामग्री जब यह असत्य है",
+      fallback: "मेरी सामग्री जब शर्त विफल होती है", // वैकल्पिक
+    }),
+  },
+};
+
+export default myConditionalContent;
+```
+
+```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+const { cond } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "मेरी सामग्री जब यह सत्य है",
+      false: "मेरी सामग्री जब यह असत्य है",
+      fallback: "मेरी सामग्री जब शर्त विफल होती है", // वैकल्पिक
+    }),
+  },
+};
+
+module.exports = myConditionalContent;
+```
+
+```json5 fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "my_key",
+  "content": {
+    "myCondition": {
+      "nodeType": "condition",
+      "condition": {
+        "true": "मेरी सामग्री जब यह सत्य है",
+        "false": "मेरी सामग्री जब यह असत्य है",
+        "fallback": "मेरी सामग्री जब शर्त विफल होती है", // वैकल्पिक
+      },
+    },
+  },
+}
+```
+
+> यदि कोई फॉलबैक घोषित नहीं किया गया है, तो यदि शर्त मान्य नहीं है, तो अंतिम घोषित कुंजी को फॉलबैक के रूप में लिया जाएगा।
+
+## React Intlayer के साथ सशर्त सामग्री का उपयोग करना
+
+React घटक के भीतर सशर्त सामग्री का उपयोग करने के लिए, `react-intlayer` पैकेज से `useIntlayer` हुक आयात करें और उपयोग करें। यह हुक निर्दिष्ट कुंजी के लिए सामग्री प्राप्त करता है और आपको उपयुक्त आउटपुट चुनने के लिए एक शर्त पास करने की अनुमति देता है।
+
+```tsx fileName="**/*.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const ConditionalComponent: FC = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* आउटपुट: मेरी सामग्री जब यह सत्य है */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* आउटपुट: मेरी सामग्री जब यह असत्य है */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* आउटपुट: मेरी सामग्री जब शर्त विफल होती है */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* आउटपुट: मेरी सामग्री जब शर्त विफल होती है */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+```javascript fileName="**/*.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const ConditionalComponent = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* आउटपुट: मेरी सामग्री जब यह सत्य है */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* आउटपुट: मेरी सामग्री जब यह असत्य है */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* आउटपुट: मेरी सामग्री जब शर्त विफल होती है */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* आउटपुट: मेरी सामग्री जब शर्त विफल होती है */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+```javascript fileName="**/*.cjs" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const ConditionalComponent = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* आउटपुट: मेरी सामग्री जब यह सत्य है */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* आउटपुट: मेरी सामग्री जब यह असत्य है */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* आउटपुट: मेरी सामग्री जब शर्त विफल होती है */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* आउटपुट: मेरी सामग्री जब शर्त विफल होती है */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+module.exports = ConditionalComponent;
+```
+
+## अतिरिक्त संसाधन
+
+कॉन्फ़िगरेशन और उपयोग पर अधिक विस्तृत जानकारी के लिए, निम्नलिखित संसाधनों का संदर्भ लें:
+
+- [Intlayer CLI दस्तावेज़](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_cli.md)
+- [React Intlayer दस्तावेज़](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_with_create_react_app.md)
+- [Next Intlayer दस्तावेज़](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_with_nextjs_15.md)
+
+ये संसाधन विभिन्न वातावरणों और फ्रेमवर्क्स में Intlayer की सेटअप और उपयोग पर और अधिक जानकारी प्रदान करते हैं।

package/docs/hi/dictionary/content_extention_customization.md

@@ -0,0 +1,100 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: सामग्री एक्सटेंशन अनुकूलन
+description: अपनी सामग्री घोषणा फ़ाइलों के एक्सटेंशनों को अनुकूलित करना सीखें। अपने प्रोजेक्ट में शर्तों को कुशलतापूर्वक लागू करने के लिए इस दस्तावेज़ का पालन करें।
+keywords:
+  - सामग्री एक्सटेंशन अनुकूलन
+  - प्रलेखन
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - content
+---
+
+# सामग्री एक्सटेंशन अनुकूलन
+
+## सामग्री फ़ाइल एक्सटेंशन
+
+Intlayer आपको अपनी सामग्री घोषणा फ़ाइलों के एक्सटेंशनों को अनुकूलित करने की अनुमति देता है। यह अनुकूलन बड़े पैमाने पर परियोजनाओं के प्रबंधन में लचीलापन प्रदान करता है और अन्य मॉड्यूल के साथ संघर्ष से बचने में मदद करता है।
+
+### डिफ़ॉल्ट एक्सटेंशन
+
+डिफ़ॉल्ट रूप से, Intlayer निम्नलिखित एक्सटेंशनों वाली सभी फ़ाइलों को सामग्री घोषणाओं के लिए देखता है:
+
+- `.content.json`
+- `.content.ts`
+- `.content.tsx`
+- `.content.js`
+- `.content.jsx`
+- `.content.mjs`
+- `.content.mjx`
+- `.content.cjs`
+- `.content.cjx`
+
+ये डिफ़ॉल्ट एक्सटेंशन अधिकांश अनुप्रयोगों के लिए उपयुक्त हैं। हालांकि, जब आपकी विशिष्ट आवश्यकताएँ होती हैं, तो आप कस्टम एक्सटेंशन परिभाषित कर सकते हैं ताकि बिल्ड प्रक्रिया को सरल बनाया जा सके और अन्य घटकों के साथ संघर्ष के जोखिम को कम किया जा सके।
+
+### सामग्री एक्सटेंशनों को अनुकूलित करना
+
+फ़ाइल एक्सटेंशनों को अनुकूलित करने के लिए जिनका उपयोग Intlayer सामग्री घोषणा फ़ाइलों की पहचान के लिए करता है, आप इन्हें Intlayer कॉन्फ़िगरेशन फ़ाइल में निर्दिष्ट कर सकते हैं। यह दृष्टिकोण बड़े पैमाने पर परियोजनाओं के लिए लाभकारी है जहाँ वॉच प्रक्रिया के दायरे को सीमित करने से बिल्ड प्रदर्शन में सुधार होता है।
+
+यहाँ आपके कॉन्फ़िगरेशन में कस्टम सामग्री एक्सटेंशनों को परिभाषित करने का एक उदाहरण है:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  content: {
+    fileExtensions: [".my_content.ts", ".my_content.tsx"], // आपके कस्टम एक्सटेंशन
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  content: {
+    fileExtensions: [".my_content.cjs", ".my_content.cjx"], // आपके कस्टम एक्सटेंशन
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  content: {
+    fileExtensions: [".my_content.mjs", ".my_content.mjx"], // आपके कस्टम एक्सटेंशन
+  },
+};
+
+module.exports = config;
+```
+
+इस उदाहरण में, कॉन्फ़िगरेशन दो कस्टम एक्सटेंशन निर्दिष्ट करता है: `.my_content.ts` और `.my_content.tsx`। Intlayer केवल इन एक्सटेंशनों वाली फ़ाइलों को देखेगा ताकि शब्दकोश बनाए जा सकें।
+
+### कस्टम एक्सटेंशनों के लाभ
+
+- **बिल्ड प्रदर्शन**: देखी जाने वाली फ़ाइलों के दायरे को कम करने से बड़े प्रोजेक्ट्स में बिल्ड प्रदर्शन में काफी सुधार हो सकता है।
+- **संघर्ष से बचाव**: कस्टम एक्सटेंशन आपकी परियोजना में अन्य जावास्क्रिप्ट या टाइपस्क्रिप्ट फ़ाइलों के साथ संघर्ष को रोकने में मदद करते हैं।
+- **संगठन**: कस्टम एक्सटेंशन आपको अपनी परियोजना की आवश्यकताओं के अनुसार अपनी सामग्री घोषणा फ़ाइलों को व्यवस्थित करने की अनुमति देते हैं।
+
+### कस्टम एक्सटेंशनों के लिए दिशानिर्देश
+
+जब आप सामग्री फ़ाइल एक्सटेंशनों को कस्टमाइज़ कर रहे हों, तो निम्नलिखित दिशानिर्देशों का ध्यान रखें:
+
+- **विशिष्टता**: ऐसे एक्सटेंशन चुनें जो आपकी परियोजना में विशिष्ट हों ताकि संघर्ष से बचा जा सके।
+- **सुसंगत नामकरण**: बेहतर कोड पठनीयता और रखरखाव के लिए सुसंगत नामकरण कन्वेंशन का उपयोग करें।
+- **सामान्य एक्सटेंशनों से बचाव**: अन्य मॉड्यूल या लाइब्रेरी के साथ संघर्ष से बचने के लिए `.ts` या `.js` जैसे सामान्य एक्सटेंशनों का उपयोग करने से बचें।
+
+## निष्कर्ष
+
+Intlayer में सामग्री फ़ाइल एक्सटेंशनों को कस्टमाइज़ करना बड़े पैमाने पर अनुप्रयोगों में प्रदर्शन को अनुकूलित करने और संघर्षों से बचने के लिए एक मूल्यवान सुविधा है। इस दस्तावेज़ में उल्लिखित दिशानिर्देशों का पालन करके, आप अपनी सामग्री घोषणाओं का प्रभावी ढंग से प्रबंधन कर सकते हैं और अपनी परियोजना के अन्य भागों के साथ सुचारू एकीकरण सुनिश्चित कर सकते हैं।
+
+## दस्तावेज़ इतिहास
+
+- 5.5.10 - 2025-06-29: प्रारंभिक इतिहास

package/docs/hi/dictionary/enumeration.md

@@ -0,0 +1,247 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-06-29
+title: एनेमरेशन
+description: जानिए कि अपनी बहुभाषी वेबसाइट में एनेमरेशन को कैसे घोषित और उपयोग करें। इस ऑनलाइन दस्तावेज़ में दिए गए चरणों का पालन करके कुछ ही मिनटों में अपने प्रोजेक्ट को सेटअप करें।
+keywords:
+  - एनेमरेशन
+  - अंतरराष्ट्रीयकरण
+  - दस्तावेज़ीकरण
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - content
+  - hi
+  - dictionary
+  - enumeration
+---
+
+# एनेमरेशन / बहुवचन रूप
+
+## एनेमरेशन कैसे काम करता है
+
+Intlayer में, एनेमरेशन `enu` फ़ंक्शन के माध्यम से प्राप्त किया जाता है, जो विशिष्ट कुंजियों को उनके संबंधित सामग्री से मैप करता है। ये कुंजियाँ संख्यात्मक मान, रेंज, या कस्टम पहचानकर्ता हो सकती हैं। जब React Intlayer या Next Intlayer के साथ उपयोग किया जाता है, तो एप्लिकेशन की लोकल और परिभाषित नियमों के आधार पर उपयुक्त सामग्री स्वचालित रूप से चुनी जाती है।
+
+## एनेमरेशन सेटअप करना
+
+अपने Intlayer प्रोजेक्ट में एनेमरेशन सेटअप करने के लिए, आपको एक कंटेंट मॉड्यूल बनाना होगा जिसमें एनेमरेशन परिभाषाएँ शामिल हों। यहाँ कारों की संख्या के लिए एक सरल एनेमरेशन का उदाहरण दिया गया है:
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+import { enu, type Dictionary } from "intlayer";
+
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "माइनस एक कार से कम",
+      "-1": "माइनस एक कार",
+      "0": "कोई कार नहीं",
+      "1": "एक कार",
+      ">5": "कुछ कारें",
+      ">19": "कई कारें",
+      "fallback": "फॉलबैक मान", // वैकल्पिक
+    }),
+  },
+} satisfies Dictionary;
+
+export default carEnumeration;
+```
+
+```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+import { enu } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "माइनस एक कार से कम",
+      "-1": "माइनस एक कार",
+      "0": "कोई कार नहीं",
+      "1": "एक कार",
+      ">5": "कुछ कारें",
+      ">19": "कई कारें",
+      "fallback": "फॉलबैक मान", // वैकल्पिक
+    }),
+  },
+};
+
+export default carEnumeration;
+```
+
+```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+const { enu } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "माइनस एक कार से कम",
+      "-1": "माइनस एक कार",
+      "0": "कोई कार नहीं",
+      "1": "एक कार",
+      ">5": "कुछ कारें",
+      ">19": "कई कारें",
+      "fallback": "फॉलबैक मान", // वैकल्पिक
+    }),
+  },
+};
+
+module.exports = carEnumeration;
+```
+
+```json fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "car_count",
+  "content": {
+    "numberOfCar": {
+      "nodeType": "enumeration",
+      "enumeration": {
+        "<-1": "माइनस एक कार से कम",
+        "-1": "माइनस एक कार",
+        "0": "कोई कार नहीं",
+        "1": "एक कार",
+        ">5": "कुछ कारें",
+        ">19": "कई कारें",
+        "fallback": "फॉलबैक मान" // वैकल्पिक
+      }
+    }
+  }
+}
+```
+
+इस उदाहरण में, `enu` विभिन्न स्थितियों को विशिष्ट सामग्री से मैप करता है। जब इसे एक React घटक में उपयोग किया जाता है, तो Intlayer दिए गए चर के आधार पर स्वचालित रूप से उपयुक्त सामग्री चुन सकता है।
+
+> Intlayer एनेमरेशन में घोषणा का क्रम महत्वपूर्ण होता है। पहली मान्य घोषणा को चुना जाएगा। यदि कई स्थितियां लागू होती हैं, तो सुनिश्चित करें कि वे सही क्रम में हैं ताकि अप्रत्याशित व्यवहार से बचा जा सके।
+
+> यदि कोई फॉलबैक घोषित नहीं किया गया है, तो यदि कोई कुंजी मेल नहीं खाती है, तो फ़ंक्शन `undefined` लौटाएगा।
+
+## React Intlayer के साथ एनेमरेशन का उपयोग करना
+
+React घटक में एनेमरेशन का उपयोग करने के लिए, आप `react-intlayer` पैकेज से `useIntlayer` हुक का उपयोग कर सकते हैं। यह हुक निर्दिष्ट ID के आधार पर सही सामग्री प्राप्त करता है। इसका उपयोग करने का एक उदाहरण यहां दिया गया है:
+
+```tsx fileName="**/*.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const CarComponent: FC = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // आउटपुट: कोई कार नहीं
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // आउटपुट: कुछ कारें
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // आउटपुट: कई कारें
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // आउटपुट: फॉलबैक मान
+        }
+      </p>
+    </div>
+  );
+};
+```
+
+```javascript fileName="**/*.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const CarComponent = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // आउटपुट: कोई कार नहीं
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // आउटपुट: कुछ कारें
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // आउटपुट: कई कारें
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // आउटपुट: फॉलबैक मान
+        }
+      </p>
+    </div>
+  );
+};
+
+export default CarComponent;
+```
+
+```javascript fileName="**/*.cjs" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const CarComponent = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // आउटपुट: कोई कार नहीं
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // आउटपुट: कुछ कारें
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // आउटपुट: कई कारें
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // आउटपुट: फॉलबैक मान
+        }
+      </p>
+    </div>
+  );
+};
+
+module.exports = CarComponent;
+```
+
+इस उदाहरण में, घटक गतिशील रूप से कारों की संख्या के आधार पर अपने आउटपुट को समायोजित करता है। निर्दिष्ट सीमा के अनुसार सही सामग्री स्वचालित रूप से चुनी जाती है।
+
+## अतिरिक्त संसाधन
+
+कॉन्फ़िगरेशन और उपयोग के बारे में अधिक विस्तृत जानकारी के लिए, निम्नलिखित संसाधनों को देखें:
+
+- [Intlayer CLI प्रलेखन](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_cli.md)
+- [React Intlayer प्रलेखन](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_with_create_react_app.md)
+- [Next Intlayer प्रलेखन](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_with_nextjs_15.md)
+
+ये संसाधन विभिन्न वातावरणों और विभिन्न फ्रेमवर्क के साथ Intlayer की सेटअप और उपयोग के बारे में और अधिक जानकारी प्रदान करते हैं।
+
+## दस्तावेज़ इतिहास
+
+- 5.5.10 - 2025-06-29: प्रारंभिक इतिहास