Saltar al contenido principal
Receta número 17

Recetario · Capítulo 3 · Títulos y aperturas

Cinco aperturas de capítulo en un solo libro

Una apertura en el nivel 1 y cuatro estilos de encabezado elegidos en el Markdown; cada uno cambia el color de acento, y algunos, márgenes, columnas o folios.

En esta página
Salida
Canvas
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.25.0
Licencia
Actualizada el 10 oct 2026
Código MIT · Texto CC BY 4.0

pp. 4–5 de 7

  • Formato 180 × 240 mm
  • 1 columna
  • Lora 10,8/14,5
  • Fraunces
  • Geist
  • Geist Mono
  • 7 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 79 ms
  • 249 líneas de código

En pocas palabras

Un libro breve sobre cómo empezar un capítulo, donde cada capítulo arranca con un estilo distinto. Enseña a dar a un capítulo su color, sus márgenes y su maquetación con un solo ajuste.

Lo que vas a componer

Cinco maneras de empezar es un libro de siete páginas sobre aperturas de capítulo, de 180 × 240 mm, y cada capítulo va compuesto con la apertura que describe. El primero es de novela: antetítulo espaciado, título en cursiva fina y capitular roja de cinco líneas, con cabeceras en las páginas siguientes. El segundo encierra el título y un florón en una cartela crema de dos filetes azules. El tercero apila el título en Fraunces Black blanca sobre un campo magenta a sangre, encima de una inicial monoespaciada calada en una caja. El cuarto, el del manual, lleva cabeceras en monoespaciada, una insignia naranja con el número junto al título y dos columnas de Geist. La coda baja el título a media página, sobre una inicial elevada. El capítulo uno usa la apertura propia del nivel 1; los otros cuatro eligen un estilo en la línea de su encabezado.

Esta receta responde a

  • ¿Cómo doy a cada capítulo su propia foto, su color o una variante de apertura?
  • ¿Cómo añado a una apertura una línea de autor, una entradilla o un primer párrafo con capitular?
  • ¿Cómo pongo el título de capítulo a todo el ancho mientras el texto sigue a dos columnas debajo?
  • ¿Cómo hago una insignia con el número junto al título que se ensanche cuando el número crece (9 → 10)?

La respuesta corta

script.js · líneas 16–52en el código completo
// A heading line picks a style by id, and its attributes feed the opener's {attr.…} texts:
//   # The Frame {style="framed" kicker="Chapter the Second"}
// A style overrides the level fields it names (opener, drop cap) and, until the next level-1
// heading, the section fields it names; the rest comes from the level and the document.
const level1 = () => ({ level: 1,
  // span 'page' opens each chapter at the head of a new page and runs its opener across
  // every column (chapter four has two). By default an H1 waits for a recto, with a blank
  // page before it; parity 'any' lets these short chapters open on either side.
  span: 'page',
  breakBefore: { enabled: true, parity: 'any' },
  marginBottom: pt(0), // each opener ends where its first paragraph starts
  advancedDesign: literary, // chapter one, unstyled: the book's own opener
  dropCap: { lines: 5, fontFamily: 'Fraunces', fontWeight: 400, color: col('accent'),
    gap: mm(2.5) } }); // a five-line drop in rubric red
const headingStyles = () => [ // factories, called by config() once every design exists
  // Each style brings its opener and swaps 'accent' for a colour of its own, on its pages.
  { id: 'framed', advancedDesign: framed, palette: { accent: palette.lapis },
    margins: { left: mm(EVEN), right: mm(EVEN) }, // a centred text block; 'accent' is blue:
    dropCap: { lines: 3, fontFamily: 'Fraunces', fontWeight: 600, color: col('accent'),
      gap: mm(2) } },
  { id: 'stacked', advancedDesign: stacked, palette: { accent: palette.magenta }, // white, on
    dropCap: { lines: BOXED, fontFamily: 'Geist Mono', fontWeight: 700, color: col('paper'),
      gap: mm(2.2) } }, // the square the opener draws for it
  { id: 'spec', advancedDesign: spec, palette: { accent: palette.signal }, dropCap: false,
    marginBottom: pt(0), // the hairline under the title is the separator
    margins: { left: mm(SPEC), right: mm(SPEC) }, // a 144 mm text block
    layout: { layoutType: 'double', gutterWidth: mm(7) },
    bodyStyle: { fontFamily: 'Geist', fontSize: pt(9.8), textAlign: 'left' }, // on the grid
    header: { elements: [...specHead('even'), ...specHead('odd')] },
    footer: { elements: [] } }, // no folio at the foot: the head gives the page
  { id: 'quiet', numbered: false, // a coda: it advances no chapter counter
    advancedDesign: quiet, palette: { accent: palette.graphite }, footer: tinyFolio,
    dropCap: { lines: 1, fontFamily: 'Fraunces', fontWeight: 300, fontSize: pt(46), // raised:
      color: col('accent'), gap: mm(1.2) }, // on the first baseline, rising into the white
    margins: { left: mm(QUIET.inner), right: mm(QUIET.outer) }, // a 106 mm measure
    bodyStyle: { fontSize: pt(QUIET.size), lineHeight: pt(QUIET.lead), textAlign: 'left' } },
]; // hook-up in config(): headings: { levels: [level1(), …] }, headingStyles()

