Page Comparison

Dokumentationen/Links

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

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

Variable Texte übersetzen (ICU Message format): https://symfony.com/doc/current/translation/message_format.html

Befehle

Anzeigen der Hilfe zum Symfony-Übersetzungstool

...

Auflistung der zur Übersetzung anstehenden Textstellen (exportiert nicht, sondern listet nur auf..)

./psh.phar docker:ssh
cd htdocs_symfony/
php bin/console translation:update --dump-messages en

...

Markierung der zu übersetzenden Textstellen in Twigtemplates. Das erste Beispiel ist die zu bevorzugende Variante.

{{ '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 (einmalig)

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

Erstinitialisierung von crowdin (einmalig)

1. im lokalen git-Verzeichnis ausführen: crowdin init
   Die dabei abgefragte Project-ID ist in den Projekteigenschaften des Crowdin-Projekts zu finden

2. Anpassen der Datei /crowdin.yml
   Die wichtigsten Einstellungen sind "source" und "translation", zum Beispiel wie folgt

   Code Block
   files: [ { # # Source files filter # e.g. "/resources/en/*.json" # "source" : "/htdocs_symfony/translations/*.en.yml", # # Where translations will be placed # e.g. "/resources/%two_letters_code%/%original_file_name%" # "translation" : "/htdocs_symfony/translations/%original_file_name%.%two_letters_code%.yml", "translation_replace": { "messages+intl-icu.en.yml.": "messages+intl-icu." } .. ]

   
   

Export der zu übersetzenden Texte vom Server

1. im lokalen git-Verzeichnis ausführen:

   Code Block
   ./psh.phar docker:ssh

   
   

   cd htdocs_symfony/

   
   

   php bin/console translation:update --dump-messages --output-format=yml --force en exit

   
   

2. Die exportierten Texte finden sich nun in *.yml-Dateien im Pfad /htdocs_symony/translations wieder

...

Hochladen der zu übersetzenden Texte

...

nach Crowdin

1. im lokalen git-Verzeichnis ausführen: crowdin upload sources

Übersetzung und Validierung in Crowdin

1. ...
2. ...

...

1. übersetzen
2. validieren

Download der übersetzten Texte aus Crowdin

1. ...
2. ...im lokalen git-Verzeichnis ausführen: crowdin download

Import der übersetzten Texte auf den Server

1. Die Übersetzungen werden von Symfony 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.