En pocas palabras
La portada y las primeras páginas de una revista de comida y campo, con foto en portada y un sumario. Enseña a dar a cada sección su propio color, que se mantiene en todas sus páginas.
Lo que vas a componer
Seis páginas de 230 × 300 mm de un número de FALLOW, revista trimestral imaginaria de comida y tierra. La portada es un valle toscano a sangre bajo FALLOW en Bodoni de 118 pt, con tres llamadas sobre un panel de papel, cada antetítulo en el color de su sección, y el precio y el código de barras en la esquina. :::toc compone el sumario de la página 2: bajo la pestaña de color de cada sección, el título, la página y la entradilla del artículo; a la derecha, la carta de la editora, los colaboradores y el colofón. Siguen tres secciones, en teja, oliva y granate, cuyos artículos abren con una imagen a sangre en la cabeza de la página y un panel de su color montado encima; folios, viñetas y recuadros llevan ese color. Lo pone la línea :::part que precede a cada artículo, sin abrir portadilla.
Esta receta responde a
- ¿Cómo hago una cubierta, una portadilla, una portada y un colofón?
- ¿Cómo añado un índice que se actualice solo (líneas de puntos, números de página, autores, filas de parte)?
- ¿Cómo divido un libro en partes o secciones, cada una con su color y su portadilla?
- ¿Cómo doy a cada capítulo su propia foto, su color o una variante de apertura?
La respuesta corta
const MASTHEAD = TRIM.width - MARGIN.inner - MARGIN.outer; // the word spans the text block
const PANEL = 84; // mm: the cover lines' panel, a column of paper over the photograph
const SEAM = 0.3; // mm: each box overlaps the one above, so no hairline of photo shows
// A cover line: a kicker in its section's colour over a line in Bodoni, on paper boxes of one
// width. Chained with 'below' they read as one panel, and a longer line pushes the rest down.
const sheet = (top, bottom) => ({ backgroundColor: col('paper'),
padding: { top: mm(top), right: mm(5), bottom: mm(bottom), left: mm(5) } });
const small = { ...label, fontSize: pt(8), letterSpacing: pt(1.6), color: col('ink') };
const coverLine = (n, colour, above = n === 1 ? '#masthead' : `#line${n - 1}`) => [
text(`kicker${n}`, `{attr.kicker${n}}`, { ...small, color: col(colour),
box: sheet(n === 1 ? 5 : 4, 1.5) },
{ ...at(above, 'below', 0, n === 1 ? 8 : -SEAM), size: { width: mm(PANEL) } }),
text(`line${n}`, `{attr.line${n}}`, { ...bodoni, italic: true, fontSize: pt(15),
lineHeight: 1.12, color: col('ink'), box: sheet(0, n === 3 ? 5 : 0) }, // line 3 ends the panel
{ ...at(`#kicker${n}`, 'below', 0, -SEAM), size: { width: mm(PANEL) } }),
];
const cover = { enabled: true, slot: { elements: [
{ kind: 'image', id: 'photo', resourceId: 'cover', // the JPEG is cropped to the trim, 23 : 30
placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: 'fill' } } },
text('strap', '{subtitle}', small, at('page', 'top-left', MARGIN.inner, 12)), // a recto
text('issue', '{attr.issue}', { ...small, align: 'right' },
at('page', 'top-right', -MARGIN.outer, 12)),
text('masthead', '{titleText}', { ...bodoni, fontWeight: 900, fontSize: pt(118),
lineHeight: 0.86, // set tight: the masthead is capitals, with no descenders
letterSpacing: pt(1), textTransform: 'uppercase', align: 'center', color: col('ink') },
{ ...at('#strap', 'below', 0, 6), size: { width: mm(MASTHEAD) } }),
...coverLine(1, 'olive'), ...coverLine(2, 'terracotta'), ...coverLine(3, 'wine'),
// The price and a made-up barcode sit in the corner, anchored to the page, not the words.
text('price', '{attr.price}', { ...small, fontSize: pt(7), box: sheet(1, 1.5) },
{ ...at('page', 'bottom-right', -MARGIN.outer, -12), size: { width: mm(32) } }),
{ kind: 'image', id: 'barcode', resourceId: 'barcode',
placement: { ...at('#price', 'above', 0, SEAM), size: { width: mm(32) } } },
] } };
// hook-up: headingStyles gets { id: 'cover', numbered: false, toc: false, advancedDesign: cover,
// footer: { elements: [] } }, with no folio; the Markdown's first line is
// # Fallow {style="cover" issue="…" price="…" kicker1="…" line1="…" … kicker3="…" line3="…"}
Ingredientes
- Funciones
- Anclaje de elementos de diseñoÍndice generalColores por parteCabeceras por secciónAperturas diseñadasEstilos de títuloCapítulos sin númeroImágenes en los diseños de páginaTextos, filetes y cajas en los diseños de páginaAtributos de títuloPaleta de color semánticaBanda de capítulo a todo el anchoColocación de figurasRecuadros flotantesRecuadrosEstilos de párrafoTipos de recurso propiosFiguras y tablas como recursosPáginas en un canvas
- También usa
- Figuras justo aquíColor del papelSaltos de página y de columnaPortadillas de parteEspacio vertical explícito
- Tipografía
- Spectral, Bodoni Moda, Jost (SIL OFL 1.1)
- Recursos
castellina-cover-1150.jpgcastellina-farm-1530.jpgfields-1610.jpgflasks-1920.jpgharvest-1840.jpg- Castellina in Chianti (la portada y su copia en el sumario) (Rowan Heuvel, CC0 1.0)
- Castellina in Chianti, un detalle (la foto del reportaje) (Rowan Heuvel, CC0 1.0)
- Plantas en matraces (la apertura del Cuaderno de campo) (chuttersnap, CC0 1.0)
- Cosecha de trigo (la apertura de Cocina) (meriç tuna, CC0 1.0)
- Campos vistos desde arriba cerca de Castellina in Chianti (la apertura del reportaje) (Generated With Diffusion Models, original)
- El código de barras de la portada, dibujado con código (Ignacio Ferro, MIT)
Elaboración
#1 · Cuelga la portada de su nombre
El código es la respuesta corta de arriba. Solo la foto, las dos líneas de cabeza y el precio se anclan a la página. Todo lo demás se ancla a otro elemento (colocación de elementos): el nombre de la revista, bajo la línea superior; el primer antetítulo, 8 mm por debajo del nombre, y a partir de ahí cada llamada bajo su antetítulo y cada antetítulo bajo la llamada anterior. Así, si una llamada ocupa más líneas o el nombre crece, empuja lo que tiene debajo en vez de pisarlo. Cada antetítulo y cada llamada llevan su propia caja de papel de 84 mm de ancho, y las seis cajas apiladas forman el panel, que crece con el texto. Cada caja, salvo la primera, se solapa 0,3 mm (SEAM) con la de encima, igual que el código de barras con el precio, porque en el canvas dos fondos que solo se tocan dejan ver entre ellos una raya finísima de la foto. Una revista no lleva la anteportada ni la portada de un libro; su nombre va en la portada, y el número, la fecha y el colofón, en el sumario. Los preliminares de un libro están en Preliminares con folios romanos y luego la página 1.
#2 · Haz de cada sección una parte sin página
const parts = { page: false }; // a :::part now only sets the section's title and palette
const story = (id, picture) => ({ id, numbered: false, advancedDesign: opener(picture) });
const headingStyles = () => [
{ id: 'cover', numbered: false, toc: false, advancedDesign: cover,
footer: { elements: [] } }, // no folio on the cover (the header is empty everywhere)
{ id: 'contents', numbered: false, toc: false, advancedDesign: contentsOpener,
footer: folioLine('{title}', '{publishDate}') }, // no section yet: the issue instead
// One opener for every story; the style names its picture, the part its colour.
story('grain', 'flasks'), story('rest', 'fields'), story('bread', 'harvest'),
];
Con parts.page: false, una línea como :::part{title="Reportajes" palette="band=#5d6a2b"} no abre portadilla y solo fija el título y la paleta de la sección desde el bloque siguiente (el contenedor :::part). El H1 de cada artículo usa un estilo de encabezado con numbered: false, así que el sumario lo recoge sin número. El estilo elige la imagen de la apertura, y el color lo pone la parte.
#3 · Enlaza todos los colores de sección a una entrada
const palette = {
ink: '#1c1a16', // text: a warm near-black
paper: '#fbf8f1', // the page, and type set on colour
band: '#8b6a3e', // the house earth; each :::part fence brings its own 'band'
muted: '#6b6358', // credits and the standfirsts in the contents
olive: '#5d6a2b', terracotta: '#a3472a', wine: '#7a2c3a', // as in the :::part fences: edit both
};
// A part overrides by id: col() writes the id beside the hex, and the designs follow it.
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 ink, so nothing prints blue.
{ id: 'main-color', name: 'ink (defaults)', value: { hex: palette.ink, model: 'hex' } },
];
Una parte redefine entradas de la paleta por su id, así que todo lo que cambia con la sección se enlaza a band: el panel de la apertura, la pestaña del folio, las viñetas y los números de las listas, la cita destacada, y el filete y el título del recuadro de datos. En el texto, la redefinición va por valor: cualquier color cuyo hex coincida con el hex base de band (#8b6a3e) toma el de la sección, y por eso ninguna otra entrada usa ese hex. En los elementos de diseño es al revés: la redefinición de una parte les llega por el paletteId, y por eso col() escribe el id junto al hex.
#4 · Deja que el sumario se agrupe solo
const mid = at('container', 'left', 0, -1); // the row's middle, 1 mm up: air above the title
const contents = { // passed to the config as `toc`
levels: [{ level: 1, fontFamily: 'Bodoni Moda', fontSize: pt(17), fontWeight: 600,
marginBottom: pt(2 * LEAD) }], // in ink, on the body's 13.5 pt leading
pageNumber: { fontSize: pt(26), width: mm(14) }, // in the levels' Bodoni
leader: { enabled: false }, subtitle: { enabled: true, attr: 'standfirst', // in italic
fontFamily: 'Spectral', fontSize: pt(10), color: col('muted') },
// A part row is a design as wide as the column; its 'band' takes the part's palette. No
// {pageNumber} in it: each story under the tab prints its own page.
parts: { height: pt(2 * LEAD), design: { elements: [ // two grid lines (the default: 2 em)
{ kind: 'rule', id: 'line', thickness: pt(0.75), color: col('band'), // behind the tab
placement: { ...mid, size: { width: 'fill' } } },
text('tab', '{titleText}', { ...label, fontSize: pt(8), letterSpacing: pt(1.6),
color: col('paper'), box: { backgroundColor: col('band'),
padding: { top: mm(1.2), right: mm(2.4), bottom: mm(1.2), left: mm(2.4) } } },
mid),
] } },
};
// The colophon closes the contents page; the Markdown calls it with :::paragraphs.
const colophon = { id: 'colophon', fontFamily: 'Jost', fontSize: pt(7), lineHeight: pt(10),
color: col('muted'), textAlign: 'left', firstLineIndent: pt(0), marginTop: pt(LEAD) };
const air = { padding: { bottom: mm(9) } }; // empty padding counts: the columns start lower
const contentsOpener = { enabled: true, slot: { elements: [
{ kind: 'rule', id: 'rule', thickness: pt(1), color: col('ink'),
placement: { ...at('container', 'top-left'), size: { width: 'fill' } } },
text('kicker', '{titleText}', { ...label, fontSize: pt(9), letterSpacing: pt(1.8),
color: col('band') }, at('#rule', 'below', 0, 5)),
text('issue', '{attr.issue}', { ...bodoni, italic: true, fontSize: pt(44), lineHeight: 1.05,
color: col('ink') }, at('#kicker', 'below', 0, 2)),
text('strap', '{subtitle}', { fontFamily: 'Spectral', italic: true, fontSize: pt(11),
color: col('muted'), align: 'left' }, at('#issue', 'below', 0, 1.5)),
text('number', '{attr.number}', { ...bodoni, fontWeight: 900, fontSize: pt(160), lineHeight: 1,
align: 'right', color: col('band'), box: air }, at('container', 'top-right', 0, 4)),
] } };
:::toc recoge los artículos y da a cada :::part una fila compuesta con toc.parts.design y la paleta de esa parte (índice general), así que un solo diseño de fila imprime tres pestañas de tres colores. El filete y la pestaña cuelgan de mid, el centro de la fila subido 1 mm para que la pestaña no roce el título de debajo. Sin línea de puntos, entre cada título y su página (3, 4 y 6) solo queda blanco, y subtitle.attr pone debajo, en cursiva, el atributo standfirst de la apertura. El colofón que cierra la columna derecha es un estilo de párrafo en Jost de 7 pt y color muted que el Markdown aplica con :::paragraphs{style="colophon"}.
#5 · Da a todos los artículos la misma apertura
const PHOTO = 150; // mm from the top edge to the foot of the picture
const FOOT = PHOTO - MARGIN.top; // the same foot from the container, which starts at the margin
const LIFT = 34; // mm: how far the panel rises into the picture
const WIDE = 136; // mm: the panel's width
const panel = (top, bottom) => ({ backgroundColor: col('band'),
padding: { top: mm(top), right: mm(6), bottom: mm(bottom), left: mm(6) } });
const below = (id) => ({ ...at(`#${id}`, 'below', 0, -SEAM), size: { width: mm(WIDE) } });
const opener = (resourceId) => ({ enabled: true, slot: { elements: [
{ kind: 'image', id: 'picture', resourceId, // fitted, never cropped: each file is 230 : 150
placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(PHOTO) } } },
text('credit', '{attr.credit}', { ...small, fontSize: pt(6.5), color: col('muted'),
letterSpacing: pt(0.6), align: 'right' }, at('container', 'top-right', 0, FOOT + 2)),
text('section', '{partTitle}', { ...label, fontSize: pt(8.5), letterSpacing: pt(1.7),
color: col('paper'), box: panel(6, 2) }, { ...at('container', 'top-left', 0, FOOT - LIFT),
size: { width: mm(WIDE) } }),
text('title', '{titleText}', { ...bodoni, fontWeight: 700, fontSize: pt(32), lineHeight: 1.02,
color: col('paper'), box: panel(0, 3) }, below('section')),
text('standfirst', '{attr.standfirst}', { fontFamily: 'Spectral', italic: true,
fontSize: pt(11.5), lineHeight: 1.35, overflow: 'wrap', align: 'left',
color: col('paper'), box: panel(0, 6) }, below('title')),
// The panel and the byline reach below the picture's foot, so they set where the story
// starts; the byline's empty padding keeps the first line 5 mm under it.
text('byline', '{attr.byline}', { ...small, fontSize: pt(7.5), letterSpacing: pt(1.3),
box: { padding: { top: mm(4), bottom: mm(5) } } }, at('#standfirst', 'below')),
] } });
La imagen, a sangre, ocupa los 150 mm de arriba de la página. Un panel en band monta 34 mm sobre su pie: son tres cajas de texto de 136 mm, cada una anclada below (debajo) de la anterior, con el nombre de la sección que da {partTitle}, el título y la entradilla. El panel y la firma bajan más que el pie de la imagen, así que el texto empieza bajo el elemento más bajo, la firma, cuyo relleno inferior vacío de 5 mm lo mantiene al menos a esa distancia.
#6 · Nombra la sección en el folio
const TAB = 6.5; // mm: the tab's side; the words beside it take its height and centre on it
const folioLine = (first, second) => ({ elements: [['even', 'left', 1], ['odd', 'right', -1]]
.flatMap(([parity, side, s]) => {
const inward = s > 0 ? 'right-of' : 'left-of'; // from the outer edge towards the gutter
const beside = (id, content, style, to, gap) => text(id, content, { ...style, align: side },
{ ...at(to, inward, s * gap), size: { height: mm(TAB) } }); // text centres vertically
return [
text(`tab-${parity}`, '{pageNumber}', { ...label, fontSize: pt(8), color: col('paper'),
align: 'center', box: { backgroundColor: col('band') } },
{ ...at('page', `bottom-${side}`, s * MARGIN.outer, -11),
size: { width: mm(TAB), height: mm(TAB) } }),
beside(`first-${parity}`, first, { ...small, color: col('band') }, `#tab-${parity}`, 3),
beside(`second-${parity}`, second, { fontFamily: 'Spectral', italic: true,
fontSize: pt(8), color: col('muted') }, `#first-${parity}`, 2.5),
].map((element) => ({ ...element, parity })); // no pages filter: openers get folios too
}) });
El número de página va en un cuadrado de band de 6,5 mm, al pie y por el lado exterior. El nombre de la sección se ancla a su lado, hacia el medianil, y el título del artículo junto al nombre; las tres cajas miden 6,5 mm de alto y llevan el texto centrado en vertical, así que comparten eje. Las revistas también folian las páginas de apertura, por eso el pie no lleva filtro pages. El estilo de la portada deja el pie vacío, y el del sumario pone el nombre de la revista y la fecha del número ({title} y {publishDate}) donde van la sección y el artículo.
La receta completa
// ═══ Postext Cookbook · Nº 023 · Magazine cover and sectioned contents ═══════════════
// https://postext.dev/en/cookbook/magazine-cover-and-contents
// Code: MIT · Text: original (CC BY 4.0) · Photos: R. Heuvel, chuttersnap, m. tuna (CC0), diffusion
// Fonts: Spectral, Bodoni Moda, Jost (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'magazine-cover-and-contents';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: one house colour, 'band', that every section overrides
const palette = {
ink: '#1c1a16', // text: a warm near-black
paper: '#fbf8f1', // the page, and type set on colour
band: '#8b6a3e', // the house earth; each :::part fence brings its own 'band'
muted: '#6b6358', // credits and the standfirsts in the contents
olive: '#5d6a2b', terracotta: '#a3472a', wine: '#7a2c3a', // as in the :::part fences: edit both
};
// A part overrides by id: col() writes the id beside the hex, and the designs follow it.
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 ink, so nothing prints blue.
{ id: 'main-color', name: 'ink (defaults)', value: { hex: palette.ink, model: 'hex' } },
];
// #endregion
const TRIM = { width: 230, height: 300 }; // an independent-magazine trim, in mm
const MARGIN = { top: 22, bottom: 20, inner: 16, outer: 14 }; // mirrored
const LEAD = 13.5; // body leading in pt: the baseline grid
const caps = { fontFamily: 'Jost', fontWeight: 600, textTransform: 'uppercase' }; // the label face
const label = { ...caps, align: 'left' }; // design text is centred by default
const bodoni = { fontFamily: 'Bodoni Moda', overflow: 'wrap', align: 'left' };
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const text = (id, content, look, placement) => ({ kind: 'text', id, content, placement, ...look });
// #region answer: the cover, one design slot whose words hang from each other
const MASTHEAD = TRIM.width - MARGIN.inner - MARGIN.outer; // the word spans the text block
const PANEL = 84; // mm: the cover lines' panel, a column of paper over the photograph
const SEAM = 0.3; // mm: each box overlaps the one above, so no hairline of photo shows
// A cover line: a kicker in its section's colour over a line in Bodoni, on paper boxes of one
// width. Chained with 'below' they read as one panel, and a longer line pushes the rest down.
const sheet = (top, bottom) => ({ backgroundColor: col('paper'),
padding: { top: mm(top), right: mm(5), bottom: mm(bottom), left: mm(5) } });
const small = { ...label, fontSize: pt(8), letterSpacing: pt(1.6), color: col('ink') };
const coverLine = (n, colour, above = n === 1 ? '#masthead' : `#line${n - 1}`) => [
text(`kicker${n}`, `{attr.kicker${n}}`, { ...small, color: col(colour),
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
#Pon el nombre de la revista en el color de la casa
El nombre de la revista toma el color tierra del gran 14 del sumario.
- textTransform: 'uppercase', align: 'center', color: col('ink') },
+ textTransform: 'uppercase', align: 'center', color: col('band') },#Abre cada sección con una portadilla
Para partes con página propia, y un número de página en cada fila de parte del sumario, mira Partes en color con un solo atributo.
Errores frecuentes
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 →
Error frecuente
Los mapas de bits toman su tamaño de impresión de una resolución: declárala, no calcules píxeles de impresión
Un mapa de bits sin resolución se coloca a un píxel por píxel de maquetación a la resolución del documento, así que una foto de 2400 px mide 406 mm de ancho en una página de 150 ppp. Declara los píxeles reales del archivo y da a la imagen su resolución (bitmap.resolution: 300), o fija layout.bitmapResolution para todos los mapas de bits: unos ppp, o 'file' para leer la que indica el archivo. La columna sigue limitando la imagen. Figuras y tablas como recursos →
- Un elemento de imagen encaja la imagen en su caja y nunca la recorta. Recorta antes cada JPEG a su caja, 23 : 30 para la portada y 230 × 150 mm para las aperturas, o la imagen encoge y deja franjas blancas en los bordes.
- En el texto, una parte cambia cualquier color cuyo hex coincida con el hex base de
band, esté enlazado abando no. Reserva ese hex para lo que deba cambiar con la sección. - Los artículos están ajustados a sus páginas en los dos idiomas: en castellano se acortaron algunas frases del Cuaderno de campo para que quepa en una página, y en inglés una frase del reportaje perdió tres palabras para que las dos columnas de la página 4 acaben a la misma altura. Si cambias el texto, comprueba que ningún artículo pase unas líneas a una página nueva y que todas las páginas, salvo la última de cada artículo, acaben igualadas.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imágenes
- Castellina in Chianti (la portada y su copia en el sumario) · Rowan Heuvel · CC0 1.0
- Castellina in Chianti, un detalle (la foto del reportaje) · Rowan Heuvel · CC0 1.0
- Plantas en matraces (la apertura del Cuaderno de campo) · chuttersnap · CC0 1.0
- Cosecha de trigo (la apertura de Cocina) · meriç tuna · CC0 1.0
- Campos vistos desde arriba cerca de Castellina in Chianti (la apertura del reportaje) · Generated With Diffusion Models · original
- El código de barras de la portada, dibujado con código · Ignacio Ferro · MIT
- Fuentes
- Spectral (SIL OFL 1.1) · Bodoni Moda (SIL OFL 1.1) · Jost (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)


