assets | ||
categories | ||
css | ||
csv | ||
runs | ||
scripts | ||
templates | ||
LICENSE | ||
paceboard.py | ||
README.md |
paceboard
About
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.
Instructions
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
csv
folder and you can manually edit the spreadsheets inside. Afterwards, runningpython3 scripts/generate.py
will update your site with the new info.
Template-based?
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.