Pular para o conteúdo principal
Receita número 87

Receitas · Capítulo 5 · Estrutura do livro

Um capítulo de tese citado em APA 7

Um capítulo de tese de doutorado cujas citações [@key, p. 33] saem em APA 7 pelo citeproc-js, com a lista de referências montada a partir de um bloco BibTeX.

Nesta página
Saída
Canvas · PDF
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.57.0 · postext-pdf ≥ 1.57.0
Licença
Atualizada em 22 de out. de 2026
Código MIT · Texto CC BY 4.0
  • Amostra em inglês: ainda sem edição em português
  • Refile 210 × 297 mm
  • 1 coluna
  • Literata 11/16
  • Public Sans
  • 3 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 282 ms
  • 118 linhas de código

Em poucas palavras

Um capítulo de uma tese de doutorado. A autora escreve um código curto para cada fonte; o Postext imprime as citações e a lista de referências do final no estilo APA.

O que você vai compor

O segundo capítulo de uma tese de doutorado em educação, a revisão de literatura: o que vinte anos de estudos dizem sobre ler no papel e na tela. O capítulo é composto numa página A4 encadernada à esquerda, em Literata com entrelinha de 16 pt, sob uma faixa clara no azul da universidade. A autora guarda as fontes no Zotero e cola a exportação em BibTeX; no texto, cada fonte é uma chave. O Postext formata cada citação em APA 7, com o autor, o ano e a página quando há, escreve “Delgado et al. (2018)” quando o nome faz parte da frase e monta a lista de referências na ordem e na forma que o estilo pede. Quando o orientador pedir Chicago, o estilo é a única linha que muda.

Esta receita responde a

  • Como cito obras e monto a bibliografia em APA, IEEE ou outro estilo de citação?

A resposta curta

script.js · linhas 27–39no código completo
// Citations are written [@key, p. 33] and formatted by citeproc-js in the chosen CSL
// style; the references come from the BibTeX block at the end of the chapter. Register
// the engine once, before the first build, then the style is one setting.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'apa', // 'chicago-author-date', 'ieee', 'vancouver'… change nothing else
  link: true, // each citation jumps to its entry in the PDF and on screen
  bibliography: {
    // APA asks for a half-inch hanging indent and keeps the list in the text size.
    fontSize: em(1), hangingIndent: mm(12.7), entrySpacing: pt(4),
    doi: 'link', // printed whole, as APA wants, and clickable
  },
};

Ingredientes

Tipografia
Literata, Public Sans (SIL OFL 1.1)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

#1 · Um motor, um estilo

O código é a resposta curta logo acima. O Postext lê as citações e deixa a redação delas a um motor de citações, registrado uma vez antes da primeira composição; postext-citeproc empacota o citeproc-js, o motor que o Zotero e o Mendeley usam, com dezesseis estilos CSL e os arquivos de idioma. [@mangen2013] dá “(Mangen et al., 2013)”, @delgado2018 sem colchetes põe os autores dentro da frase e [@ibanez2023, pp. 12–15] leva o intervalo de páginas para dentro dos parênteses. Com o documento em espanhol, as mesmas chaves tiram os conectivos e as abreviaturas do arquivo de idioma espanhol, porque o motor segue o idioma do documento.

#2 · As referências vêm de um bloco BibTeX

O último bloco do capítulo é :::references{format=bibtex}, com a exportação do Zotero colada dentro e os acentos escritos como {\'a}. :::bibliography, acima dele, coloca a lista sob o título References; sem ele, o Postext acrescenta a lista no fim. Só aparecem as obras citadas, ordenadas como a APA ordena, e cada citação no texto leva à entrada.

#3 · Um título sem número, referências por extenso

script.js · linhas 106–107no código completo
  headingStyles: [{ id: 'references', numbered: false }],
  crossRefs: { section: t({ en: 'Section {n}', es: 'Sección {n}' }) },

O título das referências usa o estilo references, que o mantém no sumário mas fora da numeração, por isso a lista não vira a seção 2.4. :ref{id="sec-speed"} imprime “Section 2.2” com o rótulo de crossRefs e leva ao título; os números vêm de startAt=2 no título do capítulo, o mesmo contador que os títulos usam.

#4 · A abertura fica numa faixa

script.js · linhas 43–68no código completo
const BAND = 92; // mm from the trim's top
const opener = {
  enabled: true,
  minHeight: mm(BAND - 28 + 10), // the body starts 10 mm under the band
  slot: { elements: [
    { kind: 'box', id: 'band', style: { backgroundColor: col('tint') },
      placement: { anchor: { to: 'page', edge: 'top-left' },
        size: { width: 'fill', height: mm(BAND) } } },
    { kind: 'text', id: 'label', content: t({ en: 'Chapter', es: 'Capítulo' }),
      fontFamily: LABEL, fontSize: pt(9), fontWeight: 600, letterSpacing: pt(1.8),
      textTransform: 'uppercase',
      color: col('accent'), align: 'left',
      placement: { anchor: { to: 'container', edge: 'top-left' },
        offset: { x: mm(0), y: mm(2) } } },
    { kind: 'text', id: 'number', content: '{number}', fontFamily: TEXT, fontSize: pt(96),
      fontWeight: 300, lineHeight: 0.9, color: col('accent'), align: 'right',
      placement: { anchor: { to: 'container', edge: 'top-right' },
        offset: { x: mm(0), y: mm(-6) },
        size: { width: mm(40), height: 'auto' } } },
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: TEXT, fontSize: pt(24),
      lineHeight: 1.12, fontWeight: 600, color: col('ink'), align: 'left', overflow: 'wrap',
      placement: { anchor: { to: 'container', edge: 'top-left' },
        offset: { x: mm(0), y: mm(14) },
        size: { width: mm(108), height: 'auto' } } },
  ] },
};

