Las plantillas de Jinja son la estructura de fondo de un documento de tarjeta modelo. El Model Card Toolkit viene con algunas plantillas prediseñadas, pero puedes modificarlas libremente o incluso crear las tuyas propias. En este documento, discutiremos cómo hacer esto.
La siguiente es la forma estándar en la que puede inicializar el Model Card Toolkit.
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)
Cuando ejecuta toolkit.scaffold_assets() , el contenido de model_card_toolkit/template se copia en mct_directory/template . Esto incluye plantillas prediseñadas como default_template.html.jinja y default_template.md.jinja .
El objeto model_card generado anteriormente se puede completar manualmente. Una vez que esté listo para generar un documento de tarjeta modelo, puede pasar model_card nuevamente a MCT con toolkit.update_model_card(model_card) .
Utilice una plantilla de tarjeta modelo prefabricada
Luego podemos generar un documento de tarjeta modelo utilizando una de las plantillas predeterminadas, mediante el siguiente código.
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')
Modificar la plantilla de tarjeta modelo
Puede modificar libremente una plantilla prediseñada para cambiar el estilo, reorganizar la información, etc. Debe estar familiarizado con la API de Jinja y las estructuras de control . Los nombres de los campos de la tarjeta modelo se toman de model_card.py .
Crear una nueva plantilla de tarjeta modelo
Crear una nueva plantilla de Tarjeta de modelo funciona igual que modificar una existente.
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