Mẫu Jinja là cấu trúc phụ trợ của tài liệu Thẻ mẫu. Bộ công cụ Thẻ Mẫu đi kèm với một số mẫu được tạo sẵn nhưng bạn có thể tự do sửa đổi các mẫu này hoặc thậm chí xây dựng mẫu của riêng mình. Trong tài liệu này, chúng ta sẽ thảo luận về cách thực hiện việc này.
Sau đây là cách tiêu chuẩn để bạn có thể khởi tạo Bộ công cụ Thẻ Mẫu.
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)
Khi bạn chạy toolkit.scaffold_assets() , nội dung của model_card_toolkit/template sẽ được sao chép vào mct_directory/template . Điều này bao gồm các mẫu được tạo sẵn như default_template.html.jinja và default_template.md.jinja .
Đối tượng model_card được tạo ở trên có thể được điền thủ công. Khi bạn đã sẵn sàng tạo tài liệu Thẻ mẫu, bạn có thể chuyển model_card trở lại MCT bằng toolkit.update_model_card(model_card) .
Sử dụng mẫu thẻ mẫu được tạo sẵn
Sau đó, chúng tôi có thể tạo tài liệu Thẻ mẫu bằng cách sử dụng một trong các mẫu mặc định, thông qua mã bên dưới.
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')
Sửa đổi mẫu thẻ mẫu
Bạn có thể tự do sửa đổi mẫu tạo sẵn để thay đổi kiểu dáng, sắp xếp lại thông tin, v.v. Bạn nên làm quen với API Jinja và cấu trúc điều khiển . Tên trường Thẻ Mẫu được lấy từ model_card.py .
Tạo Mẫu Thẻ Mẫu mới
Việc tạo mẫu Thẻ mẫu mới hoạt động giống như sửa đổi mẫu hiện có.
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