En poques paraules
Digues a la maquetació quina part de cada foto s'ha de veure sempre. Quan a una columna li falten unes línies, la foto s'allarga en lloc de deixar un forat.
Què compondràs
Tres pàgines d'una revista de costa: un reportatge sobre els oficis d'un poble de ria, amb una foto a sang a l'obertura i cinc fotos a les columnes. La recepta compon el reportatge dues vegades amb el mateix text. En la primera, les fotos conserven la forma del seu arxiu, i a la pàgina 2 les dues columnes es queden una línia per sobre de la retícula: l'esquerra sota l'últim paràgraf, la dreta damunt la foto del peu. En la segona, cada foto diu quina part de l'enquadrament s'ha de veure sempre, i el motor en retalla l'exterior: a la mateixa pàgina la marisquera i la remendadora creixen una línia cadascuna i les dues columnes acaben a l'última línia de la retícula. Ningú no ha hagut de triar els retalls.
Aquesta recepta respon a
- Com deixo que una foto es retalli per omplir una columna curta sense que el motiu surti mai de l'enquadrament?
- Com aconsegueixo columnes arran del peu i una última pàgina equilibrada (justificació vertical)?
- Com decideixo on va una figura: al capdamunt de la pàgina, a l'amplada de les dues columnes, just aquí o al marge?
La resposta curta
// 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 };
Ingredients
- Funcions
- Zona segura de la imatgeEquilibri de columnesCol·locació de figuresFigures i taules com a recursosCites que col·loquen les figuresFigures just aquíEstil dels peusTipus de recurs propisObertures dissenyadesImatges als dissenys de pàginaAtributs de títolUna o dues columnesMarges simètricsCapçaleres i folisCapçaleres segons el tipus de pàginaPaleta de color semànticaEstils de paràgrafPàgines en un canvasExportació a PDF
- També fa servir
- Figura i Taula en la teva llenguaBanda de capítol d'amplada completaFonts incrustades al PDF
- Tipografia
- Newsreader, Archivo, Archivo Narrow (SIL OFL 1.1)
- Recursos
carpintero-1600.jpgestuario-1700.jpgfaro-1600.jpgmariscadora-1600.jpgpulpeira-1600.jpgredeira-1600.jpg- The estuary at low water at dawn, with shellfish gatherers (Generated With Diffusion Models, original)
- A shellfish gatherer kneeling on the wet sand (Generated With Diffusion Models, original)
- A net mender on the quay (Generated With Diffusion Models, original)
- A shipwright planing a wooden boat in his shed (Generated With Diffusion Models, original)
- A lighthouse on a granite point and a walker below it (Generated With Diffusion Models, original)
- A cook lifting an octopus from a copper cauldron at a market (Generated With Diffusion Models, original)
Elaboració
#1 · Marca el que s'ha de quedar, res més
El codi és la resposta curta de dalt. La zona segura són quatre fraccions de la imatge, mesurades des del seu angle superior esquerre. El motor pot mostrar la foto amb qualsevol forma entre l'arxiu sencer i aquest rectangle, sempre amb l'amplada de la seva columna: més alta si en retalla els costats, més baixa si en retalla la part de dalt i la de baix. El que queda fora es retalla en proporció als marges de cada costat, de manera que la Rosa, a la dreta del centre al moll, continua a la dreta quan es tallen els costats.
#2 · Que l'equilibrat només estiri de les fotos
La mateixa regió configura l'equilibratge. Els seus recursos habituals afegeixen blanc: una línia sobre un títol, aire sota una foto, un paràgraf una línia més llarg. Aquí estan apagats, perquè la composició sense zones segures mostri cada columna curta tal com queda. Una foto amb zona segura es prova abans que qualsevol d'aquests recursos, perquè una foto més alta no obre cap forat en el text.
#3 · La zona segura és del recurs
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 és al recurs, al costat del seu arxiu, el seu peu i la seva col·locació, de manera que la foto la conserva floti on floti i en qualsevol document que la faci servir. La recepta la passa o l'omet, i aquesta és l'única diferència entre les dues composicions. La ria de l'obertura la dibuixa l'estil del títol i no és un flotant, així que no la necessita.
#4 · Compon-les totes dues i compara-les
const build = (safe) => buildDocumentWithFonts({ markdown, resources: resources(safe) }, config(),
kitFonts(FONTS));
const docs = { plain: await build(false), safe: await build(true) };
Els dos documents surten de la mateixa configuració i del mateix Markdown. Només les pàgines que continuen s'omplen fins al peu: a la pàgina 3, l'última del reportatge, les columnes només han d'acabar a la mateixa altura. Sense zones segures, la segona acaba una línia abans que la primera; amb elles, la foto del pop creix aquesta línia i totes dues acaben igualades. El botó del PDF compon la versió que hi ha damunt la taula, i el PDF retalla cada foto al seu marc de la mateixa manera.
La recepta 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
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
#Mantén una foto en línia al costat del seu text
Una foto amb position: 'here' i zona segura es retalla per dalt i per baix quan és una mica més alta que l'espai que li queda a la columna, en lloc de passar a la següent.
-const PLACEMENT = { pulpeira: { position: 'here' } }; // the rest float to the first free slot
+const PLACEMENT = { pulpeira: { position: 'here' }, faro: { position: 'here' } };#Torna a l'equilibrat els seus altres recursos
Amb els valors per defecte les fotos continuen anant primer, i els títols i els flotants prenen el que la zona segura d'una foto no arriba a cobrir.
-const balancing = { enabled: true, maxLinesPerHeading: 0, stretchAfterLists: false,
- stretchAfterFloats: false, looseParagraphs: false };
+const balancing = { enabled: true };Errors freqüents
- Una zona segura que cobreix la imatge sencera, o amb un costat menor que el 2 % d'aquesta, no es té en compte: la foto es mostra sencera, com sense zona.
- Només creixen els flotants de columna i les fotos en línia. Una foto flotant a l'amplada de les dues columnes manté la seva forma, perquè en créixer empentaria alhora totes les columnes que té a sota.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- The feature, the captions and the colophon, in Spanish and English; Arnela and its people are imaginary · Postext Cookbook · CC BY 4.0
- Imatges
- The estuary at low water at dawn, with shellfish gatherers · Generated With Diffusion Models · original
- A shellfish gatherer kneeling on the wet sand · Generated With Diffusion Models · original
- A net mender on the quay · Generated With Diffusion Models · original
- A shipwright planing a wooden boat in his shed · Generated With Diffusion Models · original
- A lighthouse on a granite point and a walker below it · Generated With Diffusion Models · original
- A cook lifting an octopus from a copper cauldron at a market · Generated With Diffusion Models · original
- Fonts
- Newsreader (SIL OFL 1.1) · Archivo (SIL OFL 1.1) · Archivo Narrow (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


