Traduzioni
"Al momento tutte le traduzioni vengono gestite da dei file con estensioni .po .pot .mo (Per dettagli sul processo di deploy delle traduzioni, vedi QUI sezione Traduzioni)" [Editable by::users](editable by/users)
I traduttori devono utilizzare la piattaforma POEditor per gestire, modificare e/o completare le traduzioni.
POEditor
Una volta loggato su POEditor il traduttore può selezionare un project (tra i project che gli sono stati assegnati o sui quali ha visibilità) e successivamente selezionare la lingua sulla quale si intende intervenire nelle traduzioni.
La pagina della lingua selezionata (vedi immagine sotto) presenta l'una sotto l'altra tutte le traduzioni, dividendole in due colonne seguendo il formato chiave (prima colonna), valore (seconda colonna) dove la chiave rappresenta un placeholder della traduzione che andrà inserita nella seconda colonna ( a volte la chiave è un titolo, a volte è la versione inglese del testo da tradurre e a volte possiede un contesto che aiuta il traduttore a scegliere la traduzione più adatta, idealmente "tutte" le chiavi delle traduzioni su POEditor dovrebbero avere un contesto)

Come vediamo nell'immagine di esempio la traduzione alla terza riga possiede il context: "Fiscal types" che aiuta il traduttore a capire il constesto della frase da tradurre. Il contesto (quando c'è) compare sotto la chiave.
Invece la chiave a volte è racchiusa tra due chiocciole "@@ chiave @@" in questo caso la chiave non è una chiave letterale da tradurre ma un placeholder il quale va tradotto con un criterio di scelta definito a parte dalla chiave , LE CHIOCCIOLE NON VANNO TRADOTTE!!!
NOTA IMPORTANTE (per i traduttori): Per motivi di sviluppo al momento possono capitare delle chiavi che possiedono frasi tradurre all'interno di tag HTML. I tag HTML vanno riportati nelle traduzioni e non vanno tradotti, al contrario della frase al loro interno che invece va tradotta. Vediamo degli esempi:

Per riconoscere un tag HTML nelle chiavi basta controllare se ci sono delle parole racchiuse dai simboli ≠
nell'esempio dell'immagine abbiamo una chiave con una frase dentro un tag bold e fuori un'altra frase.
<bold>frase</bold>frase -> <bold>frase tradotta</bold>frase tradotta
Quindi in questo caso va tradotto tutto tranne i tag HTML che vanno semplicemente riportati così come nella chiave, esattamente come nell'esempio.
Ricapitolando la chiave può essere di tipo:
- "hello" //testo semplice da tradurre
- "
<h1>hello</h1>" //testo con tag HTML e quindi va tradotto il testo e riportato il tag senza traduzione del tag - "@@ciao@@" //placeholder da sostituire con la frase più adatta
- in tutti i casi precedenti può (o no) essere presente il contesto
| + | Chiave | Esempio di traduzione IT | Esempio di traduzione EN | Esempio di traduzione ES |
|---|---|---|---|---|
| Hello Tester | Ciao Tester | Hello Tester | Hola Tester | |
Hello <bold>Tester</bold> | Ciao <bold>Tester</bold> | Hello <bold>Tester</bold> | Hola <bold>Tester</bold> | |
| @@Welcome on AppQuality@@ | Benvenuto sulla nostra piattaforma!! 💖 | Welcome to our platform!! 💖 | Bienvenida a nuestra plataforma!! 💖 |
Postum Scriptum. Nel caso in piattaforma (https://crowd.app-quality.com/) venga trovata una parola o frase che non sia presente su POEditor si è pregati di segnalarlo tempestivamente al referente delle traduzioni. Grazie.