HTML 引擎
HTML 引擎生成乾淨、適用於網路的 HTML 版本履歷。這特別適用於在網站中嵌入履歷、線上分享或創建基於網路的作品集。
配置
要使用 HTML 引擎,請在佈局配置中指定 engine: html。
layouts:
- engine: html
template: calm
# ... 其他選項章節
sections 選項允許您自定義章節標題及其順序。更多資訊,請參見章節文件。
layouts:
- engine: html
sections:
aliases:
work: "Professional Experience"
education: "Education"
skills: "Skills"
order:
- basics
- work
- education模板
template 選項允許您從各種模板中選擇。每個模板都有獨特的設計和佈局。您可以在模板文件中找到可用模板的列表。
layouts:
- engine: html
template: calm排版
typography 選項允許您自定義履歷中使用的字體樣式。
字體大小
fontSize 選項允許您設置文件的基本字體大小。
HTML 引擎支援從 14px 到 20px 的字體大小。
字體家族
fontFamily 選項允許您指定字體家族名稱和/或通用家族名稱的優先列表。這與 CSS 的 font-family 屬性完全相同。
行距
lineSpacing 選項允許您調整文件的行距。YAMLResume 使用語義值,這些值會映射到特定於引擎的實現:
| 值 | 描述 |
|---|---|
tight | 緊湊間距,適合容納更多內容 |
snug | 比 tight 稍多的空間 |
normal | 均衡的可讀性(默認) |
relaxed | 行之間更多呼吸空間 |
loose | 非常寬鬆的佈局 |
layouts:
- engine: html
typography:
fontSize: 16px
fontFamily: "Merriweather, serif"
lineSpacing: relaxed連結底線
typography.links.underline 用於控制超連結是否顯示底線。LaTeX、Typst、HTML 和 DOCX 引擎都支援此選項。
layouts:
- engine: html
typography:
links:
underline: true主題
theme 選項允許您自定義履歷的視覺外觀,而不影響可測量的版面幾何(頁面大小、邊距、字體大小)或章節結構。目前支援強調色,所有 HTML 模板都遵循此設定。
強調色
theme.colors.accent 選項設置用於標題、章節標題、連結和醒目標籤的強調色。它接受具名顏色預設值或任意 #RRGGBB 十六進位顏色字串:
| 顏色 | Preset | Hex |
|---|---|---|
black | #000000 | |
blue | #3873B3 | |
burgundy | #980000 | |
cerulean | #0081A7 | |
green | #59B24D | |
grey | #737373 | |
orange | #F28C26 | |
purple | #8054CC | |
red | #F23333 |
layouts:
- engine: html
theme:
colors:
accent: burgundy # 或任意十六進位顏色,如 "#1B365D"以下是使用 4 種強調色預設值渲染的 kami 模板:

burgundy

cerulean

green

purple
強調色預設值遵循 moderncv 色彩方案調色盤。如果未設置強調色,每個模板將回退到其預設調色盤。
進階設置
advanced 選項允許您配置 HTML 引擎的進階設置。
顯示錨點
showAnchors 選項控制是否在章節和條目上輸出片段 id 屬性,以供錨點導航。它預設啟用:啟用錨點後,每個章節都會獲得如 work 的 id,每個條目都會獲得如
work-2 的 id,因此您可以直接連結到履歷的特定部分。
layouts:
- engine: html
advanced:
# 在章節和條目上輸出片段 `id` 屬性。
showAnchors: true
showIcons: true
# HTML 文件的自定義標題。
title: "我的自定義履歷標題"
# HTML 文件的自定義頁尾。
footer: "由 <a href=\"https://yamlresume.dev\">YAMLResume</a> 生成"
# HTML 文件的 Meta 描述。
description: "用於 SEO 的履歷簡短描述。"
# HTML 文件的 Meta 關鍵字。
keywords: "履歷, CV, yamlresume"Last updated on