Pino
Toscano

    toscano.pino@tiscali.it

Traduzione italiana

# Preferenze

## Impostazioni globali e di progetto

A partire da KBabel 1.10 (KDE 3.4), KBabel ha il concetto di progetto e quindi le impostazioni sono state divise in due categorie: le impostazioni globali e le impostazioni del progetto (chiamate anche configurazione del progetto).

&GNU; gettext usa un termine "progetto", ma non ha nulla in comune con i progetti di KBabel. Per "progetto" &GNU; gettext intende un'applicazione relativa ad un file PO. Per KBabel, "progetto" è qualcosa di più esteso. Può essere un insieme di applicazioni, come &kde;.

KBabel ha sempre un progetto corrente, anche se è quello predefinito. KBabel non ha modalità senza alcun progetto. Un progetto è sempre per l'editor di KBabel e per la Gestione cataloghi.

### Limitazioni conosciute dell'implementazione corrente

Sfortunatamente, l'implementazione corrente dei progetti ha alcuni problemi noti.

Un esempio di ciò è rappresentato dalle impostazioni globali: non ci sono impostazioni per l'utente predefinito, la sua lingua e altri simili importanti dati utente. Significa che questi dati devono essere inseriti ogni volta che viene creato un nuovo progetto.

Un altro problema è la procedura guidata di un nuovo progetto. Non chiede abbastanza informazioni, in particolare non chiede l'indirizzo di posta elettronica del gruppo di traduzione. Per questo, si raccomanda di controllare le impostazioni del progetto dopo aver avviato la procedura guidata.

Al momento non puoi copiare progetti da dentro KBabel, così apparentemente non puoi condividere buone impostazioni. Tuttavia, sei libero di copiare il progetto da fuori KBabel e di caricare in KBabel il progetto copiato.

### Usare KBabel per progetti non &kde;

Mentre i valori predefiniti di &kbabel; sono orientati per lavorare con e per &kde;, &kbabel; può essere usato per tradurre file PO di altri progetti. Tuttavia, dovrai modificare le impostazioni a seconda delle necessità del progetto. Ciò vale in particolare per progetti &GNU; e simil-&GNU;, che richiedono valori predefiniti piuttosto diversi da quelli per &kde;.

Uno dei problemi è che &kbabel; è relativamente "aggressivo" quando salva file PO e sostituisce le impostazioni dei file PO con le impostazioni dei progetti, se non specificato diversamente. Ciò può sembrare molto strano a chi non è abituato a &kde;. Tuttavia, &kde; ha più di 900 file POT da tradurre solo per i messaggi delle interfacce grafiche. Per tale compito sono richiesti, quindi, dei sistemi automatici. Il tempo speso a impostare un progetto è poco rispetto a quello che viene guadagnato in seguito. Ovviamente, come utente non &kde;, potresti essere meno fortunato. Devi quindi configurare meglio le impostazioni, dato che i valori predefiniti non sono perfettamente adatti e non avrai un guadagno così grande facendo tante traduzioni, dato che i progetti &GNU; hanno tipicamente solo un file POT da tradurre.

## Impostazioni globali di &kbabel;

Per mostrare la finestra di dialogo delle preferenze scegli Impostazioni Configura KBabel... dal menu di &kbabel;. Una strutturata finestra di dialogo di configurazione facilita la ricerca di un'opzione evitando inutili ricerche estensive.

### Modifica

La categoria delle preferenze dell'editor è divisa in 3 sottosezioni: Generale, Aspetto e Tipi di carattere. Tutte queste impostazioni influiscono sul comportamento e sull'aspetto dell'editor.

#### Generale

La finestra di dialogo Modifica Generale
La finestra di dialogo Modifica Generale

Questa sezione contiene varie caselle.

La prima casella in alto imposta se rimuovere automaticamente lo stato fuzzy quando si digita qualcosa nell'editor di MsgStr. Se questa opzione è disabilitata devi scegliere manualmente Modifica Cambia stato fuzzy o usare la scorciatoia &Ctrl;U. Nota che ciò equivale ad eliminare la stringa `, fuzzy` dal commento del messaggio.

L'opzione successiva ti permette di abilitare la modifica intelligente, secondo la quale l'editor inserisce automaticamente i caratteri speciali dei quali è stato già fatto l'escape, &eg; `\t` dopo aver premuto Tab, e permette una speciale gestione di Enter.

Le caselle in basso sono utili nel controllare non la correttezza della traduzione, ma che la stringa tradotta sia un rimpiazzo adatto per l'originale. Per esempio, molti messaggi rappresentano voci nei menu con un acceleratore da tastiera e stringhe di formato nello stile del linguaggio C, la cui struttura deve rimanere intatta una volta tradotta.

