Pular para o conteúdo
Oleaflyv0.4.12

Perguntas frequentes e solução de problemas

Respostas rápidas sobre os primeiros passos, projetos, compilação, assistentes e cópias de segurança.

Não. Baixe o Oleafly, abra e escreva. Serviços opcionais, como um provedor de IA na nuvem, GitHub ou Dropbox, usam as próprias contas.

Sim. Escolha o motor ao criar um projeto. Cada motor tem os próprios recursos de edição e exportação. O guia de início rápido percorre o caminho até o seu primeiro PDF.

Posso trazer um artigo ou um currículo já existente?

Seção intitulada “Posso trazer um artigo ou um currículo já existente?”

Sim. Importe o código-fonte de um projeto, um arquivo ZIP ou um repositório Git. O Oleafly também tem caminhos de conversão para DOCX e PDFs baseados em texto. Leia Trazer um projeto existente para escolher o caminho certo.

Você pode escrever, organizar arquivos, usar a correção de texto local e rodar um modelo de IA local baixado, sem conexão com a nuvem. O Tectonic consegue compilar com pacotes em cache. Pacotes novos, referências remotas, modelos na nuvem, GitHub e downloads precisam de conexão. Deixe o projeto com uma compilação bem-sucedida pronta antes de levá-lo para o uso offline.

Os seus projetos são pastas comuns na sua biblioteca local. Você pode copiá-los, fazer cópia de segurança deles ou abri-los em outra ferramenta. Onde ficam os seus dados explica os arquivos do projeto, as configurações do aplicativo e os pontos de verificação.

Posso usar o Oleafly para uma tese ou um currículo?

Seção intitulada “Posso usar o Oleafly para uma tese ou um currículo?”

Sim. Comece pelo fluxo de trabalho de tese ou pelo fluxo de trabalho de currículo. Os dois usam o mesmo editor, prévia, referências e ferramentas de exportação de um artigo científico.

Confira se o arquivo veio dos lançamentos oficiais (abre em uma nova guia) e se corresponde à sua plataforma. Siga o guia de instalação para os passos de primeira execução da plataforma.

Escolha a arquitetura que corresponde ao seu computador e o AppImage, o pacote Debian ou o RPM. Veja Instalação no Linux para os requisitos do sistema.

O Tectonic pode precisar baixar pacotes usados por este documento, e a primeira compilação em um computador também busca um lote de pacotes comuns. Eles ficam em cache para compilações futuras. Enquanto pacotes ainda estão sendo baixados, a compilação pode passar do limite habitual de cinco minutos. Abra os Logs para ver o que está acontecendo.

Se o modo offline estiver ativado, escolha Desligar e compilar na mensagem, ou desative-o por uma compilação para buscar o pacote. Em uma cadeia de ferramentas TeX do sistema, use Localizar e instalar no erro. O TeX Live do Debian, do Ubuntu ou do Fedora recebe os pacotes dele pelo apt ou pelo dnf. Veja Motores e pacotes LaTeX.

Escolhi o pdfLaTeX e o Oleafly pede uma distribuição TeX

Seção intitulada “Escolhi o pdfLaTeX e o Oleafly pede uma distribuição TeX”

O pdfLaTeX, o XeLaTeX, o LuaLaTeX, o upLaTeX e o pLaTeX rodam em uma distribuição TeX instalada no seu computador. Quando não há nenhuma, escolher qualquer um deles abre um diálogo antes de qualquer compilação. Escolha Baixar e usar o TinyTeX para instalar uma, ou Voltar para o Tectonic para retornar ao motor embutido. Depois de uma compilação que falhou, a prévia oferece a mesma escolha como Baixar e usar o TinyTeX e Usar Tectonic. Veja Quando nenhum TeX está instalado.

O latexmk do MiKTeX roda em Perl, que o MiKTeX não inclui. Instale o Strawberry Perl, ou instale o TinyTeX em Configurações → Motores → LaTeX, que traz o próprio Perl e assume as compilações no lugar do MiKTeX. Veja MiKTeX e Perl.

A fonte não tem glifos para esses caracteres. Isso acontece mais com texto em coreano, chinês e japonês, e o TeX deixa os caracteres de fora sem fazer a compilação falhar. O Oleafly avisa e os lista no log. No LaTeX, cole a configuração que o aviso traz para a sua escrita. No Typst, baixe o pacote de fontes que o aviso oferece, ou acrescente à pasta fonts do projeto uma fonte que tenha os caracteres. No Markdown, defina mainfont ou CJKmainfont no cabeçalho YAML com uma fonte que os tenha. Veja Caracteres ausentes no PDF e Caracteres que aparecem como caixas.

