Pular para o conteúdo principal
Receita número 45

Receitas · Capítulo 3 · Títulos e aberturas

Títulos laterais, números pendurados e títulos em linha

Edital de concurso com títulos de seção num canal na margem, sobre as linhas de base do texto, números de subseção na medianiz e títulos em linha em vermelho.

Nesta página
  • Amostra em inglês: ainda sem edição em português
  • Refile 210 × 297 mm
  • Coluna e meia, medianiz de 7 mm
  • Mona Sans 10/14
  • DM Mono
  • Mona Sans@tnum
  • Noto Serif Display
  • 5 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 86 ms
  • 263 linhas de código

Em poucas palavras

O edital de uma prefeitura para escolher o projeto que vai transformar um antigo mercado de peixe numa biblioteca. Os títulos das seções ficam numa margem esquerda larga, na altura da primeira linha do texto ao lado.

O que você vai compor

Cinco páginas A4 de um edital de concurso de arquitetura, em que a prefeitura de Puerto Lince, um porto espanhol fictício, convoca projetos para transformar o mercado de peixe de 1931 na biblioteca da cidade. A diagramação segue os relatórios municipais suíços. Um canal de 50 mm desce pela esquerda de cada página, e cada seção abre com um número vermelho e um fio preto que atravessa toda a mancha. O título da seção fica no canal, em Noto Serif Display, na altura da primeira linha do texto. Os números das subseções ficam pendurados na medianiz, em DM Mono vermelho, de modo que todo título de subseção mantém a borda esquerda do texto. Os critérios de julgamento da seção 4 começam com termos em negrito vermelho. A página 1 traz um título de 58 pt sobre uma planta de situação, uma planta do terreno fica no canal da página 2, e uma elevação da frente do cais abre a página 3.

Esta receita responde a

  • Como numero os títulos (1, 1.1, 1.1.1) e dou a cada nível um estilo diferente?
  • Como monto uma diagramação em coluna e meia, com uma coluna de texto larga e uma coluna lateral estreita?
  • Como decido onde vai uma figura: no alto da página, sobre as duas colunas, exatamente aqui ou na margem?
  • Como dou cor aos termos-chave (em negrito ou itálico) no texto ou dentro dos boxes?

A resposta curta

script.js · linhas 56–81no 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

Tipografia
Mona Sans, Noto Serif Display, DM Mono (SIL OFL 1.1)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

#1 · Imprima o título da seção a partir de um boxe no canal

O código é a resposta curta lá em cima. Um título reserva espaço até o elemento mais baixo do design, de modo que um título desenhado no canal na altura da primeira linha da seção empurraria o texto uma linha para baixo, e duas no caso de um título de duas linhas. Por isso o design do título desenha só o número e o fio, e sideHeads() copia o texto de cada ## Title para um :::callout aberto logo depois do título. Com span="side", esse boxe sai do fluxo e fica no canal, na linha da grade onde o texto recomeça (estilos de boxe). O número e o fio definem reserve: false: do contrário, um boxe no canal mantém um espaço de flutuante, uma linha, embaixo dos elementos do título que estão ali, e o título cairia para a segunda linha do texto. Os boxes e o texto corrido põem a linha de base a 0,8 da altura da linha, por isso um boxe com a entrelinha de 14 pt do texto põe cada linha de um título de duas linhas sobre uma linha de base do parágrafo ao lado. O Markdown continua sendo um simples ## Schedule of accommodation. Como o design do título não imprime {titleText}, o Sandbox mostra o aviso Título não referenciado, embora o boxe imprima o título.

Página 2: o número e o fio vêm do título, e o título vem do boxe no canal, na altura da primeira linha do texto. A planta do terreno se empilha embaixo dele.

#2 · Reserve o canal para títulos e figuras

script.js · linhas 46–52no 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' mantém o texto fora do canal (tipos de diagramação). Depois da abertura, o canal guarda só os seis títulos de seção e a planta do terreno, os dois mandados para lá com span: 'side', e as legendas das tabelas 1 e 2. A coluna lateral fica por padrão em 'right', e um edital impresso só num lado da folha a mantém do mesmo lado em todas as páginas. sideColumnSide: 'left' a põe à esquerda, onde cada título de seção é lido antes do texto.

#3 · Pendure os números e componha os títulos menores em linha

script.js · linhas 85–102no 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

O título da subseção começa na borda esquerda da coluna. O número é ancorado 'left-of' do título, alinhado à direita numa caixa de 12 mm que termina 2 mm antes do texto, de modo que números como 2.1 e 3.3 ficam pendurados na medianiz e todo título se alinha com o texto embaixo dele (posicionamento de elementos). A caixa precisa de largura fixa. Uma largura 'auto' é limitada pela coluna. Lá fora, na medianiz, isso não deixa largura nenhuma, e o número não é desenhado. O nível 2 imprime '{2}' e o nível 3, '{2}.{3}', porque com {1} todo número começaria com o 1 do único H1 do edital. Os critérios da seção 4 são um quarto nível composto sem título. Cada parágrafo começa com um termo em negrito, e bodyText.boldColor o imprime em vermelho (texto do corpo). Nenhum outro parágrafo tem negrito, e as células de tabela tiram a cor de tableStyle, por isso a linha Total em negrito da tabela 1 continua preta.

