En pocas palabras
Las páginas de inicio de capítulo de un libro de geología. Una franja de color con un número grande llega hasta el borde superior, y el diseño se define una sola vez para todos los capítulos.
Lo que vas a componer
Las aperturas de capítulo de La Tierra en movimiento, un manual de introducción a la geología en página de 210 × 280 mm. El capítulo 3 se abre bajo una banda terracota a sangre por arriba. En ella van un antetítulo espaciado, el título partido donde quiso el autor, una entradilla en cursiva y un número de 168 puntos apoyado en el filete oscuro de la banda, junto al borde exterior. Debajo arrancan dos columnas justificadas, y el corte de una placa que se hunde ocupa el pie de la página. El capítulo 4 repite el diseño en verde azulado, incluidos el uñero, los números de sección, las remisiones y la etiqueta de su figura. El diseño se define una vez, en el encabezado de nivel 1. Cada capítulo pone como atributos en su línea del encabezado el tema del antetítulo, la entradilla y, si cambia de color, un estilo.
Esta receta responde a
- ¿Cómo hago una apertura de capítulo con una banda de color a sangre, un número de capítulo grande y el título?
- ¿Cómo pongo el título de capítulo a todo el ancho mientras el texto sigue a dos columnas debajo?
- ¿Cómo añado a una apertura una línea de autor, una entradilla o un primer párrafo con capitular?
- ¿Cómo doy a cada capítulo su propia foto, su color o una variante de apertura?
- ¿Cómo numero los títulos (1, 1.1, 1.1.1) y doy a cada nivel un estilo distinto?
La respuesta corta
const TOP = 24; // top margin, mm: the opener's container starts here
const OUTER = 16; // outer margin, mm: the numeral and the folios line up on it
const BLEED = 0; // mm: 0 on screen; about 3 for print, which also switches on page.cutLines
const BAND = 100; // mm from the trim to the foot of the band
const NUMERAL = 168; // pt; the baseline of a design text sits 0.8 down its line box
const PT = 25.4 / 72; // mm in a point
const AIR = 12; // mm, foot to text: ≥ 0.2 × NUMERAL × PT ≈ 11.9, the numeral box below its baseline
const BEARING = 2; // mm past the text edge: a rough optical nudge, as each digit's bearing differs
const bleedTop = { to: 'bleed', edge: 'top-left' }; // the trim's corner, pushed out by BLEED
// Design text centres by default; in a heading design it wraps by default too.
const onBand = { color: col('paper'), align: 'left' };
const below = (id, y, width) => ({ anchor: { to: `#${id}`, edge: 'below' }, offset: { y: mm(y) },
size: { width: mm(width) } }); // chained: a longer title pushes the standfirst down
const opener = { enabled: true,
// The text starts below the lowest element or minHeight (gotcha: opener-reserves-anchored).
minHeight: mm(BAND - TOP + AIR), // clears the numeral, so the text starts AIR below the foot
slot: {
elements: [ // array order is paint order: the band first, the type on top
{ kind: 'box', id: 'band', style: { backgroundColor: col('band') }, placement: {
anchor: bleedTop, size: { height: mm(BLEED + BAND) } } }, // no width: runs to the far edge
{ kind: 'rule', id: 'foot', color: col('ink'), thickness: mm(1.6), placement: {
anchor: bleedTop, offset: { y: mm(BLEED + BAND) } } },
{ kind: 'text', id: 'numeral', content: '{chapterNumber}', ...onBand,
fontFamily: 'Archivo', fontWeight: 800, fontSize: pt(NUMERAL),
lineHeight: 1, // a box as tall as the type: the y below counts on it
placement: { anchor: { to: 'page', edge: 'top-right' }, // the fore-edge of a recto
offset: { x: mm(BEARING - OUTER), y: mm(BAND - 0.8 * NUMERAL * PT) } } }, // on the foot
{ kind: 'text', id: 'kicker', ...onBand, fontFamily: 'Archivo Narrow', fontWeight: 600,
content: `${t({ en: 'Chapter', es: 'Capítulo' })} {chapterNumber} · {attr.topic}`,
fontSize: pt(8.5), letterSpacing: pt(2), textTransform: 'uppercase',
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(7) } } },
{ kind: 'text', id: 'title', content: '{titleText}', ...onBand, // breaks at the \\
fontFamily: 'Archivo', fontWeight: 800, fontSize: pt(34), lineHeight: 1.02,
placement: below('kicker', 3, 118) },
{ kind: 'text', id: 'lead', content: '{attr.lead}', ...onBand, fontFamily: 'Roboto Serif',
italic: true, fontSize: pt(10.5), lineHeight: 1.36, placement: below('title', 6, 100) },
],
},
}; // hook-up: headings.levels[0] = { span: 'page', breakBefore, advancedDesign: opener }
Ingredientes
- Funciones
- Aperturas diseñadasBanda de capítulo a todo el anchoAtributos de títuloSaltos de línea en los títulosEstilos de títuloColores por parteTítulos numeradosCapítulos que abren en página imparAnclaje de elementos de diseñoTextos, filetes y cajas en los diseños de páginaBandas a sangre y pestañasPaleta de color semánticaCabeceras y foliosCabeceras según el tipo de páginaCitas que colocan las figurasColocación de figurasFiguras y tablas como recursosLibros construidos capítulo a capítuloPáginas en un canvas
- También usa
- Sangrado y marcas de corteEstilos de párrafo
- Tipografía
- Roboto Serif, Archivo, Archivo Narrow (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Cuelga la banda y el número de la página
El código es la respuesta corta de arriba. La banda y su filete cuelgan de la esquina superior izquierda del sangrado. Como toda caja o filete sin anchura propia, se estiran hasta el otro borde de ese marco, así que llegan al corte, y al sangrado en cuanto BLEED pasa de 0. El número cuelga de la esquina superior derecha de la página: y: BAND - 0.8 * NUMERAL * PT apoya su línea de base en el filete, y BEARING desplaza su caja 2 mm hacia el borde de la página para compensar el margen lateral de la cifra, de modo que la tinta queda más o menos a ras del texto. El antetítulo cuelga del contenedor. El título cuelga debajo del antetítulo y la entradilla debajo del título, con anclajes below, y un diseño de encabezado pasa su texto de línea por defecto, así que un título más largo empuja la entradilla hacia abajo. La entradilla es un elemento de texto que toma su contenido del atributo lead del título; una línea de autor sería otro más, {attr.author}, encadenado del mismo modo. minHeight: BAND - TOP + AIR fija dónde empieza el texto. La caja del número baja 0,2 veces su cuerpo (11,9 mm) por debajo del filete, y una apertura reserva sitio hasta su elemento más bajo, así que AIR tiene que medir al menos 11,9 mm; con menos, sería la caja del número la que marcara dónde empieza el texto.
#2 · Dale la página al título de capítulo
headings: {
fontFamily: 'Archivo', color: col('band'),
levels: [
// parity: 'odd' keeps openers on rectos, so the numeral's right-edge anchor is the
// fore-edge. The copy is fitted so no chapter spills a few lines onto a page of its own,
// which would leave that page and a blank verso before the next opener.
{ level: 1, span: 'page', breakBefore: { enabled: true, parity: 'odd' },
// 0: the hidden title's default 0.5 em would add a grid line, and AIR alone sets the gap
marginBottom: pt(0), advancedDesign: opener },
{ level: 2, fontSize: pt(11.5), lineHeight: pt(LEAD), numberingTemplate: '{1}.{2}',
marginTop: pt(LEAD), marginBottom: pt(0) }, // one grid line above, none below
],
},
span: 'page' abre cada capítulo en una página nueva y extiende el encabezado de primer nivel sobre las dos columnas; luego lo dibuja advancedDesign, así que el texto del título queda oculto y el texto empieza bajo la altura reservada. breakBefore con parity: 'odd' lleva cada apertura a una página impar, donde el borde derecho al que se ancla el número es el exterior. En el nivel 2, numberingTemplate: '{1}.{2}' numera las secciones 3.1, 3.2… en el color de la banda; un nivel 3 con '{1}.{2}.{3}' seguiría con 3.1.1.
#3 · Nombra una sola vez el color del capítulo
const palette = {
ink: '#1b1f23', // text: a cool near-black
band: '#c2562b', // the chapter colour: band, tab, section numbers, references, captions
band2: '#2e6f73', // the second chapter colour, a teal; the sea in Figure 3.1
land: '#d5cbc0', // the crust in the drawings
muted: '#6b6259', // running heads and the colophon
paper: '#ffffff', // type on the band
};
// col(id): a colour linked to its palette entry, with the entry's hex beside the link.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
// The engine's defaults link to 'main-color': point it at the band, so nothing prints blue.
{ id: 'main-color', name: 'band (defaults)', value: { hex: palette.band, model: 'hex' } },
];
// {style="teal"} on a heading line swaps 'band' up to the next level-1 heading: the style's
// palette reaches design slots through their link and repaints every text colour equal to
// the base 'band'.
const headingStyles = [{ id: 'teal', palette: { band: palette.band2 } }];
Cada color de la configuración enlaza con una de estas entradas. Los valores por defecto del motor enlazan con main-color, así que, al apuntar esa entrada al color de la banda, cambian también los que la configuración no fija. El título del capítulo 4, # Fuego \\ desde abajo {style="teal" topic="Volcanes" lead="…"}, elige el estilo, que cambia band hasta el siguiente encabezado de nivel 1. Las zonas de diseño siguen el cambio a través de su enlace con la paleta, y se repintan los colores de texto iguales al band de base, de modo que en las páginas 43 y 44 se vuelven verde azulado el uñero, los números de sección y de lista, las remisiones, la etiqueta «Figura 4.1» y el folio al pie. La misma línea rellena {attr.topic} y {attr.lead}, y su \\ parte {titleText} donde quiere el autor (atributos de encabezado, saltos de línea en los títulos).
#4 · Deja que la primera cita coloque cada figura
const figure = (id, placement, caption) => ({ id, typeId: 'figure', kind: 'svg', createdAt: 0,
updatedAt: 0, svg: { fileId: `${id}.svg`, width: ART[id].width, height: ART[id].height },
placement, caption, altText: ALT[id] }); // altText: read aloud in a PDF or HTML edition
const resources = [
// 'auto' may take the citing page's foot, 'top' never can (gotcha: top-float-next-page)
figure('plate-cycle', { position: 'auto', span: 'page' },
t({ en: 'A plate’s life in cross-section: born at a ridge (left), it cools as it drifts away '
+ 'and sinks under a continent; dots mark earthquakes.',
es: 'La vida de una placa, en corte: nace en la dorsal (izquierda), se enfría al alejarse y '
+ 'se hunde bajo el continente; los puntos son terremotos.' })),
figure('two-volcanoes', { position: 'bottom', span: 'page' }, // under the text on a last page
t({ en: 'Two volcanoes in cross-section: a broad shield built of runny basalt flows (left) '
+ 'and a steep stratovolcano of lava and ash layers (right).',
es: 'Dos volcanes en corte: un escudo ancho, de coladas de basalto fluido (izquierda), y un '
+ 'estratovolcán de capas de lava y ceniza (derecha).' })),
];
Un :ref numera su figura y la coloca en el primer hueco libre a partir del párrafo que la cita. La figura 3.1 es auto. Se cita en la apertura cuando las dos columnas aún tienen sitio, así que ocupa el pie de esa página; como flotante top habría abierto la página 42, porque un flotante nunca sube por encima de su referencia. La figura 4.1 se cita en la parte baja de la segunda columna de la página 43, donde ya no cabe una banda a todo el ancho, y bottom la manda a la página 44. Es la última página del capítulo, y en una última página el motor sube los flotantes del pie hasta dejarlos justo debajo de las últimas líneas de texto, sin hueco encima.
#5 · Cabeceras, un uñero y un folio al pie
const HEAD = 15.5; // mm from the trim to the folio's and the head's baseline: 8.5 above TOP
const INSET = 9; // mm from the folio's edge to the head: room for a three-digit folio
const TAB = { y: 36, w: 9, h: 26 }; // the thumb tab, mm: its top, its width, its height
const tabSize = (w) => ({ width: mm(w), height: mm(TAB.h) });
const baseline = (size) => mm(HEAD - 0.96 * size * PT); // box: 1.2 × size, baseline 0.8 down
const label = { fontFamily: 'Archivo Narrow', fontSize: pt(7.5), fontWeight: 600,
letterSpacing: pt(1.3), textTransform: 'uppercase', color: col('muted') };
const folio = { fontFamily: 'Archivo', fontSize: pt(9), fontWeight: 800, color: col('ink') };
const side = (parity) => { // the fore-edge is a verso's left edge and a recto's right edge
const [edge, s] = parity === 'even' ? ['left', 1] : ['right', -1]; // s: into the page
const at = (to, x, y, size) => ({ anchor: { to, edge: `top-${edge}` },
offset: { x: mm(s * x), y }, ...(size && { size }) });
return [
{ kind: 'text', id: `folio-${parity}`, content: '{pageNumber}', ...folio,
placement: at('page', OUTER, baseline(9)) },
// Textbooks name the chapter on the verso and the section on the recto: {firstMark.h2}
// is the first level-2 heading that starts on the page, or the one in force.
{ kind: 'text', id: `head-${parity}`, content: s > 0 ? '{chapterTitle}' : '{firstMark.h2}',
...label, placement: at('page', OUTER + INSET, baseline(7.5)) },
{ kind: 'box', id: `tab-${parity}`, style: { backgroundColor: col('band') }, // off the trim
placement: at('bleed', 0, mm(BLEED + TAB.y), tabSize(BLEED + TAB.w)) },
{ kind: 'text', id: `tab-no-${parity}`, content: '{chapterNumber}', ...folio, fontSize: pt(13),
color: col('paper'), // design text centres by default: here, on the trimmed tab
placement: at('page', 0, mm(TAB.y), tabSize(TAB.w)) },
].map((element) => ({ ...element, parity, pages: 'body' })); // never on an opener
};
const header = { elements: [...side('even'), ...side('odd')] };
const footer = { elements: [{ kind: 'text', id: 'drop-folio', content: '{pageNumber}',
...folio, color: col('band'), pages: 'opener', // centred by its anchor
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(10) } } }] };
Cada elemento de la cabecera cuelga de una esquina superior de la página y se filtra por parity, de modo que el folio y el uñero quedan siempre en el borde exterior. La caja del uñero cuelga de la esquina del sangrado y se ensancha con BLEED, para que siga sangrando después del corte. pages: 'body' aparta todos estos elementos de las aperturas, que llevan en su lugar un folio al pie definido en footer. La página par lleva el título del capítulo, {chapterTitle}, en una sola línea, porque la \\ solo parte el título en la apertura. Los libros de texto suelen llevar la sección en la impar. La cabecera impar la imprime con {firstMark.h2}: el primer título de sección que empieza en la página, o el vigente si no empieza ninguno. En estas cuatro páginas no llega a verse, porque las dos impares son aperturas.
#6 · Empieza el libro en el capítulo 3
const continuation = { pageNumbering: { startAt: 41 }, // an odd folio: page 1 is still a recto
headings: { h1: 2, h2: 0, h3: 0, h4: 0, h5: 0, h6: 0 } }; // the next # is chapter 3
const doc = await buildDocumentWithFonts({ markdown, resources, continuation }, config(),
kitFonts(FONTS));
showPages(doc, { title: t({ en: 'Chapter opener on a full-bleed band',
es: 'Apertura de capítulo sobre banda a sangre' }) });
Estas páginas son los capítulos 3 y 4 de un libro más largo, así que buildDocument recibe una continuation con los contadores tal como los dejaron los capítulos 1 y 2. Con h1: 2 en sus headings, el siguiente # es el capítulo 3: {chapterNumber} imprime 3, las secciones se numeran desde 3.1 y la primera figura pasa a ser la 3.1. pageNumbering.startAt: 41 hace que los folios empiecen en el 41. La primera página sigue siendo impar sea cual sea su folio, porque la paridad se cuenta sobre la página física y pageIndexOffset se queda en 0; el primer folio, 41, es impar para que concuerde con ella.
La receta completa
// ═══ Postext Cookbook · Nº 003 · Chapter opener on a full-bleed band ══════════════
// https://postext.dev/en/cookbook/chapter-opener-bleed-band
// Code: MIT · Text: original (CC BY 4.0) · Drawings: generated in code (CC BY 4.0)
// Fonts: Roboto Serif, Archivo, Archivo Narrow (SIL OFL 1.1) · Needs postext ≥ 1.57.0
// Two chapters of a geology textbook. Every level-1 heading becomes a colour band bled off the
// top of the page, its number standing on the band's foot; a heading style recolours chapter 4.
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'chapter-opener-bleed-band';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: semantic colours, and the style that swaps a chapter's
const palette = {
ink: '#1b1f23', // text: a cool near-black
band: '#c2562b', // the chapter colour: band, tab, section numbers, references, captions
band2: '#2e6f73', // the second chapter colour, a teal; the sea in Figure 3.1
land: '#d5cbc0', // the crust in the drawings
muted: '#6b6259', // running heads and the colophon
paper: '#ffffff', // type on the band
};
// col(id): a colour linked to its palette entry, with the entry's hex beside the link.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
// The engine's defaults link to 'main-color': point it at the band, so nothing prints blue.
{ id: 'main-color', name: 'band (defaults)', value: { hex: palette.band, model: 'hex' } },
];
// {style="teal"} on a heading line swaps 'band' up to the next level-1 heading: the style's
// palette reaches design slots through their link and repaints every text colour equal to
// the base 'band'.
const headingStyles = [{ id: 'teal', palette: { band: palette.band2 } }];
// #endregion
// #region answer: the opener: a bleed band, the numeral on its foot, texts from the heading
const TOP = 24; // top margin, mm: the opener's container starts here
const OUTER = 16; // outer margin, mm: the numeral and the folios line up on it
const BLEED = 0; // mm: 0 on screen; about 3 for print, which also switches on page.cutLines
const BAND = 100; // mm from the trim to the foot of the band
const NUMERAL = 168; // pt; the baseline of a design text sits 0.8 down its line box
const PT = 25.4 / 72; // mm in a point
const AIR = 12; // mm, foot to text: ≥ 0.2 × NUMERAL × PT ≈ 11.9, the numeral box below its baseline
const BEARING = 2; // mm past the text edge: a rough optical nudge, as each digit's bearing differs
const bleedTop = { to: 'bleed', edge: 'top-left' }; // the trim's corner, pushed out by BLEED
// Design text centres by default; in a heading design it wraps by default too.
const onBand = { color: col('paper'), align: 'left' };
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
#Haz la banda más alta
BAND fija la altura de la banda, la posición del número y el espacio reservado sobre el texto. Con una banda más alta, parte del texto pasa a la página siguiente, así que tendrás que ajustar cada capítulo (mira el último error frecuente) o dejar que los capítulos vayan seguidos.
-const BAND = 100; // mm from the trim to the foot of the band
+const BAND = 128; // mm from the trim to the foot of the band#Imprime con sangrado
Con un sangrado de 3 mm, la banda, su filete y el uñero rebasan el corte en 3 mm, el número sigue apoyado en el filete y page.cutLines se activa con el mismo valor.
-const BLEED = 0; // mm: 0 on screen; about 3 for print, which also switches on page.cutLines
+const BLEED = 3; // mm: 0 on screen; about 3 for print, which also switches on page.cutLines#Añade un color para otro capítulo
Cada color de capítulo es una entrada más en la paleta y un estilo más; escribe {style="slate"} en el título de ese capítulo.
band2: '#2e6f73', // the second chapter colour, a teal; the sea in Figure 3.1
+ band3: '#3d4f6b', // a third chapter colour, a slate blue
@@
-const headingStyles = [{ id: 'teal', palette: { band: palette.band2 } }];
+const headingStyles = [{ id: 'teal', palette: { band: palette.band2 } },
+ { id: 'slate', palette: { band: palette.band3 } }];#Deja que los capítulos vayan seguidos
Con 'any' cada capítulo empieza en la página siguiente. Tras un capítulo que acaba en impar, el siguiente empieza en la par, sin página en blanco delante, y su número queda junto al lomo, porque cuelga del borde derecho de la página. Estas páginas quedan igual, ya que el capítulo 3 acaba en una par.
- { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'odd' },
+ { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'any' },Errores frecuentes
Error frecuente
Una apertura reserva altura hasta su elemento anclado más bajo
Una apertura de diseño avanzado reserva la altura de su elemento más bajo, y cuentan también los anclados a la página o a la sangre que quedan por debajo del título, así que un adorno al pie de la página empuja el texto a la siguiente. Dale a ese elemento reserve: false (desde postext 1.5): se pinta donde está anclado y no reserva nada. Los elementos que siguen a la propia banda (anclados a su pie, o de altura 'fill') nunca fijan su altura. Aperturas diseñadas →
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 flotante 'top' va a la página siguiente a su cita salvo que pueda encabezar la página que lo cita
Por defecto un flotante nunca va por encima de su propia referencia, así que un flotante 'top' a todo el ancho citado en la página N abre la página N+1. Con placement.citingPage: true en el recurso o en el defaultPlacement de su tipo (o layout.floatsAtCitingPage para todo el libro, desde postext 1.25) encabeza en cambio la página N, y el texto de encima de la referencia baja bajo él, cuando cabe dentro de layout.maxTopFraction y la línea que lo cita sigue en esa página. Nunca encabeza la primera página de un capítulo ni una página tras un salto forzado: allí sigue abriendo la página siguiente, y 'auto' o 'bottom' pueden ocupar el pie de la página que lo cita. Colocación de figuras →
- La banda tiene una altura fija, mientras que el antetítulo, el título y la entradilla cuelgan del margen superior y crecen hacia abajo, así que una entradilla más larga o un título de tres líneas chocan con el filete. Limita las entradillas a unas cinco líneas, como en las dos ediciones, o calcula
BANDa partir de la apertura más larga. - La fórmula de la
ydel número da por hecholineHeight: 1. La línea de base de un texto de diseño está al 80 % de la altura de su caja de línea, y0.8 * NUMERALsolo mide esa distancia cuando la caja es tan alta como el cuerpo. Si cambias el interlineado o el anclaje, cambia también la fórmula.BEARINGse ajusta a ojo, porque cada cifra tiene su propio margen lateral (aquí el 3 y el 4 terminan a 0,8 mm uno del otro). - La paleta de un estilo recolorea los elementos de diseño y el texto. Una imagen conserva los colores con los que se dibujó: la figura 4.1 es verde azulada porque el código la dibuja a partir de
band2, y una figura terracota colocada en el capítulo 4 seguiría siendo terracota. - Con
parity: 'odd', un capítulo que se pasa unas líneas de su última página deja una página casi vacía y una par en blanco antes de la siguiente apertura. Ajusta el texto, como hacen aquí las dos ediciones, y revisa la última página de cada capítulo siempre que cambien el texto oBAND.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fuentes
- Roboto Serif (SIL OFL 1.1) · Archivo (SIL OFL 1.1) · Archivo Narrow (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)


