Saltar al contenido principal
Receta número 37

Recetario · Capítulo 9 · Publicaciones completas

Memoria anual con columnas a ras

La memoria anual de una cooperativa energética a dos columnas que acaban en la misma línea, con un recuadro de cifras a lo ancho y la última página igualada.

  • Muestra en inglés: aún no hay edición en español
  • Formato 210 × 280 mm
  • 2 columnas, medianil de 7 mm
  • Brygada 1918 9,4/13,4
  • Epilogue
  • Spline Sans Mono
  • 5 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 169 ms
  • 250 líneas de código

En pocas palabras

El informe anual de una pequeña cooperativa de energía, en dos columnas. Enseña a hacer que las dos columnas de texto terminen exactamente a la misma altura.

Lo que vas a componer

La memoria de 2025 de Tidewell Community Energy, una cooperativa inventada con dos aerogeneradores, un huerto solar y paneles en 21 tejados. Cinco páginas de 210 × 280 mm, en inglés. En la cubierta, dos cintas dibujan mes a mes la producción eólica y la solar bajo un «2025» de 150 pt. Siguen la carta de la presidenta, el informe de explotación y las cuentas, a dos columnas justificadas de Brygada 1918 sobre una rejilla de 50 líneas. Las columnas llenas acaban en la última línea, y las cortas, a la altura de su vecina. Un recuadro de tres cifras cruza la página de la carta, y una nota flotante sobre los contadores abre la página 4. En la página de cierre, las columnas acaban juntas sobre la cuenta de resultados. Un atributo palette tiñe de verde azulado las páginas de explotación y de rojo ladrillo la de cuentas.

Esta receta responde a

  • ¿Cómo consigo columnas a ras del pie y una última página equilibrada (justificación vertical)?
  • ¿Cómo pongo un recuadro que cruce las dos columnas a media página, como un panel de cifras en tres bloques?
  • ¿Cómo llevo un recuadro a la cabeza o al pie de la página sin que el texto deje de llenarla?
  • ¿Cómo hago una tabla con filas de cabecera, celdas combinadas, anchos de columna y alineación por celda?
  • ¿Cómo divido un libro en partes o secciones, cada una con su color y su portadilla?

La respuesta corta

script.js · líneas 41–58en el código completo
// 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

Ingredientes

Tipografía
Brygada 1918, Epilogue, Spline Sans Mono, Mrs Saint Delafield (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Todo sobre la rejilla, y las palancas cierran los huecos

El código es la respuesta corta de arriba. La caja de texto mide exactamente 50 líneas de 13,4 pt, y el margen inferior (21,6 mm) se calcula a partir de esa altura. Cada ladillo ocupa una línea de la rejilla encima y otra propia, así que una columna que acaba corta se queda corta en líneas enteras, que es lo que añade el equilibrado de columnas. En la página 3, el párrafo de tres líneas sobre el granizo pasa entero a la página 4 por avoidOrphans, el ajuste con el que Postext impide que la última línea de un párrafo quede sola en la cabeza de una columna (la línea viuda de los manuales españoles), y la columna derecha se queda dos líneas corta. Con maxLinesPerHeading: 1, una de esas líneas va al espacio sobre The Saltings and the roofs y la otra queda para la palanca siguiente, que la pone tras la lista de tejados. Por defecto, un título toma hasta dos líneas antes de que se prueben las palancas que le siguen (maxLinesBeforeLoose), y hasta cuatro cuando a estas no les queda nada que dar, así que las dos irían sobre el título.

#2 · Iguala el texto sobre un recuadro que cruza la página

script.js · líneas 101–109en el código completo
// 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 recuadro con span="page" parte en bandas una página a dos columnas. En la página 2, la carta se corta en ocho líneas por columna encima del recuadro y sigue debajo en las dos columnas. Dentro, :::columns{count=3 breaks="3,5"} abre la segunda y la tercera columna en la segunda y la tercera cifra (los bloques tercero y quinto del grupo), en lugar de cortar donde las columnas quedarían más igualadas. El estilo de párrafo figure compone esas cifras a 26 pt, y su boldColor las pone en amarillo.

#3 · Haz flotar un recuadro a la cabeza de la página siguiente

script.js · líneas 113–122en el código completo
// 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 } };

En el Markdown, la nota sobre los contadores va tras el primer párrafo sobre Harrow Down, en la página 3, pero placement="top" la saca del flujo y la coloca en la cabeza de la página siguiente. El informe llena el resto de la página 3, y la página 4 se abre con el recuadro sobre las dos columnas. Debajo, la tabla por emplazamiento y el gráfico de anillo, ambos con position: 'top', encabezan una columna cada uno, una línea de la rejilla más abajo de lo que quedarían sin los 3,5 mm de relleno inferior del recuadro.

#4 · Da a cada sección su color sin portadilla

script.js · líneas 14–27en el código completo
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' } }));

Con parts: { page: false }, una línea como :::part{number="02" title="Operations" palette="band=#1c6e67"} no abre página. Da nombre a la sección en la franja de apertura y junto al folio, y cambia band en todas las páginas hasta la parte siguiente. Las franjas, los ladillos, las viñetas de la lista, las etiquetas de los pies y el filete de la nota toman band, así que las páginas de explotación salen en verde azulado y la de cuentas en rojo ladrillo, mientras la carta conserva el azul mar de base (colores por parte).

#5 · Construye las tablas con los datos e iguala la última página

script.js · líneas 170–219en el código completo
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() convierte DATA.accounts en la cuenta de resultados fila a fila. Una etiqueta que empieza por = imprime en negrita, sobre el tinte, la suma acumulada de cada año. Los costes van en negativo en los datos, así que el Operating surplus sale de esa suma sin teclear ningún total. Una etiqueta sin cifras, como Income u Operating costs, pasa a ser una sola celda en cursiva a lo ancho de la tabla, combinada con mergeCells, que escribe también las celdas ocultas que necesita cada combinación. En la página 5, la cuenta va como flotante a lo ancho del pie, bajo el informe de la tesorera, con el que acaba el documento. Sin equilibrado, las columnas llegarían a 12 líneas la izquierda y a 9 la derecha; el corte de cierre deja las dos en 11, y la palanca de títulos añade sobre Cash and reserves la línea que aún le falta a la derecha.

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

El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)

