Crowdin Scripts

Other languages:

Gestire le traduzioni per FreeCAD

Per gestire le traduzioni FreeCAD utilizza un servizio di traduzione di terzi chiamato Crowdin.

In FreeCAD/src/Tools ci sono 3 script che sono usati per gestire i file di traduzione:

updatets.py (github source)
updatecrowdin.py (github source)
updatefromcrowdin.py (github source)

Questi script vengono eseguiti dalla radice della directory FreeCAD/. Nota: Affinché questi script funzionino, è necessario che la chiave API Crowdin di FreeCAD sia inserita nel loro file ~/.crowdin-freecad. (Per motivi di sicurezza, disponibile solo per le persone con diritti di amministratore sul progetto FreeCAD)

updatets.py

Questo script crea i file .ts nella directory locale FreeCAD/.

updatecrowdin.py

Questo script trasferisce le modifiche dalla directory locale FreeCAD/ a Crowdin. Lo script attualmente supporta 4 argomenti:

updatecrowdin.py status stampa uno stato delle traduzioni
updatecrowdin.py update aggiorna Crowdin alla versione corrente dei file .ts trovati nel codice sorgente
updatecrowdin.py build crea un nuovo pacchetto scaricabile su crowdin con tutte le stringhe tradotte
updatecrowdin.py download scarica l'ultima versione

updatefromcrowdin.py

Questo script estrae le modifiche da crowdin alla directory locale FreeCAD/.

Inviare le stringhe più recenti a crowdin

Testato solo su Linux
È necessario un file .credentials nella propria directory /home/YourUser. Questo file è un semplice file di testo contenente solo una riga, che è la chiave API che si trova su https://crowdin.com/project/freecad/settings#api (solo per gli amministratori)
Accertarsi che il proprio repository sia pulito (git pull, git stash se necessario)
cd /path/to/freecad-source-code/src/Tools
python updatets.py (riempie tutti i file .ts trovati nella sorgente con le stringhe più recenti)
python updatecrowdin.py update (invia i file ts a crowdin. Crowdin aggiorna solo le stringhe che sono nuove)
cd ../.. (torna alla cartella radice del codice sorgente)
git checkout . (annulla tutte le modifiche ai file .ts, non c'è motivo di convalidarli in questo momento in quanto non sono ancora stati tradotti)

Unire le ultime traduzioni da crowdin

Testato solo su Linux
È necessario un file .credentials nella propria directory /home/YourUser. Questo file è un semplice file di testo contenente solo una riga, che è la chiave API che si trova su https://crowdin.com/project/freecad/settings#api (solo per gli amministratori)
Accertarsi che il proprio repository sia pulito (git pull, git stash se necessario)
cd /path/to/freecad-source-code/src/Tools
python updatecrowdin.py build (crea un file zip nel sito di crowdin con tutti i file, può richiedere un po 'di tempo. Questo passaggio può essere fatto anche sul sito Web di crowdin)
python updatecrowdin.py download (scarica un file freecad.zip in questa directory)
mv freecad.zip ~ sposta il file zip nella vostra directory home, per evitare un commit accidentalmente in seguito)
(optionale) edita lo updatefromcrowdin.py script e controlla che le default_languages contengano tutte le lingue che si vuole (in pratica tutte quelle che superano il 50% di traduzione)
python updatefromcrowdin.py -z /home/YourUser/freecad.zip
cd ../.. (torna alla cartella radice del codice sorgente)
Se qualcosa è andato storto o non si è sicuri, pulire tutto con il git checkout.
Se tutto sembra ok (git status), convalidare con git add . && git commit
Creare un PR su FreeCAD

Generare un file di traduzione dal sito Web

Clonare il repository della home page
cd /path/to/FreeCAD-homepage
xgettext --from-code=UTF-8 -o lang/homepage.pot *.php
Aggiornare la "homepage.po" sul sito Web di crowdin manualmente, utilizzando il file lang/homepage.pot

Aggiornare le traduzioni del sito web

Scaricare il file freecad.zip dal sito Web crowdin o seguendo le istruzioni sopra (python updatecrowdin.py download)
cd /path/to/FreeCAD-homepage
Accertarsi che il proprio repository sia pulito (git pull, git stash se necessario)
python updatefromcrowdin.py -z /path/to/freecad.zip
Se qualcosa è andato storto o non si è sicuri, pulire tutto con il git checkout.
Se tutto sembra ok (git status), convalidare con git add . && git commit
Creare un PR su FreeCAD-Homepage
Dopo la fusione del PR, uno degli amministratori manda un ftp al webhost