Saltar al contingut principal
Recepta número 37

Receptari · Capítol 9 · Publicacions completes

Memòria anual amb columnes arran

La memòria anual d'una cooperativa energètica a dues columnes que acaben a la mateixa línia, amb un requadre de xifres a tot l'ample i l'última pàgina igualada.

  • Mostra en anglès: encara no hi ha edició en català
  • Format 210 × 280 mm
  • 2 columnes, espai entre columnes de 7 mm
  • Brygada 1918 9,4/13,4
  • Epilogue
  • Spline Sans Mono
  • 5 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 169 ms
  • 250 línies de codi

En poques paraules

L'informe anual d'una petita cooperativa d'energia, en dues columnes. Ensenya a fer que les dues columnes de text acabin exactament a la mateixa alçada.

Què compondràs

La memòria de 2025 de Tidewell Community Energy, una cooperativa inventada amb dos aerogeneradors, un hort solar i plaques a 21 teulades. Cinc pàgines de 210 × 280 mm, en anglès. A la coberta, dues cintes dibuixen mes a mes la producció eòlica i la solar sota un «2025» de 150 pt. Segueixen la carta de la presidenta, l'informe d'explotació i els comptes, a dues columnes justificades de Brygada 1918 sobre una retícula de 50 línies. Les columnes plenes acaben a l'última línia, i les curtes, a l'altura de la del costat. Un requadre de tres xifres travessa la pàgina de la carta, i una nota flotant sobre els comptadors obre la pàgina 4. A la pàgina de tancament, les columnes acaben juntes sobre el compte de resultats. Un atribut palette tenyeix de verd blavós les pàgines d'explotació i de vermell maó la de comptes.

Aquesta recepta respon a

  • Com aconsegueixo columnes arran del peu i una última pàgina equilibrada (justificació vertical)?
  • Com poso un requadre que travessi les dues columnes a mitja pàgina, com un tauler de xifres en tres blocs?
  • Com porto un requadre al capdamunt o al peu de la pàgina sense que el text deixi d'omplir-la?
  • Com faig una taula amb files de capçalera, cel·les combinades, amplades de columna i alineació per cel·la?
  • Com divideixo un llibre en parts o seccions, cadascuna amb el seu color i la seva portadella?

La resposta curta

script.js · línies 41–58al codi complet
// The text block is LINES lines of LEAD deep (MARGIN.bottom is derived from them) and every
// heading takes whole lines, so a column the break rules leave short is short by whole lines.
// Balancing (on by default) stretches it back to its foot with its levers, in this order: a
// box that closes the column moves down to it; a picture with a safe area grows; lines above
// the headings, two each at most (maxLinesBeforeLoose); one line where a list ends; one under
// a display formula or a box, then under a float at the column head; a paragraph set one line
// longer and looser, with up to maxTracking of tracking; last, the lines a heading may still
// take, up to maxLinesPerHeading. A closing band whose columns differ by more than a line is
// cut level instead (trailing), and so is the band a page-wide box leaves when it has to move
// on to the next page (beforeSpan).
const balancing = { maxLinesPerHeading: 1 }; // one line per heading; the next lever takes more
const flowText = { // justification, hyphenation and Knuth–Plass stay at their defaults (on)
  fontFamily: 'Brygada 1918', fontSize: pt(9.4), lineHeight: pt(LEAD),
  firstLineIndent: mm(4), indentAfterHeading: false,
  minWordSpacing: 0.7, maxWordSpacing: 1.8, // word spaces 0.7–1.8 of normal (defaults 0.6–2)
};
const onGrid = { lineHeight: pt(LEAD), marginTop: pt(LEAD), marginBottom: pt(0) }; // one line
// hook-up: headings: { balancing, levels: [..., { level: 2, ...onGrid }] }, bodyText: flowText

Ingredients

