En pocas palabras
Un currículum de una página para una diseñadora de libros, con una franja de color a la izquierda para los datos de contacto y las habilidades. Las fechas de cada puesto se alinean a la derecha.
Lo que vas a componer
El currículum de Irene Salcedo, diseñadora editorial ficticia afincada en Madrid, en una sola hoja A4. Una banda ciruela de 66 mm de ancho recorre el borde izquierdo de arriba abajo. En lo alto, una pila de libros encuadernados en tela, dibujada en código, queda a la altura de la línea base del nombre. Debajo van el contacto, las habilidades y herramientas en píldoras, los idiomas, la formación, la docencia y sus aficiones. El nombre, en Hedvig Letters Serif de 46 pt, encabeza una columna de texto de 118 mm con un perfil de cinco líneas, tres puestos y los libros que ha diseñado. Cada puesto lleva el cargo a la izquierda y las fechas a la derecha en la misma línea base, con la empresa en cursiva debajo. El primer título de la barra comparte línea base con la profesión, bajo el nombre.
Esta receta responde a
- ¿Cómo compongo en columna y media, con una columna de texto ancha y una lateral estrecha?
- ¿Cómo añado una marca de agua, un fondo de color o una imagen decorativa en todas las páginas?
- ¿Cómo hago chips en línea: teclas, etiquetas, bancos de palabras para ejercicios?
La respuesta corta
const layout = {
layoutType: 'oneAndHalf',
sideColumnPercent: (SIDE / CONTENT) * 100, // 57 of the 185 mm between the margins
sideColumnSide: 'left',
sideColumnRole: 'floats', // no body text: only boxes fenced with span="side"
gutterWidth: mm(GUTTER), // the text column keeps 185 − 57 − 10 = 118 mm
};
// A side box stands where the text has reached at its fence, so the Markdown opens with it,
// before the name, and it starts at the head of the column (gotcha: side-box-starts-at-fence):
// :::callout{type="sidebar" span="side"}
// :::callout{type="section" title="Contact"} … ::: ← the sections nest inside it
// …
// :::space{lines=2.76} ← last: runs the band to the column's foot; a fifth of a line
// ::: more and the whole box moves to page 2
// # Irene Salcedo {role="Book designer and art director"}
const sidebar = { id: 'sidebar', background: col('band'),
// The first title stands on the role's line. The text starts 10 mm from the trim, the
// left margin plus 1 mm, and stops 10 mm short of the band's right edge.
padding: { top: mm(ROLE_Y), right: mm(10), bottom: pt(0), left: mm(1) },
body: { fontFamily: SANS, fontSize: pt(8.4), lineHeight: pt(12.4), color: col('paper'),
boldColor: col('paper'), paragraphSpacing: false } };
Ingredientes
- Funciones
- Columna al margen para flotantesColumna y mediaNotas al margenRecuadros anidadosRecuadrosEspacio vertical explícitoChips en líneaTextos, filetes y cajas en los diseños de páginaImágenes en los diseños de páginaAnclaje de elementos de diseñoNiveles de títuloAtributos de títuloListas de viñetas y de comprobaciónEstilos de párrafoPaleta de color semánticaPáginas en un canvas
- Tipografía
- Hedvig Letters Serif, Hanken Grotesk (SIL OFL 1.1)
- Recursos
- La pila de libros en la cabeza de la barra lateral, dibujada en código con la paleta de la página (Ignacio Ferro, CC BY 4.0)
Elaboración
#1 · Anida las secciones en un solo recuadro lateral
// The sections nest in one side box. As separate side boxes they would stand at least a line
// of paper apart (gotcha: side-boxes-line-apart). A nested box ignores span and flows inside
// its parent (gotcha: nested-callout-limits).
const section = (id, lineHeight) => ({ id, backgroundEnabled: false, // the band shows through
padding: { top: pt(0), right: pt(0), bottom: pt(0), left: pt(0) },
marginTop: mm(10),
titleStyle: { ...caps('glow'), gap: mm(2.4) },
body: { ...sidebar.body, lineHeight: pt(lineHeight) } });
const chipStyles = [{ id: 'skill', fontFamily: SANS, fontSize: pt(7.6), bold: true,
background: col('chip'), color: col('paper'), borderWidth: pt(0),
borderRadius: em(1), // past half the chip's height: a pill
paddingX: em(0.6), paddingY: em(0.22), gap: em(0.3) }];
Dentro de la columna, la banda es el recuadro de la respuesta corta. Se abre antes del nombre, y por eso span="side" lo coloca en la cabeza de la columna solo para flotantes. Las secciones van anidadas en él como recuadros sin fondo propio, de modo que el ciruela corre sin cortes de Contacto a Fuera del trabajo. Compuestas como recuadros laterales sueltos, quedan separadas por franjas de papel de 4,7 a 9,1 mm, aun con marginBottom a 0. Las píldoras miden unos 3,9 mm de alto. Habilidades y Herramientas usan un estilo propio, chips, cuyo interlineado de 16 pt deja 1,8 mm entre filas; con los 12,4 pt de las demás secciones, quedarían a medio milímetro unas de otras (estilos de chip).
#2 · Pinta los márgenes alrededor de la columna
// Header elements are painted after the text, over it, so these stay in the margins, where
// no text runs (gotcha: header-paints-over-text). They repeat on every page.
const BAND_W = LEFT + SIDE; // mm from the trim edge to the band's right edge
const SEAM = 0.5; // mm of overlap with the box, so no hairline of paper shows between them
const REACH = 1; // mm the foot box climbs above the column's foot, over the end of the box
const bandBox = (id, x, y, w, h) => ({ kind: 'box', id, style: { backgroundColor: col('band') },
placement: { ...at('page', 'top-left', x, y), size: { width: mm(w), height: mm(h) } } });
const header = { elements: [
bandBox('head', 0, 0, BAND_W, TOP + SEAM), // above the column: the top margin
bandBox('edge', 0, 0, LEFT + SEAM, TRIM_H), // beside it: the left margin, top to bottom
bandBox('foot', 0, TRIM_H - BOTTOM - REACH, BAND_W, BOTTOM + REACH), // below it
// Painted last, over the box's top padding, where no text runs. The bottom of the stack
// sits on the name's baseline.
{ kind: 'image', id: 'books', resourceId: 'books', placement: {
...at('page', 'top-left', LEFT + 1, TOP + BASELINE - BOOKS.h),
size: { width: mm(BOOKS.w), height: mm(BOOKS.h) } } },
] };
Como la columna lateral queda dentro de los márgenes, el recuadro se detiene a 9 mm del borde izquierdo y a 18 mm del superior. Tres cajas de la cabecera llenan el margen superior sobre la columna, el izquierdo de arriba abajo y el inferior bajo la columna. Los elementos de la cabecera se pintan después del texto y encima de él; por eso la receta los deja en los márgenes, donde no hay texto. Además se repiten en todas las páginas, y una segunda página también llevaría la banda (cabeceras y pies). Las cajas de arriba y de la izquierda montan 0,5 mm sobre el recuadro, y la del pie sube 1 mm por encima del pie de la columna, sobre el final del recuadro, para que no asome un hilo de papel en las juntas. El :::space que cierra el recuadro lo alarga hasta 278,0 mm, 0,8 mm por encima del pie de la columna, con 2,76 líneas en inglés y 1,76 en español.
#3 · Compón el nombre en la cabeza de la columna de texto
const nameplate = { enabled: true, slot: { elements: [
{ kind: 'text', id: 'name', content: '{titleText}', fontFamily: SERIF,
fontSize: pt(NAME.size), lineHeight: 1, color: col('ink'),
placement: at('container', 'top-left') },
{ kind: 'text', id: 'role', content: '{attr.role}', ...caps('accent'),
placement: at('#name', 'below', 0, NAME.gap) },
] } };
const nameLevel = { level: 1, // span stays 'column': the name heads the text column only
// No break before the name: the sidebar box is already on the page, and a break would
// move the name and the whole text column to page 2.
breakBefore: { enabled: false },
marginBottom: pt(LEAD), // one grid line of air under the role
advancedDesign: nameplate };
El H1 conserva el span: 'column' por defecto. Con 'page' se compone como apertura sobre las dos columnas; al ir detrás del recuadro lateral, pasa a la página 2, y allí la columna lateral empieza debajo del nombre, a 45,9 mm. breakBefore está desactivado porque el recuadro lateral ya está en la página: con salto, el nombre y toda la columna de texto pasan a la página 2. El marginBottom del nivel, una línea de la rejilla, baja el perfil de 41,3 a 45,9 mm. El relleno superior del recuadro lateral es ROLE_Y, la altura del nombre más el aire que lo separa de la profesión, así que el primer título de la barra y la profesión comparten línea base, a 39,3 mm del borde superior.
#4 · Pon las fechas en la línea del cargo
const JOB = 9.8; // pt: the job title, the dates and the employer share the size and leading
const jobText = (id, content, look) => ({ kind: 'text', id, content, fontFamily: SANS,
fontSize: pt(JOB), lineHeight: LEAD / JOB, // the body's leading, as a multiple of the size
align: 'left', ...look }); // without align, design text is centred in its box
const job = { enabled: true, slot: { elements: [
jobText('title', '{titleText}', { fontWeight: 700, color: col('ink'), overflow: 'wrap',
placement: { ...at('container', 'top-left'), size: { width: mm(84) } } }), // clear of dates
jobText('dates', '{attr.dates}', { color: col('muted'),
placement: at('container', 'top-right') }), // the title's top and size, so its baseline
jobText('org', '{attr.org}', { italic: true, color: col('muted'),
placement: at('#title', 'below') }),
] } };
const jobLevel = { level: 3, fontSize: pt(JOB), lineHeight: pt(LEAD), marginTop: pt(9),
marginBottom: pt(0), advancedDesign: job };
// The section head takes 20 pt under 19.6 pt of space, three grid lines, so a job head
// starts the same 9 pt under a grid line after a section head as after a list. The 9 pt
// below it merge with a job head's 9 pt above. Under Selected books they push the list to
// the next grid line, as the default 7 pt would; with 0 it would start one line higher.
const sectionLevel = { level: 2, fontSize: pt(14), lineHeight: pt(20),
marginTop: pt(3 * LEAD - 20), marginBottom: pt(9), advancedDesign: sectionHead };
Cada puesto es un H3 cuyos atributos llevan la empresa y las fechas: ### Directora de arte {org="Ediciones del Albardín, Madrid" dates="2021 – actualidad"} (atributos de encabezado). El cargo y las fechas se anclan a la cabeza del mismo contenedor, cada uno en una esquina, con el mismo cuerpo e interlineado, y por eso comparten línea base. El cargo tiene un ancho máximo de 84 mm y admite varias líneas: uno largo salta a la segunda antes de alcanzar las fechas, y la empresa baja con él. Cada título de sección ocupa, con el espacio de encima, tres líneas justas de la rejilla, y así todos los puestos empiezan 9 pt por debajo de una línea, vengan de un título de sección o de una lista.
La receta completa
// ═══ Postext Cookbook · Nº 057 · One-page CV with a sidebar ═══════════════════════
// https://postext.dev/en/cookbook/cv-with-sidebar
// Code: MIT · Text: original (CC BY 4.0) · Drawing: made in code (CC BY 4.0)
// Fonts: Hedvig Letters Serif, Hanken Grotesk (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'cv-with-sidebar';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
ink: '#231b22', // text: a plum-tinted near-black
band: '#3a2235', // the sidebar
accent: '#8f3b62', // on paper: the role and the section heads (7.1:1)
glow: '#f1b98f', // on the band: the sidebar titles (8.3:1)
chip: '#744d6c', // on the band: the skill chips
rule: '#d9cdd5', // the hairlines after the section heads
muted: '#6c5f69', // dates, employers, the colophon (6.0:1)
paper: '#ffffff', // the page, and the text on the band (14.4:1)
};
// Each colour carries its hex and the palette entry it follows.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [SERIF, SANS] = ['Hedvig Letters Serif', 'Hanken Grotesk'];
const PT = 25.4 / 72; // mm in a point
const [TRIM_W, TRIM_H] = [210, 297]; // mm: A4, printed on one side, so nothing is mirrored
const [TOP, LEFT, RIGHT] = [18, 9, 16]; // mm
const LEAD = 13.2; // pt: the body leading
const BOTTOM = TRIM_H - TOP - 56 * LEAD * PT; // mm: the text block holds 56 lines
const CONTENT = TRIM_W - LEFT - RIGHT; // 185 mm between the margins
const [SIDE, GUTTER] = [57, 10]; // mm: the sidebar column, and the white after it
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const LABEL = 7.8; // pt: the role and the sidebar titles, tracked capitals
const caps = (colour) => ({ fontFamily: SANS, fontSize: pt(LABEL), fontWeight: 700,
textTransform: 'uppercase', letterSpacing: pt(LABEL * 0.18), color: col(colour) });
const NAME = { size: 46, gap: 2.6 }; // pt and mm: the name, and the room under it
const ROLE_Y = NAME.size * PT + NAME.gap; // mm under the top margin: the role's line
// mm under the top margin: the name's baseline. Hedvig Letters Serif, set solid, puts it 0.795
// of the size down the line (measured on the page); another face needs its own ratio.
const BASELINE = 0.795 * NAME.size * PT;
const BOOKS = { w: 46, h: 18 }; // mm: the drawing at the head of the band
// #region answer: a float-only column on the left, filled by one box
const layout = {
layoutType: 'oneAndHalf',
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
#Cambia el color de la banda
Cada color se escribe una sola vez, en palette, y de ahí lo toman las cajas de la banda, el recuadro lateral, los chips, la profesión, los títulos y el dibujo. Con estas tres líneas, la banda, el acento y los chips pasan a verde azulado.
- band: '#3a2235', // the sidebar
+ band: '#1d3b3a', // the sidebar
- accent: '#8f3b62', // on paper: the role and the section heads (7.1:1)
+ accent: '#2b5f5b', // on paper: the role and the section heads (7.3:1)
- chip: '#744d6c', // on the band: the skill chips
+ chip: '#456d69', // on the band: the skill chips#Lleva figuras a la misma columna
El libro de texto con columna al margen pone figuras, pies laterales y glosas en una columna solo para flotantes en el borde exterior de cada página.
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
Los recuadros laterales apilados en el canal dejan una línea de papel entre ellos
En postext 1.4.1, un recuadro con span: 'side' deja debajo al menos una línea de texto antes de lo siguiente que haya en el canal, redondeada a la rejilla base, diga lo que diga su marginBottom. Por eso los recuadros con el mismo fondo nunca se tocan: apilados, se leen como tarjetas sueltas. Para un panel continuo, abre un solo recuadro lateral y anida dentro las secciones. Notas al margen →
Error frecuente
:::space se descarta al principio de un recuadro o columna
:::space se descarta al principio de una columna, de un grupo :::columns, de un recuadro sin título que tiene más contenido y de la continuación de un recuadro partido. Desde postext 1.5 un recuadro hecho solo de :::space mide lo que pide el espacio (una caja de respuesta, sitio para escribir), y el espacio que va justo bajo el título de un recuadro baja el cuerpo esa misma altura. Para abrir con espacio un recuadro sin título, dale un título o una primera línea y añade después el espacio. Espacio vertical explícito →
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
Un recuadro anidado ignora span, placement y snapToGrid
Un recuadro anidado en otro ignora su span, placement, snapToGrid y floatBarrier: siempre se compone dentro del recuadro que lo contiene, con el ancho interior de este. Recuadros anidados →
- Ajusta el
:::spacea la página. En la edición española, 1,76 líneas terminan el recuadro 0,8 mm por encima del pie de la columna. Con 1,96 líneas pasa del pie en 0,1 mm y la barra entera se va a la página 2; con 1,66 se abre una franja de papel entre el recuadro y la caja del pie. - Una caja del diseño del nombre no sirve para pintar la banda. El título reserva la altura de la caja, así que una tan alta como la banda le hace reservar más que los 260,8 mm de la columna, y el texto pasa a la página 2. Con
reserve: falsela caja no reserva nada, pero un diseño que se queda en la columna se corta al pie de esta, y el margen inferior quedaría en blanco.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imágenes
- La pila de libros en la cabeza de la barra lateral, dibujada en código con la paleta de la página · Ignacio Ferro · CC BY 4.0
- Fuentes
- Hedvig Letters Serif (SIL OFL 1.1) · Hanken Grotesk (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)


