Repository navigation
This major release focuses on the visual language and long-term maintainability of the ELIXIR Toolkit Theme. It refreshes the news, events, navigation, related-page, More information, page metadata, supporter, callout, sidebar, and top navigation experiences, while tightening the upgrade path for sites that pin theme releases.
✨ Highlights
- News and events have a new visual design, with news rendered as a timeline and events rendered as clearer cards.
- Navigation and related-page tiles now share one card pattern, with stronger hover and arrow affordances.
- The More information section has been restyled into clearer collapsible lists with compact source logos.
- Page metadata now uses the Supported by wording instead of "Affiliations", with backwards compatibility for existing sites.
- Callouts can now be written directly in Markdown blockquote syntax, including custom titles and nested callouts.
- Theme UI icons have moved to the Lucide static icon font, while Font Awesome remains available for brands and existing authored content.
- Sidebar items can now define icons, and the top navigation has more consistent active, hover, dropdown, and mobile states.
- New versioning, upgrade, and safe customization documentation gives site maintainers a clearer release workflow.
Screenshots
News and Events
News redesign before and after:
Events redesign before and after:
Navigation
Sidebar icon support + improved top-nav UX
Section navigation tiles look more clickable + better hover state, before and after:
Content Blocks
New callouts syntax + support for titles, before and after:
Also nested callouts are supported now
More information now has a coherent list-like design, before and after:
Supported by instead of affiliations + new icon pack
🔧 Improvements
- Added a
limitoption for news items and documented the equivalent event listing options. - Added natural sorting for section navigation tiles, making numbered and mixed-case page titles sort more predictably.
- Added compact supporter-name hover states and optional type filtering/sorting for supporter overview tiles.
- Added SVG logo sizing guidance for supporter tiles.
- Improved resource, training, contributor, page metadata, and badge icon alignment.
- Polished documentation and example page structures so the demo site better reflects recommended usage.
- Updated known ELIXIR Toolkit Theme instances with the ELIXIR-GOBLET Train-the-Trainer website.
🐛 Bug fixes and robustness
- Fixed an unclosed list item in the sidebar include.
- Fixed mobile top navigation dropdown toggles so the toggle target uses the full available width.
- Fixed active and hover styling in the top navigation and sidebar.
- Fixed social icon centering on contributor cards.
- Removed extra "about" text from training listings.
🚨 Breaking changes 🚨
Sass variables for news and events
The old news/event variables have been renamed:
$news-title-bg
$news-border-color
$news-title-colorReplace them with:
$news-accent-color
$news-timeline-colorUpdate any custom Sass overrides that still use the old names.
More information Sass variables
The following obsolete More information tile variables have been removed:
$info-card-bg
$info-card-color
$info-card-bg-hover
$info-card-color-hoverThese variables no longer affect the current More information styling. Remove them from custom Sass overrides.
FAIRsharing metadata
The deprecated fairsharing-coll key has been removed. Use the fairsharing key with the DOI suffix format instead.
Example:
fairsharing: c55d5eFlag icons
The vendored flag icon assets have been updated to flag-icons 7.5.0. Custom templates or content that use flag classes directly must update from the old flag-icon* naming to the new fi* naming:
<span class="fi fi-be"></span>The flag SVG files are now organised under assets/flags/4x3/ and assets/flags/1x1/. Theme includes have been updated, but custom overrides should be checked.
Lucide icons
Theme UI icons now use the Lucide static icon font and icon-* classes, for example icon-chevron-right or icon-calendar. Font Awesome remains loaded for brand icons and existing authored content, but custom copied includes or custom CSS that target old Font Awesome UI icons should be reviewed. See the icons documentation for the supported authoring pattern.
⚠️ Deprecated ⚠️
The old "Affiliations" terminology remains backwards compatible in ETT v7, but is deprecated and will be removed in ETT v8.0.0. See the Supported by documentation for the new data file, page metadata, and includes.
Before upgrading to ETT v8, migrate:
affiliationspage metadata tosupported_by._data/affiliations.ymlto_data/supported_by.yml.affiliation-tiles-selection.htmltosupported-by-tiles-selection.html.affiliations=truetosupported_by=truein section navigation includes.affiliations_sorttosupported_by_sortin theme configuration.- Custom
affiliation-*CSS hooks or include overrides to theirsupported-by-*equivalents.
Contributor-level affiliation fields and schema.org affiliation metadata are unaffected.
🌀 Migration notes
- Pin the site to
7.0.0and update the siteGemfilefrom the7.0.0release tag. See Versions and upgrades. - Review local copies of theme includes, especially
topnav.html,sidebar.html,news.html,events.html,more-information-tiles.html,section-navigation-tiles.html, and page metadata/supporter includes. See Safe customization and overrides. - Replace removed or renamed Sass variables in
_sass/_custom_variables.scss. See Custom branding. - Replace direct
flag-icon*usage withfi*classes. - Review custom icon usage and copied includes for the Lucide
icon-*class change. - Replace
fairsharing-colldata withfairsharing. - Start using Markdown callouts for new content:
{: .note }
> This is a note.The legacy {% include callout.html %} API remains supported.
📄 Full change list
- News and events include redesign by @bedroesb in #424
- Add 'limit' parameter to news description options by @bedroesb in #425
- Change to
Supported byinstead ofAffiliationsby @bedroesb in #427 - Adding ELIXIR-GOBLET Train-the-Trainer to known instances by @bedroesb in #430
- Updates Ruby gems and vendored front-end assets to latest by @bedroesb in #431
- Add backwards compatibility for
affiliation-tiles-selection.htmlby @bedroesb in #432 - Prioritize affiliations data over the supported-by fallback by @bedroesb in #433
- Fix unclosed list item in sidebar by @bedroesb in #438
- Add sidebar icon support and migrate theme UI icons to Lucide by @bedroesb in #439
- Add versioning and upgrade documentation by @bedroesb in #440
- Improve top navigation styling by @bedroesb in #442
- Make navbar dropdown toggle full width in mobile by @bedroesb in #444
- Use sort_natural for sorting section navigation tiles by @elichad in #449
- Remove
fairsharing-collsupport in favor offairsharingby @bedroesb in #450 - Remove extra "about" text from training listing by @bedroesb in #451
- Make navigation and related-page tiles feel more clickable by @bedroesb in #452
- Document SVG sizing guidance for supporter logos by @bedroesb in #457
- Remove obsolete More information tile Sass variables by @bedroesb in #458
- Polish documentation and example page structures by @bedroesb in #460
- Fix social icon centering by @bedroesb in #465
Full Changelog: 6.1.0...7.0.0