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

Receitas · Capítulo 8 · Tabelas

Programa de congresso com uma grade de células mescladas

Um programa de dois dias: mergeCells estende a plenária pelas três salas e uma oficina por dois horários, e cada palestra leva a cor da trilha.

  • Amostra em inglês: ainda sem edição em português
  • Refile 170 × 240 mm
  • 2 colunas, medianiz de 6 mm
  • Schibsted Grotesk 9,4/13
  • Chivo Mono
  • Unbounded
  • 6 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 131 ms
  • 214 linhas de código

Em poucas palavras

O programa impresso de um congresso de dois dias sobre impressão e letras. A grade de horários deixa uma palestra ocupar todas as salas ou dois horários, com cada tema na cor.

O que você vai compor

O programa impresso de um congresso de tipografia inventado em Girona, escrito em catalão. A capa desenha o ele geminado maiúsculo, L·L, com três módulos coloridos sobre preto. Cada dia abre com uma faixa preta de 76 mm e o dia do mês num algarismo de 144 pt. A grade de quinta-feira é uma tabela. A conferência de abertura ocupa uma célula preta que atravessa as três salas, e cada oficina ocupa dois horários. As partes do dia encabeçam suas linhas na largura da grade inteira, e cada palestra é um bloco na cor da trilha, identificada pelas amostras de cor da legenda. A grade é mais alta que uma página, por isso ocupa a página 3 e termina na 4 sob a linha de cabeçalho repetida. A grade de sexta-feira, mais curta, cabe inteira no pé da página de abertura.

Esta receita responde a

  • Como faço uma tabela com linhas de cabeçalho, células mescladas, larguras de coluna e alinhamento por célula?
  • Como divido uma tabela longa entre páginas com o cabeçalho repetido e um aviso de “continua”?
  • Como acrescento amostras de cor, como chave de cores, ao texto, às legendas ou às notas de tabela?
  • Como faço os rótulos “Figura” e “Tabela” saírem no idioma do meu documento?
  • Como faço uma abertura de capítulo com uma faixa de cor sangrada, um número de capítulo grande e o título?

A resposta curta

script.js · linhas 32–65no código completo
const ROOMS = ['Sala Gran', 'Sala de les Premses', 'Aula Taller'];
const TRACKS = { T: 'tipo', D: 'digital', E: 'edicio', '*': 'ink' }; // '*': a plenary
const at = (row, c) => ({ row, col: c });
const span = (r0, c0, r1, c1) => ({ start: at(r0, c0), end: at(r1, c1) });
const lines = (code, text) => text.split(' / ').map((line, i) => { // title, then speaker
  const run = i === 0 ? `**${line}**` : line;
  return code === '*' ? chip(run, 'blanc') : run; // paper-white type on the ink fill
}).join('\n'); // a line break in a cell starts a new paragraph
function schedule(text) { // '11.15 | T Title / Speaker | ^' · a bare line: a part of the day
  let m = { headerRowCount: 1, columnWidths: [12, 42, 42, 42], // weights of the 138 mm measure
    rows: [['Hora', ...ROOMS].map((room) => ({ content: room.toUpperCase(), isHeader: true }))] };
  for (const line of text.trim().split('\n')) {
    const [time, ...slots] = line.split(' | ');
    const r = m.rows.push(['', ...ROOMS].map(() => ({ content: '' }))) - 1; // four empty cells
    if (!slots.length) { // one cell across the table; a split keeps it with the rows it heads
      m = setCellContent(m, at(r, 0), chip(time.toUpperCase(), 'franja'));
      m = mergeCells(m, span(r, 0, r, 3));
      continue;
    }
    m = setCellContent(m, at(r, 0), chip(time, 'hora'));
    slots.forEach((slot, i) => {
      if (slot === '^') { // the session above runs on: one cell down both rows, centred in them
        m = mergeCells(m, span(r - 1, i + 1, r, i + 1));
        m = setAlignment(m, at(r - 1, i + 1), 'left', 'middle');
        return;
      }
      const [, code = '', body = slot] = /^([TDE*]) (.+)$/.exec(slot) ?? [];
      m = setCellContent(m, at(r, i + 1), lines(code, body));
      m = setCellBackground(m, at(r, i + 1), col(TRACKS[code] ?? 'pause'));
    });
    if (slots.length === 1) m = mergeCells(m, span(r, 1, r, 3)); // the same for all three rooms
  }
  return m; // mergeCells marks the covered cells hiddenBy (gotcha: merged-cells-hiddenby)
}

Ingredientes

Tipografia
Schibsted Grotesk, Unbounded, Chivo Mono (SIL OFL 1.1)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

