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
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
- Funcions
- Imatges a les cel·lesTaules que passen de pàginaTaules a partir de dadesEstils de taula amb nomEstil de taulesEmplenaments de cel·laEstil dels peusChips en líniaTipus de recurs propisFigures i taules com a recursosCol·locació de figuresCites que col·loquen les figuresEstils de títolAtributs de títolObertures dissenyadesImatges als dissenys de pàginaCobertes, portades i colofonsCapçaleres i folisColor del paperPaleta de color semàntica
- També fa servir
- Figures just aquíCapçaleres segons el tipus de pàginaEstils de paràgrafGeometria per seccióCapçaleres per secció
- Tipografia
- Gelasio, Alfa Slab One, Cabin Condensed (SIL OFL 1.1)
- Recursos
amish-paste-360.jpgblack-beauty-360.jpgbrandywine-360.jpgcherokee-purple-360.jpgcover-1500.jpgdragon-tongue-360.jpggold-medal-360.jpgjimmy-nardello-360.jpgkentucky-wonder-360.jpgwaltham-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
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
// 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
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
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
// ═══ 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 widthErrors freqüents
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
:refde 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.maxJustifyTrackingdeixa 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
- Recepta
- Ignacio Ferro
- 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)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


