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

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

The autofill mechanism works through a master-slave relationship between content declaration files. When the main (master) file is updated, Intlayer will automatically apply those changes to the derived (autofilled) declaration files.

import { Locales, type Dictionary } from "intlayer";const exampleContent = {  key: "example",  locale: Locales.ENGLISH,  autoFill: "./example.content.json",  content: {    contentExample: "This is an example of content",  },} satisfies Dictionary;export default exampleContent;

Here is a per-locale content declaration file using the autoFill instruction.

Then, when you run the following command: يعمل آلية التعبئة التلقائية من خلال علاقة رئيسية-تابعة بين ملفات إعلان المحتوى. عندما يتم تحديث الملف الرئيسي (الرئيسي)، سيقوم Intlayer تلقائيًا بتطبيق تلك التغييرات على ملفات الإعلان المشتقة (المعبأة تلقائيًا).

import { Locales, type Dictionary } from "intlayer";// تعريف محتوى المثالconst exampleContent = {  key: "example",  locale: Locales.ENGLISH, // اللغة الافتراضية  autoFill: "./example.content.json", // ملف التعبئة التلقائية المرتبط  content: {    contentExample: "This is an example of content", // مثال على المحتوى  },} 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: {    // المحتوى الخاص بك  },};

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

يتم إنشاء ملفات .js و .ts والملفات المشابهة كما يلي:

• إذا كان الملف موجودًا بالفعل، سيقوم Intlayer بتحليله باستخدام شجرة البنية التجريدية (AST) لتحديد كل حقل وإدخال أي ترجمات مفقودة.
• إذا لم يكن الملف موجودًا، فسيقوم Intlayer بإنشائه باستخدام قالب ملف إعلان المحتوى الافتراضي.

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

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

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

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

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

يدعم الحقل 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

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

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

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

سيؤدي هذا إلى إنشاء ملف الترجمة الفرنسية فقط.

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

يمكنك استخدام المتغيرات داخل مسار autoFill لحل المسارات المستهدفة للملفات التي تم إنشاؤها بشكل ديناميكي.

المتغيرات المتاحة:

• {{locale}} – رمز اللغة (مثل fr، es)
• {{key}} – مفتاح القاموس (مثل example)

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

سيؤدي هذا إلى إنشاء:

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

تاريخ الوثيقة

• 5.5.10 - 2025-06-29: بداية التاريخ