En pocas palabras
Las bases de un concurso de un ayuntamiento para convertir una antigua lonja en biblioteca. Los títulos de sección van en un margen izquierdo ancho, a la altura de la primera línea del texto.
Lo que vas a componer
En cinco páginas A4, el Ayuntamiento de Puerto Lince, un puerto inventado, convoca un concurso para convertir su lonja de 1931 en biblioteca. La maqueta es la de un informe municipal suizo. Una columna lateral de 50 mm, el canal, baja por la izquierda de cada página, y cada sección se abre con un número rojo y un filete negro que cruza toda la caja. Su título, en Noto Serif Display, va en el canal a la altura de la primera línea. Los números de los apartados cuelgan en el medianil, en DM Mono rojo, y los títulos quedan alineados con el texto. Los criterios del jurado empiezan con un término en negrita roja. La página 1 pone un título de 58 pt sobre el plano de situación, la planta de la parcela va en el canal de la página 2 y un alzado de la lonja abre la 3.
Esta receta responde a
- ¿Cómo numero los títulos (1, 1.1, 1.1.1) y doy a cada nivel un estilo distinto?
- ¿Cómo compongo en columna y media, con una columna de texto ancha y una lateral estrecha?
- ¿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?
- ¿Cómo doy color a los términos clave (en negrita o cursiva) en el texto o dentro de los recuadros?
La respuesta corta
// The heading stays in the flow and keeps its number, but its design has no {titleText}:
// it prints the number in the channel and a rule from there to the column's right edge,
// both reserve: false, or the box below would keep a float gap under them (a line lower).
const [NUMBER, RULE] = [8.5, 0.75]; // pt: the DM Mono number, whose figures are 0.7 em tall
// Centre the rule on the figures: their baseline is 0.8 of the line down, less 0.35 em.
const RULE_Y = pt(NUMBER * (0.8 - 0.7 / 2) - RULE / 2);
const h2 = { level: 2, numberingTemplate: '{2}', lineHeight: pt(LEAD), // one grid line
marginTop: pt(2 * LEAD), marginBottom: pt(0), advancedDesign: { enabled: true, slot: {
elements: [
{ kind: 'text', id: 'number', content: '{number}', fontFamily: LABEL, fontWeight: 500,
fontSize: pt(NUMBER), lineHeight: 1, color: col('signal'), reserve: false,
placement: at('container', 'top-left', mm(-HANG)) },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(RULE), reserve: false,
color: col('ink'), placement: { ...at('#number', 'right-of', mm(2), RULE_Y),
size: { width: 'fill' } } },
] } } };
// The title goes in a box fenced right after the heading: span="side" stands it in the
// channel on the grid line where the text resumes (gotcha: side-box-starts-at-fence).
// Attributes at the end of the line stay with the heading.
const sideHeads = (md) => md.replace(/^## (.+?)(\s*\{[^}]*\})?$/gm,
(line, title) => `${line}\n\n:::callout{type="sidehead" span="side"}\n${title}\n:::`);
// The box has no background and no padding, and it takes the text's leading, so each
// line of the title sits on a baseline of the text beside it.
const sidehead = { id: 'sidehead', backgroundEnabled: false,
padding: { top: pt(0), right: pt(0), bottom: pt(0), left: pt(0) },
body: { fontFamily: DISPLAY, fontSize: pt(13.5), lineHeight: pt(LEAD) } };
Ingredientes
- Funciones
- Notas al margenAperturas diseñadasColumna y mediaColumna al margen para flotantesTítulos numeradosAtributos de títuloTextos, filetes y cajas en los diseños de páginaAnclaje de elementos de diseñoImágenes en los diseños de páginaCitas que colocan las figurasColocación de figurasRecuadrosNegrita, cursiva y sus coloresCabeceras y foliosEstilo de tablasEstilos de cifrasEstilo de los piesFigura y Tabla en tu idiomaPies lateralesFiguras justo aquí
- También usa
- Equilibrado de columnasBanda de capítulo a todo el anchoColor del papelEstilos de párrafoTipos de recurso propiosFiguras y tablas como recursosEstilos de tabla con nombre
- Tipografía
- Mona Sans, Noto Serif Display, DM Mono (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Imprime el título de la sección desde un recuadro en el canal
El código es la respuesta corta de arriba. Un título reserva sitio hasta el elemento más bajo de su diseño, así que el nombre de la sección, dibujado en el canal a la altura de la primera línea del texto, bajaría el texto una línea, y dos si ocupara dos líneas. Por eso el diseño del encabezado dibuja solo el número y el filete, y sideHeads() copia el texto de cada ## Título en un :::callout que va justo detrás. Con span="side", ese recuadro sale del flujo y se coloca en el canal, en la línea de la rejilla en la que sigue el texto (estilos de recuadro). El número y la raya llevan reserve: false: si no, un recuadro del canal deja un hueco de flotante, una línea, bajo los elementos del título que caen en él, y el título bajaría a la segunda línea del texto. En un recuadro, igual que en el texto, la línea base queda a 0,8 de la altura de línea, así que un recuadro con el interlineado del texto, 14 pt, pone cada línea de un título de dos líneas sobre una línea base del párrafo de al lado. El Markdown sigue siendo un simple ## Programa de necesidades. Como el diseño del encabezado no imprime {titleText}, el Sandbox avisa con Título del encabezado sin usar, aunque el recuadro imprima el título.

#2 · Reserva el canal para títulos y figuras
const layout = {
layoutType: 'oneAndHalf',
sideColumnPercent: (SIDE / CONTENT) * 100, // 50 of the 178 mm between the margins
sideColumnSide: 'left', // on every page: the brief is printed on one side of the sheet
sideColumnRole: 'floats', // no text in the channel: what span: 'side' sends, side captions
gutterWidth: mm(GUTTER),
};
sideColumnRole: 'floats' deja el texto fuera del canal (tipos de disposición). Después de la apertura, en el canal solo están los seis títulos de sección y la planta de la parcela, que llegan con span: 'side', y los pies de las tablas 1 y 2. Por defecto, la columna lateral va a la derecha, y unas bases impresas a una cara la mantienen en el mismo lado en todas las páginas. sideColumnSide: 'left' la pone a la izquierda, donde cada título de sección se lee antes que su texto.
#3 · Cuelga los números y compón en línea los títulos menores
// The title keeps the text's left edge; the number, right-aligned in a 12 mm box, ends
// 2 mm short of it. The box needs that fixed width: an 'auto' width is clamped to the
// column and would shrink to nothing out here.
const H3 = { size: 10.5, number: 9 }; // pt; two boxes one grid line tall share a baseline
const h3 = { level: 3, numberingTemplate: '{2}.{3}', fontSize: pt(H3.size),
lineHeight: pt(LEAD), marginTop: pt(LEAD), marginBottom: pt(0),
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: TEXT, fontWeight: 600,
fontSize: pt(H3.size), lineHeight: LEAD / H3.size, color: col('ink'), align: 'left',
overflow: 'wrap', placement: { ...at('container', 'top-left'), size: { width: 'fill' } } },
{ kind: 'text', id: 'number', content: '{number}', fontFamily: LABEL, fontWeight: 500,
fontSize: pt(H3.number), lineHeight: LEAD / H3.number, color: col('signal'),
align: 'right', placement: { ...at('#title', 'left-of', mm(-2)),
size: { width: mm(12) } } },
] } } };
// Level 4 is not a heading: '**Accessibility.** A wheelchair user…' opens its paragraph.
// No other paragraph has bold; table cells keep tableStyle's ink, so Total stays black.
const runIn = { boldColor: col('signal') }; // spread into bodyText
El título del apartado empieza en el borde izquierdo de la columna. Su número se ancla con 'left-of' a la izquierda del título, alineado a la derecha en una caja de 12 mm que termina 2 mm antes del texto, de modo que números como 2.1 o 3.3 cuelgan en el medianil y cada título queda alineado con el texto que tiene debajo (colocación de elementos). La caja necesita una anchura fija. Una anchura 'auto' se limita a la columna. En el medianil se queda en cero, y el número no se imprime. El nivel 2 imprime '{2}' y el nivel 3, '{2}.{3}', porque con {1} todos los números empezarían por el 1 del único H1 de las bases. Los criterios de la sección 4 son un cuarto nivel que no lleva título propio. Cada párrafo empieza con un término en negrita, y bodyText.boldColor lo imprime en rojo (texto base). Ningún otro párrafo lleva negrita, y las celdas de las tablas toman su color de tableStyle, así que la fila del total de la tabla 1, también en negrita, se queda en negro.
#4 · Da a cada figura y a cada tabla su propia colocación
// The plot plan stands in the channel; the elevation crosses channel and column at the
// head of the next page; the table of areas floats to the head of the text column, with
// its caption beside it in the channel; the timetable sits where ::resource puts it, and
// its caption takes the channel too (captionSide serves an inline embed from 1.28).
const PLAN_W = 44; // mm: the plot plan, 88 m wide at 1:2000
const resource = (id, typeId, rest) => ({ id, typeId, createdAt: 0, updatedAt: 0, ...rest });
const drawing = (id, width, height, rest) => resource(id, 'figure', { kind: 'svg',
svg: { fileId: `${id}.svg`, width, height }, ...rest });
const resources = [
drawing('parcela', PLAN_W * 10, 400, {
placement: { span: 'side', width: PLAN_W / SIDE }, // 44 mm of the channel's 50
caption: t({ en: 'The plot, 1:2000. Market hall and weighbridge hut in grey; six tamarisks '
+ 'along the north edge. Red arrows: possible entrances; grey arrow: service.',
es: 'La parcela, 1:2000. Lonja y caseta de básculas, en gris; seis tamarindos en el '
+ 'borde norte. Flechas rojas: accesos posibles; flecha gris: servicio.' }),
altText: t({ en: 'Plan of the plot with the hall, the hut, six trees and three entrances.',
es: 'Planta de la parcela con la lonja, la caseta, seis árboles y tres accesos.' }) }),
drawing('fachada', 1780, 300, { placement: { position: 'top', span: 'page' },
caption: t({ en: 'Quay front, 1:300. In red, the four frames at the east end, where the '
+ 'reinforcement has corroded.',
es: 'Fachada al muelle, 1:300. En rojo, los cuatro pórticos del extremo este, con '
+ 'las armaduras corroídas.' }),
altText: t({ en: 'Elevation of the hall: thirteen vaults, eleven arches, four frames in red.',
es: 'Alzado de la lonja: trece bóvedas, once arcos y cuatro pórticos en rojo.' }) }),
resource('programa', 'table', { kind: 'table', table: { ...programme, styleId: 'figures' },
placement: { position: 'top', captionSide: true }, caption: t({
en: 'Schedule of net floor areas.', es: 'Programa de superficies útiles por zonas.' }) }),
resource('calendario', 'table', { kind: 'table', table: calendar,
placement: { position: 'here', captionSide: true },
caption: t({ en: 'Competition timetable.', es: 'Calendario del concurso.' }) }),
// No :ref cites the site plan: only the opener's image element draws it.
drawing('situacion', MAP.w * 10, MAP.h * 10, { altText: t({
en: 'Site plan of the Poniente quay with the market hall’s plot in red.',
es: 'Plano de situación del muelle de Poniente con la parcela de la lonja en rojo.' }) }),
];
La planta de la parcela va al canal con span: 'side' y se apila bajo el título de la sección 2 (colocación). width: PLAN_W / SIDE le da 44 mm de ancho, con lo que sus 88 metros quedan a escala 1:2000 exacta. El alzado de la fachada es un flotante 'top' a todo el ancho de la página. Se cita en la página 2 y abre la 3, porque un flotante nunca se coloca por encima de su referencia. La tabla del programa, citada también en la página 2, flota a la cabeza de la columna de texto de la página 3, bajo el alzado. captionSide: true pone su pie en el canal, a la altura del borde superior de la tabla. El calendario va donde lo pone ::resource, al final de las bases, y captionSide: true pone también su pie en el canal, junto al apartado 6.3. Mona Sans compone por defecto cifras proporcionales, y en una columna alineada a la derecha 120 y 560 no quedan cifra bajo cifra. Un estilo de tabla con nombre, tableStyles: [{ id: 'figures', figureStyle: 'tabular' }], que la tabla 1 elige con styleId: 'figures', activa el tnum de la fuente: sus cifras tabulares llevan el cero barrado, cerca de los números en DM Mono. Las fechas del calendario conservan las cifras propias de la fuente (estilos de cifras).
#5 · Abre las bases con el plano de situación
const MAP = { y: 68.5, w: CONTENT, h: 52 }; // mm: from the top of the text block
const display = { fontFamily: DISPLAY, fontWeight: 300, color: col('ink'), align: 'left',
overflow: 'wrap' };
const opener = { enabled: true,
// The plan's foot falls between two grid lines. A floor on the next one leaves the rule
// of section 1 as far from its text as the rule of every later section.
minHeight: mm(GRID * Math.ceil((MAP.y + MAP.h) / GRID)),
slot: { elements: [
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', ...label, color: col('signal'),
placement: at('container', 'top-left', mm(HANG)) },
{ kind: 'text', id: 'series', content: '{subtitle}', ...label,
placement: { ...at('container', 'top-left'), size: { width: mm(SIDE) } } },
{ kind: 'text', id: 'title', content: '{titleText}', ...display, fontSize: pt(58),
lineHeight: 0.96, placement: { ...at('#kicker', 'below', mm(0), mm(4.5)),
size: { width: mm(MAIN) } } },
{ kind: 'text', id: 'lead', content: '{attr.lead}', ...display, italic: true,
fontSize: pt(14), lineHeight: 1.3, placement: { ...at('#title', 'below', mm(0), mm(5)),
size: { width: mm(MAIN) } } },
{ kind: 'text', id: 'legend', content: '{attr.map}', fontFamily: TEXT, fontSize: pt(7.5),
lineHeight: 1.4, color: col('muted'), align: 'left', overflow: 'wrap',
placement: { ...at('#lead', 'align-top', mm(-HANG), pt(2)),
size: { width: mm(SIDE - 6) } } },
{ kind: 'image', id: 'map', resourceId: 'situacion', // across the channel and the column
placement: { ...at('container', 'top-left', mm(0), mm(MAP.y)),
size: { width: mm(MAP.w) } } },
] } };
Con span: 'page', el contenedor de la apertura es toda la caja, canal incluido (apertura a toda página y diseño avanzado). El antetítulo y el título se desplazan 57 mm, hasta el borde izquierdo de la columna de texto, y el plano cruza el canal y la columna. Sin él, el contenedor es la columna de texto: todo se corre 57 mm a la derecha, y el título, la entradilla y el plano se salen de la página por el borde derecho. El diseño reserva sitio hasta el pie del plano, que cae entre dos líneas de la rejilla. Un minHeight redondeado a la línea siguiente deja el filete de la sección 1 a la misma distancia de su texto que el de las demás secciones. El antetítulo, la entradilla y la leyenda del plano son atributos de la línea # Bases del concurso.
La receta completa
// ═══ Postext Cookbook · Nº 045 · Side heads, hanging numbers and run-in heads ═══════
// https://postext.dev/en/cookbook/side-heads-hanging-numbers
// Code: MIT · Text: original (CC BY 4.0) · Drawings: made in code (MIT)
// Fonts: Mona Sans, Noto Serif Display, DM Mono (SIL OFL 1.1) · Needs postext ≥ 1.65.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage, defaultResourceTypes,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'side-heads-hanging-numbers';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // a Swiss municipal report: black, white and one signal red
ink: '#17171a', // text and rules
signal: '#d42a1f', // section numbers, run-in heads, the plot on the plans (5.1:1)
tint: '#f9dcd7', // the plot's ground on the plans
sea: '#d8e2e8', // water on the plans
stone: '#cacad0', // built ground on the plans
rule: '#c3c3ca', // hairlines under the running head and in tables
muted: '#5e5e67', // running heads, legends, the colophon (6.4:1)
paper: '#ffffff',
};
// Every colour is linked to its palette entry by id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// Defaults this config does not restate link to 'main-color', so it points at the accent.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.signal })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [TEXT, DISPLAY, LABEL] = ['Mona Sans', 'Noto Serif Display', 'DM Mono'];
const TRIM = { width: 210, height: 297 }; // mm: A4, like every document of the competition
const [TOP, LEFT, RIGHT] = [26, 16, 16]; // mm; not mirrored: the brief prints one-sided
const LEAD = 14; // pt: the body leading, the pitch of the baseline grid
const LINES = 50; // grid lines in the text block
const PT = 25.4 / 72; // mm in a point
const GRID = LEAD * PT; // mm: one line of the grid
const CONTENT = TRIM.width - LEFT - RIGHT; // 178 mm
const [SIDE, GUTTER] = [50, 7]; // mm: the margin channel on the left, and the gap after it
const MAIN = CONTENT - SIDE - GUTTER; // 121 mm: the text column
const HANG = SIDE + GUTTER; // mm from the channel's left edge to the text's left edge
const at = (to, edge, x = mm(0), y = mm(0)) => ({ anchor: { to, edge }, offset: { x, y } });
// Kickers, running heads and folios: tracked capitals in the mono.
const LABEL_PT = 7.5;
const label = { fontFamily: LABEL, fontWeight: 500, fontSize: pt(LABEL_PT), lineHeight: 1.35,
letterSpacing: pt(1.2), textTransform: 'uppercase', color: col('muted'), align: 'left' };
// #region channel: one text column, and on its left a channel for boxes and figures only
const layout = {
layoutType: 'oneAndHalf',
sideColumnPercent: (SIDE / CONTENT) * 100, // 50 of the 178 mm between the margins
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
#Pon el filete solo sobre la columna de texto
Ancla el filete a la caja del propio título en lugar de al número y irá del borde izquierdo del texto al derecho de la columna; en el canal quedarán solo el número y el nombre de la sección.
- color: col('ink'), placement: { ...at('#number', 'right-of', mm(2), RULE_Y),
+ color: col('ink'), placement: { ...at('container', 'top-left', mm(0), RULE_Y),Errores frecuentes
Error frecuente
Un recuadro lateral empieza a la altura del bloque que sigue a su valla
En postext 1.4.1, un recuadro con span: 'side' se coloca en la columna lateral a la altura a la que ha llegado el texto en su valla, en la siguiente línea de la rejilla y debajo de los recuadros que ya haya. Pon la valla de una glosa justo antes del párrafo que explica: si va después, la glosa empieza junto al párrafo siguiente. Un recuadro que pasaría del pie de la columna sube hasta que su pie coincide con el de la columna, si el recuadro de encima le deja sitio; si aun así no cabe, espera a la columna lateral de la página siguiente. Notas al margen →
Error frecuente
Un flotante 'top' va a la página siguiente a su cita salvo que pueda encabezar la página que lo cita
Por defecto un flotante nunca va por encima de su propia referencia, así que un flotante 'top' a todo el ancho citado en la página N abre la página N+1. Con placement.citingPage: true en el recurso o en el defaultPlacement de su tipo (o layout.floatsAtCitingPage para todo el libro, desde postext 1.25) encabeza en cambio la página N, y el texto de encima de la referencia baja bajo él, cuando cabe dentro de layout.maxTopFraction y la línea que lo cita sigue en esa página. Nunca encabeza la primera página de un capítulo ni una página tras un salto forzado: allí sigue abriendo la página siguiente, y 'auto' o 'bottom' pueden ocupar el pie de la página que lo cita. Colocación de figuras →
Comprobación del Sandbox · headingAdvancedWithoutTitleText
El texto del título no se imprime
Por qué. Un diseño avanzado no tiene ningún elemento que imprima {titleText}, así que el texto del propio encabezado no aparece.
Solución. Añade un elemento de texto con {titleText}, salvo que el encabezado deba ser invisible. Documentación →
- Una figura lateral ocupa la cabeza del canal en la página que la cita, y un título al margen que se coloca después se apila bajo la figura, más abajo que el principio de su propia sección. Cita las figuras laterales después del título de sección de su página, como hace la sección 2 con la planta de la parcela.
- Una inserción en línea (
position: 'here') admitecaptionSidedesde postext 1.28: el pie del calendario va en el canal en la página 5, como el del programa en la página 3. El pie necesita el canal libre junto a la tabla. Donde ya hay un título lateral o una figura lateral, queda bajo la tabla.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fuentes
- Mona Sans (SIL OFL 1.1) · Noto Serif Display (SIL OFL 1.1) · DM 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)


