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
- Vom Template zur Übersetzung
- Wo Übersetzungen von Themes liegen
- Gute Quelltexte schreiben
- Prüfen und Caches
- Rückfälle
Vom Template zur Übersetzung
- Ein Template gibt
{'Read more'|i18n( 'design/mytheme/line' )}aus. - Die Übersetzungsdatei der Locale hat einen
<context>namensdesign/mytheme/linemit einer<message>, deren<source>genauRead moreist. - 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.tssite.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
- Der Operator i18n
- Sprachen in Exponential
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
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.