Speakers

Keynotes

We edit these into the speakers file manually, since they are the first folks to be added. They differ from other speakers only via a keynote: true boolean.

Speaker data

Speaker data will be present in the spreadsheets provided by the Workshops and Program Committees. It will likely be present on the same worksheets as program talk and workshop information. The main pieces of information we need are:

• full name
• title
• institution
• bio (can use HTML)

We use the speakers script to convert spreadsheet CSV exports into YAML data for the website. Prior to running the script, edit the CSV's header row so it uses the correct field names: "name", "pronouns", "position-title", "institution", "bio", "slack", "image_src", and "image_alt". Note: we do not use slack handle on the site.

Run the script with bundle exec _scripts/speakers.rb path/to/speakers.csv. It updates the speakers.yml file in place, adding missing speakers.

Speaker Images

Speaker images are also provided by the conference and workshop committees alongside alt text for those images. Sometimes we receive a Google Drive folder of images and a spreadsheet. In that case, download the images, manually rename them using the speaker's id, run the script, then edit the image_src to match the filenames.

More recently, we have received a spreadsheet with image URLs in one of its columns. The speakers script attempts to download these images. It will print if it is unable to download an image. Note that some URLs successfully download but are not images (e.g. if someone submits "https://my.resume.site" without a specific image URL); these need to be manually spotted and fixed.

Optimization

For extra credit, optimize images so they look nice and website loads quicker.

• Crop the image to be square (1x1 aspect ratio)
• Reduce the size of the image, aiming for dimensions less than 800px squared
• Run through a file size optimizer like ImageOptim

Testing

To test the speakers script, remove the existing speaker file and run bundle exec _scripts/speakers.rb _scripts/examples/speakers.csv. This should add four new speakers, fail to download one image, and successfully download one image.

Remember to reset the github repo after testing.

Notes

We used fromSheetsToJekyll for speaker data in the past, see past years for full instructions.