Saltar al contenido principal
Receta número 36

Recetario · Capítulo 8 · Tablas

Catálogo de venta por correo con imágenes en las celdas

Un catálogo de semillas cuya lista de precios, una tabla leída de un TSV, lleva un sobre pintado en la celda de cada variedad y se parte entre dos páginas.

pp. 2–3 de 4

  • Muestra en inglés: aún no hay edición en español
  • Formato 190 × 250 mm
  • 2 columnas, medianil de 7 mm
  • Gelasio 9,5/13
  • Alfa Slab One
  • Cabin Condensed
  • 4 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 66 ms
  • 227 líneas de código

En pocas palabras

Un catálogo de semillas de cuatro páginas con su lista de precios. Cada variedad lleva una pequeña pintura de su sobre dentro de la tabla, y la lista sigue de una página a la de enfrente.

Lo que vas a componer

La lista de precios de primavera de Brindlewood Seed Co., una casa de semillas inventada, en un cuadernillo de cuatro páginas sobre papel color ante. En la cubierta, «Spring Seeds» va en Alfa Slab One sobre la pintura de un girasol y una tomatera, y debajo, a dos columnas, la carta a los clientes. La lista ocupa las páginas 2 y 3. Cada variedad tiene la pintura de su sobre en lo alto de la celda, con el nombre debajo, y las clases de hortaliza bajan por una primera columna de celdas combinadas. Los precios van a la derecha en una letra estrecha de rótulos, y unos chips rojos y verdes marcan las semillas nuevas y las ecológicas. La lista se corta después del pimiento para freír y sigue en la página de enfrente bajo la misma banda roja, con «(continued)» detrás del título. La contracubierta es la hoja de pedido: dos tablas de esquinas redondeadas con renglones en blanco para rellenar a mano.

Esta receta responde a

  • ¿Cómo pongo imágenes o iconos dentro de las celdas de una tabla?
  • ¿Cómo parto una tabla larga entre páginas con la cabecera repetida y un aviso de «continúa»?
  • ¿Cómo doy estilos distintos a varias tablas (rellenos, filas alternas, marcos redondeados) en un mismo documento?
  • ¿Cómo hago una tabla con filas de cabecera, celdas combinadas, anchos de columna y alineación por celda?

La respuesta corta

script.js · líneas 44–78en el código completo
const at = (row, c) => ({ row, col: c });
const slug = (name) => name.toLowerCase().replace(/\W+/g, '-'); // 'Gold Medal' → 'gold-medal'
function priceList(tsv) { // Kind · Variety · Description · Packet · Ounce, under one head row
  let m = { ...parseTSV(tsv, { headerRows: 1 }), columnWidths: [20, 40, 63, 17, 17] }; // mm
  for (const c of [0, 1]) m = setAlignment(m, at(0, c), 'center'); // each head over its column
  for (const c of [3, 4]) m = setAlignment(m, at(0, c), 'right');
  for (let r = 1; r < m.rows.length; r++) {
    // The picture is a resource of its own; the cell sets it at the top, centred, with the
    // variety's name under it, and the row grows to hold both.
    const variety = m.rows[r][1].content;
    m = setCellImage(m, at(r, 1), { resourceId: slug(variety), width: PACKET });
    m = setCellContent(m, at(r, 1), `**${variety}**`);
    m = setAlignment(m, at(r, 1), 'center');
    for (const c of [3, 4]) { // prices in the label face: lining figures, flush right
      m = setCellContent(m, at(r, c), `:chip[$${m.rows[r][c].content}]{style="price"}`);
      m = setAlignment(m, at(r, c), 'right');
    }
    if (!m.rows[r][0].content) continue; // an empty Kind goes on with the one above
    let end = r;
    while (m.rows[end + 1] && !m.rows[end + 1][0].content) end++;
    // One cell down the rows of its kind; mergeCells leaves the covered cells in the grid,
    // marked hiddenBy (gotcha: merged-cells-hiddenby). A split never cuts through it.
    m = mergeCells(m, { start: at(r, 0), end: at(end, 0) });
    m = setAlignment(m, at(r, 0), 'center', 'middle');
    m = setCellBackground(m, at(r, 0), col('cream'));
  }
  return m;
}
// The letter on page 1 cites the list, so it floats to the first free slot after the
// letter, page 2, and is cut between rows where the page ends; span 'page' gives it the
// full 157 mm, not a 75 mm column.
const vegetableList = (tsv) => ({ id: 'vegetables', typeId: 'list', kind: 'table',
  caption: '**Vegetable Seeds**', placement: { span: 'page' },
  note: 'A packet holds about 30 tomato or pepper seeds, 40 beans or 12 squash seeds.',
  table: { model: priceList(tsv) }, createdAt: 0, updatedAt: 0 });

