En poques paraules
El guió d'un curtmetratge amb el format que fan servir els estudis de cinema. Porta una lletra de màquina d'escriure, i els diàlegs i els números d'escena van a distàncies fixes de la vora.
Què compondràs
La versió de rodatge d'Objetos perdidos, un curtmetratge inventat de tres pàgines, enquadernada com els guions dels estudis: coberta de cartolina mostassa amb dos enquadernadors de llautó i etiqueta mecanografiada, l'interior segellat amb COPIA 07 i, al darrere, el guió en Courier Prime de 12 sobre 12 en paper carta foradat. Les mesures són les dels programes de guió: acció d'1,5 a 7,5 polzades; rèplica de 2,5 a 6, sota el nom del personatge a 3,7; acotació des de 3,1, i CORTE A: i FUNDIDO A NEGRO. fins al marge dret. Cada escena porta el seu número als dos marges. La pàgina 1 del guió no porta número; les altres, a dalt a la dreta i amb punt. Cada rèplica és un requadre sense marc, amb el nom del personatge al mateix interlineat de 12 pt que el text, i així acció i diàleg mantenen sis línies per polzada.
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?
La resposta curta
// 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,
};
Ingredients
- Funcions
- RequadresSortir de la retícula a propòsitEstils de paràgrafTítols numeratsEstils de títolObertures dissenyadesAtributs de títolCobertes, portades i colofonsCapçaleres segons el tipus de pàginaCapçaleres i folisCapçaleres per seccióTextos, filets i caixes als dissenys de pàginaFormat de pàginaUnitats i mesuresTipografia del textSagnats, alineació i separació de paràgrafsEquilibri de columnesPaleta de color semànticaPàgines en un canvas
- També fa servir
- Preliminars en romans
- Tipografia
- Courier Prime, Oswald (SIL OFL 1.1) · Special Elite (Apache 2.0)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Ajusta un requadre sense marc al bloc de diàleg
El codi és a la resposta curta, més amunt. El farciment d'un requadre es mesura des de la caixa de text, així que 1 polzada a l'esquerra i 1,5 a la dreta deixen el bloc de 3,5 polzades que comença a 2,5 de la vora del full (estils de requadre). El nom del personatge és el títol del requadre i s'escriu a la línia d'obertura: title="Dora (cont.)". textTransform el passa a majúscules, i indent el porta 1,2 polzades més enllà del farciment, fins a 3,7. gap val 0 perquè, per defecte, entre el nom i la rèplica queda mig quadratí, 6 pt. Per defecte el títol d'un requadre es compon en una línia d'1,2 vegades el seu cos, 14,4 pt aquí. titleStyle.lineHeight el posa als 12 pt del text, de manera que el nom cau en una línia de la retícula i la rèplica ocupa un nombre enter de línies de 12 pt; amb el valor per defecte, cada rèplica allunyaria 2,4 pt més de la retícula el text que la segueix. Amb snapToGrid desactivat, el marge inferior d'una rèplica i el superior de la següent es fonen en una sola línia en blanc. Un requadre es manté sencer per defecte, de manera que una rèplica que ja no hi cap passa a la pàgina següent amb el seu nom.
#2 · Mesura la pàgina en polzades
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
Mida carta, amb el marge esquerre d'1,5 polzades per on passen els enquadernadors i una polzada als altres tres costats. Courier Prime és una lletra monoespaiada: a 12 pt cada caràcter fa una dècima de polzada, així que una línia d'acció admet 60 caràcters i una de diàleg 35, i amb un interlineat de 12 pt hi caben 54 línies a la pàgina. El text va en bandera, alineat a l'esquerra, i paragraphSpacing deixa una línia en blanc entre paràgrafs. El text en bandera només porta partició de mots si la demana bodyText.hyphenation.ragged, així que cap paraula no es talla, com demana el format.
#3 · Fes de les acotacions i les transicions estils de paràgraf
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 contenidor :::paragraphs{style="paren"} dins d'una rèplica sagna la primera línia 0,6 polzades des de la vora del diàleg, fins a 3,1 (estils de paràgraf). Escriu cada acotació en una sola línia, perquè l'estil només sagna la primera. A l'estil del diàleg, body.paragraphSpacing: false deixa fora del requadre la línia en blanc que separa els paràgrafs d'acció, i (luego) queda just a sota de la línia anterior. CORTE A: i FUNDIDO A NEGRO. van en contenidors transition, amb un textAlign: 'right' que els alinea amb el final de les línies d'acció. Un contenidor torna el text a la retícula de base després del seu últim paràgraf; aquest guió no en surt mai, així que l'encapçalament que segueix CORTE A: conserva les seves dues línies en blanc.
#4 · Penja els números d'escena als dos marges
// 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}' compta els títols de nivell 2, i {number} imprimeix aquest compte al disseny (configuració per nivell). Un títol amb disseny avançat conserva el seu lloc a la columna i dibuixa els seus elements en lloc del seu text (extensió i disseny avançat), i així els dos números es poden quedar als marges, al costat de l'encapçalament en negreta. Cadascun s'ancora a la caixa del mateix títol i en surt: 0,6 polzades a l'esquerra i, a la dreta, un quart de polzada més enllà del final del text, en una caixa de mitja polzada amb el text alineat a l'esquerra, perquè en un guió de més de nou escenes els números d'una i de dues xifres comencin al mateix lloc. El text propi del títol no es pinta, però es mesura, i per això el nivell va a 12 pt: amb els 15 pt per defecte, l'encapçalament de l'escena 1 passaria a dues línies i reservaria la segona. L'equilibratge de columnes està desactivat: afegiria línies en blanc sobre els encapçalaments d'escena per omplir una pàgina curta, i una pàgina de guió acaba on acaba l'última rèplica o l'últim paràgraf.
#5 · Forada i numera només les pàgines del guió
// 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) };
L'estil del títol del guió porta la seva pròpia capçalera (header), que substitueix la del document a les pàgines de la seva secció, del títol al final (estils d'encapçalament). La capçalera del document és buida, així que els forats i el número de pàgina només surten al guió. El número s'ancora a mitja polzada de la vora superior del full, i pages: 'body' el deixa fora de les pàgines d'obertura (elements de text). El títol del guió és de nivell 1 i obre pàgina, així que la pàgina 1 compta com a pàgina d'obertura i no porta número, com demana el format. Les cobertes també són títols de nivell 1; :::numbering{startAt=1}, entre l'interior de la coberta i el títol, dona el número 1 a la pàgina del títol, i la següent porta el 2. L'estil del títol fixa una línia de 12 pt; amb els 18 pt propis del nivell 1, el títol aniria en una línia de 21,6 pt i baixaria FUNDIDO DE ENTRADA: 9,6 pt.
La recepta 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',
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
#Torna les rèpliques a la retícula
Cada rèplica conserva llavors el seu marge inferior i la següent hi suma el superior, cosa que deixa dues línies en blanc entre rèpliques (tres abans d'un encapçalament d'escena) i porta el guió a una quarta pàgina.
- snapToGrid: false,
};#Escriu els encapçalaments d'escena sense negreta
A màquina, els encapçalaments d'escena s'escrivien només en majúscules; la negreta va arribar amb els programes de guió.
- 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',Errors freqüents
- Postext no imprimeix
(MÁS)sota una rèplica que es parteix entre dues pàgines ni repeteix el nom sobre la resta. DeixakeepTogetheramb el seu valor per defecte perquè cada rèplica passi sencera a la pàgina següent. - Els programes de guió afegeixen
(CONT.)al nom automàticament. Aquí va altitlede la línia d'obertura, així que escriu-lo tu on un personatge continua parlant després d'una acció. titleStyle.lineHeightmanté la rèplica a la retícula només mentre sigui igual a l'interlineat del text. Un nom en un cos més gran o més petit continua necessitant aquests 12 pt; si no, cada rèplica treu de la retícula les línies que la segueixen.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Fonts
- Courier Prime (SIL OFL 1.1) · Special Elite (Apache 2.0) · Oswald (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)


