Em poucas palavras
Um capítulo de um livro de biologia com seis tipos de boxes, como avisos e notas de laboratório. Cada tipo tem cor e símbolo próprios, para o aluno distinguir um do outro num relance.
O que você vai compor
O capítulo 2 de Living Matter, um livro didático de biologia do ensino médio numa página de 210 × 280 mm, abre sob o desenho de uma célula cortada pelo canto superior da página, com o número do capítulo no núcleo. Seguem seis tipos de boxe em três cores, cada um com um recurso gráfico próprio, para que o aluno distinga um objetivo de um aviso antes de lê-los. O magenta marca os objetivos de aprendizagem, sobre uma faixa com um alvo, e a autoavaliação, que tem um quadradinho com visto fora da moldura. O verde marca a dica de estudo, ao lado de um fio fino encimado por um selo com uma lâmpada, e o boxe de laboratório com os três pictogramas de segurança. O aviso é âmbar, com um selo de alerta no canto externo. O BOX 2.1 é lavanda, sob uma aba preta e um frasco. Os termos em negrito assumem a cor do boxe, magenta no BOX 2.1.
Esta receita responde a
- Como faço boxes de nota, dica ou aviso com ícone, faixa de cor e cantos arredondados?
- Como acrescento uma aba numerada (“BOXE 1-1”), um ícone de canto ou um ícone na margem com um fio?
- Como dou cor aos termos-chave (em negrito ou itálico) no texto ou dentro dos boxes?
A resposta curta
// box(id, hue, device) is the shared base: the hue colours the title, bullets and key terms.
const TAB = 5, BADGE = 7.4; // in mm: the tab's height (and offset), the warning badge's size
const calloutStyles = [
// The first style is also the one a missing or misspelt type falls back to.
box('objectives', 'band', { title: t({ en: 'In this chapter', es: 'En este capítulo' }),
background: col('tintBand'), stripe: { enabled: true, width: mm(7.5), color: col('band') },
icon: icon('target', 5) }), // on a side stripe (left by default) the icon is centred on it
box('feature', 'band', { background: col('mist'),
titleStyle: { fontFamily: 'Lexend', fontSize: pt(10.5), color: col('ink'), gap: mm(1.6) },
// Printed only where the fence has label="…": the tab, the flask beside it, a rule to them.
label: { fontFamily: LABEL, fontSize: pt(8), color: col('paper'), background: col('ink'),
position: 'top-left', // this verso's outer corner, above the badge ('top-right' by default)
height: mm(TAB), offset: mm(TAB), paddingX: mm(2.3), // offset = height: on the top edge
icon: { resourceId: 'flask', width: mm(4.4), gap: mm(1.2) },
rule: { enabled: true, color: col('ink'), width: pt(1.2) } } }),
box('warning', 'warnInk', { background: col('tintWarn'), borderRadius: mm(1.4),
border: { enabled: true, color: col('warn'), width: pt(0.75) },
// The badge hangs half past the outer corner: sides of half badge + GAP align the title.
padding: { top: mm(2.8), right: mm(BADGE / 2 + GAP), bottom: mm(3.2),
left: mm(BADGE / 2 + GAP) },
icon: icon('caution', BADGE, { position: 'corner', cornerSide: 'outer' }) }),
]; // straight into config(), followed by the 'more' styles
Ingredientes
- Funcionalidades
- BoxesAbas numeradas nos boxesÍcones e selos de canto nos boxesColuna de marca ao lado do boxeColunas num boxe ou no textoBoxes na largura da páginaBoxes flutuantesNegrito, itálico e suas coresPaleta de cores semânticaAberturas desenhadasFaixa de capítulo em largura totalImagens nos designs de páginaAtributos de títuloQuebras de linha nos títulosCabeços e fóliosMargens espelhadasFiguras e tabelas como recursosCitações que posicionam as figurasPosicionamento de figurasPáginas em um canvas
- Tipografia
- Noto Serif, Lexend, Barlow Semi Condensed (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Dar uma cor a cada tipo de boxe
const palette = { ink: '#1f2430', paper: '#ffffff', // text; type on stripes and tabs
band: '#ab2e78', tintBand: '#fae3ef', // the chapter's magenta: opener, objectives, self-check
tip: '#25734a', tintTip: '#e2f0e7', // study tips and lab work
warn: '#e39422', tintWarn: '#fcefd8', warnInk: '#94540a', // frame and badge; tint; its type
mist: '#e8e3f0', rule: '#dccfd8', muted: '#675e66' }; // feature box; lines in drawings; heads
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at the band, so nothing prints blue.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.band })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
Seis tipos de boxe dividem três matizes: magenta para os objetivos e a autoavaliação, verde para a dica de estudo e o laboratório, âmbar para o aviso. O BOX 2.1 tem fundo lavanda e usa o magenta nos termos-chave. Cada matiz tem uma versão clara para os fundos, e toda configuração de cor está ligada a uma entrada da paleta, de modo que mudar um matiz é editar um valor. Um texto de corpo tão pequeno precisa de contraste de 4,5:1. O magenta sobre o lavanda chega a 4,9:1, mas o âmbar sobre o fundo do aviso fica em 2,2:1, por isso o aviso guarda o âmbar para a moldura e o selo e compõe o título e os termos-chave em warnInk, um âmbar mais escuro, com 5,2:1.
#2 · Compartilhar todo o resto
const box = (id, hue, device) => ({ id, marginTop: pt(LEAD), marginBottom: pt(LEAD / 2),
padding: { top: mm(2.8), right: mm(3.4), bottom: mm(3.2), left: mm(3.4) },
titleStyle: { fontFamily: LABEL, fontSize: pt(8.5), color: col(hue), // bold by default
textTransform: 'uppercase', letterSpacing: pt(1.4), gap: mm(GAP) },
body: { fontFamily: LABEL, fontSize: pt(9.6), lineHeight: pt(12.6), color: col('ink'),
boldColor: col(hue), textAlign: 'left', firstLineIndent: pt(0), paragraphSpacing: true },
lists: { color: col(hue), gap: mm(2.2), itemSpacing: pt(2.4) }, // bullets and numbers
...device }); // the kind's title, fill and device: its spread wins over the base
// An SVG or bitmap resource, fitted into a square of that size (width × size with `width`).
const icon = (id, size, more) => ({ kind: 'resource', resourceId: id, size: mm(size), ...more });
box() reúne as configurações que todos os boxes compartilham: margens, preenchimento, letra do título e do texto, espaçamento das listas. O argumento hue colore o título, os marcadores e números e os trechos em negrito. body.boldColor deixa fluid mosaic model em magenta nos objetivos e cell wall em âmbar-acastanhado no aviso; o negrito no texto corrido continua em tinta (tipografia dentro de um boxe). Declarar calloutStyles substitui o único estilo que o motor traz de fábrica, um boxe cinza chamado note. Um bloco cujo type falta ou está escrito errado assume o primeiro estilo, por isso a lista começa pelos objetivos, que todo capítulo tem.
#3 · Faixa, aba e selo
O código é a resposta curta acima. A faixa dos objetivos tem 7,5 mm de largura e o alvo 5 mm, por isso o ícone fica dentro da cor com folga dos dois lados. O offset da aba é igual à height, o que apoia a aba na borda superior do boxe, longe do título. 'top-left' é o canto externo desta página par; o frasco vem depois da aba, e o fio corre pela borda superior do frasco até o canto oposto. position: 'corner' pendura o selo do aviso com metade da largura para fora da borda, e cornerSide: 'outer' o manda para o lado do corte, a esquerda nesta página par. Desse lado, o motor recua o título para desviar do selo, a menos que o preenchimento já cubra metade do selo mais o espaço do título; por isso o aviso tem preenchimento de BADGE / 2 + GAP nos dois lados, e o título se alinha com o texto. Só este boxe tem borderRadius: é o único com moldura, e um raio de 1,4 mm suaviza os cantos. Num boxe com faixa, o raio arredondaria também os cantos externos da faixa (estilos de boxe).
#4 · Mais três recursos gráficos
const BULB = 6.4; // the study tip's badge in mm: the text clears it
const moreStyles = [
box('tip', 'tip', { title: t({ en: 'Study tip', es: 'Para recordar' }),
backgroundEnabled: false, stripe: { enabled: true, width: pt(2.5), color: col('tip') },
// A stripe narrower than its icon: the badge sits on it at the top and hides it there.
padding: { top: mm(0.6), right: mm(0), bottom: mm(0.6), left: mm(BULB / 2 + 2) },
icon: icon('bulb', BULB) }),
box('safety', 'tip', { background: col('tintTip'), marginTop: pt(4), // under its heading
icon: icon('safety', 7, { width: mm(24.5), align: 'center' }) }), // 3 pictograms, 1 image
box('check', 'band', { background: col('tintBand'),
// Outside the frame: [marker][rule][gap][box], the rule as tall as the box.
marker: { kind: 'resource', resourceId: 'check', size: mm(7), align: 'top', gap: mm(3),
rule: { enabled: true, color: col('band'), width: pt(0.75) } } }),
];
A faixa da dica de estudo tem 2,5 pt de largura contra os 6,4 mm do selo da lâmpada, por isso ela sai como um fio fino com o selo por cima da ponta de cima; um preenchimento à esquerda de meio selo mais 2 mm mantém o texto longe da lâmpada. icon.width encaixa uma imagem numa caixa larga em vez de num quadrado, de modo que os três pictogramas de segurança, desenhados como uma só imagem de 24,5 mm, formam a coluna de ícone do boxe de laboratório, centralizada em relação ao texto. O indicador da autoavaliação fica fora da moldura, na ordem indicador, fio, espaço, boxe. O quadradinho sobre um fio de 0,75 pt a distingue da dica de estudo, cujo selo é redondo. O bloco acrescenta span="page" placement="bottom" para que a autoavaliação flutue até o pé da página 29.
#5 · Os ícones são recursos
const svgResource = (id, width, height, extra) => ({ id, typeId: 'figure', kind: 'svg',
svg: { fileId: `${id}.svg`, width, height }, createdAt: 0, updatedAt: 0, ...extra });
const pageTop = { position: 'top', span: 'page' }; // a 'top' float opens the page after its :ref
const resources = [
// Uncited, so never placed as figures: the box styles and the opener use them by id.
...['target', 'bulb', 'caution', 'check'].map((id) => svgResource(id, 240, 240)),
svgResource('flask', 200, 240), svgResource('safety', 760, 240), svgResource('cell', 2000, 2000),
svgResource('mosaic', 3480, 1240, { placement: pageTop, caption: t({
en: 'The fluid mosaic: magenta phospholipids, green proteins, an amber carrier with its '
+ 'glucose, grey cholesterol, amber sugars.', // one line: the page is wide
es: 'El mosaico fluido: fosfolípidos magenta, proteínas verdes, transportadora ámbar con su '
+ 'glucosa, colesterol gris, azúcares ámbar.' }),
altText: t({ en: 'A cell membrane in section', es: 'Una membrana celular en sección' }) }),
svgResource('fusion', 1800, 500, { placement: { position: 'here' }, caption: t({
en: 'Mouse proteins in green, human proteins in magenta (the red dye): the two cells, the '
+ 'hybrid just after fusion and the same hybrid 40 minutes later.',
es: 'En verde, las proteínas de ratón; en magenta, las humanas (el colorante rojo): las dos '
+ 'células, el híbrido recién fusionado y el mismo híbrido 40 minutos después.' }),
altText: t({ en: 'Two cells fusing into a hybrid', es: 'Dos células que se fusionan' }) }),
svgResource('osmosis', 3480, 860, { placement: pageTop, caption: t({
en: 'Red blood cells in a hypertonic, an isotonic and a hypotonic solution. Arrows show the '
+ 'net flow of water.',
es: 'Glóbulos rojos en una disolución hipertónica, una isotónica y una hipotónica. Las flechas '
+ 'indican el flujo neto de agua.' }),
altText: t({ en: 'Blood cells in three solutions', es: 'Glóbulos rojos en tres medios' }) }),
];
Todos os ícones, o frasco ao lado da aba e a célula da abertura são recursos SVG declarados com o conteúdo e registrados pelo id de arquivo. Um estilo os chama pelo id de recurso, e como o texto nunca os cita, nenhum deles vira uma figura numerada. Glifos como ✓ ou ☞ seriam mais curtos de escrever, mas os arquivos latin do Fontsource que as páginas carregam não os têm: o canvas os pegaria emprestados de uma fonte do sistema, e um PDF os descartaria. Os desenhos também não levam palavras: as legendas é que dão o nome das cores, e assim um mesmo desenho serve às duas edições.
#6 · Abrir o capítulo com uma célula
const text = (id, content, family, size, color, placement, extra) => ({ kind: 'text', id,
content, fontFamily: family, fontSize: pt(size), color: col(color), placement,
align: 'left', ...extra }); // an opener's texts wrap by default
const below = (id, y, width) => ({ anchor: { to: `#${id}`, edge: 'below' },
offset: { y: mm(y) }, size: { width: mm(width) } });
const chapter = t({ en: 'Chapter {chapterNumber}', es: 'Capítulo {chapterNumber}' });
const opener = { enabled: true, minHeight: mm(66), slot: { elements: [
{ kind: 'image', id: 'cell', resourceId: 'cell', placement: { anchor: { to: 'page',
edge: 'top-right' }, offset: { x: mm(58), y: mm(-71) }, size: { width: mm(150) } } },
text('numeral', '{chapterNumber}', 'Lexend', 118, 'paper', { anchor: { to: 'page',
edge: 'top-right' }, offset: { x: mm(-OUTER), y: mm(14) } },
{ fontWeight: 800, lineHeight: 1, align: 'right' }),
text('kicker', `${chapter} · {attr.unit}`, LABEL, 9, 'band', { anchor: { to: 'container',
edge: 'top-left' }, offset: { y: mm(3) } },
{ fontWeight: 700, letterSpacing: pt(1.8), textTransform: 'uppercase' }),
text('title', '{titleText}', 'Lexend', 34, 'ink', below('kicker', 2.5, 112),
{ fontWeight: 700, lineHeight: 1.04 }),
text('lead', '{attr.lead}', 'Noto Serif', 10.5, 'ink', below('title', 5, 98),
{ italic: true, lineHeight: 1.42 }),
] } };
A célula é um elemento de imagem ancorado no canto superior direito da página e empurrado para além dele, de modo que aparece sobretudo o quarto inferior esquerdo, com o numeral no núcleo. Os dois ficam dentro dos 66 mm que minHeight reserva para a abertura. O antetítulo e a linha fina vêm da linha do título, # Cells and \\ Membranes {unit="The cell" lead="…"}, e o \\ quebra o título só na abertura.
A receita completa
// ═══ Postext Cookbook · Nº 008 · A family of textbook boxes ═══════════════════════
// https://postext.dev/en/cookbook/textbook-box-family
// Code: MIT · Text: original (CC BY 4.0) · Drawings and icons: generated in code (CC BY 4.0)
// Fonts: Noto Serif, Lexend, Barlow Semi Condensed (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'textbook-box-family';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: three hues for six kinds of box; everything links to an entry
const palette = { ink: '#1f2430', paper: '#ffffff', // text; type on stripes and tabs
band: '#ab2e78', tintBand: '#fae3ef', // the chapter's magenta: opener, objectives, self-check
tip: '#25734a', tintTip: '#e2f0e7', // study tips and lab work
warn: '#e39422', tintWarn: '#fcefd8', warnInk: '#94540a', // frame and badge; tint; its type
mist: '#e8e3f0', rule: '#dccfd8', muted: '#675e66' }; // feature box; lines in drawings; heads
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at the band, so nothing prints blue.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.band })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
// Label face (box text and titles, tabs, captions, heads); leading in pt; outer margin in mm
const LABEL = 'Barlow Semi Condensed', LEAD = 13.4, OUTER = 16, GAP = 1.5; // GAP: title gap, mm
// #region base: what every box shares; each kind brings its colour and its one device
const box = (id, hue, device) => ({ id, marginTop: pt(LEAD), marginBottom: pt(LEAD / 2),
padding: { top: mm(2.8), right: mm(3.4), bottom: mm(3.2), left: mm(3.4) },
titleStyle: { fontFamily: LABEL, fontSize: pt(8.5), color: col(hue), // bold by default
textTransform: 'uppercase', letterSpacing: pt(1.4), gap: mm(GAP) },
body: { fontFamily: LABEL, fontSize: pt(9.6), lineHeight: pt(12.6), color: col('ink'),
boldColor: col(hue), textAlign: 'left', firstLineIndent: pt(0), paragraphSpacing: true },
lists: { color: col(hue), gap: mm(2.2), itemSpacing: pt(2.4) }, // bullets and numbers
...device }); // the kind's title, fill and device: its spread wins over the base
// An SVG or bitmap resource, fitted into a square of that size (width × size with `width`).
const icon = (id, size, more) => ({ kind: 'resource', resourceId: id, size: mm(size), ...more });
// #endregion
// #region answer: three devices: an icon on a wide stripe, a numbered tab, an outer badge
// box(id, hue, device) is the shared base: the hue colours the title, bullets and key terms.
const TAB = 5, BADGE = 7.4; // in mm: the tab's height (and offset), the warning badge's size
const calloutStyles = [
// The first style is also the one a missing or misspelt type falls back to.
box('objectives', 'band', { title: t({ en: 'In this chapter', es: 'En este capítulo' }),
background: col('tintBand'), stripe: { enabled: true, width: mm(7.5), color: col('band') },
icon: icon('target', 5) }), // on a side stripe (left by default) the icon is centred on it
box('feature', 'band', { background: col('mist'),
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
#Pôr um boxe nas duas colunas
span="page" num bloco estende qualquer tipo de boxe pelas duas colunas; o BOX 2.1 também aninha um grupo :::columns para pôr a figura ao lado do texto.
-:::callout{type="warning" title="Membrane or wall?"}
+:::callout{type="warning" title="Membrane or wall?" span="page"}#Pendurar o selo do lado da lombada
'inner' leva o selo para o lado da lombada, à esquerda numa página ímpar e à direita numa par; deixe espaço desse lado para a metade que fica fora do boxe.
- icon: icon('caution', BADGE, { position: 'corner', cornerSide: 'outer' }) }),
+ icon: icon('caution', BADGE, { position: 'corner', cornerSide: 'inner' }) }),#Pôr a aba no canto direito
'top-right', o padrão, espelha o rótulo inteiro: a aba vai para o canto direito, o frasco para a esquerda dela, e o fio vem da esquerda.
- position: 'top-left', // this verso's outer corner, above the badge ('top-right' by default)
+ position: 'top-right',Erros comuns
Erro comum
Os arquivos do Fontsource cobrem letras, não símbolos
O kit incorpora o arquivo latin do Fontsource de cada fonte e, quando o texto usa esses caracteres, o arquivo latin-ext para č, ł, † e o arquivo greek para α, χ (em uma família que o tenha: Lora e Gelasio não têm), na tela e no PDF. Símbolos como →, ≈, ✓ e ★ não estão em nenhum desses arquivos e somem no PDF: desenhe-os, componha-os como matemática ou escolha uma fonte cujos arquivos os tenham. Fontes incorporadas ao PDF →
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 · unknownCalloutType
Tipo de boxe desconhecido
Por quê. Um :::callout cita um tipo que calloutStyles não define; por isso, ele assume o primeiro estilo sem avisar.
Correção. Defina o estilo ou corrija o atributo type. Docs →
- A aba só é impressa quando o bloco tem
label="BOX 2.1"e o estilo tem um objetolabel. Um estilo sem ele ignora o atributo. - O Postext não numera os boxes. O rótulo é o texto literal do bloco, por isso você digita cada número, BOX 2.1, BOX 2.2, à mão.
- Um selo de canto fica com metade da largura para fora da lateral do boxe, sobre a margem do lado externo da página. Na outra coluna da mesma página, ele invade a medianiz, por isso mantenha os boxes com selo na coluna externa ou deixe espaço para eles.
- O
lists.colorde um boxe colore igualmente os marcadores e os números das listas numeradas, de modo que aqui os passos e as perguntas numerados saem na cor do boxe. Para colorir só os marcadores de um boxe, deixelists.colorfora do estilo dele e definaunorderedLists.colorpara o documento; os números mantêm entãoorderedLists.color.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fontes
- Noto Serif (SIL OFL 1.1) · Lexend (SIL OFL 1.1) · Barlow Semi Condensed (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)