Ingredientes

Tipografía
Gelasio, Alfa Slab One, Cabin Condensed (SIL OFL 1.1)
Recursos
  • amish-paste-360.jpg
  • black-beauty-360.jpg
  • brandywine-360.jpg
  • cherokee-purple-360.jpg
  • cover-1500.jpg
  • dragon-tongue-360.jpg
  • gold-medal-360.jpg
  • jimmy-nardello-360.jpg
  • kentucky-wonder-360.jpg
  • waltham-butternut-360.jpg
  • El girasol y la tomatera de la cubierta, una pintura (Generated With Diffusion Models, original)
  • El sobre de semillas de Brandywine (Generated With Diffusion Models, original)
  • El sobre de semillas de Cherokee Purple (Generated With Diffusion Models, original)
  • El sobre de semillas de Gold Medal (Generated With Diffusion Models, original)
  • El sobre de semillas de Amish Paste (Generated With Diffusion Models, original)
  • El sobre de semillas de Jimmy Nardello (Generated With Diffusion Models, original)
  • El sobre de semillas de Kentucky Wonder (Generated With Diffusion Models, original)
  • El sobre de semillas de Dragon Tongue (Generated With Diffusion Models, original)
  • El sobre de semillas de Black Beauty (Generated With Diffusion Models, original)
  • El sobre de semillas de Waltham Butternut (Generated With Diffusion Models, original)

Elaboración

#1 · Añade lo que el TSV no trae

El código está en la respuesta corta, más arriba. El TSV solo trae palabras y precios. setCellImage coloca el sobre de cada variedad, un recurso con el nombre de la variedad como id, en lo alto de su celda y al 55 % del ancho interior, de modo que el nombre queda bajo una imagen de 20,3 × 27,1 mm y cada fila crece hasta 36 mm. mergeCells extiende cada clase hacia abajo por la primera columna y marca con hiddenBy las celdas que tapa. Las celdas del cuerpo de una tabla comparten una sola letra, aquí Gelasio, así que cada precio es un chip sin fondo, sin borde y sin margen interior a los lados, en Cabin Condensed negrita a 1,12 em por sus cifras de caja alta.

#2 · Cita la lista y pártela entre las dos páginas

script.js · líneas 82–98en el código completo
const tableStyle = { bodyFontSize: pt(9), headerFontFamily: LABEL, // body cells in Gelasio
  headerFontSize: pt(7.5), headerColor: col('paper'), headerBackground: col('ink'),
  rules: 'horizontal', borderColor: col('rule'), borderWidth: pt(0.5), cellPadding: mm(1.5),
  // 'split' is the default, written out as the key to change: 'clip' keeps the rows that fit
  // page 2 and drops the rest, 'hide' drops the whole list. Suffix and marker label the parts.
  overflow: 'split', continuedSuffix: '(continued)',
  continuesMarker: 'Continued on the facing page' };
const tableStyles = [{ id: 'form', rules: 'grid', borderRadius: mm(2.5), // a card to write on
  borderColor: col('muted'), borderWidth: pt(0.6), headerBackground: col('basil'),
  bodyFontFamily: LABEL, bodyFontSize: pt(8.5),
  bodyBackgroundEnabled: true, bodyBackground: col('cream'), cellPadding: mm(1.6) }];
// The caption sits above the table on a tomato band and is repeated on every part. Its note
// and the marker take the caption's face, so the caption keeps the body's Gelasio, which has
// the italic the suffix and the marker are set in; Cabin Condensed has none.
const captionStyle = { fontSize: pt(12), color: col('cream'),
  position: 'above', backgroundEnabled: true, background: col('tomato'), padding: mm(2),
  gap: mm(0), note: { fontSize: pt(7.8), color: col('muted') } };

