YAMLResume

Nuevo Idioma

Guía paso a paso para añadir un nuevo idioma de currículum, desde registrar la configuración regional hasta las reglas de composición.

YAMLResume está diseñado para soportar múltiples idiomas desde la base, permitiendo a los usuarios crear currículums en su idioma preferido.

Al momento de escribir, YAMLResume soporta los siguientes idiomas:

Si tu idioma preferido no está listado, puedes contribuir siguiendo los pasos a continuación para agregar soporte para un nuevo idioma.

Registra Tu Idioma

Para agregar una nueva opción locale.language a YAMLResume, primero registra tu idioma en models/options.ts agregando una nueva entrada a LOCALE_LANGUAGE_OPTIONS.

Lista de verificación:

  • Agrega tu idioma a LOCALE_LANGUAGE_OPTIONS.
  • Construye y prueba el nuevo CLI con pnpm cli dev languages list, asegurándote de que tu idioma aparezca en la lista.

Agrega Traducciones

Proporciona traducciones para todas las opciones, puntuaciones y términos relevantes usados en YAMLResume. Esto asegura que los usuarios puedan generar currículums en el nuevo idioma con etiquetas precisas, traducciones de opciones, términos y nombres de secciones. Aquí hay un PR de referencia para agregar traducciones para el idioma noruego.

Lista de verificación:

  • Agrega traducciones a nombres de países
  • Agrega traducciones de opciones para degrees, fluency, languages, sections, y skills
  • Agrega traducciones de puntuación para comma, colon, y separator
  • Agrega traducciones de términos para courses, keywords, y score

Actualiza la Configuración de Babel

YAMLResume usa LaTeX y Typst para generar PDF. LaTeX necesita una configuración del paquete babel adecuada para obtener los mejores resultados de composición; Typst reutiliza las traducciones anteriores y no necesita configuración adicional. Aquí hay un commit de referencia para el idioma noruego.

Lista de verificación:

  • Actualiza la función renderBabelConfig() en latex/base.ts para incluir el paquete babel para tu nuevo idioma.

Prueba con el Nuevo Idioma

Construye los paquetes yamlresume/core y yamlresume/cli, luego:

  • Crea un nuevo currículum pnpm cli dev new my-resume.yml
  • Establece locale.language al nuevo idioma que acabas de agregar
  • Prueba tus cambios generando un currículum en el nuevo idioma con pnpm cli dev build my-resume.yml
  • Asegúrate de que ambas salidas PDF funcionen como se espera.

Enviando Tu PR

Una vez que hayas completado los pasos anteriores, envía tu pull request con una descripción clara de los cambios y el idioma que estás agregando. Los mantenedores revisarán tu PR y pueden solicitar cambios o aclaraciones.

¡Gracias por ayudar a hacer YAMLResume accesible para más personas alrededor del mundo!

Edit on GitHub

Last updated on

On this page