Saltar al contingut principal
Recepta número 54

Receptari · Capítol 10 · Sortida i integració

Canviar els colors d'un document amb una sola paleta

Cada color de la configuració porta un id de paleta, i una sola funció compon el programa d'un festival en vermell, verd blavós, violeta o sorra.

  • Mostra en castellà: encara no hi ha edició en català
  • Format 200 × 200 mm
  • 2 columnes, espai entre columnes de 6 mm
  • Plus Jakarta Sans 9,4/13,4
  • Syne
  • 2 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 3 ms
  • 178 línies de codi

En poques paraules

Un fulletó quadrat per a un festival de música, en quatre combinacions de color. Ensenya a canviar tots els colors del document de cop triant una altra gamma.

Què compondràs

El programa de Música en la Ribera, un festival inventat, imprès en un full quadrat de 200 mm. La portada porta a la meitat superior una banda de color amb el títol en Syne 800 a 46 pt i una ona de barres arrodonides clares; a sota, dues columnes en bandera recorren la setmana dia a dia, cada acte amb l'hora en negreta i un xip amb el preu. El dors resumeix la setmana en una graella de caselles de color sota la barra del peu i continua de dimarts a divendres, amb un requadre d'entrades sota una franja i el colofó. Sobre les pàgines hi ha quatre proves, en vermell, verd blavós, violeta i sorra. Els seus colors surten de set entrades de paleta anomenades per la seva funció, més main-color, que pren el de la banda. En prémer-ne una, tot el document es torna a compondre amb la seva paleta.

Aquesta recepta respon a

  • Com evito que els títols, les negretes i les vinyetes surtin en blau?
  • Com dono color als termes clau (en negreta o cursiva) en el text o dins dels requadres?
  • Com afegeixo mostres de color com a llegenda en el text, els peus o les notes de taula?

La resposta curta

script.js · línies 25–37al codi complet
// col(id) links a colour to a palette entry. The link decides what is printed, in text, lists,
// boxes, chips, captions, table fills, swatches, design slots and references alike; the hex
// beside it (the house red's) only fills the field a colour must have.
const col = (id) => ({ hex: HOUSE[id], model: 'hex', paletteId: id });
const entries = (hexes) => Object.entries(hexes).map(([id, hex]) => ({ id, name: id,
  value: { hex, model: 'hex' } })); // the shape of config.colorPalette
// A colourway is a palette. retint() writes it into the one config; the next build sees the
// change and sets the whole programme in the new colours.
function retint(way) {
  const palette = { ...NEUTRALS, ...COLOURWAYS[way] };
  config.colorPalette = entries({ ...palette, 'main-color': palette.band }); // defaults: band
  return config;
}

Ingredients

