okfn / opendataday

Open Data Day website
http://opendataday.org
Creative Commons Zero v1.0 Universal
89 stars 112 forks source link
event events hackathon open-data open-data-day opendata opendataday translation

opendataday

Build & Deploy to GH Pages

Open Data Day is a gathering of citizens in cities around the world to write applications, liberate data, create visualizations and publish analyses using open public data to show support for and encourage the adoption of open data policies by the world's local, regional and national governments.

You're invited. Again. The next Open Data Day will take place on Saturday 5 March 2022.

Check http://opendataday.org for public website.

Editing / contributing

Translations

To translate the site we need to duplicate the contents.lr file, and save with the language code in the file name, like contents+de.lr.

We also need to add translations to:

If we are adding new language to the site we also need to:

Running the site locally

Requirements:

Setup:

Updating the Site

Events are populated using a very lightweight import script which:

This is run in a github action with a workflow_dispatch trigger, which allows our content manager to maintain the events in a spreadsheet update the site via a button in github.

screenshot

In general, the import process is designed to be lax about missing fields and unexpected values. Some minimal validation is performed on the fields we require for the site to build correctly. Any errors will fail the action and be displayed in the GitHub actions log. e.g:

marshmallow.exceptions.ValidationError: {'Latitude': ['Not a valid number.'], 'Longitude': ['Not a valid number.']}

These will need to be resolved by editing the input spreadsheet.

There are three bits of setup we need to do each year:

Before we start, we will need a Google Form and a Google Sheet to collect the event data.
This is the 2023 form: https://docs.google.com/forms/d/e/1FAIpQLSc5wiXeUur8GHMKmi1TQIMxwk107eMJVN6UVoibIfUwGZfc7A/viewform
The Google Sheet identificators must be added to the /etl/202x.py file.
This script will attempt to read the data from the Google Sheet so you need to ensure this sheet is public.

For reference, you can check the:

Previous version

The previous version of the site has been moved to the v1 branch.