Saltar al contingut principal
Recepta número 45

Receptari · Capítol 3 · Títols i obertures

Títols al marge, números penjats i títols en línia

Bases de concurs amb els títols de secció en una columna lateral, sobre les línies de base, números penjats entre columnes i títols en línia en vermell.

En aquesta pàgina
  • Mostra en castellà: encara no hi ha edició en català
  • Format 210 × 297 mm
  • Columna i mitja, espai entre columnes de 7 mm
  • Mona Sans 10/14
  • DM Mono
  • Mona Sans@tnum
  • Noto Serif Display
  • 5 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 119 ms
  • 263 línies de codi

En poques paraules

Les bases d'un concurs d'un ajuntament per convertir una antiga llotja en biblioteca. Els títols de secció van en un marge esquerre ample, a l'altura de la primera línia del text.

Què compondràs

En cinc pàgines A4, l'Ajuntament de Puerto Lince, un port inventat, convoca un concurs per convertir la seva llotja de 1931 en biblioteca. La maqueta és la d'un informe municipal suís. Una columna lateral de 50 mm baixa per l'esquerra de cada pàgina, i cada secció s'obre amb un número vermell i un filet negre que travessa tota la caixa. El seu títol, en Noto Serif Display, va a la columna lateral a l'altura de la primera línia. Els números dels apartats pengen a l'espai entre columnes, en DM Mono vermell, i els títols queden alineats amb el text. Els criteris del jurat comencen amb un terme en negreta vermella. La pàgina 1 posa un títol de 58 pt sobre el plànol de situació, la planta de la parcel·la va a la columna lateral de la pàgina 2 i un alçat de la llotja obre la 3.

Aquesta recepta respon a

  • Com numero els títols (1, 1.1, 1.1.1) i dono a cada nivell un estil diferent?
  • Com compono en columna i mitja, amb una columna de text ampla i una de lateral estreta?
  • Com decideixo on va una figura: al capdamunt de la pàgina, a l'amplada de les dues columnes, just aquí o al marge?
  • Com dono color als termes clau (en negreta o cursiva) en el text o dins dels requadres?

La resposta curta

script.js · línies 56–81al codi complet
// 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) } };

Ingredients

Tipografia
Mona Sans, Noto Serif Display, DM Mono (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Imprimeix el títol de la secció des d'un requadre al canal

El codi és la resposta curta de més amunt. Un títol reserva lloc fins a l'element més baix del seu disseny, així que el nom de la secció, dibuixat a la columna lateral a l'altura de la primera línia del text, baixaria el text una línia, i dues si n'ocupés dues. Per això el disseny del títol dibuixa només el número i el filet, i sideHeads() copia el text de cada ## Título en un :::callout que va just darrere. Amb span="side", aquest requadre surt del flux i es col·loca a la columna lateral, a la línia de la retícula en què continua el text (estils de requadre). El número i la ratlla porten reserve: false: si no, un requadre de la columna lateral deixa un espai de flotant, una línia, sota els elements del títol que hi cauen, i el títol baixaria a la segona línia del text. En un requadre, igual que en el text, la línia de base queda a 0,8 de l'alçada de línia, així que un requadre amb l'interlineat del text, 14 pt, posa cada línia d'un títol de dues línies sobre una línia de base del paràgraf del costat. El Markdown continua sent un simple ## Programa de necesidades. Com que el disseny del títol no imprimeix {titleText}, el Sandbox avisa amb Títol de l'encapçalament sense referenciar, encara que el requadre imprimeixi el títol.

Pàgina 2: el número i el filet surten del títol; el nom de la secció, del requadre de la columna lateral, a l'altura de la primera línia del text. La planta de la parcel·la s'apila a sota.

#2 · Reserva el canal per a títols i figures

script.js · línies 46–52al codi complet
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' deixa el text fora de la columna lateral (tipus de disposició). Després de l'obertura, a la columna lateral només hi ha els sis títols de secció i la planta de la parcel·la, que hi arriben amb span: 'side', i els peus de les taules 1 i 2. Per defecte, la columna lateral va a la dreta, i unes bases impreses a una cara la mantenen al mateix costat a totes les pàgines. sideColumnSide: 'left' la posa a l'esquerra, on cada títol de secció es llegeix abans que el seu text.

#3 · Penja els números i compon en línia els títols menors

script.js · línies 85–102al codi complet
// 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ítol de l'apartat comença a la vora esquerra de la columna. El seu número s'ancora amb 'left-of' a l'esquerra del títol, alineat a la dreta en una caixa de 12 mm que acaba 2 mm abans del text, de manera que números com 2.1 o 3.3 pengen a l'espai entre columnes i cada títol queda alineat amb el text que té a sota (posicionament d'elements). La caixa necessita una amplada fixa. Una amplada 'auto' es limita a la columna. A l'espai entre columnes es queda en zero, i el número no s'imprimeix. El nivell 2 imprimeix '{2}' i el nivell 3, '{2}.{3}', perquè amb {1} tots els números començarien per l'1 de l'únic H1 de les bases. Els criteris de la secció 4 són un quart nivell que no porta títol propi. Cada paràgraf comença amb un terme en negreta, i bodyText.boldColor l'imprimeix en vermell (text de cos). Cap altre paràgraf no porta negreta, i les cel·les de les taules prenen el color de tableStyle, així que la fila del total de la taula 1, també en negreta, es queda en negre.

#4 · Dona a cada figura i a cada taula la seva pròpia col·locació

script.js · línies 335–369al codi complet
// 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 parcel·la va a la columna lateral amb span: 'side' i s'apila sota el títol de la secció 2 (col·locació). width: PLAN_W / SIDE li dona 44 mm d'amplada, amb la qual cosa els seus 88 metres queden a escala 1:2000 exacta. L'alçat de la façana és un flotant 'top' a tota l'amplada de la pàgina. Es cita a la pàgina 2 i obre la 3, perquè un flotant mai no es col·loca per sobre de la seva referència. La taula del programa, citada també a la pàgina 2, flota al capdamunt de la columna de text de la pàgina 3, sota l'alçat. captionSide: true posa el seu peu a la columna lateral, a l'altura de la vora superior de la taula. El calendari va on el posa ::resource, al final de les bases, i captionSide: true posa també el seu peu a la columna lateral, al costat de l'apartat 6.3. Mona Sans compon per defecte xifres proporcionals, i en una columna alineada a la dreta 120 i 560 no queden xifra sota xifra. Un estil de taula amb nom, tableStyles: [{ id: 'figures', figureStyle: 'tabular' }], que la taula 1 tria amb styleId: 'figures', activa el tnum de la font: les seves xifres tabulars porten el zero barrat, a prop dels números en DM Mono. Les dates del calendari conserven les xifres pròpies de la font (estils de xifres).

#5 · Obre les bases amb el plànol de situació

script.js · línies 106–131al codi complet
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) } } },
  ] } };