Tipografia
Syne, Plus Jakarta Sans (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Anomena els colors per la seva funció

script.js · línies 14–21al codi complet
const NEUTRALS = { ink: '#1d1d1f', muted: '#5f5f66', paper: '#ffffff' };
const COLOURWAYS = { // band: colour fields · onBand: type on them · deep: accent type on paper
  red: { band: '#d7263d', onBand: '#ffffff', deep: '#b3122a', tint: '#fcdfe3' },
  teal: { band: '#2a9d8f', onBand: '#1d1d1f', deep: '#17695f', tint: '#d8eeeb' },
  violet: { band: '#6a4c93', onBand: '#ffffff', deep: '#5b3f86', tint: '#e7dff0' },
  sand: { band: '#f4a261', onBand: '#1d1d1f', deep: '#a14a16', tint: '#fde4cf' },
}; // white on teal is 3.3:1 and on sand 2.1:1, so those two set their band type in ink
const HOUSE = { ...NEUTRALS, ...COLOURWAYS.red }; // the house edition: red

band omple les bandes de color, onBand acoloreix el text que hi va a sobre, deep és l'accent del text sobre paper blanc i tint, l'emplenament clar. Cada combinació fixa aquestes quatre entrades i comparteix els tres neutres. Davant del blanc, la banda verd blavosa dona 3,3:1 i la de sorra 2,1:1, un contrast escàs tant per a la lletra blanca sobre la banda com per a la lletra del color de la banda sobre el paper. Per això aquestes dues paletes posen onBand en tinta, i les quatre componen negretes i títols en deep, un to més fosc que dona entre 5,99:1 (sorra) i 8,40:1 (violeta) sobre blanc.

#2 · Enllaça tot el que el motor imprimiria en blau

script.js · línies 68–94al codi complet
const bodyText = { fontFamily: SANS, fontSize: pt(BODY), lineHeight: pt(LEAD),
  color: col('ink'), italicColor: col('ink'), // bold: the times, key terms, boxes (inherited)
  boldColor: col('deep'), referenceColor: col('deep'), textAlign: 'left', firstLineIndent: pt(0) };
const headings = { fontFamily: DISPLAY, color: col('deep'), levels: [
  // The programme opens on a recto.
  { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'odd' },
    marginTop: pt(0), marginBottom: pt(0), advancedDesign: opener },
  { level: 2, fontSize: pt(12.5), lineHeight: lines(1), marginTop: lines(1), marginBottom: pt(0) },
] };
const unorderedLists = { color: col('band'), indent: mm(3.6), gap: mm(1.4),
  marginTop: pt(0), marginBottom: pt(0) };
const chip = { fontSize: pt(7.5), bold: true, borderWidth: pt(0), borderRadius: mm(1.6),
  paddingX: mm(1.3), paddingY: pt(0.9), gap: mm(1) };
const chipStyles = [ // band = a ticket, tint = free: the same code as the grid overleaf
  { id: 'ticket', background: col('band'), color: col('onBand'), ...chip },
  { id: 'free', background: col('tint'), color: col('deep'), ...chip,
    borderWidth: pt(0.6), borderColor: col('band') }, // the outline keeps it off the white
];
const corner = (edge, y) => ({ anchor: { to: 'page', edge }, offset: { x: mm(OUTER), y: mm(y) } });
const furniture = (id, content, edge, y, style) => ({ elements: [{ kind: 'text', id, content,
  parity: 'even', pages: 'body', overflow: 'wrap', placement: corner(edge, y), ...style }] });
const header = furniture('head', '{title} · {subtitle}', 'top-left', 12, // page 2's head
  { ...caps(7.5), color: col('deep') });
const footer = furniture('folio', '{pageNumber}', 'bottom-left', -12, { fontFamily: SANS,
  fontSize: pt(8), fontWeight: 700, color: col('onBand'), box: { backgroundColor: col('band'),
    borderRadius: mm(2.4), padding: { top: mm(0.9), right: mm(2.4), bottom: mm(0.9),
      left: mm(2.4) } } });

