# Guida al traduttore di &kturtle;

Come sai, una delle migliori caratteristiche del linguaggio di programmazione &logo; è che i comandi del &logo; sono spesso tradotti nella lingua del programmatore. Ciò elimina quelle barriere che rendono difficile ai principianti comprendere le basi della programmazione. Quando traduci &kturtle; in una nuova lingua devono essere tradotti alcuni file in più rispetto alle stringhe e alla documentazione normale. La maggior parte di ciò può essere automaticamente generata dagli script di Rafael Beccar. Questi script si trovano in `kdeedu/kturtle/scripts`, i file che richiedono traduzione in `kdeedu/kturtle/data`, in queste directory trovi anche i file README che contengono le istruzioni per usarli/tradurli.

## Creare una directory per memorizzare i file tradotti

Come prima cosa, devi creare una directory dove memorizzare i file tradotti. Crea una directory chiamata `kde-i18n/codice/data/kdeedu/kturtle/` nella tua directory del CVS di KDE, dove codice è il codice del tuo paese (il codice ISO a 2 o 4 lettere).

Copia il file `Makefile.am` da `kdeedu/kturtle/data/` in questa directory. Aprilo usando il tuo editor di testi preferito, sostituisci tutte le occorrenze di en_US nel file con il codice del tuo paese (quello usato sopra) e salva il file.

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

- Copia il file `logokeywords.en_US.xml` da `kdeedu/kturtle/data/` nella directory che hai creato, e rinominalo in `logokeywords.codice.xml` dove codice è il codice del tuo paese (codice ISO a 2 o 4 lettere).

- Traduci nella tua lingua, dove è possibile, i contenuti del tag `keyword` (&ie; le informazioni tra `keyword` e `keyword`). Traduci anche i contenuti del tag `alias`, (&ie; le informazioni tra `alias` e `alias`): questi sono usati come scorciatoie per la 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.

  Un'ultima cosa: non modificare l'ordine di questo file, dato che ciò è richiesto dagli script di Rafael Beccar di generazione automatica della traduzione.

- 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

Tradurre `logohighlightstyle.en_US.xml` è un soffio usando lo script di Rafael Beccar in `kdeedu/kturtle/data/`. Assicurati di aver letto il file README in quella directory.

Per compatibilità con tutte le persone che non vogliono il supporto degli script in perl citati nel paragrafo precedente, qui vi è il classico modo di farlo:

- Copia il file `logohighlightstyle.en_US.xml` da `kdeedu/kturtle/data/` nella directory che hai creato per memorizzare il file delle parole chiave tradotto, e rinominalo 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 del 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

Nuovamente, questo compito è semplificato molto dallo script di Rafael Beccar in `kdeedu/kturtle/data/`. Assicurati di aver letto il file README in quella directory, dato che è necessario fare un po' di lavoro dopo aver tradotto automaticamente i file di esempio del logo.

Quando hai seguito le istruzioni, che si trovano nel file README che puoi trovare nella directory degli script, dovresti aver quasi finito. Non ti dimenticare di provare i file di esempio del logo tradotti che hai creato, dato che è molto comune che vi si nascondano errori. Assicurati anche che `Makefile.am` in `kde-i18n/codice/data/kdeedu/kturtle/` sia aggiornato con i nuovi file. Per l'olandese il file `Makefile.am` dovrebbe più o meno simile a questo:

    txt_DATA = advertentie.logo driehoeken.logo krullen.logo tafels.logo \
    bloem.logo driehoek.logo logohighlightstyle.nl.xml pijl.logo vierkanten.logo \
    kleuren.logo logokeywords.nl.xml randomnaam.logo vierkant.logo
    txtdir = $(kde_datadir)/kturtle/examples/nl

    xml_DATA = logohighlightstyle.nl.xml
    xmldir = $(kde_datadir)/katepart/syntax

    keywords_DATA = logokeywords.nl.xml
    keywordsdir = $(kde_datadir)/kturtle/data
    EXTRA_DIST = $(txt_DATA) $(xml_DATA) $(keywords_DATA)

Qui vi è una descrizione di come fare per tradurre SENZA usare gli script in perl di Rafael:

- Copia i file d'esempio inglesi da `kdeedu/kturtle/data/` nella directory usata per memorizzare i file delle parole chiave e di evidenziazione tradotti. Traduci i nomi di file degli esempi nella tua directory: ciò permetterà agli utenti di capire facilmente e velocemente a cosa si riferisce l'esempio.

- Traduci le parole chiave negli esempi, usando quelle nel file `logokeywords.xml` della tua lingua. Prima di tradurre gli esempi deve essere fatto il file delle parole chiave.

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