Skip to content

About

Jekyll template for a conference website containing program, speaker, talks and room overview

Topics

Resources

Stars

95 stars

Watchers

5 watching

Forks

Repository files navigation

jekyll-theme-conference

Screenshot

This is a responsive Jekyll theme based on Bootstrap 5 for conferences. It contains

  • multi-day program / schedule,
  • talk and speaker descriptions,
  • maps for directions,
  • real-time indications during the conference,
  • support for embedded video streaming or recordings
  • support for an all offline progressive web app, and
  • automatic dark mode support based on system preferences.

All components such as talks, speakers or rooms are represented as a collection of files. The schedule is defined via a simple structure stored in a YAML file. There is no need for databases and once generated the website consists only of static files. A script and workflows are available for easy import, e.g., of frab compatible schedules. The design is easily customizable and is adapted for mobile uses and printing.

The theme was created for the yearly Winterkongress conference of the Digital Society Switzerland. You can see this theme active here:

Warning

If you upgrade from an earlier major version, please note the necessary changes in the upgrade guide.

Table of Contents

Installation

There are three ways to install this theme:

  1. Gem-based method: Install as a Gem-based theme (recommended for most users)
  2. Remote theme method: Use as a remote theme (ideal for GitHub Pages)
  3. Local development: Clone or fork this repository for local development and customization (see Development section)

Gem-based Method

With Gem-based themes, directories such as assets, _layouts, and _includes are stored in the theme's gem, hidden from your immediate view. All necessary directories will be read and processed during Jekyll's build process.

This allows for easier installation and updating as you don't have to manage any of the theme files. To install:

  1. Add the following to your Gemfile:

    gem "jekyll-theme-conference"
  2. Fetch and update bundled gems by running the following Bundler command:

    bundle
  3. Set the theme in your project's Jekyll _config.yml file:

    theme: jekyll-theme-conference
  4. Continue with the Setup section below to customize the theme and add content for your conference.

To update the theme, run bundle update jekyll-theme-conference.

Remote Theme Method

Remote themes are similar to Gem-based themes but are ideal for sites hosted with GitHub Pages, as they don't require theme whitelisting.

To install:

  1. Create or replace the contents of your Gemfile with the following:

    source "https://rubygems.org"
    
    gem "github-pages", group: :jekyll_plugins
    gem "jekyll-include-cache", group: :jekyll_plugins
  2. Add jekyll-include-cache to the plugins array in your _config.yml:

    plugins:
      - jekyll-include-cache
  3. Fetch and update bundled gems by running the following Bundler command:

    bundle
  4. Add remote_theme: "DigitaleGesellschaft/jekyll-theme-conference@v5.3.0" to your _config.yml file. Remove any other theme: or remote_theme: entry.

    remote_theme: "DigitaleGesellschaft/jekyll-theme-conference@v5.3.0"
  5. Continue with the Setup section below to customize the theme and add content for your conference.

To update the theme, change the version tag in the remote_theme value (e.g., @v5.2.0 to @v5.3.0).

Setup

Add the talks, speakers, rooms and the schedule of your conference as described in the section Content, and adapt the theme as described in the section Configuration. The tools below import them or build the site for you.

Tip

To get started quickly, use the template repository: its main branch is an empty site ready to be filled, its demo branch showcases the theme with a fictional conference.

Tip

Please note that the generated website can be large containing many unnecessary whitespaces. It is recommended to minimize the generated output files before uploading them to a server (e.g., with minify).

Import from pretalx

In this repository, you'll find the Python file _tools/import_schedule.py. This script allows you to import content from a frab-compatible JSON file, such as those exported from pretalx.com.

  1. Copy the files _tools/import_schedule.py and _tools/requirements.txt from this repository

  2. Execute the script with uv, which installs the requirements, e.g., to show the help type

    uv run --no-project --with-requirements _tools/requirements.txt python _tools/import_schedule.py --help

    With several editions, pass the edition's id, e.g. --edition 2026: the script then writes to _talks/2026/, …, _data/programs/2026.yml and creates the edition's overview pages.

  3. Optionally, keep own properties across imports, as the script rewrites all rooms, speakers and talks: list them in a YAML file and pass it with --overrides, e.g. --overrides _tools/overrides.yml. They are merged into the imported entries of the same name and replace imported values (e.g. hide). Unknown names are reported and skipped.

    rooms:
      - name: Main Hall
        order: 1
        live:
          absolute_url: https://example.com/stream/main-hall
    talks:
      - name: Opening
        tags: [Keynote]

Likewise, _tools/import_resources.py imports resources such as slides and other documents from pretalx.com via its API. It downloads all files, stores them and updates the links of the talks concerned (see Links). Run it the same way, e.g., uv run --no-project --with-requirements _tools/requirements.txt python _tools/import_resources.py --help. With several editions, pass the edition's folders, e.g. --file-folder 2026/documents/slides/ --talk-folder _talks/2026/.

Automatic Build

If you prefer not to install the full Ruby/Jekyll toolchain locally, you can leverage GitHub Actions, GitHub's continuous integration platform. This repository includes several example GitHub Actions configuration files in the _tools/ folder:

  • build.yml: This workflow automatically builds and optimizes the website whenever a new tag starting with v (e.g., v2020.01.01) is added. It then attaches the generated website as an archive to a release for easy download.
  • test.yml: This workflow automatically attempts to build the website upon a new pull request, making it suitable for use as a status check before merging.
  • schedule.yml: This workflow automatically generates schedule and content files when a new pull request includes a schedule.json file (see Import from pretalx). This enables quick content updates from pretalx.com exports. With several editions, set its EDITION variable to the id of the edition to import. Its OVERRIDES variable names the file passed to --overrides.

To get started, simply copy the desired workflow file to your repository and adapt it to your needs:

  • _tools/build.yml -> .github/workflows/build.yml
  • _tools/test.yml -> .github/workflows/test.yml
  • _tools/schedule.yml -> .github/workflows/schedule.yml

Important

Please note that the Gemfile.lock of your project must be adapted to include specific versions required by GitHub's workflow server, i.e., run bundle lock --add-platform x86_64-linux to add support for them.

Configuration

