\documentclass[a4paper,12pt]{article}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[brazil]{babel}
\usepackage{listings}
\usepackage{hyperref}
\usepackage{geometry}
\geometry{margin=2.5cm}

\lstset{
	basicstyle=\ttfamily\small,
	columns=fullflexible,
	breaklines=true,
	frame=single,
}

\title{A classe \texttt{promec-ufrgs}\\ \large Teses e dissertações PROMEC/UFRGS conforme ABNT}
\author{Boris N. Rojo Tanzi \and Barbara Minosso}
\date{2026/07/16 -- v0.1}

\begin{document}
\maketitle

\begin{abstract}
\texttt{promec-ufrgs.cls} é uma classe \LaTeX{} que empacota a formatação exigida
pelo Programa de Pós-Graduação em Engenharia Mecânica (PROMEC) da UFRGS,
em conformidade com as normas ABNT (NBR 14724, 6023, 10520, 6024, 6027,
6028). A classe estende \texttt{abntex2} e concentra toda a maquinaria de
formato (pacotes, capa, folha de aprovação, elementos pré-textuais), para
que o autor da tese edite apenas os dados e o conteúdo, sem risco de
quebrar a conformidade ABNT.
\end{abstract}

\tableofcontents

\section{Instalação}

\begin{itemize}
	\item \textbf{Modo rápido}: coloque \texttt{promec-ufrgs.cls} no mesmo
	diretório do seu arquivo mestre (ex.: \texttt{TESE.tex}).
	\item \textbf{Modo pacote}: copie \texttt{promec-ufrgs.cls} para
	\texttt{TEXMFHOME/tex/latex/promec-ufrgs/} e rode \texttt{mktexlsr}/
	\texttt{texhash} (TeX Live) ou \texttt{initexmf --update-fndb}
	(MiKTeX).
\end{itemize}

\section{Exemplo mínimo}

O pacote inclui, em \texttt{example/}, um documento mínimo e
autocontido (\texttt{exemplo.tex} mais os arquivos de apoio em
\texttt{example/tex/}) que compila sozinho e serve de ponto de partida:

\begin{lstlisting}
\documentclass{promec-ufrgs}

% Dados da capa/folha de aprovacao
\titulo{Titulo da tese}
\autor{Nome do Autor}
\autortitle{Eng. em ...}
\area{Area de concentracao}
\data{mes ano}
\datacompleta{dia de mes ano}
\orientador{Prof. Dr. Fulano}
\numcoorientador{0}
\local{Porto Alegre}
\instituicao{...}
\preambulo{...}
\tipotrabalho{Doutor} % Mestre | Proposta | Qualifica | Doutor
\banca{Prof. Dr. ... \dotfill XXX}
\coordinador{Prof. Dr. ...}
\status{Avaliacao} % Avaliacao | Aprovado

\begin{document}
\promecfrontmatter        % capa, folha de aprovacao, listas, sumario...

\chapter{Introducao}
...

\end{document}
\end{lstlisting}

\section{Comandos providos pela classe}

\begin{description}
	\item[\texttt{\textbackslash titulo\{\}}, \texttt{\textbackslash autor\{\}}, \texttt{\textbackslash orientador\{\}}]
	Providos por \texttt{abntex2}; definem os dados básicos da capa.

	\item[\texttt{\textbackslash autortitle\{\}}]
	Título/qualificação do autor exibido na folha de aprovação.

	\item[\texttt{\textbackslash area\{\}}]
	Área de concentração do programa.

	\item[\texttt{\textbackslash datacompleta\{\}}]
	Data por extenso (folha de aprovação), complementando \texttt{\textbackslash data\{\}}.

	\item[\texttt{\textbackslash tipotrabalho\{\}}]
	Define o tipo de documento. Valores aceitos: \texttt{Mestre},
	\texttt{Proposta}, \texttt{Qualifica}, \texttt{Doutor} (exatamente
	como escrito). Controla os textos gerados por
	\texttt{\textbackslash imprimirtipotrabalho}, \texttt{\textbackslash imprimirmd} e
	\texttt{\textbackslash imprimircapatipodocumento}.

	\item[\texttt{\textbackslash banca\{\}}]
	Lista de membros da banca, separados por \verb|\\ \vfill|.

	\item[\texttt{\textbackslash numcoorientador\{\}}, \texttt{\textbackslash coorientador\{\}}]
	Quantidade e nomes dos coorientadores (\texttt{0} = nenhum).

	\item[\texttt{\textbackslash coordinador\{\}}]
	Nome do coordenador do PROMEC (assina a folha de aprovação).

	\item[\texttt{\textbackslash status\{\}}]
	\texttt{Avaliacao} ou \texttt{Aprovado}; controla o texto acima da
	banca na folha de aprovação.

	\item[\texttt{\textbackslash promecfrontmatter}]
	Executa toda a sequência de elementos pré-textuais: capa, folha de
	aprovação, folha de publicações, dedicatória, agradecimentos,
	resumo, listas de figuras/tabelas, glossários de abreviaturas e
	símbolos, sumário, e a transição para o corpo do texto
	(\texttt{\textbackslash mainmatter}). Deve ser chamado uma única vez,
	logo após \texttt{\textbackslash begin\{document\}}. Os arquivos
	\texttt{tex/Publication.tex}, \texttt{tex/Dedication.tex},
	\texttt{tex/Acknowledgment.tex} e \texttt{tex/Abstract.tex} são
	opcionais: cada um é incluído via \texttt{\textbackslash IfFileExists},
	então a seção correspondente simplesmente não é gerada se o arquivo
	não existir no projeto.
\end{description}

\section{Dependências}

\texttt{abntex2}, \texttt{abntex2cite}, \texttt{glossaries-extra},
\texttt{siunitx}, \texttt{pgfplots}, \texttt{tikz}, e demais pacotes
padrão do TeX Live 2024 carregados internamente por \texttt{promec-ufrgs.cls}
(ver o próprio arquivo de classe para a lista completa).

\section{Licença}

Este trabalho está sob a LaTeX Project Public License (LPPL), versão
1.3c ou posterior. A versão mais recente desta licença está em
\url{https://www.latex-project.org/lppl.txt}; uma cópia correspondente
a esta versão do pacote está incluída como o arquivo \texttt{LICENSE}.

\end{document}
