Em poucas palavras
Uma ficha escolar de ciências para construir um relógio de sol. Mostra boxes que se dividem entre duas colunas, passam para o alto da página seguinte ou ficam fixos no pé de uma página.
O que você vai compor
Quatro páginas de Taller de ciencias, um caderno escolar espanhol de atividades de laboratório: a Práctica 4, “Construye un reloj de sol” (Construa um relógio de sol). Na página 42, o aviso de segurança fica inteiro, e o procedimento de catorze passos, sobre fundo amarelo e com um selo de compasso no canto, começa no pé da coluna da esquerda e continua no alto da direita, na mesma medida e sem o título. A folha de dados de Madri sai do fluxo nessa página e encabeça a página 43, acima do texto. Um selo grafite, “Autoevaluación · 10 min”, fica fixo no pé da última página, com uma mão apontando na margem ao lado dele. Na abertura, uma faixa amarelo-sol traz um gráfico das sombras de uma vareta do meio-dia às cinco da tarde na latitude de Madri, e um painel lista os materiais em três colunas na largura da página.
Esta receita responde a
- Como deixo um boxe longo se dividir entre colunas e páginas, ou mantenho um boxe curto inteiro?
- Como levo um boxe para o alto ou o pé da página enquanto o texto continua correndo?
- Como fixo um selo ou um adesivo em uma posição exata da página?
- Como coloco um boxe atravessando as duas colunas no meio da página, como um painel “em números” com três blocos?
A resposta curta
const HAND = 6, GAP = 2, RULE = 0.75 * PT; // mm: the badge's hand, its gap, the hand's rule
const calloutStyles = [
// Kept whole: keepTogether defaults to true, so a box that does not fit the rest of a
// column moves on in one piece; only a box taller than a whole column splits anyway.
box('seguridad', bar('charcoal', 'aviso')),
// Split: the procedure fits a column, so it takes keepTogether: false to break where it
// falls instead of moving on whole: between steps, or inside one (splitMinLines, default
// 2, keeps at least two lines of the step on each side of the cut). The rest goes on in
// the next column or page without the title or the icon; a corner icon takes no room
// from the text, where an inline one would keep its column in both parts.
box('pasos', { keepTogether: false, background: col('light'),
icon: icon('compas', 7, { position: 'corner', cornerSide: 'outer' }) }),
// Floated: its fence adds placement="top", so the box leaves the flow where the fence
// stands and heads the next page, while the text after it fills this one.
box('datos', { span: 'page', background: col('tint') }),
// Pinned: 'fixed' sets the box on the page where its fence falls, at the bottom-left corner
// of the text block unless fixed.anchor says otherwise, and the column text keeps out of it.
// width: 'auto' shrink-wraps the title, so an empty fence prints a badge.
box('autoevaluacion', { placement: 'fixed', width: 'auto',
// Hang the hand and its rule in the margin (the outer one on this verso), so the badge
// itself lines up with the text: [hand][rule][GAP][badge].
fixed: { offset: { x: mm(-(HAND + RULE + GAP)) } },
marker: { ...icon('mano', HAND), gap: mm(GAP),
rule: { enabled: true, color: col('charcoal'), width: mm(RULE) } },
background: col('charcoal'), borderRadius: mm(3.2),
padding: { top: mm(1.6), right: mm(3.4), bottom: mm(1.6), left: mm(3.4) },
titleStyle: { ...TITLE, color: col('paper') } }),
// Across the page, in the flow: the text above it is cut level and resumes under it.
box('resumen', { span: 'page', backgroundEnabled: false,
stripe: { enabled: true, side: 'top', width: pt(2.5), color: col('charcoal') } }),
];
Ingredientes
- Funcionalidades
- Boxes que se dividem ou ficam inteirosBoxes flutuantesBoxes fixos e selosColuna de marca ao lado do boxeBoxes na largura da páginaColunas num boxe ou no textoÍcones e selos de canto nos boxesBoxesEspaço vertical explícitoCitações que posicionam as figurasPosicionamento de figurasEquilíbrio de colunasTabelas a partir de dadosEstilos de tabela com nomeFigura e Tabela no seu idiomaTítulos numeradosAberturas desenhadasAtributos de títuloCabeços e fóliosAvisos e diagnóstico
- Também usa
- Figuras exatamente aquiFaixa de capítulo em largura totalCabeços por tipo de páginaEstilos de parágrafoFiguras e tabelas como recursos
- Tipografia
- Host Grotesk, Commit Mono (SIL OFL 1.1)
- Materiais
- The shadow chart, the dial in profile and the icons, drawn in code in the page's palette (Ignacio Ferro, CC BY 4.0)
Preparo
#1 · Um estilo de base para todos os boxes
const TITLE = { fontFamily: LABEL, fontSize: pt(8), color: col('charcoal'),
textTransform: 'uppercase', letterSpacing: pt(1.2) }; // bold by default
const BOX_TYPE = { fontSize: pt(8.8), lineHeight: pt(12.4) }; // colours inherit bodyText
const box = (id, device) => ({ id, // margins: the defaults, snapped to whole grid lines
padding: { top: mm(3), right: mm(3.6), bottom: mm(3.4), left: mm(3.6) },
titleStyle: { ...TITLE, gap: mm(2) }, body: BOX_TYPE,
lists: { gap: mm(2), itemSpacing: pt(3) }, ...device });
const icon = (id, size, extra) => ({ kind: 'resource', resourceId: id, size: mm(size),
...extra });
// A side bar with its icon centred on it, 1.4 mm narrower than the bar.
const bar = (hue, id, width = 5.6) => ({ backgroundEnabled: false,
stripe: { enabled: true, side: 'left', width: mm(width), color: col(hue) },
icon: icon(id, width - 1.4) });
Todo estilo parte de box(): o título em monoespaçada, letra de 8,8 pt contra os 9,4 pt do texto, e o preenchimento interno. Cada um acrescenta então um único recurso: uma barra grafite no aviso de segurança, um fundo amarelo no procedimento, um tom de papel na folha de dados, um fio superior no resumo, uma pílula grafite no selo. O aluno distingue os boxes por esse recurso antes de ler qualquer título. No procedimento, o fundo também marca a continuação: a parte no alto da coluna da direita não tem título, e só o amarelo a liga aos passos 1 a 4 no pé da coluna da esquerda.
#2 · Inteiro, dividido, flutuante e fixo
O código está na resposta curta, mais acima. O procedimento mede 192 mm e numa coluna cabem 211, por isso um boxe mantido inteiro pularia para o alto da coluna da direita e deixaria 43 mm vazios no pé da esquerda. keepTogether: false deixa o boxe começar onde ele cai e continuar na coluna seguinte, ou na página seguinte, como mostra a segunda variação (o contêiner :::callout). A continuação perde o título e o ícone. Um ícone na linha tiraria dos passos uma coluna própria nas duas partes; por isso o compasso fica no canto externo do boxe, onde não ocupa largura. A linha de abertura da folha de dados tem placement="top", de modo que o boxe sai do fluxo na página 42 e encabeça a página seguinte. O selo é fixed, e um offset.x negativo leva a mão e o fio dela para a margem externa, para que a borda esquerda do selo fique alinhada com o texto.
#3 · Atravessar a página com um painel de três colunas
const materials = box('material', { span: 'page', background: col('sun'),
marginBottom: pt(LEAD), // one more grid line of air before the text resumes
padding: { top: mm(3.6), right: mm(4.4), bottom: mm(3.8), left: mm(4.4) },
columnGap: mm(GUTTER), // the page's gutter: the panel's columns sit as far apart as the text's
body: { ...BOX_TYPE, paragraphSpacing: false },
lists: { color: col('ink'), gap: mm(1.8), itemSpacing: pt(1) } });
Com span: 'page', o boxe de materiais atravessa as duas colunas. A introdução acima dele é cortada na mesma altura, e o texto continua em duas colunas embaixo dele (página 41). Dentro do contêiner, :::columns{count=3 breaks="5,9"} define onde começa cada coluna em vez de balanceá-las. breaks conta blocos filhos, e cada item de lista é um bloco, por isso a segunda e a terceira colunas abrem no quinto e no nono blocos, os rótulos em negrito. columnGap é a medianiz de 7 mm da página, e as colunas do painel ficam tão afastadas quanto as colunas de texto.
:::callout{type="material" title="Necesitarás"}
:::columns{count=3 breaks="5,9"}
**Para la esfera**
- Cartón pluma de 20 × 30 cm
- La plantilla de la esfera
- Pegamento y rotulador
**Para el gnomon y la base**
…
:::
:::#4 · Um amarelo para os fundos, outro mais claro para o boxe longo
const palette = {
ink: '#1b2430', // text
charcoal: '#2b2d42', // the safety bar, the summary's rule, the table head, the badge, titles
sun: '#f2b705', // the opener band and the materials panel: fields, never type
light: '#fad65a', // the procedure
tint: '#fff6d6', // the data sheet
rule: '#d7dde3', // hairlines
muted: '#5d6b78', // running heads, notes
paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at charcoal, so nothing prints blue.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.charcoal })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
O amarelo-sol fica reservado para as áreas de cor, a faixa e o painel, onde o grafite e a tinta preta têm contraste de 7,4:1 e 8,6:1. Como cor de letra sobre branco ele chegaria a 1,8:1, por isso nunca leva texto. O procedimento usa light, um amarelo mais pálido: a tinta preta tem contraste de 11:1 sobre ele, e a divisão ainda aparece na miniatura da galeria. A folha de dados usa tint, mais próximo do papel, para não ser confundida com o procedimento, o outro boxe com fundo da página dupla. main-color aponta para o grafite, e assim os valores padrão que a configuração não sobrescreve saem em grafite e não no azul do motor.
#5 · Abrir com uma faixa amarela
const BAND = 100; // mm from the trim to the foot of the band
const ART_W = 80; // mm: the width of the band's drawing, at the fore-edge
const AIR = 8; // mm between the band and the first line of text
const [TITLE_W, LEAD_W] = [104, 88]; // mm: the title's and the lead's measure
const onBand = { color: col('charcoal'), align: 'left' }; // a long title or lead wraps
const below = (id, y, width) => ({ anchor: { to: `#${id}`, edge: 'below' },
offset: { y: mm(y) }, size: { width: mm(width) } });
const opener = { enabled: true, minHeight: mm(BAND - TOP + AIR), slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('sun') },
placement: { anchor: { to: 'page', edge: 'top-left' }, size: { height: mm(BAND) } } },
{ kind: 'image', id: 'art', resourceId: 'sombras', placement: { anchor: { to: 'page',
edge: 'top-right' }, size: { width: mm(ART_W), height: mm(BAND) } } },
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', ...onBand, fontFamily: LABEL,
fontSize: pt(8.5), fontWeight: 700, letterSpacing: pt(1.7), textTransform: 'uppercase',
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(4) } } },
{ kind: 'text', id: 'title', content: '{titleText}', ...onBand, fontFamily: TEXT,
fontSize: pt(44), fontWeight: 800, lineHeight: 0.98, placement: below('kicker', 3, TITLE_W) },
{ kind: 'text', id: 'lead', content: '{attr.lead}', ...onBand, fontFamily: TEXT,
fontSize: pt(10.5), lineHeight: 1.4, placement: below('title', 5, LEAD_W) },
{ kind: 'text', id: 'meta', content: '{attr.meta}', ...onBand, fontFamily: LABEL,
fontSize: pt(7.4), fontWeight: 700, letterSpacing: pt(1.1), textTransform: 'uppercase',
placement: below('lead', 4, LEAD_W) },
] } };
A faixa é um elemento de caixa ancorado na página, e o desenho, um elemento de imagem junto ao corte; o chapéu, o olho e a linha de sessões vêm de atributos na linha do título. Como a faixa está ancorada na página, a abertura já reserva a altura até o pé da faixa, e o texto começaria 3,6 mm abaixo dela. minHeight: BAND - TOP + AIR pede 8 mm; a reserva se ajusta à linha seguinte da grade, e o texto começa 8,4 mm abaixo da faixa.
A receita completa
// ═══ Postext Cookbook · Nº 021 · Boxes that split, float and pin ══════════════════
// https://postext.dev/en/cookbook/boxes-split-float-pin
// Code: MIT · Text: original (CC BY 4.0) · Drawings: generated in code (CC BY 4.0)
// Fonts: Host Grotesk, Commit Mono (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// Four pages of a school lab workbook in Spanish, and five ways a box can sit on them.
import {
buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document (this recipe is Spanish only)
const RECIPE = 'boxes-split-float-pin';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: one yellow for fields, paler ones for two boxes, near-blacks for type and bars
const palette = {
ink: '#1b2430', // text
charcoal: '#2b2d42', // the safety bar, the summary's rule, the table head, the badge, titles
sun: '#f2b705', // the opener band and the materials panel: fields, never type
light: '#fad65a', // the procedure
tint: '#fff6d6', // the data sheet
rule: '#d7dde3', // hairlines
muted: '#5d6b78', // running heads, notes
paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at charcoal, so nothing prints blue.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.charcoal })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const TEXT = 'Host Grotesk'; // text and display
const LABEL = 'Commit Mono'; // labels: kickers, box titles, step numbers, heads, the table
const LEAD = 13.6; // pt: the body leading, the pitch of the baseline grid
const LINES = 44; // grid lines in a full column
const [TRIM_W, TRIM_H, TOP, INNER, OUTER, GUTTER] = [195, 255, 22, 18, 14, 7]; // mm
const PT = 25.4 / 72; // mm in a point
// #region look: the base of every box (a mono title, smaller type), then one device each
const TITLE = { fontFamily: LABEL, fontSize: pt(8), color: col('charcoal'),
textTransform: 'uppercase', letterSpacing: pt(1.2) }; // bold by default
const BOX_TYPE = { fontSize: pt(8.8), lineHeight: pt(12.4) }; // colours inherit bodyText
const box = (id, device) => ({ id, // margins: the defaults, snapped to whole grid lines
padding: { top: mm(3), right: mm(3.6), bottom: mm(3.4), left: mm(3.6) },
titleStyle: { ...TITLE, gap: mm(2) }, body: BOX_TYPE,
lists: { gap: mm(2), itemSpacing: pt(3) }, ...device });
const icon = (id, size, extra) => ({ kind: 'resource', resourceId: id, size: mm(size),
...extra });
// A side bar with its icon centred on it, 1.4 mm narrower than the bar.
const bar = (hue, id, width = 5.6) => ({ backgroundEnabled: false,
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
#Manter o procedimento inteiro
Sem essa configuração, o procedimento, que cabe numa coluna, vai inteiro para o alto da coluna da direita e deixa 43 mm vazios no pé da esquerda.
- box('pasos', { keepTogether: false, background: col('light'),
+ box('pasos', { background: col('light'),#Fazer a folha de dados flutuar para o pé
Com placement="bottom" em content.es.md, a folha de dados ocupa o pé da página 42, onde cai o delimitador dela. O procedimento que ela desloca começa no alto da coluna da direita e se divide na virada da página, terminando no alto da página 43.
-:::callout{type="datos" placement="top" title="Hoja de datos · Madrid, 40,4° N · 3,7° O"}
+:::callout{type="datos" placement="bottom" title="Hoja de datos · Madrid, 40,4° N · 3,7° O"}Erros comuns
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 →
Erro comum
A página 1 é ímpar: planeje com os números físicos
A página 1 fica à direita e a 2 é a primeira página par, então planeje as páginas duplas com os números físicos de página: uma abertura em página par fica de frente para a ímpar que vem depois dela. Quebras de página e de coluna →
Aviso de diagramação · calloutOverflow
Boxe ultrapassa a coluna
Por quê. Uma caixa que nenhum corte consegue dividir (uma figura, uma tabela ou um boxe aninhado nela mais alto que a coluna, ou um splitMinLines alto demais) foi colocada transbordando; o motor registra isso em doc.warnings e o Sandbox mostra na lista. Um boxe com span: 'side' mais alto que uma coluna lateral vazia também é colocado transbordando.
Correção. Encurte a caixa, deixe que ela se divida com keepTogether: false, reduza splitMinLines ou dê a ela outro span. Docs →
- Um boxe mais alto que uma coluna inteira se divide, diga o que disser
keepTogether. A configuração só decide nos boxes que cabem numa coluna, como este procedimento de 192 mm numa coluna de 211 mm. splitMinLines(2 por padrão) é o mínimo de linhas que um corte deixa de cada lado, contadas no passo que ele corta, por isso nenhum passo deixa uma linha sozinha. O texto antes do procedimento foi ajustado para que o corte caia entre os passos 4 e 5. Qualquer mudança no texto acima de um boxe dividido pode mover o corte, por isso confira onde ele cai depois de cada uma.- Um ícone na linha ocupa uma coluna própria, e a continuação a mantém, vazia: os passos perdem a largura do ícone nas duas partes. Um ícone no canto, ou uma faixa lateral onde o ícone se apoie, deixa a eles a medida inteira.
- Um boxe flutuante com
placement="top"encabeça a página seguinte àquela em que cai o delimitador dele; por isso, o delimitador vai na página anterior à que o boxe deve encabeçar. Aqui ela fica logo antes do procedimento, na página 42.
Créditos
- Receita
- Ignacio Ferro
- Texto
- The solar-noon table: computed for Madrid with NOAA's solar equations · NOAA Global Monitoring Laboratory · domínio público
- Imagens
- The shadow chart, the dial in profile and the icons, drawn in code in the page's palette · Ignacio Ferro · CC BY 4.0
- Fontes
- Host Grotesk (SIL OFL 1.1) · Commit Mono (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


