jekyll-theme-conference 4.1.0 → 5.0.0

data/UPGRADE_GUIDE.md

@@ -1,14 +1,69 @@
 # Upgrade Guide
 
-This guide covers the essential changes needed to upgrade from v3.x to v4.0. The major update includes **Bootstrap 5 migration** and **configuration restructuring** where many settings moved from `_config.yml` to page Front Matter.
+This guide covers the essential changes needed to upgrade between major versions: [v4 to v5](#upgrade-from-v4-to-v5) and [v3 to v4](#upgrade-from-v3-to-v4).
 
 For detailed documentation, see the [README](README.md).
 
+
+## Upgrade from v4 to v5
+
+v5 adds support for several editions of a conference in one site. Sites with a single edition keep working unchanged.
+
+### Language File
+
+The internationalization file gained the `editions.title` string (`version: 13`).
+
+**Action:**
+- If you keep your own copy of `_data/lang.yml`, replace it with the [current version](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/blob/main/_data/lang.yml).
+
+### New Checks
+
+With `show_errors`, the theme now also reports leftovers of v3: icons that are no [Bootstrap Icons](https://icons.getbootstrap.com/) (e.g. Font Awesome's `file-alt`, which render nothing), `map.enable` and Font Awesome markup in content (e.g. `<i class="fas fa-video"></i>`).
+
+**Action:**
+- Fix the reported leftovers, see [Icons](#icons) and [Map & Location Configuration](#map--location-configuration).
+
+### Room Order
+
+Rooms without `order` are listed as they first appear in the program instead of alphabetically. Rooms with `order` are sorted by it without `sort_by: order` in `_config.yml`.
+
+**Action:**
+- None, unless you relied on the alphabetical order: then set `order`.
+
+### Hidden Location Page
+
+A location page with `hide: true` only redirects to the home page, like hidden talks, speakers and rooms, instead of showing its content.
+
+**Action:**
+- None, unless the page should stay visible: then remove `hide` and its room links show again.
+
+### Editions (optional)
+
+Merge the sites of several editions (e.g. one repository per year) into one site, see [Editions](README.md#editions). Per edition:
+1. Add it to `conference.editions` with its `defaults`.
+2. Move its talks, speakers and rooms to `_talks/<id>/`, `_speakers/<id>/` and `_rooms/<id>/`.
+3. Move `_data/program.yml` to `_data/programs/<id>.yml`.
+4. Move its pages (`index.md`, `program/`, `talks/`, …) and `documents/` to `<id>/`.
+
+Finally add an `index.md` with `layout: editions` and forward the former sites' addresses to `/<id>/`. On Apache, a `.htaccess` with `layout: htaccess` forwards former addresses of the current edition, e.g. `/program/` (see [Editions](README.md#editions)). Sites with a single edition need no change.
+
+When merging, mind that:
+- The site's `baseurl` drops the edition (e.g. `/2026` → `""`). Relative paths in content, such as `../assets/images/logo.svg`, then point into the edition's folder: use `{{ site.baseurl }}/assets/…` instead.
+- `assets/`, `_sass/`, `manifest.json` and `sw.js` are shared by all editions. Markers on an edition's map go into a script named by its location page (`map.script`, see [Location Page](README.md#location-page)).
+- The edition menu replaces self-made menus of previous editions: remove them.
+- Import tools need the edition: set `EDITION` in the `schedule.yml` workflow, pass `--edition <id>` to `import_schedule.py` and the edition's folders to `import_resources.py` (e.g. `--file-folder <id>/documents/slides/ --talk-folder _talks/<id>/`).
+- Keep settings shared by all editions (e.g. `navigation.logo`) in `conference` and add only the differing ones to an edition, see [Editions](README.md#editions).
+
+
+## Upgrade from v3 to v4
+
+The major update includes **Bootstrap 5 migration** and **configuration restructuring** where many settings moved from `_config.yml` to page Front Matter.
+
 > [!CAUTION]
 > This is a major version upgrade. Test thoroughly before deploying to production.
 
 
-## Quick Overview
+### Quick Overview
 
 **Major Changes:**
 - Bootstrap 4 → Bootstrap 5 (CSS classes and JavaScript APIs changed)
@@ -19,17 +74,19 @@ For detailed documentation, see the [README](README.md).
 - Update theme version
 - Move configurations
 - Update Bootstrap syntax in custom code
+- Replace Font Awesome icon names
+- Update custom JavaScript and styles
 
-## Critical Breaking Changes
+### Critical Breaking Changes
 
-### Bootstrap 5 Upgrade
+#### Bootstrap 5 Upgrade
 
 See the official [Bootstrap migration guide](https://getbootstrap.com/docs/5.3/migration/) for any custom CSS/JavaScript in your layout.
 
 **Action:**
 - Review custom CSS/JavaScript for Bootstrap 4 classes and update accordingly.
 
-### Main Landing Page
+#### Main Landing Page
 
 **Change required:**
 ```yaml
@@ -49,7 +106,7 @@ links:
 **Action:**
 - Move `conference.main` from `_config.yml` to page's Front Matter.
 
-### Information Boxes
+#### Information Boxes
 
 **Rename and restructure:**
 ```yaml
@@ -67,7 +124,7 @@ conference:
 - Rename `info_bars` → `info.bars`
 - Change `color: alert` → `color: danger`
 
-### Map & Location Configuration
+#### Map & Location Configuration
 
 **Move to location page:**
 ```yaml
@@ -93,11 +150,13 @@ postal_address:
 - Move `conference.map` and `conference.location` from `_config.yml` to page's Front Matter.
 - If you specify an address, add it via dedicated `postal_address` attributes to page's Front Matter.
 - `CartoDB.*` map providers now require an API key, which the theme cannot pass; `OpenFireMap` was removed. Switch to another `map_provider`.
+- Remove `map.enable`: a location page with `map` shows the map.
+- To hide the location and room links (was: `conference.location.hide: true`), create a location page with `hide: true`, even if your site had none.
 
 > [!WARNING]
 > From version 4 onward, only pages with `layout: location` support embedded maps.
 
-### Program Settings
+#### Program Settings
 
 **Move to program page:**
 ```yaml
@@ -112,7 +171,7 @@ show_alltimes: true
 **Action:**
 - Move `conference.program` settings from `_config.yml` to page's Front Matter.
 
-### Link Preview
+#### Link Preview
 
 **Restructure:**
 ```yaml
@@ -129,7 +188,7 @@ conference:
 **Action:**
 - Move `link_preview` under `meta.link_preview`.
 
-### Timezone
+#### Timezone
 
 The theme now uses Jekyll's `timezone` setting (an IANA name, daylight saving time aware) instead of `conference.tz` (a fixed offset). Without it, times depend on the machine building the site.
 
@@ -141,25 +200,85 @@ timezone: Europe/Zurich  # was: conference.tz: "+01:00"
 **Action:**
 - Replace `conference.tz` (or a top-level `tz`) with `timezone`.
 
-### Icons
-The icon font is no longer loaded: the theme renders the icons it uses as inline SVGs. Icon names in links and tags work as before.
+#### Icons
+[Font Awesome](https://fontawesome.com/) was replaced by [Bootstrap Icons](https://icons.getbootstrap.com/). Unknown icon names show no icon; from v5 on, `show_errors` reports them.
+
+| Font Awesome (v3) | Bootstrap Icons (v4) |
+|-------------------|----------------------|
+| `file-alt`        | `file-earmark-text`  |
+| `video`           | `camera-video-fill`  |
+| `video-slash`     | `camera-video-off-fill` |
+| `train`           | `train-front`        |
+| `bus`             | `bus-front`          |
+| `landmark`, `industry` | `building`      |
+
+The icon font is not loaded either: the theme renders the icons it uses as inline SVGs. If your own content, layouts, or JavaScript use an icon font (e.g. `<i class="bi bi-train-front"></i>`, or `fas fa-train` of v3), add the Bootstrap Icons font to `assets/css/main.scss` (see README, section _Icons_), or use `{% include icon.html name="train-front" %}`. In JavaScript, the include only works in a file with Front Matter, e.g. `assets/js/icons.js`:
+
+```js
+---
+---
+export const TRAIN = '{% include icon.html name="train-front" %}';
+```
+
+**Action:**
+- Replace Font Awesome names in `icon:` of links and tags (`_config.yml`, talks, speakers) and in your own code.
+
+#### Custom JavaScript
+
+The theme's JavaScript is a bundle of its own now, loaded before `assets/js/main.js` (an ES module).
+
+```javascript
+// assets/js/main.js: no Front Matter, no {% include js/conference.js %}
+window.conference.awaitReady().then(async () => {
+    const map = await window.conference.map.getMap();  // was: getMap() without await
+    if (map) {  // was: typeof map !== 'undefined'
+        // ...
+    }
+});
+```
 
-If your own content, layouts, or JavaScript use the icon font (e.g. `<i class="bi bi-train-front"></i>`), add it to `assets/css/main.scss` (see README, section _Icons_), or use `{% include icon.html name="train-front" %}`.
+**Action:**
+- Remove the Front Matter and `{% include js/conference.js %}` from `assets/js/main.js`.
+- Await `getMap()`: it returns a promise, resolving once the visitor loaded the map (or with `null` without map).
+
+#### Custom Styles
+
+Bootstrap variables can no longer be set in `assets/css/main.scss` before importing the theme.
+
+```scss
+// _sass/bootstrap-variables.scss (was: in assets/css/main.scss)
+$green: #4ea93f;
+$primary: $green;
+```
+```scss
+// assets/css/main.scss
+---
+---
+
+@use "conference";  // was: @import "conference";
+
+// Custom styles
+```
+
+**Action:**
+- Set `conference.custom_style: "full"` and move Bootstrap variables to `_sass/bootstrap-variables.scss` (see README, section _Design_).
+- Replace `@import "conference"` with `@use "conference"`, remove `$fa-font-path`.
+- Bootstrap's mixins are no longer in scope unprefixed (e.g. `@include media-breakpoint-only(lg)`): replace them with plain media queries, e.g. `@media (min-width: 992px) and (max-width: 1199.98px)`.
 
-### Removed Settings
+#### Removed Settings
 
 Remove from `_config.yml` if present:
 - `conference.live.demo`
-- `conference.speaker.show_firstname`
+- `conference.speakers.show_firstname`
 - `conference.talks.hide_icons`
 - `conference.talks.hide_link_icons`
 
 > [!WARNING]
 > From version 4 onward, none of these settings are supported anymore.
 
-## Optional New Features
+### Optional New Features
 
-### Progressive Web App (PWA)
+#### Progressive Web App (PWA)
 Enable support to let the user install your conference website as a standalone app:
 ```yaml
 conference:
@@ -169,7 +288,7 @@ conference:
 ```
 Create `manifest.json` and `sw.js` with their respective layouts.
 
-### Information Modals
+#### Information Modals
 Add modal dialogs in addition to info bars:
 ```yaml
 conference:
@@ -179,7 +298,7 @@ conference:
         text: "Modal content"
 ```
 
-### Schema.org Structured Data
+#### Schema.org Structured Data
 Enhanced SEO by adding structured schema.org data:
 ```yaml
 conference:
@@ -191,10 +310,10 @@ conference:
         url: "https://example.com"
 ```
 
-### Dark Mode
+#### Dark Mode
 Automatic support based on system preferences. Optionally add `img_dark` for logos.
 
-### Privacy: Map, Videos & Streams
+#### Privacy: Map, Videos & Streams
 The map, embedded videos (links with `video:` or `iframe: true`) and live streams are only loaded once the visitor clicks a button, as their provider receives the visitor's IP address. To load self-hosted content right away, set `click_to_load: false` in the respective place:
 ```yaml
 # location/index.md (Front Matter)

data/_data/conference_assets.yml

@@ -2,4 +2,4 @@
 css/conference-only.bundle.css: "88f0b98494"
 css/conference.bundle.css: "830ee33744"
 css/map.bundle.css: "b607a13fcd"
-js/conference.bundle.js: "dd39edfd11"
+js/conference.bundle.js: "9a758590c7"

data/_data/lang.yml

@@ -1,4 +1,4 @@
-version: 12
+version: 13
 
 en:
   pronoun:
@@ -62,6 +62,8 @@ en:
   talk:
     overview: Talks
     title: Talk
+  editions:
+    title: Edition
 
 de:
   pronoun:
@@ -125,6 +127,8 @@ de:
   talk:
     overview: Vorträge
     title: Vortrag
+  editions:
+    title: Ausgabe
 
 fr:
   pronoun:
@@ -188,6 +192,8 @@ fr:
   talk:
     overview: Présentations
     title: Présentation
+  editions:
+    title: Édition
 
 pt:
   pronoun:
@@ -251,3 +257,5 @@ pt:
   talk:
     overview: Apresentações
     title: Apresentação
+  editions:
+    title: Edição

data/_includes/checks.html

@@ -1,6 +1,6 @@
 {%- assign errors = '' | split: ',' -%}
 
-{%- if site.data.lang.version != 12 -%}
+{%- if site.data.lang.version != 13 -%}
   {%- assign errors = errors | push: "The internationalization file in `_data/lang.yml` seems to be outdated and does not correspond to the current version of the theme. Grab the current version from the [theme's repository](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/blob/main/_data/lang.yml)." -%}
 {%- endif -%}
 {%- unless site.conference.lang == "en" or site.conference.lang == "de" or site.conference.lang == "fr" or site.conference.lang == "pt" -%}
@@ -9,13 +9,13 @@
 
 {%- assign missing_tracks = "" | split: "," -%}
 {%- assign talks_with_categories = 0 -%}
-{%- for talk in site.talks -%}
+{%- for talk in edition_talks -%}
   {%- comment -%} The track is optional {%- endcomment -%}
   {%- assign missing_track = 0 -%}
   {%- if talk.track -%}
     {%- assign missing_track = 1 -%}
   {%- endif -%}
-  {%- for track_prop in site.conference.talks.tracks -%}
+  {%- for track_prop in edition_tracks -%}
     {%- if talk.track == track_prop.name -%}
       {%- assign missing_track = 0 -%}
       {%- break -%}
@@ -32,10 +32,10 @@
 {%- endfor -%}
 {%- assign main_categories_size = site.conference.talks.main_categories | size -%}
 {%- if main_categories_size > 0 -%}
-  {%- assign errors = errors | push: "Your `_config.yml` file contains an outdated property name. Please rename `conference.talks.main_categories` to `conference.talks.tracks` in your configuration. For more details, refer to the [Talk Settings](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#talk-settings) section in the theme's README." -%}
+  {%- assign errors = errors | push: "Your `_config.yml` file contains an outdated property name. Please rename `conference.talks.main_categories` to `conference.talks.tracks` in your configuration. For more details, refer to the [Tracks & Tags](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#tracks--tags) section in the theme's README." -%}
 {%- endif -%}
 {%- if talks_with_categories > 0 -%}
-  {%- assign errors = errors | push: "The `categories` property in the FrontMatter of some of your talks is deprecated. Please update it by reorganizing the content into `track` and `tags` properties instead. For more details, refer to the [Talk Settings](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#talk-settings) section in the theme's README." -%}
+  {%- assign errors = errors | push: "The `categories` property in the FrontMatter of some of your talks is deprecated. Please update it by reorganizing the content into `track` and `tags` properties instead. For more details, refer to the [Tracks & Tags](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#tracks--tags) section in the theme's README." -%}
 {%- endif -%}
 {%- if missing_tracks.size > 0 -%}
   {%- capture error_msg -%}
@@ -43,32 +43,69 @@
     {%- for missing_track in missing_tracks %}
 - {{ missing_track }}
 {% endfor %}
-For more details, refer to the [Talk Settings](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#talk-settings) section in the theme's README
+For more details, refer to the [Tracks & Tags](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#tracks--tags) section in the theme's README
   {%- endcapture -%}
   {%- assign errors = errors | push: error_msg -%}
 {%- endif -%}
 
 {%- if site.conference.info_bars -%}
-  {%- assign errors = errors | push: "Your `_config.yml` file contains an outdated property name. Please rename `conference.info_bars` to `conference.info.bars` in your configuration. For more details, refer to the [Information Boxes](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#information-boxes--modals) section in the theme's README." -%}
+  {%- assign errors = errors | push: "Your `_config.yml` file contains an outdated property name. Please rename `conference.info_bars` to `conference.info.bars` in your configuration. For more details, refer to the [Information Bars & Modals](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#information-bars--modals) section in the theme's README." -%}
 {%- endif -%}
 
 {%- if site.conference.link_preview -%}
-  {%- assign errors = errors | push: "Your `_config.yml` file contains an outdated property name. Please rename `conference.link_preview` to `conference.meta.link_preview` in your configuration. For more details, refer to the [Meta Data for Search Engines and Link Previews](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#meta-data-for-search-engines-and-link-previews) section in the theme's README." -%}
+  {%- assign errors = errors | push: "Your `_config.yml` file contains an outdated property name. Please rename `conference.link_preview` to `conference.meta.link_preview` in your configuration. For more details, refer to the [Link Previews](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#link-previews) section in the theme's README." -%}
 {%- endif -%}
 
 {%- if site.conference.program -%}
-  {%- assign errors = errors | push: "Your `_config.yml` file contains an outdated property name. Please move any program configuration from `conference.program` to the your program file (with `layout: program`). For more details, refer to the [Program Settings](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#program-settings) section in the theme's README." -%}
+  {%- assign errors = errors | push: "Your `_config.yml` file contains an outdated property name. Please move any program configuration from `conference.program` to your program file (with `layout: program`). For more details, refer to the [Program Page](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#program-page) section in the theme's README." -%}
 {%- endif -%}
 
 {%- if site.conference.location -%}
-  {%- assign errors = errors | push: "Your `_config.yml` file contains an outdated property name. Please move any location configuration from `conference.location` to the your location file (with `layout: location`). For more details, refer to the [Location Settings](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#location-settings) section in the theme's README." -%}
+  {%- assign errors = errors | push: "Your `_config.yml` file contains an outdated property name. Please move any location configuration from `conference.location` to your location file (with `layout: location`). For more details, refer to the [Location Page](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#location-page) section in the theme's README." -%}
 {%- endif -%}
 {%- if page.map and page.layout != "location" -%}
-  {%- assign errors = errors | push: "Your page's FrontMatter contains an outdated property name. Maps are no longer supported on individual pages and can only included on pages with " -%}
+  {%- assign errors = errors | push: "Your page's FrontMatter contains an outdated property name. Maps are no longer supported on individual pages and can only be included on pages with `layout: location`. For more details, refer to the [Location Page](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#location-page) section in the theme's README." -%}
 {%- endif -%}
+{%- if page.map.enable != nil -%}
+  {%- assign errors = errors | push: "Your page's FrontMatter contains an outdated property name. `map.enable` is no longer supported: a location page with `map` shows the map. Remove `enable`." -%}
+{%- endif -%}
+
+{%- comment -%}
+  Icons of the config and of this page's links that are no Bootstrap Icons,
+  e.g. Font Awesome's file-alt (icon.html renders nothing for them)
+{%- endcomment -%}
+{%- capture icon_names -%}{%- include icons/_names.txt -%}{%- endcapture -%}
+{%- assign checked_icons = "" | split: "" -%}
+{%- if edition_tags -%}
+  {%- assign checked_icons = checked_icons | concat: edition_tags -%}
+{%- endif -%}
+{%- if edition_nav_links -%}
+  {%- assign checked_icons = checked_icons | concat: edition_nav_links -%}
+{%- endif -%}
+{%- if page.links -%}
+  {%- assign checked_icons = checked_icons | concat: page.links -%}
+{%- endif -%}
+{%- assign checked_icons = checked_icons | map: "icon" | compact | uniq -%}
+{%- for icon in checked_icons -%}
+  {%- assign icon_key = icon | prepend: "," | append: "," -%}
+  {%- unless icon_names contains icon_key -%}
+    {%- assign error_msg = "Unknown icon `" | append: icon | append: "`. Use the name of a [Bootstrap Icon](https://icons.getbootstrap.com/), e.g. `file-earmark-text`." -%}
+    {%- assign errors = errors | push: error_msg -%}
+  {%- endunless -%}
+{%- endfor -%}
+
+{%- comment -%} Font Awesome markup in this page's content, e.g. <i class="fas fa-video"></i> {%- endcomment -%}
+{%- assign fa_classes = "fa fa-,fas fa-,far fa-,fab fa-" | split: "," -%}
+{%- for fa_class in fa_classes -%}
+  {%- if content contains fa_class -%}
+    {%- assign error_msg = "This page contains Font Awesome icons (e.g. `" | append: fa_class | append: "`), which are no longer supported. Use [Bootstrap Icons](https://icons.getbootstrap.com/) instead." -%}
+    {%- assign errors = errors | push: error_msg -%}
+    {%- break -%}
+  {%- endif -%}
+{%- endfor -%}
 
 {%- if site.conference.main -%}
-  {%- assign errors = errors | push: "Your `_config.yml` file contains an outdated property name. Please move any main configuration from `conference.main` to the your home file (with `layout: home`). For more details, refer to the [Main Landing Page](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#main-landing-page) section in the theme's README." -%}
+  {%- assign errors = errors | push: "Your `_config.yml` file contains an outdated property name. Please move any main configuration from `conference.main` to your home file (with `layout: home`). For more details, refer to the [Landing Page](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#landing-page) section in the theme's README." -%}
 {%- endif -%}
 
 {%- if site.conference.talks.hide_icons == true or site.conference.talks.hide_link_icons -%}
@@ -79,12 +116,19 @@ For more details, refer to the [Talk Settings](https://github.com/DigitaleGesell
   {%- assign errors = errors | push: "Your `_config.yml` file contains an outdated property name. The property `conference.speakers.show_firstname` is no longer supported." -%}
 {%- endif -%}
 
-{%- assign nbr_days = site.data.program.days | size -%}
+{%- assign program_file = "_data/program.yml" -%}
+{%- assign edition_dir = "" -%}
+{%- if edition -%}
+  {%- assign program_file = "_data/programs/" | append: edition | append: ".yml" -%}
+  {%- assign edition_dir = edition | append: "/" -%}
+{%- endif -%}
+{%- assign nbr_days = edition_program.days | size -%}
 {%- if nbr_days == 0 -%}
-  {%- assign errors = errors | push: "Your schedule in `_data/program.yml` does not seem to contain any days. Have you already created the file?" -%}
+  {%- assign error_msg = "Your schedule in `" | append: program_file | append: "` does not seem to contain any days. Have you already created the file?" -%}
+  {%- assign errors = errors | push: error_msg -%}
 {%- endif -%}
-{%- if site.conference.live -%}
-  {%- for d in site.data.program.days -%}
+{%- if edition_live -%}
+  {%- for d in edition_program.days -%}
     {%- unless d.date or d.date == "" -%}
       {%- assign error_msg = "Day " | append: forloop.index | append: " in your schedule should have a (non-empty) `date` property."  -%}
       {%- assign errors = errors | push: error_msg -%}
@@ -92,12 +136,13 @@ For more details, refer to the [Talk Settings](https://github.com/DigitaleGesell
   {%- endfor -%}
 {%- endif -%}
 
-{%- assign nbr_rooms = site.rooms | size -%}
+{%- assign nbr_rooms = edition_rooms | size -%}
 {%- if nbr_rooms == 0 -%}
-  {%- assign errors = errors | push: "The `rooms` collection does not seem to contain any entry. Have you accidentally renamed the collection or is your `_rooms/` folder empty?" -%}
+  {%- assign error_msg = "The `rooms` collection does not seem to contain any entry. Have you accidentally renamed the collection or is your `_rooms/" | append: edition_dir | append: "` folder empty?" -%}
+  {%- assign errors = errors | push: error_msg -%}
 {%- else -%}
-  {%- for room in site.rooms -%}
-    {%- assign nbr_rooms_name = site.rooms | where: 'name', room.name | size -%}
+  {%- for room in edition_rooms -%}
+    {%- assign nbr_rooms_name = edition_rooms | where: 'name', room.name | size -%}
     {%- if nbr_rooms_name > 1 -%}
       {%- assign error_msg = "The room with the `name` _" | append: room.name | append: "_ occurs more than once but should be unique."  -%}
       {%- assign errors = errors | push: error_msg -%}
@@ -105,12 +150,13 @@ For more details, refer to the [Talk Settings](https://github.com/DigitaleGesell
   {%- endfor -%}
 {%- endif -%}
 
-{%- assign nbr_speakers = site.speakers | size -%}
+{%- assign nbr_speakers = edition_speakers | size -%}
 {%- if nbr_speakers == 0 -%}
-  {%- assign errors = errors | push: "The `speakers` collection does not seem to contain any entry. Have you accidentally renamed the collection or is your `_speakers/` folder empty?" -%}
+  {%- assign error_msg = "The `speakers` collection does not seem to contain any entry. Have you accidentally renamed the collection or is your `_speakers/" | append: edition_dir | append: "` folder empty?" -%}
+  {%- assign errors = errors | push: error_msg -%}
 {%- else -%}
-  {%- for speaker in site.speakers -%}
-    {%- assign nbr_speakers_name = site.speakers | where: 'name', speaker.name | size -%}
+  {%- for speaker in edition_speakers -%}
+    {%- assign nbr_speakers_name = edition_speakers | where: 'name', speaker.name | size -%}
     {%- if nbr_speakers_name > 1 -%}
       {%- assign error_msg = "The speaker with the `name` _" | append: speaker.name | append: "_ occurs more than once but should be unique."  -%}
       {%- assign errors = errors | push: error_msg -%}
@@ -118,12 +164,13 @@ For more details, refer to the [Talk Settings](https://github.com/DigitaleGesell
   {%- endfor -%}
 {%- endif -%}
 
-{%- assign nbr_talks = site.talks | size -%}
+{%- assign nbr_talks = edition_talks | size -%}
 {%- if nbr_talks == 0 -%}
-  {%- assign errors = errors | push: "The `talks` collection does not seem to contain any entry. Have you accidentally renamed the collection or is your `_talks/` folder empty?" -%}
+  {%- assign error_msg = "The `talks` collection does not seem to contain any entry. Have you accidentally renamed the collection or is your `_talks/" | append: edition_dir | append: "` folder empty?" -%}
+  {%- assign errors = errors | push: error_msg -%}
 {%- else -%}
-  {%- for talk in site.talks -%}
-    {%- assign nbr_talks_name = site.talks | where: 'name', talk.name | size -%}
+  {%- for talk in edition_talks -%}
+    {%- assign nbr_talks_name = edition_talks | where: 'name', talk.name | size -%}
     {%- if nbr_talks_name > 1 -%}
       {%- assign error_msg = "The talk with the `name` _" | append: talk.name | append: "_ occurs more than once but should be unique."  -%}
       {%- assign errors = errors | push: error_msg -%}
@@ -134,6 +181,51 @@ For more details, refer to the [Talk Settings](https://github.com/DigitaleGesell
 {%- if site.conference.tz -%}
   {%- assign errors = errors | push: "The `conference.tz` setting is no longer supported. Use Jekyll's `timezone` setting instead, e.g. `timezone: Europe/Zurich` (see the upgrade guide)." -%}
 {%- endif -%}
-{%- if site.conference.live and site.timezone == nil -%}
+{%- if edition_live and site.timezone == nil -%}
   {%- assign errors = errors | push: "Live indications require the `timezone` setting in your `_config.yml`, e.g. `timezone: Europe/Zurich`." -%}
 {%- endif -%}
+
+{%- comment -%} Editions: every page and entry belongs to a listed one {%- endcomment -%}
+{%- if edition -%}
+  {%- unless edition_config -%}
+    {%- assign error_msg = "The edition `" | append: edition | append: "` of this page is not listed in `conference.editions` in your `_config.yml` file." -%}
+    {%- assign errors = errors | push: error_msg -%}
+  {%- endunless -%}
+  {%- assign entries_without_edition = site.talks | concat: site.speakers | concat: site.rooms | where_exp: "entry", "entry.edition == nil" -%}
+  {%- if entries_without_edition.size > 0 -%}
+    {%- assign error_msg = "Some talks, speakers or rooms have no `edition`, e.g. `" | append: entries_without_edition[0].relative_path | append: "`. Place them in a folder of their edition (e.g. `_talks/" | append: edition_current_id | append: "/`) and set `edition` for it with `defaults` in your `_config.yml` file. For more details, refer to the [Editions](https://github.com/DigitaleGesellschaft/jekyll-theme-conference/#editions) section in the theme's README." -%}
+    {%- assign errors = errors | push: error_msg -%}
+  {%- endif -%}
+
+  {%- comment -%}
+    Entries outside their edition's folder, e.g. _talks/2025/x.md with
+    edition 2026 (mistaken `defaults`): counted, looked up only on a mismatch
+  {%- endcomment -%}
+  {%- assign entries = site.talks | concat: site.speakers | concat: site.rooms -%}
+  {%- for e in editions -%}
+    {%- assign e_folder = "/" | append: e.id | append: "/" -%}
+    {%- assign e_entries = entries | where: "edition", e.id -%}
+    {%- assign e_entries_in_folder = e_entries | where_exp: "entry", "entry.path contains e_folder" -%}
+    {%- if e_entries_in_folder.size == e_entries.size -%}
+      {%- continue -%}
+    {%- endif -%}
+    {%- for entry in e_entries -%}
+      {%- unless entry.path contains e_folder -%}
+        {%- assign error_msg = "Some talks, speakers or rooms lie in the folder of another edition, e.g. `" | append: entry.relative_path | append: "` has the edition `" | append: e.id | append: "`. Check the `edition` set with `defaults` in your `_config.yml` file." -%}
+        {%- assign errors = errors | push: error_msg -%}
+        {%- break -%}
+      {%- endunless -%}
+    {%- endfor -%}
+    {%- break -%}
+  {%- endfor -%}
+
+  {%- comment -%} This page outside its edition's folder, e.g. 2025/program/index.md without edition {%- endcomment -%}
+  {%- unless page.collection -%}
+    {%- assign page_folder = page.path | split: "/" | first -%}
+    {%- assign page_folder_edition = editions | where: "id", page_folder | first -%}
+    {%- if page_folder_edition and page_folder != edition -%}
+      {%- assign error_msg = "This page lies in the folder of the edition `" | append: page_folder | append: "`, but has the edition `" | append: edition | append: "`. Set `edition` for the folder with `defaults` in your `_config.yml` file." -%}
+      {%- assign errors = errors | push: error_msg -%}
+    {%- endif -%}
+  {%- endunless -%}
+{%- endif -%}

data/_includes/conference_config.json

@@ -5,6 +5,8 @@
 {%- assign lang = site.data.lang[site.conference.lang] -%}
 {
     "baseurl": {{ site.baseurl | jsonify }},
+    "edition": {{ edition | jsonify }},
+    "edition_current": {{ edition_current | jsonify }},
 
     {%- include get_location_config.html -%}
     {%- if location_map %}
@@ -12,14 +14,17 @@
         "map_provider": {{ location_map.map_provider | default: 'OpenStreetMap.Mapnik' | jsonify }},
         "home_coord": [{{ location_map.home_coord | default: '47.3744489, 8.5410422' }}],
         "default_zoom": {{ location_map.default_zoom | default: 17 }}
+        {%- if location_map.script %},
+        "script": {{ location_map.script | prepend: '/assets/js/' | prepend: site.baseurl | jsonify }}
+        {%- endif %}
     },
     {%- endif %}
 
-    {% if site.conference.live -%}
+    {% if edition_live -%}
     "live": {
         "timezone": {{ site.timezone | jsonify }},
         "days": [
-            {%- for d in site.data.program.days %}
+            {%- for d in edition_program.days %}
             {
                 {%- include get_day_hash.html %}
                 "name": {{ day_name | jsonify }},
@@ -30,11 +35,11 @@
     },
     {%- endif %}
 
-    {% if site.conference.live.streaming.enable -%}
+    {% if edition_live.streaming.enable -%}
     "stream": {
-        "pause": {{ site.conference.live.streaming.pause | default: 60 }},
-        "prepend": {{ site.conference.live.streaming.prepend | default: 5 }},
-        "extend": {{ site.conference.live.streaming.extend | default: 5 }}
+        "pause": {{ edition_live.streaming.pause | default: 60 }},
+        "prepend": {{ edition_live.streaming.prepend | default: 5 }},
+        "extend": {{ edition_live.streaming.extend | default: 5 }}
     },
     {%- endif %}
 

data/_includes/footer.html

@@ -7,7 +7,7 @@
 
   {%- include modal_link.html -%}
 
-  {%- if site.conference.live.streaming.enable -%}
+  {%- if edition_live.streaming.enable -%}
     {%- include modal_live.html -%}
   {%- endif -%}