Pular para o conteúdo
Oleaflyv0.4.12

A sua tela inicial: projetos como livros, marcadores, prévias ao passar o mouse, bifurcação e uma busca de projetos que usa a sintaxe de busca do GitHub.

A biblioteca é a tela inicial do Oleafly. Cada projeto aparece como um livro em uma estante, com o mais recentemente ativo primeiro, e tudo o que você precisa para gerenciar projetos acontece aqui.

Um projeto mostra a prévia da primeira página ao passar o mouse, e depois a busca e os filtros reduzem a biblioteca.
Um projeto mostra a prévia da primeira página ao passar o mouse, e depois a busca e os filtros reduzem a biblioteca. Abrir captura de tela completa

Cada cartão mostra o nome do projeto e a cor da capa. A capa também diz que tipo de projeto é: Documento, Imagem, Diagrama ou Externo, para uma pasta que você abriu no próprio local. Abaixo do cartão ficam o motor (LaTeX, Typst ou Markdown) e a hora da última alteração. Abra um projeto para voltar ao código-fonte e à visualização dele.

Os botões no canto superior direito alternam entre a grade, que mostra as capas, e a lista, que é mais fácil de percorrer.

Com a biblioteca vazia, a tela de boas-vindas oferece Novo projeto e Abrir uma pasta.

Clique em Novo projeto e escolha como começar:

  • Usar um modelo para um artigo, tese, currículo, apresentação ou documento em branco. Navegue pela galeria de modelos, escolha um modelo e dê um nome ao seu projeto.
  • Importar um projeto para trazer arquivos existentes. Veja o guia de importação para cada formato.
  • Projeto de pesquisa para organizar um espaço de pesquisa com documentos, fontes e tarefas.

Se você não escolher uma cor de capa, o novo projeto recebe uma cor aleatória da paleta. O Oleafly também registra os arquivos do projeto em um primeiro commit no Git chamado “Criar projeto”. Veja Git e controle de versão.

Você também pode abrir a galeria de qualquer lugar com a omnibarra de busca: pressione ⌘⇧F (Ctrl+Shift+F) e digite /create.

Abrir pasta (⌘⇧O / Ctrl+Shift+O) deixa você trabalhar em uma pasta onde ela já está, sem copiá-la para a biblioteca. Compilações, configurações, pontos de verificação e conversas dessa pasta vão para a pasta de dados do próprio Oleafly, então nada é adicionado à sua. A pasta fica na estante marcada como Externo, e o cartão dela avisa quando a pasta não é encontrada ou a unidade não está conectada.

O Oleafly limita alguns recursos em uma pasta aberta dessa forma, como Git, agentes externos e LaTeX do sistema por meio do latexmk. Uma faixa acima do editor oferece Confiar nesta pasta para ativá-los. Confie apenas em pastas cujo conteúdo você conhece. Até lá, a pasta compila no motor Tectonic embutido. Depois de confiar nela, uma pasta sem motor próprio segue o motor de compilação padrão. Comandos externos ainda precisam da própria permissão depois disso.

A sincronização na nuvem faz cópia de segurança apenas dos projetos na sua biblioteca, então uma pasta aberta no próprio local não é sincronizada.

Clique com o botão direito em um cartão Externo para mostrar a pasta no seu gerenciador de arquivos, Copiar para a biblioteca para criar um projeto seu, ou Remover do Oleafly, que deixa os arquivos onde estão. Você também pode abrir pastas pelo Finder, Explorador de Arquivos ou terminal; veja Integração com o sistema.

Passe o mouse sobre um livro e a primeira página do último PDF compilado desliza sobre a capa, para você distinguir seus artigos de relance. As prévias vêm da saída compilada de verdade e ficam em cache, então a estante continua rápida.

Se você preferir não vê-las, desligue Prévia do PDF ao passar o mouse em Configurações → Aparência → Visualização do PDF.

Passe o mouse sobre um livro e clique no ícone de marcador dele para marcar o projeto. Para mostrar só os projetos com marcador, digite is:bookmarked na caixa de busca ou defina Marcador como Com marcador nos Filtros avançados.

Um artigo bifurcado para uma nova submissão, com a cópia ganhando uma cor de capa própria.
Um artigo bifurcado para uma nova submissão, com a cópia ganhando uma cor de capa própria. Abrir captura de tela completa

Clique com o botão direito em qualquer livro:

  • Abrir projeto
  • Detalhes do projeto: o nome, o ID, o motor, o tipo, o documento principal, datas e outros metadados que a busca usa.
  • Histórico de exportações: os arquivos que você exportou deste projeto.
  • Cor do projeto: onze amostras de capa (Azul, Creme, Pêssego, Rosé, Rosa, Lilás, Céu, Água, Ciano, Menta, Primavera). A cor fica guardada no próprio projeto, então ela acompanha o projeto se você sincronizá-lo em outra máquina.
  • Bifurcar projeto: copia o projeto e todo o histórico dele no Git para um projeto novo. A caixa de diálogo sugere <name> (copy); dê o nome que você quiser. Use uma cópia para testar outra versão de um currículo ou artigo. A cópia começa sem pontos de verificação.
  • Excluir projeto: move o projeto para a Lixeira, de onde ele pode ser restaurado.

Abra o projeto e clique no título dele na barra de ferramentas superior. O título fica editável no próprio lugar: digite o novo nome e pressione Enter. A renomeação é salva nos metadados do próprio projeto.