Tipografia
Brygada 1918, Epilogue, Spline Sans Mono, Mrs Saint Delafield (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Tot sobre la retícula, i les palanques tanquen els buits

El codi és la resposta curta de dalt. La caixa de text fa exactament 50 línies de 13,4 pt, i el marge inferior (21,6 mm) es calcula a partir d'aquesta alçada. Cada intertítol ocupa una línia de la retícula a sobre i una altra de pròpia, així que una columna que acaba curta es queda curta en línies senceres, que és el que afegeix l'equilibratge de columnes. A la pàgina 3, el paràgraf de tres línies sobre la calamarsa passa sencer a la pàgina 4 per avoidOrphans, el paràmetre amb què Postext impedeix que l'última línia d'un paràgraf quedi sola al cap d'una columna (la línia vídua dels manuals espanyols), i la columna dreta es queda dues línies curta. Amb maxLinesPerHeading: 1, una d'aquestes línies va a l'espai sobre The Saltings and the roofs i l'altra queda per a la palanca següent, que la posa després de la llista de teulades. Per defecte, un títol pren fins a dues línies abans que es provin les palanques que el segueixen (maxLinesBeforeLoose), i fins a quatre quan a aquestes no els queda res per donar, així que totes dues anirien sobre el títol.

#2 · Iguala el text sobre un requadre que travessa la pàgina

script.js · línies 101–109al codi complet
// In the Markdown: :::callout{type="figures" span="page"} around :::columns{count=3 breaks="3,5"},
// each number a :::paragraphs{style="figure"} of **8.47 GWh**, then its line of text.
const figures = { id: 'figures', background: col('ink'), columnGap: mm(GUTTER),
  padding: { top: mm(5), right: mm(5), bottom: mm(5), left: mm(5) },
  marginTop: pt(LEAD), marginBottom: pt(LEAD), titleStyle: { ...boxTitle, color: col('sun') },
  body: { fontFamily: 'Epilogue', fontSize: pt(9), lineHeight: pt(12), color: col('paper'),
    ...boxText } };
const bigNumber = { id: 'figure', fontFamily: 'Epilogue', fontSize: pt(26), lineHeight: pt(31),
  color: col('paper'), boldColor: col('sun'), ...boxText };

Un requadre amb span="page" parteix en bandes una pàgina a dues columnes. A la pàgina 2, la carta es talla en vuit línies per columna damunt del requadre i continua a sota a les dues columnes. A dins, :::columns{count=3 breaks="3,5"} obre la segona i la tercera columna a la segona i la tercera xifra (els blocs tercer i cinquè del grup), en lloc de tallar on les columnes quedarien més igualades. L'estil de paràgraf figure compon aquestes xifres a 26 pt, i el seu boldColor les posa en groc.

#3 · Fes flotar un requadre al cap de la pàgina següent

script.js · línies 113–122al codi complet
// In the Markdown: :::callout{type="aside" span="page" placement="top"}. It leaves the flow
// where it stands and takes the head of the next page the flow opens; the text goes on
// filling this one. It has a stripe in the section's colour and no fill. The padding under
// the text drops the floats below the box by a grid line, so they stand clear of it.
const aside = { id: 'aside', backgroundEnabled: false, columnGap: mm(GUTTER),
  stripe: { enabled: true, side: 'top', width: pt(2.5), color: col('band') },
  padding: { top: mm(3.5), right: pt(0), bottom: mm(3.5), left: pt(0) },
  titleStyle: { ...boxTitle, color: col('band') },
  body: { fontFamily: 'Epilogue', fontSize: pt(8.6), lineHeight: pt(12.2), color: col('ink'),
    ...boxText } };

Al Markdown, la nota sobre els comptadors va després del primer paràgraf sobre Harrow Down, a la pàgina 3, però placement="top" la treu del flux i la col·loca al cap de la pàgina següent. L'informe omple la resta de la pàgina 3, i la pàgina 4 s'obre amb el requadre sobre les dues columnes. A sota, la taula per emplaçament i el gràfic d'anell, tots dos amb position: 'top', encapçalen una columna cadascun, una línia de la retícula més avall del que quedarien sense els 3,5 mm de farciment inferior del requadre.

#4 · Dona a cada secció el seu color sense portadella

script.js · línies 14–27al codi complet
const palette = {
  ink: '#14202b', // text: a blue-black
  band: '#0b5d7a', // sea, overridden by palette="band=#…" on the :::part fences
  wind: '#3aa6a0', sun: '#f2b134', coral: '#e2674b', // the data colours of the charts
  tint: '#eef3f5', // subtotal rows
  rule: '#c9d3d9', // hairlines
  muted: '#566370', // captions' notes and the running feet
  mist: '#9fb1bd', // small print on the ink cover
  paper: '#ffffff',
};
// Every colour is linked to its palette entry, so a :::part recolours it by paletteId.
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' } }));

Amb parts: { page: false }, una línia com :::part{number="02" title="Operations" palette="band=#1c6e67"} no obre pàgina. Dona nom a la secció a la franja d'obertura i al costat del foli, i canvia band a totes les pàgines fins a la part següent. Les franges, els intertítols, els pics de la llista, les etiquetes dels peus i el filet de la nota prenen band, així que les pàgines d'explotació surten en verd blavós i la de comptes en vermell maó, mentre la carta conserva el blau mar de base (colors per part).

#5 · Construeix les taules amb les dades i iguala l'última pàgina

script.js · línies 170–219al codi complet
const DATA = {
  // Output in MWh at the export meter, January to December 2025.
  wind: [560, 520, 450, 330, 270, 210, 190, 150, 300, 420, 480, 540], // Harrow Down
  sun: [90, 160, 300, 440, 560, 600, 580, 500, 380, 250, 120, 70], // the Saltings + 21 roofs
  // The turbines' year, % of the hours of both machines: [label, share, palette colour].
  hours: [['generating', 78.0, 'wind'], ['waiting for wind', 16.8, 'rule'], ['bearing repair', 2.6,
    'coral'], ['servicing and grid', 1.8, 'sun'], ['stopped for bats', 0.8, 'ink']],
  // Output by site in MWh: [site, source, capacity in MW, 2025, 2024].
  sites: [['Harrow Down', 'wind', 1.8, 4420, 4560], ['The Saltings', 'solar', 3.2, 3190, 2640],
    ['21 roofs', 'solar', 0.9, 860, 790]],
  // £ thousand, [label, 2025, 2024]; a label alone opens a group, '=' prints the running sum.
  accounts: [['Income'], ['Electricity sold under the power purchase agreement', 760, 722],
    ['Electricity sold to roof hosts', 92, 85], ['Feed-in tariff', 236, 229], ['=Total income'],
    ['Operating costs'], ['Operation and maintenance', -231, -198],
    ['Rent, rates and insurance', -158, -151], ['Staff and administration', -121, -112],
    ['Depreciation', -286, -286], ['=Operating surplus'],
    ['Interest on the Harrow Down loan', -54, -66], ['Interest on members’ shares at 3.5%', -113,
      -107], ['Grants to the Tidewell Fund', -84, -70], ['Corporation tax', -5, -7],
    ['=Surplus for the year']],
};
const fill = { background: col('tint') }; // totals sit on a tint between two hairlines
const right = (content, extra) => ({ content, align: 'right', ...extra });
const figure = (n, digits = 0) => n.toLocaleString('en-GB', { minimumFractionDigits: digits });
const head = (c, i) => (i ? right(c, { isHeader: true }) : { content: c, isHeader: true });
const siteTable = (rows) => ({ headerRowCount: 1, columnWidths: [3, 1, 1.3, 1.3], rows: [
  ['Site', 'MW', '2025', '2024'].map(head),
  ...rows.map(([site, source, mw, ...n]) => [{ content: `${site} *(${source})*` },
    right(figure(mw, 1)), ...n.map((v) => right(figure(v)))]),
  [{ content: '**All sites**', ...fill }, ...[2, 3, 4].map((i, k) => right(`**${figure(rows
    .reduce((sum, row) => sum + row[i], 0), k ? 0 : 1)}**`, fill))]] }); // the totals, summed
// Accounting style: losses in brackets, and gains followed by a no-break space, as wide as a
// bracket in a monospaced face, so the digits line up.
const pad = '\u00a0';
const money = (n) => (n < 0 ? `(${figure(-n)})` : `${figure(n)}${pad}`);
function statement(rows) {
  const sum = [0, 0];
  const cells = [['£ thousand', `2025${pad}`, `2024${pad}`].map(head)];
  for (const [label, ...years] of rows) {
    years.forEach((n, i) => { sum[i] += n; });
    const sub = label.startsWith('='); // a subtotal: the running sum, in bold
    cells.push(sub ? [{ content: `**${label.slice(1)}**`, ...fill },
      ...sum.map((n) => right(`**${money(n)}**`, fill))]
      : [{ content: years.length ? label : `*${label}*` }, // a label alone heads a group
        ...[0, 1].map((i) => right(years.length ? money(years[i]) : ''))]);
  }
  // mergeCells writes the cells a spanning group head hides (gotcha: merged-cells-hiddenby)
  return cells.reduce((model, row, r) => (r && !row[1].content ? mergeCells(model,
    { start: { row: r, col: 0 }, end: { row: r, col: 2 } }) : model),
  { rows: cells, headerRowCount: 1, columnWidths: [5, 1, 1] });
}

statement() converteix DATA.accounts en el compte de resultats fila a fila. Una etiqueta que comença per = imprimeix en negreta, sobre el tint, la suma acumulada de cada any. Els costos van en negatiu a les dades, així que l'Operating surplus surt d'aquesta suma sense teclejar cap total. Una etiqueta sense xifres, com Income o Operating costs, passa a ser una sola cel·la en cursiva a tota l'amplada de la taula, combinada amb mergeCells, que escriu també les cel·les ocultes que necessita cada combinació. A la pàgina 5, el compte va com a flotant a tota l'amplada del peu, sota l'informe de la tresorera, amb què acaba el document. Sense equilibratge, les columnes arribarien a 12 línies l'esquerra i a 9 la dreta; el tall de tancament les deixa totes dues en 11, i la palanca de títols afegeix sobre Cash and reserves la línia que encara li falta a la dreta.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 037 · Annual report with flush columns ═══════════════════════
// https://postext.dev/en/cookbook/annual-report-flush-columns
// Code: MIT · Text: original (CC BY 4.0) · Art: drawn in code · Typefaces: SIL OFL 1.1
// Fonts: Brygada 1918, Epilogue, Spline Sans Mono, Mrs Saint Delafield · Needs postext ≥ 1.28.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage, mergeCells, inlineSvgFonts,
} from 'https://esm.sh/postext';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'annual-report-flush-columns';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: 'band' is the first section's colour; each later :::part brings its own
const palette = {
  ink: '#14202b', // text: a blue-black
  band: '#0b5d7a', // sea, overridden by palette="band=#…" on the :::part fences
  wind: '#3aa6a0', sun: '#f2b134', coral: '#e2674b', // the data colours of the charts
  tint: '#eef3f5', // subtotal rows
  rule: '#c9d3d9', // hairlines
  muted: '#566370', // captions' notes and the running feet
  mist: '#9fb1bd', // small print on the ink cover
  paper: '#ffffff',
};
// Every colour is linked to its palette entry, so a :::part recolours it by paletteId.
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' } }));
// #endregion
const TRIM = { width: 210, height: 280 };
const LEAD = 13.4; // body leading in pt: one line of the baseline grid
const LINES = 50; // grid lines in a full column
const MARGIN = { top: 22, inner: 18, outer: 16 }; // mm, mirrored
MARGIN.bottom = TRIM.height - MARGIN.top - (LINES * LEAD * 25.4) / 72; // 21.6 mm: 50 lines exactly
const GUTTER = 7; // mm between the columns, and between the columns inside the boxes
const mono = { fontFamily: 'Spline Sans Mono', fontWeight: 500, textTransform: 'uppercase' };
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const text = (id, content, look, placement) => ({ kind: 'text', id, content, placement,
  align: 'left', ...look });

