Übersetzung

Übersetze deine Webseite in mehrere Sprachen.

Neleto hat eingebaute Unterstützung für mehrsprachige Websites. Übersetzungen funktionieren auf zwei Ebenen:

  1. Website-Sprachen - Konfiguriere, welche Sprachen deine Website unterstützt, und lege eine Standardsprache fest.
  2. Übersetzungsstrings - Ein Schlüssel-Wert-Speicher für übersetzte Textfragmente, die du in Seiten- und Komponenten-Templates verwenden kannst.

1. Website-Sprachen konfigurieren

Navigiere zu Einstellungen und suche den Bereich Sprachen. Hier kannst du:

  • Eine Standardsprache festlegen - die Sprache, die verwendet wird, wenn keine andere Sprachpräferenz erkannt wird.
  • Weitere Sprachen hinzufügen - jeweils mit einem value (z. B. de) und einem label (z. B. Deutsch).
  • Beste Sprache automatisch erkennen aktivieren - wenn aktiv, wählt Neleto automatisch die passendste Sprache anhand des Accept-Language-Headers des Browsers des Besuchers aus.

2. Seiten übersetzen

Bei Seiten kann der Titel der Seite und die Beschreibung übersetzt werden, dafür stellst du die Sprache im Seiten-builder um und änderst dann das jeweilige Feld. Außerdem können Felder von Elementen mit den Typen textarea, richtext und markdown auf die selbe Weise übersetzt werden.

3. Übersetzungsstrings verwalten

Navigiere zu Entwicklertools -> Übersetzungen. Hier kannst du einen Schlüssel-Wert-Speicher mit übersetzten Strings verwalten, die in Handlebars-Templates referenziert werden können.

Jeder Übersetzungseintrag hat:

  • Einen Schlüssel - eine eindeutige Kennung, mit der der String im Template referenziert wird (z. B. nav.home). Dieser Schlüssel muss für eine Übersetzung bei allen Sprachen gleich sein.
  • Eine Sprache - die Sprache, für die dieser Wert gilt (muss einer konfigurierten Sprache entsprechen).
  • Einen Wert - den übersetzten Text.

So verwendest du einen Übersetzungsstring in einem Handlebars-Template:

{{ translation("nav.home") }}

Neleto schlägt die Übersetzung für die Sprache der aktuellen Seite zur Renderzeit nach. Wenn keine Übersetzung für die aktuelle Sprache gefunden wird, wird der Wert der Standardsprache als Fallback verwendet.

Du kannst Übersetzungen auch aus einer JSON-Datei importieren, indem du den Importieren-Button in der Übersetzungsansicht verwendest. Das erwartete Format ist ein flaches Objekt, bei dem Schlüssel den übersetzten Strings zugeordnet sind:

{
  "nav.home": "Startseite",
  "nav.about": "Über uns"
}