Skip to content
Starlight View Modes

Internationalization (i18n)

Internationalization (i18n)

Learn how to configure your website with view modes to support multiple languages.

Starlight View Modes relies on Starlight’s built-in support for internationalization to provide multilingual support. Follow the Starlight “Configure i18n” guide and the Starlight View Modes plugin will automatically create your internationalized routes and pages.

Translate the view modes UI1/3

The Starlight View Modes plugin allows you to translate the default UI strings used in the view modes so that your website can be fully localized and readers can enjoy a seamless experience in their preferred language.

Chinese (China), English, French, German, Italian, Korean, Portuguese, Russian, and Spanish translated UI strings are provided out of the box.

Translate the view modes UI2/3

To provide translations for additional languages you support — or override the default ones — check the “Translate Starlight’s UI” guide in the Starlight documentation.

These are the English defaults of the existing strings Starlight View Modes ships with:

Translate the view modes UI3/3

{
  "starlightViewModes.switchesHeading": "View Modes",
  "starlightViewModes.defaultMode.title": "Normal Mode",
  "starlightViewModes.zenMode.title": "Zen Mode",
  "starlightViewModes.switchToDefaultMode": "Switch to normal mode",
  "starlightViewModes.switchToZenMode": "Switch to Zen Mode",
  "starlightViewModes.presentationMode.title": "Presentation Mode",
  "starlightViewModes.switchToPresentationMode": "Switch to Presentation Mode",
  "starlightViewModes.presentationMode.upNext": "Up next",
  "starlightViewModes.presentationMode.speakerView": "Speaker view",
  "starlightViewModes.presentationMode.fullscreen": "Toggle fullscreen",
  "starlightViewModes.presentationMode.print": "Export as PDF",
  "starlightViewModes.presentationMode.controls": "Presentation controls",
  "starlightViewModes.presentationMode.contents": "Contents",
  "starlightViewModes.presentationMode.jumpToSlide": "Jump to slide",
  "starlightViewModes.presentationMode.close": "Close",
  "starlightViewModes.presentationMode.breadcrumbs": "Breadcrumbs"
}
Switch to normal mode

Contents