Modelo Quarto de dissertações e teses do IESP-UERJ

⚠️ Aviso — modelo não oficial. Este projeto reproduz o modelo oficial de dissertações e teses do IESP-UERJ, mas não é um modelo oficial do instituto: não é mantido nem endossado pelo IESP-UERJ e foi produzido por um aluno. Confira sempre as normas vigentes do seu programa antes de submeter o trabalho.

Como citar

Se este modelo for útil ao seu trabalho, cite-o (DOI: 10.5281/zenodo.20819431):

@software{lamarcaPestana2026quarto,
  author    = {Lamarca, Felipe and Pestana, Matheus Cavalcanti},
  title     = {Quarto Template for {IESP-UERJ} Dissertations and Theses},
  year      = {2026},
  publisher = {Zenodo},
  version   = {v1},
  doi       = {10.5281/zenodo.20819431},
  url       = {https://doi.org/10.5281/zenodo.20819431}
}

Modelo Quarto para dissertações de mestrado e teses de doutorado do IESP-UERJ (Instituto de Estudos Sociais e Políticos da Universidade do Estado do Rio de Janeiro), seguindo as normas ABNT. Permite escrever o trabalho em Markdown/Quarto (.qmd) e gerar um PDF idêntico ao modelo LaTeX oficial do instituto.

🇬🇧 An English version of this guide is available in README.en.md.

Conformidade ABNT

O modelo segue as versões mais recentes das normas:

• NBR 14724:2024 — apresentação de trabalhos acadêmicos (estrutura, páginas pré-textuais contadas mas não numeradas, ficha catalográfica sem AACR2).
• NBR 6023:2018 — referências (sobrenomes em CAIXA-ALTA na lista de referências).
• NBR 10520:2023 — citações. A principal mudança: o sobrenome do autor na citação entre parênteses agora vem em inicial maiúscula — (Amado, 1991) em vez de (AMADO, 1991); et al. em itálico a partir de 4 autores.

As citações são processadas pelo citeproc (motor nativo do Quarto) usando a CSL _extensions/iesp-uerj/abnt.csl (NBR 6023:2018 + 10520:2023), e não pelo abntex2cite, que continua preso à grafia de 2002.

Pré-requisitos

1. Quarto ≥ 1.4 — https://quarto.org/docs/get-started/
2. Uma distribuição LaTeX com pdflatex. A mais simples é o TinyTeX:

   quarto install tinytex

   (ou uma instalação TeX Live completa).
3. R com os pacotes knitr e rmarkdown — os exemplos geram a figura e a tabela com código R embutido (chunks). Em R: install.packages(c("knitr", "rmarkdown")). (A figura usa apenas R base; nenhum pacote extra é necessário.)

Estrutura do repositório

.
├── _quarto.yml              # projeto Quarto (faz as subpastas acharem _extensions/)
├── pt/                      # exemplo em PORTUGUÊS
│   ├── main.qmd             #   edite este arquivo
│   ├── bibliografia.bib     #   base de referências (BibTeX)
│   └── main.pdf             #   PDF renderizado
├── en/                      # exemplo em INGLÊS
│   ├── main.qmd
│   ├── bibliography.bib
│   └── main.pdf
└── _extensions/iesp-uerj/   # o "motor" — não precisa editar
    ├── _extension.yml       # define o formato iesp-uerj-pdf
    ├── template.tex         # template LaTeX (rótulos PT/EN)
    ├── repUERJ.cls          # classe LaTeX do IESP-UERJ
    ├── repUERJformat.sty    # regras de formatação ABNT
    ├── repUERJpseudocode.sty
    ├── abnt.csl             # estilo de citação ABNT 2023
    └── logo / marcadagua    # imagens da capa e folha de rosto

A figura e a tabela de exemplo são geradas no render por chunks R (não há PNG versionado): a figura por um plot() de R base e a tabela por knitr::kable(), ambos a partir de um lm() ajustado no próprio documento.

Como usar

1. Edite os metadados no cabeçalho YAML de pt/main.qmd (veja a tabela abaixo).
2. Escreva os capítulos no corpo do documento, em Markdown.
3. Renderize a partir da raiz do repositório:

   quarto render pt/main.qmd     # -> pt/main.pdf
   quarto render en/main.qmd     # -> en/main.pdf
   quarto render                 # renderiza as duas versões de uma vez

Renderize sempre a partir da raiz (onde está _quarto.yml): é ele que permite ao Quarto localizar a extensão _extensions/iesp-uerj a partir de pt//en/.

Para começar um trabalho novo, trabalhe dentro de pt/ (ou en/) — a pasta já é autocontida (main.qmd + .bib).

Campos do YAML

Campo	Descrição
university, inst-center, unit	Instituição (3 linhas do cabeçalho da capa).
author-first, author-last, author-abbrev	Nome, sobrenome e inicial(is) do autor.
title	Título do trabalho (capa e cabeçalho do Resumo).
title-en	Título no outro idioma (cabeçalho do Abstract).
degree	Mestre, Doutor, Bacharel ou Licenciado.
program	Programa de pós-graduação (ex.: Ciência Política).
city, day, month, year	Local e data.
advisor	Orientador: title, first, last, institution.
co-advisor	Coorientador (opcional, mesma estrutura).
kw-pt-1…kw-pt-4 / kw-en-1…kw-en-4	Palavras-chave (4 slots por idioma; "" para vazio).
banca	Lista de membros da banca (name, institution; máx. 6).
dedicatoria, agradecimentos, epigrafe	Elementos pré-textuais (texto livre).
resumo, abstract	Resumo (PT) e Abstract (EN).
thesis-nature	(Opcional) Texto da natureza do trabalho na folha de rosto. Se omitido, é gerado automaticamente.
ficha-pdf	(Opcional) Caminho de um PDF com a ficha catalográfica oficial. Se omitido, a página exibe um aviso (veja abaixo).
abreviaturas, simbolos, glossario, apendices, anexos	Listas opcionais (veja pt/main.qmd).
bibliography	Arquivo .bib (padrão: bibliografia.bib).

Ficha catalográfica

A ficha catalográfica oficial é elaborada e fornecida pela Biblioteca CCS/D – IESP/UERJ. Por isso, o modelo deixa essa página reservada, com um aviso (e sem dados fabricados). Quando você receber a ficha em PDF, informe o caminho no campo ficha-pdf do YAML para inseri-la automaticamente. A página não entra na contagem de folhas (fica no verso da folha de rosto), conforme a norma.

Ocultar páginas pré-textuais

Para desativar páginas específicas, descomente a flag correspondente no YAML (todas vêm ligadas por padrão):

hide-ficha: true            # ficha catalográfica
hide-banca: true            # folha de aprovação (banca examinadora)
hide-dedicatoria: true      # dedicatória
hide-agradecimentos: true   # agradecimentos

A banca, a dedicatória e os agradecimentos também somem automaticamente se você remover os campos banca, dedicatoria ou agradecimentos. As flags hide-* permitem desativá-los mantendo o conteúdo no arquivo.

Citações

Use a sintaxe de citação do Pandoc, referenciando as chaves do .bib:

• [@bib:Amado1991] → citação entre parênteses: (Amado, 1991)
• @bib:Andrade1997 → citação textual: Andrade (1997)
• [@chaveA; @chaveB] → múltiplas citações.

A lista de Referências é gerada automaticamente no fim do documento. Por isso o main.qmd termina com:

# Referências {.unnumbered}

::: {#refs}
:::

Mantenha esse bloco no final do seu documento.

Figuras e tabelas

Para imagens prontas, use a sintaxe normal do Quarto:

![Legenda da figura](caminho/imagem.png){#fig-exemplo}

Veja a @fig-exemplo.

Para conteúdo calculado, os exemplos usam chunks R (avaliados no render). Uma figura com legenda e referência cruzada:

```{r}
#| label: fig-exemplo
#| fig-cap: "Legenda. Fonte: elaboração própria."
#| echo: false
plot(cars)
```

E uma tabela com knitr::kable() (legenda via #| tbl-cap:, referência por @tbl-exemplo). Veja pt/main.qmd para o exemplo completo (figura + tabela a partir de um lm()).

Versão em inglês

Para escrever a tese em inglês, use en/main.qmd como base. A diferença essencial é a flag lang-en: true no YAML, que troca os rótulos estruturais para o inglês (Contents, References, List of Tables…) e coloca o Abstract antes do Resumo. O Resumo em português continua presente, pois é exigido pela ABNT mesmo em trabalhos redigidos em inglês.

quarto render en/main.qmd

Seguindo a máscara oficial em inglês do IESP, os elementos institucionais permanecem em português mesmo na versão inglesa: a natureza do trabalho e o rótulo "Orientador" na folha de rosto, a folha de aprovação e a ficha catalográfica. Ficam em inglês apenas o título, o abstract e os rótulos estruturais (Contents, References, List of…).

Reprodutibilidade

Tudo o que é necessário para gerar os PDFs está versionado no repositório — basta clonar e renderizar, sem passos manuais nem acesso à internet:

git clone https://github.com/felipelmc/Quarto-Model-IESP.git
cd Quarto-Model-IESP
quarto render            # gera pt/main.pdf e en/main.pdf

• A extensão (classe, .sty, CSL, logos) está em _extensions/iesp-uerj/ — nada é baixado em tempo de render.
• A figura e a tabela são geradas pelos chunks R do próprio documento (requer R com knitr e rmarkdown); não há imagens versionadas.
• Na primeira renderização, o TinyTeX instala automaticamente os pacotes LaTeX que faltarem. Para instalar o TinyTeX: quarto install tinytex.

Limitações conhecidas

• A CSL ABNT pode exigir ajuste manual em casos de borda (subtítulos saem em negrito; obras sem autor cujo título serve de entrada). Veja virgilinojuca/csl-abnt.
• Entradas .bib que usam \i (i sem ponto) com acento — ex.: cient{\'\i}fica — podem falhar no pdflatex. Prefira UTF-8 pré-composto (científica).

Créditos

• Modelo LaTeX original (classe repUERJ): Matheus Pestana.
• A classe repUERJ é derivada do trabalho do Prof. Luís Fernando de Oliveira.
• Estilo de citação ABNT 2023 (CSL): virgilinojuca/csl-abnt.
• Port para Quarto: este repositório.

Licença

Veja LICENSE.