Saltar al contingut principal
Recepta número 98

Receptari · Capítol 5 · Estructura del llibre

Una obra col·lectiva amb bibliografia a cada capítol

Tres assajos de tres autors, cadascun un document propi a buildBundle, i cadascun tancat per una llista Chicago autor-data amb només les obres que cita.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Avançat
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.28.0 · postext-pdf ≥ 1.28.0
Llicència
Actualitzada el 11 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 155 × 235 mm
  • 1 columna
  • Libre Caslon Text 9,6/13,8
  • IBM Plex Sans Condensed
  • Libre Caslon Display
  • 10 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 563 ms
  • 187 línies de codi

En poques paraules

Un llibre d'assajos d'autors diferents. Cada assaig porta el nom del seu autor sota el títol i acaba amb la seva pròpia llista de referències, com a les obres col·lectives.

Què compondràs

La página en obra, una petita col·lecció d'assajos sobre història de la impremta, amb dos editors i tres autors. Cada autor lliura el seu assaig en un fitxer Markdown amb el seu propi bloc BibTeX, i així el conserva el llibre: un volum de 155 × 235 mm en Libre Caslon, una portada vermella i capítols que s'obren amb el número, el títol i el nom de l'autor. Cada capítol es tanca amb la seva llista de Referències en Chicago autor-data, que recull només les obres citades en aquell assaig. Dos autors citen The Printing Press as an Agent of Change, d'Eisenstein, i l'obra apareix a les dues llistes; amb la New Introduction to Bibliography de Gaskell passa el mateix als capítols 1 i 3.

Aquesta recepta respon a

  • Com dono a cada capítol d'una obra col·lectiva el seu propi autor i la seva pròpia bibliografia?
  • Com cito obres i componc la bibliografia en APA, IEEE o un altre estil de cita?

La resposta curta

script.js · línies 39–55al codi complet
// Citations are [@key] in the text; each contributor's BibTeX goes in a :::references block
// in their own chapter. Register the engine once, before the first build.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'chicago-author-date', // the humanities' author-date: (Eisenstein 1979)
  bibliography: {
    // 'chapter': a :::bibliography lists the works its own document cites, so a work two
    // contributors cite appears in both lists. 'book' (the default) would print one list,
    // after the last chapter. The scope is per document, not per H1: each essay must be a
    // document of its own in buildBundle (see the chapters region).
    scope: 'chapter',
    title: '', // no bold title paragraph: each chapter has its own ## References heading
    fontSize: em(0.9), lineHeight: pt(12.4), hangingIndent: mm(5), entrySpacing: pt(2.6),
  },
};
// Numbering and disambiguation still see the whole book: two Smiths of 2001 in different
// chapters would print 2001a and 2001b, as one bibliography would.

Ingredients

Tipografia
Libre Caslon Text, Libre Caslon Display, IBM Plex Sans Condensed (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Un document per autor

script.js · línies 337–340al codi complet
// A chapter's :::bibliography lists what that document cites; one Markdown file holding all
// three essays would make every list repeat the works of the chapters before it.
const chapters = [front, lowe, okafor, ferrer].map((markdown) => ({ markdown }));
const book = () => buildBundle({ chapters, config: config(), resources: [] });

L'abast de la resposta curta és el d'un document. buildBundle compon els quatre documents com un sol llibre, de manera que els folis, els números de capítol i l'índex segueixen la seqüència, mentre que cada :::bibliography reuneix les citacions del seu propi fitxer. Les referències es queden on les va escriure cada autor. Una clau definida en qualsevol capítol val per a tot el llibre, així que n'hi hauria hagut prou amb una sola entrada compartida, però amb capítols autònoms pots canviar l'ordre o substituir un assaig sense trencar la llista d'un altre.

#2 · La signatura és un atribut del títol

script.js · línies 59–65al codi complet
// # The Compositor's Day {author="Margaret Lowe" short="The Compositor's Day"}
const byline = text('byline', '{attr.author}', { fontFamily: TEXT, italic: true,
  fontSize: pt(12), color: col('ink'), align: 'left' }, below('title', 4));
const versoAuthor = head('verso-author', '{attr.author}', 'even',
  at('page', 'top-left', MARGIN.outer + 8, 13)); // in the running head
const tocAuthor = { enabled: true, attr: 'author', fontFamily: TEXT, fontSize: pt(9.5),
  color: col('muted') }; // a line under each title in the contents (italic by default)

El títol de cada assaig porta author="…" i un títol curt, short="…", per a la capçalera. L'obertura imprimeix l'autor sota el títol, la capçalera de la pàgina parella anomena l'autor de l'assaig al qual pertany la pàgina i l'índex posa el nom en una línia sota cada entrada. Els preliminars no han de repetir la llista d'autors.

#3 · L'obertura

script.js · línies 69–81al codi complet
// Nine lines of reserve and a line of margin under them (the level's marginBottom): ten
// lines, 48 mm, under a one-line title. A two-line title reaches past the reserve, and the
// margin then carries the text a line lower, clear of the rule.
const opener = { enabled: true, minHeight: pt(LEAD * 9), slot: { elements: [
  text('kicker', t({ en: 'Chapter {number}', es: 'Capítulo {number}' }), { ...label,
    fontSize: pt(8.5), letterSpacing: pt(1.7), color: col('accent') },
  at('container', 'top-left', 0, 4)),
  text('title', '{titleText}', { fontFamily: DISPLAY, fontSize: pt(28), lineHeight: 1.08,
    color: col('ink'), align: 'left', overflow: 'wrap' }, below('kicker', 3, { width: 'fill' })),
  byline,
  { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1.2), color: col('accent'),
    placement: { ...below('byline', 6), size: { width: mm(16) } } },
] } };

