13  Citações

A bibliografia é a parte do livro em que o Quarto mais trabalha por nós. O autor escreve a chave da referência no texto; o Pandoc, com o processador de citações Citeproc e um estilo CSL, formata a citação no corpo e monta a lista de referências no fim, em ABNT, sem que nada seja digitado à mão.

13.1 Os três arquivos

Arquivos da bibliografia
Arquivo Papel
references/references.bib banco de referências em BibTeX, uma entrada por obra
references/csl_styles/ABNT.csl estilo de citação (autor-data, ABNT); vancouver.csl fica disponível como alternativa
references.qmd página que recebe a lista de referências, no bloco #refs

Em _quarto.yml, bibliography e csl apontam para os dois primeiros; link-citations e link-bibliography transformam citações e referências em links. A opção reference-section-title é omitida de propósito: com ela, o Pandoc inseriria um subtítulo “Referências” vazio no fim de cada capítulo.

13.2 A entrada BibTeX

Cada obra é uma entrada com tipo, chave e campos. A chave segue o padrão da casa, autor_palavra_ano, em minúsculas ASCII: o sobrenome do primeiro autor, uma palavra do título e o ano.

@article{loftus_reconstruction_1974,
  author  = {Loftus, Elizabeth F. and Palmer, John C.},
  title   = {Reconstruction of automobile destruction},
  journal = {Journal of Verbal Learning and Verbal Behavior},
  volume  = {13},
  number  = {5},
  pages   = {585--589},
  year    = {1974},
  doi     = {10.1016/S0022-5371(74)80011-3}
}

Os campos mínimos por tipo são verificados pelo validador (Capítulo 14): artigo pede autor, título, periódico e ano; livro pede título, ano e editora, com autor ou organizador; capítulo de livro pede autor, título, título do livro, ano e editora. Sempre que existir, o DOI entra: é ele que permite conferir a entrada contra o registro do Crossref. Autores corporativos vão entre chaves duplas para não serem partidos em nome e sobrenome.

13.3 Citar no texto

A citação é a chave precedida de arroba, entre colchetes. As variantes cobrem o que a ABNT pede:

[@loftus_reconstruction_1974]                 → (LOFTUS; PALMER, 1974)
[@loftus_reconstruction_1974, p. 587]         → (LOFTUS; PALMER, 1974, p. 587)
[@loftus_reconstruction_1974; @squire_legacy_2009]   → duas obras
Loftus e Palmer [-@loftus_reconstruction_1974]       → só o ano, autores na frase
@loftus_reconstruction_1974                   → Loftus e Palmer (1974)

Uma regra editorial acompanha a sintaxe: a citação tem que sustentar a frase exata em que está. Não se reaproveita uma referência genérica sobre o tema para dar lastro a uma afirmação pontual, e citação de segunda mão se declara (“citado em”).

13.4 A lista de referências

A página references.qmd contém só o título e um bloco vazio com identificador refs; o Pandoc preenche o bloco com todas as obras citadas no livro, em ordem alfabética e no formato do CSL. Obras no .bib que não são citadas em nenhum capítulo não aparecem na lista, e o validador as acusa como órfãs.

Este manual cita, por exemplo, a documentação do Quarto (Posit Software, PBC, 2026), o manual do Pandoc (MacFarlane, 2026) e a especificação CSL (Citation Style Language, 2026); as entradas correspondentes estão na página de referências, formatadas pelo estilo ABNT.

13.5 O estilo CSL

O Citation Style Language é um formato XML que descreve como uma citação e uma referência devem ser formatadas (Citation Style Language, 2026). Há milhares de estilos prontos no repositório oficial; a casa mantém em references/csl_styles/ o de ABNT autor-data, que segue as normas de referências (Associação Brasileira de Normas Técnicas, 2018) e de citações (Associação Brasileira de Normas Técnicas, 2023), e o de Vancouver. Trocar o estilo do livro inteiro é trocar uma linha em _quarto.yml.

NotaPontos-chave
  • Três arquivos: o .bib com as obras, o .csl com o estilo e o references.qmd com a lista.
  • Chaves no padrão autor_palavra_ano; DOI sempre que existir.
  • A citação é a chave com arroba entre colchetes; variantes cobrem página, ano isolado e várias obras.
  • A lista de referências é gerada; obras não citadas não aparecem e são acusadas pelo validador.