Most settings of this theme are stored under the conference property in the _config.yml file. Some are Jekyll's own settings at the top level (e.g. timezone), and the settings of the main landing page, the location page and the program page are stored in their Front Matter (sections at the end).

Error Checks

Upon building, the theme runs some basic verification to check if all necessary files and configurations are in place. If it encounters an error it shows this by adding an information bar on all your sites. You can disable this, e.g., in a production environment, by setting show_errors to false (default: true).

Example:

conference:
  show_errors: false

Warning

Please be sure to disable this parameter for your production system.

Collection URLs

The three required collections containing the files for the talks, speakers and rooms have to be specified in the _config.yml file. The first block declares them and sets the URL under which they will later be accessed. The second block defines the default layout for each collection.

collections:
  talks:
    output: true
    permalink: /:collection/:title/
  speakers:
    output: true
    permalink: /:collection/:title/
  rooms:
    output: true
    permalink: /:collection/:title/

defaults:
  - scope:
      path: ""
      type: talks
    values:
      layout: talk
  - scope:
      path: ""
      type: speakers
    values:
      layout: speaker
  - scope:
      path: ""
      type: rooms
    values:
      layout: room

To change the URL of the collection, simply edit the permalink property and replace the :collection tag (which translates to talks, speakers and rooms) with your desired value.

Note

Please note that while you might want to change the URLs, the name of the three collections (talks, speakers and rooms) is fixed and cannot be changed.

Language

To set the theme's language, use the lang property. The following languages are supported:

  • English: en (Default)
  • German: de
  • French: fr
  • Portuguese: pt

Example:

conference:
  lang: en

To add more languages, copy the internationalization file from this repository to _data/lang.yml, modify it, and store it in your own repository at the same path.

Timezone

Multiple dynamic features such as showing the current day in the program, live indications or the dates in the structured data require correct timing. Define the timezone in which the conference takes place with Jekyll's timezone setting, set to an IANA timezone name. Daylight saving time is taken into account and the result does not depend on the timezone of the machine building the site.

Example:

timezone: Europe/Zurich

Navigation Bar

The navigation bar is located at the top and visible on every site. On the left, it shows the title of the website (site.title) followed by the links listed under the links property of the navigation property. See the Content > Links section below for the available properties per link. Icons are only shown when installed as an app (see below).

Example:

conference:
  navigation:
    links:
      - name: Program
        relative_url: /program/
      - live: true
      - name: About  # dropdown menu
        menu:
          - name: Location
            relative_url: /location/
          - name: Code of Conduct
            relative_url: /code-of-conduct/
          - name: Contact
            absolute_url: mailto:info@example.org

With several Editions, a menu to switch between them appears at the end of the navigation bar, labelled with the page's edition. A link with menu: editions places it among the links instead (see Links). The editions property under the navigation property adapts it:

  • name labels the menu instead of the edition; a link's own name wins.
  • hide: true removes the menu at the end, but not a link with menu: editions.

The installed app (see Progressive Web App (PWA)) serves the current edition, so its navigation bar has no menu at the end. A link with menu: editions still shows there; add pwa_hide: true to it to keep the app on the current edition.

conference:
  navigation:
    editions:
      name: Editions
    links:
      - name: Program
        relative_url: /program/
      - menu: editions

Optionally, a logo or link of your organization hosting the conference can be shown on the right side of the navigation bar. It is activated through the logo property under the navigation property containing

  • the text to show (name),
  • an absolute link address (url), and
  • optionally a logo to show instead of the text (img), whereby the path to the image file relative to the /assets/images/ folder has to be specified.
  • optionally a dark mode logo (img_dark), which will be automatically displayed when the user's system is in dark mode. If not specified, the regular img will be used in both light and dark modes.

Example:

conference:
  navigation:
    ...
    logo:
      name: Magic Organisation
      img: 'logo.svg'  # inside /assets/images/
      img_dark: 'logo-dark.svg'  # optional: dark mode version
      url: 'https://github.com'

The navigation bar automatically collapses when the available space is too small (e.g., on a smaller screen). The breakpoints are given by Bootstrap. The default breakpoint is md (collapsing if the screen width is smaller than 768px). It can be adapted by setting the breakpoint property under the navigation property to either sm, md, lg, or xl.

When installed as a progressive web application (see the Progressive Web App (PWA) section below), the navigation bar moves to the bottom. In PWA mode, it displays link icons. A link with live: true appears while live before the "More" button, with the live icon above its name (default: "Live"), and outside live as a disabled entry named name_inactive if given. Without name_inactive, it takes no place outside live: while live, the last entries move into "More" to make room. The bar holds up to five entries, four on screens narrower than 390px (e.g. iPhone mini); with more, it shows one less and a "More" button opening the others in a sheet from the bottom. Menus open as such sheets too. The current page's entry is coloured and its icon switches to the filled variant if there is one (e.g. people-fill for people). To hide an entry in this mode, set pwa_hide: true on its link.

conference:
  navigation:
    links:
      - name: Program
        icon: calendar4-week
        relative_url: /program/
      - name: Supporters
        pwa_hide: true
        relative_url: /supporters/

Meta Data

The theme automatically includes the necessary <meta> tags to ease link previewing when sharing links based on the Open Graph protocol (used by all major social networks and messenger apps) and Twitter Cards (used by X). These tags control how a link is shown when shared via different platforms and apps. The theme also includes Schema.org JSON-LD structured data to help search engines better understand and display the conference and its talks, potentially showing event cards, speaker information, and enhanced search listings.

Both configurations are organized under the meta property.

To generate a meaningful description for each of the schemas and links, the preposition for the conference title as given under the title property can be defined by using the preposition property. For example, if title is set to "Conference 2020" the corresponding preposition would be "at". The template can then use it to generate descriptions such as "Talk at Conference 2020".

title: Conference 2020
preposition: "at"

Link Previews

Support for link preview is organized under the link_preview property part of the meta property. It can be disabled by setting disable to true.

Optionally, an image that is shown as preview for all links can be specified. For sharing via Open Graph an image ratio of 1.91:1 and an ideal size of 1200x630 pixel is recommended. For sharing via Twitter an image ratio of 1.91:1 and a minimal size of 300x157 pixel (better 1200x628 pixel) is recommended. SVG image files are not supported. It is activated through the img property under the link_preview property containing an image file shown for Open Graph (open_graph) and on the Twitter Cards (twitter), whereby the path to the image file relative to the /assets/images/ folder has to be specified.

