curriculo-acad

English version below

LATTES é uma ótima plataforma para acadêmicos armazenarem todo o seu trabalho científico. No entanto, as opções de exportação são bastante frustrantes, já que a exportação em RTF não resulta em um currículo com uma boa aparência.

Por isso, estou tentando resolver esse problema exportando o arquivo XML e criando este modelo para gerar um PDF bem formatado usando Typst. Se você ainda não conhece o Typst, ele é uma linguagem muito mais fácil de aprender e um compositor mais rápido do que o LaTeX.

Eu iniciei este projeto e, como no meu currículo do LATTES não estão disponíveis todas as opções possíveis, pode haver erros quando você testá-lo. Você pode abrir uma issue ou criar um pull request com uma solução sugerida. Além disso, este é apenas o começo, então o código pode não estar tão simples e bonito quanto deveria ser.

Fonts

Eu uso Source Sans Pro, que você pode obter aqui.

Uso

Exportar arquivo XML e criar arquivo toml

Como estou mais familiarizado com arquivos toml e seu uso no Typst, criei o script em Python helper.py, que converte seu arquivo XML do LATTES em um arquivo toml. Para fazer a transformação, basta executar a seguinte linha no terminal, onde o script está localizado:

python3 helper.py caminho-para-o-seu-arquivo-xml

Isso criará o arquivo meu-arquivo.toml, que você poderá usar nos documentos do Typst.

O script você encontra aqui.

Criando o PDF

A estrutura do arquivo principal é bastante simples. Você só precisa indicar qual versão do currículo deseja no argumento kind: resumido, ampliado ou completo. Dependendo da sua escolha, você utiliza a função específica:

// Import of libraries
#import "lib.typ": *
#import "@preview/datify:0.1.3": *

#show: lattes-cv.with(
  database: "data/lattes.toml",
  kind: "completo",
  me: "KLEER",
  date: datetime.today()
  last_page: true
)     

Uso de Typst local

Antes de usar, você precisa instalar ou fazer update para Typst 0.12. Como você poderia instalar é descrevido aqui.

Uso no editor online de Typst

Você poderia usar o editor online de Typst para criar um projeto. Você poderia copiar esse projeto que já tem todos os arquivos (sem o arquivo criado do Lattes): Link. Você poderia copiar o projeto para usar.

Antes de executar, você somente precisa fazer o upload do arquivo transformado para .toml do Lattes.

Uso ou melhorias das funções

Esta é uma primeira abordagem simples para uma solução, e eu ainda não estruturei tudo completamente. O objetivo principal, até o momento, é ter funções para cada área que são chamadas se a área específica estiver presente nos dados XML/TOML.

As variáveis locais (em funções, loops, etc.) têm nomes em português. As variáveis globais têm nomes em inglês (global refere-se ao uso em lib.typ).

Como participar? (pull request)

Se você quiser participar no projeto, você pode gerar um fork e depois um pull request para adicionar seu código.

O que já está incluído

Embaixo tem uma tabela sobre as áreas no currículo Lattes. Eu não tenho todas categórias no meu, enfim eu não sei quais categórias são incluídas. Se você tiver uma dessas categórias marcada com 🧐 no seu currículo, você poderia alterar a tabela.

Status de programar a área

👷🏼 : precisa de trabalho (parcialmente codificado)

🎬 : finalizado

⛔️ : ainda não é começado

Inclusão no tipo de currículo

❌ : não incluído no tipo

✅ : incluído no tipo

🧐 : não certo que é incluído ou não

Exemplos (“completo”)

LATTES is a great platform for academics to store all their scientific work. However, the export options are quite frustrating, as exporting to RTF does not result in a well-formatted résumé.

That’s why I’m trying to solve this problem by exporting the XML file and creating this template to generate a well-formatted PDF using Typst. If you haven’t heard of Typst yet, it’s a much easier-to-learn language and a faster typesetting system than LaTeX.

I started this project, and since my LATTES résumé does not include all possible options, there may be errors when you test it. You can open an issue or create a pull request with a suggested fix. Additionally, this is just the beginning, so the code may not be as clean and elegant as it should be.

Fonts

I use Source Sans Pro, which you can get here.

Usage

Export XML file and create a TOML file

Since I am more familiar with TOML files and their use in Typst, I created the Python script helper.py, which converts your LATTES XML file into a TOML file. To perform the transformation, simply run the following command in the terminal where the script is located:

python3 helper.py path-to-your-xml-file

This will create the file my-file.toml, which you can use in Typst documents.

You can find the script here.

Creating the PDF

The structure of the main file is quite simple. You only need to specify which version of the résumé you want in the kind argument: resumido, ampliado, or completo. Depending on your choice, you use the specific function:

// Import of libraries
#import "lib.typ": *
#import "@preview/datify:0.1.3": *

#show: lattes-cv.with(
  database: "data/lattes.toml",
  kind: "completo",
  me: "KLEER",
  date: datetime.today()
  last_page: true
)     

Using Typst locally

Before using it, you need to install or update to Typst 0.12. Instructions on how to install it are described here.

Using Typst’s online editor

You can use the online Typst editor to create a project. You can copy this project, which already contains all the necessary files (except the Lattes-generated file): Link. You can duplicate the project for your use.

Before running it, you only need to upload the transformed .toml file from Lattes.

Using or improving functions

This is a first simple approach to a solution, and I haven’t fully structured everything yet. The main goal so far is to have functions for each section, which are called only if the specific section is present in the XML/TOML data.

Local variables (inside functions, loops, etc.) have names in Portuguese. Global variables have names in English (global refers to their use in lib.typ).

How to contribute? (Pull request)

If you want to contribute to the project, you can create a fork and then submit a pull request to add your code.

What is already included

Below is a table listing the sections in the Lattes résumé. I don’t have all categories in mine, so I’m unsure which categories are included. If your résumé contains one of the categories marked with 🧐, you can update the table accordingly.

Status of area implementation

👷🏼 : needs work (partially coded)

🎬 : completed

⛔️ : not started yet

Inclusion in résumé type

❌ : not included in this type

✅ : included in this type

🧐 : uncertain whether it is included or not
You can access the list above!