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
// 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
- Funciones
- Equilibrado de columnasRecuadros a todo el anchoColumnas en un recuadro o en el textoRecuadros flotantesColores por parteViudas, huérfanas y líneas cortasCorte de líneas óptimo (Knuth–Plass)Colocación de figurasPaleta de color semánticaRecuadrosTablas a partir de datosEstilos de tabla con nombreEstilo de tablasRellenos de celdaEstilo de los piesTipos de recurso propiosFiguras y tablas como recursosCubiertas, portadas y colofones
- También usa
- Citas que colocan las figurasAtributos de títuloEstilos de títuloFiguras justo aquíBanda de capítulo a todo el anchoAperturas diseñadasEstilos de párrafoPortadillas de parteCabeceras por secciónSaltos de línea en los títulos
- 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
// 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
// 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
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
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
// ═══ 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 →
- 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
- Receta
- Ignacio Ferro
- 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)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