La carta de la página 1 cita la lista con :ref{id="vegetables" text="the price list"}, y text imprime esas palabras en lugar de un número. Una tabla citada flota al primer hueco libre después de la cita, que aquí es la cabeza de la página 2. La lista no cabe entera, así que el motor la corta entre filas después de Jimmy Nardello, nunca dentro de una clase combinada. En la página 3 se repiten la fila de cabecera y la banda del pie, ahora con el sufijo; el aviso va bajo la primera parte y la nota, bajo la última (tablas más altas que la página). parseTSV(tsv, { headerRows: 1 }) convierte la primera fila en la cabecera, que se pinta como tal y se repite en la página 3. El sufijo y el aviso van en cursiva con la letra del pie, y por eso la banda se compone en Gelasio y no en Cabin Condensed, que no tiene cursiva.

#3 · Un recurso para cada sobre

script.js · líneas 272–284en el código completo
// Nothing cites the pictures, so none is numbered or placed: the cover design and the cells
// draw them by id, and their typeId is never looked up.
const picture = (id, fileId, [w, h], altText) => ({ id, typeId: 'figure', kind: 'bitmap',
  altText, bitmap: { fileId, format: 'jpeg', width: w, height: h }, createdAt: 0, updatedAt: 0 });
const varieties = parseTSV(list).rows.slice(1).map((row) => row[1].content);
const resources = [vegetableList(list), shipTo, orderForm,
  picture('cover-art', 'cover-1500.jpg', [1500, 1040], // the cover's 150 × 104 mm
    'A sunflower and a staked tomato plant in a ploughed field.'),
  ...varieties.map((name) => picture(slug(name), `${slug(name)}-360.jpg`, [360, 480], // 3 : 4
    `Seed packet of ${name}.`))];
await prepareFonts(markdown + list, config(), kitFonts(FONTS));
await Promise.all(resources.flatMap(({ bitmap }) => bitmap
  ? [loadImage(bitmap.fileId, asset(bitmap.fileId))] : []));

La imagen de una celda remite a un recurso por su id, así que cada sobre es un recurso de mapa de bits propio, un JPEG de 360 × 480 px recortado al 3 : 4 del sobre, y loadImage, del kit, lo registra con el fileId mediante registerResourceImage. Nadie cita los sobres, de modo que ninguno se numera ni se coloca fuera de su celda. Las pinturas no llevan rótulos: el nombre va como texto de la celda, con las fuentes de la página.

#4 · Un segundo estilo de tabla para la hoja de pedido

script.js · líneas 241–260en el código completo
function form(id, widths, rows, merges, note) { // an empty cell still takes a line's height
  let m = { headerRowCount: 1, columnWidths: widths, rows: rows.map((row, r) =>
    widths.map((_, c) => ({ content: row[c] ?? '', isHeader: r === 0 }))) };
  for (const [r, c0, c1] of merges) m = mergeCells(m, { start: at(r, c0), end: at(r, c1) });
  m.rows.forEach((row, r) => row.forEach((cell, c) => { // a label takes the paper's buff
    if (r === 0 || !cell.content || cell.hiddenBy) return;
    m = setCellBackground(m, at(r, c), col('paper'));
    if (cell.colSpan > 1) m = setAlignment(m, at(r, c), 'right'); // the totals' labels
  }));
  return { id, typeId: 'list', kind: 'table', note, placement: { position: 'here' },
    table: { model: m, styleId: 'form' }, createdAt: 0, updatedAt: 0 };
}
const shipTo = form('ship-to', [24, 60, 24, 49], [['Ship to'], ['Name'], ['Street or box'],
  ['Town', '', 'State and ZIP']], [[0, 0, 3], [1, 1, 3], [2, 1, 3]]);
const lines = Array.from({ length: 11 }, () => []); // eleven varieties to a sheet
const orderForm = form('order', [16, 73, 20, 20, 28], [['No.', 'Variety', 'Packets', 'Ounces',
  'Amount'], ...lines, ['Seeds total'], ['Postage: free on orders of $40 or more, otherwise $4.50'],
['**Total enclosed**']], [1, 2, 3].map((k) => [lines.length + k, 0, 3]),
'We guarantee every packet to grow. If a variety fails to come up in your garden, write to '
  + 'us before August 1 and we will send a new packet or refund what you paid for it.');

Las dos tablas de la hoja de pedido usan el estilo con nombre form, con filetes en cuadrícula, 2,5 mm de radio en las esquinas del marco exterior y un fondo crema sobre el que escribir. La lista de precios conserva el tableStyle del documento (estilos de tabla con nombre). Una celda vacía no necesita ningún texto, porque su fila ocupa igualmente una línea, aquí de 7,3 mm. Cada total combina cuatro columnas en un solo rótulo alineado a la derecha. El estilo de encabezado de la hoja de pedido pasa la página 4 a una sola columna, así que las dos tablas ocupan toda la medida, 157 mm.

