# 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

### 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?

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](/docs/getting-started/) percorre o caminho até o seu primeiro PDF.

### 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](/docs/import-project/) para escolher o caminho certo.

### 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?

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](/docs/where-your-data-lives/) 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?

Sim. Comece pelo [fluxo de trabalho de tese](/docs/workflows/thesis/) ou pelo [fluxo de trabalho de currículo](/docs/workflows/resume/). Os dois usam o mesmo editor, prévia, referências e ferramentas de exportação de um artigo científico.

## Instalação

### O sistema operacional bloqueia o instalador

Confira se o arquivo veio dos [lançamentos oficiais](https://github.com/Oleafly/Oleafly/releases/latest) e se corresponde à sua plataforma. Siga o [guia de instalação](/docs/install/#first-launch) para os passos de primeira execução da plataforma.

### 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](/docs/install/#linux) para os requisitos do sistema.

## Compilação

### 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](/docs/compiling/#reading-the-logs) para ver o que está acontecendo.

### 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](/docs/latex-engines/#recover-from-a-missing-file).

### 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](/docs/latex-engines/#when-no-tex-is-installed).

### 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](/docs/latex-engines/#miktex-and-perl).

### 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](/docs/latex-engines/#characters-missing-from-the-pdf) e [Caracteres que aparecem como caixas](/docs/typst/#characters-that-show-as-boxes).

### 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?

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](/docs/engines/#set-a-default-for-new-projects).

### 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](/docs/latex-engines/#allow-external-commands).

### A compilação terminou com avisos

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

### 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](/discord).

### 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](/docs/export/#editable-formats).

## Assistentes de IA

### Qual assistente posso usar?

Conecte um provedor de modelos, use um modelo local ou escolha um [agente de CLI](/docs/cli-agents/). [Configurar a IA](/docs/ai-setup/) cobre cada caminho.

### 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?

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](/docs/ai-chat/).

### 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](/docs/ai-setup/).

### 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](/docs/ai-usage/).

### Posso conectar um assistente externo?

Sim. Use uma [conexão de agente de CLI](/docs/cli-agents/) integrada, ative o [servidor MCP](/docs/mcp/) local do Oleafly ou conecte o seu agente ao [comando `oleafly`](/docs/cli/), que também funciona com o aplicativo fechado.

## Histórico e colaboração

### Como recupero uma versão anterior?

Abra os [Pontos de verificação](/docs/checkpoints/) para comparar o código-fonte de compilações bem-sucedidas e restaurar uma versão. Use o [Controle de versão](/docs/git-history/) para os commits do Git que você mesmo gerencia.

### Posso trabalhar com um coautor?

Sim. Com a [colaboração em tempo real](/docs/collaboration/), 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](/docs/github-sync/) para trocar commits.

### Posso usar os meus projetos em dois computadores?

Sim. A [sincronização na nuvem](/docs/cloud-sync/) 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](/docs/github-sync/).

### 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](/docs/where-your-data-lives/#back-up-your-work) para incluir o que você precisa.

## 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](https://github.com/Oleafly/Oleafly/issues); use a [comunidade no Discord](/discord) para perguntas e ajuda com fluxos de trabalho.
