Saltar al contingut principal
Recepta número 70

Receptari · Capítol 9 · Publicacions completes

Obra de teatre: repartiment, personatges i acotacions

L'obra de Wilde en edició per a actors: noms en negreta pruna, acotacions en cursiva grisa i un repartiment amb punts fins a cada actor en una tabulació.

En aquesta pàgina
Sortida
Canvas
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0
Llicència
Actualitzada el 11 d’oct. del 2026
Codi MIT · Text MIT
  • Mostra en castellà: encara no hi ha edició en català
  • Format 140 × 216 mm
  • 1 columna
  • Libre Baskerville 9,4/13,6
  • Abril Fatface
  • Playfair Display SC
  • 5 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 86 ms
  • 160 línies de codi

En poques paraules

El començament d'una comèdia famosa d'Oscar Wilde, impresa per als actors. El nom de qui parla destaca en negreta de color, i les acotacions van en gris per saltar-les amb facilitat.

Què compondràs

El començament de La importància de dir-se Ernest, d'Oscar Wilde, en una edició per a actors de cinc pàgines de 140 × 216 mm. La portada és un cartell color pruna dins d'un doble marc daurat, amb Importancia i Ernesto en versals gruixudes de cartell i un clavell daurat sota el títol. Davant del primer acte, el repartiment anomena l'actor que va estrenar cada paper al teatre St James’s el 1895. Cada parlament comença amb el nom del personatge en negreta pruna i sagna 5 mm les línies següents, de manera que l'actor veu de seguida quan li toca parlar. Les acotacions van en cursiva grisa, tant si són dins d'un parlament com entre dos, i en repassar el paper la vista se les salta. L'edició espanyola és una traducció nova que segueix el costum del teatre en espanyol: guió llarg després del nom i acotacions entre parèntesis.

Aquesta recepta respon a

  • Com componc un guió de cinema o una obra de teatre: encapçalaments d'escena, noms de personatge i diàleg sagnat pels dos costats?
  • Com dono color als termes clau (en negreta o cursiva) en el text o dins dels requadres?
  • Com componc il·lustracions sense numerar: ornaments, vinyetes, logotips?

La resposta curta

script.js · línies 34–54al codi complet
// Speeches are plain paragraphs, the speaker's name in bold and each stage direction in
// italic; a direction between two speeches is a paragraph of its own, in a container:
//   **LANE.** Yes, sir. *[Hands them on a salver.]*
//   :::paragraphs{style="direction"}
//   *[Enter Lane.]*
//   :::
// The body's two emphasis colours then mark who speaks (plum) and what is done (grey).
const dialogue = {
  fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('plum'), // **ALGERNON.**
  italicColor: col('muted'), // *[Languidly.]*, in a speech or a paragraph of its own
  minWordSpacing: 0.65, maxWordSpacing: 1.8, // justified (the default); limits inside 0.6–2
  // A runt fix tracks by 5/1000 em at most (default 10). At 10, “that?” went up beside “as”
  // and the speech stood darker than the ones around it; at 5 the word turns over.
  maxRuntTracking: 5,
  firstLineIndent: mm(5), hangingIndent: true, // the name at the margin, the turnovers hung
};
// Directions: smaller and centred, on the same grid. They are written *…* like the ones
// inside a speech, so both take the body's italic grey.
const direction = { id: 'direction', fontSize: pt(8.6),
  textAlign: 'center', firstLineIndent: pt(0) };

Ingredients

Tipografia
Libre Baskerville, Abril Fatface, Playfair Display SC (SIL OFL 1.1)
Recursos
  • The title page’s frame and the carnation fleuron, drawn in code in the page’s palette (Ignacio Ferro, MIT)

Elaboració

#1 · Un acte és un títol i prou

script.js · línies 58–69al codi complet
const headings = {
  fontFamily: LABEL, fontWeight: 400, color: col('ink'),
  textAlign: 'center', // every level: the act, the cast list's heads, the scene
  lineHeight: pt(LEAD), marginTop: pt(LEAD), marginBottom: pt(0), // whole lines of the grid
  levels: [
    { level: 1, fontFamily: DISPLAY, fontSize: pt(24), lineHeight: pt(3 * LEAD),
      color: col('plum'), textTransform: 'uppercase',
      breakBefore: { enabled: true, parity: 'odd' } }, // a recto, facing the cast list
    { level: 2, fontSize: pt(13), lineHeight: pt(2 * LEAD) },
    { level: 3, fontSize: pt(9.5), color: col('plum') },
  ],
};