#5 · Mantén la carta debajo de la pintura

script.js · líneas 115–137en el código completo
const ART = { w: 150, h: 104, y: 60 }; // mm: the cover painting, and its top on the page
const FRAME = 8; // mm: the cover's frame, in from the trim
const AIR = 10; // mm: at least this much between the painting and the letter
const SINK = Math.ceil((ART.y + ART.h + AIR - MARGIN.top) / (LEAD * 25.4 / 72)); // lines
const cover = { id: 'cover', span: 'page', footer: { elements: [] },
  // The opener reserves down to the painting's foot; minHeight is a floor AIR lower, on the
  // grid. The frame reaches the page's foot, so it stays out of that count: reserve: false
  // (gotcha: opener-reserves-anchored).
  advancedDesign: { enabled: true, minHeight: pt(SINK * LEAD), slot: { elements: [
    { kind: 'box', id: 'frame', reserve: false,
      style: { borderColor: col('basil'), borderWidth: pt(1.2) },
      placement: on('page', 'top-left', FRAME, FRAME,
        { width: mm(TRIM.w - 2 * FRAME), height: mm(TRIM.h - 2 * FRAME) }) },
    text('publisher', '{title}', on('page', 'top', 0, 17), { ...caps(9.5), color: col('basil') }),
    text('title', '{titleText}', on('page', 'top', 0, 23), { fontFamily: DISPLAY,
      fontSize: pt(58), lineHeight: 1, color: col('tomato') }),
    text('issue', '{subtitle}', on('page', 'top', 0, 49), { ...caps(8.5, 700), color: col('ink'),
      box: { backgroundColor: col('sun'), padding: { top: mm(1.3), bottom: mm(1.1),
        left: mm(4), right: mm(4) } } }),
    { kind: 'image', id: 'art', resourceId: 'cover-art',
      placement: on('page', 'top', 0, ART.y, { width: mm(ART.w) }) },
  ] } },
};

La cubierta reserva hasta el borde inferior de su pintura, a 164 mm del borde superior de la página, y sin minHeight la carta empezaría en la primera línea de la rejilla base que queda debajo, pegada a la tierra. minHeight es un mínimo algo más bajo: SINK deja 10 mm de aire bajo la pintura y redondea la distancia desde el margen superior a líneas enteras de 13 pt, 34 en total, así que las dos columnas de la carta arrancan en la rejilla base, a 177,9 mm del borde. El marco de la cubierta llega hasta el pie de la página; reserve: false lo deja fuera de esa cuenta.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 036 · Mail-order catalogue with pictures in cells ═══════
// https://postext.dev/en/cookbook/seed-catalogue
// Code: MIT · Text: original (CC BY 4.0) · Pictures: diffusion models
// Fonts: Gelasio, Alfa Slab One, Cabin Condensed (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// A fictional seed farm's spring list: a table read from TSV, a packet pictured in each row.
import {
  buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage, parseTSV,
  mergeCells, setAlignment, setCellBackground, setCellContent, setCellImage,
} from 'https://esm.sh/postext';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'seed-catalogue';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // eight named colours; every colour in the config links to one of them
  ink: '#2d2620', paper: '#f0e2c4', // brown-black text on buff
  cream: '#fcf7ea', tomato: '#c23b22', // cells to write in; the accent: bands, titles, NEW
  basil: '#2f6b3b', sun: '#e8b53a', // rules, ORGANIC, the form's head; the cover's banner
  rule: '#c7ae86', muted: '#6d5f50', // hairlines; running heads and notes
};
// col() links a colour to its palette entry; the hex is the value the entry holds.
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' } }));

const TRIM = { w: 190, h: 250 }; // mm: a stapled mail-order booklet
const MARGIN = { top: 22, bottom: 20, inner: 18, outer: 15 }; // mm, mirrored: 157 mm wide
const LEAD = 13; // pt: the body leading, the grid the headings keep to
const TEXT = 'Gelasio', DISPLAY = 'Alfa Slab One', LABEL = 'Cabin Condensed';
const PACKET = 0.55; // the packet picture's share of its cell's inner width
const caps = (size, fontWeight = 600) => ({ fontFamily: LABEL, fontSize: pt(size), fontWeight,
  letterSpacing: pt(size * 0.18), textTransform: 'uppercase' });
