เทมเพลตการ์ดโมเดล

เทมเพลต Jinja เป็นโครงสร้างแบ็คเอนด์ของเอกสาร Model Card ชุดเครื่องมือการ์ดโมเดลมาพร้อมกับเทมเพลตที่สร้างไว้ล่วงหน้าบางส่วน แต่คุณสามารถแก้ไขเทมเพลตเหล่านี้ได้อย่างอิสระหรือแม้แต่สร้างเทมเพลตของคุณเองก็ได้ ในเอกสารนี้ เราจะหารือถึงวิธีการดำเนินการนี้

ต่อไปนี้เป็นวิธีมาตรฐานที่คุณสามารถเริ่มต้น 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)

เมื่อคุณรัน 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)

ใช้เทมเพลตการ์ดโมเดลที่สร้างไว้ล่วงหน้า

จากนั้นเราสามารถสร้างเอกสาร 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 API และ โครงสร้างการควบคุม ชื่อฟิลด์การ์ดโมเดลนำมาจาก 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