El blau del motor és una entrada de la paleta, main-color (#295AA3), i per defecte els títols, la negreta, la cursiva, les remissions, els pics i la capçalera en prenen el color. Aquí cadascun porta un id de paleta: hores i termes clau en negreta deep, cursiva en tinta, pics en band i, a la pàgina 2, la capçalera en deep i el foli en onBand sobre una píndola band. retint() dona a més a main-color el color de la banda; com que aquesta configuració fixa tots els colors, en aquestes pàgines no canvia res, però un estil que s'afegeixi després sense color prendrà la banda en lloc del blau. El requadre d'entrades no fixa un color propi per a la negreta, així que hereta bodyText.boldColor amb el seu id de paleta, i la seva negreta canvia amb cada combinació.

#3 · Dibuixa la il·lustració amb caixes de disseny

script.js · línies 48–64al codi complet
const text = (id, content, x, y, width, style) => ({ kind: 'text', id, content, align: 'left',
  overflow: 'wrap', color: col('onBand'), placement: { anchor: { to: 'page', edge: 'top-left' },
    offset: { x: mm(x), y: mm(y) }, size: { width: mm(width) } }, ...style });
const opener = { enabled: true,
  minHeight: lines(18), // 85.1 mm: text 7 mm under the band (2.4 mm with the band box alone)
  slot: { elements: [
    { kind: 'box', id: 'band', style: { backgroundColor: col('band') },
      placement: { anchor: { to: 'bleed', edge: 'top-left' },
        size: { width: 'fill', height: mm(BAND) } } },
    ...waveform(), // boxes filled with col('tint'): one more link the palette decides
    text('kicker', '{attr.kicker}', INNER, 14, 150, caps(8)),
    text('title', '{titleText}', INNER, 20, TRIM - INNER - OUTER, { fontFamily: DISPLAY,
      fontSize: pt(46), fontWeight: 800, lineHeight: 0.92 }),
    text('standfirst', '{attr.standfirst}', INNER, 71, 92, { fontFamily: SANS, fontSize: pt(10),
      lineHeight: 1.36 }),
  ] },
};

L'obertura és una ranura de disseny amb una caixa a sang pel límit superior, 29 barres arrodonides per a l'ona i tres textos: el mateix títol, més l'avanttítol i l'entradeta, que surten dels seus atributs. Les barres són caixes i no un SVG, així que el seu emplenament és un altre enllaç a tint que segueix la paleta; un SVG caldria redibuixar-lo i registrar-lo de nou per a cada combinació. Amb la caixa de la banda sola, el text començaria a la línia de la retícula de base que queda 2,4 mm per sota; minHeight, 18 línies o 85,1 mm sota el marge superior, reserva més espai i baixa la primera línia a 7 mm de la banda.

#4 · Deixa que la paleta ompli la taula

script.js · línies 176–199al codi complet
const DAYS = t({ en: ['Sat 12', 'Sun 13', 'Mon 14', 'Tue 15', 'Wed 16', 'Thu 17', 'Fri 18'],
  es: ['Sáb 12', 'Dom 13', 'Lun 14', 'Mar 15', 'Mié 16', 'Jue 17', 'Vie 18'] });
const WEEK = [ // t: a ticketed concert, f: a free event, one mark a day from Saturday
  [t({ en: 'Quay Stage', es: 'Escenario del Muelle' }), 't.f.fft'],
  [t({ en: 'Iron Bridge steps', es: 'Escalinata del Puente' }), 'f.....f'],
  [t({ en: 'Market Hall', es: 'Mercado de Abastos' }), '.f...f.'],
  [t({ en: 'St Clare’s Cloister', es: 'Claustro de Santa Clara' }), '.t.....'],
  [t({ en: 'Tannery Yard', es: 'Patio de la Curtiduría' }), '...t...'],
  [t({ en: 'Boathouse', es: 'Casa de las Barcas' }), '.ft..t.'],
];
const fill = { t: col('band'), f: col('tint') }; // cell fills are palette links too
const resources = [{ id: 'week', typeId: 'table', kind: 'table', createdAt: 0, updatedAt: 0,
  placement: { position: 'top', span: 'page' }, // cited on page 1, it heads page 2
  caption: t({ en: 'The week at a glance', es: 'La semana de un vistazo' }),
  note: t({ en: ':swatch{color="band"} ticketed concert   :swatch{color="tint"} free event',
    es: ':swatch{color="band"} concierto con entrada   :swatch{color="tint"} acto gratuito' }),
  altText: t({ en: 'A grid of six venues by seven days; filled squares mark the events.',
    es: 'Una cuadrícula de seis escenarios por siete días; los cuadros rellenos son los actos.' }),
  table: { model: { headerRowCount: 1, columnWidths: [2.6, 1, 1, 1, 1, 1, 1, 1], rows: [
    [{ content: '', isHeader: true, background: col('paper') }, ...DAYS.map((day) => ({
      content: day, isHeader: true, align: 'center' }))],
    ...WEEK.map(([venue, marks]) => [{ content: venue, align: 'right' }, ...[...marks].map((m) =>
      (m === '.' ? { content: '' } : { content: '', background: fill[m] }))]),
  ] } } }];

La graella és un recurs de taula i queda fora de la configuració. Tot i això, els seus emplenaments de cel·la porten ids de paleta, i el motor els resol amb la paleta del document en compondre la taula; els :swatch{color="band"} i :swatch{color="tint"} de la llegenda, a la nota de la taula, es resolen igual. Els xips de la programació fan servir els mateixos dos ids, així que la casella plena, el xip al costat de cada hora i la mostra de la llegenda coincideixen en totes les combinacions.

#5 · Canvia la paleta i torna a compondre

script.js · línies 236–265al codi complet
const NAMES = t({ en: { red: 'Red', teal: 'Teal', violet: 'Violet', sand: 'Sand' },
  es: { red: 'Rojo', teal: 'Verde azulado', violet: 'Violeta', sand: 'Arena' } });
document.getElementById('pages').insertAdjacentHTML('beforebegin', `<section id="editions">
  <div class="desk"><header><p class="kicker">${t({ en: 'Riverside Music Week · proofs',
    es: 'Música en la Ribera · pruebas' })}</p><h2>${TITLE}</h2></header><canvas id="live"
  role="img"></canvas><div class="buttons" role="group"></div></div></section>`);
const paint = (canvas, doc) => renderPageToCanvas(doc.pages[0], doc, canvas,
  { scale: (canvas.clientWidth * Math.min(devicePixelRatio, 2)) / doc.pages[0].width });
const buttons = Object.keys(COLOURWAYS).map((way) => {
  const button = document.querySelector('#editions .buttons')
    .appendChild(Object.assign(document.createElement('button'), { type: 'button' }));
  button.innerHTML = `<canvas></canvas><span>${NAMES[way]}<i>${['band', 'deep', 'tint']
    .map((id) => `<b style="background:${COLOURWAYS[way][id]}"></b>`).join('')}</i></span>`;
  paint(button.firstChild, docs[way]);
  // The same config with another palette on every click; the fonts are loaded by now.
  button.onclick = () => show(way, buildDocument({ markdown, resources }, retint(way)));
  return [way, button];
});
const live = document.getElementById('live');
let shown; // the document on the live page
function show(way, doc) {
  paint(live, (shown = doc));
  live.ariaLabel = `${NAMES[way]}, ${t({ en: 'page 1', es: 'página 1' })}`;
  for (const [id, button] of buttons) button.ariaPressed = String(id === way);
  showPages(doc, { title: `${TITLE} · ${NAMES[way]}` });
}
show('red', docs.red);
new ResizeObserver(() => { // canvases are bitmaps: repaint them at the desk's new size
  paint(live, shown); buttons.forEach(([way, button]) => paint(button.firstChild, docs[way]));
}).observe(live);

Cada botó crida retint(), que assigna les entrades de la combinació a colorPalette en l'únic objecte de configuració, i torna a compondre. El motor resol una configuració una sola vegada i desa el resultat associat a aquest objecte; des de postext 1.25, cada composició comprova abans que l'objecte continua dient el mateix que aleshores, així que un canvi fet en el mateix objecte es resol de nou. Tots els enllaços el segueixen: el text, les llistes, els xips i la barra del peu de taula, i amb ells la banda, l'ona, la capçalera, la píndola del foli i la «tabla 1». Les quatre proves conserven els seus colors quan la paleta torna a canviar, perquè cada document desa els colors amb què es va compondre. El pen les compon amb buildDocumentWithFonts; quan es prem un botó les fonts ja estan carregades, i n'hi ha prou amb buildDocument.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 054 · Retint a whole document from one palette ═══════════
// https://postext.dev/en/cookbook/live-palette-retint
// Code: MIT · Text: original (CC BY 4.0) · Artwork: design boxes generated in code (CC BY 4.0)
// Fonts: Syne, Plus Jakarta Sans (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocument, buildDocumentWithFonts, renderPageToCanvas, defaultResourceTypes,
} from 'https://esm.sh/postext';

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

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: three neutrals every edition shares, four entries each colourway sets
const NEUTRALS = { ink: '#1d1d1f', muted: '#5f5f66', paper: '#ffffff' };
const COLOURWAYS = { // band: colour fields · onBand: type on them · deep: accent type on paper
  red: { band: '#d7263d', onBand: '#ffffff', deep: '#b3122a', tint: '#fcdfe3' },
  teal: { band: '#2a9d8f', onBand: '#1d1d1f', deep: '#17695f', tint: '#d8eeeb' },
  violet: { band: '#6a4c93', onBand: '#ffffff', deep: '#5b3f86', tint: '#e7dff0' },
  sand: { band: '#f4a261', onBand: '#1d1d1f', deep: '#a14a16', tint: '#fde4cf' },
}; // white on teal is 3.3:1 and on sand 2.1:1, so those two set their band type in ink
const HOUSE = { ...NEUTRALS, ...COLOURWAYS.red }; // the house edition: red
// #endregion

