Saltar al contingut principal
Recepta número 96

Receptari · Capítol 5 · Estructura del llibre

Un assaig d'humanitats amb obres citades en MLA

Un assaig literari amb cites [@clau, 48] que surten en MLA 9, autor i pàgina, amb una cita en bloc i la llista d'obres citades presa de dades BibTeX.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 150 × 230 mm
  • 1 columna
  • Spectral 10,6/14,4
  • Spectral SC
  • 4 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 94 ms
  • 141 línies de codi

En poques paraules

Un assaig sobre un poema de Keats, tal com l'imprimeix una revista literària. L'autora escriu una clau curta per a cada font; Postext imprimeix l'autor i la pàgina entre parèntesis i la llista d'obres citades al final, en estil MLA.

Què compondràs

Un assaig d'una revista literària trimestral: quatre pàgines sobre qui diu els dos últims versos de l'«Ode on a Grecian Urn» de Keats. La pàgina fa 150 × 230 mm i va en Spectral, amb els títols de secció i les capçaleres en Spectral SC; l'obertura ocupa una banda del negre del vernís sobre una franja d'argila vermella, els dos colors d'un vas àtic. Les cites segueixen MLA 9, l'estil de gairebé tots els departaments de literatura i d'història de l'art: autor i pàgina entre parèntesis, només la pàgina quan la frase ja anomena l'autor, un títol abreujat quan dues obres són del mateix autor i la llista d'obres citades en pàgina a part. Cada cita és una clau en el text i l'estil és un sol paràmetre de configuració.

Aquesta recepta respon a

  • Com cito obres i componc la bibliografia en APA, IEEE o un altre estil de cita?

La resposta curta

script.js · línies 32–44al codi complet
// 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),
  },
};

Ingredients

Tipografia
Spectral, Spectral SC (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · L'estil és MLA; les dades, BibTeX

El codi és la resposta curta de més amunt. El motor de cites es registra una vegada i citations.style indica l'estil MLA inclòs; citeproc-js hi redacta cada cita i la llista. Les referències van en un bloc :::references{format=bibtex} al final de l'assaig, escrites tal com les exporta un gestor de referències. MLA necessita un títol abreujat per a les dues obres de Keats, i el camp shorttitle de cada entrada el dona (en CSL es diu title-short).

#2 · Quatre maneres de citar

El text cita una obra amb [@jack1967], que imprimeix «(Jack)» perquè l'assaig es refereix al llibre sencer. Amb pàgina, [@keats-letters, 41] imprimeix «(Keats, Letters 41)»: se citen dues obres de Keats, així que citeproc hi afegeix el títol abreujat per distingir-les. Quan la frase ja anomena el crític, [-@eliot1932, 230] omet el nom i imprimeix «(230)». Una cita narrativa sense pàgina, @stillinger1974 recoge, imprimeix només el nom, «Stillinger recoge», amb un sol espai darrere: MLA no té res a posar entre parèntesis. Un cop citada l'oda amb els seus números de vers, les cites següents porten només els números, escrits entre parèntesis normals, com permet MLA.

#3 · Una cita en bloc amb la referència després del punt

script.js · línies 48–52al codi complet
// 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 passa de quatre línies de prosa, així que va a part com a cita en bloc de Markdown: en rodona, en el color del text, sagnada 2 em i sense sagnat de primera línia. MLA posa la referència d'una cita en bloc darrere del punt final, i l'original fa el mateix: …fact and reason. [@keats-letters, 48]. Un :::space{lines=0.5} a sobre i un altre a sota la separen dels paràgrafs que l'envolten.

#4 · Les obres citades, en pàgina a part

script.js · línia 119al codi complet
  headingStyles: [{ id: 'works-cited', breakBefore: { enabled: true, parity: 'any' } }],

El títol porta un estil que salta a pàgina nova, i :::bibliography{title=""} col·loca la llista a sota sense un segon títol. La llista va en ordre alfabètic amb sagnat francès, i la segona obra de Keats comença amb una ratlla triple en lloc del nom, com demana MLA per als autors repetits. Un foli al peu apareix en aquesta pàgina i a l'obertura, on no hi ha capçaleres.

#5 · L'obertura en els dos colors d'un vas

script.js · línies 56–81al codi complet
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) },
  ] },
};
script.js · línies 16–23al codi complet
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 fa 116 mm i porta l'avantítol, el títol de 56 pt en Spectral Light cursiva, el subtítol i la signatura, tots presos d'atributs del títol. La franja d'argila és una segona caixa ancorada 3 mm per sobre del peu de la banda.

La recepta completa

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

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Variants

#Posa la llista a continuació de l'assaig

Una revista que compon les obres citades després de l'últim paràgraf, sense pàgina nova, treu el salt de l'estil del títol.

-  headingStyles: [{ id: 'works-cited', breakBefore: { enabled: true, parity: 'any' } }],
+  headingStyles: [{ id: 'works-cited', breakBefore: { enabled: false } }],

#Cita en Chicago autor-any

El mateix assaig en Chicago posa l'any després de l'autor, «(Brooks 1947, 165)», i la llista s'hi adapta.

-  style: 'modern-language-association', // MLA 9th edition, author-page
+  style: 'chicago-author-date',

Errors freqüents

  • citeproc-js imprimeix els títols tal com vénen a les dades. MLA escriu els títols anglesos amb majúscula a cada paraula principal, així que escriu-los així a les referències.

Crèdits

Text
Fonts
Spectral (SIL OFL 1.1) · Spectral SC (SIL OFL 1.1)
SandboxPDF