L'acte s'obre amb un títol de primer nivell en Abril Fatface de 24 pt, sense zona de disseny. textTransform el passa a versals, i les tres línies de 13,6 pt de la retícula que ocupa deixen aquestes versals 5,5 mm per sota de la vora superior de la caixa (encapçalaments). textAlign: 'center' no admet un valor per nivell, així que també centra els títols del repartiment i el rètol Escena. breakBefore amb paritat 'odd' porta l'acte a una pàgina senar, davant del repartiment. El valor per defecte, 'always-odd', deixaria dues pàgines en blanc entre tots dos (salt de pàgina previ).

#2 · El repartiment és una filera de punts fins a cada actor

script.js · línies 73–85al codi complet
// A tab sends the actor to a stop at the end of the measure that ends the text there; the stop's
// leader fills the room before it with dots, from half an em after the person to half an em
// before the actor. The bill's head is a centred line in the face's own small capitals.
const person = { id: 'person', fontSize: pt(8.8), firstLineIndent: pt(0), textAlign: 'left',
  tabStops: [{ position: 'end', align: 'end', leader: '.' }],
  spaceBetween: pt(LEAD / 2) }; // a person every line and a half
const billHead = { id: 'bill-head', fontFamily: LABEL, fontSize: pt(8.5), color: col('plum'),
  textAlign: 'center', firstLineIndent: pt(0), marginTop: pt(LEAD / 2),
  marginBottom: pt(LEAD / 2) };
// The scenes: two stops, so `:tab Act I :tab Algernon’s flat` ends the act on the first
// (15 mm in) and starts the place on the second, 2 mm after it, as a two-column list would.
const scene = { id: 'scene', textAlign: 'left', firstLineIndent: pt(0), marginTop: pt(LEAD / 2),
  tabStops: [{ position: mm(15), align: 'end' }, { position: mm(17) }] };

Cada personatge és un paràgraf de l'estil person, amb l'actor després de :tab (tabuladors i tabulacions). L'estil té una sola tabulació, a 'end', el final de la mesura, i amb align: 'end' el nom de l'actor hi acaba. El seu leader: '.' omple de punts l'espai que hi ha abans de la tabulació, a mig em del personatge i de l'actor, i spaceBetween posa un personatge cada línia i mitja. Els noms dels personatges van en negreta, així que surten en pruna, com els dels qui parlen al diàleg. El repartiment de l'estrena, el teatre i la data encapçalen la llista amb l'estil bill-head, centrats en Playfair Display SC, que té les minúscules en versaletes. Els llocs de l'acció porten dues tabulacions: :tab Acto I :tab … fa acabar Acto I a la primera, a 15 mm del marge, amb align: 'end', de manera que els tres actes queden alineats a la dreta en una columna, i fa començar el lloc a la segona, 2 mm més enllà. L'època és una línia centrada amb l'estil de les acotacions.

#3 · Ornaments sense número ni peu

script.js · línies 89–94al codi complet
// ::resource{id="fleuron"} sets it where it stands (gotcha: resource-double-quotes).
const unnumbered = (id, name, defaultPlacement) => ({ id, name, shortLabel: '', captionPrefix: '',
  numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal', defaultPlacement });
const resourceTypes = [
  unnumbered('ornament', 'Ornament', { position: 'here', width: 0.24, align: 'center' }),
];

Un tipus de recurs amb captionPrefix i shortLabel buits imprimeix les il·lustracions soles, sense peu (tipus de recurs). El seu defaultPlacement col·loca el clavell on hi ha ::resource{id="fleuron"}, centrat i amb una amplada de 0,24 de la mesura de 107 mm, uns 26 mm.

#4 · La portada és un estil d'encapçalament

script.js · línies 98–120al codi complet
// # The Importance of Being Earnest {style="playbill" small="The" big="Importance" …}
// Each attribute is a playbill line in its own face and size. The ground is an image that
// fills the sheet: the heading reserves down to its foot, so the cast list starts on page 2.
const line = (id, content, font, size, y, color, extra = {}) => ({ kind: 'text', id, content,
  fontFamily: font, fontSize: pt(size), lineHeight: 1, color: col(color), align: 'center',
  placement: { anchor: { to: 'page', edge: 'top' }, offset: { y: mm(y) } }, ...extra });
const tracked = (track) => ({ textTransform: 'uppercase', letterSpacing: pt(track) });
const playbill = {
  id: 'playbill', span: 'page', // kept in the column, its foot would cut the ground
  header: { elements: [] }, footer: { elements: [] }, // no heads on p. 2, no folio on p. 1
  advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'image', id: 'ground', resourceId: 'playbill',
      placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { width: 'fill' } } },
    line('kicker', '{subtitle}', LABEL, 8.5, 36, 'gilt', tracked(1.7)),
    line('small', '{attr.small}', TEXT, 17, 51, 'paper', { italic: true }),
    line('big', '{attr.big}', DISPLAY, 40, 60, 'paper', { textTransform: 'uppercase' }),
    line('link', '{attr.link}', TEXT, 17, 78, 'gilt', { italic: true }),
    line('name', '{attr.name}', DISPLAY, 60, 87, 'paper', { textTransform: 'uppercase' }),
    line('author', '{author}', LABEL, 13, 133, 'paper', tracked(3)),
    line('theatre', '{attr.theatre}', LABEL, 8, 170, 'gilt', tracked(1.6)),
    line('premiere', '{attr.premiere}', TEXT, 8.5, 176, 'paper', { italic: true }),
  ] } },
};

