% Padrão para abntexto 2025-07-17 ou posterior
% Classe base: article
% pacote adicional: geometry, graphicx
% font size: 12pt
% twoside=true
%
% neste modelo, usa o layout de um lado
\documentclass[a4paper]{abntexto}
\usechapters% ativar o uso de capítulos (ajuste ao sumário)

% O padrão é dois lados. Para um lado, ou modo eletronico (um lado com margem menor), requer pequeno ajuste

% Em um lado somente
\let\twosidelayout=\onesidelayout

% No formato eletronico (suas margens parece não ser de ABNT)
%\let\onesidelayout=\eletroniclayout% pretextual
%\let\twosidelayout=\eletroniclayout% textual

\usepackage{iftex} % Para detectar o motor de TeX utilizado
% Fontes, de acordo com o motor do TeX
\ifPDFTeX % PDFLaTeX
  \usepackage[T1]{fontenc} % codificação da fonte em 8-bits
  \usepackage{mlmodern} % fontes MLModern que é mais escura que Computer Modern tradicional (espessura de letra de Book)
  %\usepackage{lmodern} % fontes Latin Modern: espessura tradicional do Computer Modern
  %\usepackage[utf8]{inputenc} % acentuação direta em UTF-8. Não é mais necessário
\else % XeLaTeX/LuaLaTeX
  \usepackage{fontsetup} % New Cmputer Modern com espessura da letra de Book
  % Padrão do XeLaTeX/LuaLaTeX
\fi

% idiomas
\usepackage[english,main=brazil]{babel}%padrão é brazil.

% pacotes matemáticas de acordo com o motor TeX
\ifPDFTeX
  \usepackage{amsmath,amssymb} % para matematica
\else
  % para matematica
  \usepackage{unicode-math}
  \ifLuaTeX
    \usepackage{lualatex-math}
  \fi
\fi
%Outros pacotes
\usepackage{hyperref} % para link automático no PDF
% Desabilitando ou redefinindo comandos que causa erros no bookmark do PDF
\pdfstringdefDisableCommands{%
\let\MakeUppercase\relax% desabilitando
\def\\{ }%
\def\and{ e }
}
\usepackage{pdfpages} % para incluir documento PDF (ex.: folha de aprovação)
\usepackage{indentfirst} % se quer que o primeiro parágrafo seja indentada
%% Se for criar o índice remissivo (opcional)
%\usepackage{makeidx}
%\makeindex
\usepackage{microtype} % micro tipografia para ajuste refinado de espaçamento

\usepackage{xtab} % para tabela longa configurável xtabular
% Para linhas horizontais com espaçamento melhorado: \toprule, \midrule, \bottomrule, \cmidrule
\usepackage{booktabs}

% BibLaTeX
\usepackage{csquotes} % biblatex recomenda quando usar o pacote de idiomas babel/poligrossia
\usepackage[backend=biber, language=auto, style=abnt]{biblatex}
\addbibresource{modelo-biblatex.bib} % arquivo bib

%\addto{\captionsbrazil}{
%    \renewcommand{\refname}{Referências}
%}

