En poques paraules
Els capítols del llibre van a una columna ampla. A partir dels apèndixs, el text corre a dues columnes de lletra més petita, i un apèndix a tres. La mida de pàgina i l'idioma del llibre no canvien en cap moment.
Què compondràs
Un petit manual per a qui conrea pomeres en una vall freda, de 150 × 220 mm, escrit en sis documents Markdown i compost com un sol llibre. Els dos capítols de la part I van a una columna justificada de Source Serif 4. La part II, els apèndixs, canvia de disseny: una taula de portaempelts i un calendari mes a mes a dues columnes en bandera i cos més petit, matèria que es consulta al cobert amb el llibre obert sobre el banc de treball, i una llista de varietats a tres columnes de pal sec. L'epíleg torna al disseny propi del llibre sense portadella. El format, els marges, la divisió de paraules i l'idioma són els mateixos a totes les pàgines.
Aquesta recepta respon a
- Com componc els apèndixs d’un llibre, o una de les seves parts, amb un altre disseny, per exemple a dues columnes i en un cos més petit?
- Com divideixo un llibre en parts o seccions, cadascuna amb el seu color i la seva portadella?
La resposta curta
const smallOpener = { minHeight: mm(24), slot: { elements: [{ id: 'title', fontSize: pt(16) }] } };
// In the Markdown: :::part{number="II" title="Appendices" style="appendix"} sets every
// chapter from there to the next part; a chapter's own chapterStyle: reference wins.
const chapterStyles = [
{ id: 'appendix', name: t({ en: 'Appendix', es: 'Apéndice' }), config: {
layout: { layoutType: 'double', gutterWidth: mm(6) },
bodyText: { fontSize: pt(8.8), lineHeight: pt(11.6), textAlign: 'left',
firstLineIndent: pt(0), paragraphSpacing: pt(4) },
// Lists merge entry by entry on their id or level: only what is named here changes.
headings: { levels: [{ level: 1, advancedDesign: smallOpener }] },
} },
{ id: 'reference', name: t({ en: 'Reference list', es: 'Lista de consulta' }), config: {
layout: { layoutType: 'multiple', columnCount: 3, gutterWidth: mm(4.5) },
bodyText: { fontFamily: SANS, fontSize: pt(7.8), lineHeight: pt(10.4), textAlign: 'left',
firstLineIndent: pt(0), paragraphSpacing: pt(3.5), boldColor: col('accent') },
headings: { levels: [{ level: 1, advancedDesign: smallOpener }] },
} },
];
// The trim, the language and the fonts stay the book's: a style that sets page.width or
// locale is ignored there, with a chapterStyleBookSetting warning.
Ingredients
- Funcions
- Estils de capítolPortadelles de partLlibres construïts capítol a capítolUna o dues columnesTres o més columnesObertures dissenyadesCapçaleres i folisCapçaleres per seccióCapçaleres segons el tipus de pàginaMarges simètricsTextos, filets i caixes als dissenys de pàginaVídues, òrfenes i línies curtesPaleta de color semàntica
- Tipografia
- Source Serif 4, Source Sans 3 (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Un estil només guarda el que canvia
El codi és la resposta curta de més amunt. Un estil de capítol té un id, un nom per al Sandbox i un config que es fusiona sobre els ajustos del llibre com ho fa la capa d'un idioma. Els objectes es fusionen clau per clau i les llistes entrada per entrada pel seu id o el seu level, de manera que smallOpener anomena un element de l'obertura, el títol, i li dona un cos més petit; el filet de sota i tota la resta es queden com els té el llibre. L'estil d'apèndix fixa dues columnes, un cos de text més petit, línies en bandera i espai entre entrades, i res més.
Alguns ajustos són del llibre sencer: el format, la resolució i l'enquadernació de page, l'idioma i la direcció d'escriptura, les xifres, les fonts, la impressió i el PDF. Un estil que en fixi algun s'ignora en aquest punt i dona un avís chapterStyleBookSetting, així que els apèndixs conserven el format de 150 mm i la divisió de paraules en castellà dels capítols.
#2 · La part anomena l'estil
// Only the first document's front matter is the book's; a later one keeps its chapterStyle.
const chapters = [front, rootstocks, appendices, calendar, varieties, afterword]
.map((markdown) => ({ markdown }));
El tercer document comença amb :::part{number="II" title="Apéndices" style="appendix"}, i tots els capítols des d'aquest fins a la part següent es componen amb l'estil d'apèndix. El cinquè anomena el seu propi estil al front matter, chapterStyle: "reference", que passa per davant del de la part. En un llibre, només el front matter del primer document és del llibre; un de posterior només en conserva la línia chapterStyle:.

#3 · Una portadella, i una part sense
const text = (id, content, family, size, extra) => ({ kind: 'text', id, content, align: 'left',
fontFamily: family, fontSize: pt(size), color: col('ink'), overflow: 'wrap', ...extra });
const at = (to, edge, x, y, width) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
...(width && { size: { width: mm(width), height: 'auto' } }) });
const parts = {
breakBefore: { parity: 'any' }, // the book is short: a part opens on the next page
design: { elements: [ // the container is the trim: the margins are measured from its edges
{ kind: 'box', id: 'band', style: { backgroundColor: col('leaf') },
placement: { ...at('page', 'top-left', 0, 0), size: { width: 'fill', height: mm(96) } } },
text('number', '{number}', SERIF, 40, { fontWeight: 600, color: col('paper'),
placement: at('page', 'top-left', MARGIN.inner, 46, MEASURE) }),
text('title', '{titleText}', SERIF, 24, { fontWeight: 600, color: col('paper'),
placement: at('#number', 'below', 0, 2, MEASURE) }),
] },
};
Cada :::part obre una portadella amb el número i el títol de la part sobre una banda verda. L'epíleg comença amb :::part{title="Epílogo" page=false}: no s'imprimeix cap portadella i, com que la part no anomena cap estil, el seu capítol es torna a compondre amb els ajustos del llibre. Una part amb page=false serveix per a les pàgines finals que segueixen els apèndixs sense tall.

