قوالب البطاقة النموذجية

قوالب Jinja هي البنية الخلفية لمستند Model Card. تأتي مجموعة أدوات بطاقة النموذج مع عدد قليل من القوالب المعدة مسبقًا، ولكن يمكنك تعديل هذه القوالب بحرية أو حتى إنشاء قالب خاص بك. في هذه الوثيقة سنناقش كيفية القيام بذلك.

فيما يلي الطريقة القياسية التي يمكنك من خلالها تهيئة مجموعة أدوات Model Card.

mct_directory = ...  # where the Model Card assets will be generated
toolkit = ModelCardToolkit(mct_directory)
model_card = toolkit.scaffold_assets()
... # set the model_card's fields here
toolkit.update_model_card(model_card)

عند تشغيل toolkit.scaffold_assets() ، يتم نسخ محتويات model_card_toolkit/template إلى mct_directory/template . يتضمن ذلك القوالب المعدة مسبقًا مثل default_template.html.jinja و default_template.md.jinja .

يمكن ملء كائن model_card الذي تم إنشاؤه أعلاه يدويًا. بمجرد أن تصبح جاهزًا لإنشاء مستند Model Card، يمكنك تمرير model_card مرة أخرى إلى MCT باستخدام toolkit.update_model_card(model_card) .

استخدم قالب بطاقة نموذجية مسبقة الصنع

يمكننا بعد ذلك إنشاء مستند نموذج البطاقة باستخدام أحد القوالب الافتراضية، عبر الكود أدناه.

template_path = os.path.join(mct_directory, 'template/html/default_template.html.jinja')
toolkit.export_format(template_path=template_path, output_file='model_card.html')

تعديل قالب البطاقة النموذجية

يمكنك تعديل قالب معد مسبقًا بحرية لتغيير التصميم وإعادة تنظيم المعلومات وما إلى ذلك. يجب أن تكون على دراية بواجهة برمجة تطبيقات Jinja وهياكل التحكم . أسماء حقول بطاقة النموذج مأخوذة من model_card.py .

إنشاء قالب بطاقة نموذج جديد

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

my_custom_template_path = ...  # where the template is stored
toolkit.export_format(template_path=my_custom_template_path, output_file'model_card.html')  # generate the final Model Card