ऑटोफिल सामग्री घोषणा फ़ाइल अनुवाद

ऑटोफिल सामग्री घोषणा फ़ाइलें आपके विकास कार्यप्रवाह को तेज़ करने का एक तरीका हैं।

ऑटोफिल तंत्र सामग्री घोषणा फ़ाइलों के बीच एक मास्टर-स्लेव संबंध के माध्यम से काम करता है। जब मुख्य (मास्टर) फ़ाइल अपडेट होती है, तो Intlayer स्वचालित रूप से उन परिवर्तनों को व्युत्पन्न (ऑटोफिल की गई) घोषणा फ़ाइलों पर लागू कर देगा।

import { Locales, type Dictionary } from "intlayer";const exampleContent = {  key: "example",  locale: Locales.ENGLISH,  autoFill: "./example.content.json",  content: {    contentExample: "यह सामग्री का एक उदाहरण है", // सामग्री का उदाहरण  },} satisfies Dictionary;export default exampleContent;

यहाँ autoFill निर्देश का उपयोग करते हुए एक प्रति-स्थान सामग्री घोषणा फ़ाइल है।

फिर, जब आप निम्नलिखित कमांड चलाते हैं:

npx intlayer fill --file 'src/components/example/example.content.ts'

Intlayer स्वचालित रूप से व्युत्पन्न घोषणा फ़ाइल src/components/example/example.content.json बनाएगा, जिसमें मुख्य फ़ाइल में पहले से घोषित नहीं किए गए सभी स्थानों को भरा जाएगा।

{  "key": "example",  "content": {    "contentExample": {      "nodeType": "translation",      "translation": {        "fr": "Ceci est un exemple de contenu",        "es": "Este es un ejemplo de contenido",      },    },  },}

इसके बाद, दोनों घोषणा फ़ाइलों को एकल शब्दकोश में मर्ज किया जाएगा, जिसे मानक useIntlayer("example") हुक (react) / कॉम्पोज़ेबल (vue) का उपयोग करके एक्सेस किया जा सकता है।

ऑटोफिल की गई फ़ाइल प्रारूप

सिफारिश की गई स्वरूप ऑटोफिल की गई घोषणा फ़ाइलों के लिए JSON है, जो स्वरूपण प्रतिबंधों से बचने में मदद करता है। हालांकि, Intlayer .ts, .js, .mjs, .cjs, और अन्य स्वरूपों का भी समर्थन करता है।

const exampleContent = {  key: "example",  autoFill: "./example.filled.content.ts",  content: {    // आपकी सामग्री  },};

यह फ़ाइल इस स्थान पर उत्पन्न करेगा:

src/components/example/example.filled.content.ts

.js, .ts, और समान फ़ाइलों का निर्माण इस प्रकार काम करता है:

• यदि फ़ाइल पहले से मौजूद है, तो Intlayer इसे AST (Abstract Syntax Tree) का उपयोग करके पार्स करेगा ताकि प्रत्येक फ़ील्ड का पता लगाया जा सके और कोई भी गायब अनुवाद डाला जा सके।
• यदि फ़ाइल मौजूद नहीं है, तो Intlayer इसे डिफ़ॉल्ट सामग्री घोषणा फ़ाइल टेम्पलेट का उपयोग करके उत्पन्न करेगा।

पूर्ण पथ (Absolute Paths)

autoFill फ़ील्ड पूर्ण पथों का भी समर्थन करता है।

const exampleContent = {  key: "example",  autoFill: "/messages/example.content.json",  content: {    // आपकी सामग्री  },};

यह फ़ाइल इस स्थान पर उत्पन्न करेगा:

/messages/example.content.json

प्रति-स्थानीय सामग्री घोषणा फ़ाइलों का स्वचालित निर्माण (Autogenerate Per-Locale Content Declaration Files)

autoFill फ़ील्ड प्रति-स्थानीय सामग्री घोषणा फ़ाइलों के निर्माण का भी समर्थन करता है।

const exampleContent = {  key: "example",  autoFill: {    fr: "./example.fr.content.json",    es: "./example.es.content.json",  },  content: {    // आपकी सामग्री  },};

यह दो अलग-अलग फ़ाइलें उत्पन्न करेगा:

• src/components/example/example.fr.content.json
• src/components/example/example.es.content.json

इस मामले में, यदि ऑब्जेक्ट में सभी स्थानीय भाषाएँ शामिल नहीं हैं, तो Intlayer बाकी स्थानीय भाषाओं की फ़ाइलें उत्पन्न करने से बचता है।

विशिष्ट स्थानीय ऑटोफिल को फ़िल्टर करें (Filter Specific Locale Autofill)

autoFill फ़ील्ड के लिए एक ऑब्जेक्ट का उपयोग करने से आप फ़िल्टर लागू कर सकते हैं और केवल विशिष्ट स्थानीय फ़ाइलें उत्पन्न कर सकते हैं।

const exampleContent = {  key: "example",  autoFill: {    fr: "./example.fr.content.json",  },  content: {    // आपकी सामग्री  },};

यह केवल फ्रेंच अनुवाद फ़ाइल उत्पन्न करेगा।

पथ चर (Path Variables)

आप उत्पन्न फ़ाइलों के लिए लक्षित पथों को गतिशील रूप से हल करने के लिए autoFill पथ के अंदर वेरिएबल्स का उपयोग कर सकते हैं।

उपलब्ध वेरिएबल्स:

• {{locale}} – स्थानीय कोड (जैसे fr, es)
• {{fileName}} – फ़ाइल नाम (जैसे index)
• {{key}} – शब्दकोश कुंजी (जैसे example)

const exampleContent = {  key: "example",  autoFill: "/messages/{{locale}}/{{key}}.content.json",  content: {    // आपकी सामग्री  },};

यह उत्पन्न करेगा:

• /messages/fr/example.content.json
• /messages/es/example.content.json

const exampleContent = {  key: "example",  autoFill: "./{{fileName}}.content.json",  content: {    // आपकी सामग्री  },};

यह उत्पन्न करेगा:

• ./index.content.json
• ./index.content.json