#4 · Una obertura en dues mides
const opener = { enabled: true, minHeight: mm(40), slot: { elements: [
text('title', '{titleText}', SERIF, 22, { fontWeight: 600, lineHeight: 1.12,
placement: at('container', 'top-left', 0, 8, MEASURE - 10) }),
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1.5), color: col('accent'),
placement: { ...at('#title', 'below', 0, 4), size: { width: mm(14) } } },
] } };
L'obertura ocupa tota l'amplada de la pàgina, així que als apèndixs passa per sobre de les dues columnes i el text comença a sota, a dues. Els estils d'apèndix i de llista de consulta redueixen el títol a 16 pt i l'enfonsament a 24 mm a través de l'id de l'element: la matèria del final del llibre ocupa menys, i els seus títols continuen clarament per sobre del text.
#5 · Titolets del llibre
const head = (id, content, parity, edge, x, extra = {}) => text(id, content, SANS, 7.5, {
parity, pages: 'body', fontWeight: 600, letterSpacing: pt(1.2), textTransform: 'uppercase',
color: col('muted'), overflow: 'clip', placement: at('page', edge, x, 12, 90), ...extra });
const folio = { fontWeight: 700, color: col('ink') };
const right = { align: 'right' };
const header = { elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-left', MARGIN.outer, folio),
head('verso-title', '{title}', 'even', 'top-left', MARGIN.outer + 9), // the book's title
head('recto-title', '{chapterTitle}', 'odd', 'top-right', -(MARGIN.outer + 9), right),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -MARGIN.outer, { ...folio, ...right }),
] };
const footer = { elements: [head('drop-folio', '{pageNumber}', 'all', 'bottom', 0, {
...folio, align: 'center', pages: 'opener', placement: at('page', 'bottom', 0, -14, 20) })] };
El títol del llibre va a la pàgina parella i el del capítol a la senar. Cap estil no els canvia, així que els titolets són iguals a totes les parts del llibre.
La recepta completa
// ═══ Postext Cookbook · Nº 187 · Appendices in two columns ═══════════════════════════════
// https://postext.dev/en/cookbook/appendices-in-two-columns
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Source Serif 4, Source Sans 3 (SIL OFL 1.1) · Needs postext ≥ 1.79.0
// A growers' handbook in six Markdown documents: the chapters in one column, the appendices
// in two columns of smaller type, one appendix in three, and an afterword back in one.
import {
buildBundle, prepareFonts, withLoadedFonts, renderPageToCanvas,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'appendices-in-two-columns';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: russet for the accent, leaf green for the part pages
const palette = { ink: '#211f1b', accent: '#8e3b24', leaf: '#46603a', muted: '#6c665c',
rule: '#cfc6b6', paper: '#fffdf8' };
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [SERIF, SANS] = ['Source Serif 4', 'Source Sans 3'];
const TRIM = { width: 150, height: 220 }; // mm, a handbook for the shed shelf
const MARGIN = { top: 22, bottom: 24, inner: 19, outer: 15 }; // mirrored
const MEASURE = TRIM.width - MARGIN.inner - MARGIN.outer; // 116 mm
const LEAD = 14; // pt, the book's leading
// #region answer: two chapter styles; a part names one, a chapter names the other
const smallOpener = { minHeight: mm(24), slot: { elements: [{ id: 'title', fontSize: pt(16) }] } };
// In the Markdown: :::part{number="II" title="Appendices" style="appendix"} sets every
// chapter from there to the next part; a chapter's own chapterStyle: reference wins.
const chapterStyles = [
{ id: 'appendix', name: t({ en: 'Appendix', es: 'Apéndice' }), config: {
layout: { layoutType: 'double', gutterWidth: mm(6) },
bodyText: { fontSize: pt(8.8), lineHeight: pt(11.6), textAlign: 'left',
firstLineIndent: pt(0), paragraphSpacing: pt(4) },
// Lists merge entry by entry on their id or level: only what is named here changes.
headings: { levels: [{ level: 1, advancedDesign: smallOpener }] },
} },
{ id: 'reference', name: t({ en: 'Reference list', es: 'Lista de consulta' }), config: {
layout: { layoutType: 'multiple', columnCount: 3, gutterWidth: mm(4.5) },
bodyText: { fontFamily: SANS, fontSize: pt(7.8), lineHeight: pt(10.4), textAlign: 'left',
firstLineIndent: pt(0), paragraphSpacing: pt(3.5), boldColor: col('accent') },
headings: { levels: [{ level: 1, advancedDesign: smallOpener }] },
} },
];
// The trim, the language and the fonts stay the book's: a style that sets page.width or
// locale is ignored there, with a chapterStyleBookSetting warning.
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
#Demanar a un estil un ajust del llibre
Un estil que fixa el format o l'idioma s'ignora en aquestes claus. La composició dona un avís chapterStyleBookSetting per cadascuna, i els apèndixs conserven el format del llibre.
{ id: 'appendix', name: t({ en: 'Appendix', es: 'Apéndice' }), config: {
+ page: { width: mm(170) }, locale: 'fr',
layout: { layoutType: 'double', gutterWidth: mm(6) },#Fer servir el disseny en un altre llibre
L'eina de línia d'ordres escriu el disseny d'un llibre, amb els seus estils de capítol, en un fitxer de disseny, i compon un altre llibre amb aquest disseny mitjançant --design. Consulta l'ordre design.
postext design manzanos.postext -o manual.postext
postext pdf perales/ --design manual.postext -o perales.pdfErrors freqüents
- La línia
:::partha d'obrir el capítol, abans del seu títol. Una línia de part posada després que hagi començat el text del capítol dona l'avíspartStyleMidChapter, i l'estil comença al capítol següent. - Un nom d'estil que no és a
chapterStylesdona l'avíschapterStyleUnknown, i aquell capítol es compon amb els ajustos del llibre.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Fonts
- Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (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)


