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
// 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
- Funcions
- Estils de paràgrafNegreta, cursiva i els seus colorsTabuladors i farcimentsSagnats, alineació i separació de paràgrafsNivells de títolCapítols que obren en pàgina senarTipus de recurs propisFigures just aquíEstils de títolCobertes, portades i colofonsAtributs de títolImatges als dissenys de pàginaTextos, filets i caixes als dissenys de pàginaCapçaleres i folisCapçaleres segons el tipus de pàginaMetadades del documentColor del paperPaleta de color semàntica
- També fa servir
- Obertures dissenyadesFigures i taules com a recursosCapçaleres per seccióEspai vertical explícit
- 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
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
// 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
// ::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
// # 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
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
// ═══ 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 abodyTextperquè 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.maxRuntTrackingadmet per defecte, i el parlament queda més fosc que els del voltant.maxRuntTracking: 5deixa 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
- Recepta
- Ignacio Ferro
- 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)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


