Saltar al contingut principal
Recepta número 36

Receptari · Capítol 8 · Taules

Catàleg de venda per correu amb imatges a les cel·les

Un catàleg de llavors: la llista de preus, una taula llegida d'un TSV, porta un sobre pintat a la cel·la de cada varietat i es parteix entre dues pàgines.

En aquesta pàgina
  • Mostra en anglès: encara no hi ha edició en català
  • Format 190 × 250 mm
  • 2 columnes, espai entre columnes de 7 mm
  • Gelasio 9,5/13
  • Alfa Slab One
  • Cabin Condensed
  • 4 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 66 ms
  • 227 línies de codi

En poques paraules

Un catàleg de llavors de quatre pàgines amb la seva llista de preus. Cada varietat porta una petita pintura del seu sobre dins de la taula, i la llista continua d'una pàgina a la del davant.

Què compondràs

La llista de preus de primavera de Brindlewood Seed Co., una casa de llavors inventada, en un quadernet de quatre pàgines sobre paper color ant. A la coberta, «Spring Seeds» va en Alfa Slab One sobre la pintura d'un gira-sol i una tomaquera, i a sota, a dues columnes, la carta als clients. La llista ocupa les pàgines 2 i 3. Cada varietat té la pintura del seu sobre a dalt de la cel·la, amb el nom a sota, i les classes d'hortalissa baixen per una primera columna de cel·les combinades. Els preus van a la dreta en una lletra estreta de rètols, i uns xips vermells i verds marquen les llavors noves i les ecològiques. La llista es talla després del pebrot per fregir i continua a la pàgina del davant sota la mateixa banda vermella, amb «(continued)» darrere del títol. La contracoberta és el full de comanda: dues taules de cantonades arrodonides amb ratlles en blanc per emplenar a mà.

Aquesta recepta respon a

  • Com poso imatges o icones dins de les cel·les d'una taula?
  • Com parteixo una taula llarga entre pàgines amb la capçalera repetida i un avís de «continua»?
  • Com dono estils diferents a diverses taules (emplenaments, files alternes, marcs arrodonits) en un mateix document?
  • Com faig una taula amb files de capçalera, cel·les combinades, amplades de columna i alineació per cel·la?

La resposta curta

script.js · línies 44–78al codi complet
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 });

Ingredients

Tipografia
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
  • The cover's sunflower and tomato plant, a painting (Generated With Diffusion Models, original)
  • The Brandywine seed packet (Generated With Diffusion Models, original)
  • The Cherokee Purple seed packet (Generated With Diffusion Models, original)
  • The Gold Medal seed packet (Generated With Diffusion Models, original)
  • The Amish Paste seed packet (Generated With Diffusion Models, original)
  • The Jimmy Nardello seed packet (Generated With Diffusion Models, original)
  • The Kentucky Wonder seed packet (Generated With Diffusion Models, original)
  • The Dragon Tongue seed packet (Generated With Diffusion Models, original)
  • The Black Beauty seed packet (Generated With Diffusion Models, original)
  • The Waltham Butternut seed packet (Generated With Diffusion Models, original)

Elaboració

#1 · Afegeix el que el TSV no porta

El codi és a la resposta curta, més amunt. El TSV només porta paraules i preus. setCellImage col·loca el sobre de cada varietat, un recurs amb el nom de la varietat com a id, a dalt de la seva cel·la i al 55 % de l'amplada interior, de manera que el nom queda sota una imatge de 20,3 × 27,1 mm i cada fila creix fins a 36 mm. mergeCells estén cada classe cap avall per la primera columna i marca amb hiddenBy les cel·les que tapa. Les cel·les del cos d'una taula comparteixen una sola lletra, aquí Gelasio, així que cada preu és un xip sense fons, sense vora i sense marge interior als costats, en Cabin Condensed negreta a 1,12 em per les seves xifres de caixa alta.

#2 · Cita la llista i parteix-la entre les dues pàgines

script.js · línies 82–98al codi complet
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 llista amb :ref{id="vegetables" text="the price list"}, i text imprimeix aquestes paraules en lloc d'un número. Una taula citada flota al primer espai lliure després de la cita, que aquí és el cap de la pàgina 2. La llista no hi cap sencera, així que el motor la talla entre files després de Jimmy Nardello, mai dins d'una classe combinada. A la pàgina 3 es repeteixen la fila de capçalera i la banda del peu, ara amb el sufix; l'avís va sota la primera part i la nota, sota l'última (taules més altes que la pàgina). parseTSV(tsv, { headerRows: 1 }) converteix la primera fila en la capçalera, que es pinta com a tal i es repeteix a la pàgina 3. El sufix i l'avís van en cursiva amb la lletra del peu, i per això la banda es compon en Gelasio i no en Cabin Condensed, que no té cursiva.

#3 · Un recurs per a cada sobre

