Pular para o conteúdo
Oleaflyv0.4.12

Ferramentas de edição

Navegação no nível de uma IDE para LaTeX e Typst: ir para a definição, encontrar referências, renomear em todo o projeto, cartões ao passar o mouse, prévia de matemática, o sumário do documento e, no Typst, ajuda de assinatura e formatação.

O Oleafly indexa o projeto inteiro, incluindo todo \label, toda chave de citação, toda macro personalizada, todo teorema, toda entrada de glossário e o grafo de \input que liga os seus arquivos. Esse índice sustenta a navegação entre arquivos. Os arquivos Typst usam os mesmos atalhos, respondidos pelo servidor de linguagem do Typst; veja Arquivos Typst abaixo.

Os atalhos mostram as teclas do macOS. No Windows e no Linux, leia ⌘ como Ctrl.

Coloque o cursor em um \ref, em uma chave de \cite, em uma macro personalizada, em um \begin{env} de um ambiente que você definiu ou em um termo de glossário e pressione F12 (ou segure ⌘ e clique nele). O editor salta para onde ele está definido, abrindo o arquivo da definição se ele estiver em outro lugar do projeto.

Pressionar F12 quando você já está em uma definição passa a encontrar as referências dela, a mesma convenção das IDEs.

Shift+F12 lista todos os usos do símbolo no painel Referências da barra lateral esquerda: uma linha por ocorrência, com o arquivo, a linha e uma prévia, e um selo “def” na própria definição. Clique em uma linha para saltar até ela. É a forma mais rápida de responder a “posso excluir este rótulo?” ou “onde citei este artigo?”

Um rótulo de equação renomeado em dois arquivos ao mesmo tempo, e depois as referências dele listadas.
Um rótulo de equação renomeado em dois arquivos ao mesmo tempo, e depois as referências dele listadas. Abrir captura de tela completa

F2 renomeia um rótulo, uma chave de citação, uma macro, um teorema, uma entrada de glossário ou um ambiente em todo o projeto em uma só etapa: o arquivo aberto é atualizado ao vivo, os outros arquivos são reescritos no disco e o índice é reconstruído. Se o novo nome já existe, a renomeação é bloqueada antes de criar uma colisão, e um aviso informa quantas edições foram feitas em quantos arquivos.

Renomear fig:overview para fig:architecture e ver os seis \ref acompanharem é uma operação de dois segundos.

Com o cursor em um caminho de arquivo, como o argumento de \input ou \includegraphics, F2 renomeia esse arquivo e atualiza os caminhos que apontam para ele. O mesmo vale para #include e image() no Typst e para links e imagens no Markdown. Veja Os caminhos acompanham um arquivo movido.

Passe o mouse sobre qualquer símbolo e um cartão o explica:

  • Em uma referência: o tipo do símbolo, uma prévia do código-fonte e o local. Depois de uma compilação LaTeX bem-sucedida, as referências compatíveis também mostram o número compilado e a página.
  • Em uma definição: quantas referências ela tem no projeto.
  • Em qualquer coisa não resolvida: um rótulo claro “Não resolvida”, que é o seu primeiro aviso de um \ref com erro de digitação ou de uma entrada .bib ausente.

Segure ⌘ (Ctrl) ao passar o mouse e os símbolos clicáveis ficam sublinhados como links; clique para saltar.

Passe o mouse sobre uma matemática em linha $…$, \(…\) ou em destaque \[…\] para renderizá-la com o KaTeX sem compilar. A matemática em destaque usa o estilo de destaque. Uma expressão com erro mostra o erro.

Abaixo da árvore de arquivos, o painel Sumário mostra a estrutura do documento: as seções recuadas por nível, além dos \input, em todos os arquivos. Os itens de outros arquivos trazem um selo com o nome do arquivo. Clique em qualquer item para ir direto até ele. Para uma tese dividida em uma dúzia de arquivos de capítulo, este é o índice pelo qual você navega.