// #region answer: every colour is a link to a palette entry; retint() swaps the palette
// col(id) links a colour to a palette entry. The link decides what is printed, in text, lists,
// boxes, chips, captions, table fills, swatches, design slots and references alike; the hex
// beside it (the house red's) only fills the field a colour must have.
const col = (id) => ({ hex: HOUSE[id], model: 'hex', paletteId: id });
const entries = (hexes) => Object.entries(hexes).map(([id, hex]) => ({ id, name: id,
  value: { hex, model: 'hex' } })); // the shape of config.colorPalette
// A colourway is a palette. retint() writes it into the one config; the next build sees the
// change and sets the whole programme in the new colours.
function retint(way) {
  const palette = { ...NEUTRALS, ...COLOURWAYS[way] };
  config.colorPalette = entries({ ...palette, 'main-color': palette.band }); // defaults: band
  return config;
}
// #endregion

const [DISPLAY, SANS, BODY, LEAD] = ['Syne', 'Plus Jakarta Sans', 9.4, 13.4]; // pt: 33 lines
const [TRIM, TOP, BOTTOM, INNER, OUTER, GUTTER] = [200, 22, 22, 17, 15, 6]; // mm: square, mirrored
const BAND = 100; // mm, trim top to the colour field's foot ('bleed' is the trim: no cut lines)
const lines = (n) => pt(n * LEAD);
const caps = (size) => ({ fontFamily: SANS, fontSize: pt(size), fontWeight: 700,
  letterSpacing: pt(size * 0.16), textTransform: 'uppercase' });

// #region opener: the colour field, a waveform of palette-linked boxes, the title on top
const text = (id, content, x, y, width, style) => ({ kind: 'text', id, content, align: 'left',

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

#Deixa la negreta en tinta

Reserva l'accent per als títols, els pics i els xips, i posa les hores i els termes clau en el color del text.

-  boldColor: col('deep'), referenceColor: col('deep'), textAlign: 'left', firstLineIndent: pt(0) };
+  boldColor: col('ink'), referenceColor: col('deep'), textAlign: 'left', firstLineIndent: pt(0) };

#Dona a cada part d'un llibre el seu propi color

Si el color canvia d'una part a una altra dins del mateix document, consulta Parts en color amb un sol atribut.

Errors freqüents

  • Una imatge conserva els colors amb què es va dibuixar. Un SVG o una fotografia no segueixen la paleta; per això l'ona està feta de caixes de disseny.
  • Un id que la paleta no té recorre a l'hex escrit al seu costat. Si t'equivoques en escriure un paletteId, aquest color es queda en el vermell de la casa en totes les combinacions.

Crèdits

Text
Text original, CC BY 4.0
Fonts
Syne (SIL OFL 1.1) · Plus Jakarta Sans (SIL OFL 1.1)
Sandbox