5 releases (3 breaking)

0.4.1 Oct 8, 2019
0.4.0 Aug 4, 2019
0.3.0 Aug 4, 2019
0.2.0 Jul 24, 2019
0.1.0 Jul 23, 2019

#1490 in Text processing

MIT license

24KB
110 lines

scripter

Build Status Coverage Status

A screenplay compiler.

What does this do?

There's a nice screenplay LaTeX package but using it is not particularly convenient, as the code gets quite verbose.

Instead let's use an ad-hoc minimal script language and transpile to TeX.

The rules of the language

  • Whitespace at beginning and end of lines are ignored
  • Lines with only whitespace in them are ignored
  • The first line is the title
  • The second line is the author(s)
  • Empty lines are ignored
  • Lines beginning with INT. or EXT. are treated as sluglines, what comes after INT. and EXT. is free-form
  • Lines beginning with whitespace are assumed to contain dialogue. That requires them to contain at least one : character. The part before the first colon is is the character that's speaking, the second is what's being said. Parts in parentheses are treated as parentheticals. Colon characters other than the first are treated as plain text.
  • Other lines are treated as description

Example

Input:

The Alienant, version 1
Firstname Lastname

INT. SPACE STATION

Dark corridor. Something lurks in the shadows.

EXT. MILITARY BASE -- DAY

COLONEL SMITH smokes a cigarette. There are items on his desk: a bottle of whisky, a gun and a doll. SMITH looks up as CAPTAIN PARKER approaches.

CAPTAIN PARKER doesn't look too well.

	SMITH: So, it's begun.
	PARKER: Yes. (inhales) Yes, it has.
	SMITH: I was afraid it'd come to this. Look: how about we –
	PARKER: No.
	SMITH: But & % $ # _ { } ~ ^ \
	PARKER: Hold on, what?

TeX output:

\documentclass{screenplay}
\usepackage[T1]{fontenc}
\usepackage[polish]{babel}
\usepackage[utf8]{inputenc}
\title{The Alienant, version 1}
\author{Firstname Lastname}
\begin{document}
\coverpage
\fadein
\intslug{SPACE STATION}

Dark corridor. Something lurks in the shadows.

\extslug{MILITARY BASE -- DAY}

COLONEL SMITH smokes a cigarette. There are items on his desk: a bottle of whisky, a gun and a doll. SMITH looks up as CAPTAIN PARKER approaches.

CAPTAIN PARKER doesn't look too well.

\begin{dialogue}{SMITH}So, it's begun.\end{dialogue}

\begin{dialogue}{PARKER}Yes. \paren{inhales} Yes, it has.\end{dialogue}

\begin{dialogue}{SMITH}I was afraid it'd come to this. Look: how about we –\end{dialogue}

\begin{dialogue}{PARKER}No.\end{dialogue}

\begin{dialogue}{SMITH}But \& \% \$ \# \_ \{ \} \textasciitilde{} \textasciicircum{} \textbackslash{}\end{dialogue}

\begin{dialogue}{PARKER}Hold on, what?\end{dialogue}

\fadeout
\theend
\end{document}

Output PDF

No runtime deps