Amb span: 'page', el contenidor de l'obertura és tota la caixa, columna lateral inclosa (extensió i disseny avançat). L'avanttítol i el títol es desplacen 57 mm, fins a la vora esquerra de la columna de text, i el plànol travessa la columna lateral i la de text. Sense això, el contenidor és la columna de text: tot es desplaça 57 mm a la dreta, i el títol, l'entradeta i el plànol surten de la pàgina per la vora dreta. El disseny reserva lloc fins al peu del plànol, que cau entre dues línies de la retícula. Un minHeight arrodonit a la línia següent deixa el filet de la secció 1 a la mateixa distància del seu text que el de les altres seccions. L'avanttítol, l'entradeta i la llegenda del plànol són atributs de la línia # Bases del concurso.

La recepta 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

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Variants

#Posa el filet només sobre la columna de text

Ancora el filet a la caixa del mateix títol en lloc del número i anirà de la vora esquerra del text a la dreta de la columna; a la columna lateral hi quedaran només el número i el nom de la secció.

-        color: col('ink'), placement: { ...at('#number', 'right-of', mm(2), RULE_Y),
+        color: col('ink'), placement: { ...at('container', 'top-left', mm(0), RULE_Y),

Errors freqüents

Error freqüent

Un requadre lateral comença a l'altura del bloc que segueix la seva tanca

A postext 1.4.1, un requadre amb span: 'side' es col·loca a la columna lateral a l'altura on ha arribat el text a la seva tanca, a la línia següent de la retícula i sota els requadres que ja hi hagi. Posa la tanca d'una glossa just abans del paràgraf que explica: si va després, la glossa comença al costat del paràgraf següent. Un requadre que passaria del peu de la columna puja fins que el seu peu coincideix amb el de la columna, si el requadre de sobre li deixa lloc; si tot i així no hi cap, espera la columna lateral de la pàgina següent. Notes al marge →

Error freqüent

Un flotant 'top' va a la pàgina següent a la seva cita tret que pugui encapçalar la pàgina que el cita

Per defecte un flotant no va mai per sobre de la seva pròpia referència, així que un flotant 'top' a tota l'amplada citat a la pàgina N obre la pàgina N+1. Amb placement.citingPage: true al recurs o al defaultPlacement del seu tipus (o layout.floatsAtCitingPage per a tot el llibre, des de postext 1.25) encapçala en canvi la pàgina N, i el text de damunt de la referència baixa sota seu, quan hi cap dins de layout.maxTopFraction i la línia que el cita continua en aquesta pàgina. No encapçala mai la primera pàgina d'un capítol ni una pàgina després d'un salt forçat: allà continua obrint la pàgina següent, i 'auto' o 'bottom' poden ocupar el peu de la pàgina que el cita. Col·locació de figures →

Comprovació del Sandbox · headingAdvancedWithoutTitleText

El text del títol no s'imprimeix

Per què. Un disseny avançat no té cap element que imprimeixi {titleText}, de manera que el text del títol mateix no apareix.

Solució. Afegeix un element de text amb {titleText}, tret que el títol hagi de ser invisible. Documentació →

  • Una figura lateral ocupa el capdamunt de la columna lateral a la pàgina que la cita, i un títol al marge que es col·loca després s'apila sota la figura, més avall que el principi de la seva pròpia secció. Cita les figures laterals després del títol de secció de la seva pàgina, com fa la secció 2 amb la planta de la parcel·la.
  • Una inserció en línia (position: 'here') admet captionSide des de postext 1.28: el peu del calendari va a la columna lateral a la pàgina 5, com el del programa a la pàgina 3. El peu necessita la columna lateral lliure al costat de la taula. On ja hi ha un títol lateral o una figura lateral, queda sota la taula.

Crèdits

Text
Text original, CC BY 4.0
Fonts
Mona Sans (SIL OFL 1.1) · Noto Serif Display (SIL OFL 1.1) · DM Mono (SIL OFL 1.1)
Sandbox