En pocas palabras
Un ensayo sobre un poema de Keats, tal como lo imprime una revista literaria. La autora escribe una clave corta para cada fuente; Postext imprime el autor y la página entre paréntesis y la lista de obras citadas al final, en estilo MLA.
Lo que vas a componer
Un ensayo de una revista literaria trimestral: cuatro páginas sobre quién dice los dos últimos versos de la «Ode on a Grecian Urn» de Keats. La página mide 150 × 230 mm y va en Spectral, con los títulos de sección y las cabeceras en Spectral SC; la apertura ocupa una banda del negro del barniz sobre una franja de arcilla roja, los dos colores de un vaso ático. Las citas siguen MLA 9, el estilo de casi todos los departamentos de literatura e historia del arte: autor y página entre paréntesis, solo la página cuando la frase ya nombra al autor, un título abreviado cuando dos obras son del mismo autor y la lista de obras citadas en página aparte. Cada cita es una clave en el texto y el estilo es un solo ajuste.
Esta receta responde a
- ¿Cómo cito obras y compongo la bibliografía en APA, IEEE u otro estilo de cita?
La respuesta corta
// 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
- Funciones
- Citas en un estilo de citaBibliografía a partir de las referenciasAperturas diseñadasAtributos de títuloEstilos de títuloCabeceras y foliosMárgenes simétricosEstilos de párrafoPaleta de color semánticaExportación a PDF
- También usa
- Referencias cruzadasColor del papelCabeceras según el tipo de páginaFuentes incrustadas en el PDFEspacio vertical explícito
- Tipografía
- Spectral, Spectral SC (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · El estilo es MLA; los datos, BibTeX
El código es la respuesta corta de arriba. El motor de citas se registra una vez y citations.style elige el estilo MLA incluido; citeproc-js redacta con él cada cita y la lista. Las referencias van en un bloque :::references{format=bibtex} al final del ensayo, escritas como las exporta un gestor de referencias. MLA necesita un título abreviado para las dos obras de Keats, y el campo shorttitle de cada entrada lo da (en CSL se llama title-short).
#2 · Cuatro maneras de citar
El texto cita una obra con [@jack1967], que imprime «(Jack)» porque el ensayo se refiere al libro entero. Con página, [@keats-letters, 41] imprime «(Keats, Letters 41)»: se citan dos obras de Keats, así que citeproc añade el título abreviado para distinguirlas. Cuando la frase ya nombra al crítico, [-@eliot1932, 230] omite el nombre e imprime «(230)». Una cita narrativa sin página, @stillinger1974 recoge, imprime solo el nombre, «Stillinger recoge», con un único espacio detrás: MLA no tiene nada que poner entre paréntesis. Una vez citada la oda con sus números de verso, las citas siguientes llevan solo los números, escritos entre paréntesis normales, como permite MLA.
#3 · Una cita en bloque con la referencia tras el punto
// 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),
};
La carta sobre la Negative Capability pasa de cuatro líneas de prosa, así que va aparte como cita en bloque de Markdown: en redonda, en el color del texto, sangrada 2 em y sin sangría de primera línea. MLA pone la referencia de una cita en bloque detrás del punto final, y el original hace lo mismo: …fact and reason. [@keats-letters, 48]. Un :::space{lines=0.5} encima y otro debajo la separan de los párrafos que la rodean.
#4 · Las obras citadas, en página aparte
headingStyles: [{ id: 'works-cited', breakBefore: { enabled: true, parity: 'any' } }],
El título lleva un estilo que salta a página nueva, y :::bibliography{title=""} coloca la lista debajo sin un segundo título. La lista va en orden alfabético con sangría francesa, y la segunda obra de Keats empieza con una raya triple en lugar del nombre, como pide MLA para los autores repetidos. Un folio al pie aparece en esta página y en la apertura, donde no hay cabeceras.
#5 · La apertura en los dos colores de un 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' } }));
La banda mide 116 mm y lleva el antetítulo, el título de 56 pt en Spectral Light cursiva, el subtítulo y la firma, todos tomados de atributos del encabezado. La franja de arcilla es una segunda caja anclada 3 mm por encima del pie de la banda.
La receta 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 = 'es'; // @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
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Pon la lista a continuación del ensayo
Una revista que compone las obras citadas tras el último párrafo, sin página nueva, quita el salto del estilo del encabezado.
- headingStyles: [{ id: 'works-cited', breakBefore: { enabled: true, parity: 'any' } }],
+ headingStyles: [{ id: 'works-cited', breakBefore: { enabled: false } }],#Cita en Chicago autor-año
El mismo ensayo en Chicago pone el año tras el autor, «(Brooks 1947, 165)», y la lista se adapta.
- style: 'modern-language-association', // MLA 9th edition, author-page
+ style: 'chicago-author-date',Errores frecuentes
- citeproc-js imprime los títulos tal como vienen en los datos. MLA escribe los títulos ingleses con mayúscula en cada palabra principal, así que escríbelos así en las referencias.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Citas de «Ode on a Grecian Urn» (1820) · John Keats · dominio público
- Citas de dos cartas de 1817, en Letters of John Keats to His Family and Friends, ed. de Sidney Colvin (1925) · John Keats · dominio público
- Fuentes
- Spectral (SIL OFL 1.1) · Spectral SC (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


