مرجع ملفات البيانات الوصفية (Metadata Files API Reference)

يغطي هذا القسم من الوثائق اتفاقيات ملفات البيانات الوصفية. يمكن تعريف البيانات الوصفية المعتمدة على الملفات عن طريق إضافة ملفات بيانات وصفية خاصة إلى مقاطع المسار (route segments).

يمكن تعريف كل اتفاقية ملف إما باستخدام ملف ثابت (مثل opengraph-image.jpg)، أو متغير ديناميكي يستخدم الكود لإنشاء الملف (مثل opengraph-image.js).

بمجرد تعريف الملف، سيقوم Next.js تلقائيًا بخدمة الملف (مع تجزئة في بيئة الإنتاج للتخزين المؤقت) وتحديث عناصر الرأس ذات الصلة بالبيانات الوصفية الصحيحة، مثل عنوان URL للأصل، ونوع الملف، وحجم الصورة.

معلومة مفيدة:

• معالجات المسار الخاصة مثل sitemap.ts، وopengraph-image.tsx، وicon.tsx، وملفات البيانات الوصفية الأخرى يتم تخزينها مؤقتًا افتراضيًا.
• إذا كنت تستخدمها مع middleware.ts، قم بتكوين المطابق (matcher) لاستثناء ملفات البيانات الوصفية.