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.

Trovare i file .ts

Per trovare i file .ts installare il pacchetto synaptic.

Preinstallati

I pacchetti installati nel sistema sono in formato .qm e devono pertanto essere convertiti in .ts. Per cercare i file già installati nel file system nella propria o altre lingue:

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 o in una cartella creata appositamente per la traduzione.

   Per mantenere ordinata la propria "Home" si consiglia di creare una cartella specifica per le traduzioni al suo interno.

4. Per convertire i file .qm in file .ts ed azzerare le traduzioni digitare nel terminale i seguenti comandi:

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

   dove al posto di sp inserire la sigla del paese.

Da sorgente

Se la ricerca non dà risultato, è utile scaricare i sorgenti dai repository per verificare l'eventuale presenza dei file nomepacchetto_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 tarball dei 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 o in una cartella creata appositamente per la traduzione.

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

In mancanza di file nomepacchetto_untraslated.ts, seguire le istruzioni per detradurre i file nomepacchetto_sp.ts, sostituendo sp con la sigla della lingua e nomepacchetto col nome del pacchetto da tradurre.

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 in /usr/share/qt4/phrasebooks o /usr/share/qt5/phrasebooks a seconda delle proprie esigenze.

Tradurre con Linguist

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 clic 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, raggruppate in Options, 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.

7. Se si è allocato il file traduzione nella propria Home, dopo ogni traduzione fare clic su Ctrl + T in modo di aggiungere la traduzione al dizionario.

8. Finita la traduzione, per salvare il file in formato .ts fare clic su File → Save As....

9. Nella finestra apertasi selezionare in Filter il Qt translation sources in Name sostituire il 'untranslated' con la sigla della lingua e premere Save.

10. Per creare il .qm selezionare File → Release As....

11. Selezionare nella finestra apertasi 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 delle traduzioni

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 allocare i file tradotti in /usr/local 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