O Oleafly interrompeu a minha compilação por demorar demais

Seção intitulada “O Oleafly interrompeu a minha compilação por demorar demais”

Uma compilação pode rodar por 5 minutos. Enquanto pacotes ainda estão sendo baixados, o limite se estende até 30 minutos. O Markdown para PDF tem 15 minutos, e o Quarto e o Calepin têm uma hora. Compile de novo: um download continua de onde parou. Para rascunhos longos no Tectonic, defina Modo de compilação como Rápido no menu de compilação.

Projetos novos podem usar a minha própria instalação do TeX?

Seção intitulada “Projetos novos podem usar a minha própria instalação do TeX?”

Sim. Abra Configurações → Motores → LaTeX e defina o Motor de compilação padrão como latexmk (TeX do sistema). Projetos LaTeX novos, importados e convertidos passam a começar nele. Veja Definir um padrão para novos projetos.

Esses pacotes executam outros programas enquanto o documento compila, o que o Oleafly bloqueia por padrão. Eles precisam de LaTeX do sistema. Se você confia em todos os arquivos do projeto, escolha Permitir comandos externos na faixa acima do editor. Veja Permitir comandos externos.

Abra os Logs e confira primeiro as citações e referências indefinidas. A Pré-verificação ajuda a encontrar os trechos do código-fonte afetados antes de você exportar.

Peça ao assistente para ler o log, corrigir o erro e compilar de novo. Use Pedir aprovação quando quiser revisar as ações propostas ao longo do caminho. Você também pode publicar o log no fórum de ajuda no Discord.

Por que um formato de exportação está faltando?

Seção intitulada “Por que um formato de exportação está faltando?”

Os formatos disponíveis dependem do motor e do tipo de documento. Confira a tabela de exportação.

Conecte um provedor de modelos, use um modelo local ou escolha um agente de CLI. Configurar a IA cobre cada caminho.

Não. Escrita, compilação, citações, prévias, diagramas, histórico do projeto e exportações estão disponíveis sem assistente.

Ele pode trabalhar com arquivos do projeto, consultar fontes, inspecionar um PDF, criar figuras, executar ferramentas e ajudar a reparar uma compilação. Escolha um plano e uma política de aprovação adequados ao trabalho. Veja Conversa e ferramentas.

O modelo passou por um teste de chamada de ferramenta. Isso ajuda você a escolher um modelo para ações no projeto; não avalia a qualidade da escrita ou da pesquisa dele. Veja Configurar a IA.

Alguns provedores e agentes de CLI não informam o uso. Desconhecido significa que o valor não está disponível. Leia Uso e orçamentos.

Sim. Use uma conexão de agente de CLI integrada, ative o servidor MCP local do Oleafly ou conecte o seu agente ao comando oleafly, que também funciona com o aplicativo fechado.

Abra os Pontos de verificação para comparar o código-fonte de compilações bem-sucedidas e restaurar uma versão. Use o Controle de versão para os commits do Git que você mesmo gerencia.

Sim. Com a colaboração em tempo real, você e os seus coautores editam o mesmo projeto ao mesmo tempo por um servidor de colaboração que o seu grupo mantém. Cada um mantém o projeto como arquivos no próprio computador. Você também pode compartilhar pacotes do código-fonte ou usar a sincronização com o GitHub para trocar commits.

Sim. A sincronização na nuvem mantém os projetos e as configurações da sua biblioteca no seu próprio Dropbox, e cada computador que você conecta pode baixá-los. Abra Configurações → Armazenamento de dados → Sincronização na nuvem para conectá-la. Você também pode mover um projeto entre computadores com a sincronização com o GitHub.

Exportar o código-fonte faz cópia de segurança de tudo?

Seção intitulada “Exportar o código-fonte faz cópia de segurança de tudo?”

Faz cópia de segurança do código-fonte do projeto. Pontos de verificação automáticos, preferências do aplicativo e credenciais ficam separados. Siga o guia de backup para incluir o que você precisa.

Abra Configurações → Ajuda e sobre → Copiar informações e inclua esses dados com uma descrição curta, os passos para reproduzir o problema e o log relevante. Relate o problema em Issues (abre em uma nova guia); use a comunidade no Discord para perguntas e ajuda com fluxos de trabalho.

Visualização da imagem

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

Tente de novo ou pesquise na documentação.