# Guida al traduttore di &kturtle;

Come sai, la grande importanza del linguaggio &logo; è che i comandi del &logo; possono essere tradotti nella tua lingua. Ciò rende semplice per un bambino capire i comandi. Per una nuova lingua, ci sono 3 file da tradurre: per primo il file con le parole chiave (o comandi), quindi il file con l'evidenziazione del &logo; e infine gli esempi.

## Come tradurre le parole chiave del &logo; (comandi)

I file dei comandi si trovano in `kdeedu/kturtle/src/data/keywords/`. Ogni file è chiamato `logokeywords.`codice`.xml` dove `codice` è il codice ISO del tuo paese (nota che deve essere un codice ISO valido).

- Copia il file `logokeywords.en_US.xml` rinominandolo in `logokeywords.`codice`.xml` dove `codice` è il codice della tua lingua (codice ISO a 2 o 4 lettere).

- Traduci nella tua lingua, quando è possibile, il contenuto della tag `keyword` (&ie; le informazioni tra `keyword` e `keyword`). Traduci anche il contenuto della tag `alias`, (&ie; le informazioni tra `alias` e `alias`). Questi contenuti si riferiscono alla parola chiave dato che l'alias è un'abbreviazione della parola chiave.

  Per esempio traduci while in: `keyword`while`keyword`

  Non tradurre altro e non tradurre le parole inglesi in `command name="english_word"`. Queste parole devono rimanere in inglese.

- Salava il tuo file come UTF-8 (in &kate;, usa Salva con nome... e scegli utf8 nella casella alla destra del nome del file).

- Fai il commit del tuo file (aggiungi il nome del tuo file nel file `Makefile.am`) o invialo a Anne-Marie.

- In caso di dubbio, contatta Anne-Marie Mahfouf annemarie.mahfouf@free. fr per maggiori informazioni.

## Come tradurre i file di evidenziazione della sintassi

I file dell'evidenziazione della sintassi si trovano in `kdeedu/kturtle/src/data/highlightstyle/`. Ogni file è chiamato `logohighlightstyle.`codice`.xml` dove `codice` è il codice ISO del tuo paese (nota che deve essere un codice ISO valido). Nota che il codice del paese qui deve essere lo stesso di quello nel file `logokeywords` e della cartella degli esempi.

- Copia il file `logohighlightstyle.en_US.xml` rinominandolo in `logohighlightstyle.`codice`.xml` dove `codice` è il codice del tuo paese (il codice ISO a 2 o 4 lettere)

- Nella linea 4 del file, c'è `language name="en_US"`...: Cambia qui en_US con il codice ISO della tua lingua (a 2 o 4 lettere).

- Traduci nella tua lingua il contenuto della tag `item` (&ie; le informazioni tra `item` e `item`). Questo contenuto deve corrispondere al file `logokeyword`. Per esempio traduci while in: `item` while `item` e lascia gli spazi come sono (uno all'inizio e uno alla fine). Non tradurre nient'altro.

- Salava il tuo file come UTF-8 (in &kate;, usa Salva con nome... e scegli utf8 nella casella alla destra del nome del file).

- Fai il commit del tuo file (aggiungi il nome del tuo file nel file `Makefile.am`) o invialo a Anne-Marie.

- In caso di dubbio, contatta Anne-Marie Mahfouf annemarie.mahfouf@free. fr per maggiori informazioni.

## Come tradurre gli esempi

Gli esempi si trovano nei sorgenti di &kturtle; nella cartella `kdeedu/kturtle/examples`.

- Crea una cartella con il codice ISO della tua lingua come nome.

- Copia gli esempi inglesi in questa cartella e rinomina i file con la loro traduzione nella tua lingua. Ciò permetterà agli utenti di leggere e capire facilmente a cosa si riferisce ogni esempio.

- Guarda in `kturtle/src/data/keywords/` il file corrispondente alla tua lingua. Questo file deve essere tradotto prima di tradurre gli esempi. Sostituisci negli esempi tutte le parole chiave in inglese con le parole chiave tradotte da te.

- Salava il tuo file come UTF-8 (in &kate;, usa Salva con nome... e scegli utf8 nella casella alla destra del nome del file)

- Fai il commit della tua cartella (aggiungi dentro un file `Makefile.am`) o inviala a Anne-Marie.

- In caso di dubbio, contatta Anne-Marie Mahfouf, annemarie.mahfouf@free.fr per maggiori informazioni.

- Infine, se vuoi, puoi aggiungere i tuoi esempi in questa cartella.