% Mesmo com \usechapters do ABNTexto, tamanho das fontes do título da referências bibliográficas e similares ficam como seção. Para ser de capítulo, precisa de ajustes usando comando de abntexto.
\defbibheading{bibliography}[\refname]{\chapter*{#1}}
\makeatletter
% Índice remissivo
\AddToHook{env/theindex/begin}{\begin{corrprint}}
\AddToHook{env/theindex/end}{\end{corrprint}}
% referências bibliográficas
\AddToHook{env/thebibliography/begin}{\begin{corrprint}}
\AddToHook{env/thebibliography/end}{\end{corrprint}}
% Glossário com pacote glossaries
\AtBeginDocument{\@ifpackageloaded{glossaries}{
  \AddToHook{cmd/printglossary/before}{\begin{corrprint}}
  \AddToHook{cmd/printglossary/after}{\end{corrprint}}   
}} %\@ifpackageloaded %\AtBeginDocument
% Glossário com pacote acro
\AtBeginDocument{\@ifpackageloaded{acro}{
  \AddToHook{cmd/printacronyms/before}{\begin{corrprint}}
  \AddToHook{cmd/printacronyms/after}{\end{corrprint}}   
}} %\@ifpackageloaded %\AtBeginDocument
\makeatother
 
% versão * do capítulo/seção não tem no ABNTexto.
% No ABNTexto, será \clearpage\nonum\notoc\chapter{\centering } ou \nonum\notoc\section{\centering }
% Providenciando versão * pela praticidade em usar no conteúdo pretextual (ABNT: deve ser centralizada)

\makeatletter
  \let\chapter@nostar\chapter% copiando o original
  \def\chapter{\@ifstar\chapter@star\chapter@nostar}
  \def\chapter@star#1{% com *
    \cleardoublepage
    \nonum\notoc\chapter@nostar{\centering #1}
  }
% Para artigos
%\let\section@nostar\section% copiando o original
%\def\section{\@ifstar\section@star\section@nostar}
%\def\section@star#1{% com *
%  \nonum\notoc\section@nostar{\centering #1}
%}
\makeatother
% informação do documento (requer o pacote hyperref)
\hypersetup{pdftitle={Exemplo de ABNTexto},
  pdfauthor={Sadao Massago},
  pdfsubject={Exemplo do documento em ABNT com a classe ABNTexto},
  pdfkeywords={ABNT, LaTeX, ABNTexto}
}

\sloppy % preferência a underfull (muito espaço entre palavras)
% enumeração subordinado a capítulo
\numberwithin{equation}{chapter}
% permite quebrar equacoes entre linhas
\allowdisplaybreaks

% INICIO DO DOCUMENTO
\begin{document}

\begin{titlepage}
UNIVERSIDADE FEDERAL DE SÃO CARLOS \\
CENTRO DE CIÊNCIAS E TECNOLOGIAS PARA SUSTENTABILIDADE
\begin{center}
\vfill
\Large SADAO MASSAGO
\vfill
{\Huge\bfseries EXEMPLO DE ABNTEXTO}
\vfill
SOROCABA \\
AGOSTO DE 2025
\end{center}
\end{titlepage}
\pretextual % pretextual é iniciado automaticamente?
% Folha de rosto é obrigatório no ABNT
\begin{center}
\vfill
Sadao Massago
\vfill
{\Large\bfseries Exemplo de ABNTexto}
\vfill
\begin{flushright}\begin{minipage}{0.5\textwidth}
\noindent% sem indentação
\singlesp % espaçamento simpoles, usando o comando de ABNTexto
Texto do tipo ‘‘Monografia apresentada ...’’ que depende da instituição
\end{minipage}\end{flushright}
\vfill
Universidade Federal de São Carlos \\
Centro de Ciências e Tecnologias para Sustentabilidade
\vfill
Orientador(a): Nome do(a) orientador(a)
\vfill
Sorocaba\\
Agosto de 2025
\end{center}

%% Ficha catalográfica, caso existir, deve ficar no verso da folha de rosto
%\newpage % Quando tiver versão definitiva, inserir aqui
%\includepdf{fichacatalograficafinal.pdf}
%
%Caso exista errata. Opcional no ABNT.
%\chapter*{Errata}
%
\newpage
Folha de aprovação é obrigatório no ABNT
%% Quando tiver a folha de aprovação devidamente assinada, incluir aqui
%% \includepdf{folhadeaprovacaofinal.pdf}
%
%\chapter*{}
%%Dedicatória é um elemento opcional para ABNT
%
\chapter*{}
Agradecimentos é opcional no ABNT, mas boa educação é agradecer aos que contribuíram para realização do trabalho.
%
%\chapter*{}
%epigrafe (uma mensagem) que é opcional no ABNT. Deverá colocar o autor da mensagem, alinhada a direita.
%
\chapter*{Resumo}
\noindent Resumo em português, obrigatório no ABNT.

\noindent
\textbf{Palavras-chave}: ABNT, LaTeX, ABNTexto.
%
\chapter*{Abstract} %Resumo em língua estrangeira (obrigatório no ABNT).
\begin{otherlanguage}{english}
\noindent Abstract in foreign language is required in ABNT.

\noindent
\textbf{Keywords}: ABNT, LaTeX, ABNTexto.
\end{otherlanguage}
%
%\clearpage\phantomsection\pdfbookmark[chapter]{\listfigurename}{lof}
%\chapter*{Lista de Figuras}% opcional no ABNT
%\makeext{lof}
%
%\clearpage\phantomsection\pdfbookmark[chapter]{\listfigurename}{lot}
%\chapter*{Lista de Tabelas} % opcional no ABNT
%\makeext{lot}
%
% \clearpage
%\chapter*{Siglas} % Lista de siglas é opcional no ABNT.
%\begin{description}
%\item[ABNT] Associação Brasileira de Normas Técnicas.
%\end{description}
%\end{siglas}
%
% \clearpage
%\chapter*{Simbolos}% Lista de Símbolos é opcional no ABNT
%\begin{description}
%\item[$\pi$] Razão entre circunferência e raio.
%\item[ABNT] Associação Brasileira de Normas Técnicas.
%\end{description}
%
\clearpage
% \section*{Sumário} % artigo
\chapter*{Sumário}
\maketoc % produz sumário. Não use \tableofcontents

% CONTEÚDO PRINCIPAL
\clearpage
\textual \let\textual=\relax% iniciando o textual e desativando o comando
%
% Como já é conteúdo textual, capítulos serão enumerados.
\chapter{Prefácio} % prefácio (ou apresentação) é opcional no ABNT
Prefácio aqui. Se preferir, pode incorporar na introdução.

\clearpage
\chapter{Introdução}
Introdução aqui.

\clearpage
\chapter{Alíneas}
Alineas é criado pelo ambiente \texttt{topics}.
\begin{topics}
\item \label{alinea:1} ítem 1
\begin{topics}
\item subítem a
\item subítem b
\end{topics}
\item \label{alinea:2} ítem 2
\end{topics}
\clearpage
\chapter{Legenda}
O comando \verb+\legend+ especifica se vai ser figura ou tabela e cria a legenda (título).
Deve respeitar a ordem dos comandos \verb+\legend+, \verb+\src+ e \verb+\begin{place}+. A opção de posicionamento é mesmo de figuras/tabelas flutuantes \texttt{figure}/\texttt{table},adicionado de uma opção 'here' que fixa no lugar como a opção 'H' do pacote \texttt{float}.
\legend{figure}{Uma figura}
\src{CTAN: \url{https://ctan.org/}}
\label{fig:teste}
\begin{place}[hbp!] % opção de posicionamento é mesmo de figure/table
\includegraphics[width=0.4\linewidth]{example-image}
\end{place}
Ver \ref{fig:teste}.

Poderá usar subfiguras nativamente como na Figura~\ref{fig:teste2} (Figura~\ref{fig:teste2:a} e \ref{fig:teste2:b}).
\legend{figure}{Duas figuras}\label{fig:teste2}
% \src{CTAN: \url{https://ctan.org/}}
\begin{multiplace}% [here] % 'here' (padrão) fixa no lugar como 'H' do pacotee float
  \sublegend{figure}{Normal}
  \subsrc{CTAN: \url{https://ctan.org/}}
  \label{fig:teste2:a}
  \begin{subplace}
    \includegraphics[width=0.4\linewidth]{example-image-a}
   \end{subplace}
  % figura 2
  \sublegend{figure}{Rotacionada}
  \subsrc{CTAN: \url{https://ctan.org/}}
  \label{fig:teste2:b}
  \begin{subplace}
    \includegraphics[width=0.4\linewidth,angle=45]{example-image-a}
  \end{subplace}  
\end{multiplace}

A tabela pequena pode ser inseridas de forma análoga a da figura, mas deve usar o comando \verb+\legend+ devidamente com opção 'table'.
\begin{center}
\legend{table}{Um título}\label{tab:primeira}
\src{Elaboração do autor.}
\begin{place}[here]% 'here' (padrão) fixa no lugar como 'H' do pacote float
\begin{tabular}{ll} 
\toprule %\hline
   produto & preço \\
\midrule %\hline
   cenouras  (500g)          & R\$0,50  \\
   cogumelos (vidro de 500g) & R\$5,00  \\
   batata    (1Kg)           & R\$1,20  \\ \midrule % \hline
   total & R\$6,70 \\
   \bottomrule %\hline
\end{tabular}
\end{place}
\end{center}

Não há suporte para tabelas longas (2025). Também não há suporte para quadros ainda (2025).

Quem precisar de tabelas e quadros longos (e curtos), use o pacote como o \texttt{tabularray-abnt} do \url{https://ctan.org/pkg/tabularray-abnt}.

\clearpage
\chapter{Citações}
Para citações curtas, use \verb+\enquote{texto}\cite{key}+.

Para citações longas (mais de 3 linhas), use
\verb+\Enquote{texto\cite{key}}+ (com ``E'' maiúsculo).
Por exemplo, 
\Enquote{
As citações diretas, no texto, com mais de três linhas, devem ser destacadas com recuo de 4 cm da margem esquerda, com letra menor que a do texto utilizado e sem as aspas.
No caso de documentos datilografados, deve-se observar apenas o recuo
\apud[5.3]{NBR10520:2002}{book:abntex2:araujo}
% \cite[5.3]{NBR10520:2002}.
} %Enquote

\verb+\paud{}+ é para citação das citações.
% Em \apud{NBR10520:2002}{book:abntex2:araujo}
% NBR10520:2002 é onde está escrito, enquanto que book:abntex2:araujo é quem citou.

\enquote{Citações simples, com até três linhas, devem ser
incluídas com aspas. Observe que em \LaTeX, as aspas iniciais são diferentes das finais} \cite{book:abntex2:araujo}.

Citações indiretas (reescritas) é formatado normalmente como um texto, mas também precisam estar com fontes citadas.
Para citaçao de referências bibliográficas que faz parte do texto, use \verb+\textcite{}+ como em ``Segundo \textcite{book:abntex2:araujo}, ...''.
Análogo para \verb+\apud{}+ que deve usar \verb+\textapud{}+ quando faz parte do texto.

\clearpage
\chapter{Considerações Finais}
Conclusão do trabalho.
% PÓS TEXTUAL
%% Referencias bibliográficas é obrigatório no ABNT
\clearpage\phantomsection\addcontentsline{toc}{chapter}{\protect\toclabelbox{}\refname}%                    
\printbibliography%sem opção, para devido funcionamento em ABNTexto
%% glossário é opcional no ABNT
%\clearpage\phantomsection\addcontentsline{toc}{chapter}{\protect\toclabelbox{}\glossaryname}%                    
% inserir glossário pelo comando de acordo com o pacote usado: pacotes mais usados são acro e glossaries

%%Apêndices são opcionais no ABNT
%\clearpage
%\appendix{Primeiro Apêndice}
%Conteúdo do primeiro apêndice.
%\clearpage
%\appendix{Segundo Apêndice}
%Conteúdo do segundo apêndice.
%% Anexos são opcionais no ABNT
%\clearpage
%\annex{Primeiro Anexo}
%Conteúdo do primeiro anexo
%\annex{Segundo Anexo}
%Conteúdo do segundo anexo
%% Índice remissivo (opcional no ABNT)
% \clearpage\phantomsection\addcontentsline{toc}{chapter}{\protect\toclabelbox{}\indexname}%                    
% \printindex
\end{document}