Ingredientes

Tipografía
Lora, Fraunces, Geist, Geist Mono (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Pon en el nivel la apertura propia del libro

script.js · líneas 97–105en el código completo
// The first paragraph, in :::paragraphs{style="lead"}, starts 17 mm under the title.
const literary = design([
  text('kicker', '{attr.kicker}', 'Geist', 8, centred(22), { ...caps(1.7), align: 'center' }),
  text('title', '{titleText}', 'Fraunces', 32, at('#kicker', 'below', 0, 4, 'fill'),
    { fontWeight: 300, italic: true, lineHeight: 1.05, align: 'center' }),
  { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.8), color: col('accent'),
    placement: at('#title', 'below', (MEASURE - 18) / 2, 6, 18) }, // an 18 mm rule, centred
  room('#title', 17),
]);

El capítulo uno no lleva estilo, así que toma el diseño del nivel 1, del que parte cada estilo (la respuesta corta muestra el nivel y los estilos). El primer párrafo del capítulo está en el Markdown, en un grupo :::paragraphs{style="lead"} un cuerpo mayor que el texto (12/17 puntos frente a 10,8/14,5), y lo abre la capitular del nivel, dropCap (letras capitulares): la M se apoya en la quinta línea de base y, sin fontSize, su parte alta queda a la altura de las mayúsculas de la primera línea, con las dos alturas de mayúsculas medidas en Fraunces y en Lora. La apertura termina con una caja vacía, room(), 17 mm por debajo del título, donde empieza la entradilla; un :::space bajo la entradilla deja una línea en blanco y el texto empieza sin sangría.

#2 · Enmarca el título con dos cajas

script.js · líneas 109–127en el código completo
const FRAME = 62; // mm: the outer box's height
const INSET = 3; // mm: the hairline box runs this far inside it
const FLEURON = 44; // mm: the ornament's width, centred under the title
const framed = design([ // array order is paint order: the boxes first, the type on top
  { kind: 'box', id: 'frame', placement: { ...at('container', 'top-left', 0, 0),
    size: { width: 'fill', height: mm(FRAME) } },
  style: { backgroundColor: col('tint'), borderColor: col('accent'), borderWidth: pt(1.6) } },
  { kind: 'box', id: 'hairline', placement: { ...at('#frame', 'align-top', INSET, INSET),
    size: { width: mm(MEASURE - 2 * INSET), height: mm(FRAME - 2 * INSET) } },
  style: { borderColor: col('accent'), borderWidth: pt(0.5) } },
  text('kicker', '{attr.kicker}', 'Geist', 7.5, centred(14), { ...caps(1.6), align: 'center' }),
  text('title', '{titleText}', 'Fraunces', 34, at('#kicker', 'below', 0, 3.5, 'fill'),
    { fontWeight: 600, lineHeight: 1.05, align: 'center' }),
  // An image element draws a registered resource, never numbered or captioned. Its resourceId
  // may be '{attr.photo}' (postext ≥ 1.8): then each heading names its own photo.
  { kind: 'image', id: 'fleuron', resourceId: 'fleuron',
    placement: at('#title', 'below', (MEASURE - FLEURON) / 2, 4.5, FLEURON) },
  room('#frame', 9), // the text starts 9 mm under the frame
]);

El orden del array es el orden de pintado: primero las cajas y encima el texto; el florón es un elemento de imagen, que dibuja un recurso SVG registrado que nunca se numera ni se cita. Un elemento de imagen sirve también para dar a cada capítulo su propia foto: desde postext 1.8 su resourceId admite marcadores, así que con resourceId: '{attr.foto}' un mismo estilo dibuja la foto que indica cada título, # El marco {style="framed" foto="lago"}, como las recetas de la ficha de cocina (elementos de imagen). El estilo framed de la respuesta corta usa palette para volver azul accent en las páginas de este capítulo, así que los filetes, el antetítulo y el folio salen en azul, y sus margins centran la caja de texto bajo el marco. La dropCap propia del estilo usa col('accent'), que la paleta también vuelve azul, así que la S de tres líneas va a juego con el marco.

