Saltar al contenido principal
Receta número 45

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

Títulos al margen, números colgados y títulos en línea

Bases de concurso con los títulos de sección en un canal al margen, sobre las líneas base del texto, números colgados en el medianil y títulos en línea en rojo.

  • Formato 210 × 297 mm
  • Columna y media, medianil de 7 mm
  • Mona Sans 10/14
  • DM Mono
  • Mona Sans@tnum
  • Noto Serif Display
  • 5 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 119 ms
  • 263 líneas de código

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

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

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.

Página 2: el número y el filete salen del título; el nombre de la sección, del recuadro del canal, a la altura de la primera línea del texto. La planta de la parcela se apila debajo.

#2 · Reserva el canal para títulos y figuras

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

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

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

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

Sandbox
// ═══ 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') admite captionSide desde 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

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