Saltar al contenido principal
Receta número 29

Recetario · Capítulo 3 · Títulos y aperturas

Chuleta de anclajes: un cartel de elementos encadenados

Un cartel A3 cuyos elementos cuelgan del sangrado, de la página, de su zona o unos de otros, y una segunda hoja que enmarca cada elemento y rotula trece.

En esta página
Salida
Canvas
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.34.0
Licencia
Actualizada el 16 oct 2026
Código MIT · Texto CC BY 4.0

pp. 1–2 de 2

  • Formato 297 × 420 mm
  • 2 columnas, medianil de 7 mm
  • Funnel Sans 12/16
  • Funnel Display
  • Martian Mono
  • 2 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 47 ms
  • 180 líneas de código

En pocas palabras

Un cartel de charlas de astronomía antes de un eclipse de sol. Enseña a colocar cada elemento midiendo desde el borde de la página o desde otro elemento.

Lo que vas a componer

Cartel de un club de astronomía ficticio para cuatro charlas, los jueves de abril, antes del eclipse total de Sol del 2 de agosto de 2027. Un cielo azul ultramar llena los dos tercios superiores de un A3. Una Luna negra tapa un Sol amarillo limón cortado por el borde derecho, y detrás de ambos se extiende una corona dibujada con código. El título, Vuelve la sombra en Funnel Display de 120 pt, se apoya en su entradilla al pie del cielo. Bajo el horizonte, cuatro fechas azules encabezan las charlas, y la letra pequeña va a dos columnas sobre una banda azul. Cada elemento cuelga del sangrado, de la página, de su zona o de otro, y sus desplazamientos se miden desde ahí. La segunda hoja enmarca en rosa la caja de cada elemento y los contenedores de cabecera y pie, y rotula trece elementos con su anclaje.

Esta receta responde a

  • ¿Cómo coloco los elementos de diseño respecto a la página, la sangre o entre sí, en lugar de por coordenadas?
  • ¿Cómo añado una marca de agua, un fondo de color o una imagen decorativa en todas las páginas?

La respuesta corta

script.js · líneas 56–72en el código completo
const SKY = 272; // mm from the trim's top edge to the horizon, the sky's lower edge
const INSET = BLEED + MARGIN; // from the bleed's edge to the text's edge
const AIR = 14; // mm between the standfirst and the horizon
const poster = () => ({ enabled: true, slot: { elements: [ // array order is paint order
  // 'bleed' and 'page' are frames of the sheet; 'container' would be this heading's own box.
  { kind: 'box', id: 'sky', style: { backgroundColor: col('sky') }, // no width: fills the bleed
    placement: at('bleed', 'top-left', 0, 0, { height: mm(BLEED + SKY) }) },
  ...eclipse(), // the Sun hangs from the trim's corner, the Moon and the corona from the Sun
  // The headline stands on the horizon and grows upwards: 'above' puts an element's
  // bottom-left corner on the top-left corner of its anchor, so a longer title lifts the kicker.
  text('deck', '{attr.deck}', FACE.deck, { ...at('#sky', 'align-bottom', INSET, -AIR),
    size: { maxWidth: mm(153) } }), // shrink-wraps its lines, but wraps at 153 mm
  text('title', '{titleText}', FACE.title, at('#deck', 'above', 0, -9)), // breaks at the \\
  text('kicker', '{attr.kicker}', FACE.kicker, at('#title', 'above', 0, -7)),
  ...programme(), // four columns chained off the horizon
] } }); // hook-up: headings.levels[0] = { span: 'page', breakBefore, advancedDesign: poster() }
// {titleText} is the heading's text; each {attr.*} is written on its line in content.md.

Ingredientes