// #region answer: flush columns: whole grid lines everywhere, and the balancing levers
// The text block is LINES lines of LEAD deep (MARGIN.bottom is derived from them) and every
// heading takes whole lines, so a column the break rules leave short is short by whole lines.
// Balancing (on by default) stretches it back to its foot with its levers, in this order: a
// box that closes the column moves down to it; a picture with a safe area grows; lines above
// the headings, two each at most (maxLinesBeforeLoose); one line where a list ends; one under
// a display formula or a box, then under a float at the column head; a paragraph set one line
// longer and looser, with up to maxTracking of tracking; last, the lines a heading may still
// take, up to maxLinesPerHeading. A closing band whose columns differ by more than a line is

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 tot el buit als títols

A la pàgina 3, les dues línies lliures van llavors sobre The Saltings and the roofs, i cap després de la llista.

-const balancing = { maxLinesPerHeading: 1 }; // one line per heading; the next lever takes more
+const balancing = {}; // the default: two lines above a heading, then the other levers

#Desactiva l'equilibratge

La columna dreta de la pàgina 3 acaba llavors dues línies curta. A la pàgina 5, l'esquerra arriba a 12 línies i la dreta es queda en 9, i el compte comença una línia més avall.

-const balancing = { maxLinesPerHeading: 1 }; // one line per heading; the next lever takes more
+const balancing = { enabled: false };

