Welcome! This is the source for the SaTML conference website, built with Pelican (a static site generator) and Bulma (a CSS framework).

To set things up locally, create a virtual environment and install the required dependencies:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

To preview the site locally with automatic reloading, run:

make devserver

Once it's running, head over to http://localhost:8000 to preview the site.

• pelicanconf.py: Main configuration file
• data/: Structured data (e.g., organizing committee)
• content/: The core site content
• theme/templates/: The template files
• plugins/: plugins extending the markdown (see below)

• - [ ] item renders as a checkbox list (plugins/checklist.py).
• [[2026-09-29]] renders as a formatted date ("Tue, Sep 29, 2026") and a list wrapped between ::: dates and ::: lines becomes a deadline list that dims past deadlines and highlights the next upcoming one with a countdown (plugins/dates.py). The brackets say what kind of date it is: [[..]] author deadline (hour-precise countdown), ((..)) conference-side date such as a notification (day granularity), {{..}} date without a countdown.
• A ::: edition block with key: value lines (year, image, venue, location, date, url) renders as a clickable past-edition card (plugins/editions.py).
• A ::: card block renders a generic content card (plugins/cards.py). Consecutive cards share a responsive two-column grid and stack on narrow screens.

Each edition of the conference is organized in an (ideally) self-contained repository under the IEEE SaTML GitHub organization. The domain satml.org is linked to this organization, which allows to serve any of its repositories via GitHub Pages under https://satml.org/.

The current edition is served directly under https://satml.org, which is tied to the special repository ieee-satml.github.io.

To add a new edition:

1. Archive the current site:

   • Duplicate the content of the main repository ieee-satml.github.io into a new repository named after the year (e.g., 2026).
   • This repository should be deployed at https://satml.org/2026.
   • In pelicanconf.py, update the SITEURL to reflect this new location.
   • Fix any internal links that may broke due to the move.

2. Create the new main site in ieee-satml.github.io:

   • This repository will serve the new edition directly under https://satml.org.
   • It should be completely independent of the previous one.
   • Include links pointing to past editions (e.g., 2023, 2024, etc.).

• The files gitlab-ci.yml and pelicandevconf.py are used for the development server at TU Berlin. They are not required for deployment on GitHub and may be removed in a future cleanup.
• The deployment workflow for GitHub Pages is defined in .github/workflows/deploy.yml.