Skip to aside Skip to content Skip to footer

Events

Examples

Past events

Use this snippet:

{% include events.html event_type="past_event" col=2 %}

This renders as:

  • Documentation sprint

    Online

    An upcoming event with a longer description, related page metadata and enough text to exercise the collapsed description pattern.

    Sessions include:

    • improving page metadata for generated tiles
    • reviewing contributor and supporter displays
    • checking event cards on mobile and desktop layouts
    • linking the event to a relevant example page

    The event is intentionally scheduled in the future so the upcoming events example has stable content to display.

  • Theme maintenance clinic

    Online

    A short past event used to verify date ranges, time display and online locations.

  • Past community workshop

    Barcelona, Spain

    A past event with an internal link in the description.

Upcoming events with title, caption and truncation

Use this snippet:

{% include events.html caption=true title=true event_type="upcoming_event" caption_url="/events" truncate=true limit=3 %}

This renders as:

Upcoming events

  • Documentation sprint

    Online

    An upcoming event with a longer description, related page metadata and enough text to exercise the collapsed description pattern.

    Sessions include:

    • improving page metadata for generated tiles
    • reviewing contributor and supporter displays
    • checking event cards on mobile and desktop layouts
    • linking the event to a relevant example page

    The event is intentionally scheduled in the future so the upcoming events example has stable content to display.

  • Theme maintenance clinic

    Online

    A short past event used to verify date ranges, time display and online locations.

  • Past community workshop

    Barcelona, Spain

    A past event with an internal link in the description.

An overview of all our events can be found on the events page.

Parameters

  • event_type: Required. Use upcoming_event or past_event.
  • title: Show the event type as a heading when matching events are present (true or false).
  • caption: Show the “An overview of all our events can be found on the events page.” caption (true or false).
  • caption_url: Use a custom URL when the main events page is not served at /events.
  • truncate: Collapse descriptions longer than 40 words behind a button (true or false).
  • limit: Limit the number of event items shown.
  • col: Set the number of event columns from the medium breakpoint upwards. Defaults to 1; use col=2 for a two-column layout.
  • related_pages: Show only events tagged with a page_id. Add the same ID to each event’s related_pages list in _data/events.yml.

Use this snippet:

{% include events.html event_type="upcoming_event" related_pages="gp5" %}

This renders as:

  • Documentation sprint

    Online

    An upcoming event with a longer description, related page metadata and enough text to exercise the collapsed description pattern.

    Sessions include:

    • improving page metadata for generated tiles
    • reviewing contributor and supporter displays
    • checking event cards on mobile and desktop layouts
    • linking the event to a relevant example page

    The event is intentionally scheduled in the future so the upcoming events example has stable content to display.