script.js · línies 272–284al codi complet
// 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 imatge d'una cel·la remet a un recurs pel seu id, així que cada sobre és un recurs de mapa de bits propi, un JPEG de 360 × 480 px retallat al 3 : 4 del sobre, i loadImage, del kit, el registra amb el fileId mitjançant registerResourceImage. Ningú no cita els sobres, de manera que cap no es numera ni es col·loca fora de la seva cel·la. Les pintures no porten rètols: el nom va com a text de la cel·la, amb les fonts de la pàgina.

#4 · Un segon estil de taula per al full de comanda

script.js · línies 241–260al codi complet
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.');

Les dues taules del full de comanda fan servir l'estil amb nom form, amb filets en graella, 2,5 mm de radi a les cantonades del marc exterior i un fons crema sobre el qual escriure. La llista de preus conserva el tableStyle del document (estils de taula amb nom). Una cel·la buida no necessita cap text, perquè la seva fila ocupa igualment una línia, aquí de 7,3 mm. Cada total combina quatre columnes en un sol rètol alineat a la dreta. L'estil d'encapçalament del full de comanda passa la pàgina 4 a una sola columna, així que les dues taules ocupen tota la mesura, 157 mm.

#5 · Mantén la carta sota la pintura

script.js · línies 115–137al codi complet
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 coberta reserva fins a la vora inferior de la seva pintura, a 164 mm de la vora superior de la pàgina, i sense minHeight la carta començaria a la primera línia de la retícula de base que queda a sota, enganxada a la terra. minHeight és un mínim una mica més baix: SINK deixa 10 mm d'aire sota la pintura i arrodoneix la distància des del marge superior a línies senceres de 13 pt, 34 en total, així que les dues columnes de la carta arrenquen a la retícula de base, a 177,9 mm de la vora. El marc de la coberta arriba fins al peu de la pàgina; reserve: false el deixa fora d'aquest compte.

La recepta 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

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Variants

#Queda't només amb el que hi cap

Amb overflow: 'clip', la llista es queda en les cinc varietats que caben a la pàgina 2, amb la nota a sota, i a la pàgina 3 només queden les notes del camp d'assaig, a la primera columna.

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

#Encongeix els sobres

Al 40 %, les files baixen a 29 mm, però les dues mongetes comparteixen una cel·la combinada i juntes necessiten 57 mm, més dels 44 mm que queden a la pàgina 2. Les notes del camp d'assaig pugen a aquest forat, i la pàgina 3 només porta la resta de la llista, amb la pàgina en blanc per sota dels 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

Errors freqüents

Error freqüent

Les cel·les combinades necessiten hiddenBy: fes servir mergeCells

Les cel·les es col·loquen segons la seva posició a la fila, així que una cel·la combinada necessita cel·les de farciment marcades amb hiddenBy on s'estén; ometre-les, com en HTML, desplaça totes les columnes següents. Combina cel·les amb mergeCells. Des de postext 1.5 una taula amb una graella irregular s'anota a doc.contentWarnings com a raggedTableGrid, i parseTSV(text, { headerRows }) marca les files de capçalera. Taules a partir de dades →

Error freqüent

Una obertura reserva alçada fins al seu element ancorat més baix

Una obertura de disseny avançat reserva l'alçada del seu element més baix, i també hi compten els ancorats a la pàgina o a la sang que queden per sota del títol, així que un ornament al peu de la pàgina empeny el text a la següent. Dona a aquest element reserve: false (des de postext 1.5): es pinta on està ancorat i no reserva res. Els elements que segueixen la mateixa banda (ancorats al seu peu, o d'alçada 'fill') no en fixen mai l'alçada. Obertures dissenyades →

  • Un recurs que ningú no cita no es col·loca mai. Si treus el :ref de la carta, el catàleg es queda sense llista de preus.
  • En columnes de 75 mm, Knuth–Plass pot deixar una línia justificada amb els espais més oberts del que permet maxWordSpacing; bodyText.maxJustifyTracking deixa que una línia així prengui una mica d'interlletratge en lloc d'això. Aquí la carta i les notes del camp d'assaig es van reescriure fins que la línia més oberta va estirar els espais 1,33 vegades la seva amplada normal.

Crèdits

Text
Text original, CC BY 4.0
Imatges
  • The cover's sunflower and tomato plant, a painting · Generated With Diffusion Models · original
  • The Brandywine seed packet · Generated With Diffusion Models · original
  • The Cherokee Purple seed packet · Generated With Diffusion Models · original
  • The Gold Medal seed packet · Generated With Diffusion Models · original
  • The Amish Paste seed packet · Generated With Diffusion Models · original
  • The Jimmy Nardello seed packet · Generated With Diffusion Models · original
  • The Kentucky Wonder seed packet · Generated With Diffusion Models · original
  • The Dragon Tongue seed packet · Generated With Diffusion Models · original
  • The Black Beauty seed packet · Generated With Diffusion Models · original
  • The Waltham Butternut seed packet · Generated With Diffusion Models · original
Fonts
Gelasio (SIL OFL 1.1) · Alfa Slab One (SIL OFL 1.1) · Cabin Condensed (SIL OFL 1.1)
Sandbox