Contribute to the site

Add a new league or seasons of existing leagues

I don't want to waste time writing detailed instructions if no one is interested. Let me know if you want to contribute to the site and the instructions below aren't clear enough.

Getting started

The website is served from GitLab and all the historical content is hosted there. For every season, there is a directory with a JavaScript file for each league. As an example, take a look at the directory for the 2017/18 season. If you want to understand how this data is used please feel free to take a look around the repository, but note that it's not necessary to know how it works if you just want to add content.

Contribute an individual season

The easiest way to make a useful contribution is to send me the data of a single season in the right format. Please note that for now I'd like to focus on first tier leagues.

The format to follow is not complicated. This file shows the data for the 2017/18 Bundesliga. You'll need to replace the data of that file with the data of the season you're adding.

The first is the variable name, or var. It's the country code, specifically the ISO 3166-1 alpha-2 code. For Germany that's de. You can check which code to use on Wikipedia.

The second thing to do is adding the season's metadata: the competition name, the source of the data (please use Wikipedia), the number of teams in the league, and the European qualification and relegation places. For these, simply add the rankings for the teams that qualified to the Champions League places, Europa League, and which relegated. Important to note is that this should be the teams that actually qualified. The Europa League spots for the 2017/18 Bundesliga season are listed as 5, 6 and 8. Frankfurt finished 8th, but qualified for the Europa League group stage by winning the cup.

Lastly, and most importantly, add the league table data. How I've done it so far is by putting the league table in a spreadsheet and then using CSV to JSON to convert it to the right format. You can use this example spreadsheet to get the proper format. Just copy-paste the table and hit convert. Then copy-paste the result in the appropriate place.

When this is all done. Please save the file using the country code and the js extension and email me the file. I'll put it up on the site ASAP. If you're familiar with git and GitLab, please feel free to make a pull request, but I can't imagine this is time-effective for a single season.

Contribute multiple seasons

Please send me an email if you want to contribute a significant amount of data. I can then properly explain everything that is required to add them to the site. I only want to write these instructions if someone needs them.