\pdfinfoomitdate=1
\pdftrailerid{}
\pdfsuppressptexinfo=15
\documentclass[11pt,a4paper]{article}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[brazilian,english]{babel}
\usepackage{geometry}
\usepackage{hyperref}
\usepackage{enumitem}
\usepackage{fancyvrb}
\geometry{margin=2.5cm}
\hypersetup{hidelinks,pdftitle={abntexto-ufc package manual},pdfauthor={Tiago Guimarães Sombra}}
\setlist{nosep}
\newcommand{\pkg}{\texttt{abntexto-ufc}}
\newcommand{\upstream}{\texttt{abntexto}}
\newcommand{\version}{3.0.1}

\title{\pkg\\Package manual}
\author{Tiago Guimarães Sombra}
\date{Version \version\ --- 2026-09-10}

\begin{document}
\maketitle

\section{Purpose and status}

\pkg{} is an unofficial, community-maintained LaTeX class for academic works at the Federal University of Ceará (UFC), Brazil. It is built on top of the \upstream{} class and provides UFC-oriented front matter, academic-work profiles, research-project and scientific-article profiles, bibliography integration, academic objects and related formatting support.

The project is not an official or UFC-homologated template unless the University explicitly grants that status.

\section{Requirements}

The class requires LaTeX2e and \upstream{} 1.1 or newer. Version \version{} is certified primarily against TeX Live 2026. Bibliography workflows use \texttt{biblatex} and \texttt{biber}; optional class features may load additional packages when enabled.

The package does not redistribute the UFC logo, coat of arms or any other institutional mark. It also does not redistribute proprietary Microsoft Arial or Times New Roman font files. An institutional mark may be supplied locally only by users who are authorized to use it.

\section{Installation}

When installed through a TeX distribution, start a document with:

\begin{Verbatim}[frame=single]
\documentclass{abntexto-ufc}
\end{Verbatim}

The CTAN distribution has one runtime file, \texttt{abntexto-ufc.cls}. All project-owned runtime modules used in the development repository are incorporated into that class during the deterministic CTAN build. No external \texttt{abntexto-ufc/*.def} files are required or distributed.

For manual installation, place \texttt{abntexto-ufc.cls} in a location visible to TeX and install the external \upstream{} dependency separately.

The canonical upstream package page is \url{https://ctan.org/pkg/abntexto}.

\section{Minimal configuration}

Version 3 uses one canonical English project API. Setup keys and project-owned public commands are English; Portuguese remains appropriate for rendered Brazilian academic content. The historical v2 Portuguese project API is not retained through runtime aliases.

\begin{Verbatim}[frame=single]
\documentclass{abntexto-ufc}

\ufcsetup{
  type = undergraduate-capstone,
  print-mode = single-sided,
  coat-of-arms = false,
  author = {Nome Sobrenome},
  title = {Titulo do trabalho},
  location = {Fortaleza},
  year = {2026},
  advisor = {Prof. Dr. Nome do Orientador},
  institution = {Universidade Federal do Ceara},
  undergraduate-program = {Nome do Curso}
}

\begin{document}
\pretextual
\ufcPrintCover
\ufcPrintTitlePage
\ufcPrintTableOfContents

\textual
\section{Introducao}
Texto do trabalho.
\end{document}
\end{Verbatim}

The package also contains \texttt{abntexto-ufc-example.tex} and its compiled PDF as a minimal portable example.

\section{Document profiles}

The canonical \texttt{type} values provided by version \version{} are:

\begin{itemize}
  \item \texttt{undergraduate-capstone};
  \item \texttt{specialization-capstone};
  \item \texttt{masters-thesis};
  \item \texttt{doctoral-thesis};
  \item \texttt{research-project};
  \item \texttt{anonymized-research-project};
  \item \texttt{scientific-article}.
\end{itemize}

The complete editable template and the v2-to-v3 migration mapping are maintained in the project repository rather than duplicated into the CTAN package.

\section{Architecture and dependencies}

The development repository remains modular: the canonical source class loads responsibility-specific \texttt{.def} files for core behavior, fonts, layout, front matter, academic-work profiles, articles, research projects, objects, bibliography, upstream integrations, standards adaptations and back matter. This modular source layout is an engineering concern only.

For CTAN, the release builder deterministically expands those project-owned modules into a single generated \texttt{abntexto-ufc.cls}. The generated class is then compiled in isolation with only the external \upstream{} dependency available. The CTAN ZIP contains no project-owned \texttt{.def} file and no nested runtime module directory.

The CTAN package does not vendor \texttt{abntexto.cls}; \upstream{} remains a normal external TeX dependency. The separate Overleaf convenience bundle published on GitHub may include the project's pinned upstream revision so that an uploaded project is self-contained.

\section{Bibliography and current standards}

The project uses \texttt{biblatex-abnt} and a narrowly scoped compatibility layer for current ABNT NBR 6023:2025 requirements that are not yet represented by the released dependency behavior. Version \version{} follows the project's current-edition policy: applicable current ABNT editions take precedence over superseded technical references embedded in older institutional guides.

The version 3 bibliography regression explicitly covers current online availability/access elements, DOI coexistence, repeated authorship and legal-person/jurisdiction identification under NBR 6023:2025.

\section{Distribution}

The canonical package archive is \texttt{abntexto-ufc-3.0.1.zip}. It is the single archive intended for CTAN submission and contains one top-level \texttt{abntexto-ufc/} directory. Its only runtime implementation file is the generated monolithic \texttt{abntexto-ufc.cls}; the remaining files are README, CHANGELOG, license, this manual and the minimal example in source/PDF form.

Repository engineering infrastructure, source \texttt{.def} modules, tests, CI workflows, evidence files, roadmaps, proprietary fonts and institutional mark assets are deliberately excluded from the CTAN archive.

Separate editable-template and Overleaf archives may be attached to the GitHub Release for user convenience; they preserve the repository-oriented modular layout and are not CTAN upload files.

\section{License and support}

\pkg{} is distributed under the LaTeX Project Public License, version 1.3c or later. The complete license text is included in \texttt{LICENSE}.

Repository and issue tracker:

\begin{center}
\url{https://github.com/tiagosombrra/abntexto-ufc}
\end{center}

\end{document}