Saltar al contenido principal
Receta número 57

Recetario · Capítulo 1 · Página y retícula

Currículum de una página con barra lateral

Un currículum A4 cuya barra ciruela es un recuadro en la columna izquierda, solo para flotantes; unas cajas de la cabecera la prolongan por los márgenes.

En esta página
  • Formato 210 × 297 mm
  • Columna y media, medianil de 10 mm
  • Hanken Grotesk 9,3/13,2
  • Hedvig Letters Serif
  • 1 página
  • Nivel
  • Postext 1.57.1
  • Compuesto en 45 ms
  • 176 líneas de código

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

script.js · líneas 47–67en el código completo
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

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

script.js · líneas 91–102en el código completo
// 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

script.js · líneas 71–87en el código completo
// 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

script.js · líneas 106–118en el código completo
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

script.js · líneas 130–149en el código completo
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

Sandbox
// ═══ 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 :::space a 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: false la 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

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)
Sandbox