En poques paraules
Una guia de butxaca d'ocells de l'estuari en dues parts, una bruna i una altra verda. Ensenya com un sol paràmetre de color per part tenyeix la seva pàgina d'obertura, les pestanyes, els números de pàgina i la seva línia de l'índex.
Què compondràs
Aves del estuario és una guia de camp de butxaca, amb una part per hàbitat. Els fangars van en bru i els canyissars en verd canyís, i cada color es fixa una vegada, al :::part del seu hàbitat. La portadella és un camp de color a sang amb un número romà de 150 pt i la llista d'espècies en crema; el dors es pinta igual, amb la pestanya en negatiu al tall. A les pàgines d'espècie prenen aquest color la pestanya, el foli, l'avanttítol, el filet sota el nom científic, els trets en negreta, els pics i l'etiqueta de la làmina. L'índex, sota una vista de l'estuari, dona a cada part una banda del seu color amb la pàgina de la seva portadella. La coberta, la franja i les quatre làmines són pintures generades amb models de difusió i carregades com a mapes de bits JPEG; la paleta d'una part no arriba a les imatges, així que els seus colors són els seus.
Aquesta recepta respon a
- Com divideixo un llibre en parts o seccions, cadascuna amb el seu color i la seva portadella?
- 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 afegeixo un índex que s'actualitzi sol (línies de punts, números de pàgina, autors, files de part)?
- Com dono color als termes clau (en negreta o cursiva) en el text o dins dels requadres?
La resposta curta
// In the Markdown: :::part{number="I" title="The \\ Mudflats" palette="band=#8c5e24"}
// Every colour below that is linked to 'band' takes #8c5e24 until the next part.
const parts = { // passed to the config as `parts`
// A divider opens on a recto by default. The break after it goes to the next recto too, so
// the back of the leaf stays blank and versoDesign paints it (gotcha: verso-design-breakafter).
breakAfter: { parity: 'odd' },
margins: { top: mm(125) }, // the fence's text starts low, under the title
design: { elements: [ // the divider: its container is the whole trim
box('field', col('band'), { ...at('top-left', 0, 0, 'bleed'), ...fill }),
text('part', t({ en: 'Part', es: 'Parte' }), { ...label, fontSize: pt(10),
letterSpacing: pt(2.4), color: col('paper') },
at('top-left', MARGIN.inner, MARGIN.top)), // a recto: the inner margin is on the left
// Roman for the parts, Arabic for the species. {numberRoman} re-formats number="I" (or
// "1"); the species design prints {number}, from numberingTemplate '{1}'.
text('numeral', '{numberRoman}', { ...display, fontSize: pt(150), lineHeight: 0.9,
color: col('paper') }, below('part', 0)),
// The \\ in the title breaks the line here; the contents and the heads get one line.
text('title', '{titleText}', { ...display, fontSize: pt(46), lineHeight: 0.98,
color: col('paper') }, below('numeral', 2, { width: mm(MEASURE) })),
rule('rule', col('paper'), 1, below('title', 7, { width: mm(14) })),
] },
// The back of the leaf: the same band, edge to edge, the part's tab in reverse at the
// fore-edge (a verso's is on the left) and its name at the foot.
versoDesign: { elements: [
box('field', col('band'), { ...at('top-left', 0, 0, 'bleed'), ...fill }),
text('tab', '{partNumber}', { ...label, fontSize: pt(9), color: col('band'), align: 'center',
box: { backgroundColor: col('paper') } }, { ...at('top-left', 0, TAB.y), size: TAB.size }),
text('name', '{partTitle}', { ...label, fontSize: pt(9), letterSpacing: pt(2.4),
color: col('paper') }, at('bottom-left', MARGIN.outer, -MARGIN.bottom)),
] },
// The fence's list of species, in the paper colour on the band.
bodyStyle: { fontSize: pt(11), color: col('paper'), textAlign: 'left', numberColor: col('paper'),
orderedLists: { fontFamily: 'Barlow Condensed', separator: '', gap: mm(4) } },
};
Ingredients
- Funcions
- Colors per partPortadelles de partÍndex generalPaleta de color semànticaNegreta, cursiva i els seus colorsBandes a sang i pestanyesCapçaleres segons el tipus de pàginaCapçaleres i folisObertures dissenyadesAtributs de títolTítols numeratsEstils de títolCapítols sense númeroSalts de línia als títolsCobertes, portades i colofonsImatges als dissenys de pàginaTipus de recurs propisFigures just aquíRequadres fixos i insígniesSalts de pàgina i de columna
- Tipografia
- Alegreya, Zilla Slab, Barlow Condensed (SIL OFL 1.1)
- Recursos
cover-1152.jpgcurlew-1200.jpgredshank-1200.jpgreedling-1200.jpgstrip-1536.jpgwarbler-1200.jpg- The cover: a curlew on the estuary mud, reeds in front (Generated With Diffusion Models, original)
- The contents strip: a curlew and a redshank on the mud, the reedbed beyond (Generated With Diffusion Models, original)
- Plate 1: Eurasian curlew (Generated With Diffusion Models, original)
- Plate 2: common redshank (Generated With Diffusion Models, original)
- Plate 3: bearded reedling (Generated With Diffusion Models, original)
- Plate 4: common reed warbler (Generated With Diffusion Models, original)
Elaboració
#1 · Una entrada de la paleta perquè les parts la canviïn
const palette = {
ink: '#1f2624', // text: a green-tinted near-black
band: '#3c4b4f', // the house slate, before any part; each :::part brings its own
paper: '#f6f3ea', // the page, and the type set on a band
rule: '#d5d1c4', // hairlines
muted: '#61675f', // running heads, Latin names, the colophon
};
// The paletteId is the link a part's palette="band=#…" follows, in text and designs alike.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
// The engine's defaults link to 'main-color': point it at the ink, so nothing prints blue.
{ id: 'main-color', name: 'ink (defaults)', value: { hex: palette.ink, model: 'hex' } },
];
Una part redefineix entrades de la paleta pel seu id, així que tot el que ha de canviar amb l'hàbitat s'enllaça a una sola entrada, band. El seu valor propi, un gris pissarra, només es veu fora de les parts (a l'avanttítol de la coberta i al títol de la nota de l'índex), i cap altre color de la configuració no comparteix aquell hex. col() dona a cada color el seu paletteId, i aquest id és el que segueix la redefinició d'una part, tant als estils de text com als elements de disseny.
#2 · Una portadella, el seu dors i la seva llista
El codi d'aquest pas és la resposta curta, més amunt. Un :::part obre una portadella en pàgina senar, i parts.design la compon sobre tota la pàgina, a sang. El Markdown de dins del bloc comença a 125 mm de la vora superior, sota el títol: unes línies sobre l'hàbitat amb l'estil de paràgraf habitat i després la llista de les seves espècies amb bodyStyle. versoDesign pinta el dors del full (el camp i la pestanya en negatiu) només si aquella pàgina queda en blanc, i breakAfter: { parity: 'odd' } la deixa en blanc en enviar la primera espècie a la pàgina senar següent. {numberRoman} imprimeix el number="I" de la part en xifres romanes (amb "1" sortiria la mateixa I), mentre que les espècies es numeren de l'1 al 4 en aràbigues. El \\ del títol parteix la línia només a la portadella; l'índex i les capçaleres el componen en una sola línia.
#3 · Els accents del text canvien amb la part
const bodyText = {
fontFamily: 'Alegreya', fontSize: pt(10.5), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('band'), // the field marks: **Bill**, **Voice.**
italicColor: col('ink'), referenceColor: col('ink'),
firstLineIndent: mm(4), indentAfterHeading: false,
// Tighter than the 0.6–2 defaults. runtMinCharacters counts word spaces, not letters:
// 45 are about 20 letters of Alegreya (the default 20, about 9); a shorter last line is a runt.
minWordSpacing: 0.75, maxWordSpacing: 1.7, runtMinCharacters: 45,
};
const unorderedLists = { bulletChar: '•', color: col('band'), // the field marks' bullets
marginTop: pt(0), marginBottom: pt(0) };
// The plates are numbered with the species, and their label is in the part's colour.
const resourceTypes = [{ id: 'plate', numberingTemplate: '{n}', resetOn: 'never',
counterFormat: 'decimal', ...t({
en: { name: 'Plate', namePlural: 'Plates', shortLabel: 'Pl.', captionPrefix: 'Plate' },
es: { name: 'Lámina', namePlural: 'Láminas', shortLabel: 'Lám.', captionPrefix: 'Lámina' },
}) }];
const captionStyle = { fontSize: pt(8.5), labelColor: col('band'), descriptionItalic: true,
gap: mm(1.8) };
Des d'un :::part fins al següent, tot color del text igual al valor propi de band pren el valor de la part (el contenidor :::part). Aquí són els trets en negreta, els pics i les etiquetes de les làmines. El text corregut i les cursives es queden en el color ink. Les làmines són un tipus de recurs propi, amb l'etiqueta Làmina i una numeració que no es reinicia, així que van de l'1 al 4, com les espècies.
#4 · L'obertura de cada espècie
const species = { enabled: true, slot: { elements: [
text('kicker', '{number} · {attr.status}', { ...label, fontSize: pt(8.5),
letterSpacing: pt(1.7), color: col('band') }, at('top-left', 0, 1, 'container')),
// 'cm' is a unit symbol: it keeps its lower case, so the size is not set in capitals.
text('size', '{attr.size}', { ...label, textTransform: 'none', fontSize: pt(8.5),
letterSpacing: pt(0.5), color: col('muted') }, at('top-right', 0, 1, 'container')),
text('name', '{titleText}', { ...display, fontSize: pt(22), lineHeight: 1.05,
color: col('ink') }, below('kicker', 1.5, { width: 'fill' })),
text('latin', '{attr.latin}', { fontFamily: 'Alegreya', italic: true, fontSize: pt(11.5),
color: col('ink') }, below('name', 0.8)),
rule('rule', col('band'), 0.75, below('latin', 2, { width: mm(MEASURE) })),
] } };
L'obertura de cada espècie imprimeix tres atributs del seu títol: status a l'avanttítol, darrere del número; size a la dreta de l'avanttítol, i latin sota el nom. L'avanttítol i el filet sota el nom científic s'enllacen a band, així que el mateix disseny serveix per als dos hàbitats. El títol no porta salt de pàgina propi: cada espècie comença després d'un :::pagebreak, o després del salt que segueix la part, i així la seva pàgina compta com a pàgina de text i porta capçaleres. La mida no porta les majúscules dels rètols, perquè cm és un símbol d'unitat.
#5 · Una banda per part a l'índex
const contents = {
levels: [{ level: 1, fontFamily: 'Zilla Slab', fontSize: pt(12), fontWeight: 600,
numberFontFamily: 'Barlow Condensed', numberFontWeight: 600, numberColor: col('muted'),
numberWidth: mm(5), numberGap: mm(3), marginTop: pt(4) }],
pageNumber: { fontFamily: 'Barlow Condensed', fontSize: pt(10), fontWeight: 600, width: mm(7) },
leader: { char: '. ' },
subtitle: { enabled: true, attr: 'latin', fontFamily: 'Alegreya', fontSize: pt(9.5),
color: col('muted') }, // the Latin name, in italic by default
// A part row lays out this design with the part's number, title, page and palette.
parts: { height: mm(8.5), marginTop: pt(LEAD), design: { elements: [
box('row', col('band'), { ...at('top-left', 0, 0, 'container'), ...fill }),
text('part', t({ en: 'Part {number}', es: 'Parte {number}' }), { ...label, fontSize: pt(8),
letterSpacing: pt(1.6), color: col('paper') }, at('left', 3, 0, 'container')),
text('title', '{titleText}', { ...display, fontSize: pt(12), color: col('paper') },
at('left', 20, 0, 'container')),
text('page', '{pageNumber}', { ...label, fontSize: pt(10), color: col('paper'),
align: 'right' }, at('right', -2.5, 0, 'container')),
] } },
};
:::toc dona una fila a cada :::part i hi compon toc.parts.design amb el número, el títol, la pàgina de la portadella i la paleta d'aquella part (índex general), així que la mateixa caixa surt bruna per als fangars i verda per als canyissars. Cada espècie sota la banda porta el seu número, una línia de punts i la seva pàgina, i a sota el nom científic que dona l'atribut latin.
#6 · La part a les capçaleres i a la pestanya
const head = (id, content, parity, placement, style = {}) => ({ ...text(id, content, { ...label,
fontSize: pt(8), letterSpacing: pt(1.4), color: col('muted'), overflow: 'clip', ...style },
placement), parity, pages: 'body' }); // dividers are 'part' pages, their versos 'blank'
const folio = { fontSize: pt(9), fontWeight: 700, color: col('band') };
const tab = (parity, edge) => head(`tab-${parity}`, '{partNumber}', parity,
{ ...at(edge, 0, TAB.y), size: TAB.size },
{ fontSize: pt(9), color: col('paper'), align: 'center', box: { backgroundColor: col('band') } });
const header = { elements: [
head('verso-folio', '{pageNumber}', 'even', at('top-left', MARGIN.outer, HEAD.y), folio),
head('verso-title', '{title}', 'even', at('top-left', MARGIN.outer + HEAD.gap, HEAD.y)),
head('recto-title', '{partTitle}', 'odd', at('top-right', -(MARGIN.outer + HEAD.gap), HEAD.y)),
head('recto-folio', '{pageNumber}', 'odd', at('top-right', -MARGIN.outer, HEAD.y), folio),
tab('even', 'top-left'), tab('odd', 'top-right'), // on the fore-edge, left on a verso
] };
Amb pages: 'body', les capçaleres només surten a les pàgines de text. Les portadelles són pàgines part i els seus dorsos pintats, pàgines blank; la coberta i l'índex s'obren amb un títol a tota l'amplada de la pàgina, que les converteix en pàgines d'obertura. La capçalera de la pàgina parella imprimeix {title}, el títol del frontmatter, de manera que el nom del llibre continua al Markdown. La de la pàgina senar imprimeix {partTitle} en una sola línia, i la pestanya del tall imprimeix {partNumber} sobre una caixa amb el fons enllaçat a band.
La recepta completa
// ═══ Postext Cookbook · Nº 019 · Parts in colour from one attribute ═══════════════════════
// https://postext.dev/en/cookbook/parts-in-colour
// Code: MIT · Text: original (CC BY 4.0) · Pictures: diffusion models
// Fonts: Alegreya, Zilla Slab, Barlow Condensed (SIL OFL 1.1) · Needs postext ≥ 1.57.0
// A pocket field guide to two habitats. Each :::part names its own 'band' colour, and every
// colour linked to 'band' takes it: the divider and its verso, the tab, the field marks.
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'parts-in-colour';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: 'band' is the entry the parts override; the others keep their value
const palette = {
ink: '#1f2624', // text: a green-tinted near-black
band: '#3c4b4f', // the house slate, before any part; each :::part brings its own
paper: '#f6f3ea', // the page, and the type set on a band
rule: '#d5d1c4', // hairlines
muted: '#61675f', // running heads, Latin names, the colophon
};
// The paletteId is the link a part's palette="band=#…" follows, in text and designs alike.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
// The engine's defaults link to 'main-color': point it at the ink, so nothing prints blue.
{ id: 'main-color', name: 'ink (defaults)', value: { hex: palette.ink, model: 'hex' } },
];
// #endregion
const TRIM = { width: 150, height: 200 }; // a pocket guide
const MARGIN = { top: 22, bottom: 20, inner: 19, outer: 21 }; // mirrored; room for a thumb
const MEASURE = TRIM.width - MARGIN.inner - MARGIN.outer; // 110 mm, about 70 characters
const LEAD = 14.5; // body leading in pt: the baseline grid
const STRIP = 44; // the contents' picture strip, from the top edge (mm)
const HEAD = { y: 12, gap: 8 }; // running heads from the top edge; folio to title (mm)
const TAB = { y: 26, size: { width: mm(8), height: mm(24) } }; // the thumb tab, at the fore-edge
const TITLE_DROP = 6; // mm from the foot of the contents strip to the title's box
const BOOK = t({ en: 'Birds of the Estuary', es: 'Aves del estuario' });
const label = { fontFamily: 'Barlow Condensed', fontWeight: 600, textTransform: 'uppercase' };
const display = { fontFamily: 'Zilla Slab', fontWeight: 700 };
const at = (edge, x, y, to = 'page') => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const below = (id, y, size) => ({ ...at('below', 0, y, `#${id}`), ...(size && { size }) });
const fill = { size: { width: 'fill', height: 'fill' } };
const text = (id, content, style, placement) => ({ kind: 'text', id, content, overflow: 'wrap',
align: 'left', ...style, placement });
const box = (id, color, placement) => ({ kind: 'box', id, style: { backgroundColor: color },
placement });
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
#Afegeix un tercer hàbitat
Una línia :::part més, davant de la primera espècie de l'aiguamoll, afegeix un tercer color amb la seva portadella, el seu dors pintat i la seva fila a l'índex, sense tocar la configuració. Treu també la nota de l'índex, perquè la tercera banda i les seves espècies necessiten aquell lloc.
+:::part{number="III" title="Las \\ marismas" palette="band=#6b4a7a"}
+:::
+
+# Tarro blanco {latin="Tadorna tadorna" size="58–67 cm" status="Residente"}#Posa l'espècie davant de la portadella
Sense el salt a la pàgina senar següent, la primera espècie ocupa el dors de la portadella i no queda cap pàgina en blanc per pintar.
- breakAfter: { parity: 'odd' },Errors freqüents
Error freqüent
parts.versoDesign necessita parts.breakAfter amb paritat 'odd'
El dors d'una portadella de part només es pinta quan parts.breakAfter { enabled: true, parity: 'odd' } deixa aquest verso en blanc. Portadelles de part →
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 →
- Una part torna a acolorir el text comparant valors: qualsevol color del text igual al valor propi de
bandcanvia amb la part, encara que estigui enllaçat a una altra entrada o a cap. Reserva aquell hex per aband. - La pestanya imprimeix
{partNumber}, que és buit fora d'una part, així que una pàgina de text anterior al primer:::partporta una pestanya buida, de color pissarra. Deixa totes les pàgines de text dins d'una part. - Les imatges i les mostres de color conserven els colors que porten escrits. Les làmines d'aquesta recepta prenen els colors del seu hàbitat de
HABITAT, al codi, així que un color nou en un:::partcal afegir-lo també allà.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Imatges
- The cover: a curlew on the estuary mud, reeds in front · Generated With Diffusion Models · original
- The contents strip: a curlew and a redshank on the mud, the reedbed beyond · Generated With Diffusion Models · original
- Plate 1: Eurasian curlew · Generated With Diffusion Models · original
- Plate 2: common redshank · Generated With Diffusion Models · original
- Plate 3: bearded reedling · Generated With Diffusion Models · original
- Plate 4: common reed warbler · Generated With Diffusion Models · original
- Fonts
- Alegreya (SIL OFL 1.1) · Zilla Slab (SIL OFL 1.1) · Barlow 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)

