# Pacotes

Pesquise pacotes LaTeX no CTAN e pacotes Typst no Typst Universe e adicione um ao seu documento pela barra de ferramentas do editor.

Documentos LaTeX e Typst recebem a maior parte dos recursos extras de pacotes. O botão de pacotes na extremidade direita da barra de ferramentas do editor abre uma lista pesquisável para a linguagem do projeto e escreve para você a linha que carrega um pacote. Projetos Markdown não têm botão de pacotes.

Você também pode abrir a lista pela paleta do ⌘K com **Navegar pelos pacotes LaTeX** ou **Navegar pelos pacotes Typst**.

## Pacotes LaTeX

Em um projeto LaTeX, escolha **Pacotes LaTeX**. Pesquise no CTAN por nome ou descrição do pacote. Se o CTAN não puder ser alcançado, ou se você estiver offline, o diálogo avisa e mostra a lista interna do Oleafly no lugar. Uma lista que não pôde ser atualizada mostra a data em que foi baixada.

Cada linha pode mostrar estes rótulos:

- **No documento**: o arquivo principal já carrega este pacote.
- **Classe de documento**: a entrada é uma classe, não um pacote. Classes são definidas com `\documentclass`, então a linha permite copiar essa linha, mas não adicioná-la.
- **Instalado**: a sua distribuição TeX já tem o pacote.

Cada linha também tem estes controles:

- **Opções**, um campo para opções do pacote, como `margin=2cm`. As chaves precisam corresponder, e `]` ou `%` não podem ser usados.
- **Adicionar ao preâmbulo**, que escreve `\usepackage[options]{name}` no preâmbulo do arquivo principal. Se o arquivo já carrega o pacote, nada muda e o diálogo avisa.
- **Copiar linha**, que copia a mesma linha `\usepackage`, ou a linha `\documentclass` para uma classe.
- **CTAN**, que abre a página do pacote no CTAN.
- **Instalar**, para um pacote que falta na sua distribuição TeX. Veja abaixo.

### Instalando pacotes LaTeX

O que "instalado" significa depende de como o projeto compila:

- **Tectonic**, o compilador interno, baixa um pacote na primeira vez que o seu documento o usa. Não há nada para instalar, e o diálogo informa isso no topo.
- **latexmk com TeX Live ou TinyTeX**: quando a sua distribuição TeX tem o `tlmgr`, o Oleafly verifica quais pacotes você tem, marca-os como **Instalado** e oferece **Instalar** para os demais. Instalar executa o `tlmgr` para aquele pacote.
- **TeX Live do Debian, do Ubuntu ou do Fedora**: o gerenciador de pacotes do sistema é o dono dele, então o diálogo manda instalar os pacotes com `apt` ou `dnf` e não tem botão **Instalar**.
- **Outras configurações TeX**, como o MiKTeX: o Oleafly não consegue dizer quais pacotes estão presentes, então as linhas não mostram estado de instalação. Use o MiKTeX Console para o MiKTeX.

Com o TeX Live ou o TinyTeX, uma compilação que não encontra um arquivo oferece **Localizar e instalar** na mensagem de erro, que descobre a qual pacote o arquivo pertence. Veja [Recuperar de um arquivo ausente](/docs/latex-engines/#recover-from-a-missing-file).

Escolha o compilador na seta ao lado de **Compilar de novo**. Veja [Motores LaTeX](/docs/latex-engines/).

## Pacotes Typst

Em um projeto Typst, escolha **Pacotes Typst** para navegar pelo Typst Universe. Pesquise por nome, palavra-chave ou categoria, ou reduza a lista com um chip de categoria. O diálogo mostra até 100 pacotes por vez, então pesquise quando a lista for longa.

Cada linha mostra o nome do pacote, a versão mais recente dele, um distintivo **Modelo** para pacotes de modelo e uma descrição curta. Quando um pacote precisa de um Typst mais novo do que o usado pelo projeto, a linha diz qual versão ele precisa.

- **Inserir importação** adiciona `#import "@preview/name:version": *` depois das importações no topo do arquivo `.typ` aberto. Se o arquivo já importa esse pacote, só o número de versão muda. Um arquivo Typst precisa estar aberto no editor.
- **Copiar importação** copia a mesma linha.

### Dicas de atualização

Quando uma importação `@preview` no seu arquivo é mais antiga do que o lançamento mais recente no Typst Universe, o editor marca a versão com uma dica como "cetz 0.4.2 está disponível. Esta importação usa 0.3.4." A ação **Atualizar para 0.4.2** da dica troca o número no lugar.

### Mantenha os pacotes com o projeto

O Typst baixa pacotes para um cache compartilhado na primeira vez que um projeto os importa. Para que um projeto carregue as próprias cópias, use **Pacotes do projeto** no fim do diálogo:

- **Usar pacotes da pasta do projeto** faz o Typst procurar primeiro na pasta `typst-packages` do projeto. Um projeto configurado assim compila offline e em outros computadores.
- **Incorporar os pacotes ao projeto** copia do cache para `typst-packages` todos os pacotes que o projeto importa. Se um pacote ainda não estiver no cache, compile uma vez on-line e incorpore de novo.

Os dois precisam do Typst 0.12 ou mais novo. Em um projeto fixado no Typst 0.11, a seção avisa isso.

A seção também mostra quantos pacotes o projeto mantém.

### Offline

Com o modo offline ativado, o diálogo usa a lista de pacotes baixada da última vez e mostra a data dela. Se nenhuma lista tiver sido baixada, ele não consegue mostrar uma até você ficar on-line.

## Páginas relacionadas

- [O editor](/docs/editor/#the-editor-toolbar): o restante da barra de ferramentas do editor
- [Compilação](/docs/compiling/): como os pacotes são obtidos durante uma compilação
- [Configurações do documento](/docs/document-settings/): tamanho do papel, margens e fontes sem escrever código de pacote