#3 · Apila el título y mete la inicial en una caja

script.js · líneas 131–160en el código completo
const FIELD = 130; // mm from the trim: the foot of the colour field
const S_BEARING = 1.2; // mm: the white left of the title's S (0.0365 em at 94 pt)
// The boxed initial: the style's drop cap sets the white letter; the opener draws the square,
// fitted by hand in pt. The text starts on the grid line 8 mm under the field (from the trim).
const TEXT_TOP = Math.ceil(((FIELD - TOP + 8) * 72) / 25.4 / LEAD) * LEAD; // pt
const BASE = 0.8; // a line's baseline stands 0.8 down its line box
const CAPS = 0.7; // the height of a capital in Lora, em
// Geist Mono, em: cap height, the advance every capital shares, the white either side of an M
const MONO = { caps: 0.71, advance: 0.6, side: 0.044 };
const BOXED = 3; // lines the initial spans
const capsTop = TEXT_TOP + BASE * LEADIN.lead - CAPS * LEADIN.size; // the first line's capitals
const foot = TEXT_TOP + (BOXED - 1 + BASE) * LEADIN.lead; // the third baseline: the letter's foot
// The M runs from the first line's capitals to its foot; the square runs past both as far as
// the M's sides sit in, so the colour is as wide on all four sides.
const letter = (foot - capsTop) / MONO.caps, pad = MONO.side * letter;
const stacked = design([
  { kind: 'box', id: 'field', style: { backgroundColor: col('accent') },
    placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { height: mm(FIELD) } } },
  text('kicker', '{attr.kicker}', 'Geist', 8, at('container', 'top-left', 0, 4),
    { ...caps(1.8), color: col('paper') }),
  // {titleText} keeps the \\ breaks from the Markdown, so each line ends at the writer's \\.
  // Moved left by the S's side bearing, so its curve meets the text edge.
  text('title', '{titleText}', 'Fraunces', 94,
    at('container', 'top-left', -S_BEARING, 15, 'fill'),
    { fontWeight: 900, lineHeight: 0.84, color: col('paper') }),
  { kind: 'box', id: 'initial', style: { backgroundColor: col('accent') }, reserve: false,
    placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: pt(capsTop - pad) },
      size: { width: pt(MONO.advance * letter), height: pt(foot - capsTop + 2 * pad) } } },
  room('container', (TEXT_TOP * 25.4) / 72, 'top-left'), // the opener ends where the text starts
]);

Los cortes del título se escriben en el Markdown: # Salta \\ a la \\ vista. parte {titleText} en cada \\, mientras que las cabeceras y los marcadores del PDF leen el título en una sola línea (saltos de línea en los títulos). El campo cuelga del borde superior del sangrado, a todo lo ancho y con 130 mm de alto, y la entradilla empieza en la primera línea de la rejilla que queda 8 mm por debajo (TEXT_TOP). La inicial en caja se hace con dos piezas. La dropCap del estilo compone la M en tres líneas de la entradilla, en blanco, y la apertura pinta debajo una caja magenta, colocada a partir de TEXT_TOP, del interlineado de la entradilla y de las medidas de Geist Mono, de modo que el color que queda encima y debajo de la M mide lo mismo que su blanco lateral. La caja no ocupa sitio en la apertura (reserve: false); una caja room vacía cierra la apertura donde empieza la entradilla.

#4 · Dale al manual su insignia, dos columnas y sus cabeceras

