Setup

No Arch Linux eu tive que instalar os pacotes auxiliares do latex externamente, usei:

sudo pacman -S texlive

No windows existem alternativas:

1. Softwares para latex
2. Latex no vscode (Windows)
3. How to Run Overleaf Locally

How to Run - script

Windows

Clique duplo em run.bat

Linux

$ sh run.sh

How to Run - VSCODE

Primeiramente, tenha em mente que sempre que você for buildar o projeto o arquivo principal (main.tex) deve ser o arquivo para o qual você está olhando. Na sequência, um detalhe que foi importante para mim foi o seguinte:

Sempre clicar em Clean up auxiliary files antes de buildar o projeto.

Por fim, para gerar o PDF em si basta usar a tecla de atalho Ctrl + Alt + B, lembrando que o arquivo main.tex deve estar aberto e na janela ativa (você está olhando para ele).

Referências não resolvidas (??)

pdflatex -interaction=nonstopmode main.tex
bibtex main
pdflatex -interaction=nonstopmode main.tex
pdflatex -interaction=nonstopmode main.tex

O Fluxo de Trabalho de Citação do LaTeX: Uma Introdução Técnica

É fundamental compreender o modelo de compilação do LaTeX, que opera de forma assíncrona e requer múltiplas execuções para resolver todas as dependências, como citações, referências a figuras e o sumário.

O Modelo de Compilação em Múltiplas Etapas

O processo que transforma o seu código-fonte .tex e a sua base de dados .bib num PDF final com citações corretas não é um evento único, mas uma sequência coreografada de programas que comunicam entre si através de arquivos auxiliares.

1. Primeira Execução do pdflatex: Nesta passagem inicial, o compilador lê os seus arquivos .tex, incluindo o arquivo principal main.tex. Ele identifica todos os comandos \cite{...}. No entanto, nesta fase, o LaTeX ainda não tem conhecimento sobre a que essas chaves (por exemplo, Amaral2023, Souza2019) correspondem. A sua única ação é escrever essas chaves num arquivo auxiliar, main.aux. Se o processo parasse aqui, todas as citações no PDF apareceriam como (??), pois as referências ainda não foram resolvidas.

2. A Execução do bibtex: Este é um passo crucial e distinto. O programa bibtex é executado não no seu arquivo .tex, mas no arquivo auxiliar main.aux gerado na etapa anterior. O BibTeX lê as chaves de citação do .aux, localiza as entradas correspondentes no seu arquivo de base de dados (bibliografia/referencias.bib, conforme especificado no comando \bibliography em main.tex ), formata essas entradas de acordo com o estilo de bibliografia especificado (abntex2-alf) e escreve o código LaTeX totalmente formatado num novo arquivo: main.bbl. Este programa também gera o seu próprio arquivo de log, main.blg, que é vital para depurar problemas específicos do BibTeX.

3. Segunda Execução do pdflatex: O compilador LaTeX é executado novamente. Desta vez, quando encontra o comando \bibliography, ele localiza e lê o arquivo main.bbl recém-criado. Ao fazer isso, ele compõe a lista de referências no final do documento. Mais importante, ao processar cada comando \bibitem dentro do .bbl, ele finalmente aprende qual rótulo (por exemplo, "AMARAL et al., 2023") corresponde a cada chave (Amaral2023). Esta informação de referência cruzada é então escrita de volta no arquivo main.aux. As citações no texto podem agora ser resolvidas, mas referências futuras (por exemplo, uma citação na página 2 para uma referência definida na página 10) ainda podem estar incorretas.

4. Terceira Execução do pdflatex: Esta passagem final garante a estabilidade. O LaTeX relê o arquivo .aux, que agora está totalmente preenchido com todas as informações de referência cruzada. Esta execução finaliza a composição, garantindo que todas as citações no texto sejam renderizadas corretamente com os rótulos apropriados.

Overleaf Locally

Uma alternativa ao VS Code e executar manualmente as ferramentas pdflatex e bibtex é o overleaf, ele possui uma versão web e gratuita com limite de execução disponível em overleaf.com. Também há uma alternativa: executar o overleaf localmente em sua própria máquina, eu fiz isso e usei os seguintes comandos:

docker exec -it sharelatex /bin/bash  
tlmgr install scheme-full
https://github.com/FahimFBA/overleaf-toolkit-essential/

Precisei alterar o arquivo USPSC-classe/abntex2-alf.bst, encontrei a versão mais atualizada no seguinte repositório:

https://github.com/abntex/abntex2

Inclusão da folha de aprovação

para incluir a folha de aprovação eu utilizei a cli qpdf. Primeiramente salvei ela como folhaaprovacao.pdf na pasta Pré-Textual e executei a seguinte linha de comando:

qpdf \                                                                        ✔ 
main.pdf \          
--pages \
    main.pdf 1-2 \ 
    ./Pre-textual/folhaaprovacao.pdf \ 
    main.pdf 3-z \          
-- \      
TCC_final_assinado.pdf