const on = (to, edge, x, y, size) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
  ...(size && { size }) });
const text = (id, content, placement, style) => ({ kind: 'text', id, content, placement,
  overflow: 'wrap', ...style }); // a long line takes a second one, in the heads too
const chip = (id, size, ink, box) => ({ id, fontFamily: LABEL, bold: true, fontSize: em(size),
  color: col(ink), borderRadius: pt(1.2), ...box });
const rule = (id, below, gap, thickness) => ({ kind: 'rule', id, direction: 'horizontal',
  thickness: pt(thickness), color: col('basil'),
  placement: { ...on(`#${below}`, 'below', 0, gap), size: { width: 'fill' } } });

// #region answer: a price list from TSV: a packet in each variety's cell, kinds merged down
const at = (row, c) => ({ row, col: c });
const slug = (name) => name.toLowerCase().replace(/\W+/g, '-'); // 'Gold Medal' → 'gold-medal'
function priceList(tsv) { // Kind · Variety · Description · Packet · Ounce, under one head row
  let m = { ...parseTSV(tsv, { headerRows: 1 }), columnWidths: [20, 40, 63, 17, 17] }; // mm
  for (const c of [0, 1]) m = setAlignment(m, at(0, c), 'center'); // each head over its column

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

#Quédate solo con lo que cabe

Con overflow: 'clip', la lista se queda en las cinco variedades que caben en la página 2, con la nota debajo, y en la página 3 solo quedan las notas del campo de ensayo, en su primera columna.

-  overflow: 'split', continuedSuffix: '(continued)',
+  overflow: 'clip', continuedSuffix: '(continued)',

#Encoge los sobres

Al 40 %, las filas bajan a 29 mm, pero las dos judías comparten una celda combinada y juntas necesitan 57 mm, más de los 44 mm que quedan en la página 2. Las notas del campo de ensayo suben a ese hueco, y la página 3 solo lleva el resto de la lista, con la página en blanco por debajo de los 157 mm.

-const PACKET = 0.55; // the packet picture's share of its cell's inner width
+const PACKET = 0.4; // the packet picture's share of its cell's inner width

Errores frecuentes

Error frecuente

Las celdas combinadas necesitan hiddenBy: usa mergeCells

Las celdas se colocan según su posición en la fila, así que una celda combinada necesita celdas de relleno marcadas con hiddenBy donde se extiende; omitirlas, como en HTML, desplaza todas las columnas siguientes. Combina celdas con mergeCells. Desde postext 1.5 una tabla con una rejilla irregular se anota en doc.contentWarnings como raggedTableGrid, y parseTSV(texto, { headerRows }) marca las filas de cabecera. Tablas a partir de datos →

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 →

  • Un recurso que nadie cita no se coloca nunca. Si quitas el :ref de la carta, el catálogo se queda sin lista de precios.
  • En columnas de 75 mm, Knuth–Plass puede dejar una línea justificada con los espacios más abiertos de lo que permite maxWordSpacing; bodyText.maxJustifyTracking deja que una línea así tome un poco de espaciado entre letras en su lugar. Aquí la carta y las notas del campo de ensayo se reescribieron hasta que la línea más abierta estiró sus espacios 1,33 veces su ancho normal.

Créditos

Texto
Texto original, CC BY 4.0
Imágenes
  • El girasol y la tomatera de la cubierta, una pintura · Generated With Diffusion Models · original
  • El sobre de semillas de Brandywine · Generated With Diffusion Models · original
  • El sobre de semillas de Cherokee Purple · Generated With Diffusion Models · original
  • El sobre de semillas de Gold Medal · Generated With Diffusion Models · original
  • El sobre de semillas de Amish Paste · Generated With Diffusion Models · original
  • El sobre de semillas de Jimmy Nardello · Generated With Diffusion Models · original
  • El sobre de semillas de Kentucky Wonder · Generated With Diffusion Models · original
  • El sobre de semillas de Dragon Tongue · Generated With Diffusion Models · original
  • El sobre de semillas de Black Beauty · Generated With Diffusion Models · original
  • El sobre de semillas de Waltham Butternut · Generated With Diffusion Models · original
Fuentes
Gelasio (SIL OFL 1.1) · Alfa Slab One (SIL OFL 1.1) · Cabin Condensed (SIL OFL 1.1)
Sandbox