En pocas palabras
Un capítulo de un libro de física con una columna ancha de texto y otra estrecha junto al borde exterior. La estrecha lleva diagramas y notas breves al lado del texto al que acompañan.
Lo que vas a componer
El capítulo 4 de Palanca y lente, un manual de física en página de 210 × 275 mm. El texto ocupa una columna ancha y nunca entra en el margen exterior, un canal de 53 mm. El número del capítulo, un 4 verde, va en ese canal a la altura del título, y los objetivos, debajo. Los diagramas se apilan desde la cabeza del canal, y los términos clave van en glosas verde claro junto al pasaje que los define. Las figuras que se quedan en la columna de texto, sobre fondo oscuro o claro, llevan el pie en el margen, a la altura de su base. Solo el panel del prisma cruza las dos columnas. Los márgenes son simétricos, así que el canal queda siempre en el lado exterior de la página, a la derecha en las impares y a la izquierda en las pares.
Esta receta responde a
- ¿Cómo compongo en columna y media, con una columna de texto ancha y una lateral estrecha?
- ¿Cómo pongo notas al margen o glosas junto al párrafo que explican?
- ¿Cómo añado una figura con pie numerado y la cito en el texto («véase la fig. 3.2»)?
- ¿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 pongo el pie al lado de una figura, o encima de una tabla sobre una barra de color?
- ¿Cómo numero los títulos (1, 1.1, 1.1.1) y doy a cada nivel un estilo distinto?
La respuesta corta
const layout = {
layoutType: 'oneAndHalf', // a wide main column and a narrow side column
sideColumnPercent: 30, // of the 176 mm content width: a 52.8 mm channel
sideColumnRole: 'floats', // no body text: side figures, side captions and side boxes only
sideColumnSide: 'outer', // right on a recto, left on a verso (the margins are mirrored)
gutterWidth: mm(7), // the text column keeps the rest: 176 − 52.8 − 7 = 116 mm
};
// A figure placed with span 'side' stacks in the channel from the head of the page that cites it,
// under the numeral on a chapter's first page.
const side = { span: 'side' };
// A figure left in the text column (the default span) sets its caption in the channel beside
// it; page-wide floats ignore captionSide and keep theirs underneath.
const resourceTypes = defaultResourceTypes(LANG).map((type) => (type.id !== 'figure' ? type
: { ...type, defaultPlacement: { captionSide: true } })); // the built-in types, in LANG
// A box fenced :::callout{type="term" span="side"} leaves the flow and lands in the channel at the
// height the text has reached: fence each gloss before the paragraph it should stand beside.
Ingredientes
- Funciones
- Columna al margen para flotantesPies lateralesNotas al margenColumna y mediaMárgenes simétricosCitas que colocan las figurasColocación de figurasPies numeradosFiguras y tablas como recursosFigura y Tabla en tu idiomaAperturas diseñadasAnclaje de elementos de diseñoAtributos de títuloTítulos numeradosEstilos de títuloCapítulos que abren en página imparRecuadrosCabeceras y foliosCabeceras según el tipo de páginaPaleta de color semántica
- Tipografía
- Merriweather, Merriweather Sans (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Reserva el margen para los flotantes
El código de este paso es la respuesta corta de arriba. En una disposición en columna y media, sideColumnPercent: 30 da a la columna lateral el 30 % de los 176 mm de ancho de la caja (52,8 mm), y la columna de texto se queda con lo que sobra tras el medianil de 7 mm (116 mm, unos 75 caracteres de Merriweather de 9,3 pt). sideColumnRole: 'floats' cierra la columna lateral al texto, y sideColumnSide: 'outer' la pone en el lado exterior, que con márgenes simétricos cambia de una página a otra. Las figuras van a ella con span: 'side'. Un recuadro con span="side" en la línea de apertura sale del flujo y entra en el canal a la altura por la que va el texto, así que cada glosa empieza junto al bloque que la sigue en el Markdown.
#2 · Deja que la cita coloque cada figura
const drawings = new Map(); // fileId → SVG markup, registered before the build
const figure = (id, { width, height, markup }, placement) => {
drawings.set(`${id}.svg`, markup);
return { id, typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0, caption: t(captions[id]),
altText: t(captions[id]), // read aloud in HTML and tagged PDF; the canvas does not use it
svg: { fileId: `${id}.svg`, width, height }, ...(placement && { placement }) };
};
const resources = [ // no placement: a main-column float, its caption in the channel
figure('burning-glass', burningGlass()),
figure('refraction', refraction(), side),
figure('critical-angle', criticalAngle(), side),
figure('fibre', fibre()),
figure('prism', prism(), { span: 'page', position: 'top' }), // across text column and channel
figure('principal-rays', principalRays()),
figure('diverging', diverging(), side),
];
El primer :ref a una figura la numera y la sitúa donde indica su colocación. Una figura con span: 'side' se apila desde la cabeza del canal de la página que la cita, aunque la cita quede más abajo, y pasa a la página siguiente si el resto del canal no le basta. Las figuras 4.2 y 4.3, citadas las dos en la página 88, bajan por el canal de esa página con la glosa del ángulo límite entre ellas. El prisma es un flotante top a todo el ancho citado en la página 88, y un flotante nunca queda por encima de su cita, así que abre la 89 sobre las dos columnas. Las figuras 4.1, 4.4 y 4.6 se quedan en la columna de texto y toman captionSide del defaultPlacement del tipo figura. Ocupan el hueco inferior de la columna, así que cada pie queda a la altura de la base de su figura; en el hueco superior se alinearía con su borde de arriba.
#3 · Abre el capítulo en el margen
// Every element counts toward the opener's depth, the page-anchored numeral too (gotcha:
// opener-reserves-anchored). minHeight fixes that depth at nine lines of the grid, room for a
// one-line title, the rule and a four-line standfirst (41.2 mm), so the text starts on the same
// line in every such chapter, however short its standfirst and even with a smaller numeral. Kicker
// and numeral (40.6 mm) reach the ninth line too; a deeper opener grows past it, line by line.
const [KICKER, NUMERAL] = [8, 104]; // pt
const opener = {
enabled: true,
minHeight: pt(LEAD * 9), // 42.9 mm: the text starts on the eleventh line, after marginBottom
slot: {
elements: [
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: SANS, fontWeight: 800,
fontSize: pt(32), lineHeight: 1.05, color: col('ink'), align: 'left', overflow: 'wrap',
placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: 'fill' } } },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1), color: col('accent'),
placement: { anchor: { to: '#title', edge: 'below' }, offset: { y: mm(4) },
size: { width: 'fill' } } },
{ kind: 'text', id: 'lead', content: '{attr.lead}', fontFamily: SERIF, italic: true,
fontSize: pt(10.5), lineHeight: 1.45, color: col('ink'), align: 'left', overflow: 'wrap',
placement: { anchor: { to: '#rule', edge: 'below' }, offset: { y: mm(3.5) },
size: { width: 'fill' } } },
// The kicker hangs from the page's top-right corner, not from the heading: the channel lies
// outside the heading's column, and on the right only on a recto (so chapters open on one).
// The numeral hangs from the kicker.
{ kind: 'text', id: 'kicker', content: t({ en: 'Chapter', es: 'Capítulo' }), ...label,
fontSize: pt(KICKER), align: 'left', placement: { anchor: { to: 'page', edge: 'top-right' },
offset: { x: mm(-OUTER), y: mm(TOP) }, size: { width: mm(CHANNEL) } } },
{ kind: 'text', id: 'numeral', content: '{chapterNumber}', fontFamily: SANS, fontWeight: 800,
fontSize: pt(NUMERAL), lineHeight: 1, color: col('accent'), align: 'left',
placement: { anchor: { to: '#kicker', edge: 'below' }, offset: { y: mm(0.5) },
size: { width: mm(CHANNEL) } } },
],
},
};
El encabezado de primer nivel se queda en la columna de texto, donde una ranura de diseño apila su texto, el filete y la entradilla; el antetítulo cuelga de la esquina superior derecha de la página y el número, del antetítulo, los dos con el ancho del canal. minHeight fija la altura de la apertura en nueve líneas de la rejilla (42,9 mm), que dan cabida a un título de una línea, el filete y una entradilla de cuatro, así que con una entradilla más corta el texto no sube. El antetítulo y el número de 104 pt acaban 40,6 mm por debajo del margen superior, dentro de esas nueve líneas, así que tampoco bajan el texto. El canal solo está a la derecha en las páginas impares, y por eso el encabezado de primer nivel salta a página impar. El recuadro de objetivos va después del primer párrafo, y ninguna figura del margen se cita antes que él, así que queda bajo el número (lo explica «Errores frecuentes»).
#4 · Lleva los folios al lado del canal
const [HEAD_Y, FOOT_Y, HEAD_GAP] = [12.5, -12, 9]; // mm from the top and bottom trim; folio to head
// A text on the physical page: edge picks the corner, x and y are its offsets in mm.
const head = ({ edge, x, y = HEAD_Y, ...text }) => ({
kind: 'text', pages: 'body', ...label, color: col('muted'), ...text,
placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(y) } },
});
const folio = { content: '{pageNumber}', fontSize: pt(8.5), letterSpacing: pt(0),
color: col('accent') };
const verso = { parity: 'even', edge: 'top-left' }; // x counts in from the left edge
const recto = { parity: 'odd', edge: 'top-right' }; // x counts back from the right edge
const header = { elements: [
head({ id: 'verso-folio', ...verso, ...folio, x: OUTER }),
head({ id: 'verso-title', ...verso, content: '{title}', x: OUTER + HEAD_GAP }),
head({ id: 'recto-title', ...recto, x: -(OUTER + HEAD_GAP),
content: t({ en: 'Chapter {chapterNumber} · {chapterTitle}',
es: 'Capítulo {chapterNumber} · {chapterTitle}' }) }),
head({ id: 'recto-folio', ...recto, ...folio, x: -OUTER }),
] };
// A chapter's first page, always a recto, carries a drop folio at the foot of the channel instead.
const footer = { elements: [
head({ id: 'drop-folio', ...recto, ...folio, pages: 'opener', edge: 'bottom-right', x: -OUTER,
y: FOOT_Y }),
] };
Cada elemento se ancla a la página física y se filtra por parity, así que el folio y la cabecera quedan en el mismo borde que el canal a los dos lados de la doble página. pages: 'body' los aparta de la apertura, que lleva en su lugar un folio al pie del canal.
#5 · Empieza el libro en el capítulo 4
const continuation = { pageNumbering: { startAt: 87 }, // odd, like page 1: a recto
headings: { h1: 3, h2: 0, h3: 0, h4: 0, h5: 0, h6: 0 } }; // the next # is chapter 4
const doc = await buildDocumentWithFonts({ markdown, resources, continuation }, config(),
kitFonts(FONTS));
showPages(doc, { title: t({ en: 'Textbook with a margin column',
es: 'Libro de texto con columna al margen' }) });
Estas páginas son el capítulo 4 de un libro más largo. La continuación deja el contador de capítulos en 3, así que {chapterNumber} imprime 4 y el numberingTemplate: '{1}.{2}' del segundo nivel numera los apartados del 4.1 al 4.3; las figuras van de la 4.1 a la 4.7. ## Preguntas {style="plain"} toma una entrada de headingStyles con numbered: false, así que ese título no lleva número. Los folios empiezan en el 87 porque la primera página cae a la derecha, y a la derecha van los folios impares.
#6 · Nombra los colores una sola vez
const palette = {
ink: '#1a222d', // text, and the dark panels of figures 4.1, 4.4 and 4.5
accent: '#17774f', // the only accent colour: numerals, folios, section headings, labels
ray: '#f2a516', // light rays in every diagram
glass: '#cfe6dd', // glass in the diagrams
tint: '#edf5f1', // the key-term glosses and the light plate of a construction diagram
muted: '#5b6863', // running heads, the normals in the diagrams, the colophon
paper: '#ffffff',
};
// A colour carries its id and its hex. The diagrams read `palette` as well, so retint the
// chapter by editing it: the text, the designs and the drawings change together.
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': point it at the accent, so nothing prints blue.
{ id: 'main-color', name: 'accent (defaults)', value: { hex: palette.accent, model: 'hex' } },
];
Cada color de la configuración enlaza con una entrada de la paleta y lleva además su hex, que col() copia del mismo objeto. Para cambiar los colores del capítulo, edita palette: los diagramas leen el mismo objeto, así que su vidrio, sus rayos, sus paneles oscuros y su fondo claro cambian a la vez que números, antetítulos y glosas. main-color apunta al color de acento, así que los colores por defecto de los estilos de texto que la configuración no fija salen en verde y no en el azul del motor.
La receta completa
// ═══ Postext Cookbook · Nº 001 · Textbook with a margin column ═══════════════════
// https://postext.dev/en/cookbook/textbook-margin-column
// Code: MIT · Text: original (CC BY 4.0) · Diagrams: generated in code (CC BY 4.0)
// Fonts: Merriweather, Merriweather Sans (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// A chapter of a physics textbook in the column-and-a-half layout: the body text keeps to
// the main column, and the outer margin is a channel for diagrams, captions and glosses.
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage, defaultResourceTypes,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'textbook-margin-column';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: semantic colours, each linked by id and written out in hex
const palette = {
ink: '#1a222d', // text, and the dark panels of figures 4.1, 4.4 and 4.5
accent: '#17774f', // the only accent colour: numerals, folios, section headings, labels
ray: '#f2a516', // light rays in every diagram
glass: '#cfe6dd', // glass in the diagrams
tint: '#edf5f1', // the key-term glosses and the light plate of a construction diagram
muted: '#5b6863', // running heads, the normals in the diagrams, the colophon
paper: '#ffffff',
};
// A colour carries its id and its hex. The diagrams read `palette` as well, so retint the
// chapter by editing it: the text, the designs and the drawings change together.
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': point it at the accent, so nothing prints blue.
{ id: 'main-color', name: 'accent (defaults)', value: { hex: palette.accent, model: 'hex' } },
];
// #endregion
// The page in mm, named once: the channel, the opener and the running heads derive from it.
const [TRIM_W, TRIM_H] = [210, 275];
const [TOP, BOTTOM, INNER, OUTER] = [24, 22, 20, 14]; // inner and outer swap on a verso
const LEAD = 13.5; // body leading in pt
const [SERIF, SANS] = ['Merriweather', 'Merriweather Sans'];
// #region answer: a float-only channel on the outer edge, and what goes into it
const layout = {
layoutType: 'oneAndHalf', // a wide main column and a narrow side column
sideColumnPercent: 30, // of the 176 mm content width: a 52.8 mm channel
sideColumnRole: 'floats', // no body text: side figures, side captions and side boxes only
sideColumnSide: 'outer', // right on a recto, left on a verso (the margins are mirrored)
gutterWidth: mm(7), // the text column keeps the rest: 176 − 52.8 − 7 = 116 mm
};
// A figure placed with span 'side' stacks in the channel from the head of the page that cites it,
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
#Deja los pies debajo de las figuras
Con los valores por defecto del tipo figura, los pies de las figuras 4.1, 4.4 y 4.6 ocupan líneas de la columna de texto, y el canal queda solo para diagramas y glosas.
-const resourceTypes = defaultResourceTypes(LANG).map((type) => (type.id !== 'figure' ? type
- : { ...type, defaultPlacement: { captionSide: true } })); // the built-in types, in LANG
+const resourceTypes = defaultResourceTypes(LANG); // what the engine uses when none are set#Pon el canal a la derecha en todas las páginas
Para un documento que se lee página a página en pantalla, desactiva los márgenes simétricos y pasa al borde derecho el folio y la cabecera de las pares; así los capítulos pueden abrirse en cualquier página.
- sideColumnSide: 'outer', // right on a recto, left on a verso (the margins are mirrored)
+ sideColumnSide: 'right', // what 'outer' means anyway once the margins stop mirroring
- bottom: mm(BOTTOM), left: mm(INNER), right: mm(OUTER), mirror: true } }, // left: recto's inner
+ bottom: mm(BOTTOM), left: mm(INNER), right: mm(OUTER), mirror: false } },
- { level: 1, breakBefore: { enabled: true, parity: 'odd' }, marginBottom: pt(LEAD),
+ { level: 1, breakBefore: { enabled: true, parity: 'any' }, marginBottom: pt(LEAD),
-const verso = { parity: 'even', edge: 'top-left' }; // x counts in from the left edge
+const verso = { parity: 'even', edge: 'top-right' };
- head({ id: 'verso-folio', ...verso, ...folio, x: OUTER }),
- head({ id: 'verso-title', ...verso, content: '{title}', x: OUTER + HEAD_GAP }),
+ head({ id: 'verso-folio', ...verso, ...folio, x: -OUTER }),
+ head({ id: 'verso-title', ...verso, content: '{title}', x: -(OUTER + HEAD_GAP) }),
- head({ id: 'drop-folio', ...recto, ...folio, pages: 'opener', edge: 'bottom-right', x: -OUTER,
+ head({ id: 'drop-folio', ...folio, pages: 'opener', edge: 'bottom-right', x: -OUTER,#Abre el capítulo bajo una banda de color
Apertura de capítulo sobre banda a sangre lleva una banda de color a sangre por arriba de la página y pone sobre ella el título y un número de capítulo de 168 pt.
Errores frecuentes
Error frecuente
Los recuadros laterales no flotan: esperan sitio
Un recuadro con span: 'side' no flota: se coloca junto al bloque al que sigue y, si el canal del margen está lleno, espera a la página siguiente. Pon cada glosa justo después del párrafo que explica. Si el capítulo termina con recuadros aún en espera, cada uno ocupa la columna lateral de una página posterior al texto, en el orden de sus vallas, y la composición lo avisa (afterText); hasta postext 1.24 solo se abría una de esas páginas y los recuadros restantes se perdían sin aviso. 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 →
Error frecuente
Una apertura reserva altura hasta su elemento anclado más bajo
Una apertura de diseño avanzado reserva la altura de su elemento más bajo, y cuentan también los anclados a la página o a la sangre que quedan por debajo del título, así que un adorno al pie de la página empuja el texto a la siguiente. Dale a ese elemento reserve: false (desde postext 1.5): se pinta donde está anclado y no reserva nada. Los elementos que siguen a la propia banda (anclados a su pie, o de altura 'fill') nunca fijan su altura. Aperturas diseñadas →
Error frecuente
Sin <marker> ni filtros en los SVG, o pasan a mapa de bits
Una figura SVG solo sigue siendo vectorial en el PDF sin <marker>, filtros ni máscaras; si no, pasa a mapa de bits, y los filtros muy anidados pueden dejarla en blanco en Chrome. Dibuja las puntas de flecha como trazados. Figuras y tablas como recursos →
- Figuras y glosas se apilan en el canal en el orden en que el texto llega a ellas, nunca una al lado de otra. La glosa del ángulo límite va después del párrafo de la ley de Snell y antes del que cita la figura 4.3, así que en la página 88 se apila entre las figuras 4.2 y 4.3, junto al párrafo que presenta el término. Con el bloque después de esa cita, caería bajo la figura 4.3.
- En la primera página de un capítulo, las figuras laterales se apilan bajo el antetítulo y el número. Una figura citada en el primer párrafo ocupa ese sitio y baja el recuadro de objetivos por el canal, así que este capítulo cita su primera figura del margen después del recuadro.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fuentes
- Merriweather (SIL OFL 1.1) · Merriweather Sans (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)


