ترجمات ملف إعلان محتوى التعبئة التلقائية

ملفات إعلان محتوى التعبئة التلقائية هي وسيلة لتسريع سير عمل التطوير الخاص بك.

تعمل آلية التعبئة التلقائية من خلال علاقة رئيسي-تابع بين ملفات إعلان المحتوى. عندما يتم تحديث الملف الرئيسي (الرئيسي)، يقوم 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) لتحديد كل حقل وإدخال أي ترجمات مفقودة.
• إذا لم يكن الملف موجودًا، سيقوم Intlayer بإنشائه باستخدام قالب ملف إعلان المحتوى الافتراضي.

المسارات المطلقة

يدعم الحقل autoFill أيضًا المسارات المطلقة.

const exampleContent = {  key: "example",  autoFill: "/messages/example.content.json",  content: {    // المحتوى الخاص بك  },};

سيتم إنشاء الملف في:

/messages/example.content.json

إنشاء ملفات إعلان المحتوى لكل لغة تلقائيًا

يدعم الحقل 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 إنشاء اللغات المتبقية.

تصفية تعبئة تلقائية للغة محددة

استخدام كائن للحقل autoFill يسمح لك بتطبيق عوامل تصفية وإنشاء ملفات لغة محددة فقط.

const exampleContent = {  key: "example",  autoFill: {    fr: "./example.fr.content.json",  },  content: {    // المحتوى الخاص بك  },};

سيتم إنشاء ملف الترجمة الفرنسية فقط.

متغيرات المسار

يمكنك استخدام المتغيرات داخل مسار 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