lattes2pdf

Converta seu Currículo Lattes em um CV em PDF, escolhendo o que apresentar e como organizar as informações. Use perfis editáveis para criar versões acadêmicas ou resumidas e temas do RenderCV para definir a aparência. O YAML gerado é compatível com o RenderCV e pode ser editado e renderizado diretamente, inclusive com temas personalizados pelo usuário.

Veja exemplos fictícios nos nove temas do RenderCV.

Instalação

Requer Python 3.12 ou superior. No Linux ou macOS, instale em um ambiente virtual:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install lattes2pdf

O RenderCV é instalado como dependência e a geração usa Typst.

Do Lattes ao PDF

Na Plataforma Lattes, acesse a edição do seu currículo e procure Exportar, escolhendo o formato XML. Salve o arquivo baixado: o lattes2pdf aceita tanto o XML quanto o ZIP que o contém, sem precisar descompactá-lo.

O perfil seleciona e organiza o conteúdo e o tema define a aparência.

Gerar um currículo

lattes2pdf render curriculo.xml -o cv.pdf

O comando usa o preset resumido, com o tema classic por padrão. Para incluir todos os detalhes conhecidos do currículo sem aplicar um preset, use --full.

Esse comando gera três arquivos:

Para experimentar outro tema, use --theme moderncv ou um nome listado em lattes2pdf theme --help. Todos os nove temas nativos do RenderCV 2.8 estão disponíveis. Use pastas separadas para comparar temas; com temas personalizados, templates e fontes também são copiados junto ao YAML.

Para testar sem o seu Lattes, baixe o XML fictício e use-o no lugar de curriculo.xml.

Comece com um perfil

O preset resumido já é usado por padrão em render e export. Os presets seguem a seleção de categorias dos modelos de exportação presentes na plataforma Lattes. Para escolher outro ou editar suas preferências, copie um preset e use o arquivo na geração:

lattes2pdf profile ampliado -o profile.yaml  # gera o arquivo de configuração
lattes2pdf render curriculo.xml --profile profile.yaml -o ampliado.pdf  # usa o perfil personalizado

O estilo bibliográfico é independente do tema: os presets usam ABNT; para Chicago (autor-data), use --bibliography-style chicago ou bibliography_style: chicago no perfil.

• Os três são arquivos YAML editáveis e aceitam exclusões, filtros e ajustes por seção.
• O preset completo é diferente de --full.
• Nenhum preset limita páginas, anos ou quantidade de registros.

Categorias do Lattes

Liste as seções do currículo e consulte os grupos e possíveis ajustes de cada uma delas:

lattes2pdf sections
lattes2pdf sections lattes.formacao

Por exemplo, lattes.formacao reúne education (formação acadêmica) e training (formação complementar). Veja os grupos e registros presentes no seu currículo:

lattes2pdf inspect curriculo.xml --section lattes.formacao

Você pode combinar categorias e grupos no arquivo de configuração do perfil. Para manter a formação acadêmica e omitir a complementar:

include: [profile, lattes.formacao, lattes.atuacao, lattes.artigos]
exclude: [training]

Endereço também é uma categoria: use lattes.endereco em include ou exclude. Por exemplo, para gerar um currículo sem endereço a partir do seu perfil:

lattes2pdf render curriculo.xml --profile profile.yaml --exclude lattes.endereco -o cv.pdf

Editar o resultado no RenderCV

Abra o cv.yaml gerado, ajuste o texto ou a aparência e compile novamente:

rendercv render cv.yaml --pdf-path cv-editado.pdf

Essa edição afeta o documento gerado. Para repetir as escolhas em novas exportações, salve as de conteúdo no profile.yaml e as visuais no design.yaml.

Escolher o que aparece

Veja as seções e os registros do seu currículo:

lattes2pdf inspect curriculo.xml
lattes2pdf inspect curriculo.xml --section lattes.artigos

Por exemplo, a publicação do XML fictício aparece assim:

publications.articles — Artigos publicados (1)
  publications.articles:5af5a2d20b36  Catálogos abertos & memória digital (2024)

Use o nome de um grupo para excluí-lo inteiro ou copie o ID de um registro específico:

lattes2pdf render curriculo.xml --exclude training -o sem-formacao-complementar.pdf
lattes2pdf render curriculo.xml \
  --exclude-id publications.articles:5af5a2d20b36 -o sem-artigo.pdf

Use os IDs retornados pelo seu próprio inspect. As opções de inclusão e exclusão aceitam vários valores separados por espaços, como --exclude training awards, e também podem ser repetidas.

Guardar suas preferências

Edite o preset copiado ou crie um profile.yaml com apenas as escolhas de que precisa:

include: [profile, lattes.formacao, lattes.atuacao, lattes.artigos]
exclude: [training]
order: [profile, lattes.atuacao, lattes.formacao, lattes.artigos]
theme: moderncv

sections:
  education:
    title: Formação acadêmica
    show_advisors: false
  publications.articles:
    show_authors: true
    show_links: true

Para guardar exclusões individuais, acrescente exclude_ids com os IDs do inspect:

exclude_ids:
  - publications.articles:5af5a2d20b36

Depois, aplique o arquivo:

lattes2pdf render curriculo.xml --profile profile.yaml -o personalizado.pdf

Consulte os possíveis ajustes de uma categoria ou diretamente de um grupo mostrado pelo inspect:

# exemplos
lattes2pdf sections lattes.formacao
lattes2pdf sections publications.articles
lattes2pdf sections profile
lattes2pdf sections lattes.anais
lattes2pdf sections lattes.patentes

Um --profile explícito substitui o preset padrão, e as opções da linha de comando tem precedência sobre o arquivo de perfil. Para filtros por ano, ordenação e outros ajustes, consulte lattes2pdf render --help. Use --force quando quiser substituir saídas existentes.

Temas personalizados com RenderCV

O perfil e o tema podem ser usados juntos. Escolha onde fazer cada ajuste:

Para começar com a configuração de um tema nativo:

lattes2pdf theme classic -o meu-tema

Consulte as opções de design e o guia oficial para criar temas e personalizar templates do RenderCV.

Para usar seu tema no lattes2pdf, o design.yaml deve conter somente o mapa design. Se houver templates personalizados, mantenha a pasta com o nome indicado em design.theme ao lado desse arquivo, assim como a pasta fonts, se usada.

lattes2pdf render curriculo.xml --profile profile.yaml \
  --theme meu-tema/design.yaml -o meu-cv.pdf

Você também pode salvar theme: meu-tema/design.yaml no perfil. Nesse caso, o caminho é relativo ao profile.yaml.

Exportação e limites

Para gerar somente o YAML e o relatório, use lattes2pdf export curriculo.xml -o cv.yaml. O modo --full inclui todos os registros e detalhes conhecidos permitidos pela ferramenta, podendo produzir um documento extenso.

A integração atual usa RenderCV 2.8. Veja como contribuir e a licença MIT.