#1 · Transforme cada linha do programa numa linha da tabela

O código é a resposta curta lá em cima. Cada dia é texto simples num arquivo de conteúdo, uma linha por horário: | separa as salas, uma letra indica a trilha, * marca uma plenária com fundo preto, / inicia cada linha depois do título e ^ prolonga a sessão do horário de cima. Todas as mesclagens saem de mergeCells. Uma linha com uma só sessão, como a plenária ou um intervalo, ocupa as três colunas de sala. Uma oficina ocupa a célula e a de baixo, e uma parte do dia (MATÍ, TARDA), escrita como uma linha sem |, ocupa as quatro colunas. As células cobertas por uma mesclagem continuam na grade, marcadas com hiddenBy, porque a coluna de uma célula é a posição na linha (Construir modelos de tabela). headerRowCount: 1 faz dos nomes das salas a linha de cabeçalho. Os columnWidths são pesos relativos, e 12 + 3 × 42 somam os 138 mm da medida, de modo que a coluna da hora tem 12 mm e cada sala 42 mm. setAlignment(…, 'left', 'middle') centraliza cada oficina na vertical nas duas linhas.

#2 · Deixe a quinta-feira continuar e a sexta ficar inteira

script.js · linhas 69–80no código completo
// The built-in types in Catalan, Figura and Taula; a grid's caption goes above it.
const resourceTypes = defaultResourceTypes('ca').map((type) => ({ ...type,
  ...(type.id === 'table' && { captionStyle: { position: 'above' } }),
  numberingTemplate: '{n}', resetOn: 'never' })); // Taula 1, Taula 2: one count, not per day
const SPLIT = { overflow: 'split', // the default; the other values are 'clip' and 'hide'
  // The engine's own Catalan strings are '(cont.)' and 'Continua': these spell them out.
  continuedSuffix: '(continuació)', // after the caption of every part but the first
  continuesMarker: 'Continua a la pàgina següent' }; // under every part but the last
// Thursday is cited on page 2 and placed at the top, so it opens page 3 (gotcha:
// top-float-next-page) and splits; Friday goes whole to the foot of the page that cites it.
const PLACE = { dijous: { position: 'top', span: 'page' },
  divendres: { position: 'bottom', span: 'page' } };

A grade de quinta-feira é citada na página 2 e posicionada no alto de uma página. Uma flutuante nunca sobe acima da referência, por isso a grade abre a página 3. Ela é mais alta que a página, e overflow: 'split' a corta entre duas linhas, nunca dentro de uma célula mesclada (Tabelas mais altas que a página). A página 3 termina com a linha das 17.30 e o aviso embaixo. A página 4 repete a linha de cabeçalho e a legenda inteira, com as amostras de cor, seguida de (continuació), e a nota só aparece sob esta última parte. A grade de sexta-feira vai para o pé de uma página e cabe sob o texto que a cita na página 5. defaultResourceTypes('ca') dá aos tipos os nomes em catalão, Figura e Taula. Os textos em catalão do motor para uma tabela dividida são (cont.) e Continua; o estilo de tabela os escreve por extenso. numberingTemplate: '{n}' com resetOn: 'never' numera as duas grades numa só série, Taula 1 e Taula 2.

#3 · Corte os preenchimentos em blocos

script.js · linhas 84–93no código completo
const tableStyle = { ...SPLIT, borderColor: col('paper'), borderWidth: pt(1.6), // grid rules
  headerBackground: col('ink'), headerColor: col('paper'), headerFontFamily: LABEL,
  headerFontSize: pt(7.5), bodyFontSize: pt(8.2),
  cellPadding: mm(1.5) };
const bare = (id, extra) => ({ id, backgroundEnabled: false, borderWidth: pt(0),
  paddingX: pt(0), ...extra }); // a chip that only changes the face, the size or the colour
const chipStyles = [bare('blanc', { color: col('paper') }), // the plenary's type, on ink
  bare('hora', { fontFamily: LABEL, fontSize: em(0.96), bold: true }),
  bare('franja', { fontFamily: LABEL, fontSize: em(0.92), bold: true, color: col('accent') }),
  bare('sala')]; // keeps each room of the plan's note on one line

setCellBackground, na resposta curta, dá a cada sessão a cor da paleta da trilha, e fios de 1,6 pt na cor do papel cortam os preenchimentos em blocos separados por linhas brancas (Estilo de tabela). Uma tabela tem uma única cor de texto para as células do corpo, por isso o texto branco da plenária é um chip cujo estilo define a cor e desativa o preenchimento, a borda e o espaçamento lateral do chip. Os horários e as partes do dia também são chips, em Chivo Mono (Estilos de chip). Um chip nunca quebra entre linhas; o título de uma plenária e a linha do palestrante cabem cada um numa linha da célula de três salas. Na nota da planta, o chip sala deixa o texto como está e mantém numa só linha o número e o nome de cada sala, como faria um espaço inseparável entre as palavras.

