Screenplay

MediaWiki extensions manual

File:OOjs UI icon advanced.svg Screenplay Release status: beta
Implementation	Tag
Description	Adds a <screenplay/> tag for screenplay formatting
Author(s)	User page Miscellaneous Sandbox Subpages Screenplay I registered on <www.semantic-mediawiki.org>. Property "Has user description" (as page type) with input value "I registered on ." contains invalid characters or is incomplete and therefore can cause unexpected results during a query or annotation process., User page Miscellaneous Sandbox Subpages Screenplay I registered on <www.semantic-mediawiki.org>. Property "Has user description" (as page type) with input value "I registered on ." contains invalid characters or is incomplete and therefore can cause unexpected results during a query or annotation process.
Latest version	0.6
MediaWiki	>= 1.39.0
License	MIT License
Download	<translate> Download extension</translate> <translate> Git</translate> [?]: <translate> Download Git master</translate> <translate> browse repository</translate> (GitHub) <translate> commit history</translate> <translate> repository contributors (GitHub)</translate> <translate> code review</translate>
Example	http://wiki.zaori.org/wiki/Holes/Session_48
Parameters $wgScreenplayTokens
Hooks used ParserFirstCallInit
Quarterly downloads
Public wikis using
Translate the Screenplay extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

The Screenplay extension adds a parser for formatting wikitext within <screenplay/> tags into screenplay layout.

Installation

• <translate> [[<tvar name=2>Special:ExtensionDistributor/Screenplay</tvar>|Download]] and move the extracted <tvar name=name>Screenplay</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
  <translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Screenplay
• <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate>

  wfLoadExtension( 'Screenplay' );
  

• File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>

Usage

Mostly fountain-like syntax, mostly due to coincidence. Parsing is done based on line layout and position.

All items are separated by a double linebreak.

• Scene headings: Single lines, begin with INT or EXT. Automatically format to display full line as all caps.

• Dialogue block: Has at least two lines - an all-caps speaker, followed by some dialogue text. Single linebreaks may be used between component parts, or within the dialogue itself.
  • Speaker: All caps. Start of block.
  • Parenthetical: Wrapped in parentheses, can appear anywhere after the speaker. Must have its own line.
  • Dialogue: Anything else after the speaker.

• Slugs: Anything else (probably). Just display as full-width regular lines (within the context of the overall screenplay formatting).

Example

<screenplay>
INT. Some place - night

Some flavour text to set the scene and all that jazz. Yeah.

SOME GUY
I'm talking, what.

HORSE
(doing stuff)
Yeah, yeah, apparently I'm a talking horse doing stuff too. That's great, man. Just bloody great. Sod off.

One of them does something else or stuff. Or both. Maybe the scene even does something.

HORSE
Yeah, it's real fascinating.
</screenplay>

Limitations

• Ideally the scene headers would be added to the table of contents, but mw core's handling of the table of contents sucks, so doing this would basically involve reimplementing the entire thing, or something. So we haven't bothered.
  • For similar reasons, normal MediaWiki headers within the <screenplay> tags are also not added to the table of contents, though they do format normally.
• Some stuff that should exist is just plain missing. File a bug!