#4 · Dê a cada figura e tabela o seu próprio posicionamento

script.js · linhas 335–369no 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.' }) }),
];

A planta do terreno vai para o canal com span: 'side' e se empilha sob o título lateral da seção 2 (posicionamento). width: PLAN_W / SIDE lhe dá 44 mm de largura, o que põe os 88 metros exatamente em 1:2000. A elevação da fachada é um flutuante 'top' na largura da página. Ela é citada na página 2 e abre a página 3, já que um flutuante nunca é posicionado acima da referência. A tabela do programa, também citada na página 2, flutua para o alto da coluna de texto da página 3, sob a elevação. captionSide: true põe a legenda no canal, na altura do topo da tabela. O calendário fica onde ::resource o coloca, no fim do edital, e captionSide: true põe a legenda dele no canal também, ao lado da seção 6.3. A Mona Sans compõe por padrão algarismos proporcionais, e numa coluna alinhada à direita 120 e 560 não ficam algarismo sob algarismo. Um estilo de tabela com nome, tableStyles: [{ id: 'figures', figureStyle: 'tabular' }], que a tabela 1 escolhe com styleId: 'figures', liga o tnum da fonte: seus algarismos tabulares têm o zero cortado, perto dos números em DM Mono. As datas do calendário mantêm os algarismos próprios da fonte (estilos de algarismos).

#5 · Abra o edital sobre a planta de situação

script.js · linhas 106–131no 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) } } },
  ] } };

Com span: 'page', o contêiner da abertura é a mancha inteira, canal incluído (span e design avançado). O chapéu e o título ficam a 57 mm da borda, na borda esquerda da coluna de texto, e a planta atravessa canal e coluna. Sem isso, o contêiner é a coluna de texto, todos os elementos andam 57 mm para a direita, e o título, a linha fina e a planta passam da borda direita da página. O design reserva espaço até o pé da planta, que cai entre duas linhas da grade. Um minHeight arredondado para a linha seguinte deixa o fio da seção 1 tão longe do texto quanto o fio de todas as seções seguintes. O chapéu, a linha fina e a legenda do mapa são atributos da linha # Competition brief.

A receita 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 = 'en'; // @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

O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)

Variações

#Ponha o fio só na coluna de texto

Ancore o fio na caixa do próprio título em vez do número, e ele vai da borda esquerda do texto até a borda direita da coluna, com só o número e o título no canal.

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

Erros comuns

Erro comum

Um boxe lateral começa na altura do bloco que vem depois do seu delimitador

No postext 1.4.1, um boxe com span: 'side' fica na coluna lateral na altura a que o texto chegou no seu delimitador, na linha seguinte da grade e abaixo dos boxes que já estiverem ali. Abra o delimitador de uma glosa logo antes do parágrafo que ela explica: se vier depois, a glosa começa ao lado do parágrafo seguinte. Um boxe que passaria do pé da coluna sobe até seu pé coincidir com o da coluna, se o boxe de cima permitir; se mesmo assim não couber, espera pela coluna lateral da página seguinte. Notas na margem →

Erro comum

Um flutuante 'top' vai para a página seguinte à sua citação, a menos que possa encabeçar a página que o cita

Por padrão um flutuante nunca fica acima da própria referência, então um flutuante 'top' na largura da página citado na página N abre a página N+1. Com placement.citingPage: true no recurso ou no defaultPlacement do seu tipo (ou layout.floatsAtCitingPage para o livro todo, desde o postext 1.25) ele encabeça a página N, e o texto acima da referência desce para baixo dele, quando cabe dentro de layout.maxTopFraction e a linha que o cita continua nessa página. Nunca encabeça a primeira página de um capítulo nem uma página depois de uma quebra forçada: ali continua abrindo a página seguinte, e 'auto' ou 'bottom' podem ocupar o pé da página que o cita. Posicionamento de figuras →

Verificação do Sandbox · headingAdvancedWithoutTitleText

Texto do título não impresso

Por quê. Um design avançado não tem nenhum elemento que imprima {titleText}; por isso, as palavras do próprio título nunca aparecem.

Correção. Acrescente um elemento de texto com {titleText}, a menos que o título deva ser invisível. Docs →

  • Uma figura lateral ocupa o alto do canal na página que a cita, e um título lateral aberto depois dela se empilha embaixo da figura, abaixo do início da própria seção. Cite as figuras laterais depois do título de seção da página delas, como a seção 2 cita a planta do terreno.
  • Uma inserção em linha (position: 'here') aceita captionSide desde o postext 1.28: a legenda do calendário fica no canal na página 5, como a do programa na página 3. A legenda precisa do canal livre ao lado da tabela. Onde já há um título lateral ou uma figura lateral, ela fica sob a tabela.

Créditos

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