Crowdin Scripts/de

Verwalten von Übersetzungen für FreeCAD
FreeCAD nutzt den Übersetzungsdienst Crowdin um Übesetzungen zu verwalten.

Es gibt 3 Skripten in  die zur Verwaltung von Übersetzungsdateien verwendet werden:
 * 1)   (github source)
 * 2)   (github source)
 * 3)   (github source)

Hinweise

 * Diese Skripten werden im -Wurzelverzeichnis ausgeführt.
 * Damit diese Skripte funktionieren, muss der gültige FreeCAD crowdin API-Schlüssel in der Datei  enthalten sein. (aus Sicherheitsgründen steht dieser nur Personen mit Administrationsrechten im FreeCAD crowdin-Projekt zur Verfügung)
 * Aktuell sind diese Werkzeuge Python2 - kompatibel.

updatets.py
Das  Skript erzeugt '.ts'-Dateien (Qt Translation Source Files) in Deinem lokalen  -Verzeichnis.

Es ist eingebunden in:

updatecrowdin.py
Das  Skript schiebt Änderungen aus Deinem lokalen  -Verzeichnis zu crowdin (3rd party translation crowdsource translation service). Das Skript unterstützt aktuell 4 Argumente:


 * gibt den Status der Übersetzungen aus;
 * aktualisiert in crowdin die aktuelle Version der '.ts'-Dateien, die im Quellcode gefunden werden;
 * erstellt ein neues Downloadpacket auf crowdin mit allen übersetzten Begriffen (Strings);
 * holt das neueste Packet (build) ab;

updatefromcrowdin.py
Das  Skript schiebt Änderungen aus crowdin auf Dein lokales  -Verzeichnis.

Um die neuesten Begriffe (strings) nach crowdin zu senden

 * Only tested on linux
 * You need a .credentials file in your /home/YourUser directory. That file is a simple text file containing only one line, which is the API key that you get on https://crowdin.com/project/freecad/settings#api (only for admins)
 * Make sure your repository is clean (git pull, git stash if needed)
 * cd /path/to/freecad-source-code/src/Tools
 * python updatets.py (will fill all the .ts files found in the source with the lastest strings)
 * python updatecrowdin.py update (will send the ts files to crowdin. Crowdin will only update strings that are new)
 * cd ../.. (go back to the source code root folder)
 * git checkout . (undo all the changes to the .ts files, no reason to commit them right now as they are still untranslated)

To merge latest translations from crowdin

 * Only tested on linux
 * You need a .credentials file in your /home/YourUser directory. That file is a simple text file containing only one line, which is the API key that you get on https://crowdin.com/project/freecad/settings#api (only for admins)
 * Make sure your repository is clean (git pull, git stash if needed)
 * cd /path/to/freecad-source-code/src/Tools
 * python updatecrowdin.py build (will create a zip on crowdin side with all the files, can take a while.. This step can also be done on the crowdin website)
 * python updatecrowdin.py download (will download a freecad.zip file in this directory)
 * mv freecad.zip ~ move the zip file to your home dir, to avoid accidentally committing it later)
 * (optional) edit updatefromcrowdin.py script and check that the default_languages contain all the ones you want (basically all that are at more than 50%)
 * python updatefromcrowdin.py -z /home/YourUser/freecad.zip
 * cd ../.. (go back to the source code root folder)
 * if something went wrong or you are unsure, clean everything with git checkout.
 * if everything looks ok (git status), commit with git add . && git commit
 * Create a PR on FreeCAD

To generate a translation file from the website

 * Clone the homepage repository
 * cd /path/to/FreeCAD-homepage
 * xgettext --from-code=UTF-8 -o lang/homepage.pot *.php
 * Update the "homepage.po" on crowdin website manually, using the lang/homepage.pot file

To update the translations of the website

 * Get the freecad.zip file either by downloading it from the crowdin website or following instructions above (python updatecrowdin.py download)
 * cd /path/to/FreeCAD-homepage
 * Make sure your repository is clean (git pull, git stash if needed)
 * python updatefromcrowdin.py -z /path/to/freecad.zip
 * if something went wrong or you are unsure, clean everything with git checkout.
 * if everything looks ok (git status), commit with git add . && git commit
 * Create a PR on FreeCAD-Homepage
 * After the PR is merged, one of the admins will ftp push to the webhost

Related

 * Localisation
 * Crowdin Administration
 * Release process