Introduzione

Il programma Linguist è un editor specializzato per tradurre i file .ts usati per internazionalizzare i programmi, utile per programmi od applicazioni non ancora tradotte in cui è disponibile il supporto Qt.

Installazione

Installare a seconda delle proprie esigenze i pacchetti:

• qttools5-dev-tools per applicazioni Qt5;

• qt4-dev-tools e qt4-linguist-tools per applicazioni Qt4.

I file .ts

I pacchetti da tradurre possono essere recuperati sia dal sistema sia dai pacchetti sorgente, per trovarli nel sistema è utile il pacchetto Synaptic.

Preinstallati

Cercare quelli già installati nel file system nella propria o altre lingue in formato .qm, da convertire in formato .ts per poterli tradurre.

1. Avviare il programma Synaptic e cercare il pacchetto richiesto per nome.

2. Fare clic con il tasto destro del mouse sul nome del pacchetto per aprire il menu contestuale e cliccare su Proprietà, poi spostarsi nella scheda File installati e leggere il percorso ai file .qm.

3. Avviare il file manager al percorso individuato nel punto precedente e copiare il file .qm nella propria Home.

4. Per convertire i file .qm in file .ts ed azzerare le traduzioni digitare nel terminale i seguenti comandi sostituendo il sp con la sigla del paese:

    cd /home/nomeutente/cartellaprescelta
    lconvert --drop-translations nome_sp.qm -o nome_untraslated.ts

Da sorgente

Se la ricerca non dà risultato, è utile scaricare i sorgenti dai repository per verificare l'eventuale presenza dei file nome_untranslated.ts, non inclusi nei pacchetti compilati e distribuiti.

1. Avviare il programma Synaptic e cercare il pacchetto richiesto per nome.

2. Fare clic con il tasto destro del mouse sul nome del pacchetto per aprire il menu contestuale e cliccare su Proprietà, poi spostarsi nella scheda Comune e leggere il nome del sorgente, la versione e la sezione dei repository in cui si trova.

3. Avviare il browser.

4. Cercare e scaricare i sorgenti dal repository ufficiale.

   1. Selezionare la sezione dei repository appropriata.
   2. Fare clic sulla lettera iniziale del nome cercato.
   3. Scorrere la lista fino a trovare il nome del sorgente e fare clic su esso.
   4. Fare clic sulla versione richiesta.
   5. Salvare il tarball nella cartella prescelta nella propria "Home".

5. Estrarre il contenuto dei sorgenti precedentemente scaricati nella propria Home e copiare il file nome_untranslated.ts nella cartella specifica per la traduzione. Generalmente i file per la traduzione si trovano nella cartella translations.

In mancanza di file _untraslated.ts, seguire le istruzioni riportate sopra per detradurre i file nome_sp.ts, sostituendo sp con la sigla della lingua.

Configurazione

Primo avvio

1. Aprire un terminale e digitare il seguente comando:

   linguist

2. Cliccare su Phrases → Open Phrase Book... e selezionare il dizionario .qph della lingua verso cui si intende tradurre rispettivamente in /usr/share/qt4/phrasebooks o /usr/share/qt5/phrasebooks.

Traduzione

1. Per avviare il programma Linguist fare clic sul file nomeprogramma_untraslated.ts creato precedentemente

2. Nella finestra apertasi in automatico selezionare nella sezione Target language le opzioni Language → Italian e Country/Region → Italy, poi fare click su ok.

   Nel caso non venga mostrata la finestra per le impostazioni della lingua fare clic su Edit → Translations File Settings...

3. Selezionare View → Views e mettere la spunta su Context, Strings e Phrases and guesses.

4. Fare clic su Validation e mettere la spunta su Accelerations, Ending Punctuation e Place Marker Match.

5. Selezionare Edit → Batch Translations..., mettere la spunta sulle tre opzioni in alto e cliccare su Run, poi chiudere la finestra cliccando su Cancel.

6. Selezionare il gruppo di stringhe che si vuole tradurre in Context e selezionare la riga da tradurre in Strings e digitare la traduzione in Italian translation e fare clic su Ctrl + Enter. Se si è allocato il file traduzione nella propria "Home" dopo ogni traduzione fare clic su Ctrl + T in modo di aggiungere la traduzione nel dizionario.

7. Finita la traduzione per salvare il file in formato .ts fare clic su File → Save As..., nella finestra selezionare in Filter il Qt translation sources in Name sostituire il 'untranslated' con la sigla della lingua e premere Save.

8. Per creare il .qm selezionare File → Release As..., selezionare in Filter il Qt message file for released applications e premere Save.

   Aggiungere le proprie traduzioni al dizionario permette di riusarle per tradurre altre stringhe, semplicemente ripetere ogni 3 o 4 gruppi di stringhe tradotte il punto 3.

Allocazione

Le traduzioni non hanno un'allocazione predefinita, normalmente si trovano in /usr/share/nomeprogramma/translations. Per controllare l'esatta allocazione delle traduzioni del software che si sta traducendo:

1. avviare il programma Synaptic e cercare il pacchetto richiesto per nome.

2. Fare clic con il tasto destro del mouse sul nome del pacchetto per aprire il menu contestuale e cliccare su Proprietà, poi spostarsi nella scheda File installati e leggere il percorso ai file .qm.

Per evitare che un aggiornamento cancelli le traduzioni è consigliabile usare la directory /usr/local per allocare i file tradotti, e creare un collegamento simbolico alla directory richiesta, spostando l'eventuale file .qm preesistente come backup.

Digitare nel terminale i seguenti comandi:

1. Per spostare l'eventuale file .qm preesistente:

    sudo mv /usr/share/nomeprogramma/translations/nome_it.qm /usr/share/nomeprogramma/translations/nome_it.qm

2. Per creare la directory dove allocare:

    sudo mkdir -p /usr/local/share/nomeprogramma/translations

3. Per allocare il file .qm:

    sudo cp nome_it.qm /usr/local/share/nomeprogramma/translations

4. Per creare il collegamento simbolico:

    sudo ln -s /usr/local/share/nomeprogramma/translations/nome_it.qm /usr/share/nomeprogramma/translations

dove al posto di nomeprogramma inserire il nome del programma e al posto di nome_it.qm inserire il nome e l'estensione del file della traduzione.

Ulteriori risorse

• Sito ufficiale Qt

• Sito documentazione Qtlingist Qt5

• Sito documentazione Qtlingist Qt4