DOCX 引擎

DOCX 引擎从您的简历 YAML 文件生成 Microsoft Word 文档。这特别适用于需要以可编辑格式分享简历，或将其提交到要求 Word 文档的系统时。

配置

要使用 DOCX 引擎，请在布局配置中指定 engine: docx。

layouts:
  - engine: docx
    template: calm
    # ... 其他选项

页面

page 选项允许您自定义页面设置，例如纸张大小、页边距以及是否显示页码。

layouts:
  - engine: docx
    page:
      showPageNumbers: true
      # a4 or letter
      paperSize: a4
      margins:
        top: 2.5cm
        left: 1.5cm
        right: 1.5cm
        bottom: 2.5cm

章节

sections 选项允许您自定义章节标题及其顺序。更多信息，请参见章节文档。

layouts:
  - engine: docx
    sections:
      aliases:
        work: "Professional Experience"
        education: "Education"
        skills: "Skills"
      order:
        - basics
        - work
        - education

模板

template 选项允许您从各种模板中选择。每个模板都有独特的设计和布局。您可以在模板文档中找到可用模板的列表。

layouts:
  - engine: docx
    template: calm

排版

typography 选项允许您自定义简历中使用的字体样式。

值	描述
`10pt`	小
`10.5pt`	紧凑
`11pt`	正常
`11.5pt`	中等
`12pt`	大

字体家族

fontFamily 选项允许您指定 DOCX 输出中使用的字体名称。字体必须在打开文档的系统上可用。

layouts:
  - engine: docx
    typography:
      fontFamily: Arial

行间距

lineSpacing 选项允许您调整文档的行间距。YAMLResume 使用语义值，这些值会映射到特定于引擎的实现：

值	描述
`tight`	紧凑间距
`snug`	比 tight 稍多的空间
`normal`	均衡的可读性（默认）
`relaxed`	行之间更多呼吸空间
`loose`	非常宽松的布局

主题

theme 选项允许您自定义简历的视觉外观，而不会影响可测量的版面几何（页面大小、边距、字体大小）或章节结构。目前支持强调色。markdown 引擎会忽略 theme 选项。

强调色

theme.colors.accent 选项设置用于章节标题、超链接和其他突出显示元素的强调色。它既接受命名的颜色预设，也接受任意的 #RRGGBB 十六进制颜色字符串：

颜色	预设	十六进制
	`black`	`#000000`
	`blue`	`#3873B3`
	`burgundy`	`#980000`
	`cerulean`	`#0081A7`
	`green`	`#59B24D`
	`grey`	`#737373`
	`orange`	`#F28C26`
	`purple`	`#8054CC`
	`red`	`#F23333`

layouts:
  - engine: docx
    theme:
      colors:
        accent: burgundy # 或任意十六进制颜色，如 "#1B365D"

以下是使用 4 种强调色预设渲染的 calm 模板：

burgundy

cerulean

green

purple

在 DOCX 输出中，强调色会为 calm 模板中的章节标题和超链接文本着色。未设置强调色时，模板保持其默认调色板。

高级设置

advanced 选项允许您配置 DOCX 的高级设置。

显示 URL

showUrls 选项控制是否在文档中显示原始 URL。启用后，机构、公司、项目等的 URL 将显示为可点击的超链接。

显示图标

showIcons 选项控制是否为联系信息和位置显示表情图标。启用后，电话和邮件符号等图标将显示在文本旁边。

layouts:
  - engine: docx
    advanced:
      showUrls: true
      showIcons: true

On this page