YAMLResume v0.11: Playground, Comando Doctor e Mais Idiomas

Temos o prazer de anunciar YAMLResume v0.11. Esta versão traz melhorias significativas na experiência do desenvolvedor com um novo componente Playground integrável, diagnósticos do ambiente através do comando doctor, suporte expandido de idiomas e personalização tipográfica.

Novo Pacote: @yamlresume/playground

Extraímos e publicámos o nosso playground web como um componente React independente: @yamlresume/playground. Este pacote alimenta o playground oficial e agora pode ser integrado nas suas próprias aplicações.

npm install @yamlresume/playground @yamlresume/core

O componente Playground fornece:

• Editor YAML em Vivo: Editor baseado em Monaco com destaque de sintaxe YAML
• Pré-visualização em Tempo Real: Pré-visualização instantânea para designs HTML, Markdown e LaTeX
• Design Responsivo: Design de painéis separados no desktop, interface com separadores no telemóvel
• Opções de Exportação: Descarrega, copia ou imprime o teu currículo

A utilização básica é simples:

import { useState } from "react"
import { Playground } from "@yamlresume/playground"

function App() {
  const [yaml, setYaml] = useState("layouts: []");

  return (
    <Playground yaml={yaml} onChange={(newYaml) => setYaml(newYaml)} />
  )
}

O pacote também exporta hooks como useResumeState e useResumeRenderer para criar experiências de editor personalizadas. Consulta o README do pacote para a referência completa da API.

Novo Comando: yamlresume doctor

Configurar um ambiente LaTeX pode ser complicado. O novo comando doctor ajuda a diagnosticar a tua configuração verificando as dependências necessárias:

$ yamlresume doctor

  System:
    OS: macOS 14.6.1
    CPU: (10) arm64 Apple M1 Max
  Binaries:
    Node: 25.6.0 - /opt/homebrew/bin/node
    Yarn: 1.22.22 - /Users/hanyu/Library/pnpm/yarn
    npm: 11.8.0 - /opt/homebrew/bin/npm
    pnpm: 10.6.3 - /opt/homebrew/bin/pnpm

ℹ Checking XeTeX...                                                                                                                                                     2:26:36 PM
  XeTeX: XeTeX 3.141592653-2.6-0.999994 (TeX Live 2022)

ℹ Checking Tectonic...                                                                                                                                                  2:26:36 PM
  Tectonic: tectonic 0.15.0Tectonic 0.15.0

ℹ Checking Fonts...                                                                                                                                                    2:26:36 PM
  Linux Libertine O: Not Installed
  Linux Libertine: Installed
  Noto Serif CJK SC: Installed
  Noto Sans CJK SC: Installed

O comando doctor verifica:

• Informação do sistema: SO, arquitetura de CPU
• Binários: Node.js, npm, pnpm, Yarn, Bun
• Motores LaTeX: Disponibilidade de XeTeX e Tectonic
• Fontes: Fontes necessárias para uma renderização ótima do currículo (Linux Libertine para texto latino, Noto CJK para chinês/japonês/coreano)

Isto é particularmente útil ao configurar YAMLResume numa nova máquina ou resolver problemas de compilação do currículo.

Suporte para Japonês e Alemão

YAMLResume continua a expandir a sua internacionalização. Agora suportamos dois idiomas mais:

• Japonês (ja): Suporte completo para cabeçalhos de secção em japonês, formatos de data e nomes de países
• Alemão (de): Graças a Daniel Bälz por contribuir as traduções para alemão

Isto eleva o nosso número de idiomas suportados para oito:

• Inglês (en)
• Chinês (zh)
• Espanhol (es)
• Francês (fr)
• Norueguês (no)
• Holandês (nl)
• Japonês (ja)
• Alemão (de)

Para gerar o teu currículo em japonês ou alemão:

locale:
  language: ja  # ou 'de' para alemão

Personalização de Família Tipográfica

Agora podes personalizar a família tipográfica tanto para os motores HTML como LaTeX. Isto dá-te um controle preciso sobre a tipografia para que coincida com a tua marca pessoal ou preferências regionais.

Motor HTML

layouts:
  - engine: html
    typography:
      fontFamily: '"Inter", "Helvetica Neue", sans-serif'

Cada modelo HTML adota uma lista de fontes padrão, e quando especificas o fontFamily na tua configuração de design, será pré-inserido na lista padrão.

Motor LaTeX

layouts:
  - engine: latex
    typography:
      fontFamily: "EB Garamond"

fontFamily para o motor LaTeX também suporta a sintaxe de família de fontes CSS, ou seja, a lista de fontes separadas por vírgulas. O motor LaTeX de YAMLResume usará a macro \IfFontExistsTF para verificar a existência de cada fonte e só escolher a primeira que seja acessível para XeTeX/Tectonic na lista.

Aqui está um exemplo de currículo LaTeX com fonte Big Caslon no macOS:

Outras Melhorias

• Nome Türkiye: Atualizou o nome do país de "Turkey" para "Türkiye" para refletir a mudança de nome oficial (#152)
• Cobertura de testes melhorada: Adicionados testes multiplataforma em Node.js 22 e 24 no macOS, Linux e Windows

Atualiza Hoje

Obtém a versão mais recente:

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

Verifica que o teu ambiente está pronto:

$ yamlresume doctor

Como sempre, agradecemos os teus comentários e contribuições em GitHub. Boa construção!