En poques paraules
El programa imprès d'un congrés de tipografia de dos dies. El seu horari deixa que una xerrada ocupi totes les sales o dues franges horàries, amb cada tema del seu color.
Què compondràs
El programa imprès, en català, d'unes jornades de tipografia inventades que se celebren a Girona. La coberta dibuixa la ela geminada majúscula, L·L, amb tres mòduls de color sobre negre. Cada jornada s'obre amb una banda negra de 76 mm i el dia del mes en una xifra de 144 pt. La graella del dijous és una taula. La conferència inaugural ocupa una cel·la negra que abasta les tres sales, i cada taller, dues franges horàries. Les parts del dia encapçalen les seves files a tota l'amplada, i cada ponència és una peça del color del seu itinerari; les mostres de color del peu fan de llegenda. La graella no cap en una pàgina, així que omple la 3 i acaba a la 4, sota la seva fila de capçalera repetida. La del divendres, més curta, cap sencera al peu de la seva pàgina d'obertura.
Aquesta recepta respon a
- Com faig una taula amb files de capçalera, cel·les combinades, amplades de columna i alineació per cel·la?
- Com parteixo una taula llarga entre pàgines amb la capçalera repetida i un avís de «continua»?
- Com afegeixo mostres de color com a llegenda en el text, els peus o les notes de taula?
- Com aconsegueixo les etiquetes «Figura» i «Taula» en la llengua del meu document?
- Com faig una obertura de capítol amb una banda de color a sang, un número de capítol gran i el títol?
La resposta curta
const ROOMS = ['Sala Gran', 'Sala de les Premses', 'Aula Taller'];
const TRACKS = { T: 'tipo', D: 'digital', E: 'edicio', '*': 'ink' }; // '*': a plenary
const at = (row, c) => ({ row, col: c });
const span = (r0, c0, r1, c1) => ({ start: at(r0, c0), end: at(r1, c1) });
const lines = (code, text) => text.split(' / ').map((line, i) => { // title, then speaker
const run = i === 0 ? `**${line}**` : line;
return code === '*' ? chip(run, 'blanc') : run; // paper-white type on the ink fill
}).join('\n'); // a line break in a cell starts a new paragraph
function schedule(text) { // '11.15 | T Title / Speaker | ^' · a bare line: a part of the day
let m = { headerRowCount: 1, columnWidths: [12, 42, 42, 42], // weights of the 138 mm measure
rows: [['Hora', ...ROOMS].map((room) => ({ content: room.toUpperCase(), isHeader: true }))] };
for (const line of text.trim().split('\n')) {
const [time, ...slots] = line.split(' | ');
const r = m.rows.push(['', ...ROOMS].map(() => ({ content: '' }))) - 1; // four empty cells
if (!slots.length) { // one cell across the table; a split keeps it with the rows it heads
m = setCellContent(m, at(r, 0), chip(time.toUpperCase(), 'franja'));
m = mergeCells(m, span(r, 0, r, 3));
continue;
}
m = setCellContent(m, at(r, 0), chip(time, 'hora'));
slots.forEach((slot, i) => {
if (slot === '^') { // the session above runs on: one cell down both rows, centred in them
m = mergeCells(m, span(r - 1, i + 1, r, i + 1));
m = setAlignment(m, at(r - 1, i + 1), 'left', 'middle');
return;
}
const [, code = '', body = slot] = /^([TDE*]) (.+)$/.exec(slot) ?? [];
m = setCellContent(m, at(r, i + 1), lines(code, body));
m = setCellBackground(m, at(r, i + 1), col(TRACKS[code] ?? 'pause'));
});
if (slots.length === 1) m = mergeCells(m, span(r, 1, r, 3)); // the same for all three rooms
}
return m; // mergeCells marks the covered cells hiddenBy (gotcha: merged-cells-hiddenby)
}
Ingredients
- Funcions
- Taules a partir de dadesTaules que passen de pàginaEmplenaments de cel·laMostres de colorChips en líniaCol·locació de figuresEstil de taulesEstil dels peusObertures dissenyadesBanda de capítol d'amplada completaAtributs de títolEstils de títolCobertes, portades i colofonsFigura i Taula en la teva llenguaTipus de recurs propisEstils de paràgrafCapçaleres i folisPaleta de color semàntica
- També fa servir
- Bibliografies i glossarisCites que col·loquen les figuresCapçaleres segons el tipus de pàginaFigures i taules com a recursosCapçaleres per seccióCapítols sense número
- Tipografia
- Schibsted Grotesk, Unbounded, Chivo Mono (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Converteix cada línia del programa en una fila
El codi és la resposta curta de més amunt. Cada jornada és text pla en un fitxer de contingut, amb una línia per franja horària: | separa les sales, una lletra indica l'itinerari, * marca una plenària sobre emplenament negre, / obre cada línia que segueix el títol i ^ allarga la sessió de la franja anterior. Totes les combinacions surten de mergeCells. Una línia amb una sola sessió, com la plenària o una pausa, ocupa les tres columnes de sala. Un taller ocupa la seva cel·la i la de sota, i una part del dia (MATÍ, TARDA), que s'escriu com una línia sense |, les quatre columnes. Les cel·les cobertes continuen a la graella, marcades amb hiddenBy, perquè la columna de cada cel·la és la seva posició a la fila (Construir models de taula). headerRowCount: 1 converteix els noms de les sales en la fila de capçalera. Els columnWidths són pesos relatius, i 12 + 3 × 42 sumen els 138 mm de l'amplada de caixa, així que la columna de l'hora fa 12 mm i cada sala 42. setAlignment(…, 'left', 'middle') centra cada taller en vertical a les seves dues files.
#2 · Deixa que el dijous continuï i el divendres quedi sencer
// The built-in types in Catalan, Figura and Taula; a grid's caption goes above it.
const resourceTypes = defaultResourceTypes('ca').map((type) => ({ ...type,
...(type.id === 'table' && { captionStyle: { position: 'above' } }),
numberingTemplate: '{n}', resetOn: 'never' })); // Taula 1, Taula 2: one count, not per day
const SPLIT = { overflow: 'split', // the default; the other values are 'clip' and 'hide'
// The engine's own Catalan strings are '(cont.)' and 'Continua': these spell them out.
continuedSuffix: '(continuació)', // after the caption of every part but the first
continuesMarker: 'Continua a la pàgina següent' }; // under every part but the last
// Thursday is cited on page 2 and placed at the top, so it opens page 3 (gotcha:
// top-float-next-page) and splits; Friday goes whole to the foot of the page that cites it.
const PLACE = { dijous: { position: 'top', span: 'page' },
divendres: { position: 'bottom', span: 'page' } };
La graella del dijous es cita a la pàgina 2 i va a dalt d'una pàgina. Un flotant no puja mai per sobre de la seva referència, així que la graella obre la pàgina 3. No hi cap, i overflow: 'split' la talla entre dues files, mai dins d'una cel·la combinada (Taules més altes que la pàgina). La pàgina 3 acaba amb la fila de les 17.30 i l'avís a sota. La 4 repeteix la fila de capçalera i el peu complet, amb la llegenda de colors, seguit de (continuació), i la nota només apareix sota aquesta última part. La del divendres va al peu d'una pàgina i cap sota el text que la cita a la pàgina 5. defaultResourceTypes('ca') dona als tipus els noms en català, Figura i Taula. Els textos catalans del motor per a una taula partida són (cont.) i Continua; l'estil de taula els escriu sencers. numberingTemplate: '{n}' amb resetOn: 'never' numera les dues graelles en una sola sèrie: Taula 1 i Taula 2.
#3 · Talla els emplenaments en peces
const tableStyle = { ...SPLIT, borderColor: col('paper'), borderWidth: pt(1.6), // grid rules
headerBackground: col('ink'), headerColor: col('paper'), headerFontFamily: LABEL,
headerFontSize: pt(7.5), bodyFontSize: pt(8.2),
cellPadding: mm(1.5) };
const bare = (id, extra) => ({ id, backgroundEnabled: false, borderWidth: pt(0),
paddingX: pt(0), ...extra }); // a chip that only changes the face, the size or the colour
const chipStyles = [bare('blanc', { color: col('paper') }), // the plenary's type, on ink
bare('hora', { fontFamily: LABEL, fontSize: em(0.96), bold: true }),
bare('franja', { fontFamily: LABEL, fontSize: em(0.92), bold: true, color: col('accent') }),
bare('sala')]; // keeps each room of the plan's note on one line
setCellBackground, a la resposta curta, dona a cada sessió el color de la paleta del seu itinerari, i uns filets d'1,6 pt del color del paper tallen els emplenaments en peces separades per línies blanques (Estil de taules). Una taula té un sol color de text per a les cel·les del cos, així que el blanc de la plenària és un xip amb un estil que fixa el color i treu l'emplenament, la vora i el marge lateral del xip. Les hores i les parts del dia també són xips, en Chivo Mono (Estils de xip). Un xip no es parteix mai entre dues línies; el títol d'una plenària i la línia del seu ponent caben cadascun en una línia de la cel·la de tres sales. A la nota del plànol, el xip sala deixa el text tal com és i manté en una línia el número i el nom de cada sala, com faria un espai de no separació entre les seves paraules.
#4 · Obre cada jornada amb una banda
const BAND = 76, STRIP = 8, AIR = 7; // mm: band from the trim, its strip of modules, air below
const text = (id, content, family, size, color, placement, extra) => ({ kind: 'text', id,
content, fontFamily: family, fontSize: pt(size), color: col(color), placement, align: 'left',
overflow: 'wrap', ...extra }); // a long line wraps, in the running heads too
const pin = (to, edge, x, y, size) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
...(size && { size }) });
const caps = (size) => ({ fontWeight: 500, textTransform: 'uppercase',
letterSpacing: pt(size * 0.18) });
const NUMERAL = 144; // pt
// mm: Unbounded 800's 1 at 144 pt starts its ink 0.76 mm into its box, the date's first capital
// at 8 pt 0.1 to 0.2 mm into its own (P 0.19, S 0.09): 0.6 mm to the left lines up the two inks
const BEARING = 0.6;
const BASELINE = 0.8; // a design line's baseline sits 0.8 down its box (lineHeight 1)
const opener = { enabled: true, minHeight: mm(BAND - PAGE.top + AIR), slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('ink') },
placement: pin('bleed', 'top-left', 0, 0, { width: 'fill', height: mm(BAND) }) },
{ kind: 'image', id: 'strip', resourceId: 'strip', placement: pin('page', 'top-left', 0,
BAND - STRIP, { width: mm(PAGE.w), height: mm(STRIP) }) }, // on the band's foot
text('date', '{attr.date}', LABEL, 8, 'edicio', pin('container', 'top-left', 0, 0), caps(8)),
text('numeral', '{attr.day}', DISPLAY, NUMERAL, 'paper', pin('#date', 'below', -BEARING, 1),
{ fontWeight: 800, lineHeight: 1 }), // a 144 pt line box
text('title', '{titleText}', DISPLAY, 26, 'paper', // its baseline level with the numeral's
pin('#numeral', 'right-of', 5, BASELINE * (NUMERAL - 26) * PT),
{ fontWeight: 700, lineHeight: 1 }),
] } };
El disseny del títol de primer nivell dibuixa la banda: una caixa de 76 mm d'alçada des de la vora de sang, amb la franja de mòduls al llarg del seu peu. La data surt de l'atribut date del títol, i la xifra, de day. El traç de l'1 d'Unbounded 800 a 144 pt comença 0,76 mm dins de la seva caixa, i el de la primera majúscula de la data, entre 0,1 i 0,2 mm dins de la seva; per això la xifra es desplaça 0,6 mm a l'esquerra, i la data, la xifra i el text comencen el seu traç a menys de 0,2 mm els uns dels altres. El nom del dia va a la dreta de la xifra, baixat BASELINE × (144 − 26) pt perquè les dues línies de base coincideixin, perquè en un text de disseny amb lineHeight: 1 la línia de base queda a 0,8 de l'alçada de la seva caixa. minHeight reserva la pàgina fins a 7 mm per sota de la banda, i la retícula de base arrodoneix aquesta reserva cap amunt fins a 14 línies, així que la caixa de la primera línia de text comença 10,2 mm sota la banda. Amb AIR = 0 té prioritat la caixa de la mateixa xifra, que baixa més enllà del peu de la banda, i el text comença 5,6 mm sota la banda.
#5 · Sagna les notes dels ponents
const paragraphStyles = [
{ id: 'bio', hangingIndent: mm(4) }, // the name at the column edge, the lines under it 4 mm in
{ id: 'colophon', fontFamily: LABEL, fontSize: pt(7.4), lineHeight: pt(LEAD * 0.75),
textAlign: 'left', color: col('muted'), firstLineIndent: pt(0), marginTop: pt(LEAD) },
];
Cada ponent és un paràgraf d'un bloc :::paragraphs{style="bio"}. El nom en negreta comença a la vora de la columna i les línies següents entren 4 mm, en sagnat francès, així que els noms queden alineats columna avall, com en un índex (Estils de paràgraf).
La recepta completa
// ═══ Postext Cookbook · Nº 053 · Conference programme with a merged schedule grid ═══════
// https://postext.dev/en/cookbook/conference-programme
// Code: MIT · Text: original, in Catalan (CC BY 4.0) · Drawings: generated in code (CC BY 4.0)
// Fonts: Schibsted Grotesk, Unbounded, Chivo Mono (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage,
defaultResourceTypes, mergeCells, setCellContent, setCellBackground, setAlignment,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'conference-programme';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
ink: '#1d1b24', paper: '#ffffff', // a violet near-black; type on the ink fills
tipo: '#b09cf2', digital: '#4fc7bb', edicio: '#f4b43a', // the three tracks: fills and swatches
pause: '#ecebf1', // registration, breaks and meals
accent: '#6a3ed3', // kickers, caption labels, the parts of the day
muted: '#67636f', // running heads and notes
};
// Each colour carries its hex and the palette entry it follows.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent }) // defaults' id
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [TEXT, DISPLAY, LABEL] = ['Schibsted Grotesk', 'Unbounded', 'Chivo Mono'];
const PAGE = { w: 170, h: 240, top: 22, bottom: 20, inner: 17, outer: 15 }; // mm, mirrored
const LEAD = 13; // pt: the body's leading and baseline grid
const PT = 25.4 / 72; // mm in a point
const chip = (text, style) => `:chip[${text}]{style="${style}"}`;
// #region answer: a day's schedule as a table with merged cells, track fills and a head row
const ROOMS = ['Sala Gran', 'Sala de les Premses', 'Aula Taller'];
const TRACKS = { T: 'tipo', D: 'digital', E: 'edicio', '*': 'ink' }; // '*': a plenary
const at = (row, c) => ({ row, col: c });
const span = (r0, c0, r1, c1) => ({ start: at(r0, c0), end: at(r1, c1) });
const lines = (code, text) => text.split(' / ').map((line, i) => { // title, then speaker
const run = i === 0 ? `**${line}**` : line;
return code === '*' ? chip(run, 'blanc') : run; // paper-white type on the ink fill
}).join('\n'); // a line break in a cell starts a new paragraph
function schedule(text) { // '11.15 | T Title / Speaker | ^' · a bare line: a part of the day
let m = { headerRowCount: 1, columnWidths: [12, 42, 42, 42], // weights of the 138 mm measure
rows: [['Hora', ...ROOMS].map((room) => ({ content: room.toUpperCase(), isHeader: true }))] };
for (const line of text.trim().split('\n')) {
const [time, ...slots] = line.split(' | ');
const r = m.rows.push(['', ...ROOMS].map(() => ({ content: '' }))) - 1; // four empty cells
if (!slots.length) { // one cell across the table; a split keeps it with the rows it heads
m = setCellContent(m, at(r, 0), chip(time.toUpperCase(), 'franja'));
m = mergeCells(m, span(r, 0, r, 3));
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
#Arrodoneix les cantonades de la graella
Una taula partida arrodoneix les cantonades superiors de la seva primera part, a la pàgina 3, i les inferiors de l'última, a la pàgina 4, on només es veu la dreta perquè la columna de l'hora no té emplenament.
- cellPadding: mm(1.5) };
+ cellPadding: mm(1.5), borderRadius: mm(2.5) };#Numera cada graella per jornada
Si es compta per títols de primer nivell, com als tipus predefinits, surten la Taula 1.1 i la Taula 2.1, i el plànol passa a ser la Figura 2.1; l'estil de la coberta no es numera, així que el dijous és el títol 1.
- numberingTemplate: '{n}', resetOn: 'never' })); // Taula 1, Taula 2: one count, not per day
+ numberingTemplate: '{h1}.{n}', resetOn: 'h1' })); // Taula 1.1, Taula 2.1: per dayErrors freqüents
Error freqüent
Un flotant 'top' va a la pàgina següent a la seva cita tret que pugui encapçalar la pàgina que el cita
Per defecte un flotant no va mai per sobre de la seva pròpia referència, així que un flotant 'top' a tota l'amplada citat a la pàgina N obre la pàgina N+1. Amb placement.citingPage: true al recurs o al defaultPlacement del seu tipus (o layout.floatsAtCitingPage per a tot el llibre, des de postext 1.25) encapçala en canvi la pàgina N, i el text de damunt de la referència baixa sota seu, quan hi cap dins de layout.maxTopFraction i la línia que el cita continua en aquesta pàgina. No encapçala mai la primera pàgina d'un capítol ni una pàgina després d'un salt forçat: allà continua obrint la pàgina següent, i 'auto' o 'bottom' poden ocupar el peu de la pàgina que el cita. Col·locació de figures →
Crèdits
- Recepta
- Ignacio Ferro
- Text
- The programme’s Catalan text, both schedules included, written for this recipe, and the cover, band and floor-plan drawings, generated in code · Ignacio Ferro · CC BY 4.0
- Fonts
- Schibsted Grotesk (SIL OFL 1.1) · Unbounded (SIL OFL 1.1) · Chivo Mono (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)


