En pocas palabras
Dile a la maquetación qué parte de cada foto tiene que verse siempre. Cuando a una columna le faltan unas líneas, la foto se alarga en lugar de dejar un hueco.
Lo que vas a componer
Tres páginas de una revista de costa: un reportaje sobre los oficios de un pueblo de ría, con una foto a sangre en la apertura y cinco fotos en las columnas. La receta compone el reportaje dos veces con el mismo texto. En la primera las fotos conservan la forma de su archivo, y en la página 2 las dos columnas se quedan una línea por encima de la rejilla: la izquierda bajo su último párrafo, la derecha encima de la foto del pie. En la segunda cada foto dice qué parte del encuadre tiene que verse siempre, y el motor recorta fuera de ella: en la misma página la mariscadora y la redeira crecen una línea cada una y las dos columnas terminan en la última línea de la rejilla. Nadie ha tenido que elegir los recortes.
Esta receta responde a
- ¿Cómo dejo que una foto se recorte para llenar una columna corta sin que su motivo salga nunca del encuadre?
- ¿Cómo consigo columnas a ras del pie y una última página equilibrada (justificación vertical)?
- ¿Cómo decido dónde va una figura: en la cabeza de la página, a lo ancho de las dos columnas, justo aquí o al margen?
La respuesta corta
// Each photo names the rectangle that must always show, in fractions of the file:
// x and width of its width, y and height of its height. Outside it the engine may crop,
// so the photo can stand taller (sides cut, down to the area's width) or lower (top and
// bottom cut, down to its height) than the file, always as wide as its column.
const SAFE_AREAS = {
mariscadora: { x: 0.2, y: 0.36, width: 0.34, height: 0.46 }, // Carmen, her rake and basket
redeira: { x: 0.34, y: 0.14, width: 0.4, height: 0.66 }, // Rosa and the net in her lap
carpintero: { x: 0.12, y: 0.2, width: 0.64, height: 0.62 }, // Manuel and the whole hull
faro: { x: 0.34, y: 0.14, width: 0.32, height: 0.56 }, // the tower and the walker below it
pulpeira: { x: 0.2, y: 0.08, width: 0.56, height: 0.82 }, // Lucía, the octopus, the cauldron
};
// Columns end flush on this grid by whole lines. A heading or a photo that does not fit a
// column's foot leaves lines empty there; these settings forbid the usual fixes (space above
// a heading, under a photo, or a paragraph run long), so only a photo with a safe area can
// take them, by growing a line at a time. Without safe areas the short columns stay short.
const balancing = { enabled: true, maxLinesPerHeading: 0, stretchAfterLists: false,
stretchAfterFloats: false, looseParagraphs: false };
Ingredientes
- Funciones
- Zona segura de la imagenEquilibrado de columnasColocación de figurasFiguras y tablas como recursosCitas que colocan las figurasFiguras justo aquíEstilo de los piesTipos de recurso propiosAperturas diseñadasImágenes en los diseños de páginaAtributos de títuloUna o dos columnasMárgenes simétricosCabeceras y foliosCabeceras según el tipo de páginaPaleta de color semánticaEstilos de párrafoPáginas en un canvasExportación a PDF
- También usa
- Figura y Tabla en tu idiomaBanda de capítulo a todo el anchoFuentes incrustadas en el PDF
- Tipografía
- Newsreader, Archivo, Archivo Narrow (SIL OFL 1.1)
- Recursos
carpintero-1600.jpgestuario-1700.jpgfaro-1600.jpgmariscadora-1600.jpgpulpeira-1600.jpgredeira-1600.jpg- La ría en bajamar al amanecer, con mariscadoras (Generated With Diffusion Models, original)
- Una mariscadora de rodillas en la arena mojada (Generated With Diffusion Models, original)
- Una redeira en el muelle (Generated With Diffusion Models, original)
- Un carpintero de ribera cepillando una barca en su nave (Generated With Diffusion Models, original)
- Un faro sobre una punta de granito y una caminante a sus pies (Generated With Diffusion Models, original)
- Una pulpeira sacando un pulpo de un caldero de cobre en el mercado (Generated With Diffusion Models, original)
Elaboración
#1 · Marca lo que tiene que quedar, nada más
El código es la respuesta corta de arriba. La zona segura son cuatro fracciones de la imagen, medidas desde su esquina superior izquierda. El motor puede mostrar la foto con cualquier forma entre el archivo entero y ese rectángulo, siempre con el ancho de su columna: más alta si recorta los lados, más baja si recorta arriba y abajo. Lo que queda fuera se recorta en proporción a los márgenes de cada lado, así que Rosa, a la derecha del centro en el muelle, sigue a la derecha cuando se cortan los lados.
#2 · Que el equilibrado solo tire de las fotos
La misma región configura el equilibrado. Sus recursos habituales añaden blanco: una línea sobre un título, aire bajo una foto, un párrafo una línea más largo. Aquí están apagados, para que la composición sin zonas seguras muestre cada columna corta tal como queda. Una foto con zona segura se prueba antes que cualquiera de ellos, porque una foto más alta no abre ningún hueco en el texto.
#3 · La zona segura es del recurso
const FILES = { estuario: [1700, 1133] }; // px, declared as they are; the rest 1600 × 1067
// Caption and alt text of each photo, one block per photo: content.figures.<lang>.md.
const figureTexts = String.raw`mariscadora
Carmen Lago separa berberechos en su parcela de la ría, en bajamar.
Una mujer con botas verdes, de rodillas en la arena mojada junto a un rastro y una cesta.
redeira
Rosa Doval remienda un paño de cerco en el muelle.
Una mujer sentada en un taburete cose una red verde; detrás, barcos de pesca.
carpintero
Manuel Barreiro cepilla el forro de la gamela.
Un hombre mayor cepilla el costado de una barca de madera a medio construir.
faro
La punta de Arnela: el faro y el camino de la costa.
Un faro blanco sobre rocas de granito; abajo, una caminante con mochila roja.
pulpeira
Lucía Fraga saca un pulpo del caldero de cobre.
Una mujer con mandil saca un pulpo cocido de un caldero de cobre humeante.
`;
const CAPTIONS = Object.fromEntries(figureTexts.trim().split(/\n\s*\n/)
.map((block) => block.split('\n').map((line) => line.trim()))
.map(([id, caption, alt]) => [id, [caption, alt]]));
const PLACEMENT = { pulpeira: { position: 'here' } }; // the rest float to the first free slot
const photo = (id, safe) => {
const [w, h] = FILES[id] ?? [1600, 1067];
const [caption, alt] = CAPTIONS[id] ?? [];
return { id, typeId: 'figure', kind: 'bitmap', createdAt: 0, updatedAt: 0,
bitmap: { fileId: `${id}-${w}.jpg`, format: 'jpeg', width: w, height: h },
...(caption && { caption, altText: alt, placement: PLACEMENT[id] ?? { position: 'auto' } }),
...(safe && SAFE_AREAS[id] && { safeArea: SAFE_AREAS[id] }) };
};
const resources = (safe) => ['estuario', ...Object.keys(CAPTIONS)].map((id) => photo(id, safe));
safeArea está en el recurso, junto a su archivo, su pie y su colocación, de modo que la foto la conserva flote donde flote y en cualquier documento que la use. La receta la pasa o la omite, y esa es la única diferencia entre las dos composiciones. La ría de la apertura la dibuja el estilo del encabezado y no es un flotante, así que no la necesita.
#4 · Compón las dos y compáralas
const build = (safe) => buildDocumentWithFonts({ markdown, resources: resources(safe) }, config(),
kitFonts(FONTS));
const docs = { plain: await build(false), safe: await build(true) };
Los dos documentos salen de la misma configuración y del mismo Markdown. Solo las páginas que continúan se llenan hasta el pie: en la página 3, la última del reportaje, las columnas solo tienen que acabar a la misma altura. Sin zonas seguras la segunda termina una línea antes que la primera; con ellas la foto del pulpo crece esa línea y las dos acaban igualadas. El botón del PDF compone la versión que está sobre la mesa, y el PDF recorta cada foto a su marco de la misma manera.
La receta completa
// ═══ Postext Cookbook · Nº 116 · Photos that grow to fill a short column ═══════════
// https://postext.dev/en/cookbook/photos-fill-short-columns
// Code: MIT · Text: original (CC BY 4.0) · Photos: diffusion models
// Fonts: Newsreader, Archivo, Archivo Narrow (SIL OFL 1.1) · Needs postext ≥ 1.25.0
//
// A magazine feature set twice. Without safe areas some columns end short; with them the
// engine crops each photo outside its area to set it taller, and the photos fill those lines.
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage, defaultResourceTypes,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'es'; // @lang: the language of the sample document ('es' | 'en')
const RECIPE = 'photos-fill-short-columns';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: six named colours, the accents taken from the photos: sea slate, net green
const palette = {
ink: '#1d2326', // text: a cold near-black
sea: '#2f5d73', // the accent: kicker, caption labels, folios, references
net: '#3f6b55', // the second colour: the opener's rule
rule: '#c9d1d3', // hairlines
muted: '#5f6a6e', // running heads, credits, the colophon
paper: '#ffffff',
};
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' } })),
// The engine's defaults link to 'main-color': pointed at the accent, no default blue shows.
{ id: 'main-color', name: 'sea (defaults)', value: { hex: palette.sea, model: 'hex' } },
];
// #endregion
const [TEXT, DISPLAY, LABEL] = ['Newsreader', 'Archivo', 'Archivo Narrow'];
const LEAD = 13.6; // body leading in pt: the grid the photos grow by
const [PAGE_W, PAGE_H, TOP, BOTTOM, INNER, OUTER, GUTTER] = [225, 297, 22, 22, 18, 16, 7]; // mm
const PHOTO_H = 150; // the opener's bleed photo: 225 × 150 mm, the shape of the file
const at = (to, edge, x, y, size) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
...(size && { size }) });
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 }); // the running heads ask for an ellipsis instead
const caps = (size) => ({ fontWeight: 700, textTransform: 'uppercase',
letterSpacing: pt(size * 0.18) });
// #region answer: a safe area per photo, and balancing that may only grow pictures
// Each photo names the rectangle that must always show, in fractions of the file:
// x and width of its width, y and height of its height. Outside it the engine may crop,
// so the photo can stand taller (sides cut, down to the area's width) or lower (top and
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
#Mantén una foto en línea junto a su texto
Una foto con position: 'here' y zona segura se recorta por arriba y por abajo cuando es un poco más alta que el hueco que le queda en su columna, en lugar de pasar a la siguiente.
-const PLACEMENT = { pulpeira: { position: 'here' } }; // the rest float to the first free slot
+const PLACEMENT = { pulpeira: { position: 'here' }, faro: { position: 'here' } };#Devuelve al equilibrado sus otros recursos
Con los valores por defecto las fotos siguen yendo primero, y los títulos y los flotantes toman lo que la zona segura de una foto no alcanza.
-const balancing = { enabled: true, maxLinesPerHeading: 0, stretchAfterLists: false,
- stretchAfterFloats: false, looseParagraphs: false };
+const balancing = { enabled: true };Errores frecuentes
- Una zona segura que cubre la imagen entera, o con un lado menor que el 2 % de ella, no se tiene en cuenta: la foto se muestra completa, como sin ella.
- Solo crecen los flotantes de columna y las fotos en línea. Una foto flotante a lo ancho de las dos columnas mantiene su forma, porque al crecer empujaría a la vez todas las columnas que tiene debajo.
Créditos
- Receta
- Ignacio Ferro
- Texto
- El reportaje, los pies y el colofón, en español y en inglés; Arnela y sus vecinos son imaginarios · Postext Cookbook · CC BY 4.0
- Imágenes
- La ría en bajamar al amanecer, con mariscadoras · Generated With Diffusion Models · original
- Una mariscadora de rodillas en la arena mojada · Generated With Diffusion Models · original
- Una redeira en el muelle · Generated With Diffusion Models · original
- Un carpintero de ribera cepillando una barca en su nave · Generated With Diffusion Models · original
- Un faro sobre una punta de granito y una caminante a sus pies · Generated With Diffusion Models · original
- Una pulpeira sacando un pulpo de un caldero de cobre en el mercado · Generated With Diffusion Models · original
- Fuentes
- Newsreader (SIL OFL 1.1) · Archivo (SIL OFL 1.1) · Archivo Narrow (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)


