Languages, URLs and Parameters¶

Ekit allows you to build monolingual or multilingual websites without duplicating templates.
The displayed language, page, and content are automatically determined from the URL.

This document explains the URL model, language handling, and content parameters used by Ekit.

URL structure¶

Ekit uses a clean and SEO-friendly routing system based on path segments.

/[lang]/[view]/[slug]?param=value

lang (optional): language code (en, fr, de, …)
view: page name (template)
slug (optional): identifies a specific record
param=value (optional): query parameters for filtering or dynamic behavior

Examples¶

/
/fr
/en/blog
/fr/blog/my-article
/blog/my-article
/fr/blog/my-article?preview=true

URLs always start with a leading /.
This keeps routes explicit, predictable, and aligned with standard web routing conventions.

Routing rules¶

The language segment is optional
If present, the first segment defines the active language
The first page segment maps to the current view
If no view is present, index is used by default
The second page segment is used as the slug
Query parameters are optional and used for filtering or additional behavior

Route resolution¶

Example URL:

/fr/blog/my-article

Resolved parameters:

params = { lang: "fr", view: "blog", slug: "my-article" }

Language detection¶

The language is automatically inferred from the first URL segment.

If the first segment matches a configured language → it is used
Otherwise → the project’s default language is applied

This allows: - monolingual projects without configuration - shared templates across multiple languages

Language examples¶

URL	Language	View	Slug
/fr/blog	fr	blog	—
/de/blog/post	de	blog	post
/blog/post	defaultLang	blog	post
/	defaultLang	index	—

Unknown language codes¶

If an unknown language is used:

/it/blog

Ekit will:

fall back to the default language
treat it as a normal segment if needed

The `<base>` tag in the layout (recommended)¶

To ensure correct navigation between pages and languages, define a base URL in your layout.

In layouts/layout.hbs, inside the <head> section:

This guarantees consistent navigation and prevents malformed URLs when mixing relative and root-relative links.

Linking pages and languages¶

Always use root-relative links (starting with /).

Language switcher example¶

<ul>
  <li><a href="/en/">EN</a></li>
  <li><a href="/fr/">FR</a></li>
  <li><a href="/de/">DE</a></li>
</ul>

Linking to a page¶

<a href="/fr/blog">Blog (FR)</a>
<a href="/en/blog">Blog (EN)</a>

Linking to a specific content (slug)¶

<a href="/fr/blog/my-article">Article</a>

URL parameters (query string)¶

Query parameters can be used for filtering or dynamic behavior.

/blog?category=news
/blog/my-article?preview=true

They are available in templates via the query object.

Handlebars example¶

<p>Category: {{query.category}}</p>

Recommended pattern: slug-based content¶

Ekit uses slug-based routing as the primary way to identify content.

Example:

/fr/blog/my-article

In your datasource:

datasources:
  article:
    from: blog
    slug: "{{params.slug}}"

UID support (optional)¶

You can still use a uid when needed (internal or legacy usage).

datasources: article: from: blog uid: "{{query.uid}}"