Ferramentas do documento
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
Seção intitulada “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\documentclasspara 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
Seção intitulada “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 otlmgrpara 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
aptoudnfe 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.
Escolha o compilador na seta ao lado de Compilar de novo. Veja Motores LaTeX.
Pacotes Typst
Seção intitulada “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.typaberto. 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
Seção intitulada “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
Seção intitulada “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-packagesdo projeto. Um projeto configurado assim compila offline e em outros computadores. - Incorporar os pacotes ao projeto copia do cache para
typst-packagestodos 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
Seção intitulada “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
Seção intitulada “Páginas relacionadas”- O editor: o restante da barra de ferramentas do editor
- Compilação: como os pacotes são obtidos durante uma compilação
- Configurações do documento: tamanho do papel, margens e fontes sem escrever código de pacote