Errors freqüents

Error freqüent

avoidWidows vigila el peu de la columna, i avoidOrphans, el capdamunt

Postext dona nom propi a les dues línies soles: avoidWidows (widowMinLines, widowPenalty) evita que la primera línia d'un paràgraf quedi sola al peu d'una columna, i avoidOrphans (orphanMinLines, orphanPenalty), que l'última quedi sola al capdamunt de la següent. Molts manuals d'estil fan servir els dos noms al revés, així que tria l'opció pel lloc on actua. Totes dues vénen activades, tret d'una retícula de caràcters (cjk.grid): allà avoidWidows ve desactivada, i avoidOrphans també a la regió del Japó, perquè la pàgina contingui les línies que la retícula compta (des de postext 1.28). Funcionen com a penalitzacions: la composició compara cadascuna amb les línies buides que deixaria respectar-la. Vídues, òrfenes i línies curtes →

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 →

  • Si les columnes de la pàgina de tancament difereixen en una sola línia, es queden així, amb l'esquerra una línia més llarga, com les deixaria un caixista; el tall de tancament només actua amb dues línies de diferència o més. Perquè acabin juntes, allarga o escurça el text en una línia.
  • El compte de resultats posa els costos entre parèntesis. Per alinear-hi les xifres positives, la recepta tanca cada xifra positiva amb un espai de no separació, que en una lletra monoespaiada fa el mateix ample que el parèntesi de tancament; una cel·la de taula conserva aquest espai al final del text.

Crèdits

Text
Text original, CC BY 4.0
Fonts
Brygada 1918 (SIL OFL 1.1) · Epilogue (SIL OFL 1.1) · Spline Sans Mono (SIL OFL 1.1) · Mrs Saint Delafield (SIL OFL 1.1)
Sandbox