# Manuale di &lokalize;

Nick Shaforostoff

    shaforostoff@kde.ru

Pino Toscano

    toscano.pino@tiscali.it

Traduzione italiana
2007-2009 Nick Shaforostoff
&FDLNotice;
2009-05-09
1.0

&lokalize; è un sistema per la traduzione assistita dal computer («Computer Assisted Translation», «CAT») focalizzato a produttività e qualità. Ha i componenti tipici di strumenti di CAT: memoria di traduzione, glossario e un'unica funzionalità di fusione delle traduzioni (sincronizzazione). È orientato principalmente ala traduzione di software e si integra con strumenti esterni di conversione per la traduzione in modo indipendente di documenti di ufficio.

&lokalize; localizzazione l10n internazionalizzazione i18n traduzione globalizzazione g11n XLIFF gettext OpenDocument KBabel

## Introduzione

Quando avvii &lokalize; la prima volta, vedrai una scheda vuota Vista globale del progetto. Lavorare con &lokalize; implica iniziare con la creazione/apertura di un progetto.

Se stai lavorando in modo autonomo, probabilmente stai traducendo un file OpenDocument. Per fa ciò, scegli Progetto Crea nuovo progetto. La procedura guidata ti chiederà il documento da tradurre, lo convertirà nel formato interno di &lokalize; (XLIFF), e creerà un progetto con il file. Quando hai terminato la traduzione, scegli Strumenti Converti in ODF per integrare la traduzione in una copia del documento da tradurre.

Se stai traducendo per KDE, allora avrai già un file di progetto di &lokalize; nella cartella della tua lingua (solitamente chiamato `index.lokalize`), oppure puoi selezionare Progetto Crea nuovo progetto e la procedura guidata scaricherà i file di traduzione della tua lingua e creerà un progetto.

I file di traduzione sono aperti in schede separate, con due grandi caselle di testo e varie viste di strumenti. Queste viste possono essere posizionate l'una sull'altra (in una struttura a schede), mostrate in modo separato o nascoste. I file di traduzione sono formati da molte coppie di stringhe in inglese, chiamate unità. Una unità di solito corrisponde ad una stringa nell'interfaccia utente, oppure ad un paragrafo di documentazione. Lo scopo della prima casella di testo è di mostrare la parte "originale" della coppia. Lo scopo della seconda casella di testo è di mostrare la traduzione. Puoi passare da una unità all'altra usando la vista Unità di traduzione o i tasti Pag Su e Pag Giù.

Si raccomanda di abituarsi alle scorciatoie da tastiera invece di menu e barre degli strumenti, per incrementare la produttività. Per esempio, usa &Ctrl;L per passare sulla casella di testo Ricerca veloce e filtrare elementi nella vista Unità di traduzione. Quando hai finito, premi Pag Giù per muoverti nella lista filtrata di elementi.

Una unità può essere tradotta o non tradotta. La traduzione di una unità tradotta può essere pronta oppure non pronta (chiamata anche fuzzy). Se una unità non è pronta, la sua traduzione viene mostrata in corsivo. &lokalize; ti permette di navigare facilmente attraverso le unità del file a secondo dello stato della loro traduzione. Vedi le scorciatoie nel menu Vai. Quando navighi tra le unità, le unità non tradotte sono considerate come non pronte. Inoltre, puoi anche filtrarle usando la vista Unità di traduzione. Premendo Pag Giù ti porterà alla successiva unità nella lista filtrata/ordinata di quella vista.

Se stai lavorando con traduzioni in formato XLIFF (sicuramente nel caso in cui stai traducendo OpenDocument) sono disponibili gli stati estesi (nuovo, richiede revisione, approvato, &etc;). Puoi selezionarli nel menu a comparsa del pulsante Approvato nella barra degli strumenti. La classificazione degli stati quali pronto o non pronto dipende dalla fase di lavoro corrente (traduzione, revisione, approvazione). Una fase predefinita per te dipende dal tuo ruolo nel progetto (impostato nelle impostazioni del progetto). Ciascuna unità di solito contiene informazioni su quando ha cambiato fase e, per ogni fase, chi vi ha lavorato.

## Progetti

Il «progetto» è uno dei concetti principali in &lokalize;. Un progetto è rappresentato da un file che contiene percorsi, cartelle con traduzioni, modelli ed altri file: file di glossario, script di automazione, memorie di traduzione. Quando &lokalize; apre un file senza un progetto già caricato, cercherà un file di progetto nelle directory genitori (fino a quattro livelli). In alternativa, puoi specificare il file di progetto usando l'opzione `--project` se avvii &lokalize; da riga di comando.

