En pocas palabras
El comienzo de una comedia famosa de Oscar Wilde, impresa para los actores. El nombre de quien habla destaca en negrita de color, y las acotaciones van en gris para saltarlas con facilidad.
Lo que vas a componer
El comienzo de La importancia de llamarse Ernesto, de Oscar Wilde, en una edición para actores de cinco páginas de 140 × 216 mm. La portada es un cartel color ciruela dentro de un doble marco dorado, con Importancia y Ernesto en versales gruesas de cartel y un clavel dorado bajo el título. Frente al primer acto, el reparto nombra al actor que estrenó cada papel en el teatro St James’s en 1895. Cada parlamento empieza con el nombre del personaje en negrita ciruela y sangra 5 mm las líneas siguientes, de modo que el actor ve enseguida cuándo le toca hablar. Las acotaciones van en cursiva gris, estén dentro de un parlamento o entre dos, y al repasar el papel la vista se las salta. La edición española es una traducción nueva que sigue la costumbre del teatro en español: raya tras el nombre y acotaciones entre paréntesis.
Esta receta responde a
- ¿Cómo compongo un guion de cine o una obra de teatro: encabezados de escena, nombres de personaje y diálogo sangrado por los dos lados?
- ¿Cómo doy color a los términos clave (en negrita o cursiva) en el texto o dentro de los recuadros?
- ¿Cómo compongo ilustraciones sin numerar: adornos, viñetas, logotipos?
La respuesta corta
// 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) };
Ingredientes
- Funciones
- Estilos de párrafoNegrita, cursiva y sus coloresTabuladores y rellenosSangrías, alineación y separación de párrafosNiveles de títuloCapítulos que abren en página imparTipos de recurso propiosFiguras justo aquíEstilos de títuloCubiertas, portadas y colofonesAtributos de títuloImágenes en los diseños de páginaTextos, filetes y cajas en los diseños de páginaCabeceras y foliosCabeceras según el tipo de páginaMetadatos del documentoColor del papelPaleta de color semántica
- También usa
- Aperturas diseñadasFiguras y tablas como recursosCabeceras por secciónEspacio vertical explícito
- Tipografía
- Libre Baskerville, Abril Fatface, Playfair Display SC (SIL OFL 1.1)
- Recursos
- El marco de la portada y el florón del clavel, dibujados en código con la paleta de la página (Ignacio Ferro, MIT)
Elaboración
#1 · Un acto es un título sin más
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') },
],
};
El acto se abre con un encabezado de primer nivel en Abril Fatface de 24 pt, sin zona de diseño. textTransform lo pasa a versales, y las tres líneas de 13,6 pt de la rejilla que ocupa dejan esas versales 5,5 mm por debajo del borde superior de la caja (encabezados). textAlign: 'center' no admite un valor por nivel, así que centra también los títulos del reparto y el rótulo Escena. breakBefore con paridad 'odd' lleva el acto a una página impar, frente al reparto. El valor por defecto, 'always-odd', dejaría dos páginas en blanco entre ambos (salto de página antes del encabezado).
#2 · El reparto es una fila de puntos hasta 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 personaje es un párrafo del estilo person, con el actor tras :tab (tabuladores y tabulaciones). El estilo tiene una sola tabulación, en 'end', el final de la medida, y con align: 'end' el nombre del actor termina en ella. Su leader: '.' llena de puntos el hueco anterior a la tabulación, a medio em del personaje y del actor, y spaceBetween pone un personaje cada línea y media. Los nombres de los personajes van en negrita, así que salen en ciruela, como los de quien habla en el diálogo. El reparto del estreno, el teatro y la fecha encabezan la lista en el estilo bill-head, centrados en Playfair Display SC, cuyas minúsculas son versalitas. Los lugares de la acción llevan dos tabulaciones: :tab Acto I :tab … termina Acto I en la primera, a 15 mm del margen, con align: 'end', de modo que los tres actos quedan alineados a la derecha en una columna, y empieza el lugar en la segunda, 2 mm más allá. La época es una línea centrada con el estilo de las acotaciones.
#3 · Adornos sin número ni pie
// ::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 tipo de recurso con captionPrefix y shortLabel vacíos imprime sus ilustraciones solas, sin pie (tipos de recurso). Su defaultPlacement coloca el clavel donde está ::resource{id="fleuron"}, centrado y con un ancho de 0,24 de la medida de 107 mm, unos 26 mm.
#4 · La portada es un estilo de título
// # 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" …} lleva el título en cuatro atributos que el diseño compone en dos familias: Abril Fatface de 40 y 60 pt para los sustantivos y Libre Baskerville cursiva de 17 pt para La y de llamarse (atributos de encabezado). El fondo ciruela, el marco y el clavel son un solo SVG dibujado en código y anclado al sangrado (elementos de imagen). El estilo lleva span: 'page' aunque el libro tenga una sola columna. Si el diseño se quedara en la columna, se cortaría por el pie de la caja de texto, a 23,3 mm del borde inferior de la hoja. El header vacío del estilo quita las cabeceras del reparto, que pertenece a la misma sección, y su footer vacío quita de la portada el folio al pie, que saldría en ciruela sobre ciruela (estilos de encabezado).
El fondo es un elemento de imagen, y una apertura reserva altura hasta el pie de sus imágenes, así que el título ocupa la hoja entera: Personajes de la obra empieza en la página 2 sin ningún :::pagebreak tras la portada, estén donde estén sus líneas. Tampoco hay que corregir las líneas centradas con letterSpacing. El espaciado que sigue a la última letra no cuenta al centrar, y OSCAR WILDE queda en el centro de la página.
#5 · Cabeceras que se saltan la primera página del acto
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 par lleva el título de la obra, tomado del frontmatter, y la impar el del acto, de {chapterTitle}; las dos van en versales de Playfair Display SC, con el folio en ciruela en el borde exterior (elementos de texto). La primera página del acto cuenta como apertura porque su primer bloque es un título que salta de página, así que pages: 'body' le quita las cabeceras, y el pie de página le pone en su lugar un folio centrado.
La receta 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,
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
#Alinea las acotaciones con las líneas sangradas
En bandera y con una sangría de primera línea de 5 mm, una acotación de una línea arranca a la altura de las líneas sangradas de los parlamentos, y la descripción de la escena se convierte en dos párrafos sangrados bajo su rótulo centrado.
const direction = { id: 'direction', fontSize: pt(8.6),
- textAlign: 'center', firstLineIndent: pt(0) };
+ textAlign: 'left', firstLineIndent: mm(5) };#Deja una línea entre parlamentos
paragraphSpacing: true añade una línea en blanco de la rejilla tras cada parlamento. El acto inglés pasa entonces de tres a cinco páginas, y el español, de tres a cuatro.
firstLineIndent: mm(5), hangingIndent: true, // the name at the margin, the turnovers hung
+ paragraphSpacing: true,
};Errores frecuentes
Error frecuente
::resource{id="…"} solo admite comillas dobles
Una inserción de bloque solo se reconoce como ::resource{id="…"} con comillas dobles; cualquier otra forma se queda en el texto como una línea visible. Figuras justo aquí →
- Toda cursiva del diálogo toma
italicColor, también la de énfasis, y el es que subraya Lane sale en el gris de las acotaciones. El gris va enbodyTextporque la mayoría de las acotaciones están dentro de un parlamento, en el mismo párrafo que el énfasis; solo en redonda quedaría ese es en tinta. - En la edición inglesa, tres parlamentos de Wilde terminan en una palabra sola: information., you. y that? El tercero puede subir a la línea anterior, pero solo con el 1 % de espaciado negativo entre letras que
bodyText.maxRuntTrackingadmite por defecto, y el parlamento queda más oscuro que los que lo rodean.maxRuntTracking: 5deja ese tope en la mitad: that? baja a una línea propia y la de arriba se abre hasta 1,78 veces el espacio normal, dentro del límite de 1,8. Las tres líneas cortas se quedan, para no tocar el texto de Wilde. La traducción española se reescribió allí donde una línea acababa en una palabra de una letra o donde una sílaba quedaba sola. - Los nombres se dividen como cualquier otra palabra: en la página 5 de la edición inglesa, Au-gusta y Gwen-dolen se parten entre dos líneas. Un carácter de unión de palabras (U+2060) dentro de Augusta mantiene el nombre entero, pero estira la línea anterior hasta 1,71 veces el espacio normal, así que el texto inglés conserva los guiones.
- En el canvas, Playfair Display SC dibuja fi como una ligadura en minúscula, así que first saldría con una fi minúscula entre versalitas. Por eso la cabecera del reparto inglés dice The original cast.
Créditos
- Receta
- Ignacio Ferro
- Texto
- The Importance of Being Earnest (La importancia de llamarse Ernesto, 1895): los personajes y los lugares de la obra, el reparto del estreno y el comienzo del primer acto · Oscar Wilde · dominio público
- La traducción al español del fragmento, del reparto y de los lugares de la acción · Postext Cookbook · original
- Imágenes
- El marco de la portada y el florón del clavel, dibujados en código con la paleta de la página · Ignacio Ferro · MIT
- Fuentes
- Libre Baskerville (SIL OFL 1.1) · Abril Fatface (SIL OFL 1.1) · Playfair Display 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)