conference:
  meta:
    link_preview:
      disable: false  # Set to true to disable Open Graph and Twitter Card meta tags
      img:
        twitter: "twitter_preview.png"  # inside /assets/images/
        open_graph: "facebook_preview.png"  # inside /assets/images/

Structured Data (Schema.org)

Support for Schema.org JSON-LD structured data is organized under the schema_org property part of the meta property. It can be disabled by setting disable to true. Different schemas are generated depending on the page type, and these schemas are interconnected. The following schemas are generated:

  • ConferenceEvent (main and program page)
  • Event (talk pages)
  • Place (location and room pages)
  • Person (speaker pages)

Note

Please note that any talk, room, or speaker set to hide: true will not be included in the generated schemas or their relations.

Optionally, the following properties can be added under the schema_org property to provide further information about the conference:

  • Event Status (event_status):
    • scheduled (default)
    • cancelled
    • postponed
    • moved_online
  • Event Attendance Mode (event_attendance_mode):
    • offline (default)
    • online
    • mixed
  • Organizer hosting the conference (organizer) with the following properties
    • name
    • url
  • Call for Participation (has_participation_offer) with the following property
    • url
  • Ticket offer (tickets) with the following optional properties
    • url
    • availability:
      • in_stock
      • pre_order
      • sold_out
      • limited_availability
      • out_of_stock
      • online_only
      • in_store_only
    • price
    • priceCurrency: Currency code (ISO 4217, e.g., "USD", "EUR", "CHF")
  • Image file path (img) relative to the /assets/images/
conference:
  meta:
    schema_org:
      disable: false  # Set to true to disable Schema.org JSON-LD structured data
      event_status: "scheduled"  # Options: scheduled, cancelled, postponed, moved_online
      event_attendance_mode: "offline"  # Options: offline, online, mixed
      organizer:  # Organization hosting the conference
        name: "Your Organization Name"  # Organization name
        url: "https://example.com"  # Organization website URL (optional, can use name or url)
      has_participation_offer:  # Call for participation
        url: "https://example.com/register"  # URL for participation offer
      tickets:  # Ticket offer
        url: "https://example.com/tickets"  # URL to purchase tickets
        availability: "in_stock"  # Options: in_stock, pre_order, sold_out, limited_availability, out_of_stock, online_only, in_store_only
        price: "50.00"  # Price as a string (e.g., "50.00")
        priceCurrency: "USD"  # Currency code (ISO 4217, e.g., "USD", "EUR", "CHF")
      img: "conference.png"  # inside /assets/images/

Information Bars & Modals

The theme supports two types of information displays: banners at the top of the page (bars) and dialog popups (modals). Both can be used to inform your visitors about important news and announcements.

