Dicas para compilar seu documento

A classe da FEI permite aos seus usuários criar documentos com diversos recursos textuais que enriquecem a qualidade do trabalho final. Muitos desses recursos são apenas configurados pela classe da FEI, mas são gerados por outros programas.

• Citações e referências bibliográfica: pacote biblatex-abnt e o programa biber;
• Listas de símbolos e abreviaturas: programa makeglossaries e, opcionalmente, o bib2gls;
• Índice remissivo: programa texindy;
• O PDF em si: programas: pdflatex, xelatex ou lualatex.

Por causa disso, a compilação de uma monografia, dissertação ou tese utilizando a classe da FEI é mais complexa que a compilação de um artigo em LaTeX, processo com o qual a maioria dos usuários de LaTeX estão mais acostumados.

Essa página lista algumas opções que os usuários têm para compilar seus trabalhos manualmente ou automatizar o processo.

---

Aviso: se certifique que os programas mencionados na seção que você vai seguir estejam instalados no seu computador, e.g. você optou por utilizar o latexmk ou o make, certifique-se que eles estejam instalados no seu computador. O mesmo vale para makeglossaries, texindy etc.

---

• Manualmente, pelo terminal
• Utilizando um Makefile
• Utilizando o latexmk
• Utilizando o TeXStudio
  • Com latexmk
  • Sem o latexmk
• Outras opções

Manualmente, pelo terminal

Supondo que seu arquivo se chama documento.tex, use os seguintes comandos no seu terminal. Preste atenção nos comentários:

pdflatex -recorder -interaction=nonstopmode $documento.tex
biber $documento.bcf # se o documento possui citações/refências
texindy $documento.idx # se o documento usa índice remissivo
makeglossaries $documento # se o documento usa abreviaturas e símbolos

# se qualquer um dos 3 comandos anteriores foi executado, chamar o pdflatex mais 2 vezes
pdflatex -recorder -interaction=nonstopmode $documento.tex
pdflatex -recorder -interaction=nonstopmode $documento.tex

Utilizando um Makefile

O processo acima pode ser automatizado pelo uso de um arquivo Makefile com o seguinte conteúdo:

NAME = documento

$(NAME).pdf:
	pdflatex -recorder -interaction=nonstopmode $(NAME).tex
	biber $(NAME).bcf
	texindy $(NAME).idx
	makeglossaries $(NAME)
	pdflatex -recorder -interaction=nonstopmode $(NAME).tex
	pdflatex -recorder -interaction=nonstopmode $(NAME).tex

Ele pode então ser chamado pelo comando make.

Utilizando o latexmk

Esta é uma abordagem que eu recomendo que todos os usuários usem e se familiarizem, pois ela simplifica tanto a compilação pelo terminal como pelo TeXStudio, além de viabilizar a compilação pelo Overleaf, que utiliza o latexmk por padrão.

O latexmk é um programa que automatiza a compilação de documentos TeX. Ele checa a existência de comandos dentro dos arquivos tex utilizados na criação do documento e também pelos arquivos auxiliares gerados durante a compilação do PDF inicial e decide quais comandos devem ser executados, quantas vezes e em qual ordem.

Para utilizar o latexmk em documentos formatados pela classe da FEI:

1. Baixe o zip da classe da FEI neste link;
2. copie o arquivo .latexmkrc para o diretório do seu documento. Esse arquivo configura o latexmk para compilar o documento;
3. compile seu documento com o latexmk.

Para compilar o documento pela linha de comando: latexmk meu_documento.tex

Utilizando o TeXStudio

Existem duas opções. A primeira envolve configurar o latexmk primeiro. A segunda (menos flexível) envolve configurar o próprio TeXStudio.

Com latexmk

1. Configure o latexmk para compilar seu documento utilizando a classe da FEI e, em seguida, configure o TeXStudio para utilizar o latexmk como compilador padrão.

2. Entre em Options > Configure TeXstudio > Build e mude a opção Default Compiler para Latexmk.

3. Utilize a opção Build quando quiser compilar seu documento.

Sem o latexmk

1. Entre em Options > Configure TeXstudio > Build;

2. clique no botão Configure à direita de Default Compiler e escolha os seguintes programas na seguinte ordem:

   • Para documentos sem índice remissivo ou lista de símbolos e abreviaturas: PdfLaTeX + Biber + PdfLaTeX + PdfLaTeX
   • Para documentos com lista de símbolos ou abreviaturas: PdfLaTeX + Makeglossaries + Biber + PdfLaTeX + PdfLaTeX
   • Para documentos com índice remissivo: PdfLaTeX + Texindy + Biber + PdfLaTeX + PdfLaTeX
   • Para documentos com ambos: PdfLaTeX + Texindy + Makeglossaries + Biber + PdfLaTeX + PdfLaTeX

Em todos os casos: Default Bibliography > Biber.

Outras opções

Existem outros programas que automatizam a compilação de documentos TeX, como o arara e o rubber. Aqui, eu apenas cito a existência deles, mas não ensino como configurá-los.