YAMLResume

Novo Idioma

O YAMLResume foi desenhado para suportar múltiplos idiomas desde a base, permitindo aos utilizadores criar currículos no seu idioma preferido.

No momento de escrever, o YAMLResume suporta os seguintes idiomas:

Se o teu idioma preferido não está listado, podes contribuir seguindo os passos abaixo para adicionar suporte para um novo idioma.

Regista o Teu Idioma

Para adicionar uma nova opção locale.language ao YAMLResume, primeiro regista o teu idioma em models/resume.ts adicionando uma nova entrada a LOCALE_LANGUAGE_OPTIONS.

Lista de verificação:

  • Adiciona o teu idioma a LOCALE_LANGUAGE_OPTIONS.
  • Constrói e testa o novo CLI com pnpm cli dev languages list, assegurando-te de que o teu idioma aparece na lista.

Adiciona Traduções

Fornece traduções para todas as opções, pontuações e termos relevantes usados no YAMLResume. Isto assegura que os utilizadores possam gerar currículos no novo idioma com etiquetas precisas, traduções de opções, termos e nomes de secções. Aqui está um PR de referência para adicionar traduções para o idioma norueguês.

Lista de verificação:

  • Adiciona traduções a nomes de países
  • Adiciona traduções de opções para degrees, fluency, languages, sections, e skills
  • Adiciona traduções de pontuação para comma, colon, e separator
  • Adiciona traduções de termos para courses, keywords, e score

Atualiza a Configuração de Babel

O YAMLResume usa LaTeX para geração de PDF, e para obter os melhores resultados de composição, precisamos de estabelecer a configuração do pacote babel adequada. Aqui está um commit de referência para o idioma norueguês.

Lista de verificação:

  • Atualiza a função renderBabelConfig() em preamble.ts para incluir o pacote babel para o teu novo idioma.

Testa com o Novo Idioma

Constrói os pacotes yamlresume/core e yamlresume/cli, depois:

  • Cria um novo currículo pnpm cli dev new my-resume.yml
  • Define locale.language para o novo idioma que acabaste de adicionar
  • Testa as tuas alterações gerando um currículo no novo idioma com pnpm cli dev build my-resume.yml
  • Assegura-te de que ambas as saídas PDF funcionam como esperado.

Enviando o Teu PR

Uma vez que tenhas completado os passos acima, envia o teu pull request com uma descrição clara das alterações e o idioma que estás a adicionar. Os mantenedores vão rever o teu PR e podem solicitar alterações ou esclarecimentos.

Obrigado por ajudar a tornar o YAMLResume acessível para mais pessoas à volta do mundo!

Edit on GitHub

Last updated on