Shows

The show records are stored as _shows/YY_YY/show_name.md with YY_YY being the academic year ‘span’. The synopsis is the content of the page, i.e. goes after the attribute section.

Attribute Reference

Attribute Job Description
title
string
Show title

Displayed at the top of the show page and on various other pages. Should be the title of this performance, may not quite match the title of the play – see canonical.

playwright
string
Full name of the playwright

Omit if using devised, set to various if compilation.

playwright_false
boolean
Exclude student playwright from crew list

Only used when student_written: true. Excludes the student adaptor, translator, or playwright from the crew list.

playwright_alias
string
Student name of the playwright

Student playwrights occasionally use aliases to write under. Use their student name here to ensure attribution is given in the crew list.

devised
Used if play was devised

Either true for generic output or a descriptor. Example descriptor: Cast and Crew will output “Devised by Cast and Crew”. Omit if using playwright.

improvised
Used if a play was (fully) improvised.

Omit if false. Primarily used for fully improvised shows, rather than scripted shows with improvised elements.

adaptor
string
Full name of adaptor

Outputs as “Adapted by adaptor”.

translator
string
Full name of the translator

Outputs as “Translated by translator”.

playwright_type
string
Playwright type

Either playwright, devised, improvised, various, or unknown.

playwright_formatted
string
Short form formatted playwright string

Excludes adaptor and other additional details.

playwright_formatted_long
string
Long form formatted playwright string

Includes adaptor and othe additional details.

canonical
List of canonical titles and playwrights for reverse lookup.

Specify titles and/or playwrights in a list. See #486.

student_written
boolean
Show written by a NNT member

Set to true; false or line missing are equivalent. In order of precedence, the adaptor, translator, or playwright are then given a role in the crew list. Suppress this behaviour with playwright_false

company
string
Non-NNT only, the name of the company
company_sort
string
Primary name for the company.

Group together companies where the company name has changed over time. Use the name at the time of the show. See #1614

period
string
Choices: `Autumn`, `Spring` or `Edinburgh`. Omit if unknown.
season
string
Season show belongs to

Choices: In House, Fringe, External, StuFF, Edinburgh, Lakeside, Fundraiser, IUDF, Unscripted, Online.

season_path
string
Absolute path to season page

Path instead of document as show pages data is generated before season documents exist.

season_sort
number
Order which this show comes in the entire year

Use multiples of 10 for ease of additions. Roughly: Autumn should start at 30, Spring 200 and Edinburgh 400. Shows then fall at 30, 40, 50 &c

ignore_missing
boolean
Suppresses missing detail warnings

Is true when season matches External, Postgrads or STUFF (as per list in _config.yml).

year
string
Year identifier

YY_YY

year_page
document
Year page
seq_index
number
Index of set of all shows

Zero is youngest show.

seq_next
document
Show page next in sequence

seq_index + 1

seq_previous
document
Show page previous in sequence

seq_index - 1

redirect_from
array
Array of URLs to redirect to this record

Used to migrate from old URL scheme to new; jekyll-redirect-from generates the redirects (pages with meta redirect tags).

venue
string
Venue show was performed in.

Used to match all shows performed in venue, ensure text matches.

venue_sort
string
Group of venues venue belongs to.

Will group show together with other shows with the same sort. For example C cubed, C nova, C soco, C too can all be grouped as C venues.

venue_path
string
Absolute path to venue page

Path instead of document as show pages data is generated before venue documents exist.

date_start
date
Date of first performance

In the format YYYY-MM-DD.

date_end
date
Date of last performance

In the format YYYY-MM-DD, omit if show only ran one day.

tour
array
List of tours the show has been on (NSDF &c).

Specify venue, date_start, date_end and notes. See #12. Shows taken to Edinburgh should have a separate show created under the Edinburgh period.

excerpt
string

Generated excerpt of synopsis for use in search results and other summaries.

trivia
array
List of trivia hashes.

List of trivia / anecdotes / short stories about the show. See trivia list.

cast
array
Cast members

Uses the person list format.

cast_incomplete
boolean
Incomplete Cast

Enforces the ‘Missing Details’ box to appear regardless of cast size.

cast_note
string

Replaces the text in the default ‘Missing Details’ box with a custom string (does not replace the call to action). Only appears when cast_incomplete is set to true, as there is no minimum cast size.

crew
array
Crew members

Uses the person list format. Note: You do not need to include the playwright as a member of the crew as this is handled automatically.

crew_incomplete
boolean
Incomplete Crew

Enforces the ‘Missing Details’ box to appear regardless of crew size (automatically appears when there are fewer than 5 crew). Suppress automatic behaviour by setting false.

crew_note
string

Replaces the text in the default ‘Missing Details’ box with a custom string (does not replace the call to action).

prod_shots
string
SmugMug album ID for production shots

Use util/smug-albums to find the AlbumID. Fetch is limited to the first 350 items.

smugmug_album
hash
SmugAlbum object for prod_shots
assets
array
Publicity and other materials

Uses the photos and assets format.

poster
hash
Selected asset to use as show poster

Currently identical to display_image.

display_image
hash
Selected asset to use as show display image

Used to represent show in search results, people records &c. Order of precedence: override assets, posters, flyers, programmes.

comment
string
Reserved for editor comments

Displayed in editors’ mode.

Example Show

---
title: The Pillowman
playwright: Martin McDonagh
season: In House
season_sort: 70
period: Autumn
venue: New Theatre
date_start: 2012-12-12
date_end: 2012-12-15

canonical:
- title: The Pillowman
  playwright: Martin McDonagh

cast:
  - role: Katurian
    name: Sam Haywood
  - role: Ariel
    name: Will Randall
crew:
  - role: Director
    name: James McAndrew
  - role: Producer
    name: Nick Stevenson

prod_shots: abcd123

assets:
  - type: poster
    image: XJZCPfW
  - type: flyer
    image: XKsW92t
  - type: programme
    filename: the_pillowman_programme.pdf
    title: Programme

tour:
  - venue: The National
    date_start: 2013-01-01
    date_end: 2013-01-03
    notes: Show won award
---

In an unnamed police state, a writer has been arrested because the content of his stories bares a striking resemblance to a series of gruesome child murders. Interrogated by two brutal detectives, he claims to know nothing of such murders. But also in their custody is his younger, brain damaged brother, who perhaps knows more than he first lets on. A darkly comic thriller like no other.