paceboard is a template-based static site generator for speedrun leaderboards.
You can configure site details, implement categories, and add runs all from a single Python script (paceboard.py).
Category and run information is stored in csv files for ease of access and editing.
This guide assumes that you know the basics of hosting your own website. Since paceboard is a static site generator, you can host via the free GitHub Pages, assuming you know how to use Git.
Let's get started!
- Make sure you have the latest version of Python 3.
- Download or fork the paceboard repository.
- Go to your install location via the command line, then run
python3 paceboard.py. Follow the prompts to configure and auto-generate your site! - Discover you made a typo? Hop into the
csvfolder and you can manually edit the spreadsheets inside. Afterwards, runningpython3 scripts/generate.pywill update your site with the new info.
Within the templates folder are the HTML files paceboard uses to format the site. If you're feeling intrepid, you can edit these templates to your liking.
During page generation, paceboard swaps out the tk_ and lk_ strings with their corresponding values in the database.
