En pocas palabras
El guion de un cortometraje con el formato que usan los estudios de cine. Lleva una letra de máquina de escribir, y los diálogos y los números de escena van a distancias fijas del borde.
Lo que vas a componer
La versión de rodaje de Objetos perdidos, un cortometraje inventado de tres páginas, encuadernada como los guiones de los estudios: cubierta de cartulina mostaza con dos encuadernadores de latón y etiqueta mecanografiada, el interior sellado con COPIA 07 y, detrás, el guion en Courier Prime de 12 sobre 12 en papel carta taladrado. Las medidas son las de los programas de guion: acción de 1,5 a 7,5 pulgadas; réplica de 2,5 a 6, bajo el nombre del personaje a 3,7; acotación desde 3,1, y CORTE A: y FUNDIDO A NEGRO. hasta el margen derecho. Cada escena lleva su número en los dos márgenes. La página 1 del guion no lleva número; las demás, arriba a la derecha y con punto. Cada réplica es un recuadro sin borde, con el nombre del personaje en el mismo interlineado de 12 pt que el texto, y así acción y diálogo mantienen seis líneas por pulgada.
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?
La respuesta corta
// Positions from the left edge of the sheet, in inches, as screenwriting software gives them.
const DIALOGUE = { left: 2.5, right: 6 }; // the block of speech, 3.5 inches wide
const CUE = 3.7; // the character's name
const TEXT_RIGHT = 8.5 - MARGIN.right; // 7.5: where action lines end
const dialogue = {
id: 'dialogue',
backgroundEnabled: false, // no fill and no border: the box is only a measure
padding: { top: pt(0), bottom: pt(0),
left: mm((DIALOGUE.left - MARGIN.left) * IN), // 1 inch in from the action
right: mm((TEXT_RIGHT - DIALOGUE.right) * IN) }, // 1.5 inches short of it
// The fence's title is the cue: title="Dora (cont’d)" prints DORA (CONT’D) at 3.7 inches,
// in the headings' Courier, with no gap under it (the default is half a line). On the
// body's 12-pt leading (the default is 1.2 times its size, 14.4 pt), the name sits on a
// grid line and a speech is a whole number of lines.
titleStyle: { fontWeight: 400, textTransform: 'uppercase', lineHeight: pt(LEAD),
indent: mm((CUE - DIALOGUE.left) * IN), gap: pt(0) },
body: { paragraphSpacing: false }, // no blank line before a parenthetical mid-speech
marginTop: pt(LEAD), marginBottom: pt(LEAD), // one blank line above and below
// Snapped to the grid, a box keeps its bottom margin and the next speech adds its top
// margin: two blank lines between speeches. Unsnapped, the two margins collapse into one.
snapToGrid: false,
};
Ingredientes
- Funciones
- RecuadrosSalir de la rejilla a propósitoEstilos de párrafoTítulos numeradosEstilos de títuloAperturas diseñadasAtributos de títuloCubiertas, portadas y colofonesCabeceras según el tipo de páginaCabeceras y foliosCabeceras por secciónTextos, filetes y cajas en los diseños de páginaFormato de páginaUnidades y medidasTipografía del textoSangrías, alineación y separación de párrafosEquilibrado de columnasPaleta de color semánticaPáginas en un canvas
- También usa
- Preliminares en romanos
- Tipografía
- Courier Prime, Oswald (SIL OFL 1.1) · Special Elite (Apache 2.0)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Ajusta un recuadro sin marco al bloque de diálogo
El código está en la respuesta corta, más arriba. El relleno de un recuadro se mide desde la caja de texto, así que 1 pulgada a la izquierda y 1,5 a la derecha dejan el bloque de 3,5 pulgadas que empieza a 2,5 del borde de la hoja (estilos de recuadro). El nombre del personaje es el título del recuadro y se escribe en la línea de apertura: title="Dora (cont.)". textTransform lo pasa a mayúsculas, e indent lo lleva 1,2 pulgadas más allá del relleno, hasta 3,7. gap vale 0 porque, por defecto, entre el nombre y la réplica queda medio cuadratín, 6 pt. Por defecto el título de un recuadro se compone en una línea de 1,2 veces su cuerpo, 14,4 pt aquí. titleStyle.lineHeight lo pone en los 12 pt del texto, así que el nombre cae en una línea de la rejilla y la réplica ocupa un número entero de líneas de 12 pt; con el valor por defecto, cada réplica alejaría 2,4 pt más de la rejilla el texto que la sigue. Con snapToGrid desactivado, el margen inferior de una réplica y el superior de la siguiente se funden en una sola línea en blanco. Un recuadro se mantiene entero por defecto, de modo que una réplica que ya no cabe pasa a la página siguiente con su nombre.
#2 · Mide la página en pulgadas
const MARGIN = { top: 1, bottom: 1, left: 1.5, right: 1 }; // inches: the left one takes the brads
const page = { sizePreset: 'custom', width: mm(8.5 * IN), height: mm(11 * IN), dpi: 150,
margins: { top: mm(MARGIN.top * IN), bottom: mm(MARGIN.bottom * IN),
left: mm(MARGIN.left * IN), right: mm(MARGIN.right * IN) } };
const bodyText = { fontFamily: TEXT, fontSize: pt(12), lineHeight: pt(LEAD), color: col('ink'),
textAlign: 'left', firstLineIndent: pt(0), // action: flush left, never justified
paragraphSpacing: true }; // a blank line between paragraphs
Tamaño carta, con el margen izquierdo de 1,5 pulgadas por el que pasan los encuadernadores y una pulgada en los otros tres lados. Courier Prime es una letra monoespaciada: a 12 pt cada carácter mide una décima de pulgada, así que una línea de acción admite 60 caracteres y una de diálogo 35, y con un interlineado de 12 pt caben 54 líneas en la página. El texto va en bandera, alineado a la izquierda, y paragraphSpacing deja una línea en blanco entre párrafos. El texto en bandera solo lleva separación silábica si la pide bodyText.hyphenation.ragged, así que ninguna palabra se corta, como pide el formato.
#3 · Haz de las acotaciones y las transiciones estilos de párrafo
const PAREN = 3.1;
const paragraphStyles = [
{ id: 'paren', firstLineIndent: mm((PAREN - DIALOGUE.left) * IN) }, // inside a speech
{ id: 'transition', textAlign: 'right' }, // CUT TO:, flush with the action's right edge
];
Un contenedor :::paragraphs{style="paren"} dentro de una réplica sangra su primera línea 0,6 pulgadas desde el borde del diálogo, hasta 3,1 (estilos de párrafo). Escribe cada acotación en una sola línea, porque el estilo solo sangra la primera. En el estilo del diálogo, body.paragraphSpacing: false deja fuera del recuadro la línea en blanco que separa los párrafos de acción, y (luego) queda justo debajo de la línea anterior. CORTE A: y FUNDIDO A NEGRO. van en contenedores transition, cuyo textAlign: 'right' los alinea con el final de las líneas de acción. Un contenedor devuelve el texto a la rejilla base después de su último párrafo; este guion no sale nunca de ella, así que el encabezado que sigue a CORTE A: conserva sus dos líneas en blanco.
#4 · Cuelga los números de escena en los dos márgenes
// Each number sits in a box half an inch wide, text aligned left, so that 9, 12 and an
// inserted 12A start at the same place on both sides.
const NUMBER_W = 0.5; // inches
const number = (id, edge, x) => ({ kind: 'text', id, content: '{number}', fontFamily: TEXT,
fontSize: pt(12), fontWeight: 700, lineHeight: 1, color: col('ink'), align: 'left',
placement: { ...at('container', edge, x * IN), size: { width: mm(NUMBER_W * IN) } } });
// The heading's own text is not painted but still measured: at the level's default 15 pt,
// scene 1's heading would wrap and reserve a second line.
const slugline = { level: 2, fontSize: pt(12), lineHeight: pt(LEAD),
marginTop: pt(2 * LEAD), marginBottom: pt(LEAD), // two blank lines above, one below
numberingTemplate: '{2}', // the scene count, which {number} prints
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'text', id: 'heading', content: '{titleText}', fontFamily: TEXT, fontSize: pt(12),
fontWeight: 700, lineHeight: 1, color: col('ink'), align: 'left', overflow: 'wrap',
placement: { ...at('container', 'top-left'), size: { width: 'fill' } } },
number('left', 'top-left', -0.6), // starts at 0.9 inches from the edge of the sheet
number('right', 'top-right', 0.25 + NUMBER_W), // starts a quarter inch past the text
] } } };
const headings = {
// The family of the speech titles, and the one the headings' unpainted text is measured
// in (left unset, a sixth face, Open Sans Bold, would be loaded for nothing).
fontFamily: TEXT,
// Script pages end where the last whole speech or paragraph ends. Balancing would add
// blank lines above the sluglines to fill them.
balancing: { enabled: false },
levels: [
// 'any': the cover, its inside and the title each open the next page, with no blank.
{ level: 1, breakBefore: { enabled: true, parity: 'any' } },
slugline,
] };
numberingTemplate: '{2}' cuenta los encabezados de nivel 2, y {number} imprime esa cuenta en el diseño (configuración por nivel). Un título con diseño avanzado conserva su sitio en la columna y dibuja sus elementos en lugar de su texto (apertura a toda página y diseño avanzado), y así los dos números pueden quedarse en los márgenes, junto al encabezado en negrita. Cada uno se ancla a la caja del propio título y sale de ella: 0,6 pulgadas a la izquierda y, a la derecha, un cuarto de pulgada más allá del final del texto, en una caja de media pulgada con el texto alineado a la izquierda, para que en un guion de más de nueve escenas los números de una y de dos cifras empiecen en el mismo sitio. El texto propio del título no se pinta, pero se mide, y por eso el nivel va a 12 pt: con los 15 pt por defecto, el encabezado de la escena 1 pasaría a dos líneas y reservaría la segunda. El equilibrado de columnas está desactivado: añadiría líneas en blanco sobre los encabezados de escena para llenar una página corta, y una página de guion acaba donde acaba su última réplica o su último párrafo.
#5 · Taladra y numera solo las páginas del guion
// Three holes down the bound edge, 4.25 inches apart, as a three-hole punch leaves them.
const HOLES = [1.25, 5.5, 9.75].map((y) => y * IN); // mm: hole centres from the top
const EDGE = 0.375 * IN; // mm: from the bound edge to the centre of each hole
const HOLE = 7; // mm across
const punched = HOLES.map((y, i) => ({ kind: 'box', id: `punch${i}`,
style: { backgroundColor: col('hole'), borderRadius: mm(HOLE / 2) },
placement: { ...at('page', 'top-left', EDGE - HOLE / 2, y - HOLE / 2),
size: { width: mm(HOLE), height: mm(HOLE) } } }));
// The script's first page opens with its title, an H1 that breaks the page, so the page is
// an 'opener' and pages: 'body' leaves it unnumbered, as the format asks.
const folio = { kind: 'text', id: 'folio', content: '{pageNumber}.', pages: 'body',
fontFamily: TEXT, fontSize: pt(12), color: col('ink'), align: 'right',
placement: at('page', 'top-right', -MARGIN.right * IN, 0.5 * IN) };
// The title's style carries the header of its section: the pages from the title to the end.
const title = { id: 'script', header: { elements: [...punched, folio] },
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: TEXT, fontSize: pt(12),
lineHeight: 1, textTransform: 'uppercase', color: col('ink'), align: 'center',
placement: { ...at('container', 'top'), size: { width: 'fill' } } },
] } }, // H1's own line, 1.2 × 18 pt, would reserve 21.6 pt and drop FADE IN: 9.6 pt
lineHeight: pt(LEAD), marginBottom: pt(LEAD) };
El estilo del encabezado del guion lleva su propia cabecera (header), que sustituye a la del documento en las páginas de su sección, del título al final (estilos de encabezado). La cabecera del documento está vacía, así que los agujeros y el número de página solo salen en el guion. El número se ancla a media pulgada del borde superior de la hoja, y pages: 'body' lo deja fuera de las páginas de apertura (elementos de texto). El título del guion es de nivel 1 y abre página, así que la página 1 cuenta como página de apertura y no lleva número, como pide el formato. Las cubiertas también son encabezados de nivel 1; :::numbering{startAt=1}, entre el interior de la cubierta y el título, da el número 1 a la página del título, y la siguiente lleva el 2. El estilo del encabezado fija una línea de 12 pt; con los 18 pt propios del nivel 1, el título iría en una línea de 21,6 pt y bajaría FUNDIDO DE ENTRADA: 9,6 pt.
La receta completa
// ═══ Postext Cookbook · Nº 061 · Screenplay format ═══════════════════════════════
// https://postext.dev/en/cookbook/screenplay-format
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Courier Prime, Oswald (SIL OFL 1.1), Special Elite (Apache 2.0) · Needs postext ≥ 1.25.0
import { buildDocumentWithFonts, renderPageToCanvas } from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'screenplay-format';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // black type on white bond, and a card cover in goldenrod
ink: '#1b1b1b', // every line of the script
paper: '#ffffff',
hole: '#e3e1db', // the punched holes down the left edge of each script page
card: '#e6b84a', // the cover stock
cardDark: '#b98a2a', // the label's shadow and the rims of the punched holes
cardInk: '#4a3510', // the small print on the cover (6.3:1 on the card)
brass: '#a8812f', // the brads
brassLight: '#e9cf82', // the glint on each brad
stamp: '#8f231c', // the draft stamp (4.7:1 on the card)
};
// Every colour is linked to its palette entry by id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to main-color: pointed at the ink, anything left unset prints black.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.ink })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const TEXT = 'Courier Prime';
const IN = 25.4; // mm in an inch: the format is specified in inches
const LEAD = 12; // pt: 12-point Courier at six lines to the inch, so one line is one grid line
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
// #region page: US Letter, a 1.5-inch binding margin, Courier 12 on 12, ragged right
const MARGIN = { top: 1, bottom: 1, left: 1.5, right: 1 }; // inches: the left one takes the brads
const page = { sizePreset: 'custom', width: mm(8.5 * IN), height: mm(11 * IN), dpi: 150,
margins: { top: mm(MARGIN.top * IN), bottom: mm(MARGIN.bottom * IN),
left: mm(MARGIN.left * IN), right: mm(MARGIN.right * IN) } };
const bodyText = { fontFamily: TEXT, fontSize: pt(12), lineHeight: pt(LEAD), color: col('ink'),
textAlign: 'left', firstLineIndent: pt(0), // action: flush left, never justified
paragraphSpacing: true }; // a blank line between paragraphs
// #endregion
// #region answer: a speech is a callout with no frame, padded to the 3.5-inch dialogue block
// Positions from the left edge of the sheet, in inches, as screenwriting software gives them.
const DIALOGUE = { left: 2.5, right: 6 }; // the block of speech, 3.5 inches wide
const CUE = 3.7; // the character's name
const TEXT_RIGHT = 8.5 - MARGIN.right; // 7.5: where action lines end
const dialogue = {
id: 'dialogue',
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
#Devuelve las réplicas a la rejilla
Cada réplica conserva entonces su margen inferior y la siguiente le suma el superior, lo que deja dos líneas en blanco entre réplicas (tres antes de un encabezado de escena) y lleva el guion a una cuarta página.
- snapToGrid: false,
};#Escribe los encabezados de escena sin negrita
A máquina, los encabezados de escena se escribían solo en mayúsculas; la negrita llegó con los programas de guion.
- fontSize: pt(12), fontWeight: 700, lineHeight: 1, color: col('ink'), align: 'left',
+ fontSize: pt(12), fontWeight: 400, lineHeight: 1, color: col('ink'), align: 'left',- fontWeight: 700, lineHeight: 1, color: col('ink'), align: 'left', overflow: 'wrap',
+ fontWeight: 400, lineHeight: 1, color: col('ink'), align: 'left', overflow: 'wrap',Errores frecuentes
- Postext no imprime
(MÁS)bajo una réplica que se parte entre dos páginas ni repite el nombre sobre el resto. DejakeepTogethercon su valor por defecto para que cada réplica pase entera a la página siguiente. - Los programas de guion añaden
(CONT.)al nombre automáticamente. Aquí va en eltitlede la línea de apertura, así que escríbelo tú donde un personaje sigue hablando después de una acción. titleStyle.lineHeightmantiene la réplica en la rejilla solo mientras sea igual al interlineado del texto. Un nombre en un cuerpo mayor o menor sigue necesitando esos 12 pt; si no, cada réplica saca de la rejilla las líneas que la siguen.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fuentes
- Courier Prime (SIL OFL 1.1) · Special Elite (Apache 2.0) · Oswald (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)


