Em poucas palavras
Um livro de ensaios de autores diferentes. Cada ensaio traz o nome do autor sob o título e termina com a própria lista de referências, como nas coletâneas.
O que você vai compor
The Working Page, uma pequena coletânea de ensaios sobre a história da impressão, organizada por dois pesquisadores e escrita por três. Cada ensaio chega do autor como um arquivo Markdown com um bloco BibTeX próprio, e é assim que o livro o mantém: um volume de 155 × 235 mm em Libre Caslon, uma folha de rosto vermelha e capítulos que abrem com um número, um título e o nome do autor. Cada capítulo fecha com a própria lista de References em Chicago autor-data, que contém só as obras citadas naquele ensaio. The Printing Press as an Agent of Change, de Eisenstein, é citado por dois autores e por isso aparece nas duas listas; a New Introduction to Bibliography de Gaskell faz o mesmo nos capítulos 1 e 3.
Esta receita responde a
- Como dou a cada capítulo de uma obra coletiva seu próprio autor e sua própria bibliografia?
- Como cito obras e monto a bibliografia em APA, IEEE ou outro estilo de citação?
A resposta curta
// Citations are [@key] in the text; each contributor's BibTeX goes in a :::references block
// in their own chapter. Register the engine once, before the first build.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
style: 'chicago-author-date', // the humanities' author-date: (Eisenstein 1979)
bibliography: {
// 'chapter': a :::bibliography lists the works its own document cites, so a work two
// contributors cite appears in both lists. 'book' (the default) would print one list,
// after the last chapter. The scope is per document, not per H1: each essay must be a
// document of its own in buildBundle (see the chapters region).
scope: 'chapter',
title: '', // no bold title paragraph: each chapter has its own ## References heading
fontSize: em(0.9), lineHeight: pt(12.4), hangingIndent: mm(5), entrySpacing: pt(2.6),
},
};
// Numbering and disambiguation still see the whole book: two Smiths of 2001 in different
// chapters would print 2001a and 2001b, as one bibliography would.
Ingredientes
- Funcionalidades
- Bibliografia a partir das referênciasCitações em um estilo de citaçãoLivros compostos capítulo a capítuloAtributos de títuloAberturas desenhadasSumárioCabeços e fóliosCabeços por tipo de páginaEstilos de títuloCapítulos sem númeroCapas, folhas de rosto e colofõesAncoragem de elementos de designBoxes flutuantesMargens espelhadasPaleta de cores semânticaExportação para PDF
- Tipografia
- Libre Caslon Text, Libre Caslon Display, IBM Plex Sans Condensed (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Um documento por autor
// A chapter's :::bibliography lists what that document cites; one Markdown file holding all
// three essays would make every list repeat the works of the chapters before it.
const chapters = [front, lowe, okafor, ferrer].map((markdown) => ({ markdown }));
const book = () => buildBundle({ chapters, config: config(), resources: [] });
O alcance da resposta curta é o de um documento. buildBundle diagrama os quatro documentos como um só livro, de modo que os números de página, os números de capítulo e o sumário seguem em sequência, enquanto cada :::bibliography reúne as citações do próprio arquivo. As referências ficam onde o autor as escreveu: uma chave definida em qualquer capítulo vale para o livro inteiro, por isso uma única entrada compartilhada bastaria, mas capítulos autônomos podem ser trocados ou reordenados sem quebrar a lista de outro ensaio.
#2 · A autoria é um atributo do título
// # The Compositor's Day {author="Margaret Lowe" short="The Compositor's Day"}
const byline = text('byline', '{attr.author}', { fontFamily: TEXT, italic: true,
fontSize: pt(12), color: col('ink'), align: 'left' }, below('title', 4));
const versoAuthor = head('verso-author', '{attr.author}', 'even',
at('page', 'top-left', MARGIN.outer + 8, 13)); // in the running head
const tocAuthor = { enabled: true, attr: 'author', fontFamily: TEXT, fontSize: pt(9.5),
color: col('muted') }; // a line under each title in the contents (italic by default)
O título de cada ensaio leva author="…" e um título curto, short="…", para o cabeço. A abertura imprime o autor sob o título, o cabeço da página par nomeia o autor do ensaio a que a página pertence, e o sumário imprime o nome numa linha sob cada entrada. Nada nas páginas iniciais do livro lista os autores duas vezes.
#3 · A abertura
// Nine lines of reserve and a line of margin under them (the level's marginBottom): ten
// lines, 48 mm, under a one-line title. A two-line title reaches past the reserve, and the
// margin then carries the text a line lower, clear of the rule.
const opener = { enabled: true, minHeight: pt(LEAD * 9), slot: { elements: [
text('kicker', t({ en: 'Chapter {number}', es: 'Capítulo {number}' }), { ...label,
fontSize: pt(8.5), letterSpacing: pt(1.7), color: col('accent') },
at('container', 'top-left', 0, 4)),
text('title', '{titleText}', { fontFamily: DISPLAY, fontSize: pt(28), lineHeight: 1.08,
color: col('ink'), align: 'left', overflow: 'wrap' }, below('kicker', 3, { width: 'fill' })),
byline,
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1.2), color: col('accent'),
placement: { ...below('byline', 6), size: { width: mm(16) } } },
] } };
Antetítulo, título e autoria se empilham a partir do alto da mancha, cada um ancorado abaixo do anterior, de modo que um título de duas linhas, como o do capítulo 3, empurra a autoria e o fio para baixo junto com ele. A reserva desce o texto 48 mm, dez linhas, sob um título de uma linha; um título de duas toma uma linha a mais, de modo que o fio não encosta no texto e o capítulo 3 começa uma linha abaixo dos outros dois.
#4 · Cabeços para um livro de muitos autores
function head(id, content, parity, placement, look = {}) { // hoisted: the byline uses it
return { ...text(id, content, { ...label, fontWeight: 500, fontSize: pt(7.5),
letterSpacing: pt(1.1), color: col('muted'), ...look }, placement), parity, pages: 'body' };
}
const folio = { fontWeight: 600, color: col('ink') };
const header = { elements: [
head('verso-folio', '{pageNumber}', 'even', at('page', 'top-left', MARGIN.outer, 13), folio),
versoAuthor,
head('recto-title', '{attr.short}', 'odd', at('page', 'top-right', -(MARGIN.outer + 8), 13),
{ align: 'right' }),
head('recto-folio', '{pageNumber}', 'odd', at('page', 'top-right', -MARGIN.outer, 13),
{ ...folio, align: 'right' }),
] };
const footer = { elements: [{ ...head('drop-folio', '{pageNumber}', 'all',
at('container', 'top', 0, 9), { ...folio, align: 'center' }), pages: 'opener' }] };
Uma coletânea nomeia o autor na página par e o capítulo na ímpar, onde uma monografia imprimiria o título do livro e o do capítulo. Os cabeços são filtrados para pages: 'body', por isso as aberturas levam só um fólio no pé.
#5 · As páginas iniciais
const bare = { numbered: false, toc: false, header: { elements: [] }, footer: { elements: [] } };
const cover = { enabled: true, slot: { elements: [
{ kind: 'box', id: 'field', style: { backgroundColor: col('accent') },
placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(150) } } },
text('title', '{titleText}', { fontFamily: DISPLAY, fontSize: pt(58), lineHeight: 1,
color: col('paper'), align: 'left', overflow: 'wrap' },
{ ...at('page', 'top-left', MARGIN.inner, 64), size: { width: mm(118) } }),
text('subtitle', '{subtitle}', { fontFamily: TEXT, italic: true, fontSize: pt(15),
color: col('paper'), align: 'left' }, below('title', 5)),
text('editors', '{attr.editors}', { ...label, fontSize: pt(9), letterSpacing: pt(1.8),
color: col('accent') }, at('page', 'top-left', MARGIN.inner, 162)),
text('contributors', '{attr.contributors}', { fontFamily: TEXT, italic: true, fontSize: pt(12),
color: col('ink'), align: 'left' }, below('editors', 3)),
text('imprint', '{attr.imprint}', { ...label, fontWeight: 500, fontSize: pt(7.5),
letterSpacing: pt(1.5), color: col('muted') }, at('page', 'bottom-left', MARGIN.inner, -16)),
] } };
const contentsOpener = { enabled: true, minHeight: mm(40), slot: { elements: [
text('kicker', '{title}', { ...label, fontSize: pt(8.5), letterSpacing: pt(1.7),
color: col('accent') }, at('container', 'top-left', 0, 4)),
text('title', '{titleText}', { fontFamily: DISPLAY, fontSize: pt(28), color: col('ink'),
align: 'left' }, below('kicker', 3)),
] } };
const contents = {
levels: [{ level: 1, fontFamily: TEXT, fontSize: pt(12.5), lineHeight: pt(LEAD),
numberFontFamily: LABEL, numberFontSize: pt(10), numberFontWeight: 600,
numberColor: col('accent'), numberWidth: mm(6), numberGap: mm(3), marginBottom: pt(LEAD) }],
pageNumber: { fontFamily: LABEL, fontSize: pt(9), fontWeight: 600, color: col('ink'),
width: mm(7) },
leader: { char: '. ', gap: mm(2) },
subtitle: tocAuthor,
};
A folha de rosto e o sumário são dois títulos sem número no primeiro documento, sem cabeços e sem entrada no sumário. Os designs deles leem {title} e {subtitle} do front matter, e os organizadores e autores, dos atributos do próprio título.
A receita completa
// ═══ Postext Cookbook · Nº 098 · An edited volume with a bibliography per chapter ═════
// https://postext.dev/en/cookbook/edited-volume-chapter-bibliographies
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Libre Caslon Text & Display, IBM Plex Sans Condensed (OFL 1.1) · Needs postext ≥ 1.28.0
// Three essays by three contributors, each a Markdown document of its own with its own
// BibTeX block, laid out by buildBundle as one volume: every chapter closes on its own list.
import {
buildBundle, prepareFonts, withLoadedFonts, renderPageToCanvas, registerCitationEngine,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
import { createCiteprocEngine, STYLES, LOCALES } from 'https://esm.sh/postext-citeproc';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'edited-volume-chapter-bibliographies';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: printer's red on a warm paper, the rest in ink
const palette = {
ink: '#211c19', // text: a warm near-black
accent: '#8e2b1f', // printer's red: the cover field, kickers, the references heading
rule: '#cdbfb2', // hairlines
muted: '#6b5f57', // running heads, the contents' contributors, the colophon
paper: '#fcfaf6', // the page, and the type on the red field
};
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 TEXT = 'Libre Caslon Text', DISPLAY = 'Libre Caslon Display';
const LABEL = 'IBM Plex Sans Condensed';
const MARGIN = { top: 23, bottom: 22, inner: 20, outer: 18 }; // mm, mirrored
const LEAD = 13.8; // body leading in pt: the baseline grid
const label = { fontFamily: LABEL, fontWeight: 600, textTransform: 'uppercase', align: 'left' };
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const below = (id, y, size) => ({ ...at(`#${id}`, 'below', 0, y), ...(size && { size }) });
const text = (id, content, look, placement) => ({ kind: 'text', id, content, ...look, placement });
// #region answer: one list per chapter: scope 'chapter' over a book of separate documents
// Citations are [@key] in the text; each contributor's BibTeX goes in a :::references block
// in their own chapter. Register the engine once, before the first build.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
style: 'chicago-author-date', // the humanities' author-date: (Eisenstein 1979)
bibliography: {
// 'chapter': a :::bibliography lists the works its own document cites, so a work two
// contributors cite appears in both lists. 'book' (the default) would print one list,
// after the last chapter. The scope is per document, not per H1: each essay must be a
// document of its own in buildBundle (see the chapters region).
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
#Uma lista para o volume inteiro
Algumas editoras reúnem todas as obras numa única bibliografia no fim. Mude o alcance e tire os três títulos ## References; a lista passa a vir depois do último capítulo.
- scope: 'chapter',
- title: '', // nenhum parágrafo de título em negrito: cada capítulo tem o seu próprio título ## References
+ scope: 'book',
+ title: 'Bibliography',#Cite em APA
Um volume de ciências sociais muda o estilo e mais nada.
- style: 'chicago-author-date', // o autor-data das humanidades: (Eisenstein 1979)
+ style: 'apa',Erros comuns
Erro comum
Uma chave definida duas vezes mantém a primeira entrada, sem aviso
As referências valem para o livro inteiro: uma chave escrita em dois capítulos mantém a primeira definição, e a segunda é ignorada sem aviso. Em um livro de vários autores, use um prefixo nas chaves de cada colaborador. Bibliografia a partir das referências →
Erro comum
Valores de atributo: sem { ou }; aspas simples se tiver "
Um valor de atributo termina na chave de fechamento, por isso não pode conter { nem }. Um valor que contém aspas duplas vai entre aspas simples; o cifrão não causa problema. Atributos de título →
Erro comum
Um estilo de título herda a quebra de página do seu nível
Uma entrada de headingStyles recebe do seu nível de título todos os campos que não define, inclusive breakBefore. Um sumário ou um colofão com estilo sobre um H1 depois de um :::pagebreak herda a paridade 'odd' e cai depois de uma página em branco. Dê a esse estilo breakBefore: { enabled: false }. Estilos de título →
scope: 'chapter'lista o que o documento cita antes do:::bibliography, não o que a seção H1 cita. Com todos os ensaios num único arquivo Markdown, a segunda lista repete as obras do primeiro ensaio e a terceira repete as dos dois.- No livro inteiro vale a primeira definição de cada chave. Se dois autores usarem
smith2001para obras diferentes, o ensaio posterior cita sem aviso o livro do autor anterior: ponha um prefixo nas chaves de cada autor, ou confira as listas com os originais. - A desambiguação é calculada para o livro inteiro. Duas obras diferentes de Smith de 2001 em capítulos diferentes podem sair como 2001a e 2001b, mesmo quando a lista de um capítulo contém só uma delas.
- Um subtítulo que abre uma página perde por padrão todo o espaço acima dele, e o ajuste à grade põe então embaixo a fração de linha que falta: Whose letters, no alto da página 10, ficaria mais longe do texto do que What the reader sees, mais abaixo na mesma página.
headings.columnHeadSpace: 'remainder'deixa essa fração de linha acima do subtítulo (títulos). Convém a um livro em uma coluna, onde nenhuma coluna vizinha mostra que o subtítulo começa um pouco mais abaixo.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fontes
- Libre Caslon Text (SIL OFL 1.1) · Libre Caslon Display (SIL OFL 1.1) · IBM Plex Sans Condensed (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)


