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
// 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
- Funcions
- Cites en un estil de citaBibliografia a partir de les referènciesReferències creuadesTítols numeratsEstils de títolCapítols sense númeroObertures dissenyadesCapçaleres i folisPaleta de color semànticaExportació a PDF
- També fa servir
- Cites que col·loquen les figuresAtributs de títolCapçaleres segons el tipus de pàginaFonts incrustades al PDF
- 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
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
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.
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
// ═══ 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
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Fonts
- Literata (SIL OFL 1.1) · Public Sans (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