One or multiple information banners can be shown at the top of the website just below the navigation bar. They are prominent and can inform your visitors about important news. They are activated through the info.bars property, which contains a list for each information banner to show. Each banner consists of

  • a title (title),
  • a color (color) following the Bootstrap color scheme (see below), possible values are:
    • primary (your website's main color, normally blue)
    • secondary (your website's secondary color, normally grey)
    • success (green)
    • danger (red)
    • warning (yellow)
    • info (blue)
    • light (white)
    • dark (dark grey)
  • an additional text (text, markdown supported),
  • the option to show it on all pages, only the main landing page (main_only: true), or all pages except the main landing page (pages_only: true),
  • optionally, the number of days to keep the info bar dismissed after a user closes it (dismissal_days, default: 7). Each info bar can have its own dismissal period. Setting dismissal_days: 0 will disable dismissibility entirely (no close button will be shown, and the info bar cannot be dismissed).
  • optionally, a list of link buttons (links).

Information modals appear as modal dialog popups that overlay the page content, dimming the background. They are useful for displaying important announcements that require user attention. Modals are activated through the info.modals property, which contains a list for each information modal to show. Each modal consists of

  • a title (title),
  • an additional text (text, markdown supported),
  • the option to show it on all pages, only the main landing page (main_only: true), or all pages except the main landing page (pages_only: true),
  • optionally, the number of days to keep the info modal dismissed after a user closes it (dismissal_days, default: 7). Each modal can have its own dismissal period. Setting dismissal_days: 0 will disable dismissibility entirely (cannot be closed).
  • optionally, a list of link buttons (links) in its footer instead of the close button. Following one dismisses the modal.

Modals automatically appear when a page loads. The dismissal state is persisted in the browser's localStorage, so users won't see dismissed modals again until the dismissal period expires.

Example:

conference:
  info:
    # Information modals (shown as modal dialogs)
    modals:
      - title: Important Announcement
        main_only: true
        dismissal_days: 7
        text: This is an information modal that appears as a dialog.
        links:
          - name: Program
            relative_url: /program/

    # Information bars (shown as alerts at the top of the page)
    bars:
      - title: Sold Out!
        color: primary
        main_only: true
        dismissal_days: 14
        text: |
          We're truly sorry but we are **sold out**.

          ---

          Try again next year.
        links:
          - name: Waiting List
            absolute_url: https://example.com/waiting-list
      - title: Important Notice
        color: warning
        dismissal_days: 0
        text: |
          This is a non-dismissible information banner that will always be visible.

Live Indications & Streaming

To help users navigate the program during the conference, a Live indication can be shown next to talks that are currently taking place. A small JavaScript function keeps the site automatically up-to-date (without the need to refresh) showing the indication as soon as the talk has started and hiding it once it is over (according to the timetable indicated in the _data/program.yml file).

This can be further extended if some talks have an associated live stream: When clicking one of the live indications, a modal will open containing the corresponding embedded live stream. The URL to the live stream has to be set via live property in each room (see the Content > Rooms section below). Instead of opening the modal an external link can also be used.

To activate these functionalities, each day in the program.yml file must contain a date property (see section Content > Schedule / Program below) and the live property has to be set in the configuration file containing

  • optionally, how long a pause between two consecutive talks has to be for the live indication to pause (stop, default: 240),
  • optionally, under the now_line property, a horizontal line in the program marking the current time (behind the talks):
    • if it is shown (enable, default: true), and
    • its colour, one of Bootstrap's theme colours (color, default: danger), and
  • optionally, under the streaming property:
    • if streaming should be enabled (enable), and if enabled
    • how many minutes the stream goes active before a talk (prepend, default: 5),
    • how many minutes the stream stays active after a talk (extend, default: 5),
    • how long a pause between two consecutive talks has to be for the stream to pause (pause, default: 60),
    • if the stream is only loaded once the visitor clicks a button, as the streaming provider receives the visitor's IP address (click_to_load, default: true; set to false for self-hosted streams), and
    • an external (absolute) link to which the user will be redirected instead of opening the modal (external).
conference:
  live:
    stop: 240 # in minutes
    now_line:
      enable: true
      color: danger # Bootstrap theme colour, e.g. primary
    streaming:
      enable: true
      pause: 60 # in minutes
      prepend: 5 # in minutes
      extend: 5 # in minutes
      click_to_load: true # optional: false loads streams without consent
      external: "https://example.com/stream" # optional: external link instead of modal

Progressive Web App (PWA)

The theme includes built-in support for Progressive Web App (PWA) functionality, allowing your conference website to be installed on users' devices and work offline. Once a visitor opened the site, all pages (program, talks, speakers, rooms, …) and all files below assets/ (stylesheets, scripts, images, fonts) are available offline. Documents (documents/, with editions <id>/documents/) and map tiles are not. Pages and data are always loaded fresh when online, so schedule changes reach visitors right away (falling back to the stored copy if the network does not answer within 3 seconds, e.g. on a crowded conference Wi-Fi). When the site is rebuilt, installed apps only download what changed: the theme's bundles are versioned by their content, all other files are revalidated. PWA functionality is disabled by default. To enable it, multiple manual steps are necessary to add the necessary files:

  1. Enable and optionally customize the functionality in your _config.yml:

    conference:
      pwa:
        enable: true
    
        # Theme color for the PWA (default: Bootstrap primary color, #0d6efd)
        theme_color: "#0d6efd"
    
        # Theme color in dark mode (default: theme_color)
        theme_color_dark: "#0a58ca"
    
        # Background color for the PWA (default: white, #ffffff)
        background_color: "#ffffff"
    
        # Banner asking visitors on phones and tablets to install the app (default: true)
        install_banner: true
    
        # PWA icons configuration
        icons:
          - img: "icons/icon-192.png"
            sizes: "192x192"
            type: "image/png"
          - img: "icons/icon-512.png"
            sizes: "512x512"
            type: "image/png"
          - img: "icons/maskable-512.png"
            sizes: "512x512"
            type: "image/png"
            purpose: "maskable"

    Icons can be configured as an array of objects containing:

    • img: Path to the icon file relative to /assets/images/ (required)
    • sizes: Optional, icon size in format "WIDTHxHEIGHT" (e.g., "192x192")
    • type: Optional, MIME type (e.g., "image/png")
    • purpose: Defaults to "any", see mdn Manifest Reference for alternative values
  2. Create a manifest file in the root of your project, manifest.json with the following content:

    ---
    layout: manifest
    ---
  3. Create a service worker JavaScript file in the root of your project, sw.js with the following content:

    ---
    layout: sw
    ---
  4. Create specified icon files. It is recommended to have at least icons for the following three settings:

    • size: "192x192"
    • size: "512x512"
    • size: "512x512", purpose: "maskable"

    These icons will be used when users install the app on their devices. You can generate these from a single high-resolution logo using a tool like:

On phones and tablets (iOS and Android), a banner above the page invites visitors to install the app. It looks like the platform's own install banners. Its button opens the browser's install prompt where available (Chrome on Android), otherwise a panel at the bottom explaining in three steps how to add the app to the home screen. Closing the banner hides it for 30 days. It is not shown on desktops, within the installed app or on past editions. Set install_banner: false to turn it off.

Note

Please note that when installed as a PWA, the navigation bar moves to the bottom and includes icons. See the Navigation Bar section above for more information.

Tracks & Tags

Talks can optionally be organized into tracks, where each track groups talks under a common subject. Tracks are visually distinct across the website, especially in the program, by a unique color. Additionally, each talk can have one or more associated tags. Both tracks and tags are linked via the talk's Front Matter (refer to the Content > Talks section below for more details).

To define available tracks, add the tracks property under the talks property in the configuration file. This property is a list of tracks, with each track requiring:

  • its name, which must match the track specified in the talk's Front Matter.
  • a color (color) following the Bootstrap color scheme (see below), possible values include:
    • primary (your website's main color, normally blue)
    • secondary (your website's secondary color, normally grey)
    • success (green)
    • danger (red)
    • warning (yellow)
    • info (blue)
    • light (white)
    • dark (dark grey)
  • optionally, an icon (icon: followed by the Bootstrap Icons icon name to show) as a second distinction besides the color, e.g. for color blind visitors. It is shown in the lower right corner of each talk.

Instead of displaying the tag name, you can replace it with an icon. To define tags with icons, add the tags property under the talks property in your configuration file. Each listed tag requires:

  • its name, which must match the tag specified in the talk's Front Matter.
  • optionally, an icon to show instead of the tag's name (icon: followed by the Bootstrap Icons icon name to show).

Talks can also have associated links displayed at the end of their content. If these links have an icon (see Content > Talks below), they will also appear on the talk overview page (e.g., to indicate which talks have video recordings).

Example:

conference:
  talks:
    # Talk tracks
    tracks:
      - name: Track A
        color: info
        icon: circle-fill
      - name: Track B
        color: success

    # Talk tags
    tags:
      - name: No recording
        icon: camera-video-off-fill

Landing Page

The main landing page is shown at the root of the website to greet new visitors. To show it you need to create a index.md file in the root of your website's folder and specify its layout as layout: home.

The main page states your site's title (site.title) or a logo instead. The logo can be configured through the header property of the main page's Front Matter containing

  • a img property specifying the path to the image file relative to the /assets/images/ folder.
  • optionally a img_dark property for a dark mode version of the logo, which will be automatically displayed when the user's system is in dark mode. If not specified, the regular img will be used in both light and dark modes.

The title/logo on the main page is followed by a description of your site (site.description) and the content of your index.md file. It ends with an optional list of link buttons. See the Content > Links section below for the available properties per link.

layout: home
header:
  img: "main_logo.png"
  img_dark: "main_logo_dark.png"  # optional: dark mode version
links:
  - name: Program
    relative_url: /program/
  - name: Tickets
    disabled: true
    absolute_url: ''

Location Page

To help users find your venue, an OpenStreetMap container displaying a map can be shown on the location page as well as the address of the venue. You can define the initial position of the map by setting the default zoom level default_zoom, the center coordinates home_coord, and the map provider for the tiles map_provider. Alternative map providers can be found here. The map contains small control buttons to zoom in and out, center the map back to the initial position, and show the visitor's current location (has to be manually activated and granted by the visitor).

To protect the visitors' privacy, the map is only loaded once the visitor clicks a button, as the tile provider receives the visitor's IP address. The consent is stored in the browser for 30 days. If you host the tiles yourself, you can load the map right away by setting click_to_load: false.

Location settings are configured directly in the Front Matter of the location page (the page with layout: location). The location page's Front Matter supports the following properties:

  • title: The title shown in the navigation bar for the location section (defaults to "Location")
  • hide: Set to true to hide the location page and all room links (default: false). The page then only redirects to the home page. Hidden rooms still need to exist in the _rooms/ directory as references.
  • map: Map configuration object with the following properties:
    • home_coord: Center coordinates of the map (e.g., 47.37808, 8.53935)
    • default_zoom: Initial zoom level (e.g., 17)
    • map_provider: Tile provider (default: "OpenStreetMap.Mapnik")
    • click_to_load: Load the map only after the visitor's consent (default: true)
    • script: Script adapting the map, e.g. adding markers (see below)
  • postal_address: Postal address displayed on the location page and used in schema.org structured data. Can contain:
    • name: Venue name (e.g., "Zentralwäscherei")
    • street: Street address (e.g., "Neue Hard 12")
    • locality: City or locality (e.g., "Zurich")
    • postal_code: Postal or ZIP code (e.g., "8005")
    • region: State, province, or region (e.g., "ZH", "Zurich")
    • country: ISO 3166-1 alpha-2 country code (e.g., "CH")

Example location page (location/index.md):

---
layout: location
title: Conference Venue
hide: false
postal_address:
  name: "Zentralwäscherei"
  street: "Neue Hard 12"
  locality: "Zurich"
  postal_code: "8005"
  region: "ZH"
  country: "CH"
map:
  default_zoom: 17
  home_coord: 47.37808, 8.53935
  map_provider: "OpenStreetMap.Mapnik"
---

Welcome to our conference venue!

The map is based on the Leaflet JavaScript library. To add markers, text, or shapes, name a script in map.script, relative to assets/js/ (e.g. script: maps/venue.js for assets/js/maps/venue.js). Once the visitor loaded the map, the theme calls the script's default export with the map object (Leaflet is available as L):

// assets/js/maps/venue.js
export default function (map) {
    L.polygon([[47.3751, 8.5274], [47.3755, 8.5279], [47.3758, 8.5273]], {
        className: 'map-area'
    }).addTo(map);

    L.marker([47.37785, 8.54035], {
        icon: L.divIcon({ className: 'map-label', html: 'Main Station', iconSize: null })
    }).addTo(map);
}

The class map-label centres a label on its point, sizes it to its text and keeps it dark on the light map tiles, also in dark mode. The class map-area draws a shape in the primary colour. Add classes of your own next to them to style labels and shapes further.

With several editions, each edition's location page names its own script. Alternatively, assets/js/main.js gets the map with await window.conference.map.getMap() after await window.conference.awaitReady() (resolves once the visitor loaded the map, with null on pages without map).

Program Page

Program settings are configured directly in the Front Matter of the program page (the page with layout: program). The program page's Front Matter supports the following properties:

  • title: The title shown on the program page (defaults to "Program")
  • time_steps: The time interval in minutes for each row in the schedule grid or start to show only the intervals that correspond to a talk start time (default: 15)
  • show_alltimes: Show time labels for all intervals, not just full hours (default: false)
  • show_first_hour: Always show hour in time label of first row (default: false)
  • hide_legend: Hide track legends at the bottom of program table (default: false)
---
layout: program
title: Conference Program
time_steps: 15
show_alltimes: true
---

Editions

One site can hold several editions of a conference, e.g. the current one and past ones as archive. Every edition lives below its own folder (/2026/, /2025/, …), the site's root forwards to the current edition. Without editions, the site holds a single edition as described in the rest of this document.

List the editions in _config.yml under conference.editions. The current edition is the first one with current: true, else the first one of the list. Its id names the edition's folders, its name labels it in the menu to switch between editions (default: its id).

An edition inherits the site's settings and can override some of them. An override replaces the site's setting as a whole, all others are kept; e.g. an edition with its own navigation.links keeps the site's navigation.logo.

Setting In _config.yml Per edition
title, description Jekyll, top level yes
url, baseurl, timezone Jekyll, top level no
meta.link_preview, meta.schema_org conference yes
navigation.logo, navigation.links, navigation.breakpoint, navigation.editions conference yes
info.bars, info.modals conference yes
talks.tracks, talks.tags conference yes
lang, custom_style, show_errors, pwa conference no
live conference no, current edition only

Settings in a page's Front Matter (e.g. of the Landing Page or the Program Page) belong to its edition anyway, as every edition has its own pages.

conference:
  editions:
    - id: "2026"
      current: true
      title: My Conference 2026
    - id: "2025"
      name: 2025 (Archive)
      title: My Conference 2025
      talks:
        tracks:
          - name: Workshops
            color: warning

Mark each page and entry with its edition by folder, with one pair of defaults per edition (in addition to the layouts of the collections, see Collection URLs):

defaults:
  - scope:
      path: "2026"     # pages, e.g. 2026/program/index.md
    values:
      edition: "2026"
  - scope:
      path: "_*/2026"  # talks, speakers and rooms, e.g. _talks/2026/keynote.md
    values:
      edition: "2026"
      permalink: /2026/:collection/:title/

With show_errors, pages report a page or entry whose edition doesn't match its folder, e.g. due to a forgotten defaults entry.

The content of each edition is then placed as follows:

index.md                  layout: editions (forwards to the current edition)
2026/index.md             layout: home
2026/program/index.md     layout: program (likewise talks/, speakers/, location/, …)
2026/documents/           files of links (slides/, bio/, …)
_talks/2026/              talks (likewise _speakers/2026/, _rooms/2026/)
_data/programs/2026.yml   schedule

Talks, speakers and rooms are looked up within their edition only, so names may repeat across editions (e.g. a speaker attending every year). Links with relative_url point into the page's edition, e.g. /program/ to /2026/program/. Live indications, live streams and the offline app (PWA) cover the current edition only. To point visitors of a past edition to the current one, give it an info bar (see Information Bars & Modals), e.g. info: {bars: [{title: Archive, color: secondary, text: "Go to the [current edition](/2026/)."}]} in its editions entry. Files below assets/ (styles, scripts, images) and _sass/ are shared by all editions.

Other addresses, e.g. a former /program/, show the site's 404 page. To forward them to the current edition on an Apache web server, create a .htaccess file in the root of your project:

---
layout: htaccess
---

It forwards addresses that don't exist but do exist in the current edition, e.g. /program/ to /2026/program/, and follows the current edition on its own. Below the Front Matter, you can add your own rules. It assumes the site lies at baseurl below the web server's document root. Other hosts (e.g. GitHub Pages, Netlify, nginx) ignore the file and need their own redirects.

Content

The different talks, speakers and rooms are stored as a collection of files. Each file contains a small header in form of a YAML block (called Front Matter) used to store additional information beside a description. The schedule defining when and in which room a talk takes place is stored as a YAML data file.

Schedule / Program

The schedule of the conference linking the talks with the rooms and indicating when each talk takes place and how long it lasts, is set in the _data/program.yml file (with several editions: _data/programs/<id>.yml per edition). It contains a list of days, whereby each day contains a list of rooms, whereby each room contains a list of talks.

Each day consists of

  • a list of rooms (rooms) in which talks are taking place on that day
  • optionally, the day's name, e.g., the weekday
  • optionally, the short form of the day's name (abbr), and
  • a date in the format YYYY-MM-DD (required if live indications are enabled, optional otherwise)

Each room consists of

  • the room's name (must correspond to one of the room identifiers), and
  • a list of talks (talks) which also can be empty [].

The order of the rooms in the list defines the order of the rooms as shown in the schedule on the program page. Elsewhere (e.g. live streams or the room links on the location page), rooms follow their first appearance in the program, unless they set order (see Rooms).

Each talk consists of

  • a name (must correspond to one of the talk identifiers),
  • a starting time time_start given as H:M (strftime formatted) or H:M +∆ whereby ∆ is the day offset in relation to the date given for the given day, and
  • an end time time_end.

The list of talks should (manually) be ordered by time, i.e., the first occurring talk should be listed first.

Example:

days:
  - name: Monday
    abbr: Mo
    date: 2020-01-31
    rooms:
      - name: Room A
        talks:
          - name: Vim Impetus Placerat Cotidieque Ad
            time_start: "12:00"
            time_end: "12:45"
          - name: Condimentum Vitae Sapien Pellentesque
            time_start: "12:45"
            time_end: "13:30"

      - name: Room B
        talks:
          - name: Arcu Non Odio
            time_start: "12:00"
            time_end: "13:00"

Talks

Each talk is represented by a file in the _talks/ directory. It must begin with valid YAML Front Matter containing

  • the talk's name (used as identifier),
  • one or more existing speakers name(s),
  • optionally, a track which should match the tracks defined in the site's configuration,
  • optionally, a list of tags
  • optionally, a list of links (see the Links subsection below for the available properties):
    • Links with an icon are treated separately and are also included on the talk overview page.
    • Links with live: true are only shown below the live stream for the given talk in form of buttons.
  • optionally, lang with the talk's language (e.g. en) if it differs from the site's, so screen readers pronounce its title and description correctly,
  • optionally, hide: true if the talk's page should not be linked to (its page then only redirects to the home page).

Example:

---
name: Vim Impetus Placerat Cotidieque Ad
speakers:
  - Tolga Philip
track: Track A
tags:
  - Short
---

Speakers

Each speaker is represented by a file in the _speakers/ directory. It must begin with valid YAML Front Matter containing

  • the speaker's name (used as identifier), as well as its
  • first_name,
  • last_name,
  • optionally, a list of links (see the Links subsection below for the available properties):
    • Links with an icon are treated separately and are also included on the speaker overview page.
  • optionally, hide: true if the speaker's page should not be linked to.

If the speaker's name consists of only one word, populate the last_name property and leave the first_name property empty. The last name is generally used for sorting the speakers.

Example:

---
name: Tolga Philip
first_name: Tolga
last_name: Philip
links:
  - name: Profile
    absolute_url: https://github.com
---

Rooms

Each room is represented by a file in the _rooms/ directory. It must begin with valid YAML Front Matter containing

  • the room's name
  • optionally, hide: true if the room's page should not be linked to,
  • optionally, its position (order, a number) where rooms are listed outside the program, otherwise rooms follow their first appearance in the program, and
  • optionally under the live property, a URL pointing to a live stream for the given room during the conference (see the section Configuration > Live Indications & Streaming above), either:
    • as an absolute_url, or
    • a relative_url.

Example:

---
name: The Room
hide: false
live:
  absolute_url: https://github.com
---

Links

Links are used at different locations throughout the theme: They can either be used in the configuration file (for the landing page, the navigation bar, info bars or modals), or in talks and for speakers. A link can thereby have the following properties:

  • the text to show (name),
  • the link address:
    • relative to the site's base address: relative_url:,
    • as an absolute address: absolute_url:,
    • pointing to a file uploaded to the /documents folder: file:, or
    • pointing to an external video: video:.
  • optionally, if it is disabled (disabled: true),
  • optionally, if it should open in an iframe embedded in a popup-like modal (iframe: true),
  • optionally, for links opening in the modal, if the content is loaded right away (click_to_load: false, e.g. for self-hosted videos) instead of once the visitor clicks a button, as the provider receives the visitor's IP address, and
  • optionally, an icon to show in front of the title (icon: followed by the Bootstrap Icons icon name to show, see Icons).

Using the file: indicator, the

  • link address is set to
    • the site's base address followed by /documents/slides and the value for talks,
    • the site's base address followed by /documents/bio and the value for speakers, or
    • the site's base address followed by /documents and the value for all remaining types.
    • With several editions, the edition's id precedes /documents, e.g. /2026/documents/slides.
  • the link's icon: is set to file-earmark-text.

Using the video: indicator, the

  • link address is set to an absolute address as given by the value.
  • the link's iframe: attribute is set to true to embed the video in a popup-like modal having a default iframe ratio of 24:11.
  • the link's icon: is set to camera-video-fill.

Additionally, a talk link can also have the following property:

  • live: true whereby the link is only shown below the live stream for the given talk in form of buttons.

Additionally, a navigation bar, main landing page, info bar or info modal link can also have the following properties:

  • live: true making the link only visible during the conference and adds a live indication.
    • The link is only shown if name is set. If name is an empty string, "Live Stream" is shown instead.
    • If name_inactive is set, its value is used as a placeholder text while the conference is not live. If name_inactive is an empty string, "Live Stream" is shown instead.
    • If streaming is enabled and any URL property is omitted, a click on the link will open the streaming modal (see section Configuration > Live Indications & Streaming above).
  • menu containing another list of links. This creates a dropdown menu of multiple sublinks, while the URL of the parent link is ignored. The sublinks have the same properties as regular links.
    • With menu: editions, the dropdown menu lists the editions instead. Without name, it is labelled with navigation.editions.name, else the page's edition. It is not shown with a single edition.

Pages

The overviews of talks and speakers, the location with its rooms, and the program as a time schedule each have a dedicated layout. Simply create a page and associate the corresponding layout with it:

  • talks/index.md with layout: talk-overview
  • speakers/index.md with layout: speaker-overview
  • location/index.md with layout: location
  • program/index.md with layout: program

They can be empty but should contain the layout property in the Front Matter header.

Additional static pages can easily be added as files and linked to via navigation bar or main landing page.

Design

The design is based on Bootstrap 5 and is highly customizable. It integrates Bootstrap Icons (see Icons) and Leaflet for mapping. The theme also features automatic dark mode, adapting to user system preferences.

The theme offers three distinct approaches to Bootstrap integration, allowing you to choose the level of customization that suits your needs:

Pre-compiled Bundle (Default)

This is the default option and requires no setup. As the Bootstrap framework is pre-compiled, direct modifications to its core (e.g., theme colors) are not possible. However, you can add custom styles to assets/css/main.scss; these will be loaded last and override existing styles.

conference:
  custom_style: "none"  # or omit this line (default)

The assets/css/ directory contains:

  • conference.bundle.css: Complete bundle containing:
    • Pre-compiled Bootstrap 5 framework
    • Conference theme customizations
  • map.bundle.css: Leaflet map styles, loaded together with the map
  • main.scss: For user-modifiable custom styles.

Including assets/css/main.scss in your project is optional. If included, it must begin with a Front Matter header for Jekyll recognition:

---
---

// Custom styles
// ...

Split Bundle (Custom Bootstrap CSS)

Integrate your own Bootstrap file, such as a theme from Bootswatch. Similar to the default option, assets/css/main.scss can be used for additional custom styles, which will override previous styles.

conference:
  custom_style: "bootstrap"

The assets/css/ directory contains:

  • bootstrap.min.css: Your custom Bootstrap framework (user-provided).
  • conference-only.bundle.css: Conference theme customizations
  • map.bundle.css: Leaflet map styles, loaded together with the map
  • main.scss: For additional custom styles.

Including assets/css/main.scss in your project is optional. If included, it must begin with a Front Matter header for Jekyll recognition:

---
---

// Custom styles
// ...

Full Custom Build (Custom SCSS)

Compile your Bootstrap framework by modifying Bootstrap variables. This provides complete control over Bootstrap's SCSS variables, enabling source-level customization.

The theme simplifies this by including all Bootstrap SCSS source files. These are located in the Gem's _sass folder and are automatically overlaid with your project's _sass folder.

While offering the most flexibility, this setup requires several steps:

  1. Configure Jekyll's SASS compiler in _config.yml. Ensure sass_dir is either unset (using the default) or points to the _sass folder. Output compression is recommended.
    sass:
        sass_dir: _sass    # or omit this line
        style: compressed
  2. Configure the theme to use the full custom style setup:
    conference:
     custom_style: "full"
  3. Create _sass/bootstrap-variables.scss to override Bootstrap variables.
    // If needed, include Bootstrap functions first
    @use "bootstrap/functions" as *;
    
    // Override Bootstrap variables
    $green: #4ea93f;
    $primary: $green;
  4. Include the compiled conference bundle, incorporating your Bootstrap modifications, in assets/css/main.scss:
    ---
    ---
    
    @use "conference";
    
    // Custom styles
    // ...

Styling Hooks

Talks, speakers, rooms and the recurring parts of pages carry a class of their own wherever they are shown (program, overviews, talk, speaker and room pages, video and live stream modals). Use them to style these elements in assets/css/main.scss without depending on the Bootstrap classes of the markup:

Class Element
Talks
talk-list List of talks in the talk overview or on a speaker or room page (contains one talk-item per talk)
talk-item Talk in such a list
talk-title Title of a talk
talk-speakers Speakers of a talk (contains one speaker-name per speaker)
talk-info Time, room and duration of a talk (contains talk-time, room-name and talk-duration)
talk-time Start time of a talk
talk-duration Duration of a talk
track-name Name of a track
talk-tag Tag of a talk
Speakers and rooms
speaker-name Name of a speaker
room-name Name of a room
Pages
home-header Header box of the home page
page-label Label above the title of a speaker page (Speaker)
links-icon, links-more List of links at the end of a talk or speaker page: with an icon (files and videos), or further links (below More information)
link-item Link in such a list
back-link Link back to the overview or program at the end of a talk or speaker page
consent-button Button to load an external map or video

For example, to set speakers in italics:

.talk-speakers,
.speaker-name {
  font-style: italic;
}

Icons

The theme shows Bootstrap Icons as inline SVG images, rendered when the site is built: only the icons in use are part of a page, without loading an icon font. Any icon name can be used for links and tags (e.g. icon: camera-video-off-fill); unknown names show no icon. In your own pages and layouts, include an icon with

{% include icon.html name="geo-alt" class="me-1" %}

To use the icon font in your own content or JavaScript instead (e.g. <i class="bi bi-train-front"></i>), add it to your assets/css/main.scss:

@use "bootstrap-icons/font/bootstrap-icons" with (
  $bootstrap-icons-font-dir: "../webfonts"
);

Custom JavaScript

The theme includes a pre-built JavaScript bundle (assets/js/conference.bundle.js). This bundle is automatically included in the theme gem, pre-compiled, and minified, requiring no build tools for end users. Please do not modify this file directly.

To add custom JavaScript, edit the assets/js/main.js file in your project. This file loads after the conference bundle, giving you full access to all theme functionality.

Available Global Objects:

  • window.conference: Main conference object with the following modules:
    • conference.program: Program days as tabs
    • conference.map: Map functionality (getMap() resolves once the map is loaded, or with null without map)
    • conference.modal: Links (e.g. videos) in a modal
    • conference.embed: Embedded streams on the stream overview page
    • conference.live: Live indications following the program (incl. setTime("09:30", "2026-02-20"), getTime(), pauseTime(), continueTime(), resetTime() for testing)
    • conference.nowline: Line at the current time in the program
    • conference.stream: Live stream modal
    • conference.infobox: Dismissal of information boxes and modals
    • conference.darkmode: Dark mode according to the system preference
    • conference.pwa: Service worker registration and install banner (if PWA is enabled)
    • conference.config: Settings of the modules, e.g. conference.config.baseurl, conference.config.edition (the page's edition id, null without editions) and conference.config.edition_current
    • conference.awaitReady(): Promise-based initialization helper
  • window.bootstrap: Bootstrap components (Alert, Collapse, Dropdown, Modal, Offcanvas, Tab)
  • window.L: Leaflet map library (once the map is loaded)

Example Usage:

// Wait for conference to initialize
window.conference.awaitReady().then(async () => {
    // Access the map (returns a promise)
    const map = await window.conference.map.getMap();
    if (map) {
        // Add custom map markers
        L.marker([47.37785, 8.54035]).addTo(map);
    }

    // Custom program interactions
    // ...
});

Development

Jekyll Theme Development

If you want to modify this theme and see its changes on an existing project, simply indicate in your Gemfile that you want to use the local copy of the theme by adding a path indication after the gem instantiation:

group :jekyll_plugins do
  gem "jekyll-theme-conference", path: "../[path to your local theme]"
end

JavaScript & CSS Development

The theme's JavaScript and CSS are built using Vite. Source files are located in:

JavaScript (_js/ directory):

_js/
├── main.js            # Main entry point, list of modules
├── init.js            # Reads the inline configuration, initializes the modules
├── core/
│   ├── clock.js       # Current (or test) time
│   ├── conference.js  # Core conference object
│   ├── consent.js     # Consent before loading embedded content
│   └── time.js        # Timezone helpers
└── modules/
    ├── darkmode.js    # Colour mode following the system
    ├── embed.js       # Embedded streams (stream overview)
    ├── infobox.js     # Dismissal of information boxes
    ├── live.js        # Live indications
    ├── map.js         # Map functionality
    ├── modal.js       # Links in a modal
    ├── nowline.js     # Line at the current time in the program
    ├── program.js     # Program days as tabs
    ├── pwa.js         # Service worker registration, install banner
    └── stream.js      # Live stream modal

CSS/SCSS (_css/ directory):

_css/
├── main.scss                 # Main entry point (with Bootstrap)
├── main-only.scss            # Alternative entry point (without Bootstrap)
├── map.scss                  # Leaflet styles (loaded with the map)
├── bootstrap.scss            # Adapted Bootstrap Framework
├── bootstrap-variables.scss  # Placeholder for custom build of Bootstrap Framework
└── theme.scss                # Conference-specific styles

The CSS source imports libraries from npm:

  • bootstrap - Bootstrap framework
  • bootstrap-icons - Bootstrap Icons
  • leaflet and plugins - Map styles

To modify the theme's source code and rebuild:

  1. Install dependencies:

    npm install
  2. Build the bundles:

    npm run build

    This compiles:

    • _js/ → assets/js/conference.bundle.js
    • _css/ → assets/css/conference.bundle.css, assets/css/conference-only.bundle.css and assets/css/map.bundle.css

    This generates:

    • _includes/icons/: one include per Bootstrap Icon (inline SVG)
    • _data/conference_assets.yml: content hashes of the bundles (cache busting)

    This copies:

    • _css/ + any SASS file from the different framework libraries → _sass
    • Webfonts → assets/webfonts/ (for sites using the icon font themselves)
  3. Test your changes locally:

    bundle exec jekyll serve

Tests

The tests build the example site in test/fixture/ (containing edge cases such as quotes and markup in names, overnight talks, hidden entries, live streams, PWA and a map) and the site with two editions in test/fixture-editions/, and run on every pull request:

npm run build                         # theme bundles
(cd test/fixture && bundle install)   # once
npm test                              # generated JSON, structured data, timestamps, escaping, program options, style setups
npx playwright install chromium       # once
npm run test:e2e                      # in a browser: modules, live stream, map, offline PWA, dark mode, info boxes
uv run --no-project --with-requirements _tools/requirements.txt python -m unittest discover test/tools

Run a single test with e.g. node --test --test-name-pattern="site.json" test/build.test.js or npx playwright test test/e2e/map.spec.js. Set SKIP_BUILD=1 to reuse the last build in browser tests.

License

This project is licensed under the MIT License. You can view LICENSE.md for more details.

About

Jekyll template for a conference website containing program, speaker, talks and room overview

Topics

Resources

Stars

95 stars

Watchers

5 watching

Forks

Releases

Used by

Contributors

Languages