Variantes

#Deja todo el hueco a los títulos

En la página 3, las dos líneas libres van entonces sobre The Saltings and the roofs, y ninguna tras la lista.

-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 el equilibrado

La columna derecha de la página 3 acaba entonces dos líneas corta. En la página 5, la izquierda llega a 12 líneas y la derecha se queda en 9, y la cuenta empieza una línea más abajo.

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

Errores frecuentes

Error frecuente

avoidWidows vigila el pie de la columna, y avoidOrphans, su cabeza

Postext da nombre propio a las dos líneas solas: avoidWidows (widowMinLines, widowPenalty) evita que la primera línea de un párrafo quede sola al pie de una columna, y avoidOrphans (orphanMinLines, orphanPenalty), que la última quede sola en la cabeza de la siguiente. Muchos manuales de estilo usan los dos nombres al revés, así que elige el ajuste por el lugar donde actúa. Los dos vienen activados, salvo en una retícula de caracteres (cjk.grid): ahí avoidWidows viene desactivado, y avoidOrphans también en la región de Japón, para que la página contenga las líneas que su retícula cuenta (desde postext 1.28). Funcionan como penalizaciones: la composición compara cada una con las líneas vacías que dejaría respetarla. Viudas, huérfanas y líneas cortas →

Error frecuente

Las celdas combinadas necesitan hiddenBy: usa mergeCells

Las celdas se colocan según su posición en la fila, así que una celda combinada necesita celdas de relleno marcadas con hiddenBy donde se extiende; omitirlas, como en HTML, desplaza todas las columnas siguientes. Combina celdas con mergeCells. Desde postext 1.5 una tabla con una rejilla irregular se anota en doc.contentWarnings como raggedTableGrid, y parseTSV(texto, { headerRows }) marca las filas de cabecera. Tablas a partir de datos →

  • Si las columnas de la página de cierre difieren en una sola línea, se quedan así, con la izquierda una línea más larga, como las dejaría un cajista; el corte de cierre solo actúa con dos líneas de diferencia o más. Para que acaben juntas, alarga o acorta el texto en una línea.
  • La cuenta de resultados pone los costes entre paréntesis. Para alinear con ellos las cifras positivas, la receta cierra cada cifra positiva con un espacio de no separación, que en una letra monoespaciada mide lo mismo que el paréntesis de cierre; una celda de tabla conserva ese espacio al final de su texto.

Créditos

Texto
Texto original, CC BY 4.0
Fuentes
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