Internationalization

Declare your languages with the locales option. Each key is both a content directory and a URL prefix, except root, which is the default language served without a prefix.

zenith({
  title: 'My Docs',
  locales: {
    root: { label: 'English' },
    fr: { label: 'Français' },
    ar: { label: 'العربية', dir: 'rtl' },
  },
});

Translations mirror the default language, one directory per locale:

index.mdx is served at /, and fr/index.mdx at /fr/.

Every page of the default language exists in every locale. When a translation is missing, the default content is shown at the translated URL, with a note telling the reader the page is not translated yet. Navigation stays complete, and no link ever breaks.

A locale also inherits the page order of the default language, so a meta.json only needs to be translated when you want different labels.

Labels like “On this page” or “Edit this page” ship translated for English, French, Spanish and German, picked from each locale’s lang. Override any string, or add a language, with the translations option:

zenith({
  locales: { root: { label: 'English' }, fr: { label: 'Français' } },
  translations: {
    fr: { 'toc.title': 'Sommaire' },
  },
});

Callout titles follow the language of the file, so :::warning renders as “Avertissement” in a French page.

Pagefind builds one index per language and searches the one matching the current page, so readers only get results in the language they are browsing.

llms.txt and llms-full.txt cover the default language. Each translated page has its own .md version, and an untranslated one points to the Markdown of the default language, which is the content it shows.