AGENTS.md

Commands

bundle exec jekyll serve    # Run dev server at localhost:4000
bundle exec jekyll build    # Build to _site/

Architecture

This is a Jekyll static site for Usetix marketing. Key patterns:

Multilingual (EN/DE): Language determined by URL path (/ = English, /de/ = German). Pages use ref in front matter to link translations. Translation strings live in _data/strings.yml (EN) and _data/strings_de.yml (DE). Layouts access translations via site.data.strings.en or site.data.strings_de.de.

Layout inheritance: All layouts extend base.html which provides HTML document structure plus head.html, header.html, footer.html includes. Child layouts (default, home, post, blog) declare layout: base in front matter.

CSS layers: Uses vanilla CSS with @layer for specificity control. Import order in assets/css/main.css: reset → base → components → modules → utilities.

Blog posts: English in _posts/, German in de/_posts/. Front matter defaults in _config.yml auto-assign language and layout based on path.