En pocas palabras
Una guía de bolsillo de aves del estuario en dos partes, una parda y otra verde. Enseña cómo un solo ajuste de color por parte tiñe su página de apertura, las pestañas, los números de página y su línea del índice.
Lo que vas a componer
Aves del estuario es una guía de campo de bolsillo, con una parte por hábitat. Los fangales van en pardo y los carrizales en verde carrizo, y cada color se fija una vez, en el :::part de su hábitat. La portadilla es un campo de color a sangre con un número romano de 150 pt y la lista de especies en crema; el dorso se pinta igual, con la pestaña en negativo en el corte. En las páginas de especie toman ese color la pestaña, el folio, el antetítulo, el filete bajo el nombre científico, los rasgos en negrita, las viñetas y la etiqueta de la lámina. El índice, bajo una vista del estuario, da a cada parte una banda de su color con la página de su portadilla. La cubierta, la franja y las cuatro láminas son pinturas generadas con modelos de difusión y cargadas como mapas de bits JPEG; la paleta de una parte no llega a las imágenes, así que sus colores son los suyos.
Esta receta responde a
- ¿Cómo divido un libro en partes o secciones, cada una con su color y su portadilla?
- ¿Cómo oculto las cabeceras en las aperturas y las páginas en blanco, o pinto una página par en blanco con el color de la parte?
- ¿Cómo añado un índice que se actualice solo (líneas de puntos, números de página, autores, filas de parte)?
- ¿Cómo doy color a los términos clave (en negrita o cursiva) en el texto o dentro de los recuadros?
La respuesta corta
// 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) } },
};
Ingredientes
- Funciones
- Colores por partePortadillas de parteÍndice generalPaleta de color semánticaNegrita, cursiva y sus coloresBandas a sangre y pestañasCabeceras según el tipo de páginaCabeceras y foliosAperturas diseñadasAtributos de títuloTítulos numeradosEstilos de títuloCapítulos sin númeroSaltos de línea en los títulosCubiertas, portadas y colofonesImágenes en los diseños de páginaTipos de recurso propiosFiguras justo aquíRecuadros fijos e insigniasSaltos de página y de columna
- Tipografía
- Alegreya, Zilla Slab, Barlow Condensed (SIL OFL 1.1)
- Recursos
cover-1152.jpgcurlew-1200.jpgredshank-1200.jpgreedling-1200.jpgstrip-1536.jpgwarbler-1200.jpg- La cubierta: un zarapito en el fango del estuario, con carrizos delante (Generated With Diffusion Models, original)
- La franja del índice: un zarapito y un archibebe en el fango, y el carrizal al fondo (Generated With Diffusion Models, original)
- Lámina 1: zarapito real (Generated With Diffusion Models, original)
- Lámina 2: archibebe común (Generated With Diffusion Models, original)
- Lámina 3: bigotudo (Generated With Diffusion Models, original)
- Lámina 4: carricero común (Generated With Diffusion Models, original)
Elaboración
#1 · Una entrada de la paleta para que las partes la cambien
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 parte redefine entradas de la paleta por su id, así que todo lo que debe cambiar con el hábitat se enlaza a una sola entrada, band. Su valor propio, un gris pizarra, solo se ve fuera de las partes (en el antetítulo de la cubierta y en el título de la nota del índice), y ningún otro color de la configuración comparte ese hex. col() da a cada color su paletteId, y ese id es lo que sigue la redefinición de una parte, tanto en los estilos de texto como en los elementos de diseño.
#2 · Una portadilla, su dorso y su lista
El código de este paso es la respuesta corta, más arriba. Un :::part abre una portadilla en página impar, y parts.design la compone sobre toda la página, a sangre. El Markdown entre sus delimitadores empieza a 125 mm del borde superior, bajo el título: unas líneas sobre el hábitat con el estilo de párrafo habitat y después la lista de sus especies con bodyStyle. versoDesign pinta el dorso de la hoja (el campo y la pestaña en negativo) solo si esa página queda en blanco, y breakAfter: { parity: 'odd' } la deja en blanco al mandar la primera especie a la siguiente página impar. {numberRoman} imprime el number="I" de la parte en números romanos (con "1" saldría la misma I), mientras que las especies se numeran del 1 al 4 en arábigos. El \\ del título parte la línea solo en la portadilla; el índice y las cabeceras lo componen en una sola línea.
#3 · Los acentos del texto cambian con la parte
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) };
Desde un :::part hasta el siguiente, todo color del texto igual al valor propio de band toma el valor de la parte (el contenedor :::part). Aquí son los rasgos en negrita, las viñetas y las etiquetas de las láminas. El texto corrido y las cursivas se quedan en el color ink. Las láminas son un tipo de recurso propio, con la etiqueta Lámina y una numeración que no se reinicia, así que van del 1 al 4, como las especies.
#4 · La apertura de cada especie
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) })),
] } };
La apertura de cada especie imprime tres atributos de su título: status en el antetítulo, detrás del número; size a la derecha del antetítulo, y latin bajo el nombre. El antetítulo y el filete bajo el nombre científico se enlazan a band, así que el mismo diseño sirve para los dos hábitats. El título no lleva salto de página propio: cada especie empieza tras un :::pagebreak, o tras el salto que sigue a la parte, y así su página cuenta como página de texto y lleva cabeceras. El tamaño no lleva las mayúsculas de los rótulos, porque cm es un símbolo de unidad.
#5 · Una banda por parte en el índice
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 da una fila a cada :::part y compone en ella toc.parts.design con el número, el título, la página de la portadilla y la paleta de esa parte (índice general), así que la misma caja sale parda para los fangales y verde para los carrizales. Cada especie bajo la banda lleva su número, una línea de puntos y su página, y debajo el nombre científico que da el atributo latin.
#6 · La parte en las cabeceras y en la pestaña
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
] };
Con pages: 'body', las cabeceras solo salen en las páginas de texto. Las portadillas son páginas part y sus dorsos pintados, páginas blank; la cubierta y el índice se abren con un título a todo el ancho de la página, que las convierte en páginas de apertura. La cabecera de la página par imprime {title}, el título del frontmatter, de modo que el nombre del libro sigue en el Markdown. La de la página impar imprime {partTitle} en una sola línea, y la pestaña del corte imprime {partNumber} sobre una caja cuyo fondo se enlaza a band.
La receta 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 });
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Añade un tercer hábitat
Un bloque :::part más, delante de la primera especie de la marisma, añade un tercer color con su portadilla, su dorso pintado y su fila en el índice, sin tocar la configuración. Quita también la nota del índice, porque la tercera banda y sus especies necesitan ese sitio.
+:::part{number="III" title="Las \\ marismas" palette="band=#6b4a7a"}
+:::
+
+# Tarro blanco {latin="Tadorna tadorna" size="58–67 cm" status="Residente"}#Pon la especie frente a la portadilla
Sin el salto a la siguiente página impar, la primera especie ocupa el dorso de la portadilla y no queda ninguna página en blanco que pintar.
- breakAfter: { parity: 'odd' },Errores frecuentes
Error frecuente
parts.versoDesign necesita parts.breakAfter con paridad 'odd'
El dorso de una portadilla de parte solo se pinta cuando parts.breakAfter { enabled: true, parity: 'odd' } deja ese verso en blanco. Portadillas de parte →
Error frecuente
La página 1 es impar: planifica con números físicos
La página 1 queda a la derecha y la 2 es la primera página par, así que planifica los pliegos con números de página físicos: una apertura en página par queda frente a la impar que la sigue. Saltos de página y de columna →
- Una parte recolorea el texto comparando valores: cualquier color del texto igual al valor propio de
bandcambia con la parte, aunque esté enlazado a otra entrada o a ninguna. Reserva ese hex paraband. - La pestaña imprime
{partNumber}, que está vacío fuera de una parte, así que una página de texto anterior al primer:::partlleva una pestaña vacía, de color pizarra. Deja todas las páginas de texto dentro de una parte. - Las imágenes y las muestras de color conservan los colores escritos en ellas. Las láminas de esta receta toman los colores de su hábitat de
HABITAT, en el código, así que un color nuevo en un:::parthay que añadirlo también allí.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imágenes
- La cubierta: un zarapito en el fango del estuario, con carrizos delante · Generated With Diffusion Models · original
- La franja del índice: un zarapito y un archibebe en el fango, y el carrizal al fondo · Generated With Diffusion Models · original
- Lámina 1: zarapito real · Generated With Diffusion Models · original
- Lámina 2: archibebe común · Generated With Diffusion Models · original
- Lámina 3: bigotudo · Generated With Diffusion Models · original
- Lámina 4: carricero común · Generated With Diffusion Models · original
- Fuentes
- Alegreya (SIL OFL 1.1) · Zilla Slab (SIL OFL 1.1) · Barlow Condensed (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)

