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.