En poques paraules
Una guia de butxaca de passejades per Lisboa. Cada passejada té el seu color, que apareix en una pestanya a la vora de la pàgina per trobar-la amb el polze.
Què compondràs
Les set primeres pàgines de Lisboa a peu, guia de butxaca de 120 × 200 mm. La coberta és una paret de rajoles blaves i blanques amb el títol en una placa emmarcada com un rètol de carrer lisboeta, i la pàgina 2 presenta les tres passejades amb un plànol de les seves rutes. Cada passejada té un color, terracota per a l'Alfama i groc per a la Baixa, i una pestanya al tall porta aquest color i el seu número a la mateixa alçada a cada pàgina de la passejada. Amb la passejada canvien també la banda de l'obertura, les parades, la capçalera de la pàgina senar i el to del requadre «No t'ho perdis». La pàgina parella en blanc que empeny la passejada 2 a una senar va pintada del seu groc i porta el seu número. El text és Albert Sans en bandera; els noms, DM Serif Display, i els rètols, Asap Condensed.
Aquesta recepta respon a
- Com amago les capçaleres a les obertures i a les pàgines en blanc, o pinto una pàgina parella en blanc amb el color de la part?
- Com poso capçaleres: el títol del llibre a la pàgina esquerra, el del capítol a la dreta i el foli per fora?
- Com afegeixo una pestanya numerada («REQUADRE 1-1»), una icona de cantonada o una icona al marge amb un filet?
- Com afegeixo mostres de color com a llegenda en el text, els peus o les notes de taula?
La 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' }));
Ingredients
- Funcions
- Bandes a sang i pestanyesColors per partCapçaleres segons el tipus de pàginaCapçaleres per seccióEstils de títolObertures dissenyadesAtributs de títolTítols numeratsCapítols que obren en pàgina senarCapçaleres i folisPaleta de color semànticaChips en líniaIcones i distintius de cantonadaMostres de colorFigures just aquíTipus de recurs propisImatges als dissenys de pàginaTextos, filets i caixes als dissenys de pàginaCobertes, portades i colofonsPàgines en un canvas
- També fa servir
- RequadresEquilibri de columnesColor del paperSalts de pàgina i de columnaEstils de paràgrafFigures i taules com a recursosSalts de línia als títolsCapítols sense número
- Tipografia
- Albert Sans, DM Serif Display, Asap Condensed (SIL OFL 1.1)
- Recursos
- The tiles, the map of the routes and its pins, drawn in code (Ignacio Ferro, CC BY 4.0)
Elaboració
#1 · Anomena els colors que canvia una passejada
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
];
La palette d'un estil d'encapçalament substitueix entrades pel seu id a les pàgines de la seva secció (estils d'encapçalament), així que tot color que hagi de seguir la passejada s'enllaça a una de quatre entrades: band per als camps de color, la pestanya i els cercles de les parades; bandInk per al text sobre paper; onBand per al text sobre un camp, i wash per al requadre. El blanc sobre el groc de la Baixa dona un contrast de 2:1, així que l'onBand d'aquesta passejada és la tinta, amb 8:1. Els elements de disseny segueixen l'id, mentre que el text es recoloreja per valor: un color igual a l'hex base d'una entrada pren el valor de la passejada, i per això els quatre valors base són diferents. El títol del requadre a la pàgina 4 i la línia que t'envia a la passejada 2 a la pàgina 5 són text en bandInk, i tots dos surten en terracota.
#2 · Deixa les capçaleres a les pàgines de text
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) };
Després de la composició, cada pàgina rep una funció (elements de text). La primera pàgina d'una passejada és opener, perquè el seu títol força un salt de pàgina; la pàgina de farciment abans d'una senar és blank, i les altres són body. Les capçaleres porten pages: 'body', així que no surten a les obertures de les pàgines 3 i 7 ni a la pàgina en blanc 6, i el foli al peu porta 'opener'. La pàgina parella imprimeix el {title} del frontmatter, i la senar, Paseo {chapterNumber} · {chapterTitle} en bandInk, terracota a la pàgina 5. Les pestanyes de la resposta curta porten 'all'. El camp de la pàgina en blanc va després a la llista, i com que l'ordre de la llista és l'ordre de pintat, tapa la pestanya a la pàgina 6. La introducció de la pàgina 2 va abans de la passejada 1 i allà {chapterNumber} és buit, així que el seu estil porta un header propi amb les quatre capçaleres i sense pestanyes. Sense ell, la pàgina 2 imprimiria una pestanya blava buida.
#3 · Obre cada passejada sota la seva banda i numera les seves parades
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') }),
] } } };
La banda s'ancora a la sang, que aquí és el tall, i entra 30 mm a la caixa de text. El disseny acaba amb la banda, i minHeight reserva vuit línies de la retícula de base, 37,3 mm; l'obertura ocupa la més gran de les dues alçades, així que a les pàgines 3 i 7 el text comença 7,3 mm sota la banda. Cada parada és un títol de nivell 3 amb un disseny que posa {number} en un cercle de 5,4 mm omplert de band. La plantilla {3} torna a començar a cada passejada, perquè un títol de nivell 1 reinicia els comptadors inferiors, i els pins del plànol porten els mateixos números. Una parada porta una línia de retícula de marge a sobre i cap a sota, i el seu cercle baixa 3,2 mm dins de les dues línies que ocupa el títol. Queden uns 8,3 mm de blanc sobre el cercle i 2,1 mm per sota; entre paràgrafs hi ha 6,4 mm.
#4 · Penja una rajola del requadre i deixa els xips en 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 }];
El requadre només porta el to clar de la passejada, sense filet ni vora, i una rajola dibuixada en codi a la seva cantonada (estils de requadre). cornerSide: 'outer' penja la rajola mig fora del costat exterior del requadre, arran de la seva vora superior; a la pàgina 4, parella, és el costat esquerre, on comença el títol. Amb 6,5 mm de farciment als dos costats, el títol esquiva la rajola i s'alinea amb el text del requadre en qualsevol de les dues pàgines. La paleta de la passejada canvia el to i el títol, però la rajola continua blava, perquè els seus colors van dibuixats a l'SVG. Un xip enllaçat a band prendria també el color de la passejada; aquí les dades en queden al marge, així que els xips van en tinta sobre paper, amb un contorn gris en muted, iguals a totes les passejades.
#5 · Fes la llegenda del plànol amb mostres de color
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.',
} }) });
El plànol és un recurs SVG que va on hi ha ::resource{id="routes"}, amb un tipus de recurs propi perquè el seu peu digui «Plano 1». A la nota, tres mostres de color fan de llegenda de les rutes: :swatch{color="alfama"} i les de baixa i belem. Una mostra de color accepta l'id d'una entrada de la paleta (format en línia). La paleta rep de WALKS una entrada per passejada, i el dibuix pren els colors de les rutes del mateix objecte, així que la llegenda coincideix amb les rutes i amb les pestanyes. Els números dels pins es dibuixen amb traços, així que el plànol no porta cap font.
La recepta 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 = 'es'; // @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)
L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)
Variants
#Deixa sense pintar la pàgina parella en blanc
Sense el camp, la pàgina 6 conserva la seva pestanya: pages: 'all' la imprimeix també a la pàgina en blanc, en el groc de la passejada 2 i amb un 2.
-const header = { elements: [...heads, ...tabs, ...blankPage] };
+const header = { elements: [...heads, ...tabs] };#Afegeix la tercera passejada
WALKS ja té els colors de Belém i walkStyles el seu estil, així que n'hi ha prou amb un títol. La passejada comença a la pàgina 9, i la 8, que queda en blanc, va pintada de verd blavós amb un 3 blanc.
+# Belém {style="belem" route="Del monasterio a la torre"}
+
+El tranvía 15 va de la Praça da Figueira a Belém junto al río.Errors freqüents
Error freqüent
Una pàgina pren la capçalera de l'última secció que hi comença
Quan dos estils de títol comencen a la mateixa pàgina, aquesta pren la capçalera, el peu i la paleta de l'últim. Una pàgina en blanc de separació pertany al capítol anterior, i l'emplenament de paritat, al següent. Capçaleres per secció →
Error freqüent
Un estil de títol hereta el salt de pàgina del seu nivell
Una entrada de headingStyles pren del seu nivell de títol tot allò que no fixa, també breakBefore. Un índex o un colofó amb estil sobre un H1 després d'un :::pagebreak hereta la paritat 'odd' i cau darrere d'una pàgina en blanc. Dona a aquest estil breakBefore: { enabled: false }. Estils de títol →
Error freqüent
Els desplaçaments negatius relatius al contenidor no pinten res
El text de disseny d'amplada automàtica es limita al seu contenidor, de manera que un desplaçament negatiu respecte al contenidor el treu fora i no es pinta res. Ancora aquests elements a la pàgina o a la sang amb desplaçaments explícits en mm, o dona'ls una amplada fixa. Ancoratge d'elements de disseny →
Error freqüent
La pàgina 1 és senar: planifica amb números físics
La pàgina 1 queda a la dreta i la 2 és la primera pàgina parella, així que planifica els plecs amb números de pàgina físics: una obertura en pàgina parella queda davant de la senar que la segueix. Salts de pàgina i de columna →
- La pàgina 6 existeix perquè la passejada 1 acaba a la pàgina 5, senar. Una passejada que acaba en pàgina parella no deixa pàgina en blanc, i llavors el color de la passejada següent només es veu a les seves pròpies pàgines.
- Abans de la primera passejada numerada,
{chapterNumber}és buit, així que un element que l'imprimeixi, com la pestanya, necessita allà un estil que el deixi fora.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Imatges
- The tiles, the map of the routes and its pins, drawn in code · Ignacio Ferro · CC BY 4.0
- Fonts
- Albert Sans (SIL OFL 1.1) · DM Serif Display (SIL OFL 1.1) · Asap Condensed (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


