https://wiki.opencaching.de/index.php?action=history&feed=atom&title=Translation_Handling_%28OC4%29Translation Handling (OC4) - Versionsgeschichte2026-05-09T09:21:33ZVersionsgeschichte dieser Seite in Opencaching-WikiMediaWiki 1.41.0https://wiki.opencaching.de/index.php?title=Translation_Handling_(OC4)&diff=7857&oldid=prevFraggle: Erstentwurf2024-05-06T18:33:25Z<p>Erstentwurf</p>
<p><b>Neue Seite</b></p><div>== Dokumentationen/Links ==<br />
* Crowdin Import-/Exporttool: support.crowdin.com/cli-tool<br />
* Symfony-Doku: https://symfony.com/doc/current/translation.html<br />
* Variable Texte übersetzen (ICU Message format): https://symfony.com/doc/current/translation/message_format.html<br />
<br />
<br />
== Befehle ==<br />
Anzeigen der Hilfe zum Symfony-Übersetzungstool<br />
./psh.phar docker:ssh<br />
cd htdocs_symfony/<br />
php bin/console translation:update --help<br />
<br />
Auflistung der zur Übersetzung anstehenden Textstellen (exportiert nicht, sondern listet nur auf..)<br />
./psh.phar docker:ssh<br />
cd htdocs_symfony/<br />
php bin/console translation:update --dump-messages en<br />
<br />
Markierung der zu übersetzenden Textstellen in Twigtemplates. Das erste Beispiel ist die zu bevorzugende Variante.<br />
<nowiki>{{{ 'The quick brown fox jumps over the lazy dog' | trans }}<br />
{% trans %}The quick brown fox jumps over the lazy dog{% endtrans %}</nowiki><br />
<br />
<br />
== HowTo: Ablauf für Export der Texte vom Server zu Crowdin und Re-Import der übersetzten Texte ==<br />
=== Lokale Installation von crowdin (einmalig) ===<br />
* siehe https://support.crowdin.com/cli-tool/#installation<br />
<br />
=== Erstinitialisierung von crowdin (einmalig) ===<br />
* im lokalen git-Verzeichnis ausführen: <code>crowdin init</code><br />
: Die dabei abgefragte Project-ID ist in den Projekteigenschaften des Crowdin-Projekts zu finden<br />
* Anpassen der Datei /crowdin.yml<br />
: Die wichtigsten Einstellungen sind "source" und "translation", zum Beispiel wie folgt<br />
<br />
<nowiki>files: [<br />
{<br />
#<br />
# Source files filter<br />
# e.g. "/resources/en/*.json"<br />
#<br />
"source" : "/htdocs_symfony/translations/*.en.yml",<br />
<br />
#<br />
# Where translations will be placed<br />
# e.g. "/resources/%two_letters_code%/%original_file_name%"<br />
#<br />
"translation" : "/htdocs_symfony/translations/%original_file_name%.%two_letters_code%.yml",<br />
"translation_replace": {<br />
"messages+intl-icu.en.yml.": "messages+intl-icu."<br />
}<br />
..<br />
]</nowiki><br />
<br />
<br />
=== Export der zu übersetzenden Texte vom Server ===<br />
im lokalen git-Verzeichnis ausführen:<br />
<nowiki>./psh.phar docker:ssh<br />
cd htdocs_symfony/<br />
php bin/console translation:update --dump-messages --output-format=yml --force en<br />
exit</nowiki><br />
<br />
Die exportierten Texte finden sich nun in <code>*.yml</code>-Dateien im Pfad <code>/htdocs_symony/translations</code> wieder<br />
<br />
=== Hochladen der zu übersetzenden Texte nach Crowdin ===<br />
im lokalen git-Verzeichnis ausführen: <code>crowdin upload sources</code><br />
<br />
=== Übersetzung und Validierung in Crowdin ===<br />
# In crowdin einloggen und noch nicht übersetzte Texte übersetzen<br />
# In crowdin einloggen und übersetzte Texte validieren<br />
<br />
=== Download der übersetzten Texte aus Crowdin ===<br />
im lokalen git-Verzeichnis ausführen: <code>crowdin download</code><br />
<br />
=== Import der übersetzten Texte auf den Server ===<br />
Die Übersetzungen werden von Symfony automatisch genutzt, je nach eingestellter %locale% Variable<br />
Behelfsweise kann %locale% auf eine andere Sprache umgestellt werden, indem der Wert 'default_locale' in der Datei <code>/htdocs_symfony/config/packages/translation.php</code> von 'en' auf z.B. 'de' umgestellt wird.<br />
<br />
<br />
<br />
[[Kategorie:Entwicklung]]<br />
[[Kategorie:English pages]]</div>Fraggle