Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Template-Texte übersetzen

Wie Texte in Templates zu Übersetzern und zurück gelangen - Kontexte und Quellen in i18n-Aufrufen, translation.ts-Dateien in der Theme-Erweiterung, TranslationExtensions, die Kataloge untranslated und Englisch, die…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/designers/templates/translating-template-strings.md

On this page

This page is a translation. Read the English original

Template-Texte übersetzen

Diese Seite ist für Designer, die die Texte eines Themes für die Übersetzung vorbereiten und die Übersetzungen pflegen. Für das erste Mal Schritt für Schritt siehe Tutorial: ein Theme internationalisieren.

Inhalt

  1. Vom Template zur Übersetzung
  2. Wo Übersetzungen von Themes liegen
  3. Gute Quelltexte schreiben
  4. Prüfen und Caches
  5. Rückfälle

Vom Template zur Übersetzung

  1. Ein Template gibt {'Read more'|i18n( 'design/mytheme/line' )} aus.
  2. Die Übersetzungsdatei der Locale hat einen <context> namens design/mytheme/line mit einer <message>, deren <source> genau Read more ist.
  3. Ihre <translation> wird angezeigt; ohne sie wird der Quelltext angezeigt.

Wo Übersetzungen von Themes liegen

extension/mytheme/translations/ger-DE/translation.ts
extension/mytheme/translations/fre-FR/translation.ts
extension/mytheme/translations/untranslated/translation.ts   (optional: every source, empty translations, for translators)

Der Siteaccess liest sie, wenn site.ini [RegionalSettings] TranslationExtensions[] die Erweiterung auflistet. Das Theme media liefert elf Kataloge in dieser Struktur mit; das Theme starter liefert ger-DE. Siehe Übersetzungen in einem Theme.

Gute Quelltexte schreiben

  • Ganze Sätze mit Platzhaltern, nie Bruchstücke, die im Template zusammengefügt werden.
  • Eine Bedeutung pro Kontext: „Open“ (ein Verb auf einer Schaltfläche) und „Open“ (ein Zustand) in verschiedenen Kontexten.
  • Ein Kommentar für Übersetzer, wenn der Text mehrdeutig ist (der zweite Parameter von i18n).
  • Quelltexte in amerikanischem Englisch („color“, „license“), wie im Rest des Produkts.

Prüfen und Caches

./console exp:ezchecktranslation ger-DE          # statistics for one translation
php bin/php/ezcache.php --clear-id=translation   # after changing a .ts file
xmllint --noout extension/mytheme/translations/ger-DE/translation.ts

site.ini [RegionalSettings] TranslationCache=enabled cacht Übersetzungen; TranslationCheckMTime=enabled (Standard) bemerkt geänderte .ts-Dateien an ihrer Zeit.

Rückfälle

Eine Locale kann bei fehlenden Texten auf eine andere zurückfallen (zum Beispiel eine regionale Variante auf die Hauptsprache); ./console exp:i18n fallbacks zeigt die Kette jeder Locale und wie viel vom Kernel und von jeder Erweiterung sie übersetzt zeigt (doc/eng-us/languages.md, „Translation fallbacks“).

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x