استخدم مساعدك المفضل للملخص واستخدم هذه الصفحة والموفر AI الذي تريده
بدءاً من الدمج مع خادم MCP Intlayer ، يمكن لمساعدك الذكي الاسترجاع من جميع المستندات مباشرة من ChatGPT ، DeepSeek ، Cursor ، VSCode ، إلخ.
عرض الوثائق الخاصة بالخادم MCPتمت ترجمة محتوى هذه الصفحة باستخدام الذكاء الاصطناعي.
اعرض آخر نسخة المحتوى الأصلي باللغة الإنكليزيةإذا كان لديك فكرة لتحسين هذه الوثيقة، فلا تتردد في المساهمة من خلال تقديم طلب سحب على GitHub.
رابط GitHub للتوثيقنسخ الـ Markdown من المستند إلى الحافظة
ترجمات ملف إعلان محتوى التعبئة التلقائية
ملفات إعلان محتوى التعبئة التلقائية هي وسيلة لتسريع سير عمل التطوير الخاص بك.
تعمل آلية التعبئة التلقائية من خلال علاقة رئيسي-تابع بين ملفات إعلان المحتوى. عندما يتم تحديث الملف الرئيسي (الرئيسي)، يقوم 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
تاريخ الوثيقة
الإصدار | التاريخ | التغييرات |
---|---|---|
6.0.0 | 2025-09-20 | إضافة التهيئة العامة |
6.0.0 | 2025-09-17 | إضافة متغير {{fileName}} |
5.5.10 | 2025-06-29 | بداية السجل |