Perguntas frequentes e solução de problemas
Respostas rápidas sobre os primeiros passos, projetos, compilação, assistentes e cópias de segurança.
Primeiros passos
Seção intitulada “Primeiros passos”Preciso de uma conta?
Seção intitulada “Preciso de uma conta?”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.
O Oleafly aceita LaTeX, Typst e Markdown?
Seção intitulada “O Oleafly aceita LaTeX, Typst e Markdown?”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.
Posso trabalhar offline?
Seção intitulada “Posso trabalhar offline?”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.
Onde estão os meus arquivos?
Seção intitulada “Onde estão os meus arquivos?”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.
Instalação
Seção intitulada “Instalação”O sistema operacional bloqueia o instalador
Seção intitulada “O sistema operacional bloqueia o instalador”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.
Qual pacote Linux devo usar?
Seção intitulada “Qual pacote Linux devo usar?”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.
Compilação
Seção intitulada “Compilação”A minha primeira compilação é lenta
Seção intitulada “A minha primeira compilação é lenta”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.
Um pacote está faltando
Seção intitulada “Um pacote está faltando”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 MiKTeX diz que o latexmk precisa do Perl
Seção intitulada “O MiKTeX diz que o latexmk precisa do Perl”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.
Falta texto no meu PDF
Seção intitulada “Falta texto no meu PDF”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.
O meu documento usa minted ou PythonTeX
Seção intitulada “O meu documento usa minted ou PythonTeX”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.
A compilação terminou com avisos
Seção intitulada “A compilação terminou com avisos”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.
Não entendo um erro de compilação
Seção intitulada “Não entendo um erro de compilação”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.
Assistentes de IA
Seção intitulada “Assistentes de IA”Qual assistente posso usar?
Seção intitulada “Qual assistente posso usar?”Conecte um provedor de modelos, use um modelo local ou escolha um agente de CLI. Configurar a IA cobre cada caminho.
Preciso de IA para usar o editor?
Seção intitulada “Preciso de IA para usar o editor?”Não. Escrita, compilação, citações, prévias, diagramas, histórico do projeto e exportações estão disponíveis sem assistente.
O que o assistente pode fazer?
Seção intitulada “O que o assistente pode fazer?”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 que significa Verificado ao lado de um modelo?
Seção intitulada “O que significa Verificado ao lado de um modelo?”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.
Por que o uso aparece como Desconhecido?
Seção intitulada “Por que o uso aparece como Desconhecido?”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.
Posso conectar um assistente externo?
Seção intitulada “Posso conectar um assistente externo?”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.
Histórico e colaboração
Seção intitulada “Histórico e colaboração”Como recupero uma versão anterior?
Seção intitulada “Como recupero uma versão anterior?”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.
Posso trabalhar com um coautor?
Seção intitulada “Posso trabalhar com um coautor?”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.
Posso usar os meus projetos em dois computadores?
Seção intitulada “Posso usar os meus projetos em dois computadores?”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.
Relatar um problema
Seção intitulada “Relatar um problema”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.