Avanttítol, títol i signatura s'apilen des del capdamunt de la caixa, cadascun ancorat sota l'anterior, així que un títol de dues línies com el del capítol 3 fa baixar amb ell la signatura i el filet. La reserva baixa el text 48 mm, deu línies, sota un títol d'una línia; un títol de dues en pren una més, de manera que el filet no toca el text i el capítol 3 comença una línia més avall que els altres dos.

#4 · Capçaleres per a un llibre de diversos autors

script.js · línies 85–99al codi complet
function head(id, content, parity, placement, look = {}) { // hoisted: the byline uses it
  return { ...text(id, content, { ...label, fontWeight: 500, fontSize: pt(7.5),
    letterSpacing: pt(1.1), color: col('muted'), ...look }, placement), parity, pages: 'body' };
}
const folio = { fontWeight: 600, color: col('ink') };
const header = { elements: [
  head('verso-folio', '{pageNumber}', 'even', at('page', 'top-left', MARGIN.outer, 13), folio),
  versoAuthor,
  head('recto-title', '{attr.short}', 'odd', at('page', 'top-right', -(MARGIN.outer + 8), 13),
    { align: 'right' }),
  head('recto-folio', '{pageNumber}', 'odd', at('page', 'top-right', -MARGIN.outer, 13),
    { ...folio, align: 'right' }),
] };
const footer = { elements: [{ ...head('drop-folio', '{pageNumber}', 'all',
  at('container', 'top', 0, 9), { ...folio, align: 'center' }), pages: 'opener' }] };

Una obra col·lectiva anomena l'autor a la pàgina parella i el capítol a la senar, on una monografia posaria el títol del llibre i el del capítol. Les capçaleres es limiten a pages: 'body', de manera que les obertures només porten un foli al peu.

#5 · Els preliminars

script.js · línies 103–133al codi complet
const bare = { numbered: false, toc: false, header: { elements: [] }, footer: { elements: [] } };
const cover = { enabled: true, slot: { elements: [
  { kind: 'box', id: 'field', style: { backgroundColor: col('accent') },
    placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(150) } } },
  text('title', '{titleText}', { fontFamily: DISPLAY, fontSize: pt(58), lineHeight: 1,
    color: col('paper'), align: 'left', overflow: 'wrap' },
  { ...at('page', 'top-left', MARGIN.inner, 64), size: { width: mm(118) } }),
  text('subtitle', '{subtitle}', { fontFamily: TEXT, italic: true, fontSize: pt(15),
    color: col('paper'), align: 'left' }, below('title', 5)),
  text('editors', '{attr.editors}', { ...label, fontSize: pt(9), letterSpacing: pt(1.8),
    color: col('accent') }, at('page', 'top-left', MARGIN.inner, 162)),
  text('contributors', '{attr.contributors}', { fontFamily: TEXT, italic: true, fontSize: pt(12),
    color: col('ink'), align: 'left' }, below('editors', 3)),
  text('imprint', '{attr.imprint}', { ...label, fontWeight: 500, fontSize: pt(7.5),
    letterSpacing: pt(1.5), color: col('muted') }, at('page', 'bottom-left', MARGIN.inner, -16)),
] } };
const contentsOpener = { enabled: true, minHeight: mm(40), slot: { elements: [
  text('kicker', '{title}', { ...label, fontSize: pt(8.5), letterSpacing: pt(1.7),
    color: col('accent') }, at('container', 'top-left', 0, 4)),
  text('title', '{titleText}', { fontFamily: DISPLAY, fontSize: pt(28), color: col('ink'),
    align: 'left' }, below('kicker', 3)),
] } };
const contents = {
  levels: [{ level: 1, fontFamily: TEXT, fontSize: pt(12.5), lineHeight: pt(LEAD),
    numberFontFamily: LABEL, numberFontSize: pt(10), numberFontWeight: 600,
    numberColor: col('accent'), numberWidth: mm(6), numberGap: mm(3), marginBottom: pt(LEAD) }],
  pageNumber: { fontFamily: LABEL, fontSize: pt(9), fontWeight: 600, color: col('ink'),
    width: mm(7) },
  leader: { char: '. ', gap: mm(2) },
  subtitle: tocAuthor,
};

