# Verificações de pré-submissão

Inspecione o código-fonte, o log de compilação, o PDF, as referências, os sinais de acessibilidade e os riscos de submissão antes que um documento saia das suas mãos.

Uma compilação bem-sucedida só prova que um PDF foi gerado. Ela não prova que toda citação foi resolvida, que a ordem de leitura faz sentido, que o pacote de submissão está limpo ou que o arquivo carrega a estrutura de acessibilidade que alega ter.

A Pré-verificação reúne essas perguntas em uma única revisão local. Abra o **escudo** no trilho do projeto, escolha as verificações que fazem sentido para o documento e rode uma verificação enquanto resolve um problema, ou o conjunto inteiro antes da submissão.

![O painel de Pré-verificação do Oleafly. Selecione as verificações de que você precisa, rode uma pela própria linha ou rode todas as verificações ativas pelo botão de baixo.](https://cdn.oleafly.com/images/screenshots/desktop/docs/preflight-checks-dark-window-v2.png#view=0,45,344,689)

![A Pré-verificação executa verificações de compilação, submissão e acessibilidade em um artigo antes do envio.](https://cdn.oleafly.com/images/gifs/desktop/preflight.gif?v=2)

## Seis verificações independentes

### Compilação e layout

Lê o log de compilação e o PDF mais recentes em busca de compilações falhas, citações e referências não resolvidas, avisos de nova passagem, glifos ausentes, caixas extrapoladas, texto cortado, destinos duplicados no PDF e tamanhos de página misturados.

### Prontidão para submissão

Aplica um perfil de publicação selecionado ao projeto. Ela confere requisitos estáveis sobre a classe de documento, o resumo e as palavras-chave, os formatos de figura, as fontes incorporadas, as restrições do PDF, as legendas, os nomes portáveis e o excesso de arquivos no pacote de código-fonte.

### Prontidão para ATS

Extrai um currículo de forma parecida com um sistema de triagem de candidatos. Ela informa os campos de contato, as seções esperadas e os layouts que podem embaralhar a ordem de leitura.

### Acessibilidade

Confere sinais do código-fonte e do PDF sobre marcação, texto alternativo, metadados de idioma e título, preferências do leitor, títulos, tabelas, links, ordem de leitura, texto selecionável, marcadores onde ajudam e texto muito pequeno.

### Referências e recursos

Encontra arquivos ausentes, citações e referências cruzadas não resolvidas, rótulos e DOIs duplicados, entradas de bibliografia incompletas e referências não citadas quando o projeto completo está disponível.

### Privacidade e revisão cega

Procura credenciais, chaves privadas, arquivos sensíveis, notas de rascunho, comentários internos, agradecimentos, campos de autoria e metadados de identidade que podem quebrar uma revisão cega.

## Projetos Typst

Os códigos Typst têm as suas próprias verificações. Elas leem os seus arquivos `.typ` diretamente, então regras de LaTeX nunca disparam sobre sintaxe Typst.

- **Referências e recursos** encontra referências `@` e citações sem rótulo ou entrada de bibliografia correspondente, rótulos duplicados, caminhos de imagem ou `#include` que não correspondem a nenhum arquivo do projeto, um arquivo `#bibliography` que não está no projeto e um documento que cita fontes mas nunca chama `#bibliography`. As chaves de citação podem ficar em um arquivo `.bib` ou em um arquivo Hayagriva `.yml`.
- **Acessibilidade** aponta imagens sem texto `alt`, na imagem ou na figura que a contém, títulos vazios e um documento sem título definido por `#set document(title: ...)` ou pelo modelo.
- **Prontidão para submissão** confere se o projeto importa um modelo compatível com o perfil escolhido, se o modelo recebe um resumo e palavras-chave e se não sobrou texto `#lorem`, espaço reservado ou nota de TODO. Ela também olha legendas, tamanhos de imagem e nomes de arquivo.
- **Privacidade e revisão cega** encontra nomes de autores, e-mails e afiliações passados ao modelo, agradecimentos e caminhos de arquivos locais.

Cada achado nomeia o arquivo e a linha, e o detalhe dele mostra a correção em Typst, como `#image("chart.png", alt: "Bar chart of yearly sales")`.

## Leia a certeza, não só a cor

Cada resultado explica como o Oleafly chegou até ele:

- **Verificado** significa que o aplicativo observou evidência direta no código-fonte, no log, no projeto ou no PDF.
- **Aviso** significa que uma heurística documentada encontrou algo que uma pessoa deveria inspecionar.
- **Manual** nomeia uma verificação que os arquivos não conseguem resolver com segurança.

Uma entrada ausente nunca se torna uma aprovação. Achados só no código-fonte permanecem parciais até existir um PDF atual.

## Escolha um perfil de publicação

Use o perfil de publicação em geral, arXiv, IEEE, ACM, periódico ou tese que melhor corresponde ao destino. Os perfis cobrem requisitos estáveis o suficiente para conferir automaticamente. Em um projeto Typst, um perfil também espera um modelo Typst correspondente, e o achado nomeia os modelos que ele aceita.

Depois abra as instruções atuais do veículo. Limites de páginas, margens, tetos de tamanho de arquivo, regras de anonimização e convenções de nomenclatura mudam rápido demais para um perfil genérico decidir sobre elas.

## Veja o que outro leitor recebe

Escolha **Leitor de tela** no painel de Pré-verificação para abrir **O que o leitor vê**, que extrai o texto do PDF página por página. Use-o para pegar um artigo em duas colunas lido atravessando a página, um número de telefone perdido em fonte de ícones, uma legenda no lugar errado ou uma página sem texto selecionável.

Para currículos, **O que um analisador extraiu** mostra o nome, o e-mail, o telefone, os links e as seções padrão que a simulação de ATS conseguiu recuperar.

Essas visões são evidência, não um substituto para testar com o portal de submissão real, o leitor de tela ou o analisador usado pelo seu público.

## PDF/UA e acessibilidade: o limite honesto

O Oleafly confere a parte do PDF/UA-1 que ele consegue ler do arquivo. Os achados citam o PDF/UA-1, o PDF/UA-2 onde ele difere, pontos de verificação do Matterhorn Protocol e as técnicas de PDF do WCAG 2.2.

O relatório cobre sinais legíveis por máquina, como:

- uma árvore de marcação com conteúdo real;
- texto alternativo em figuras e fórmulas;
- células de cabeçalho em tabelas;
- progressão dos títulos;
- idioma do documento e título XMP;
- a preferência do leitor que exibe o título;
- descrições de links e conteúdo suspeito sem marcação;
- se uma declaração de PDF/UA-1 registrada no arquivo o sustenta.

O painel informa quantas das 106 regras do PDF/UA-1 verificáveis por máquina foram verificadas. Ele também avisa quando uma regra não pôde ser lida ou não se aplicou. Uma regra não verificada não conta como aprovada.

:::caution[A Pré-verificação não certifica PDF/UA]
Esta é uma verificação de subconjunto, não uma declaração de conformidade. O Oleafly não consegue decidir se um texto alternativo é significativo, se a ordem de leitura faz sentido para uma pessoa, se o contraste de cor é suficiente ou se o documento funciona bem com a tecnologia assistiva de um leitor. Para um resultado formal de conformidade, valide o arquivo final com o veraPDF ou o PAC 2024 e complete uma revisão humana.
:::

## Prepare um PDF marcado a partir de LaTeX

A marcação do LaTeX depende da classe de documento, dos pacotes, do motor e da versão do TeX Live. A Pré-verificação examina o documento principal efetivo e os arquivos de preâmbulo que ele carrega antes de oferecer a preparação.

1. Rode **Acessibilidade** no PDF atual e leia os achados.
2. Abra **Exportação acessível**.
3. Confira o relatório de compatibilidade de classe e pacotes. Uma classe incompatível bloqueia a preparação; um pacote parcialmente compatível ou desconhecido aparece como aviso.
4. Escolha **Preparar para exportação acessível** e revise cada mudança proposta no código-fonte.
5. Substitua cada espaço reservado de texto alternativo gerado por uma descrição significativa e acrescente o título do documento quando solicitado.
6. Compile com pdfLaTeX ou LuaLaTeX do TeX Live 2026, ou de um TeX Live atualizado desde novembro de 2025. Matemática acessível precisa de LuaLaTeX.
7. Rode Acessibilidade de novo, inspecione o modo de leitura e depois valide o PDF final fora do Oleafly quando a conformidade importa.

A preparação pode acrescentar ou atualizar `\DocumentMetadata` com idioma, intenção de PDF/UA-2 e marcação; declarar uma primeira linha de cabeçalho de tabela; adicionar espaços reservados visíveis para alternativas de figura ausentes; e acrescentar `unicode-math` quando o motor escolhido precisa dele. Ela mostra as mudanças antes de aplicá-las.

A linha `\DocumentMetadata` fica dentro de uma verificação de versão. Um LaTeX mais antigo que novembro de 2025, como o do motor embutido, a ignora e compila o documento sem marcação em vez de falhar, e o PDF não declara nenhuma conformidade com o PDF/UA. A Pré-verificação então informa **A marcação foi ignorada porque este LaTeX é antigo demais** e nomeia o LaTeX que a compilação usou.

O motor Tectonic embutido não consegue criar uma árvore de marcação. **Compilar com marcação e conferir** usa uma distribuição TeX do sistema disponível ou o TinyTeX gerenciado pelo Oleafly, e sempre roda o LuaLaTeX, mesmo em um projeto Tectonic. Se a compilação com marcação para por causa de um arquivo ausente, como o `tagpdf-base.sty` no TinyTeX, ela se oferece para instalá-lo como faz uma compilação normal e depois roda a compilação com marcação de novo. Você também pode compilar o código-fonte preparado com a sua própria cadeia de ferramentas atual.

:::note[A compatibilidade pode ser o obstáculo]
A Pré-verificação usa os dados publicados do LaTeX Project sobre o status de marcação. Classes sem suporte são bloqueadas, classes parcialmente suportadas são marcadas com um aviso, e pacotes ausentes dos dados são tratados como desconhecidos em vez de presumidos seguros. `enumitem` está bloqueado no momento porque não pode ser carregado no fluxo de trabalho com marcação.
:::

Veja [Motores e pacotes LaTeX](/docs/latex-engines/) para o TinyTeX, o status dos pacotes e a fronteira de segurança em torno do TeX do sistema.

## Padrões de PDF no Typst

Um projeto Typst não tem código a preparar. O Typst gera sozinho PDFs arquiváveis e acessíveis, então a verificação de **Acessibilidade** mostra **Padrões de PDF** no lugar da **Exportação acessível**.

1. Rode **Acessibilidade** e corrija o texto alternativo ausente e o título do documento ausente. O PDF/UA-1 precisa dos dois.
2. Em **Padrões de PDF**, escolha um **Padrão**, como PDF/UA-1 ou PDF/A-2b.
3. Escolha **Exportar PDF** e salve o arquivo.
4. Valide o PDF exportado fora do Oleafly quando a conformidade importa.

O Typst 0.14 e os posteriores marcam todo PDF, então não há uma compilação marcada separada. Versões mais antigas oferecem menos padrões, e o Typst 0.11 não oferece nenhum; o painel diz qual se aplica. Para usar uma versão mais nova, mude a **Versão do Typst (deste projeto)** no menu de compilação. Veja [Projetos Typst](/docs/typst/#what-each-version-can-do).

## Uma passada final prática

1. Compile exatamente o código-fonte que você pretende submeter.
2. Rode todas as verificações relevantes da Pré-verificação.
3. Corrija os achados verificados e investigue os avisos.
4. Complete cada item manual usando o guia atual do veículo.
5. Leia o PDF final da primeira à última página, incluindo referências e apêndices.
6. Abra o arquivo exportado e o pacote de código-fonte nos locais onde foram salvos.
7. Use o validador do próprio destino antes do prazo.

A Pré-verificação reduz surpresas evitáveis. Aceitação, acessibilidade e correção científica ainda dependem do autor, do veículo e das pessoas que vão usar o documento.
