Em poucas palavras
Um guia de bolso de passeios por Lisboa. Cada passeio tem a cor, que aparece numa aba na borda da página para você achá-lo com o polegar.
O que você vai compor
As sete primeiras páginas de Lisbon on Foot, um guia de bolso de 120 × 200 mm. A capa é uma parede de azulejos azuis e brancos com o título numa placa emoldurada como as placas de rua de Lisboa, e a página 2 apresenta os três passeios com um mapa das rotas. Cada passeio tem uma cor, terracota para Alfama e amarelo para a Baixa, e uma aba no corte da frente mostra essa cor e o número do passeio na mesma altura em todas as páginas dele. Com o passeio mudam também a faixa da abertura, as paradas numeradas, o cabeço da página ímpar e o tom do boxe “Don’t miss”. A página par em branco que empurra o passeio 2 para uma página ímpar é pintada no amarelo do passeio 2 e traz o número. O texto é Albert Sans, alinhado à esquerda; os nomes são DM Serif Display, e os rótulos, Asap Condensed.
Esta receita responde a
- Como oculto os cabeços nas aberturas e nas páginas em branco, ou pinto uma página par em branco com a cor da parte?
- Como configuro os cabeços: título do livro na página esquerda, título do capítulo na direita e fólio do lado de fora?
- Como acrescento uma aba numerada (“BOXE 1-1”), um ícone de canto ou um ícone na margem com um fio?
- Como acrescento amostras de cor, como chave de cores, ao texto, às legendas ou às notas de tabela?
A resposta curta
// '# Alfama {style="alfama"}' opens a section that runs to the next level-1 heading. Its
// palette gives band, bandInk, onBand and wash the walk's values on the section's pages,
// in the page furniture and in the text alike.
const walkStyles = Object.keys(WALKS).map((id) => ({ id, palette: WALKS[id] }));
// The tab has one size and one place on every page, hanging from the foot of the opener
// band; only its colour and its number change from walk to walk.
const TAB = { y: BAND, width: 7, height: 24 }; // mm
const tab = (parity, edge) => text(`tab-${parity}`, '{chapterNumber}', {
...label, fontSize: pt(11), fontWeight: 700, color: col('onBand'), align: 'center',
verticalAlign: 'middle', overflow: 'clip', box: { backgroundColor: col('band') },
parity, pages: 'all', // the walk's first page is an 'opener' page: the tab goes there too
}, { ...at('bleed', edge, 0, TAB.y), ...size(mm(TAB.width), mm(TAB.height)) });
const tabs = [tab('odd', 'top-right'), tab('even', 'top-left')]; // on the fore-edge
// The blank verso that pushes a walk onto a recto belongs to that walk (gotcha:
// section-last-wins), so the field takes the next walk's colour and its numeral the number.
const blankPage = [
box('field', { backgroundColor: col('band') },
{ ...at('bleed', 'top-left', 0, 0), ...size('fill', 'fill') }),
tileImage('field-tiles', 'tiles-page', 'top-left', 'fill', 'auto'),
text('field-number', '{chapterNumber}', { ...display, fontSize: pt(220), lineHeight: 1,
color: col('onBand'), overflow: 'clip' }, at('page', 'bottom-left', MARGIN.outer, -24)),
].map((el) => ({ ...el, pages: 'blank' }));
Ingredientes
- Funcionalidades
- Faixas sangradas e guias lateraisCores por parteCabeços por tipo de páginaCabeços por seçãoEstilos de títuloAberturas desenhadasAtributos de títuloTítulos numeradosCapítulos que abrem em página ímparCabeços e fóliosPaleta de cores semânticaChips no textoÍcones e selos de canto nos boxesAmostras de corFiguras exatamente aquiTipos de recurso personalizadosImagens nos designs de páginaTextos, fios e caixas nos designs de páginaCapas, folhas de rosto e colofõesPáginas em um canvas
- Também usa
- BoxesEquilíbrio de colunasCor do papelQuebras de página e de colunaEstilos de parágrafoFiguras e tabelas como recursosQuebras de linha nos títulosCapítulos sem número
- Tipografia
- Albert Sans, DM Serif Display, Asap Condensed (SIL OFL 1.1)
- Materiais
- The tiles, the map of the routes and its pins, drawn in code (Ignacio Ferro, CC BY 4.0)
Preparo
#1 · Dar nome às cores que um passeio muda
const palette = {
ink: '#1b2430', // text: a blue-black
paper: '#fffdf8', // the page
band: '#1f4e9c', // the section colour: tile blue until a walk replaces it
bandInk: '#1d4a94', // the section colour for type on paper
onBand: '#ffffff', // type set on the band
wash: '#e8eef8', // the section's box tint
muted: '#5e6875', // running heads, notes, chip outlines
};
// Each walk's values for those four. Baixa yellow is too light for white type, so its
// onBand is the ink. The text is recoloured by value, so the four base values must differ.
const WALKS = {
alfama: { band: '#b9533a', bandInk: '#a1432b', onBand: '#ffffff', wash: '#f7e7e0' },
baixa: { band: '#e2b23d', bandInk: '#7d5a0f', onBand: '#1b2430', wash: '#fbf0d5' },
belem: { band: '#2b7a78', bandInk: '#236866', onBand: '#ffffff', wash: '#e1eeed' },
};
const NAMES = { alfama: 'Alfama', baixa: 'Baixa', belem: 'Belém' };
// A walk's palette follows the paletteId; the hex beside it is the colour's base value.
const col = (id) => ({ hex: palette[id] ?? WALKS[id].band, model: 'hex', paletteId: id });
const entry = (id, hex) => ({ id, name: id, value: { hex, model: 'hex' } });
const colorPalette = [
...Object.entries(palette).map(([id, hex]) => entry(id, hex)),
...Object.entries(WALKS).map(([id, w]) => entry(id, w.band)), // for :swatch{color="alfama"}
entry('main-color', palette.ink), // the engine's defaults link here: nothing prints blue
];
A palette de um estilo de título substitui entradas pelo id nas páginas da seção (estilos de título), por isso toda cor que deve acompanhar o passeio se liga a uma de quatro entradas: band para os campos de cor, a aba e os círculos das paradas, bandInk para o texto sobre o papel, onBand para o texto sobre um campo e wash para o boxe. O branco sobre o amarelo da Baixa dá um contraste de 2:1, por isso o onBand desse passeio é a tinta, com 8:1. Os elementos de design seguem o id, enquanto o texto é recolorido pelo valor: uma cor igual ao hex base de uma entrada assume o valor do passeio, e por isso os quatro valores base são todos diferentes. O título do boxe na página 4 e a linha que manda você para o passeio 2 na página 5 são texto em bandInk, e os dois saem em terracota.
#2 · Deixar os cabeços só nas páginas de texto
const head = (id, content, parity, placement, style = {}) => ({ ...text(id, content, {
...label, fontSize: pt(7.8), letterSpacing: pt(1.3), color: col('muted'), overflow: 'clip',
...style }, placement), parity, pages: 'body' }); // never on openers or blank pages
const folio = { fontSize: pt(8.5), fontWeight: 700, color: col('ink') };
// Anchored to the page: from its top-right corner a negative x runs inwards
// (gotcha: negative-offsets).
const heads = [
head('verso-folio', '{pageNumber}', 'even', at('page', 'top-left', MARGIN.outer, HEAD.y), folio),
head('verso-title', '{title}', 'even', at('page', 'top-left', MARGIN.outer + HEAD.gap, HEAD.y)),
head('recto-title', `${t({ en: 'Walk', es: 'Paseo' })} {chapterNumber} · {chapterTitle}`, 'odd',
at('page', 'top-right', -(MARGIN.outer + HEAD.gap), HEAD.y), { color: col('bandInk') }),
head('recto-folio', '{pageNumber}', 'odd', at('page', 'top-right', -MARGIN.outer, HEAD.y), folio),
];
// Array order is paint order: the blank page's field comes last and covers the tab there.
const header = { elements: [...heads, ...tabs, ...blankPage] };
// A walk's first page has no running head: its folio drops to the foot.
const footer = { elements: [{ ...head('drop-folio', '{pageNumber}', 'all',
at('container', 'top', 0, 7), folio), pages: 'opener', align: 'center' }] };
// Page 2 comes before Walk 1, where {chapterNumber} is empty, so its header has no tabs. With
// the level's break off (gotcha: style-inherits-break), it is a 'body' page.
const introStyle = { id: 'intro', numbered: false, header: { elements: heads },
breakBefore: { enabled: false }, advancedDesign: { enabled: false },
fontSize: pt(24), lineHeight: pt(2 * LEAD), marginBottom: pt(LEAD / 2) };
Depois da diagramação, cada página recebe um papel (elementos de texto). A primeira página de um passeio é opener, porque o título dela força a quebra de página; a página de enchimento antes de uma ímpar é blank; as demais são body. Os cabeços levam pages: 'body', de modo que as aberturas das páginas 3 e 7 e a página em branco 6 ficam sem eles, e o fólio no pé leva 'opener'. A página par imprime o {title} do front matter, e a ímpar, Walk {chapterNumber} · {chapterTitle} em bandInk, terracota na página 5. As abas da resposta curta levam 'all'. O campo da página em branco vem depois delas na lista, e como a ordem da lista é a ordem de pintura, ele cobre a aba na página 6. A página 2, a introdução, vem antes do passeio 1, por isso ali {chapterNumber} fica vazio, e o estilo dela tem um header próprio com os quatro cabeços e sem abas. Sem ele, a página 2 imprimiria uma aba azul vazia.
#3 · Abrir cada passeio sob a sua faixa e numerar as paradas
const walkLevel = { level: 1, breakBefore: { enabled: true, parity: 'odd' }, // a recto
// The band ends 30 mm into the text area; a floor of 8 grid lines, with nothing added
// under it, starts the text 7.3 mm below the band.
marginBottom: pt(0), advancedDesign: { enabled: true, minHeight: pt(8 * LEAD), slot: {
elements: [
box('band', { backgroundColor: col('band') },
{ ...at('bleed', 'top-left', 0, 0), ...size('fill', mm(BAND)) }),
tileImage('tiles', 'tiles-band', 'top-right', 'auto', mm(BAND)),
text('kicker', `${t({ en: 'Walk', es: 'Paseo' })} {chapterNumber}`, { ...label,
fontSize: pt(9), letterSpacing: pt(2), color: col('onBand') },
at('page', 'top-left', MARGIN.inner, 17)), // walks open on rectos: inner is left
text('title', '{titleText}', { ...display, fontSize: pt(34), lineHeight: 1,
color: col('onBand') }, { ...at('#kicker', 'below', 0, 1), ...size(mm(70), 'auto') }),
text('route', '{attr.route}', { fontFamily: 'Albert Sans', italic: true, fontSize: pt(10),
color: col('onBand') }, { ...at('#title', 'below', 0, 1.5), ...size(mm(70), 'auto') }),
] } } };
const STOP = 5.4; // mm: the diameter of a stop's circle
const stopLevel = { level: 3, numberingTemplate: '{3}', // restarts at every walk
// A grid line above a stop and no margin under it, so the circle can sit 3.2 mm down its
// two grid lines: about 8.3 mm of white above a stop and 2.1 under it, 6.4 between paragraphs.
marginTop: pt(LEAD), marginBottom: pt(0), advancedDesign: { enabled: true, slot: { elements: [
text('number', '{number}', { ...label, fontSize: pt(9), fontWeight: 700, align: 'center',
verticalAlign: 'middle', color: col('onBand'), overflow: 'clip',
box: { backgroundColor: col('band'), borderRadius: mm(STOP / 2) } },
{ ...at('container', 'top-left', 0, 3.2), ...size(mm(STOP), mm(STOP)) }),
text('name', '{titleText}', { ...display, fontSize: pt(13.5), lineHeight: 1.1,
color: col('ink') }, { ...at('#number', 'right-of', 2.4, 0.2), ...size('fill', 'auto') }),
] } } };
A faixa é ancorada à sangria, que aqui é o refile, e avança 30 mm na mancha gráfica. O design termina com a faixa, e minHeight reserva oito linhas da grade, 37,3 mm; a abertura fica com a maior das duas alturas, por isso nas páginas 3 e 7 o texto começa 7,3 mm abaixo da faixa. Cada parada é um título de nível 3 cujo design põe {number} num círculo de 5,4 mm preenchido com band. O modelo {3} recomeça a cada passeio, já que um título de nível 1 zera os contadores mais profundos, e os pinos do mapa trazem os mesmos números. Uma parada tem uma linha da grade de margem acima e nenhuma abaixo, e o círculo fica 3,2 mm abaixo do topo das duas linhas da grade que o título ocupa. Isso deixa uns 8,3 mm de branco acima do círculo e 2,1 mm abaixo; os parágrafos ficam a 6,4 mm um do outro.
#4 · Pendurar um azulejo no boxe e deixar os chips em tinta
const calloutStyles = [{ id: 'dontmiss', title: t({ en: 'Don’t miss', es: 'No te lo pierdas' }),
background: col('wash'), // one device: the walk's tint
// The tile hangs half off the box's outer side, flush with its top: the left side on a verso.
// With 6.5 mm of padding on both sides the title stays in line with the box's text there too.
// The tile's colours are drawn into the SVG, so it stays tile blue in every walk.
padding: { top: mm(3.4), right: mm(6.5), bottom: mm(3.4), left: mm(6.5) },
icon: { kind: 'resource', resourceId: 'tile', size: mm(10), position: 'corner',
cornerSide: 'outer' },
titleStyle: { ...label, fontSize: pt(8.5), fontWeight: 700, letterSpacing: pt(1.5),
color: col('bandInk') },
body: { fontSize: pt(9), lineHeight: pt(12.4), color: col('ink') } }];
// The facts are ink on paper in every walk: the walk's colour is kept for the tab, the stops
// and the box, and a chip linked to 'band' would follow it too.
const chipStyles = [{ id: 'fact', background: col('paper'), borderColor: col('muted'),
borderWidth: pt(0.6), borderRadius: mm(0.8), paddingX: mm(1.4), paddingY: mm(0.5),
fontFamily: 'Asap Condensed', fontSize: em(0.92), color: col('ink'), bold: true }];
O boxe não tem fio nem borda, só o tom claro do passeio e um azulejo desenhado em código no canto (estilos de boxe). cornerSide: 'outer' pendura o azulejo metade para fora do lado externo do boxe, rente ao topo; na página 4, uma página par, é o lado esquerdo, onde começa o título. Com 6,5 mm de preenchimento dos dois lados, o título passa livre do azulejo e fica alinhado com o texto do boxe em qualquer das duas páginas. A paleta do passeio muda o tom e o título, mas o azulejo continua azul, porque as cores dele estão desenhadas no SVG. Um chip ligado a band também tomaria a cor do passeio; aqui os dados ficam fora disso, e por isso os chips são tinta sobre papel, com um contorno cinza em muted, iguais em todos os passeios.
#5 · Fazer a legenda do mapa com as amostras de cor dos passeios
const map = svg('routes', MAP.width, MAP.height, { placement: { position: 'here' }, ...t({ en: {
caption: 'The three walks. The numbered pins are the stops in the text.',
note: ':swatch{color="alfama"} Walk 1, Alfama · :swatch{color="baixa"} Walk 2, Baixa · '
+ ':swatch{color="belem"} Walk 3, Belém, 6 km west (inset)',
altText: 'Map of central Lisbon north of the river: the yellow route runs from the '
+ 'waterfront up the Baixa grid to Rossio; the terracotta route climbs east from the '
+ 'cathedral through Alfama. An inset shows the teal Belém route.',
}, es: {
caption: 'Los tres paseos. Los pines numerados son las paradas del texto.',
note: ':swatch{color="alfama"} Paseo 1, Alfama · :swatch{color="baixa"} Paseo 2, Baixa · '
+ ':swatch{color="belem"} Paseo 3, Belém, 6 km al oeste (en el detalle)',
altText: 'Plano del centro de Lisboa al norte del río: la ruta amarilla sube desde el '
+ 'muelle por la cuadrícula de la Baixa hasta el Rossio; la terracota sube hacia el este '
+ 'desde la catedral por Alfama. En un detalle, la ruta verde azulada de Belém.',
} }) });
O mapa é um recurso SVG composto onde está ::resource{id="routes"}, com um tipo de recurso próprio para que a legenda diga Map 1. A nota identifica as rotas com três amostras de cor, :swatch{color="alfama"} e as equivalentes para baixa e belem. Uma amostra de cor aceita o id de uma entrada da paleta (formatação em linha). A paleta recebe de WALKS uma entrada por passeio, e o desenho tira as cores das rotas do mesmo objeto, de modo que a legenda bate com as rotas e com as abas. Os números dos pinos são desenhados como traços, de modo que o mapa não leva fonte nenhuma.
A receita completa
// ═══ Postext Cookbook · Nº 047 · Walking guide with thumb tabs ═══════════════════
// https://postext.dev/en/cookbook/walking-guide-thumb-tabs
// Code: MIT · Text: original (CC BY 4.0) · Map and tiles: drawn in code (CC BY 4.0)
// Fonts: Albert Sans, DM Serif Display, Asap Condensed (SIL OFL 1.1) · Needs postext ≥ 1.34.0
// A pocket guide to Lisbon. Each walk is a heading style that sets four colours, and the tab,
// the stop numbers, the box's tint and title and the blank page before the walk take them.
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'walking-guide-thumb-tabs';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: 'band' and three partners are the entries a walk overrides
const palette = {
ink: '#1b2430', // text: a blue-black
paper: '#fffdf8', // the page
band: '#1f4e9c', // the section colour: tile blue until a walk replaces it
bandInk: '#1d4a94', // the section colour for type on paper
onBand: '#ffffff', // type set on the band
wash: '#e8eef8', // the section's box tint
muted: '#5e6875', // running heads, notes, chip outlines
};
// Each walk's values for those four. Baixa yellow is too light for white type, so its
// onBand is the ink. The text is recoloured by value, so the four base values must differ.
const WALKS = {
alfama: { band: '#b9533a', bandInk: '#a1432b', onBand: '#ffffff', wash: '#f7e7e0' },
baixa: { band: '#e2b23d', bandInk: '#7d5a0f', onBand: '#1b2430', wash: '#fbf0d5' },
belem: { band: '#2b7a78', bandInk: '#236866', onBand: '#ffffff', wash: '#e1eeed' },
};
const NAMES = { alfama: 'Alfama', baixa: 'Baixa', belem: 'Belém' };
// A walk's palette follows the paletteId; the hex beside it is the colour's base value.
const col = (id) => ({ hex: palette[id] ?? WALKS[id].band, model: 'hex', paletteId: id });
const entry = (id, hex) => ({ id, name: id, value: { hex, model: 'hex' } });
const colorPalette = [
...Object.entries(palette).map(([id, hex]) => entry(id, hex)),
...Object.entries(WALKS).map(([id, w]) => entry(id, w.band)), // for :swatch{color="alfama"}
entry('main-color', palette.ink), // the engine's defaults link here: nothing prints blue
];
// #endregion
const TRIM = { width: 120, height: 200 }; // a pocket guide
// Mirrored, and tighter than a book's at top and foot: a pocket guide keeps 164 mm of text.
const MARGIN = { top: 18, bottom: 18, inner: 14, outer: 16 };
const MEASURE = TRIM.width - MARGIN.inner - MARGIN.outer; // 90 mm, about 55 characters
const LEAD = 13.2; // body leading in pt: the baseline grid
const BAND = 48; // mm: a walk opener's colour band, from the top edge
const HEAD = { y: 10, gap: 7 }; // running heads from the top edge; folio to title (mm)
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
#Deixar a página par em branco sem pintura
Sem o campo, a página 6 mantém a aba: pages: 'all' a imprime também na página em branco, no amarelo do passeio 2 e com um 2.
-const header = { elements: [...heads, ...tabs, ...blankPage] };
+const header = { elements: [...heads, ...tabs] };#Acrescentar o terceiro passeio
WALKS já tem as cores de Belém e walkStyles o estilo dele, de modo que o passeio só precisa do título no conteúdo. Ele abre na página 9, depois de uma página 8 em branco pintada de verde-azulado com um 3 branco.
+# Belém {style="belem" route="From the monastery to the tower"}
+
+Tram 15 runs from Praça da Figueira to Belém along the river.Erros comuns
Erro comum
A página assume o cabeçalho da última seção que começa nela
Quando dois estilos de título começam na mesma página, ela assume o cabeçalho, o rodapé e a paleta do último. Uma página em branco de separação pertence ao capítulo anterior, e o preenchimento de paridade, ao seguinte. Cabeços por seção →
Erro comum
Um estilo de título herda a quebra de página do seu nível
Uma entrada de headingStyles recebe do seu nível de título todos os campos que não define, inclusive breakBefore. Um sumário ou um colofão com estilo sobre um H1 depois de um :::pagebreak herda a paridade 'odd' e cai depois de uma página em branco. Dê a esse estilo breakBefore: { enabled: false }. Estilos de título →
Erro comum
Deslocamentos negativos relativos ao contêiner não pintam nada
O texto de design com largura automática fica limitado ao seu contêiner, então um deslocamento negativo em relação ao contêiner o empurra para fora e nada é pintado. Ancore esses elementos na página ou na sangria com deslocamentos explícitos em mm, ou dê a eles uma largura fixa. Ancoragem de elementos de design →
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 →
- A página 6 existe porque o passeio 1 termina na página 5, uma página ímpar. Um passeio que termina numa página par não deixa página em branco, e a cor do passeio seguinte só aparece nas páginas dele.
- Antes do primeiro passeio numerado,
{chapterNumber}fica vazio, por isso um elemento que o imprime, como a aba, precisa ali de um estilo que o deixe de fora.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imagens
- The tiles, the map of the routes and its pins, drawn in code · Ignacio Ferro · CC BY 4.0
- Fontes
- Albert Sans (SIL OFL 1.1) · DM Serif Display (SIL OFL 1.1) · Asap 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)