Os títulos de seção aparecem como texto simples, então um comando de cor, uma troca de fonte ou um \nameref em um título não aparece como LaTeX bruto. Os títulos criados por macros suas que envolvem \section são listados, e os títulos dentro da definição de uma macro, não.

O divisor do painel entre a árvore e o sumário pode ser arrastado para redimensionar.

Os três comandos de navegação também ficam no menu Inteligência de código da barra de ferramentas do editor (o ícone de chaves) e no menu de clique com o botão direito, para que sejam fáceis de descobrir antes de os atalhos virarem memória muscular.

Nos arquivos .typ, o Tinymist, o servidor de linguagem do Typst, responde à maioria desses comandos. O Oleafly executa a versão do Tinymist que corresponde à versão do Typst do projeto (veja Projetos Typst).

  • F12 ou ⌘+clique vai à definição de um rótulo, uma variável ou uma função, inclusive uma que esteja em outro arquivo.
  • ⇧F12 lista todos os usos no painel Referências.
  • F2 renomeia um rótulo, uma variável ou uma função em todo o projeto.
  • Passe o mouse sobre uma função para ler a documentação dela. Passe o mouse sobre uma importação @preview para ver um link do pacote no Typst Universe.

Os mesmos três comandos estão no menu Inteligência de código da barra de ferramentas do Typst, no menu de clique com o botão direito e na paleta ⌘K. Os rótulos em arquivos Typst e LaTeX ficam separados, então um rótulo usado nos dois não é informado duas vezes, e renomear um deixa o outro como está.

Digite ( depois do nome de uma função e um cartão mostra os parâmetros dela, com o que você está digitando destacado. Esc o fecha. Para ver o nome dos parâmetros escrito antes de cada argumento nas chamadas de função, ative Dicas de nome de parâmetro em Configurações → Aparência → Editor, em Typst.

Valores de cor como rgb("#1f77b4") ganham uma pequena amostra ao lado. Use ⌘+clique em um link ou em um caminho de arquivo no código-fonte para abri-lo.

Formatar documento organiza o arquivo inteiro com o typstyle. Pressione ⇧⌥F (Shift+Alt+F), clique com o botão direito no editor ou encontre o comando na paleta ⌘K. Formatar seleção formata só as linhas selecionadas.

O grupo Typst em Configurações → Aparência → Editor controla o formatador:

  • Formatar ao salvar formata um arquivo Typst toda vez que você pressiona ⌘S (Ctrl+S). O salvamento automático não mexe no arquivo. Vem desativado por padrão.
  • Largura de linha do formatador é o ponto em que o typstyle quebra linhas longas. O padrão é 120 caracteres.
  • Recuo do formatador é o número de espaços por nível. O padrão é 2.
  • Verificações de lint do Typst procura prováveis erros toda vez que você salva. Ativá-las ou desativá-las reinicia o servidor de linguagem.

Uma pasta pode conter mais de um artigo, como manuscript.tex ao lado de manuscript_v1.tex ou de uma saída do latexdiff. Cada arquivo LaTeX com o seu próprio \documentclass conta como um documento separado, junto com os arquivos que ele inclui por \input, \include ou \subfile. Rótulos, teoremas, entradas de glossário e macros pertencem ao próprio documento, então um rótulo presente em três cópias de um artigo não aparece como definido três vezes.

Ir para a definição, encontrar referências, renomear, o autocompletar, o Preflight e o oleafly check ficam dentro do documento em que você está trabalhando. Um \ref para um rótulo que só outro documento define aparece como indefinido, que é também o que a compilação diz. Os arquivos que nenhum documento inclui ainda enxergam todos os rótulos, e um projeto com um único documento não é afetado.

O assistente de IA tem uma ferramenta project_map construída sobre esse mesmo índice: o sumário, os rótulos, as citações, as macros, o grafo de arquivos e quaisquer referências não resolvidas. Quando você pergunta sobre “a seção de metodologia”, ele realmente consegue encontrá-la.

Visualização da imagem

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

Tente de novo ou pesquise na documentação.