A faixa é uma caixa ancorada ao refile, e o texto começa 10 mm abaixo dela. O número é composto em Literata Light de 96 pt, à direita, onde é lido como uma forma e deixa ao título a medida inteira.

script.js · linhas 16–21no código completo
const palette = {
  ink: '#1b1b1f', accent: '#22406a', tint: '#e6ecf4', rule: '#b9bec8', muted: '#5d6370',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 087 · A thesis chapter cited in APA 7 ═══════════════════
// https://postext.dev/en/cookbook/apa-thesis-with-bibtex
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Literata, Public Sans (SIL OFL 1.1) · Needs postext ≥ 1.57.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerCitationEngine,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
import { createCiteprocEngine, STYLES, LOCALES } from 'https://esm.sh/postext-citeproc';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'apa-thesis-with-bibtex';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a thesis prints in black; the one colour is the university's
const palette = {
  ink: '#1b1b1f', accent: '#22406a', tint: '#e6ecf4', rule: '#b9bec8', muted: '#5d6370',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const TEXT = 'Literata', LABEL = 'Public Sans';
const LEAD = 16; // pt: double spacing is a typewriter habit; 1.45 reads as well and fits more

// #region answer: the citation engine, APA 7 and how its references look
// Citations are written [@key, p. 33] and formatted by citeproc-js in the chosen CSL
// style; the references come from the BibTeX block at the end of the chapter. Register
// the engine once, before the first build, then the style is one setting.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'apa', // 'chicago-author-date', 'ieee', 'vancouver'… change nothing else
  link: true, // each citation jumps to its entry in the PDF and on screen
  bibliography: {
    // APA asks for a half-inch hanging indent and keeps the list in the text size.
    fontSize: em(1), hangingIndent: mm(12.7), entrySpacing: pt(4),
    doi: 'link', // printed whole, as APA wants, and clickable
  },
};
// #endregion

// #region opener: a pale band at the head of the page, the number large and light in it
const BAND = 92; // mm from the trim's top
const opener = {
  enabled: true,
  minHeight: mm(BAND - 28 + 10), // the body starts 10 mm under the band
  slot: { elements: [
    { kind: 'box', id: 'band', style: { backgroundColor: col('tint') },

O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)

Variações

#Mude o estilo

O mesmo capítulo em Chicago autor-data tira a vírgula depois do nome e põe o ano depois dos autores na lista.

-  style: 'apa', // 'chicago-author-date', 'ieee', 'vancouver'… change nothing else
+  style: 'chicago-author-date',

#Deixe a lista menor que o texto

Muitas universidades aceitam a lista de referências um corpo abaixo e em espaço simples.

-    fontSize: em(1), hangingIndent: mm(12.7), entrySpacing: pt(4),
+    fontSize: em(0.9), lineHeight: pt(13), hangingIndent: mm(12.7), entrySpacing: pt(3),

Erros comuns

  • A APA escreve os títulos de artigos e livros só com a inicial maiúscula, e o citeproc-js imprime os títulos como os dados os trazem. O Zotero guarda a maioria dos títulos com maiúscula em cada palavra, por isso corrija-os no Zotero ou no BibTeX antes que cheguem à página.

Créditos

Texto
Texto original, CC BY 4.0
Fontes
Literata (SIL OFL 1.1) · Public Sans (SIL OFL 1.1)
SandboxPDF