Em poucas palavras
Os capítulos do livro são compostos em uma coluna larga. A partir dos apêndices, o texto corre em duas colunas de letra menor, e um apêndice em três. O tamanho da página e o idioma do livro não mudam em nenhum momento.
O que você vai compor
Um pequeno manual para quem cultiva macieiras num vale frio, de 150 × 220 mm, escrito em seis documentos Markdown e diagramado como um só livro. Os dois capítulos da parte I são compostos em uma coluna justificada de Source Serif 4. A parte II, os apêndices, muda de projeto: uma tabela de porta-enxertos e um calendário mês a mês em duas colunas em bandeira e corpo menor, matéria que o produtor lê no galpão com o livro aberto sobre a bancada, e uma lista de variedades em três colunas sem serifa. O posfácio volta ao projeto do próprio livro sem página divisória. Formato, margens, hifenização e idioma são os mesmos em todas as páginas.
Esta receita responde a
- Como componho os apêndices de um livro, ou uma de suas partes, com outro design, por exemplo em duas colunas e em corpo menor?
- Como divido um livro em partes ou seções, cada uma com sua cor e sua página divisória?
A 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.
Ingredientes
- Funcionalidades
- Estilos de capítuloPáginas de abertura de parteLivros compostos capítulo a capítuloUma ou duas colunasTrês ou mais colunasAberturas desenhadasCabeços e fóliosCabeços por seçãoCabeços por tipo de páginaMargens espelhadasTextos, fios e caixas nos designs de páginaViúvas, órfãs e linhas curtasPaleta de cores semântica
- Tipografia
- Source Serif 4, Source Sans 3 (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Um estilo guarda só o que muda
O código é a resposta curta logo acima. Um estilo de capítulo tem um id, um nome para o Sandbox e um config que é mesclado sobre as configurações do livro, como acontece com a camada de um idioma. Os objetos se mesclam chave a chave e as listas entrada a entrada, pelo id ou pelo level. Assim, smallOpener nomeia um único elemento da abertura, o título, e lhe dá um corpo menor; o fio abaixo dele e todo o resto ficam como o livro os define. O estilo de apêndice define duas colunas, um corpo de texto menor, linhas em bandeira e espaço entre as entradas, e nada mais.
Algumas configurações pertencem ao livro inteiro: o formato, a resolução e a encadernação de page, o idioma e a direção da escrita, os algarismos, as fontes, a impressão e a saída em PDF. Um estilo que defina alguma delas é ignorado nesse ponto e gera um aviso chapterStyleBookSetting, de modo que os apêndices mantêm o formato de 150 mm e a hifenização em inglês britânico dos capítulos.
#2 · A parte nomeia o estilo
// 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 }));
O terceiro documento começa com :::part{number="II" title="Appendices" style="appendix"}, e todos os capítulos dali até a parte seguinte são compostos no estilo de apêndice. O quinto nomeia seu próprio estilo no front matter, chapterStyle: "reference", que prevalece sobre o da parte. Num livro, só o front matter do primeiro documento vale para o livro; um documento posterior mantém apenas a linha chapterStyle:.

#3 · Uma página divisória, e uma parte sem ela
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 abre uma página divisória com o número e o título da parte sobre uma faixa verde. O posfácio começa com :::part{title="Afterword" page=false}: nenhuma página divisória é impressa e, como a parte não nomeia estilo, seu capítulo volta a ser composto com as configurações do livro. Uma parte com page=false serve para as páginas finais que seguem os apêndices sem interrupção.

#4 · Uma abertura em dois tamanhos
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) } } },
] } };
A abertura ocupa toda a largura da página; nos apêndices, portanto, ela passa por cima das duas colunas e o texto começa embaixo, em duas. Os estilos de apêndice e de consulta reduzem o título a 16 pt e o rebaixamento a 24 mm pelo id do elemento: a matéria do fim do livro ocupa menos espaço, e seus títulos continuam bem maiores que o texto.
#5 · Cabeços do livro
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) })] };
O título do livro vai na página par e o do capítulo na ímpar. Nenhum estilo os altera, então os cabeços são iguais em todas as partes do livro.
A receita 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 = 'en'; // @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.
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
#Pedir a um estilo uma configuração do livro
Um estilo que define o formato ou o idioma é ignorado nessas chaves. A composição gera um aviso chapterStyleBookSetting para cada uma, e os apêndices mantêm o formato do livro.
{ id: 'appendix', name: t({ en: 'Appendix', es: 'Apéndice' }), config: {
+ page: { width: mm(170) }, locale: 'fr',
layout: { layoutType: 'double', gutterWidth: mm(6) },#Reaproveitar o projeto em outro livro
A ferramenta de linha de comando grava o projeto gráfico de um livro, com os estilos de capítulo, num arquivo de projeto, e compõe outro livro com ele usando --design. Veja o comando design.
postext design apples.postext -o handbook.postext
postext pdf pears/ --design handbook.postext -o pears.pdfErros comuns
- A linha
:::partprecisa abrir o capítulo, antes do título. Uma linha de parte colocada depois que o texto do capítulo já começou gerapartStyleMidChapter, e o estilo só começa no capítulo seguinte. - Um nome de estilo que não existe em
chapterStylesgerachapterStyleUnknown, e aquele capítulo é composto com as configurações do livro.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fontes
- Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (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)


