YAMLResume

Motor DOCX

Gere um currículo editável do Microsoft Word a partir de YAML, com tamanho de página, fontes e layout de duas colunas configuráveis.

O motor DOCX gera documentos Microsoft Word a partir do seu ficheiro YAML de currículo. Isto é particularmente útil quando precisa de partilhar o seu currículo num formato editável ou submetê-lo a sistemas que exigem documentos Word.

Configuração

Para utilizar o motor DOCX, especifique engine: docx na sua configuração de layout.

layouts:
  - engine: docx
    template: calm
    # ... outras opções

Página

A opção page permite personalizar as definições de página, como o tamanho do papel, as margens e se deve mostrar números de página.

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

Secções

A opção sections permite personalizar os títulos das secções e a sua ordem. Para mais informações, consulte a documentação de secções.

layouts:
  - engine: docx
    sections:
      aliases:
        work: "Experiência Profissional"
        education: "Educação"
        skills: "Competências"
      order:
        - basics
        - work
        - education

Modelos

A opção template permite escolher entre uma variedade de modelos. Cada modelo tem um design e disposição únicos. Pode encontrar uma lista de modelos disponíveis na documentação de modelos.

layouts:
  - engine: docx
    template: calm

Tipografia

A opção typography permite personalizar os estilos de fonte utilizados no seu currículo.

Tamanho da Fonte

A opção fontSize permite definir o tamanho de fonte base para o documento. O motor DOCX suporta tamanhos de fonte entre 10pt e 12pt.

ValorDescrição
10ptPequeno
10.5ptCompacto
11ptNormal
11.5ptMédio
12ptGrande

Família de Fontes

A opção fontFamily permite especificar o nome da fonte a utilizar na saída DOCX. A fonte deve estar disponível no sistema onde o documento é aberto.

layouts:
  - engine: docx
    typography:
      fontFamily: Arial

Espaçamento de Linha

A opção lineSpacing permite ajustar o espaçamento de linha (leading) do documento. YAMLResume utiliza valores semânticos que são mapeados para implementações específicas do motor:

ValorDescrição
tightEspaçamento compacto
snugUm pouco mais de espaço do que tight
normalLegibilidade equilibrada (predefinição)
relaxedMais espaço entre linhas
looseLayout muito espaçado

Sublinhado de Hiperligações

Defina typography.links.underline para controlar se as hiperligações são sublinhadas.

layouts:
  - engine: docx
    typography:
      links:
        underline: true

Tema

A opção theme permite personalizar a aparência visual do seu currículo sem afetar a geometria de layout mensurável (tamanho da página, margens, tamanhos de fonte) ou a estrutura de secções. Atualmente, suporta cores de destaque. O motor markdown ignora a opção de tema.

Cor de Destaque

A opção theme.colors.accent define a cor de destaque utilizada para títulos de secções, hiperligações e outros elementos destacados. Aceita uma das predefinições de cores nomeadas ou uma cadeia de cor hexadecimal #RRGGBB arbitrária:

CorPresetHex
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 # ou uma cor hexadecimal arbitrária como "#1B365D"

Aqui está o template calm renderizado com quatro predefinições de cores de destaque:

Template DOCX calm com a cor de destaque burgundy

burgundy

Template DOCX calm com a cor de destaque cerulean

cerulean

Template DOCX calm com a cor de destaque green

green

Template DOCX calm com a cor de destaque purple

purple

Na saída DOCX, a cor de destaque colore os títulos de secções e o texto das hiperligações no modelo calm. Quando nenhuma cor de destaque está definida, o modelo mantém a sua paleta predefinida.

Avançado

A opção advanced permite configurar definições avançadas do DOCX.

Mostrar URLs

A opção showUrls controla se deve mostrar URLs brutas no documento. Quando ativada, os URLs de instituições, empresas, projetos, etc. são mostrados como hiperligações clicáveis.

Mostrar Ícones

A opção showIcons controla se deve mostrar ícones emoji para informação de contacto e localização. Quando ativada, ícones como telefone e email são mostrados junto ao texto.

layouts:
  - engine: docx
    advanced:
      showUrls: true
      showIcons: true
Edit on GitHub

Last updated on

On this page