Controlla argomenti

  Se questa opzione è selezionata, le stringhe c-format nell'originale e nella traduzione sono controllate per controllare il numero delle sequenze di formato e la correttezza del loro ordine.

Controlla acceleratori

  Se questa opzione è selezionata, &kbabel; controlla che il numero di acceleratori sia lo stesso nella stringa originale e in quella tradotta. Nota che il carattere acceleratore è & (ma non in tutte le librerie di sviluppo). Vedi la sezione sotto Varie per sapere come cambiare l'acceleratore da tastiera.

Controlla equazione

  Questa è una funzione per lo sviluppo del progetto &kde;. I file `.desktop` sono semplici file di testo che memorizzano vari parametri nella forma `valore=chiave`. Alcune di queste `chiavi` sono traducibili. L'unica restrizione è quella di lasciare invariata la parte sinistra dell'uguaglianza. Il controllo delle equazioni ti permette di individuare molti degli errori generati dall'algoritmo di `msgmerge`. Nota che ci sono situazioni in cui questa funzione genera falsi errori su alcuni file PO.

Cerca per informazioni di contesto tradotte

  Alcuni messaggi originali includono informazioni contestuali per marcarli come unici, anche se rappresentano la stessa parola. Ciò accade per il fatto che molte semplici parole, come Salva, sono tradotto in molte lingue. Le informazioni contestuali sono indicate da `_:`. Molti traduttori inesperti traducono le informazioni contestuali riempiendo i loro file PO con errori. Marca questa casella per assicurarti di essere avvisato riguardo a questi errori in un file.

Controlla forme plurali

  Se stai traducendo il progetto &kde;, esso usa una sintassi speciale per le forme di plurali dei messaggi. Questa funzione conta automaticamente il numero di forme in msgstr e lo confronta con il numero specificato nella scheda Identità. Un numero non corretto di forme di plurali può far andare in crash un'applicazione.

Segnalazione acustica in caso di errore

  Il sistema emetterà un segnale acustico quando selezioni un messaggio con errori simili a quelli sopra descritti.

Cambia colore del testo in caso di errore

  Questo è un altro tipo di avviso riguardo a errori nel messaggio corrente. È una buona soluzione per chi ha problemi di udito o non apprezza il suono della campanella. Vedi anche la sezione Aspetto per sapere come cambiare il colore del testo in caso di errori.

#### Aspetto

La finestra di dialogo Modifica Aspetto
La finestra di dialogo Modifica Aspetto

Queste opzioni ti permettono di configurare l'aspetto dell'editor di messaggi. In alto vi sono 4 caselle:

Evidenzia sintassi

  Se abiliti questa opzione sarà attivata l'evidenziazione della sintassi per caratteri speciali, tasti acceleratori e sfondo del testo nell'editor di msgid e di msgstr. Attiva questa opzione se non hai un display monocromatico o hai problemi di vista.

Sfondo evidenziato

  Lo sfondo sarà evidenziato solo per caratteri esistenti in msgid e msgstr, ed anche per gli spazi bianchi. Ciò è utile se non vuoi vedere gli apici (vedi sotto) nei messaggi, e potrai vedere gli spazi all'inizio e alla fine delle linee di testo.

Segna con punti gli spazi bianchi

  Se non senti il bisogno di contare gli spazi e non gradisci l'evidenziazione dello sfondo, attiva questa opzione per avere un punto disegnato nel mezzo degli spazi bianchi. Nota che il punto è disegnato al centro della casella di ogni carattere e non è un punto separatore di migliaia.

Mostra apici

  Se pensi che sia meglio per te vedere i caratteri di terminale nelle linee di testo di msgstr o msgid, allora attiva questa opzione per vedere gli apici in ogni linea di testo.

  Se hai già modificato file PO con normali editor di testo potresti voler vedere le virgolette all'inizio e alla fine delle linee delle voci del file PO.

Ci sono diverse scelte di colore per le differenti voci nel testo modificato che ne facilitano la modifica. I colori possono essere cambiati facendo clic sui pulsanti di scelta del colore. Dalla finestra di dialogo di scelta del colore puoi scegliere tra i colori standard, i colori personalizzati o un colore da qualsiasi parte dello schermo.

Colore dello sfondo

  Questa opzione imposta il colore di sfondo per i caratteri nella vista di MsgID e nell'editor di MsgStr. Per cambiare il colore di sfondo generale delle caselle di testo devi usare &kcontrolcenter;.

Colore dei caratteri tra virgolette

  Qui puoi regolare il colore dei caratteri di cui è stato fatto l'escape, come le virgolette (`\"`) o il carattere di fine linea (`\n`).

