Juggling Festival Service Information

Aim of the service.

How it's updated.

When it's updated.

Where I get the information from.

How the information is structured.

History. How this service has evolved.

Aim of the service

How it's updated

When it's updated

Where I get the information from

How the information is structured

The information is contained in the festivals/ directory of the Juggling Information Service. Information on each convention is held in its own file. To access these files in a sensible way (well I think it is; if you don't agree, please suggest a more user-friendly alternative), I've set things up so you access them in a variety of ways, such as by geographical region. To do this easily, the information is held as follows:

index.html

This file is the top level entry point for the festival information. It is generated automatically each day, and contains links to festivals coming soon, and links to the upcoming lists for each of the several regions.

upcoming/

This directory contains an index.html file containing a chronological list of all upcoming festivals. It also contains a set of region.html files, containing links to the upcoming festivals in that region. A region is in some cases one country and in others it covers multiple countries - this is determined by the number of festivals in a given country. All of these indexes are generated automatically each day.

past/

This directory is organized like the upcoming/ directory, but contains information on festivals that have past. It contains a index.html file containing a reverse chronological list of all past festivals. It also contains a set of region.html files, containing links to the past festivals in that region. These indexes are also generated automatically each day.

fest/

This directory contains the files with the details of each festival. There is usually one file per festival, but additional files containing logos, maps, photos, or more information is possible. Each primary festival file is named as yymmdd-cc-what.html, where:

yymmdd

the year, month, and day when the festival ends

cc

a country code for where the festival occurs

what

a code representing what the festival is called

This naming convention makes maintenance of the information fairly simple, and allows the daily automatic generation of all of the indexes to be fast and simple.

Etc/

This directory contains the scripts that run daily to automatically generate the indexes, plus a few configuration files that provide additional information needed by the scripts. These files require minimal maintenance.

Regions

A list of regions, containing a code name and full name for each, plus the list of country codes contained in each region.

Countries

A list mapping country codes to the full names for each country.

What

A list mapping the what portion of a festival file name to the full festival name. This is only needed for some old festival files that do not contain this information within the file in the currently standard manner.

update

This is the executable script that runs daily to generate all of the indexes. It uses several other scripts that are also kept within this directory.

../Icon/, Icon/

These directories contain the icons displayed with the various index files.

Misc/history.html

The history of how this service evolved.

Misc/index.html

This file.