Tipografía
Funnel Display, Funnel Sans, Martian Mono (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Ancla dos elementos a la hoja y cuelga los demás de ellos

El código es la respuesta corta de arriba. En él, anchor.to dice de qué cuelga un elemento: 'bleed' y 'page' son marcos de la hoja (la misma caja mientras page.cutLines esté desactivado), 'container' es la caja de la propia zona y '#id' es otro elemento (colocación de elementos). Una caja sin ancho llega hasta el borde opuesto de su marco, así que el cielo ocupa el sangrado de lado a lado. Un elemento colocado respecto al cielo se mide desde el borde izquierdo del cielo, que es el del sangrado; por eso la x de la entradilla es INSET, 18 mm. El titular se monta de abajo arriba desde el borde inferior del cielo. 'align-bottom' deja la base de la caja de la entradilla AIR, 14 mm, por encima de ese borde, y 'above' apoya cada elemento sobre el de debajo, de modo que un título con más líneas sube el antetítulo en vez de pisar la entradilla. Bajo el diseño, la letra pequeña empieza en la primera línea de la rejilla base de 16 pt que queda al menos 3,2 mm por debajo del elemento más bajo, la línea de los ponentes; esos 3,2 mm son el margen inferior que el título lleva por defecto.

#2 · Cuelga la Luna y la corona del Sol

script.js · líneas 76–87en el código completo
const SUN = 150; // mm across; the Moon is drawn the same size
const CORONA = 300; // mm, the square picture of the corona
const HALO = (CORONA - SUN) / 2; // how far the corona reaches past the Sun on every side
const BITE = { x: 2, y: 2.5 }; // mm the Moon sits off the Sun: a sliver is left at upper left
const disc = (id, colour, placement) => ({ kind: 'box', id, placement: { ...placement,
  size: square(SUN) }, style: { backgroundColor: col(colour), borderRadius: mm(SUN / 2) } });
const eclipse = () => [
  { kind: 'image', id: 'corona', resourceId: 'corona', // listed before the discs: painted behind
    placement: at('#sun', 'align-top', -HALO, -HALO, square(CORONA)) },
  disc('sun', 'sun', at('page', 'top-right', 30, 25)), // 30 mm of it past the right edge
  disc('moon', 'ink', at('#sun', 'align-top', BITE.x, BITE.y)),
];

El Sol es el único elemento anclado a la página, que es la caja de corte. Contada desde la esquina 'top-right', una x positiva sale por el borde derecho, y 30 mm del disco quedan fuera. La Luna y la corona cuelgan del Sol con 'align-top', así que se mueven con él. Sus desplazamientos se cuentan desde la esquina superior izquierda del Sol: la Luna se corre 2 mm a la derecha y 2,5 mm hacia abajo, lo que deja un filo de Sol arriba a la izquierda, y la corona empieza HALO, 75 mm, más arriba y más a la izquierda, lo que centra su cuadrado de 300 mm sobre el disco de 150 mm. La corona es un elemento de imagen que toma el tamaño de su caja (elementos de imagen) y va en la lista antes que los discos para pintarse detrás de ellos.

#3 · Encadena las cuatro tardes en columnas

script.js · líneas 91–100en el código completo
const GUT = 7; // mm between the evenings, and between the two columns of text under them
const COL = (A3.width - 2 * MARGIN - 3 * GUT) / 4; // four columns across the text width: 60 mm
const DROP = 12; // mm from the horizon to the dates
const programme = () => [1, 2, 3, 4].flatMap((n) => [
  text(`day${n}`, `{attr.d${n}}`, FACE.day, n === 1
    ? at('#sky', 'below', INSET, DROP, wide(COL)) // the first date hangs from the horizon
    : at(`#day${n - 1}`, 'right-of', GUT, 0, wide(COL))), // the others from the one before
  text(`talk${n}`, `{attr.t${n}}`, FACE.talk, at(`#day${n}`, 'below', 0, 3, wide(COL))),
  text(`who${n}`, `{attr.s${n}}`, FACE.who, at(`#talk${n}`, 'below', 0, 2.5, wide(COL))),
]);

Cada fecha, charla y ponente tiene un size.width fijo de COL, y 'right-of' más GUT pone la fecha siguiente una columna más allá. Sin ancho, una fecha se ajusta a sus cifras (el «8» mide 17 mm), así que el «15» empezaría 7 mm después y cada charla correría en una sola línea hasta meterse en la columna siguiente. COL reparte el ancho del texto entre cuatro con el mismo medianil de 7 mm que las dos columnas de letra pequeña de debajo, por lo que la segunda columna de letra pequeña empieza bajo el 22. Cada charla cuelga 'below' de su fecha y cada ponente de su charla, de modo que una charla que ocupara tres líneas bajaría a su ponente y a ningún otro.

#4 · Lleva la banda al pie, en todas las páginas

script.js · líneas 104–115en el código completo
const MARK = 10; // mm, the club's mark
const PAD = (FOOT - MARK) / 2; // centres the mark in the bottom margin
const markTall = { height: mm(MARK) }; // as tall as the mark: the line is centred on it
const footer = { elements: [
  { kind: 'box', id: 'band', style: { backgroundColor: col('sky') }, // the bottom margin, bled
    placement: at('bleed', 'bottom-left', 0, 0, { height: mm(BLEED + FOOT) }) },
  // The container runs from the text down to the trim: 'bottom-*' counts up, 'top-*' down.
  { kind: 'image', id: 'mark', resourceId: 'mark',
    placement: at('container', 'bottom-left', 0, -PAD, square(MARK)) },
  text('club', '{attr.club}', FACE.foot, at('#mark', 'right-of', 3, 0, markTall)),
  text('free', '{attr.free}', FACE.foot, at('container', 'top-right', 0, PAD, markTall)),
] };

Lo que tenga que salir en todas las páginas, como esta banda, va en la zona de la cabecera o del pie, y un estilo de encabezado con cabecera o pie propios la sustituye en las páginas de su sección. El pie del estilo de las guías repite estos cuatro elementos con sus marcos y sus etiquetas; por eso la banda y el emblema salen en las dos hojas. El contenedor del pie es el margen inferior, del texto al corte: 'bottom-left' cuenta hacia arriba desde el corte y 'top-right' hacia abajo desde el texto, y el −10 del emblema y el +10 de la línea «Entrada libre» caen en la misma franja de 10 mm, en mitad de la banda (cabeceras y pies). El pie se pinta después del texto y no le quita sitio, de modo que FOOT es a la vez el margen inferior y la altura de la banda, que así nunca pisa las líneas de encima.

#5 · Dibuja las líneas de construcción desde la misma configuración

script.js · líneas 119–146en el código completo
const GUIDE = { borderColor: col('guide'), borderWidth: pt(1) };
const signed = ({ value }) => `${value < 0 ? '−' : '+'}${Math.abs(value)}`; // all offsets in mm
const describe = ({ id, placement: { anchor: { to, edge }, offset = {} } }) => [`#${id}`,
  `${edge} ${to}`, // the two words of anchor: { to, edge }
  ['x', 'y'].filter((k) => offset[k]?.value).map((k) => `${k} ${signed(offset[k])}`).join(' '),
].filter(Boolean).join(' · ');
// A border never changes an element's size (padding does), so each frame traces its box.
// An image or a rounded box gets a square frame of its size, hung from its top-left corner.
const frame = (el) => (el.kind === 'text' ? [{ ...el, box: { ...el.box, ...GUIDE } }]
  : el.kind === 'box' && !el.style.borderRadius ? [{ ...el, style: { ...el.style, ...GUIDE } }]
    : [el, { kind: 'box', id: `${el.id}-box`, style: GUIDE,
      placement: at(`#${el.id}`, 'align-top', 0, 0, el.placement.size) }]);
const tag = (el, [edge, x = 0, y = 0, note]) => text(`${el.id}-tag`, note ?? describe(el),
  face('Martian Mono', 8.5, 500, 'ink', { box: { backgroundColor: col('guide'),
    padding: { top: pt(1.6), bottom: pt(1.2), left: pt(3), right: pt(3) } } }),
  at(`#${el.id}`, edge, x, y));
const guides = (elements, tags) => [...elements.flatMap(frame),
  ...elements.filter((el) => tags[el.id]).map((el) => tag(el, tags[el.id]))];
const container = (id) => ({ kind: 'box', id, style: GUIDE, // the slot's own box, drawn
  placement: at('container', 'top-left', 0, 0, { width: 'fill', height: 'fill' }) });
const TAGS = { // where each tag sits against its element: [edge, x, y, text]
  sky: ['align-bottom', INSET, -3], corona: ['align-bottom', 90, -2], sun: ['above'],
  moon: ['below', 20, 2], kicker: ['above'], title: ['above'], deck: ['above'],
  day1: ['above', 0, -6], day2: ['above'], who1: ['below'],
  mark: ['above', 0, -2], club: ['above', 69, -2], free: ['above', -30, -2],
  header: ['align-bottom', 0, -2, t({ en: 'header container', es: 'contenedor de la cabecera' })],
  footer: ['align-bottom', 0, -2, t({ en: 'footer container', es: 'contenedor del pie' })],
};

guides() recorre los elementos del cartel. Un texto recibe un borde en su caja, y una caja cuadrada, un borde en su estilo; ninguno de los dos mueve nada, porque solo el padding agranda una caja. Una imagen o un disco redondo recibe una caja cuadrada de su mismo tamaño colgada de su esquina superior izquierda, así que también queda dibujada la esquina del Sol de la que cuelgan la Luna y la corona. Cada etiqueta es un texto colgado de su elemento y escrito por describe() a partir del placement de ese elemento, así que ninguna etiqueta puede contradecir la configuración que rotula. {style="guides"} en el segundo título trae este diseño, con una cabecera y un pie propios (estilos de encabezado). Una etiqueta sin ancho solo dispone del espacio entre su ancla y el borde derecho del contenedor; por eso la etiqueta de #free empieza 30 mm a la izquierda de su texto. pageIndexOffset: 1, en la continuation del contenido, convierte el cartel en página par, y así el visor pone las dos hojas una junto a otra.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 029 · Anchoring cheat sheet: a poster built from chained elements ═══
// https://postext.dev/en/cookbook/anchoring-cheat-sheet
// Code: MIT · Text: original (CC BY 4.0) · Drawings: generated in code (CC BY 4.0)
// Fonts: Funnel Display, Funnel Sans, Martian Mono (SIL OFL 1.1) · Needs postext ≥ 1.34.0
// An A3 poster whose elements hang from the bleed, the page, their slot or one another, never
// from coordinates; the second sheet is the same poster with each element framed and tagged.
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'anchoring-cheat-sheet';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
  ink: '#0b0b0c', // text, and the Moon
  sky: '#1b3bff', // the sky, the foot band and the dates
  sun: '#ffe53b', // the Sun and the kicker
  paper: '#ffffff', // type on the sky
  muted: '#5c5f66', // speakers and the colophon
  guide: '#ff2d9b', // frames and tags on the construction sheet
};
// col(id): a colour linked to its palette entry, so a swapped palette recolours the sheet.
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' } })),
  { id: 'main-color', name: 'sky (defaults)', value: { hex: palette.sky, model: 'hex' } },
];

