Saltar al contenido principal
Receta número 23

Recetario · Capítulo 9 · Publicaciones completas

Portada de revista e índice por secciones

Una portada cuyas llamadas cuelgan del nombre de la revista y un sumario generado con una fila de color por sección. Cada sección es una parte sin portadilla.

  • Formato 230 × 300 mm
  • 2 columnas, medianil de 6 mm
  • Spectral 9,5/13,5
  • Bodoni Moda
  • Jost
  • 6 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 127 ms
  • 249 líneas de código

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

script.js · líneas 39–74en el código completo
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

Tipografía
Spectral, Bodoni Moda, Jost (SIL OFL 1.1)
Recursos
  • castellina-cover-1150.jpg
  • castellina-farm-1530.jpg
  • fields-1610.jpg
  • flasks-1920.jpg
  • harvest-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

script.js · líneas 78–87en el código completo
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

script.js · líneas 14–27en el código completo
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

script.js · líneas 91–124en el código completo
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

script.js · líneas 128–152en el código completo
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

script.js · líneas 156–171en el código completo
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

Sandbox
// ═══ 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 a band o 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

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)
Sandbox