SaTML Website

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

Getting Started

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

Running the Development Server

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.

Structure

• 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)

Special markdown constructs

• - [ ] 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).

Adding a New Edition

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.).

Misc

• 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.