Translation Handling (OC4)

Dokumentationen

Crowdin Import-/Exporttool: support.crowdin.com/cli-tool

Symfony-Doku: https://symfony.com/doc/current/translation.html

Befehle

Anzeigen der Hilfe zum Symfony-Übersetzungstool

./psh.phar docker:ssh
cd htdocs_symfony/
php bin/console translation:update --help

Auflistung der zur Übersetzung anstehenden Textstellen

php bin/console translation:update --dump-messages en

Markierung der zu übersetzenden Textstellen in Twigtemplates

{{ The quick brown fox jumps over the lazy dog | trans }}

Alternativ funktioniert auch dieses Beispiel, vorzuziehen ist aber das obere

{% trans %}The quick brown fox jumps over the lazy dog{% endtrans %}

HowTo: Ablauf für Export der Texte vom Server zu Crowdin und Re-Import der übersetzten Texte

Lokale Installation von crowdin

1. siehe https://support.crowdin.com/cli-tool/#installation

Export der zu übersetzenden Texte vom Server

1. im lokalen git-Verzeichnis ausführen:
   ./psh.phar docker:ssh
   cd htdocs_symfony/
   php bin/console translation:update --dump-messages --output-format=yml --force en
2. Die exportierten Texte finden sich nun in *.yml-Dateien im Pfad /htdocs_symony/translations wieder

Hochladen der zu übersetzenden Texte nach Crowding

1. im lokalen Projektverzeichnis ausführen: crowdin upload sources
2. ...?

Übersetzung und Validierung in Crowdin

1. übersetzen
2. validieren
3. ..?

Download der übersetzten Texte aus Crowdin

1. im lokalen Projektverzeichnis ausführen: crowdin download
2. ...?

Import der übersetzten Texte auf den Server

1. Die Überwetzungen werden automatisch genutzt, je nach eingestellter %locale% Variable
2. Behelfsweise kann %locale% auf eine andere Sprache umgestellt werden, indem der Wert 'default_locale' in der Datei /htdocs_symfony/config/packages/translation.php von 'en' auf z.B. 'de' umgestellt wird.