Skip to content

qwandor/dancelist-data

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dancelist data

This repository contains the data behind https://folkdance.page/ and https://balfolk.org/, lists of social folk dance events. Additions and corrections are welcome, subject to the listing policy below.

Code for the website itself is in a separate repository.

Listing policy

This list is for social folk dance events which are open to the public. This includes both regular social dances, special one-off dances and multi-day events such as festivals.

In scope Out of scope
Social folk dances, such as balfolk, contra and ceilidh Performance dances, such as Morris
Other styles of social dance, such as Lindy Hop, forró or tango
Folk dance festivals Folk music festivals without a substantial social dance component
Regular or one-off social dance events with live music Concerts
Events open to the public Private parties or clubs
In-person events Online events

Format

Event data is in YAML format under events, with generally one file per location or organisation. Each file may contain one or more events.

Required fields

An event must have at least a name, a start and end date (they may be the same) or datetime, a country, a city, at least one style, and at least one of workshop or social must be true. Times should be in the local timezone of wherever the event is taking place, with a timezone offset included. The first line of the file should be a modeline referring to the JSON schema). For example:

# yaml-language-server: $schema=../../events_schema.json
events:
  - name: Clandestine Mazurka in Northampton Square
    start: "2022-05-13T13:00:00+01:00"
    end: "2022-05-13T15:30:00+01:00"
    country: UK
    city: London
    styles: [balfolk]
    workshop: false
    social: true

Or with just a date:

# yaml-language-server: $schema=../../events_schema.json
events:
  - name: Clandestine Mazurka in Northampton Square
    start_date: 2022-02-13
    end_date: 2022-02-13
    country: UK
    city: London
    styles: [balfolk]
    workshop: false
    social: true

Dance styles

The styles field should contain one or more of the following values:

Value Meaning
balfolk Balfolk, a group of French and other European dances
contra American contra dancing
e-ceilidh English ceilidh
ecd Playford and other English Country Dances
ceili Irish céilí
irish-set Irish set dancing
italian Italian dances, such as pizzica and tarantella
polish Polish folk dances, such as oberek and kujawiak
reeling Scottish reeling
s-ceilidh Scottish cèilidh
scd Scottish country dance
scandi Swedish, Danish and Norwegian dances, such as Polska, Schottis, Sønderhoning and Pols

Optional fields

Field name Usage
details A longer description of the event, one sentence.
links One or more URLs with more information of the event. This should ideally include both a Facebook event page and a non-Facebook page.
bands A list of bands playing at the event.
callers A list of callers calling at the event, for called dances such as contra and ceilidh
price The price (or range of prices) of the event, including currency. e.g. "£5-15" or "free".
organisation The organisation who is running the event.

For example:

# yaml-language-server: $schema=../../events_schema.json
events:
  - name: Bristol Contra Dance
    details: All welcome of any level of experience for great dancing to amazing gender-free calling and brilliant music.
    links:
      - "https://bristolcontra.wordpress.com/"
      - "https://www.facebook.com/events/690727345267580/"
    start_date: 2022-02-18
    end_date: 2022-02-18
    country: UK
    city: Bristol
    styles: [contra]
    workshop: false
    social: true
    bands:
      - Bearded Dragons
    callers:
      - Charlotte Rich-Griffin
    price: £6-£15
    organisation: Bristol Contra