YAMLResume

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 十六進位顏色字串:

顏色PresetHex
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 模板:

kami 模板 burgundy 強調色效果

burgundy

kami 模板 cerulean 強調色效果

cerulean

kami 模板 green 強調色效果

green

kami 模板 purple 強調色效果

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"
Edit on GitHub

Last updated on

On this page