Pular para o conteúdo
Oleaflyv0.4.12

Ferramentas do documento

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.

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.

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.

Escolha o compilador na seta ao lado de Compilar de novo. Veja Motores LaTeX.

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.

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.

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.

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.

Visualização da imagem

Não foi possível carregar as respostas da IA

Tente de novo ou pesquise na documentação.