Colore degli errori di sintassi

  Questo è il colore per l'intero testo del messaggio se vengono rilevati errori al salvataggio di un file PO. Gli errori riguardano la fine diversa di msgid e msgstr, o il modo non corretto in cui è stato fatto l'escape dei caratteri.

Colore dei caratteri c-format

  Questa opzioni imposta il colore di sequenze di caratteri come quelle delle funzioni C `printf` o `scanf`. In generale queste iniziano con il carattere di percentuale (`&percnt;`) e continuano con un carattere.

Colore per tasti acceleratori

  Gli acceleratori da tastiera in &kde; iniziano con il carattere e commerciale (&) ma se stai traducendo per altri progetti potrebbe esserci un carattere diverso che indica il tasto acceleratore. Vedi la sezione Varie sotto per sapere come cambiare l'acceleratore da tastiera.

Lo stato della voce correntemente modificata è indicato da tre LED. Per tua comodità puoi scegliere dove posizionare questi LED, nella barra di stato o nella sezione dell'editor (tra le voci di msgid e msgstr). Se hai problemi a vedere alcuni colori o vuoi poter notare facilmente i cambiamenti dello stato dei LED senza muovere gli occhi puoi scegliere il colore preferito usando il pulsante di scelta del colore.

### Ricerca

La finestra di dialogo di ricerca
La finestra di dialogo di ricerca

La sezione sulla ricerca ti permette di personalizzare varie impostazioni riguardanti la ricerca in stringhe precedentemente tradotte.

Le impostazioni generali sono comuni per tutti i tipi di ricerca. Se attivi l'opzione Avvia automaticamente la ricerca, la ricerca sarà automaticamente avviata ogni volta che nell'editor passi ad un'altra voce. Al momento, ci sono tre possibilità tra cui puoi scegliere ma, dato che &kbabel; può usare plugin di dizionario, i dizionari disponibili dipendono da quelli installati. Puoi configurare ogni plugin di ricerca scegliendo Impostazioni Configura dizionario... ....

I plugin di dizionario installati in maniera predefinita sono:

Motore di ricerca nel database di &kde;

  Questo nuovo metodo è ancora allo stadio alpha di sviluppo e si basa su &kbabeldict;, distribuito assieme a &kbabel;. Consulta la documentazione di &kbabeldict; per maggiori informazioni sulla configurazione del motore di ricerca.

PO compendio

  Il compendio è un normale file PO, che contiene una lista di traduzioni standard del proprio gruppo di traduzione. Se non ne hai uno, puoi anche usare un file che contiene tutte le traduzioni del tuo gruppo di traduzione (&eg;, per il progetto &kde;, il file `$lang.messages`, che può essere trovato presso i18n.kde.org).

PO ausiliario

  L'ausiliario dovrebbe aiutarti a trovare il contesto di una traduzione cercando lo stesso messaggio in un catalogo di messaggi dello stesso pacchetto ma tradotto in un'altra lingua. In questo modo puoi vedere come il messaggio è stato tradotto in un'altra lingua.

Puoi anche iniziare la ricerca manualmente selezionando una voce dal menu a comparsa che appare sia facendo clic su Dizionari Trova testo PO compendio sia tenendo premuto per un po' il pulsante di ricerca nella barra degli strumenti.

### Confronto

La finestra di dialogo di confronto
La finestra di dialogo di confronto

Nella sezione Confronto vi sono le impostazioni che riguardano il modo in cui sono visualizzate le differenze tra i msgid.

Ogni differenza può essere visualizzata da parti aggiunte e da caratteri rimossi dal testo. Per entrambi puoi specificare la modalità di visualizzazione e il colore usati. Evidenziato significa che lo sfondo dei caratteri corrispondenti sarà mostrato con il colore selezionato, mentre Sottolineato (per i caratteri aggiunti) o Sbarrato (per i caratteri rimossi) denoterà, grazie a linee colorate, le parti modificate.

La modalità di confronto richiede di trovare l'originale msgid per il confronto. Per questo scopo, &kbabel; può usare il database delle traduzioni se tu lo abiliti con l'opzione Utilizza messaggi dal database delle traduzioni. Una seconda possibilità è di usare un albero di file PO originali e di specificarne la radice in Cartella base per i file di confronto.

### Tipi di carattere

La finestra di dialogo dei tipi di carattere
La finestra di dialogo dei tipi di carattere

Questa è una standard finestra di dialogo di &kde; di scelta del tipo di carattere con una piccola aggiunta. Puoi scegliere di visualizzare solo tipi di carattere a spaziatura fissa attivando l'opzione Mostra soltanto tipi di caratteri a spaziatura fissa. Ciò è fortemente raccomandato per tradurre facilmente. La finestra di dialogo dei tipi di carattere ti permette di impostare la famiglia, lo stile, la dimensione e la codifica dei caratteri. L'area in basso mostra, come aiuto aggiuntivo, un'anteprima del tipo di carattere corrente.