In ogni progetto scegli il ruolo che hai nel progetto stesso (traduttore, revisore, certificatore), e &lokalize; sceglierà una diversa fase del lavoro per ogni file che modifichi.

Le memorie di traduzione (al contrario di file di progetto, glossario e script) non sono condivise tra i membri della squadra di traduzione, dato che sono creati e memorizzati nella cartella home dell'utente: ciò significa che le memorie di traduzione per tutti i progetti sono memorizzati nella stessa cartella, e che quindi possono essere usati quando altri progetti sono aperti.

### Scheda della vista globale del progetto

La scheda Vista globale del progetto mostra un albero di file con statistiche del progetto, come la percentuale di unità tradotte completate e l'ultimo traduttore. Ti permette di aprire un file selezionato in una nuova scheda della finestra corrente di &lokalize;.

## Glossario

Ti sei mai stancato di scrivere la stessa lunga sequenza di testo diverse volte, solo perché impiegheresti più tempo a cercare la sua traduzione per copiarla e incollarla? Adesso dovrai solo cercare la (frequente) sequenza di parole nella Vista glossario, quindi inserirla usando una scorciatoia da tastiera.

Ovviamente, il glossario dovrebbe essere prima riempito con sequenze di parole. &lokalize; ha un comodo editor di glossario che permette la ricerca su tutto il glossario.

La vista glossario nell'angolo in basso a destra mostra le voci di glossario adatte all'unità corrente
La vista glossario nell'angolo in basso a destra mostra le voci di glossario adatte all'unità corrente

## Memoria di traduzione

La Memoria di traduzione ti permette di trascinare una cartella con file di traduzione da ⪚ &dolphin; nella vista e, dopo pochi minuti, saranno mostrati automaticamente i suggerimenti per la traduzione quando passi ad un altra unità. Per inserire nel file i suggerimenti di traduzione, usa &Ctrl;1, &Ctrl;2 e così via, a secondo del numero di suggerimenti.

Premendo F7 sarà aperta la scheda della Memoria di traduzione, che permette di interrogare la memoria di traduzione. Facendo clic su un risultato di ricerca sarà aperto il file corrispondente, all'unità corrispondente. Se vuoi aprire velocemente un file nel progetto (ed è aggiunto alla memoria di traduzione), invece di sfogliare la Vista globale del progetto digitane il nome (terminato da «*») nel campo Modello di nome di file.

Sono indicizzate nella memoria di traduzione tutte le voci, incluse quelle non pronte e quelle e non tradotte. Ciò permette alla memoria di traduzione di sostituire la ricerca nei file che richiede la scansione di ogni file nel progetto ad ogni ricerca.

&lokalize; con risultati della ricerca nella memoria di traduzione per l'unità corrente
&lokalize; con risultati della ricerca nella memoria di traduzione per l'unità corrente

## Funzionalità di sincronizzazione della traduzione

La Modalità sincronizzazione (precedentemente conosciuta come Modalità di fusione) permette di far risparmiare tempo ai traduttori, in casi in cui due o più traduttori stanno lavorando allo stesso tempo sullo stesso file o quando vengono mantenute le traduzioni di diversi rami di software.

&lokalize; ti permette di navigare velocemente tra le unità tra loro differenti e di mostrare le differenze parola per parola. Inoltre, &lokalize; ha due viste di sincronizzazione: la Sincronizzazione primaria e la Sincronizzazione secondaria. Sono uguali, ma la prima è usata di solito per unire traduzioni mentre la seconda per sincronizzare traduzioni di due rami di software.

Dopo che hai copiato (sincronizzato) la traduzione dal file ausiliario, ogni ulteriore modifica fatta a questa unità sarà replicata nel file ausiliario.

### Fusione

Un uso della Modalità sincronizzazione può essere quello di revisionare modifiche fatte da (nuovi) traduttori, in casi in cui non puoi essere sicuro della qualità del lavoro svolto.

Apri un file base, quindi trascina la sua versione modificata nella vista Sincronizzazione primaria, seguita da &Alt;Down o &Alt;Up (ricorda che le scorciatoie da tastiera possono essere modificare nel modo classico di tutte le applicazioni &kde;) per navigare attraverso le voci tra loro differenti.

&lokalize; usato per la fusione di modifiche nella traduzione
&lokalize; usato per la fusione di modifiche nella traduzione

### Replica

La Modalità sincronizzazione può essere usata per fare allo stesso tempo modifiche alle traduzioni di due rami. Imposta la Cartella ramo di traduzione nelle opzioni del progetto alla directory cartella base del ramo, e la vista Sincronizzazione secondaria aprirà automaticamente i file dal ramo. Quindi, ogni volta che fai modifiche in file nel ramo principale, verranno automaticamente replicate nel ramo (ovviamente, se contiene la stessa stringa inglese).

