Hub documentation

صفحات النماذج قبل الإصدار

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

صفحات النماذج قبل الإصدار

يتوفر هذا الميزة للمنظمات التي تشترك في خطة Enterprise أو أعلى — أو تواصل معنا.

تتيح لك صفحات النماذج قبل الإصدار أن تعلن مؤسستك عن نموذج قادم بينما لا يزال خاصًا. وبدلًا من صفحة الخطأ 404، يرى الزوار صفحة إعلان مخصصة تتضمن عدّادًا تنازليًا حيًا حتى تاريخ الإصدار وزر الإعجاب والإشعار عند الإصدار، مما يتيح لهم تلقي إشعار عبر البريد الإلكتروني في اللحظة التي يُطرح فيها نموذجك. عندما تجعل النموذج عامًا، يُعتبر مُصدرًا وتُستبدل صفحة الإعلان ببطاقة النموذج.

المؤهلات

  • يجب أن تكون مؤسستك مشتركة في خطة Enterprise أو أعلى.
  • يجب أن يكون مستودع النموذج ضمن مساحة اسم المنظمة (مثل my-org/my-upcoming-model). المستودعات المملوكة للمستخدمين غير مؤهلة.
  • يجب أن يكون مستودع النموذج خاصًا. إن جعل النموذج عامًا يؤدي إلى نشره (انظر أسفل).

أعلن عن نموذجك

لتحويل صفحة نموذج خاص إلى صفحة إصدار مسبق، أضف حقل release_date إلى بيانات وصفية بطاقة النموذج (القسم YAML في أعلى README.md للمستودع):

---
release_date: 2026-07-27
description: "A short tagline shown on the pre-release page"
---

يقبل حقل release_date تاريخًا بصيغة YAML، أو طابعًا زمنيًا بصيغة ISO 8601 محاطًا بعلامتي اقتباس إذا كنت ترغب في استهداف وقت محدد:

release_date: "2026-07-27T15:00:00Z"

تُرفض القيم غير الصالحة من قِبل مُتحقّق البيانات الوصفية وتُتجاهل. لا يجب أن يكون التاريخ في المستقبل: فمع تاريخ في الماضي، تعرض الصفحة عبارة «قريبًا جدًا» بدلاً من عدّ تنازلي. تُعرض التواريخ بتوقيت UTC.

تتيح لك بعض حقول البيانات الوصفية الاختيارية تخصيص صفحة الإصدار التجريبي:

الحقلالتأثير
descriptionالعبارة الترويجية الرئيسية لصفحة ما قبل الإصدار، وتُستخدم أيضاً بوصف ميتا للصفحة.
pretty_nameالاسم المقروء للبشر المعروض بدلاً من اسم المستودع في العنوان الرئيسي.
approximate_etaاضبطه على true إذا كان release_date مجرد تقدير: فيتم حينها وضع علامة Current ETA على التاريخ.
thumbnailرابط صورة مشاركة اجتماعية مخصصة، تحل محل الصورة المولّدة.
---
release_date: 2026-07-27
approximate_eta: true
pretty_name: "My Upcoming Model"
description: "A short tagline shown on the pre-release page"
---

بعض الأمور الأخرى التي يجب معرفتها:

  • جسم بطاقة النموذج بصيغة Markdown (كل ما يلي بيانات الوصف YAML) هو ما يقرؤه الزوار في صفحة ما قبل الإصدار — استخدمه لوصف ما هو قادم، وعرض لقطات استباقية، والربط ببحث علمي، وما إلى ذلك.
  • لا تحتاج إلى رفع أي أوزان بعد: لا يحتاج المستودع سوى إلى README.md طوال فترة الإعلان. ارفع ملفات النموذج متى ما كنت مستعدًا.
  • بعد تعديل بيانات بطاقة النموذج الوصفية، قد يستغرق تفعيل صفحة الإصدار التجريبي أو تعطيلها بضع لحظات.

ما يراه الزوار

