Pular para o conteúdo principal
Receita número 187

Receitas · Capítulo 5 · Estrutura do livro

Apêndices em duas colunas com corpo menor

Um manual de fruticultura em uma coluna cujos apêndices mudam de projeto: uma parte nomeia um estilo de capítulo, um apêndice nomeia o seu e o posfácio volta.

Nesta página
Saída
Canvas
Postext
Testada com o Postext 1.79.0
Requer ≥ 1.79.0
Licença
Atualizada em 12 de nov. de 2026
Código MIT · Texto CC BY 4.0

p. 6–7 de 10

  • Amostra em inglês: ainda sem edição em português
  • Refile 150 × 220 mm
  • 1 coluna
  • Source Serif 4 10,5/14
  • Source Sans 3
  • 10 páginas
  • Nível
  • Postext 1.79.0
  • Diagramado em 315 ms
  • 122 linhas de código

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

script.js · linhas 29–48no código completo
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

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

script.js · linhas 264–266no código completo
// 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:.

Apêndice C: o estilo próprio do capítulo, três colunas sem serifa, no lugar das duas da parte.

#3 · Uma página divisória, e uma parte sem ela

script.js · linhas 52–66no código completo
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.

A página divisória da parte II.

#4 · Uma abertura em dois tamanhos

script.js · linhas 70–75no código completo
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

script.js · linhas 79–91no código completo
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

Sandbox
// ═══ 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.pdf

Erros comuns

  • A linha :::part precisa abrir o capítulo, antes do título. Uma linha de parte colocada depois que o texto do capítulo já começou gera partStyleMidChapter, e o estilo só começa no capítulo seguinte.
  • Um nome de estilo que não existe em chapterStyles gera chapterStyleUnknown, e aquele capítulo é composto com as configurações do livro.

Créditos

Texto
Texto original, CC BY 4.0
Fontes
Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (SIL OFL 1.1)
Sandbox