script.js · líneas 181–208en el código completo
const SPEC = 18; // mm: both side margins, for a 144 mm text block in two columns
const PAD = 1.6; // mm of colour over the badge's figures
const spec = design([
  { kind: 'rule', id: 'top-rule', direction: 'horizontal', thickness: pt(2.4), color: col('ink'),
    placement: at('container', 'top-left', 0, 0, 'fill') },
  text('kicker', '{attr.kicker}', 'Geist Mono', 7.5, at('container', 'top-left', 0, 3.2),
    { ...caps(1.2, 500), color: col('graphite') }),
  // The badge's width follows its text, with padding on both sides, so 9 → 10 widens it. Its
  // line box holds 1 mm more under the figures than over them, so the foot pads 1 mm less.
  text('badge', '{chapterNumber}', 'Geist Mono', 26, at('container', 'top-left', 0, 12),
    { fontWeight: 700, lineHeight: 1, box: { backgroundColor: col('accent'), padding: {
      top: mm(PAD), right: mm(2.4), bottom: mm(PAD - 1), left: mm(2.4) } } }),
  // Same size and line height as the badge, dropped by its top padding, so the baselines meet.
  text('title', '{titleText}', 'Geist', 26, at('#badge', 'right-of', 4, PAD),
    { fontWeight: 700, lineHeight: 1 }),
  { kind: 'rule', id: 'hairline', direction: 'horizontal', thickness: pt(0.5), color: col('ink'),
    placement: at('container', 'top-left', 0, 31, 'fill') }, // room for a one-line title
]);
const specHead = (parity) => { // mono labels over the opener's rule, on every page of the section
  const [edge, s] = parity === 'even' ? ['top-left', 1] : ['top-right', -1];
  const mono = { ...caps(1.1, 500), color: col('graphite'), parity, pages: 'all' };
  return [
    text(`sp-page-${parity}`, '{pageNumber} / {totalPages}', 'Geist Mono', 7,
      at('container', edge, 0, HEAD_Y), mono),
    text(`sp-chap-${parity}`, '§ {chapterNumber} · {chapterTitle}', 'Geist Mono', 7,
      at('container', edge, s * 16, HEAD_Y), mono),
  ];
};

La insignia es un elemento de texto con fondo y relleno interior pero sin anchura, así que su ancho sigue al de {chapterNumber}, y el título se coloca a su derecha con right-of: en el capítulo 10 la insignia crece una cifra, 5,5 mm, y el título se desplaza con ella. Su relleno inferior es 1 mm menor que el superior porque la caja de línea deja ese milímetro de más bajo las cifras, y así el 4 queda centrado. En el estilo spec, layout pasa la sección a dos columnas y el span: 'page' del nivel extiende la apertura sobre las dos. Sus margins ensanchan la caja de texto a 144 mm, bodyStyle compone Geist en bandera sobre la rejilla base de 14,5 puntos del libro, header sustituye las cabeceras del libro y un footer vacío quita el folio.

#5 · Deja aire a la coda

script.js · líneas 212–221en el código completo
const quiet = design([ // the kicker is in the accent, which this style turns graphite
  text('kicker', '{attr.kicker}', 'Geist', 7.5, at('container', 'top-left', 0, 92),
    caps(1.6, 500)),
  text('title', '{titleText}', 'Fraunces', 26, at('#kicker', 'below', 0, 3),
    { fontWeight: 300, lineHeight: 1.1 }),
  room('#title', 3), // and the initial's rise, in whole lines: the text 16 mm under the title
]);
const tiny = (parity, edge) => text(`tiny-${parity}`, '{pageNumber}', 'Geist', 6.5,
  at('container', edge, 0, -12), { fontWeight: 500, color: col('muted'), parity });
const tinyFolio = { elements: [tiny('even', 'bottom-left'), tiny('odd', 'bottom-right')] };

El antetítulo cuelga 92 mm por debajo del comienzo de la caja de texto, y la inicial elevada es la capitular de una sola línea del estilo quiet: su pie se apoya en la primera línea de base y, con 46 puntos, sobresale hacia el blanco de arriba en lugar de hundirse en el párrafo. El párrafo deja libre por encima, en líneas enteras, lo que sobresale la letra, así que la caja room de la apertura bajo el título mide solo 3 mm. En el estilo quiet, margins estrechan la medida a 106 mm, bodyStyle compone el texto en bandera a 12,5/17,5 puntos, footer cambia el folio de la apertura por uno pequeño en la esquina exterior del pie y palette vuelve gris el antetítulo. En esta página no se imprime ningún número de capítulo, así que numbered: false solo se notaría en un capítulo añadido después de la coda, que seguiría siendo el quinto.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 017 · Five chapter openers in one book ═════════════════
// https://postext.dev/en/cookbook/five-chapter-openers
// Code: MIT · Text: original (CC BY 4.0) · Ornament: generated in code (CC BY 4.0)
// Fonts: Lora, Fraunces, Geist, Geist Mono (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// A small book about openers, each chapter set in the one it describes. Every heading style
// brings its opener and palette; three move the margins, two bring their own type and folios.
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'five-chapter-openers';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region answer: one opener per chapter: the level's own, then heading styles by name
// A heading line picks a style by id, and its attributes feed the opener's {attr.…} texts:
//   # The Frame {style="framed" kicker="Chapter the Second"}
// A style overrides the level fields it names (opener, drop cap) and, until the next level-1
// heading, the section fields it names; the rest comes from the level and the document.
const level1 = () => ({ level: 1,
  // span 'page' opens each chapter at the head of a new page and runs its opener across
  // every column (chapter four has two). By default an H1 waits for a recto, with a blank
  // page before it; parity 'any' lets these short chapters open on either side.
  span: 'page',
  breakBefore: { enabled: true, parity: 'any' },
  marginBottom: pt(0), // each opener ends where its first paragraph starts
  advancedDesign: literary, // chapter one, unstyled: the book's own opener
  dropCap: { lines: 5, fontFamily: 'Fraunces', fontWeight: 400, color: col('accent'),
    gap: mm(2.5) } }); // a five-line drop in rubric red