بينما يكون النموذج خاصًا ومحددًا release_date (وكانت مؤسستك مؤهلة)، يرى الزوار صفحة ما قبل الإصدار بدلاً من صفحة 404:

  • بطل يحمل تسمية إصدار قادم، واسم النموذج، وشعارك، وعدّاد تنازلي مباشر حتى تاريخ الإصدار. تُشتق ألوان البطل من صورة منطمتك الرمزية.
  • زر الإعجاب والإشعار عند الإصدار: عند النقر عليه، يُعجَب المستخدم بالمستودع ويُشترك في إشعار بريدي إلكتروني للإصدار. يجب أن يكون المستخدمون مسجلين الدخول، وإلغاء الإعجاب بالنموذج يلغي الاشتراك.
  • محتوى بطاقة النموذج.
  • شريط جانبي يعرض عدد الإعجابات (بوصفها مستخدمين بانتظار الإصدار) مع أحدث من أعجبوا، وتاريخ الإصدار المتوقع، وأحدث نماذج مؤسستك.
  • صورة مصغّرة مخصصة للمشاركة على وسائل التواصل الاجتماعي، باستخدام نفس ألوان البطل.
Pre-release page of a model, with a countdown to the release date and a Like and Notify on release button

يعرض صفحة ما قبل الإصدار محتوى بطاقة النموذج الخاصة بك — كل ما تكتبه في نص README.md يكون مرئيًا للعامة أثناء فترة الإعلان، بما في ذلك الصور والفيديوهات التي تشير إليها. أما بقية المستودع فيبقى خاصًا: تبقى الملفات والمناقشات والوصول إلى واجهة برمجة التطبيقات مقصورة على الأعضاء، ولا يُدرج النموذج في القائمة العامة.

عندما يصل العد التنازلي إلى الصفر، تعرض الصفحة «قريباً جداً» — وتبقى صفحة ما قبل الإصدار منشورة حتى تجعل النموذج عاماً.

ما يراه الأعضاء

يستمر كل من لديه صلاحية القراءة في المستودع في رؤية صفحة النموذج العادية، مما يتيح لفريقك مواصلة إدارة الملفات والإعدادات أثناء عرض الإعلان:

  • يشير شريط في صفحة النموذج إلى أن النموذج في مرحلة ما قبل الإصدار. انقر على معاينة الصفحة — أو أضف ?preview إلى عنوان النموذج — للتحقق مما يراه الزوار.
  • في قوائم النماذج، يظهر النموذج مع شارة Pre-release.
Banner on the model page indicating that the model is in pre-release, with a Preview the page button

أبلغ مشتركيك عند الإصدار

عندما تكون مستعدًا للإصدار:

  1. ادفع ملفات النموذج إلى المستودع.
  2. اجعل النموذج عامًا. يؤدي هذا إلى إصدار النموذج: تتحول صفحة ما قبل الإصدار إلى صفحة نموذج عادية — لا حاجة إلى إزالة حقل release_date.
  3. سيظهر لأعضاء المستودع الذين لديهم صلاحية الكتابة شريط علوي ينص على “N مستخدمين بانتظار الإشعار بهذا الإصدار”، مع زر إرسال إشعارات الإصدار.
  4. انقر على إرسال إشعارات الإصدار لإرسال بريد إلكتروني إلى كل مشترك يخبره بأن نموذجك أصبح متاحًا الآن على Hugging Face.
Banner on the model page showing the number of users waiting to be notified, with a Send release notifications button

لا تُرسل الإشعارات تلقائيًا عندما يصبح النموذج عامًا: أنت من يحدد متى تُرسل. إليك بعض الأمور التي يجب معرفتها:

  • المشتركون هم المستخدمون الذين أعجبوا بالنموذج أثناء مرحلة ما قبل الإصدار، لذا قد يكون الرقم الظاهر في الشريط الإعلاني أقل من إجمالي عدد الإعجابات.
  • يُرسَل البريد الإلكتروني إلى كل مشترك مرة واحدة كحد أقصى، وتختفي الشريط الإعلاني بمجرد إرسال الإشعارات.
  • تلتزم الإشعارات بـتفضيلات الإشعارات الخاصة بكل مستخدم (“إصدار اشتركت فيه أصبح متاحًا”).

أمور يجب وضعها في الاعتبار

  • يبقى الموقع نشطًا بعد التاريخ المحدد: بلوغ تاريخ الإصدار لا يؤدي تلقائيًا إلى إزالة صفحة ما قبل الإصدار؛ اجعل النموذج عامًا لإصداره ثم عُد إلى صفحة النموذج العادية.
  • إعلان النموذج علنياً هو الإصدار: لا يمكن إرسال إشعارات الإصدار إلا بعد أن يصبح النموذج عاماً.
  • Removing release_date while the model is still private takes the pre-release page down: visitors get a 404 page again, like for any private model.
  • Making the model private again (while release_date is still set) turns the pre-release page back on.
Update on GitHub