LaTeX com Overleaf e abnTeX2: passo a passo

Nomes de menu e de botão são os da interface pública observada e da documentação oficial em 09/09/2026; quando a sua tela divergir, vale a tela. Os números marcados «na demonstração deste manual» vieram de uma instalação local (TinyTeX + abnTeX2) em que os modelos foram compilados de verdade nessa data.

Comece no Overleaf: o primeiro PDF sai sem instalar nada. Instale uma distribuição local quando o projeto estourar o tempo de compilação gratuito, quando precisar trabalhar sem internet ou quando quiser Git e scripts — e leve o projeto de um lado para o outro pelo .zip (Parte 2) ou pelo Git (Parte 4).

Um capítulo por arquivo (capitulos/1-introducao.tex…) incluído com \include no main.tex; figuras numa pasta figuras/; um único .bib. Rótulos com prefixo (fig:, tab:, sec:, eq:) para não colidir. Nunca escreva o número de uma figura à mão.

A senha é digitada só na página do Overleaf ou na página de login da sua instituição (SSO). Nunca há senha neste manual, nos scripts nem em qualquer «assistente» que se ofereça a fazer login por você.

Escreva no «Code Editor»: é onde você vê o que o abntex2cite e o \ref estão fazendo. O «Visual Editor» serve para revisar texto corrido e para colegas que não conhecem LaTeX — o arquivo é o mesmo.

Ordem de preferência: o modelo oficial da sua instituição (biblioteca ou programa) → um modelo institucional publicado com licença clara → o modelo canônico do abnTeX2 (Parte 3). Um modelo de outra universidade tem a capa e a ficha de outra universidade: sirva-se do preâmbulo, não da identidade visual.

Orientador que revisa em LaTeX: convide com «Review» (comenta sem editar) ou «Edit». Orientador que revisa em Word: gere o .docx com pandoc (Parte 4) e traga as mudanças de volta à mão. No plano gratuito, rotule uma versão («label») antes de cada revisão grande: só as rotuladas sobrevivem às 24 h.

Leia o primeiro erro do log, não o último: os seguintes costumam ser consequência. Quando o projeto não couber em 10 s, baixe o .zip e compile localmente (Parte 4) — a compilação local não tem limite de tempo.

Um \include{capitulos/N-nome} por capítulo mantém o main.tex curto e permite compilar um capítulo de cada vez com \includeonly{}. Apêndice é o que você produziu; anexo é o que veio de terceiros — a classe numera cada um com a letra certa.

No Overleaf, «Recompile» já roda o latexmk com o bibtex. No computador, use compilar.sh main.tex --limpar (Parte 4): ele chama latexmk -pdf -f, filtra as linhas de erro e imprime «ok: main.pdf (N páginas)». Quando o resultado parecer velho, limpe antes de desconfiar do código.

abntex2cite (BibTeX) e biblatex-abnt (Biber) não convivem no mesmo documento: escolha um. O abntex2cite é o que os modelos canônicos e a maioria dos modelos institucionais usam; o biblatex-abnt é a via para quem já trabalha com biblatex ou precisa de recursos que o BibTeX não tem. Nos dois casos, o .bib vem do Zotero (Parte 4).

Uma coleção do Zotero por trabalho, um .bib por trabalho, chaves fixadas nos itens que você já citou. Na versão 8 do Better BibTeX, a chave passou a viver no campo nativo de chave de citação do Zotero 8 — não a edite à mão.

O script copia o modelo, troca abntex2-modelo-references por referencias e a marca por figuras/marca.pdf, e compila com latexmk se ele existir; sem latexmk, avisa: «envie a pasta ao Overleaf (New Project → Upload Project) ou instale o TinyTeX». O referencias.bib copiado é o de exemplo do abnTeX2 — substitua pelo exportado do Zotero.

Rode antes de cada entrega: o primeiro número que importa é o «citadas sem entrada», que tem de ser 0. Os 21 «nunca citados» da demonstração são o .bib de exemplo do abnTeX2 — no seu trabalho, a lista mostra o que ficou na biblioteca sem entrar no texto.

Editor é preferência; distribuição é obrigação. Qualquer um dos editores compila o mesmo main.tex com a mesma sequência da Parte 3 — e o compilar.sh funciona ao lado de todos eles.

Versione o que é fonte (.tex, .bib, figuras, scripts) e ignore o que é gerado (auxiliares; o PDF, se preferir). Wilson et al. (2017) resumem: manuscrito em texto simples, sob controle de versão, com mensagens de commit que digam o que mudou. O histórico do Overleaf gratuito dura 24 h; o do Git dura o que você quiser.

O plugin não escreve a dissertação: ele confere que o projeto compila, que as citações fecham e que a estrutura é a da norma. O texto, a escolha do modelo e a decisão sobre cada ajuste de forma continuam sendo seus.

Conteúdo, capturas e os scripts novo_trabalho.py, compilar.sh e checar_citacoes.py: CC BY 4.0 — use, copie, adapte e redistribua com atribuição. O abnTeX2 é distribuído sob a LPPL 1.3 pelo seu time; o LaTeX sob a LPPL; os modelos da galeria do Overleaf têm as licenças indicadas nas suas páginas. Nenhum vínculo ou endosso do Overleaf, da Digital Science, do time do abnTeX2, do TeX Users Group, do MiKTeX, de Yihui Xie, do Zotero, do Better BibTeX, da Microsoft, da OpenAI, da ABNT ou de qualquer outra ferramenta ou instituição citada.