#4 · Abra cada dia com uma faixa

script.js · linhas 97–121no código completo
const BAND = 76, STRIP = 8, AIR = 7; // mm: band from the trim, its strip of modules, air below
const text = (id, content, family, size, color, placement, extra) => ({ kind: 'text', id,
  content, fontFamily: family, fontSize: pt(size), color: col(color), placement, align: 'left',
  overflow: 'wrap', ...extra }); // a long line wraps, in the running heads too
const pin = (to, edge, x, y, size) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
  ...(size && { size }) });
const caps = (size) => ({ fontWeight: 500, textTransform: 'uppercase',
  letterSpacing: pt(size * 0.18) });
const NUMERAL = 144; // pt
// mm: Unbounded 800's 1 at 144 pt starts its ink 0.76 mm into its box, the date's first capital
// at 8 pt 0.1 to 0.2 mm into its own (P 0.19, S 0.09): 0.6 mm to the left lines up the two inks
const BEARING = 0.6;
const BASELINE = 0.8; // a design line's baseline sits 0.8 down its box (lineHeight 1)
const opener = { enabled: true, minHeight: mm(BAND - PAGE.top + AIR), slot: { elements: [
  { kind: 'box', id: 'band', style: { backgroundColor: col('ink') },
    placement: pin('bleed', 'top-left', 0, 0, { width: 'fill', height: mm(BAND) }) },
  { kind: 'image', id: 'strip', resourceId: 'strip', placement: pin('page', 'top-left', 0,
    BAND - STRIP, { width: mm(PAGE.w), height: mm(STRIP) }) }, // on the band's foot
  text('date', '{attr.date}', LABEL, 8, 'edicio', pin('container', 'top-left', 0, 0), caps(8)),
  text('numeral', '{attr.day}', DISPLAY, NUMERAL, 'paper', pin('#date', 'below', -BEARING, 1),
    { fontWeight: 800, lineHeight: 1 }), // a 144 pt line box
  text('title', '{titleText}', DISPLAY, 26, 'paper', // its baseline level with the numeral's
    pin('#numeral', 'right-of', 5, BASELINE * (NUMERAL - 26) * PT),
    { fontWeight: 700, lineHeight: 1 }),
] } };

O design do título de nível 1 desenha a faixa: uma caixa de 76 mm de altura a partir da borda da sangria, com a tira de módulos ao longo da borda inferior. A data vem do atributo date do título, e o algarismo, de day. O 1 da Unbounded 800 em 144 pt começa a tinta 0,76 mm para dentro da caixa, e a primeira maiúscula da data entre 0,1 e 0,2 mm para dentro da dela, por isso o algarismo se desloca 0,6 mm para a esquerda, e a data, o algarismo e o texto começam a tinta a menos de 0,2 mm um do outro. O nome do dia fica à direita do algarismo, baixado BASELINE × (144 − 26) pt para que as duas linhas de base coincidam, porque num texto de design com lineHeight: 1 a linha de base fica a 0,8 da altura da caixa. minHeight reserva a página até 7 mm abaixo da faixa, e a grade de linhas de base arredonda essa reserva para cima, até 14 linhas, por isso a caixa da primeira linha de texto começa 10,2 mm abaixo da faixa. Com AIR = 0 quem define a altura é a caixa do próprio algarismo, que passa da borda inferior da faixa, e o texto começa 5,6 mm abaixo da faixa.

#5 · Recue as linhas seguintes das notas dos palestrantes

script.js · linhas 125–129no código completo
const paragraphStyles = [
  { id: 'bio', hangingIndent: mm(4) }, // the name at the column edge, the lines under it 4 mm in
  { id: 'colophon', fontFamily: LABEL, fontSize: pt(7.4), lineHeight: pt(LEAD * 0.75),
    textAlign: 'left', color: col('muted'), firstLineIndent: pt(0), marginTop: pt(LEAD) },
];

