Em poucas palavras
Um ensaio sobre um poema de Keats, como uma revista literária o imprime. A autora escreve um código curto para cada fonte; o Postext imprime o autor e a página entre parênteses e a lista de obras citadas no fim, no estilo MLA.
O que você vai compor
Um ensaio de uma revista literária trimestral: quatro páginas sobre quem diz os dois últimos versos da “Ode on a Grecian Urn”, de Keats. A página é de revista, 150 × 230 mm, composta em Spectral, com títulos de seção e cabeços em Spectral SC, e a abertura fica numa faixa da cor do verniz negro sobre uma tira de argila vermelha, as duas cores de um vaso ático. As citações seguem o MLA 9, o estilo da maioria dos departamentos de literatura e de história da arte: autor e página entre parênteses, só a página quando a frase já nomeia o autor, um título abreviado quando duas obras são do mesmo autor e a lista de obras citadas numa página própria. Cada citação é uma chave no texto, e o estilo é uma única configuração.
Esta receita responde a
- Como cito obras e monto a bibliografia em APA, IEEE ou outro estilo de citação?
A resposta curta
// The text cites with [@keats-letters, 48] → (Keats, Letters 48): MLA prints the author
// and the page, and adds a short title when two works share an author. [-@eliot1932, 230]
// drops the name the sentence already gives → (230). The list is alphabetical, and a
// second work by the same author opens with a dash (MLA's ---) instead of the name.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
style: 'modern-language-association', // MLA 9th edition, author-page
link: true, // a citation jumps to its entry in Works Cited
bibliography: {
// MLA's half-inch hanging indent, scaled to a 108 mm measure.
fontSize: em(0.94), lineHeight: pt(13.4), hangingIndent: em(2.2), entrySpacing: pt(3),
},
};
Ingredientes
- Funcionalidades
- Citações em um estilo de citaçãoBibliografia a partir das referênciasAberturas desenhadasAtributos de títuloEstilos de títuloCabeços e fóliosMargens espelhadasEstilos de parágrafoPaleta de cores semânticaExportação para PDF
- Também usa
- Referências cruzadasCor do papelCabeços por tipo de páginaFontes incorporadas ao PDFEspaço vertical explícito
- Tipografia
- Spectral, Spectral SC (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · O estilo é MLA; os dados são BibTeX
O código é a resposta curta acima. O motor de citações é registrado uma vez e citations.style indica o estilo MLA incluído; o citeproc-js escreve com ele cada citação e a lista. As referências ficam num bloco :::references{format=bibtex} no fim do ensaio, escritas como um gerenciador de referências as exporta. O MLA precisa de um título abreviado para as duas obras de Keats, e o campo shorttitle de cada entrada o fornece (em CSL ele se chama title-short).
#2 · Quatro tipos de citação
O texto cita uma obra com [@jack1967], que imprime “(Jack)” porque o ensaio se refere ao livro como um todo. Com página, [@keats-letters, 41] imprime “(Keats, Letters 41)”: há duas obras de Keats citadas, de modo que o citeproc acrescenta o título abreviado para distingui-las. Quando a frase já nomeia o crítico, [-@eliot1932, 230] omite o nome e imprime “(230)”. Uma citação narrativa sem página, @stillinger1974 records, imprime só o nome, “Stillinger records”, com um único espaço depois: o MLA não tem nada a pôr entre parênteses. Depois que a ode foi citada com os números dos versos, os trechos seguintes levam só os números, digitados entre parênteses comuns, como o MLA permite.
#3 · Uma citação em bloco com a referência depois do ponto final
// More than four lines of prose go in a Markdown blockquote: in ink, indented, with no
// first-line indent. Its citation follows the final full stop, as MLA asks.
const blockquote = {
color: col('ink'), italic: false, indent: em(2), firstLineIndent: em(0),
};
A carta sobre a Negative Capability passa de quatro linhas de prosa, e por isso é destacada como uma citação em bloco do Markdown: em redondo, na cor do texto, recuada 2 em e sem recuo de primeira linha. O MLA põe a referência de uma citação em bloco depois do ponto final, e o texto de origem faz o mesmo: …fact and reason. [@keats-letters, 48]. Um :::space{lines=0.5} acima e outro abaixo separam a citação dos parágrafos em volta.
#4 · As obras citadas numa página própria
headingStyles: [{ id: 'works-cited', breakBefore: { enabled: true, parity: 'any' } }],
O título usa um estilo que quebra para uma página nova, e :::bibliography{title=""} põe a lista sob ele sem um segundo título. A lista é alfabética com recuo deslocado, e a segunda obra de Keats começa com um travessão triplo no lugar do nome, como o MLA pede para autores repetidos. Um fólio no pé aparece nesta página e na abertura, onde não há cabeços.
#5 · A abertura nas duas cores de um vaso
const BAND = 116; // mm from the trim's top
const opener = {
enabled: true,
minHeight: mm(BAND - MARGIN.top + 4), // the text starts a line under the band
slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('glaze') },
placement: { ...at('page', 'top-left'), size: { width: 'fill', height: mm(BAND) } } },
{ kind: 'box', id: 'foot', style: { backgroundColor: col('clay') },
placement: { ...at('page', 'top-left', 0, BAND - 3), size: { width: 'fill',
height: mm(3) } } },
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', fontFamily: LABEL, fontWeight: 600,
fontSize: pt(9), letterSpacing: pt(1.6), color: col('slip'), align: 'left',
placement: at('container', 'top-left', 0, 6) },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: TEXT, fontWeight: 300,
italic: true, fontSize: pt(56), lineHeight: 0.95, color: col('paper'), align: 'left',
overflow: 'wrap', placement: { ...at('container', 'top-left', -1, 30),
size: { width: mm(110), height: 'auto' } } },
{ kind: 'text', id: 'sub', content: '{attr.sub}', fontFamily: TEXT, fontWeight: 300,
fontSize: pt(13), lineHeight: 1.25, color: col('paper'), align: 'left', overflow: 'wrap',
placement: { ...at('container', 'top-left', 0, 66),
size: { width: mm(96), height: 'auto' } } },
{ kind: 'text', id: 'byline', content: '{attr.byline}', fontFamily: LABEL, fontWeight: 600,
fontSize: pt(9.5), letterSpacing: pt(1.2), color: col('slip'), align: 'left',
placement: at('container', 'top-left', 0, 82) },
] },
};
const palette = {
ink: '#1f1a17', glaze: '#231c19', clay: '#9a3d22', slip: '#e3a27e', rule: '#c9bdb0',
muted: '#6b6159', paper: '#fffdf9',
};
// Every colour is linked to its palette entry by id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.clay })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
A faixa tem 116 mm de altura e traz o chapéu, o título em 56 pt de Spectral Light itálico, o subtítulo e a assinatura, todos alimentados por atributos do título. A tira de argila é uma segunda caixa ancorada 3 mm acima do pé da faixa.
A receita completa
// ═══ Postext Cookbook · Nº 096 · A humanities essay with MLA works cited ══════════
// https://postext.dev/en/cookbook/mla-humanities-essay
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Spectral, Spectral SC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, 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 = 'mla-humanities-essay';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: the black glaze and the red clay of an Attic vase
const palette = {
ink: '#1f1a17', glaze: '#231c19', clay: '#9a3d22', slip: '#e3a27e', rule: '#c9bdb0',
muted: '#6b6159', paper: '#fffdf9',
};
// Every colour is linked to its palette entry by id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.clay })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const TEXT = 'Spectral', LABEL = 'Spectral SC';
const TRIM = { width: 150, height: 230 }; // a literary quarterly
const MARGIN = { top: 22, bottom: 22, inner: 19, outer: 21 };
const LEAD = 14.4; // pt
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
// #region answer: MLA 9 author-page citations and a Works Cited list
// The text cites with [@keats-letters, 48] → (Keats, Letters 48): MLA prints the author
// and the page, and adds a short title when two works share an author. [-@eliot1932, 230]
// drops the name the sentence already gives → (230). The list is alphabetical, and a
// second work by the same author opens with a dash (MLA's ---) instead of the name.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
style: 'modern-language-association', // MLA 9th edition, author-page
link: true, // a citation jumps to its entry in Works Cited
bibliography: {
// MLA's half-inch hanging indent, scaled to a 108 mm measure.
fontSize: em(0.94), lineHeight: pt(13.4), hangingIndent: em(2.2), entrySpacing: pt(3),
},
};
// #endregion
// #region quotation: a block quotation, set in and upright
// More than four lines of prose go in a Markdown blockquote: in ink, indented, with no
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
#Pôr a lista logo depois do ensaio
Uma revista que compõe as obras citadas depois do último parágrafo, sem página nova, tira a quebra do estilo de título.
- headingStyles: [{ id: 'works-cited', breakBefore: { enabled: true, parity: 'any' } }],
+ headingStyles: [{ id: 'works-cited', breakBefore: { enabled: false } }],#Citar no Chicago autor-data
O mesmo ensaio em Chicago põe o ano depois do autor, “(Brooks 1947, 165)”, e a lista acompanha.
- style: 'modern-language-association', // MLA 9th edition, author-page
+ style: 'chicago-author-date',Erros comuns
- O citeproc-js imprime os títulos como os dados os trazem. O MLA usa maiúscula em cada palavra principal nos títulos em inglês, por isso escreva-os assim nas referências.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Quotations from “Ode on a Grecian Urn” (1820) · John Keats · domínio público
- Quotations from two letters of 1817, in Letters of John Keats to His Family and Friends, ed. Sidney Colvin (1925) · John Keats · domínio público
- Fontes
- Spectral (SIL OFL 1.1) · Spectral SC (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)