Ad esempio, se traduci per KDE, puoi prelevare «trunk» in `/home/utente/progetti/kde/trunk/l10n-kde4/TUA_LINGUA` e il ramo stabile in `/home/utente/progetti/kde/branches/stable/l10n-kde4/TUA_LINGUA`. Crea il progetto di &lokalize;: `/home/utente/progetti/kde/trunk/l10n-kde4/TUA_LINGUA/progetto.lokalize` e imposta `BranchDir=../../../branches/stable/l10n-kde4/TUA_LINGUA`; quindi lavora usando questo progetto, depositando le modifiche sia in «trunk» che nel ramo stabile.

### Traduzioni alternative

Ciascuna unità può avere diverse traduzioni alternative associate. Tali traduzioni possono apparire durante l'aggiornamento del file, quando la stringa nei sorgenti viene modificata leggermente. In questo caso, la vecchia traduzione con il suo (vecchio) sorgente viene spostata nella lista delle traduzioni alternative, così non sono perse.

Quando si traduce software, di solito gli strumenti di gettext sono usati per preparare i file di traduzione. Quando il testo originale cambia, gli strumenti di gettext aggiornano i file di traduzione e segnano le voci con il testo originale modificato come fuzzy (o non pronto, usando un'altra terminologia). Il testo originale precedente viene memorizzato, così i traduttori possono vedere quali modifiche sono state fatte. &lokalize; semplifica la vita dei traduttori ed evidenzia nella vista Traduzioni alternative le parti del testo originale che sono cambiate.

&lokalize; che evidenzia parti del testo originale cambiate dall'ultima volta che la traduzione è stata revisionata
&lokalize; che evidenzia parti del testo originale cambiate dall'ultima volta che la traduzione è stata revisionata

## Lavorare con script in &lokalize;

Le funzioni di &lokalize; possono essere estese usando script in diversi linguaggi interpretati, tra cui Python e JavaScript. Gli script sono integrati nell'interfaccia di &lokalize; con voci nei menu (a cui puoi assegnare scorciatoie da tastiera). La posizione e il nome della voce di menu di ogni script è definita nel file .rc che lo accompagna. Per ogni progetto aperto, &lokalize; cerca file .rc nella cartella `DIRECTORY_DEL_PROGETTO/lokalize-scripts` e li aggiunge in un file di cache chiamato `DIRECTORY_DEL_PROGETTO/lokalize-scripts/scripts.rc` (che in generale non dovresti aggiungere al sistema di controllo versione usato per il progetto). I file RC contengono anche i percorsi degli script, che possono essere relativi alla cartella del file .rc o ad una cartella di script di sistema - entrambe le cartelle sono provate (in realtà, i percorsi dovrebbero essere relativi se vuoi condividere il file .rc con altre persone nel tuo progetto). Quindi, puoi ad esempio specificare `../../scripts/lokalize/opensrc.py` per caricare lo script dalla cartella globale degli script di kde4-l10n (&ie; non specifico per la tua lingua).

Esempi di file .rc possono essere trovati nella cartella di installazione di &lokalize; (di solito `/usr/share/kde4/apps/lokalize/scripts/`) e nel deposito di KDE. Qui puoi trovare ulteriori esempi di script, tra cui lo script `check-gui.js` (basato su JavaScript) che viene eseguito automaticamente ad ogni salvataggio dei file (ciò viene fatto con un'opzione speciale nel file .rc). Se hai familiarità con Python o JavaScript, il codice dovrebbe essere sufficientemente chiaro.

Sotto ci sono collegamenti ai riferimenti API. Tutto ciò che è segnatocon Q_SCRIPTABLE può essere usato negli script.

- Riferimento API dell'oggetto Editor

- Riferimento API dell'oggetto Lokalize

- Riferimento API oggetto Project

## Riconoscimenti e licenza

&lokalize;

Copyright del programma © 2007-2009, Nick Shaforostoff shaforostoff@kde.ru

È stato preso del codice da &kbabel;, il predecessore di &lokalize;.

Copyright della documentazione © 2007-2009 Nick Shaforostoff shaforostoff@kde.ru

Autore:

- Nick Shaforostoff shaforostoff AT kde.ru

Per maggiori informazioni, visita la pagina di riferimento di &lokalize;.

Traduzione italiana di Pino Toscano toscano.pino@tiscali.it

&underFDL; &underGPL;
&documentation.index;