# La importancia de llamarse Ernesto {style="playbill" …} porta el títol en quatre atributs que el disseny compon en dues famílies: Abril Fatface de 40 i 60 pt per als substantius i Libre Baskerville cursiva de 17 pt per a La i de llamarse (atributs d'encapçalament). El fons pruna, el marc i el clavell són un sol SVG dibuixat en codi i ancorat a la sang (elements d'imatge). L'estil porta span: 'page' encara que el llibre tingui una sola columna. Si el disseny es quedés a la columna, es tallaria pel peu de la caixa de text, a 23,3 mm de la vora inferior del full. El header buit de l'estil treu les capçaleres del repartiment, que pertany a la mateixa secció, i el seu footer buit treu de la portada el foli al peu, que sortiria en pruna sobre pruna (estils d'encapçalament).

El fons és un element d'imatge, i una obertura reserva alçada fins al peu de les seves imatges, així que el títol ocupa el full sencer: Personajes de la obra comença a la pàgina 2 sense cap :::pagebreak després de la portada, siguin on siguin les seves línies. Tampoc cal corregir les línies centrades amb letterSpacing. L'espaiat que segueix l'última lletra no compta a l'hora de centrar, i OSCAR WILDE queda al centre de la pàgina.

#5 · Capçaleres que se salten la primera pàgina de l'acte

script.js · línies 124–140al codi complet
const head = (id, content, parity, edge, x, style) => ({
  kind: 'text', id, content, parity, pages: 'body', // never on openers or blank pages
  fontFamily: LABEL, fontSize: pt(8.5), letterSpacing: pt(0.8), color: col('muted'),
  textTransform: 'uppercase', ...style,
  placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(11) } },
});
const folio = { fontFamily: TEXT, letterSpacing: pt(0), color: col('plum') };
const header = { elements: [
  head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, folio),
  head('verso-title', '{title}', 'even', 'top-left', OUTER + 8),
  head('recto-act', '{chapterTitle}', 'odd', 'top-right', -(OUTER + 8)),
  head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, folio),
] };
// The act's first page carries a drop folio instead, centred under the text block.
const footer = { elements: [{ ...head('drop-folio', '{pageNumber}', 'all', 'top', 0, folio),
  pages: 'opener', align: 'center',
  placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(8) } } }] };

La pàgina parella porta el títol de l'obra, pres del frontmatter, i la senar el de l'acte, de {chapterTitle}; tots dos van en versals de Playfair Display SC, amb el foli en pruna a la vora exterior (elements de text). La primera pàgina de l'acte compta com a obertura perquè el seu primer bloc és un títol que salta de pàgina, així que pages: 'body' li treu les capçaleres, i el peu de pàgina hi posa en el seu lloc un foli centrat.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 070 · Play script: cast list, speakers and stage directions ═══
// https://postext.dev/en/cookbook/stage-play
// Code: MIT · Text: Oscar Wilde, 1895 (PD, Gutenberg #844), Spanish: the Cookbook · Art: in code
// Fonts: Libre Baskerville, Abril Fatface, Playfair Display SC (OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'stage-play';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // every colour in the config links to one of these
  ink: '#221b1f', // the dialogue: a near-black with a little plum in it
  plum: '#5b2349', // the one accent: speakers' names, act titles, the title page's ground
  gold: '#b48a45', // rules and ornaments
  gilt: '#c9aa77', // gold lightened for small type on the plum ground (5.3:1)
  muted: '#6c6168', // stage directions and running heads (5.5:1 on the paper)
  paper: '#fbf6ec', // a cream stock
};
// A colour is its hex and the palette entry it follows.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  // The engine's defaults link to 'main-color': point it at the accent, so nothing prints blue.
  { id: 'main-color', name: 'plum (defaults)', value: { hex: palette.plum, model: 'hex' } },
];
const [TEXT, DISPLAY, LABEL] = ['Libre Baskerville', 'Abril Fatface', 'Playfair Display SC'];
const [BODY, LEAD] = [9.4, 13.6]; // pt: the dialogue and its leading, the pitch of the grid
const TRIM = { width: 140, height: 216 }; // mm: 5½ × 8½ in, the acting-edition size
const [TOP, INNER, OUTER, LINES] = [20, 18, 15, 36]; // mm, and 36 lines to a full page