Cada palestrante é um parágrafo de um bloco :::paragraphs{style="bio"}. O nome em negrito começa na borda da coluna e as linhas de baixo entram 4 mm, em recuo deslocado, e assim os nomes se alinham coluna abaixo como num índice (Estilos de parágrafo).

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 053 · Conference programme with a merged schedule grid ═══════
// https://postext.dev/en/cookbook/conference-programme
// Code: MIT · Text: original, in Catalan (CC BY 4.0) · Drawings: generated in code (CC BY 4.0)
// Fonts: Schibsted Grotesk, Unbounded, Chivo Mono (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage,
  defaultResourceTypes, mergeCells, setCellContent, setCellBackground, setAlignment,
} from 'https://esm.sh/postext';

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

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
  ink: '#1d1b24', paper: '#ffffff', // a violet near-black; type on the ink fills
  tipo: '#b09cf2', digital: '#4fc7bb', edicio: '#f4b43a', // the three tracks: fills and swatches
  pause: '#ecebf1', // registration, breaks and meals
  accent: '#6a3ed3', // kickers, caption labels, the parts of the day
  muted: '#67636f', // running heads and notes
};
// 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 }) // defaults' id
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [TEXT, DISPLAY, LABEL] = ['Schibsted Grotesk', 'Unbounded', 'Chivo Mono'];
const PAGE = { w: 170, h: 240, top: 22, bottom: 20, inner: 17, outer: 15 }; // mm, mirrored
const LEAD = 13; // pt: the body's leading and baseline grid
const PT = 25.4 / 72; // mm in a point
const chip = (text, style) => `:chip[${text}]{style="${style}"}`;

// #region answer: a day's schedule as a table with merged cells, track fills and a head row
const ROOMS = ['Sala Gran', 'Sala de les Premses', 'Aula Taller'];
const TRACKS = { T: 'tipo', D: 'digital', E: 'edicio', '*': 'ink' }; // '*': a plenary
const at = (row, c) => ({ row, col: c });
const span = (r0, c0, r1, c1) => ({ start: at(r0, c0), end: at(r1, c1) });
const lines = (code, text) => text.split(' / ').map((line, i) => { // title, then speaker
  const run = i === 0 ? `**${line}**` : line;
  return code === '*' ? chip(run, 'blanc') : run; // paper-white type on the ink fill
}).join('\n'); // a line break in a cell starts a new paragraph
function schedule(text) { // '11.15 | T Title / Speaker | ^' · a bare line: a part of the day
  let m = { headerRowCount: 1, columnWidths: [12, 42, 42, 42], // weights of the 138 mm measure
    rows: [['Hora', ...ROOMS].map((room) => ({ content: room.toUpperCase(), isHeader: true }))] };
  for (const line of text.trim().split('\n')) {
    const [time, ...slots] = line.split(' | ');
    const r = m.rows.push(['', ...ROOMS].map(() => ({ content: '' }))) - 1; // four empty cells
    if (!slots.length) { // one cell across the table; a split keeps it with the rows it heads
      m = setCellContent(m, at(r, 0), chip(time.toUpperCase(), 'franja'));
      m = mergeCells(m, span(r, 0, r, 3));

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

#Arredonde os cantos da grade

Uma tabela dividida arredonda os cantos superiores da primeira parte, na página 3, e os inferiores da última, na página 4, onde só o da direita aparece porque a coluna da hora não tem preenchimento.

-  cellPadding: mm(1.5) };
+  cellPadding: mm(1.5), borderRadius: mm(2.5) };

#Numere a grade de cada dia separadamente

Contar por título de nível 1, como fazem os tipos predefinidos, dá Taula 1.1 e Taula 2.1 e transforma a planta em Figura 2.1; o estilo da capa não é numerado, de modo que a quinta-feira é o título 1.

-  numberingTemplate: '{n}', resetOn: 'never' })); // Taula 1, Taula 2: one count, not per day
+  numberingTemplate: '{h1}.{n}', resetOn: 'h1' })); // Taula 1.1, Taula 2.1: per day

Erros comuns

Erro comum

Células mescladas precisam de hiddenBy: use mergeCells

As células são posicionadas pela posição no array da linha, então uma célula mesclada precisa de células de preenchimento marcadas com hiddenBy onde ela se estende; omiti-las, como no HTML, desloca todas as colunas seguintes. Crie as mesclagens com mergeCells. Desde o postext 1.5, uma tabela com grade irregular é informada em doc.contentWarnings como raggedTableGrid, e parseTSV(text, { headerRows }) marca as linhas de cabeçalho. Tabelas a partir de dados →

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 →

Créditos

Texto
  • The programme’s Catalan text, both schedules included, written for this recipe, and the cover, band and floor-plan drawings, generated in code · Ignacio Ferro · CC BY 4.0
Fontes
Schibsted Grotesk (SIL OFL 1.1) · Unbounded (SIL OFL 1.1) · Chivo Mono (SIL OFL 1.1)
Sandbox