## La procedura guidata di un nuovo progetto

### Pagina 1

La pagina 1 della procedura guidata di un nuovo progetto
La pagina 1 della procedura guidata di un nuovo progetto

La prima pagina della procedura guidata chiede le informazioni base del progetto.

Nome del progetto

  Inserisci qui il nome del progetto, dato che sarà mostrato nel menu di &kbabel;.

Nome del file di configurazione

  Scegli qui un file che conterrà le impostazioni del tuo progetto.

Lingua

  Scegli o inserisci qui il nome della lingua usata da questo progetto.

Tipo di progetto

  Scegli qui il tipo del tuo progetto.

### Pagina 2

La pagina 2 della procedura guidata di un nuovo progetto
La pagina 2 della procedura guidata di un nuovo progetto

La seconda pagina della procedura guidata chiede alcune impostazioni relative alla Gestione cataloghi.

Cartella base per i file PO

  Scegli la cartella base dove sono i tuoi file PO.

Cartella base per i file POT

  Scegli la cartella base dove sono i tuoi file POT.

Inserisci o scegli le cartelle che contengono rispettivamente tutti i file PO e i file POT. I file e le cartelle in queste cartelle saranno uniti in un unico albero nella finestra di &catalogmanager;.

### Controllare le impostazioni del progetto

Come scritto prima in questo capitolo, sfortunatamente la procedura guidata è molto semplice e per questo non chiede alcune impostazioni importanti.

Adesso che hai completato il nuovo progetto, dovresti verificare le impostazioni principali in Progetto Configura.... In particolare, scegli la pagina Identità e correggi l'indirizzo di posta del gruppo di traduzione in Mailing list della lingua (il valore predefinito creato dalla procedura guidata a partire dall'impostazione della lingua è utile solo se sei parte di un progetto &GNU;).

Se le impostazioni del progetto non sono per KDE, si raccomanda di controllare la pagina Salvataggio e le impostazioni contenute lì.

## Impostazioni del progetto

Per mostrare la finestra di dialogo delle impostazioni del progetto scegli Progetto Configura... dal menu di &kbabel; o di &catalogmanager;. Usa una strutturata finestra di dialogo di configurazione che facilita la ricerca di un'opzione evitando inutili ricerche estensive.

Sul lato sinistro della finestra di dialogo delle preferenze vi è un elenco delle categorie di opzioni e sul lato sinistro la scheda corrispondente alla categoria selezionata. Se ti sposti da una categoria all'altra, &kbabel; mantiene le modifiche fatte, e quando ne sei soddisfatto premi il pulsante OK. In ogni momento puoi usare l'aiuto rapido, basta che fai clic sul punto interrogativo nella barra del titolo e, dopo che il cursore è diventato una freccia con un punto interrogativo, fai clic su un pulsante, su un'etichetta o su un'opzione delle preferenze per saperne di più.

