Übersetzung
Neleto hat eingebaute Unterstützung für mehrsprachige Websites. Übersetzungen funktionieren auf zwei Ebenen:
- Website-Sprachen - Konfiguriere, welche Sprachen deine Website unterstützt, und lege eine Standardsprache fest.
- Ü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 einemlabel(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"
}