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
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
- Funciones
- Anclaje de elementos de diseñoTextos, filetes y cajas en los diseños de páginaImágenes en los diseños de páginaAperturas diseñadasBanda de capítulo a todo el anchoBandas a sangre y pestañasEstilos de títuloCabeceras por secciónAtributos de títuloSaltos de línea en los títulosPaleta de color semánticaEstilos de párrafoFiguras y tablas como recursosPáginas en un canvas
- También usa
- Sangrado y marcas de corte
- 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
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
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
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
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
// ═══ 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 edgeErrores 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#idque 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
- Receta
- Ignacio Ferro
- 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)
- 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)