const headingStyles = () => [ // factories, called by config() once every design exists
  // Each style brings its opener and swaps 'accent' for a colour of its own, on its pages.
  { id: 'framed', advancedDesign: framed, palette: { accent: palette.lapis },
    margins: { left: mm(EVEN), right: mm(EVEN) }, // a centred text block; 'accent' is blue:
    dropCap: { lines: 3, fontFamily: 'Fraunces', fontWeight: 600, color: col('accent'),
      gap: mm(2) } },
  { id: 'stacked', advancedDesign: stacked, palette: { accent: palette.magenta }, // white, on
    dropCap: { lines: BOXED, fontFamily: 'Geist Mono', fontWeight: 700, color: col('paper'),
      gap: mm(2.2) } }, // the square the opener draws for it
  { id: 'spec', advancedDesign: spec, palette: { accent: palette.signal }, dropCap: false,
    marginBottom: pt(0), // the hairline under the title is the separator
    margins: { left: mm(SPEC), right: mm(SPEC) }, // a 144 mm text block
    layout: { layoutType: 'double', gutterWidth: mm(7) },
    bodyStyle: { fontFamily: 'Geist', fontSize: pt(9.8), textAlign: 'left' }, // on the grid
    header: { elements: [...specHead('even'), ...specHead('odd')] },
    footer: { elements: [] } }, // no folio at the foot: the head gives the page
  { id: 'quiet', numbered: false, // a coda: it advances no chapter counter
    advancedDesign: quiet, palette: { accent: palette.graphite }, footer: tinyFolio,
    dropCap: { lines: 1, fontFamily: 'Fraunces', fontWeight: 300, fontSize: pt(46), // raised:

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

#Abre cada capítulo en página impar

Con 'odd', todos los capítulos empiezan en página impar y del segundo al quinto llevan delante una par en blanco, así que el libro pasa de 7 a 11 páginas.

-  breakBefore: { enabled: true, parity: 'any' },
+  breakBefore: { enabled: true, parity: 'odd' },

#Deja la capitular en tres líneas

Sin fontSize, el cuerpo sigue al número de líneas, así que una capitular de tres líneas también queda enrasada con las mayúsculas de la primera.

-  dropCap: { lines: 5, fontFamily: 'Fraunces', fontWeight: 400, color: col('accent'),
+  dropCap: { lines: 3, fontFamily: 'Fraunces', fontWeight: 400, color: col('accent'),

#Versalitas tras la capitular

leadIn compone en versalitas las primeras palabras que siguen a la letra, como hacen muchas novelas; con words: 'line' abarca toda la primera línea.

-    gap: mm(2.5) } });
+    gap: mm(2.5), leadIn: { words: 'line' } } });

Errores frecuentes

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 →

  • Las entradillas van en bandera, como en la apertura de una revista; justificada junto a una capitular de cinco líneas, una entradilla puede abrir mucho los espacios en una línea de pocas palabras.
  • La caja magenta está ajustada a mano a Lora 12/17, a la M de Geist Mono y a la línea de base de la entradilla, situada a 0,8 de su caja de línea (BASE). Si cambias la fuente, el cuerpo o el interlineado de la entradilla, la letra inicial, el número de líneas o la altura del campo, vuelve a comprobar la caja contra las mayúsculas de la primera línea.
  • Los títulos nunca se giran ni van en vertical: el texto de diseño es siempre horizontal. Apila las palabras con \\, como hace el capítulo tres.

Créditos

Texto
Texto original, CC BY 4.0
Fuentes
Lora (SIL OFL 1.1) · Fraunces (SIL OFL 1.1) · Geist (SIL OFL 1.1) · Geist Mono (SIL OFL 1.1)
Sandbox