En pocas palabras
Un libro de ensayos de autores distintos. Cada ensayo lleva el nombre de su autor bajo el título y termina con su propia lista de referencias, como en las obras colectivas.
Lo que vas a componer
La página en obra, una pequeña colección de ensayos sobre historia de la imprenta, con dos editores y tres autores. Cada autor entrega su ensayo en un archivo Markdown con su propio bloque BibTeX, y así lo conserva el libro: un volumen de 155 × 235 mm en Libre Caslon, una portada roja y capítulos que se abren con el número, el título y el nombre del autor. Cada capítulo se cierra con su lista de Referencias en Chicago autor-fecha, que recoge solo las obras citadas en ese ensayo. Dos autores citan The Printing Press as an Agent of Change, de Eisenstein, y la obra aparece en las dos listas; con la New Introduction to Bibliography de Gaskell pasa lo mismo en los capítulos 1 y 3.
Esta receta responde a
- ¿Cómo doy a cada capítulo de una obra colectiva su propio autor y su propia bibliografía?
- ¿Cómo cito obras y compongo la bibliografía en APA, IEEE u otro estilo de cita?
La respuesta corta
// 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.
Ingredientes
- Funciones
- Bibliografía a partir de las referenciasCitas en un estilo de citaLibros construidos capítulo a capítuloAtributos de títuloAperturas diseñadasÍndice generalCabeceras y foliosCabeceras según el tipo de páginaEstilos de títuloCapítulos sin númeroCubiertas, portadas y colofonesAnclaje de elementos de diseñoRecuadros flotantesMárgenes simétricosPaleta de color semánticaExportación a PDF
- También usa
- RecuadrosTítulos numeradosColor del papelFuentes incrustadas en el PDFCabeceras por sección
- Tipografía
- Libre Caslon Text, Libre Caslon Display, IBM Plex Sans Condensed (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Un documento por autor
// 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: [] });
El alcance de la respuesta corta es el de un documento. buildBundle compone los cuatro documentos como un solo libro, de modo que los folios, los números de capítulo y el índice siguen la secuencia, mientras cada :::bibliography reúne las citas de su propio archivo. Las referencias se quedan donde las escribió cada autor. Una clave definida en cualquier capítulo vale para todo el libro, así que habría bastado con una sola entrada compartida, pero con capítulos autónomos puedes cambiar el orden o sustituir un ensayo sin romper la lista de otro.
#2 · La firma es un atributo del título
// # 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ítulo de cada ensayo lleva author="…" y un título corto, short="…", para la cabecera. La apertura imprime el autor bajo el título, la cabecera de la página par muestra el autor del ensayo al que pertenece la página y el índice pone el nombre en una línea bajo cada entrada. Los preliminares no tienen que repetir la lista de autores.
#3 · La apertura
// 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) } } },
] } };
Antetítulo, título y firma se apilan desde la cabeza de la caja, cada uno anclado debajo del anterior, así que un título de dos líneas como el del capítulo 3 baja con él la firma y el filete. La reserva baja el texto 48 mm, diez líneas, bajo un título de una línea; un título de dos toma una línea más, de modo que el filete no toca el texto y el capítulo 3 empieza una línea más abajo que los otros dos.
#4 · Cabeceras para un libro de varios autores
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 colectiva pone el autor en la página par y el capítulo en la impar, donde una monografía pondría el título del libro y el del capítulo. Las cabeceras se limitan a pages: 'body', de modo que las aperturas solo llevan un folio al pie.
#5 · Los preliminares
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 y el índice son dos títulos sin número en el primer documento, sin cabeceras y sin entrada en el índice. Sus diseños leen {title} y {subtitle} del frontmatter, y los editores y autores, de los atributos del propio título.
La receta completa
// ═══ 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).
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Una sola lista para todo el volumen
Algunas editoriales reúnen todas las obras en una bibliografía final. Cambia el alcance y quita los tres encabezados ## Referencias; la lista pasa a ir detrás del último capítulo.
- scope: 'chapter',
- title: '', // no bold title paragraph: each chapter has its own ## References heading
+ scope: 'book',
+ title: 'Bibliografía',#Cita en APA
Un volumen de ciencias sociales cambia el estilo y nada más.
- style: 'chicago-author-date', // the humanities' author-date: (Eisenstein 1979)
+ style: 'apa',Errores frecuentes
Error frecuente
Una clave definida dos veces conserva su primera entrada, sin aviso
Las referencias valen para todo el libro: una clave escrita en dos capítulos conserva la primera definición y la segunda se ignora sin aviso. En un libro de varios autores, pon un prefijo a las claves de cada uno. Bibliografía a partir de las referencias →
Error frecuente
Valores de atributo: sin { ni }; comillas simples si llevan "
Un valor de atributo termina en la llave de cierre, así que no puede contener { ni }. Un valor que lleve comillas dobles va entre comillas simples; el signo de dólar no da problemas. Atributos de título →
Error frecuente
Un estilo de título hereda el salto de página de su nivel
Una entrada de headingStyles toma de su nivel de título todo lo que no fija, también breakBefore. Un índice o un colofón con estilo sobre un H1 tras un :::pagebreak hereda la paridad 'odd' y cae detrás de una página en blanco. Dale a ese estilo breakBefore: { enabled: false }. Estilos de título →
scope: 'chapter'lista lo que el documento cita antes del:::bibliography, no lo que cita su sección H1. Con todos los ensayos en un mismo archivo Markdown, la segunda lista repite las obras del primer ensayo y la tercera, las de los dos anteriores.- En todo el libro manda la primera definición de cada clave. Si dos autores usan
smith2001para obras distintas, el ensayo posterior cita sin aviso el libro del primero: pon un prefijo a las claves de cada autor o coteja las listas con los originales. - La desambiguación se calcula para el libro entero. Dos obras distintas de Smith de 2001 en capítulos diferentes pueden salir como 2001a y 2001b, aunque la lista de un capítulo solo contenga una de ellas.
- Un subtítulo que abre una página pierde por defecto todo su espacio superior, y el ajuste a la rejilla pone entonces debajo la fracción de línea que le falta: De quién son las letras, en cabeza de la página 10, quedaría más lejos de su texto que Lo que ve el lector, más abajo en la misma página.
headings.columnHeadSpace: 'remainder'deja esa fracción de línea sobre el subtítulo (encabezados). Conviene a un libro a una columna, donde ninguna columna vecina delata que el subtítulo empieza un poco más abajo.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fuentes
- Libre Caslon Text (SIL OFL 1.1) · Libre Caslon Display (SIL OFL 1.1) · IBM Plex Sans Condensed (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


