Jinja 템플릿은 모델 카드 문서의 백엔드 구조입니다. 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 객체는 수동으로 채울 수 있습니다. 모델 카드 문서를 생성할 준비가 되면 toolkit.update_model_card(model_card) 사용하여 model_card MCT에 다시 전달할 수 있습니다.
미리 만들어진 모델 카드 템플릿 사용
그런 다음 아래 코드를 통해 기본 템플릿 중 하나를 사용하여 모델 카드 문서를 생성할 수 있습니다.
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