# 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 di traduzione assistito dal computer, che si focalizza su produttività e qualità. &lokalize; applica un approccio di traduzione paragrafo per paragrafo per la traduzione di documentazione, mentre viene usato un approccio messaggio per messaggio per a traduzione di componenti di &GUI;.

&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.

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 messaggi. Un messaggio 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 un messaggio all'altro usando l'albero dei messaggi 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.

Un messaggio può essere tradotto o non tradotto. La traduzione di un messaggio tradotto può essere approvata o non approvata (chiamata anche fuzzy e non pronta). Se un messaggio non è approvato, la sua traduzione viene mostrata in corsivo. &lokalize; ti permette di navigare facilmente attraverso i messaggi del file a secondo dello stato della loro traduzione. Vedi le scorciatoie nel menu Vai. Quando navighi tra i messaggi, i messaggi non tradotti sono considerati come non approvati. Inoltre, puoi anche filtrare i messaggi nella 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 voce 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 messaggi tradotti completati e l'ultimo traduttore. Ti permette di aprire un file selezionato nella finestra corrente di &lokalize; o in una nuova.

## 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 alla voce corrente
La vista glossario nell'angolo in basso a destra mostra le voci di glossario adatte alla voce corrente

## Memoria di traduzione

La Memoria di traduzione ti permette di trascinare una cartella con file di traduzione da &eg; &dolphin; nella vista e, dopo pochi minuti, saranno mostrati automaticamente i suggerimenti per la traduzione quando passi ad un altro messaggio. 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, alla voce 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 fuzzy 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 la voce corrente
&lokalize; con risultati della ricerca nella memoria di traduzione per la voce 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 i messaggi 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 voce 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 voce 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 dello 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 kde-l10n4 (&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. Se hai familiarità con Python o JavaScript, il codice dovrebbe essere sufficientemente chiaro.

Sotto ci sono collegamenti ai riferimenti API. Tutto ciò che è marcato con 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;