YAMLResume v0.13: DOCX Engine & Brazilian Portuguese

We're excited to announce YAMLResume v0.13. This release introduces a brand new DOCX rendering engine for generating Microsoft Word documents, adds Brazilian Portuguese language support, brings bold labels and keywords to DOCX templates, and includes various bug fixes and improvements.

New Engine: DOCX

The biggest feature in this release is the new DOCX rendering engine. You can now generate Microsoft Word documents directly from your resume YAML file.

The DOCX engine is built on top of the docx npm package, which constructs an AST of document nodes (Paragraphs, TextRuns, Tables, etc.) and serializes them to a ZIP-based OOXML binary.

Calm Template for DOCX

The first DOCX template available is Calm, inspired by latex moderncv template and matching the visual design of the HTML Calm template with a clean two-column layout.

layouts:
  - engine: docx
    template: calm

The DOCX Calm template supports almost the same customization options as other engines, including font size, line spacing, and page margins.

Here is a sample configuration:

layouts:
  - engine: docx
    page:
      showPageNumbers: true
      # a4 or letter
      paperSize: a4
      margins:
        top: 2.5cm
        left: 1.5cm
        right: 1.5cm
        bottom: 2.5cm
    typography:
      fontFamily: Arial
      fontSize: 11pt
      lineSpacing: normal
    advanced:
      showUrls: true
      showIcons: true
    sections:
      aliases:
        work: "Professional Experience"
        education: "Education"
        skills: "Skills"
      order:
        - basics
        - work
        - education

Here's a preview of the DOCX Calm template in Microsoft Word:

CLI Support

As always, you can list all available templates and engines with:

$ yamlresume templates list

| layouts.[].template | Engine | Template Name    | Description                                                         |
| ------------------- | ------ | ---------------- | ------------------------------------------------------------------- |
| jake                | latex  | Jake's Resume    | A simple, straight-forward resume template based on Jake's Resume   |
| moderncv-banking    | latex  | ModernCV Banking | ModernCV template with banking style                                |
| moderncv-casual     | latex  | ModernCV Casual  | ModernCV template with casual style                                 |
| moderncv-classic    | latex  | ModernCV Classic | ModernCV template with classic style                                |
| calm                | html   | Calm             | Clean and minimalist design suitable for all professionals.         |
| vscode              | html   | VS Code          | Dark theme inspired by Visual Studio Code, tailored for developers. |
| calm                | docx   | Calm             | Clean and minimalist design suitable for all professionals.         |

Playground Preview

The playground now supports DOCX preview, allowing you to see your Word document output in real time as you edit your resume.

Brazilian Portuguese Language Support

YAMLResume continues to expand its internationalization. We're adding Brazilian Portuguese (português brasileiro), the official language of Brazil -- the largest country in South America and the Lusophone world.

This brings our supported language count to ten:

• English (en)
• Chinese (zh-hans, zh-hant-tw, zh-hant-hk)
• Spanish (es)
• French (fr)
• Norwegian (no)
• Dutch (nl)
• Japanese (ja)
• German (de)
• Indonesian (id)
• Brazilian Portuguese (pt-BR)

To generate your resume in Brazilian Portuguese:

locale:
  language: pt-BR

All predefined options will be translated automatically to Brazilian Portuguese.

Bug Fixes

JSON Resume Import

• json2yamlresume now preserves the summary field for work, projects, and volunteer entries when converting from JSON Resume format

Link Improvements (v0.12.3)

• Added showUrls option to show or hide URLs in LaTeX templates
• Phone numbers in Jake's template now use tel: href prefix
• URLs in moderncv templates are now underlined for better visibility

CLI and Locale Fixes (v0.12.1--v0.12.2)

• The --timeout flag now works correctly with yamlresume build
• Improved wording of the "present" keyword across locales
• Fixed fontawesome7 compatibility with older TeX Live 2022 installations

Upgrade Today

Get the latest version:

$ npm install -g yamlresume@latest
# or
$ brew upgrade yamlresume

Credit

As always, we welcome your feedback and contributions on GitHub. Happy building!