# arXiv para Typst

Converta o código-fonte LaTeX de um artigo do arXiv em Typst, com uma verificação de compilação que lista o que não foi convertido.

O arXiv para Typst parte do código-fonte que os autores submeteram, não do PDF. O Oleafly baixa ou descompacta o e-print, converte o arquivo LaTeX principal dele para Typst e compila o resultado uma vez, para que você veja o que ainda precisa de correção.

## Quando usar

- você quer a estrutura de um artigo do arXiv em Typst;
- você é autor levando a sua própria submissão para Typst;
- a licença do artigo permite a reutilização que você tem em mente.

Para manter o artigo em LaTeX, use o [arXiv para LaTeX](/docs/tools/arxiv-to-latex/). Um artigo sem pacote de código-fonte não pode passar por esse caminho. O [PDF para Typst](/docs/tools/pdf-to-typst/) reconstrói o código-fonte a partir do PDF.

## Converta um artigo

1. Abra o **arXiv para Typst** ou execute `/arxiv-to-typst`.
2. Em **ID do arXiv**, digite um identificador como `1706.03762`. Para trabalhar offline, mude para **Arquivo salvo** e escolha um pacote de código-fonte `.tar.gz`, `.tgz` ou `.gz`.
3. Escolha **Converter**.
4. Leia a nota abaixo do resultado. Ela nomeia o arquivo LaTeX principal, diz se o Typst compilou o resultado e conta os itens que não foram convertidos. A lista abaixo da nota mostra cada erro do Typst com o número de linha e cada item que não foi convertido.
5. Escolha **Salvar ZIP** para manter o `main.typ` com os outros arquivos do artigo, ou **Criar projeto** para abri-lo como um projeto Typst.

## O que a conversão faz

O Oleafly encontra o arquivo principal e traz para ele o texto dos arquivos carregados com `\input`, `\include` ou `\subfile`. O Pandoc converte esse LaTeX para Typst com seções numeradas. Figuras, arquivos de bibliografia e os outros arquivos não TeX do pacote mantêm suas pastas ao lado do `main.typ`, de modo que o arquivo convertido ainda encontra suas imagens. O Typst então compila o arquivo convertido como verificação.

Buscar um ID baixa o código-fonte do arXiv e precisa de uma conexão de rede. Um arquivo salvo converte inteiramente no seu dispositivo, com o Pandoc que acompanha o Oleafly.

## O que corrigir manualmente

Macros personalizados, pacotes sem equivalente em Typst, figuras TikZ, tabelas complexas e estilos de bibliografia são os remanescentes habituais. Resolva primeiro os erros do Typst na lista e depois compare o PDF compilado com o artigo, seção por seção. O Typst não consegue exibir figuras EPS, então converta essas figuras para PDF, PNG ou SVG.

:::caution[Confira primeiro a licença]
Artigos no arXiv carregam licenças diferentes. Verifique a licença do artigo e os termos dos autores antes de reutilizar o texto ou as figuras dele.
:::

Para converter um projeto LaTeX que você já tem no Oleafly, use **Converter em um projeto Typst** pela paleta de comandos. O documento [Projetos Typst](/docs/typst/#convert-a-latex-project-to-typst) explica o recurso.
