Saltar al contingut principal
Recepta número 87

Receptari · Capítol 5 · Estructura del llibre

Un capítol de tesi citat en APA 7

Un capítol de tesi doctoral amb citacions [@clau, p. 33] que surten en APA 7 gràcies a citeproc-js, amb la llista de referències presa d'un bloc BibTeX.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.57.0 · postext-pdf ≥ 1.57.0
Llicència
Actualitzada el 22 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 210 × 297 mm
  • 1 columna
  • Literata 11/16
  • Public Sans
  • 3 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 446 ms
  • 118 línies de codi

En poques paraules

Un capítol d'una tesi doctoral. L'autora escriu una clau curta per a cada font; Postext imprimeix les citacions i la llista de referències del final en estil APA.

Què compondràs

El segon capítol d'una tesi doctoral en educació, l'estat de la qüestió: el que diuen vint anys d'estudis sobre llegir en paper i en pantalla. El capítol va en A4 enquadernat a l'esquerra, en Literata amb 16 pt d'interlineat, sota una banda pàl·lida en el blau de la universitat. L'autora desa les fonts a Zotero i enganxa l'exportació en BibTeX; al text, cada font és una clau. Postext compon cada citació en APA 7, amb l'autor, l'any i la pàgina quan n'hi ha, escriu «Delgado et al. (2018)» quan el nom forma part de la frase i munta la llista de referències en l'ordre i la forma que demana l'estil. Si el director de tesi demana Chicago, l'estil és l'única línia que canvia.

Aquesta recepta respon a

  • Com cito obres i componc la bibliografia en APA, IEEE o un altre estil de cita?

La resposta curta

script.js · línies 27–39al codi complet
// 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
  },
};

Ingredients

Tipografia
Literata, Public Sans (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Un motor, un estil

El codi és la resposta curta de més amunt. Postext llegeix les citacions i en deixa la redacció a un motor de citacions que es registra una vegada abans de la primera composició; postext-citeproc embolcalla citeproc-js, el motor de Zotero i Mendeley, amb setze estils CSL i els seus fitxers de llengua. [@mangen2013] dona «(Mangen et al., 2013)», @delgado2018 sense claudàtors posa els autors dins de la frase i [@ibanez2023, pp. 12–15] porta l'interval de pàgines al parèntesi. Amb el document en castellà, les mateixes claus prenen els nexes i les abreviatures del fitxer de llengua castellana, perquè el motor segueix la llengua del document.

#2 · Les referències surten d'un bloc BibTeX

L'últim bloc del capítol és :::references{format=bibtex}, amb l'exportació de Zotero enganxada a dins i els accents escrits com {\'a}. :::bibliography, a sobre, col·loca la llista sota el títol Referencias; sense aquest bloc, Postext afegeix la llista al final. Només hi apareixen les obres citades, ordenades com ordena APA, i cada citació del text enllaça amb la seva entrada.

#3 · Un títol sense número i referències amb paraules

script.js · línies 106–107al codi complet
  headingStyles: [{ id: 'references', numbered: false }],
  crossRefs: { section: t({ en: 'Section {n}', es: 'Sección {n}' }) },

El títol de les referències porta l'estil references, que el deixa a l'índex però fora de la numeració, així que la llista no es converteix en la secció 2.4. :ref{id="sec-speed"} imprimeix «Sección 2.2» amb l'etiqueta de crossRefs i enllaça amb el títol; els números surten de startAt=2 al títol del capítol, el mateix comptador que fan servir els títols.

#4 · L'obertura va en una banda

script.js · línies 43–68al codi complet
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' } } },
  ] },
};

La banda és una caixa ancorada al tall de la pàgina, i el text comença 10 mm per sota. El número va en Literata Light de 96 pt a la dreta, on es llegeix com una forma i deixa al títol tota la seva amplada.

script.js · línies 16–21al codi complet
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' } }));

La recepta 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 = 'es'; // @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') },

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Variants

#Canvia l'estil

El mateix capítol en Chicago autor-any treu la coma després del nom i posa l'any darrere dels autors.

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

#Deixa la llista més petita que el text

Moltes universitats admeten la llista de referències un cos per sota i a espai senzill.

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

Errors freqüents

  • APA escriu els títols d'articles i llibres amb majúscula només inicial, i citeproc-js imprimeix els títols tal com vénen a les dades. Zotero desa gairebé tots els títols amb majúscula a cada paraula, així que corregeix-los a Zotero o al BibTeX abans que arribin a la pàgina.

Crèdits

Text
Text original, CC BY 4.0
Fonts
Literata (SIL OFL 1.1) · Public Sans (SIL OFL 1.1)
SandboxPDF