Le pagine le le impostazioni di &kbabel; (l'editor) e per &catalogmanager; sono nella lista.

### Identità

Queste impostazioni sono per &kbabel;.

Questa sezione ti permette di impostare i campi standard di ogni file PO tradotto. Questi sono il proprio nome, l'indirizzo di posta elettronica, il nome completo della lingua, l'indirizzo di posta elettronica della mailing list del gruppo di traduzione. Vi è anche un campo riguardante il fuso orario per poter modificare l'orario di ultima modifica dei file PO. Puoi specificarlo come sequenza di caratteri come CET o differenze dall'orario GMT come +0100 (&ie; per l'Italia). Questa informazione è usata durante l'aggiornamento delle intestazioni del file. Puoi trovare l'opzione che controlla quali campi dell'intestazione modificare nella sezione Salvataggio della finestra di dialogo delle preferenze.

Le sequenze di caratteri per i fusi orari non sono standard. Per questo motivo non dovresti usare la stringa qui impostata nell'impostazione dell'orario per il salvataggio nella scheda Salvataggio. Usa, invece, `%z`.

Numero di forme singolari/plurali

  Usa questa opzione per impostare il numero di forme di plurali della tua lingua. Per esempio, 2 per l'italiano (una per il singolare e una per il plurale).

  Questa caratteristica attualmente è implementata solo per le forme di plurali usate in &kde;. Non funziona con le forme di plurali &GNU; gettext.

### Salvataggio

Queste impostazioni sono per &kbabel;.

Questa sezione ti permette di modificare le opzioni riguardanti il salvataggio dei file PO. Il primo gruppo di caselle controlla il comportamento generale delle azioni eseguite durante il salvataggio dei file PO.

Aggiorna intestazione quando salvi

  Attiva questa opzione per aggiornare ad ogni salvataggio le informazioni contenute nell'intestazione di ogni file. L'intestazione normalmente contiene le informazioni riguardanti la data e l'ora dell'ultimo aggiornamento del file, l'ultimo traduttore, ecc. Puoi scegliere quali informazioni aggiornare grazie alle caselle contenute nell'area Campi da aggiornare. I campi che non esistono sono aggiunti all'intestazione. Se vuoi aggiungere altri campi all'intestazione, puoi modificarla manualmente scegliendo Modifica Modifica intestazione... nella finestra dell'editor.

Controlla la sintassi del file quando salvi

  Marca questa opzione per controllare automaticamente al salvataggio la sintassi di un file con ``msgfmt` --statistics`. Vedrai comparire un messaggio solo se si verificano errori. Dovresti mantenere abilitata questa verifica a meno che tu non sappia cosa stia facendo.

Se non vuoi modificare alcuni campi nell'intestazione dei file PO o ne vuoi forzare l'aggiornamento, ci sono cinque caselle che controllano: la data di revisione, la lingua del file PO, la codifica del testo, il nome dell'ultimo traduttore, l'insieme di caratteri. Se un campo non esiste, è aggiunto all'intestazione. Se vuoi aggiungere altre informazioni all'intestazione, devi modificarla manualmente scegliendo Modifica Modifica intestazione... nella finestra dell'editor. Disattiva l'opzione sopra Aggiorna intestazione quando salvi se non vuoi aggiornare l'intestazione automaticamente.

Per la data e l'ora del campo PO-Revision-Date dell'intestazione puoi scegliere uno tra i seguenti formati: Predefinito, Locale e Personalizzato.

Dovresti mantenere l'impostazione predefinita di Predefinita. Le altre due impostazioni fanno sì che il file PO generato non sia più un file PO &GNU; gettext standard, e per questo dovrebbero essere evitate.

- Predefinito è il formato normalmente utilizzato nei file PO.

- Locale è il formato specifico del tuo paese.

- Personalizzato ti permette di definire il formato tuo, e puoi usare le seguenti stringhe di formato simili a quelle del linguaggio C:

  #### Anno

  Formato | Significato | Intervallo
  --- | --- | ---
  %y | anno | da 00 a 99
  %Y | anno | da 0001 a 9999

  #### Mese

  Formato | Significato | Intervallo
  --- | --- | ---
  %m | mese dell'anno | da 01 a 12
  %f | mese dell'anno | da 1 a 12
  %b,%h | abbreviazione del mese | da gen a dic

  #### Giorno

  Formato | Significato | Intervallo
  --- | --- | ---
  %j | giorno dell'anno | da 001 a 366
  %d | giorno del mese | da 01 a 31
  %e | giorno del mese | da 1 a 31
  %a | abbreviazione del giorno della settimana | da dom a sab

  #### Ore

  Formato | Significato | Intervallo
  --- | --- | ---
  %H | ore | da 00 a 23
  %k | ore | da 0 a 23
  %i | ore | da 1 a 12
  %I | ore | da 01 a 12
  %p |  | AM o PM

  #### Minuti, secondi e fuso orario

  Formato | Significato | Intervallo
  --- | --- | ---
  %M | minute | da 00 a 59
  %S | secondi | da 00 a 59
  %Z | fuso orario | (fornito nelle impostazioni di identità)
  %z | fuso orario | (differenza numerica come specificata nelle impostazioni di sistema)

L'opzione per scegliere il formato della data per i file PO è considerata obsoleta, e probabilmente sarà rimossa in una futura versione di KBabel.

Il gruppo più basso raggruppa le opzioni riguardanti la codifica dei file PO al salvataggio. Se lavori per il progetto &kde; sappi che i file PO devono essere codificati in UTF-8 in &kde;. In alternativa puoi scegliere la codifica corrispondente alla tua lingua. Se, per alcuni motivi, non vuoi cambiare inavvertitamente la codifica del file PO corrente, attiva l'opzione Mantieni la codifica del file.

Per ragioni di scambio di informazioni, &GNU; gettext limita le codifiche permesse per i file PO. &kbabel; non conosce queste restrizioni, e per questo la codifica corrispondente alla tua lingua potrebbe non essere adatta (UTF-8 è sempre supportato da &GNU; gettext).

### Controllo ortografico

Queste impostazioni sono per &kbabel;.

Qui puoi impostare le preferenze del correttore ortografico. Ciò ti interessa se hai un dizionario della lingua in cui stai traducendo. Sotto vi sono le voci di cui si esamina l'impostazione:

Crea combinazioni radici/affissi non nel dizionario

  Per le nuove parole aggiunte al dizionario personale, il correttore ortografico creerà combinazioni radici/affissi per corrispondere più di una parola (variazioni).

Considera le parole attaccate come errori di ortografia

  Se questa opzione è attivata, le parole attaccate saranno considerate errori. Tuttavia, tali parole sono molto comuni nella lingua tedesca, che ha moltissime parole composte, così, in quel caso, è meglio disattivare questa opzione.

Dizionario

  Dalla lista a comparsa puoi scegliere quale dizionario usare. Nota che è necessario installare un dizionario adatto per la propria lingua. Controlla la distribuzione di ispell o aspell per sapere se ne hai uno.

Codifica

  Qui scegli la codifica del testo. Questa opzione è passata al correttore ortografico, ed è usata come codifica per il proprio dizionario di parole. Per maggiori informazioni consulta la documentazione di kspell.

  La codifica selezionata qui non è collegata alle codifiche dei file PO. A seconda del tipo di correttore ortografico (specialmente nel caso di `ispell`), potresti non avere tanta scelta per la codifica (ad esempio, alcune lingue dell'Europa occidentale possono funzionare con `ispell` solo usando ISO-8859-1).

Client

  Programma da usare per il controllo ortografico. Al momento `ispell` (Ispell internazionale) o aspell.

Ricorda parole ignorate

  Tiene traccia delle parole ignorate dall'utente durante il controllo ortografico dei file PO. È molto conveniente ignorare le abbreviazioni o le strane combinazioni di lettere che si incontrano nelle interfacce grafiche.

File in cui memorizzare le parole ignorate

  Qui puoi impostare il percorso del file che contiene le parole ignorate. Fai clic sull'icona di una cartella alla destra della casella di testo. Il valore predefinito è `$`HOME`/.kde/share/apps/kbabel/spellignores`, dove `$`HOME`` rappresenta la tua cartella home.

### Riferimenti nel codice sorgente

Queste impostazioni sono per &kbabel;.

Impostazioni del progetto, riferimenti nel codice sorgente
Impostazioni del progetto, riferimenti nel codice sorgente

Questa finestra di dialogo serve a impostare il modo con cui KBabel dovrebbe costruire il percorso completo per ogni riferimento nel codice sorgente; questi riferimenti si trovano nei commenti di ogni voce di un file PO.

#### Elementi della finestra di dialogo

Nella casella di testo Cartella base per il codice sorgente puoi impostare una cartella base dove si trova il codice sorgente del tuo progetto. Ciò definisce il valore della variabile `@CODEROOT@`, descritta più avanti.

Nel gruppo Modelli di percorso puoi definire modelli o regole per costruire i percorsi con l'aiuto di alcune variabili, definite sotto: `@CODEROOT@`, `@PACKAGEDIR@`, `@PACKAGE@`, `@COMMENTPATH@`, `@POFILEDIR@`.

La variabile `@PODIRFILE@` è stata introdotta in &kbabel; versione 1.11.1 (per &kde; 3.5.1).

Con il pulsante Aggiungi puoi aggiungere ciò che è stato inserito nella casella di testo alla lista dei modelli di percorso usati. Con il pulsante Rimuovi puoi rimuovere il modello selezionato dalla lista. Con i pulsanti Su e Giù puoi modificare la priorità dei modelli di percorso.

#### Le variabili

- `@CODEROOT@`: la cartella base del codice sorgente.

- `@PACKAGEDIR@`: la cartella del pacchetto (&ie; il file PO).

- `@PACKAGE@`: il nome del pacchetto (&ie; il nome del file PO senza estensione).

- `@POFILEDIR@`: la cartella del file PO

- `@COMMENTPATH@`: il percorso relativo specificato nel commento di una voce nel file PO come riferimento ai sorgenti.

Le variabili `@PACKAGEDIR@` e `@POFILEDIR@` hanno un significato simile ma risultato diverso. La variabile `@POFILEDIR@` conterrà sempre la cartella del file PO, `@PACKAGEDIR@` potrebbe non averlo. Se il file PO è stato caricato con l'aiuto di &catalogmanager;, allora `@PACKAGEDIR@` ha solo la parte del percorso, basata sul percorso base del file PO definito per &catalogmanager; (guarda più avanti).

5

#### I modelli di percorso predefiniti

A partire da &kbabel; 1.11.1 (di &kde; 3.5.1) ci sono cinque modelli predefiniti di percorso:

- `@PACKAGEDIR@`/`@PACKAGE@`/`@COMMENTPATH@`

- `@CODEROOT@`/`@PACKAGEDIR@`/`@PACKAGE@`/`@COMMENTPATH@`

- `@CODEROOT@`/`@PACKAGE@`/`@COMMENTPATH@`

- `@POFILEDIR@`/`@COMMENTPATH@`

- `@POFILEDIR@`/../`@COMMENTPATH@`

I progetti &kde; richiedono tipicamente il terzo modello. L'ultimo modello è tipico di progetti &GNU;, dove i riferimenti ai sorgenti sono relativi alla directory genitore della directory dove si trova il file PO.

#### Creare nuovi modelli di percorso

Nella maggior parte dei casi, i modelli predefiniti di percorso dovrebbero essere sufficienti, indipendentemente se il progetto è per KDE (assumendo che hai impostato correttamente la directory base) o se il progetto è &GNU; (o strutturato come un progetto &GNU;).

Per &kde;, alcuni file PO non contengono abbastanza informazioni (includendo percorso e nome del file) affinché &kbabel; possa trovare il file sorgente corretto a cui il commento fa riferimento. Per correggere ciò, avresti bisogno di modelli precisi di percorso per tali file, e questi modelli sono quasi impossibile da definire a causa del numero di tali file in &kde;. Ma se lavori spesso con tali file, forse sarebbe meglio impostare esplicitamente un modello di percorso per supportare quel file PO.

Per creare modelli di percorso personalizzati, puoi usare le variabili definite sopra ma, a parte `@COMMENTPATH@`, non tutte le altre variabili devono essere obbligatoriamente usate (per essere esatti, neanche `@COMMENTPATH@` è obbligatoria, ma non usandola non otterrai alcun risultato).

Un esempio di modello di percorso potrebbe essere quello necessario per visualizzare i riferimenti nei sorgenti del file di &kde; desktop_kdebase.po. In quel caso, potresti aver bisogno di un percorso come: `@CODEROOT@`/`@PACKAGEDIR@`/kdebase/`@COMMENTPATH@` (paragonato con uno dei modelli predefiniti di percorso, la sequenza `@PACKAGE@` è stata sostituita da kdebase).

Nel caso di problemi veramente complessi puoi, ovviamente, definire un percorso assoluto senza alcuna variabile diversa da `@COMMENTPATH@`, come ad esempio: /home/utente/kde-source/kdebase/`@COMMENTPATH@` assumendo che /home/utente/kde-source/kdebase è il percorso in cui si trovano i sorgenti del modulo kdebase.

### Varie

Queste impostazioni sono per &kbabel;.

Nella sezione Varie vi sono impostazioni che non appartengono ad altre sezioni.

Marcatore per l'acceleratore da tastiera

  Qui puoi impostare il carattere che indica l'acceleratore da tastiera in una &GUI;. Il valore predefinito è & (e commerciale), ma può variare in alcune librerie di sviluppo. Per esempio, nelle traduzioni Gnome/GTK l'acceleratore da tastiera è rappresentato dal carattere _ (trattino basso).

Espressione regolare per le informazioni sul contesto

  Agli utenti inesperti "espressione regolare" può suonare strano. Per questo ti raccomandiamo di modificare il valore predefinito solo se sai cosa stai facendo. Alcune librerie di sviluppo di &GUI; hanno metodi propri di descrizione delle informazioni contestuali. Chiedi consiglio a uno sviluppatore esperto se traduci file PO diversi dai file standard di &kde;. Per il gusto della completezza "tradurrò" per te il significato dell'espressione regolare predefinita: "il testo corrisponde se inizia con _: ed è seguito da uno o più caratteri e termina con un carattere di fine linea".

### Cartelle del progetto

Queste impostazioni sono per &catalogmanager;.

Qui vi sono due caselle di testo con pulsanti con cartelle. Inserisci o seleziona le cartelle che contengono rispettivamente tutti i file PO e i file POT. I file e le cartelle in queste cartelle saranno uniti in un unico albero nella finestra della Gestione cataloghi.

Sotto puoi attivare e disattivare le seguenti opzioni:

Apri file in una nuova finestra

  Se questa opzione è attivata, tutti i file aperti dalla gestione cataloghi sono aperti in una nuova finestra.

Termina i processi quando esci

  Se attivi questa opzione, &kbabel; proverà a terminare i processi che non sono già stati terminati quando il programma termina, inviando loro un segnale di chiusura (kill).

  Non è garantito che i processi sono terminati.

Crea indice per il contenuto del file

  Se attivi questa opzione, &kbabel; creerà un indice dei contenuti per ogni file nell'albero. Questo indice è usato nelle operazioni di ricerca/sostituzione.

  C'è un ampio compromesso sulla velocità. Se abiliti la creazione dell'indice, l'aggiornamento delle informazioni dei file sarà molto più lento. Da un altro lato, ciò velocizza considerevolmente le operazioni di ricerca e sostituzione.

### Comandi per le cartelle

Queste impostazioni sono per &catalogmanager;.

Impostazioni del progetto, comandi per le cartelle
Impostazioni del progetto, comandi per le cartelle

Qui puoi inserire i comandi da eseguire nelle cartelle dalla gestione cataloghi. I comandi sono mostrati nel sottomenu Comandi del menu contestuale della gestione cataloghi.

Inserisci il nome del comando nel campo Etichetta del comando. Puoi inserire qualsiasi cosa come etichetta, ed è visualizzata solo nel menu. Nel campo Comando inserisci il comando da eseguire quando selezioni la corrispondente voce di menu. Quindi premi il pulsante Aggiungi per aggiungere il comando ai comandi disponibili. Per modificare un comando, selezionalo, premi il pulsante Modifica e premi Aggiungi dopo che hai finito. Per rimuovere un comando, selezionalo dalla lista e premi il pulsante Rimuovi. Se vuoi ordinare i comandi nel sottomenu contestuale, usa i pulsanti "Su" e "Giù".

Il comando è eseguito attraverso la shell predefinita, così puoi eseguire più comandi in una volta separandoli con punto e virgola, e puoi impostare, se necessario, variabili d'ambiente. I comandi sono eseguiti nella cartella (del file PO) che hai selezionato nella gestione cataloghi.

Le stringe seguenti saranno sostituite in un comando:

- `@PACKAGE@`: il nome della cartella senza percorso

- `@PODIR@`: il nome della cartella con file PO con percorso

- `@POTDIR@`: il nome della cartella con i modelli con percorso

Ad es.: se vuoi eseguire `make` e `make install` dovrai inserire `Make install` nel campo Nome e `make; make install` nel campo Comando. Se selezioni Comandi Make install dal menu contestuale di una cartella, saranno eseguiti in questa cartella i comandi sopra elencati.

### Comandi per i file

Queste impostazioni sono per &catalogmanager;.

Impostazioni del progetto, comandi per i file
Impostazioni del progetto, comandi per i file

Qui puoi inserire i comandi da eseguire sui file dalla gestione cataloghi. I comandi sono mostrati nel sottomenu Comandi del menu contestuale della gestione cataloghi.

Inserisci il nome del comando nel campo Etichetta del comando. Puoi inserire qualsiasi cosa come etichetta, ed è visualizzata solo nel menu. Nel campo Comando inserisci il comando da eseguire quando selezioni la corrispondente voce di menu. Quindi premi il pulsante Aggiungi per aggiungere il comando ai comandi disponibili. Per modificare un comando selezionalo, premi il pulsante Modifica e premi Aggiungi dopo che hai finito. Per rimuovere un comando, selezionalo dalla lista e premi il pulsante Rimuovi. Se vuoi ordinare i comandi nel sottomenu contestuale, usa i pulsanti "Su" e "Giù".

Il comando è eseguito attraverso la shell predefinita, così puoi eseguire più comandi in una volta separandoli con il punto e virgola, e puoi impostare, se necessario, variabili d'ambiente. I comandi sono eseguiti nella cartella (del file PO), nel quale si trova il file che hai selezionato nella gestione cataloghi.

Le stringe seguenti saranno sostituite in un comando:

- `@PACKAGE@`: il nome del file senza percorso e senza estensione

- `@POFILE@`: il nome del file PO con percorso ed estensione

- `@POTFILE@`: il nome del corrispondente modello con percorso ed estensione

- `@PODIR@`: il nome della cartella, nella quale si trova il file PO, con percorso

- `@POTDIR@`: il nome della cartella, nella quale si trova il modello, con percorso

Per esempio: se vuoi fondere il modello con il tuo file PO inserisci `Fondi` nel campo Nome e `msgmerge @POFILE@ @POTFILE@ > @PACKAGE@.new && mv @PACKAGE@.new "@PACKAGE@.po` nel campo Comando. Se selezioni Comandi Fondi dal menu contestuale di un file, il file PO sarà fuso con il suo modello.

### Gestione cataloghi

Queste impostazioni sono per &catalogmanager;.

Impostazioni del progetto, &catalogmanager;
Impostazioni del progetto, &catalogmanager;

Le caselle mostrano o nascondono le colonne corrispondenti nella vista di &catalogmanager;.

### Confronto

Queste impostazioni sono per &catalogmanager;.

Impostazioni del progetto, confronto
Impostazioni del progetto, confronto