A caixa de busca no topo da tela inicial filtra a estante enquanto você digita. Ela usa a mesma sintaxe da busca de issues e pull requests do GitHub. Palavras simples correspondem ao nome do projeto, ao ID, ao arquivo principal, ao caminho da pasta, às exportações, ao motor, ao tipo e à cor da capa. Qualificadores estreitam a lista:

QualificadorExemploCorrespondências
is:is:bookmarked, is:folder, is:library, is:forkedProjetos com marcador, pastas abertas no próprio local, projetos guardados no Oleafly, bifurcações
has: e no:has:preview, no:exportsProjetos com ou sem prévia de PDF compilado ou exportações
engine:engine:typst, engine:latexLaTeX, Typst ou Markdown
kind:kind:imageProjetos de documento, imagem ou diagrama
color:color:mintCor da capa, pelo nome da amostra
created:, updated:, opened:created:>2026-01-01, updated:>@today-1wData de criação, última alteração ou última abertura
in:draft in:nameLimita as palavras a name, id, file, path ou export
sort:sort:name-asc, sort:createdOrdem da estante

engine:latex encontra todos os projetos LaTeX, qualquer que seja o motor LaTeX usado. O mais antigo engine:tectonic continua funcionando e encontra os mesmos projetos.

As regras seguem as do GitHub:

  • Um espaço significa AND. AND e OR em maiúsculas, e parênteses, agrupam termos, até cinco níveis de profundidade. O AND tem precedência sobre o OR.
  • Vírgulas listam alternativas: engine:typst,markdown corresponde a qualquer um dos dois motores. Repetir um qualificador significa os dois, então engine:typst engine:markdown não encontra nada.
  • Um - no início exclui: -kind:image, -is:bookmarked. NOT também funciona, e -word deixa de fora os projetos que contêm aquela palavra.
  • Aspas mantêm os espaços juntos: "lab notes", in:path "My Papers".
(engine:typst OR engine:markdown) is:bookmarked -kind:image sort:updated-desc

Datas aceitam >, >=, < e <=, intervalos como 2026-01-01..2026-03-31 (use * para uma extremidade aberta) e datas relativas: @today, @today-7d, @today-2w, @today-1m ou @today-1y. created:>@today-1w significa os últimos sete dias.

sort: aceita activity, updated, created, opened ou name, cada um com -asc ou -desc. Sem uma direção, a ordenação é descendente. O padrão é a atividade recente.

Clique na caixa de busca enquanto ela está vazia e um menu suspenso lista os qualificadores. Conforme você digita, ele sugere qualificadores, os valores deles, AND, OR e Excluir. Percorra o menu com as setas e pressione Enter para aceitar uma sugestão. Tab ou Escape o fecha sem aceitar nada.

Qualificadores e valores aparecem em cores conforme você digita. Um erro ganha um tom âmbar e uma nota curta dizendo o que está errado: um parêntese não fechado, por exemplo, ou um valor que o qualificador não aceita. Um qualificador desconhecido é buscado como texto simples, e um valor inválido é ignorado.

O botão de controles deslizantes ao lado da caixa de busca abre os Filtros avançados, com menus de Motor, Tipo de projeto, Marcador, Visualização do PDF, Criado, Modificado e Ordenar por. Um menu Local se junta a eles depois que você abre uma pasta no próprio local. Todo menu edita o texto da busca, então a caixa e o painel sempre concordam. Quando o painel não consegue mostrar a sua consulta como uma única escolha, o menu mostra Personalizado. Redefinir remove os qualificadores e mantém as suas palavras simples.

A omnibarra de busca (⌘⇧F / Ctrl+Shift+F, ou Buscar documentos no dock) pesquisa metadados de projetos e o texto completo de cada documento de cada projeto. Ela salta direto para o projeto, o arquivo e a linha correspondentes. Digite / para comandos com escopo, como /projects, /docs ou /create.

A omnibarra tem filtros próprios, mais simples, como name:resume ou bookmark:yes. A sintaxe estilo GitHub acima pertence à caixa de busca da tela inicial.

Um pequeno dock na tela inicial reúne tudo o que não é um projeto:

  • Novo projeto: comece com um modelo, importe arquivos ou crie um espaço de pesquisa.
  • Buscar documentos: a omnibarra de busca (⌘⇧F / Ctrl+Shift+F).
  • Compositor de diagramas: o compositor de diagramas, sem abrir um projeto antes. Ele pergunta para que serve o diagrama: Diagrama TikZ, Diagrama Typst ou Diagrama Mermaid.
  • Notas: abre as Notas. Aparece enquanto Notas está ativado em Configurações → Experimentação.
  • Ferramentas do Oleafly: uma galeria com busca de utilitários de documentos (abaixo).
  • Aparência: alterne entre Claro, Escuro e Sistema.
  • Configurações: a engrenagem, ou ⌘, (Ctrl+,), abre a janela completa de configurações.

Ative Ferramentas LaTeX em Configurações → Experimentação para mostrar a galeria de Ferramentas do Oleafly. Ela reúne conversores entre LaTeX, Typst, Markdown, Word, HTML e imagens, além de construtores de referências, validadores, consultas de pesquisa, calculadoras de estatística e auxiliares de escrita. O guia de Ferramentas do Oleafly cobre cada uma.

Cada livro é uma pasta comum sob ~/.oleafly/projects/, com um nome aleatório legível como flying-pink-pikachu. Nada na biblioteca é proprietário: veja Onde os seus dados ficam.

Um projeto excluído fica na Lixeira até você restaurá-lo ou excluí-lo em definitivo. As duas ações estão em Configurações → Armazenamento de dados. Veja Armazenamento e Lixeira.

Visualização da imagem

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

Tente de novo ou pesquise na documentação.