This project is a web-based slideshow system, built using Jekyll and running on GitHub Pages.
You can access the website at aydenthekinch.git.io. To make changes, you need permission to edit this repository. You can navigate to a file and edit it directly from GitHub browser. After every change, you must "Commit changes" before they can take effect.
- To add a file, drag and drop it into the file explorer. You can also click "Add file" and upload it from your computer.
- To delete a file, select it and click the three dots in the upper right corner. Then click delete file.
GitHub Pages can only publish repositories that are smaller than 1GB. Most 1920x1080 images are 0.5 to 1 MB while GIFs and videos are substantially larger.
This repository should not be your primary storage for media files. You can always delete older slideshows to make space.
To edit the slide interval or folders accessed by a specific slideshow, navigate to the _data folder and open the settings.yml file. Here you will see a collection of all the active slideshows.
Here you can see multiple settings, Name, Update, Folders, and URL. Each will be explained in more detail below.
This is what is displayed in the header of the landing page.
This is the number of seconds a slide is displayed before moving to the next slide.
This is the name of the "slideshows" folder that contains the images to be displayed. You can list multiple folders and the view will cycle through all the photos in each of them.
This is the path from the root to the file associated with each view. You shouldn't have to change this unless you're changing the structure of the site.
In order to add slides to a slide show, you can:
- add images to an existing folder
- make a new folder and put it in 'slideshows'.
If you make a new image folder in slideshows, be sure to add it's name to the view's folder setting in settings.yml.
It's recommended to use images with a resolution of at least 1920x1080 and an aspect ratio around 16:9 to preserve the best quality when displayed on the TV's set up in the UBC Dairy Farm.
The TV's browser can render .png, .webp, .gif, .apng, .pdf, .ico, and .bmp files.
Slides are automatically organized alphanumerically in the slideshow folders. If you want to change the ordering, you should add 1a, 1b, 1c... 2a, 2b ... etc. to the front of each file name. If a view is given multiple folders to pull from, it will show all slides in the first folder first and then show all the slides in the second folder before looping.
To add a new view (and a new slideshow), you need to create a new key in settings.yml and a new page. The new key should have all the settings listed above. The new page only needs to have YAML front matter that includes
- layout: slideshow_image
- screen: (name of the new key in setting.yml)