Saltar al contingut principal
Recepta número 116

Receptari · Capítol 7 · Figures i imatges

Fotos que creixen fins a omplir la columna

Cada foto marca la seva zona segura; l'equilibratge pot retallar-ne l'exterior per allargar-la, i la columna que havia quedat curta acaba arran.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 225 × 297 mm
  • 2 columnes, espai entre columnes de 7 mm
  • Newsreader 9,8/13,6
  • Archivo
  • Archivo Narrow
  • 6 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 84 ms
  • 178 línies de codi

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

script.js · línies 46–62al codi complet
// 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

Tipografia
Newsreader, Archivo, Archivo Narrow (SIL OFL 1.1)
Recursos
  • carpintero-1600.jpg
  • estuario-1700.jpg
  • faro-1600.jpg
  • mariscadora-1600.jpg
  • pulpeira-1600.jpg
  • redeira-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

script.js · línies 210–244al codi complet
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

script.js · línies 254–256al codi complet
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

Sandbox
// ═══ 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

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)
SandboxPDF