La portada i l'índex són dos títols sense número al primer document, sense capçaleres i sense entrada a l'índex. Els seus dissenys llegeixen {title} i {subtitle} del frontmatter, i els editors i autors, dels atributs del mateix títol.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 098 · An edited volume with a bibliography per chapter ═════
// https://postext.dev/en/cookbook/edited-volume-chapter-bibliographies
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Libre Caslon Text & Display, IBM Plex Sans Condensed (OFL 1.1) · Needs postext ≥ 1.28.0
// Three essays by three contributors, each a Markdown document of its own with its own
// BibTeX block, laid out by buildBundle as one volume: every chapter closes on its own list.
import {
  buildBundle, prepareFonts, withLoadedFonts, 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 = 'edited-volume-chapter-bibliographies';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: printer's red on a warm paper, the rest in ink
const palette = {
  ink: '#211c19', // text: a warm near-black
  accent: '#8e2b1f', // printer's red: the cover field, kickers, the references heading
  rule: '#cdbfb2', // hairlines
  muted: '#6b5f57', // running heads, the contents' contributors, the colophon
  paper: '#fcfaf6', // the page, and the type on the red field
};
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 = 'Libre Caslon Text', DISPLAY = 'Libre Caslon Display';
const LABEL = 'IBM Plex Sans Condensed';
const MARGIN = { top: 23, bottom: 22, inner: 20, outer: 18 }; // mm, mirrored
const LEAD = 13.8; // body leading in pt: the baseline grid
const label = { fontFamily: LABEL, fontWeight: 600, textTransform: 'uppercase', align: 'left' };
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const below = (id, y, size) => ({ ...at(`#${id}`, 'below', 0, y), ...(size && { size }) });
const text = (id, content, look, placement) => ({ kind: 'text', id, content, ...look, placement });

// #region answer: one list per chapter: scope 'chapter' over a book of separate documents
// Citations are [@key] in the text; each contributor's BibTeX goes in a :::references block
// in their own chapter. Register the engine once, before the first build.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'chicago-author-date', // the humanities' author-date: (Eisenstein 1979)
  bibliography: {
    // 'chapter': a :::bibliography lists the works its own document cites, so a work two
    // contributors cite appears in both lists. 'book' (the default) would print one list,
    // after the last chapter. The scope is per document, not per H1: each essay must be a
    // document of its own in buildBundle (see the chapters region).

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

#Una sola llista per a tot el volum

Algunes editorials reuneixen totes les obres en una bibliografia final. Canvia l'abast i treu els tres títols ## Referencias; la llista passa a anar darrere de l'últim capítol.

-    scope: 'chapter',
-    title: '', // no bold title paragraph: each chapter has its own ## References heading
+    scope: 'book',
+    title: 'Bibliografía',

#Cita en APA

Un volum de ciències socials canvia l'estil i res més.

-  style: 'chicago-author-date', // the humanities' author-date: (Eisenstein 1979)
+  style: 'apa',

Errors freqüents

Error freqüent

Una clau definida dues vegades conserva la primera entrada, sense avís

Les referències valen per a tot el llibre: una clau escrita en dos capítols conserva la primera definició i la segona s'ignora sense avís. En un llibre de diversos autors, posa un prefix a les claus de cadascun. Bibliografia a partir de les referències →

Error freqüent

Valors d'atribut: sense { ni }; cometes simples si porten "

Un valor d'atribut acaba a la clau de tancament, així que no pot contenir { ni }. Un valor que porti cometes dobles va entre cometes simples; el signe de dòlar no dona problemes. Atributs de títol →

Error freqüent

Un estil de títol hereta el salt de pàgina del seu nivell

Una entrada de headingStyles pren del seu nivell de títol tot allò que no fixa, també breakBefore. Un índex o un colofó amb estil sobre un H1 després d'un :::pagebreak hereta la paritat 'odd' i cau darrere d'una pàgina en blanc. Dona a aquest estil breakBefore: { enabled: false }. Estils de títol →

  • scope: 'chapter' llista el que el document cita abans del :::bibliography, no el que cita la seva secció H1. Amb tots els assajos en un mateix fitxer Markdown, la segona llista repeteix les obres del primer assaig i la tercera, les dels dos anteriors.
  • A tot el llibre preval la primera definició de cada clau. Si dos autors fan servir smith2001 per a obres diferents, l'assaig posterior cita sense avís el llibre del primer: posa un prefix a les claus de cada autor o confronta les llistes amb els originals.
  • La desambiguació es calcula per al llibre sencer. Dues obres diferents de Smith del 2001 en capítols diferents poden sortir com a 2001a i 2001b, encara que la llista d'un capítol només en contingui una.
  • Un subtítol que obre una pàgina perd per defecte tot el seu espai superior, i l'ajust a la retícula posa llavors a sota la fracció de línia que li falta: De quién son las letras, al cap de la pàgina 10, quedaria més lluny del seu text que Lo que ve el lector, més avall a la mateixa pàgina. headings.columnHeadSpace: 'remainder' deixa aquesta fracció de línia sobre el subtítol (encapçalaments). Convé a un llibre a una columna, on cap columna veïna no delata que el subtítol comença una mica més avall.

Crèdits

Text
Text original, CC BY 4.0
Fonts
Libre Caslon Text (SIL OFL 1.1) · Libre Caslon Display (SIL OFL 1.1) · IBM Plex Sans Condensed (SIL OFL 1.1)
SandboxPDF