const A3 = { width: 297, height: 420 }; // mm, the trim
const MARGIN = 18; // mm at the top and sides: the body's edges, and the header container's
const FOOT = 30; // mm, the bottom margin: the footer container and its band
const BLEED = 0; // mm; 3 for the printer, which switches on page.cutLines below
// at(): a placement. Offsets are distances from the anchor point, never page coordinates.
const at = (to, edge, x = 0, y = 0, size) => ({ anchor: { to, edge },
  offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });
const wide = (w) => ({ width: mm(w) }); // fixed, so a text is as wide as its column
const square = (d) => ({ width: mm(d), height: mm(d) });
// Design text is centred by default, and in a footer it is cut with '…': these wrap, set left.
const text = (id, content, face, placement) => ({ kind: 'text', id, content, overflow: 'wrap',
  align: 'left', ...face, placement });
const face = (fontFamily, size, fontWeight, colour, more) => ({ fontFamily, fontSize: pt(size),
  fontWeight, color: col(colour), ...more });
const caps = (tracking) => ({ letterSpacing: pt(tracking), textTransform: 'uppercase' });
const FACE = { // lineHeight as a multiple of each size
  kicker: face('Martian Mono', 12, 500, 'sun', caps(1.8)),
  title: face('Funnel Display', 120, 800, 'paper', { lineHeight: 0.86 }),
  deck: face('Funnel Sans', 22, 400, 'paper', { lineHeight: 1.22 }),

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

#Añade 3 mm de sangre y marcas de corte

Con 3 mm de BLEED se activan las marcas de corte, y el cielo y la banda del pie, que cuelgan del sangrado, entran 3 mm en ella mientras INSET deja el texto en el margen; el Sol, la Luna y la corona cuelgan de la página, y todo lo que pinta una página se recorta al sangrado, así que el Sol acaba 3 mm más allá del corte y fuera del sangrado solo quedan las marcas de corte.

-const BLEED = 0; // mm; 3 for the printer, which switches on page.cutLines below
+const BLEED = 3; // mm; 3 for the printer, which switches on page.cutLines below

#Sube el horizonte

Con 20 mm menos de SKY sube el borde del cielo, y con él la entradilla, el título, el antetítulo y los doce textos del programa, mientras la letra pequeña pasa a una línea más alta de la rejilla base; el Sol cuelga de la página, así que el segundo cambio lo sube los mismos 20 mm para que guarde la distancia con el título, que en la edición inglesa llegaría a tocar el filo de Sol.

-const SKY = 272; // mm from the trim's top edge to the horizon, the sky's lower edge
+const SKY = 252; // mm from the trim's top edge to the horizon, the sky's lower edge
-  disc('sun', 'sun', at('page', 'top-right', 30, 25)), // 30 mm of it past the right edge
+  disc('sun', 'sun', at('page', 'top-right', 30, 5)), // 30 mm of it past the right edge

Errores frecuentes

Error frecuente

Los elementos de cabecera y pie se pintan encima del texto

Los elementos de cabecera y pie se pintan sobre la página y el área de texto no les deja sitio. Mantenlos dentro de los márgenes, que son los que les reservan el espacio. Cabeceras y folios →

Error frecuente

Valores de atributo: sin { ni }; comillas simples si llevan "

Un valor de atributo termina en la llave de cierre, así que no puede contener { ni }. Un valor que lleve comillas dobles va entre comillas simples; el signo de dólar no da problemas. Atributos de título →

Comprobación del Sandbox · designCyclicAnchor

Referencia de anclaje cíclica

Por qué. Los elementos de diseño se anclan unos a otros en bucle, así que ninguno puede colocarse.

Solución. Ancla un elemento de la cadena al contenedor, a la página o al sangrado. Documentación →

Comprobación del Sandbox · designDanglingAnchor

Referencia de anclaje rota

Por qué. Un elemento de diseño se ancla a un #id que no tiene ningún elemento de la zona.

Solución. Corrige el id o añade el elemento al que se refiere. Documentación →

  • En un pen nada avisa de un anclaje cíclico ni de uno roto. El panel Revisión del Sandbox avisa de ellos en la cabecera, el pie, las portadillas de parte y los niveles de encabezado, pero no en los estilos de encabezado como guides. Un elemento anclado a un #id que no existe se coloca respecto al contenedor: un borde de elemento como 'below' cae en la esquina superior izquierda del contenedor, con su desplazamiento, y un borde de contenedor como 'top-right', en esa esquina. En un bucle, un elemento cae de la misma manera y los demás se encadenan a él.
  • 'align-left' y 'align-top' llevan al mismo punto: los dos ponen la esquina superior izquierda del elemento sobre la de su ancla.
  • Un borde se pinta centrado sobre el contorno de la caja, así que cada marco rosa de 1 pt sobresale 0,5 pt de la caja que traza, aunque la documentación de la configuración dice que los trazos se pintan por dentro.

Créditos

Texto
Texto original, CC BY 4.0
Fuentes
Funnel Display (SIL OFL 1.1) · Funnel Sans (SIL OFL 1.1) · Martian Mono (SIL OFL 1.1)
Sandbox