// #region answer: a speech is a paragraph: the name in bold, the directions in italic
// Speeches are plain paragraphs, the speaker's name in bold and each stage direction in
// italic; a direction between two speeches is a paragraph of its own, in a container:
//   **LANE.** Yes, sir. *[Hands them on a salver.]*
//   :::paragraphs{style="direction"}
//   *[Enter Lane.]*
//   :::
// The body's two emphasis colours then mark who speaks (plum) and what is done (grey).
const dialogue = {
  fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('plum'), // **ALGERNON.**
  italicColor: col('muted'), // *[Languidly.]*, in a speech or a paragraph of its own
  minWordSpacing: 0.65, maxWordSpacing: 1.8, // justified (the default); limits inside 0.6–2
  // A runt fix tracks by 5/1000 em at most (default 10). At 10, “that?” went up beside “as”
  // and the speech stood darker than the ones around it; at 5 the word turns over.
  maxRuntTracking: 5,

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

#Alinea les acotacions amb les línies sagnades

En bandera i amb un sagnat de primera línia de 5 mm, una acotació d'una línia comença a l'altura de les línies sagnades dels parlaments, i la descripció de l'escena es converteix en dos paràgrafs sagnats sota el seu rètol centrat.

 const direction = { id: 'direction', fontSize: pt(8.6),
-  textAlign: 'center', firstLineIndent: pt(0) };
+  textAlign: 'left', firstLineIndent: mm(5) };

#Deixa una línia entre parlaments

paragraphSpacing: true afegeix una línia en blanc de la retícula després de cada parlament. L'acte anglès passa llavors de tres a cinc pàgines, i l'espanyol, de tres a quatre.

   firstLineIndent: mm(5), hangingIndent: true, // the name at the margin, the turnovers hung
+  paragraphSpacing: true,
 };

Errors freqüents

Error freqüent

::resource{id="…"} només admet cometes dobles

Una inserció de bloc només es reconeix com a ::resource{id="…"} amb cometes dobles; qualsevol altra forma es queda al text com una línia visible. Figures just aquí →

  • Tota cursiva del diàleg pren italicColor, també la d'èmfasi, i l'es que subratlla Lane surt en el gris de les acotacions. El gris va a bodyText perquè la majoria de les acotacions són dins d'un parlament, al mateix paràgraf que l'èmfasi; només en rodona quedaria aquest es en tinta.
  • A l'edició anglesa, tres parlaments de Wilde acaben en una paraula sola: information., you. i that? El tercer pot pujar a la línia anterior, però només amb l'1 % d'interlletratge negatiu que bodyText.maxRuntTracking admet per defecte, i el parlament queda més fosc que els del voltant. maxRuntTracking: 5 deixa aquest límit a la meitat: that? baixa a una línia pròpia i la de sobre s'obre fins a 1,78 vegades l'espai normal, dins del límit d'1,8. Les tres línies curtes s'hi queden, per no tocar el text de Wilde. La traducció espanyola es va reescriure allà on una línia acabava en una paraula d'una lletra o on una síl·laba quedava sola.
  • Els noms es parteixen com qualsevol altra paraula: a la pàgina 5 de l'edició anglesa, Au-gusta i Gwen-dolen es parteixen entre dues línies. Un caràcter d'unió de paraules (U+2060) dins d'Augusta manté el nom sencer, però estira la línia anterior fins a 1,71 vegades l'espai normal, així que el text anglès conserva els guionets.
  • Al canvas, Playfair Display SC dibuixa fi com una lligadura en minúscula, així que first sortiria amb una fi minúscula entre versaletes. Per això la capçalera del repartiment anglès diu The original cast.

Crèdits

Text
  • The Importance of Being Earnest (1895): the persons and scenes of the play, the first cast and the opening of the first act · Oscar Wilde · domini públic
  • The Spanish translation of the extract, the cast list and the scenes · Postext Cookbook · original
Imatges
  • The title page’s frame and the carnation fleuron, drawn in code in the page’s palette · Ignacio Ferro · MIT
Fonts
Libre Baskerville (SIL OFL 1.1) · Abril Fatface (SIL OFL 1.1) · Playfair Display SC (SIL OFL 1.1)
Sandbox