# Manuale di &kmouth;

## Introduzione

&kmouth; è un'applicazione che permette alle persone che non possono parlare di far parlare il loro computer. Include una cronologia di frasi pronunciate dalla quale l'utente può selezionare le frasi da pronunciare.

Nota che &kmouth; non include un sintetizzatore vocale. Richiede invece un sintetizzatore vocale installato nel sistema.

## Uso di &kmouth;

### Il primo avvio

Durante il primo avvio di &kmouth;, viene mostrato un programma assistente nel quale puoi inserire una configurazione di base.

Configurazione della pronuncia Configurazione della pronuncia

Con la prima pagina dell'assistente specifichi il comando che sarà usato più tardi per la conversione da testo a parlato. Per maggiori dettagli guarda la descrizione della finestra di configurazione.

Frasario iniziale Frasario iniziale

Nella seconda pagina selezioni di quali frasari standard hai bisogno. Potrai più tardi selezionare dai frasari le frasi usate di frequente, così non dovrai scriverle. Ovviamente &kmouth; ha anche una finestra di dialogo di modifica nel caso che più tardi volessi modificare i tuoi frasari.

Completamento delle parole Completamento delle parole

Con la terza pagina definisci il dizionario per il completamento delle parole. &kmouth; analizzerà la documentazione di &kde; della lingua scelta per rilevare la frequenza delle singole parole. A scelta puoi confrontare l'elenco delle parole con un dizionario di OpenOffice.org per aggiungere delle parole ortograficamente corrette al completamento delle parole.

### La finestra principale

La finestra principale di &kmouth; è piuttosto semplice. Consiste sostanzialmente di un campo di testo nel quale scrivi le tue frasi (il campo bianco in basso nell'immagine), e una cronologia delle frasi pronunciate (il campo bianco in alto nell'immagine).

La finestra principale di &kmouth; La finestra principale di &kmouth;

Ammesso che tu abbia correttamente configurato &kmouth; puoi usare il campo di testo per inserire le frasi che vuoi ascoltare. Una volta che una frase è pronunciata sarà aggiunta alla cronologia. Dalla cronologia puoi scegliere le frasi da pronunciare.

Dai frasari (situati nella linea sotto la barra degli strumenti) puoi scegliere le frasi usate frequentemente.

### La finestra di dialogo di configurazione

Usando la voce del menu Impostazioni Configura &kmouth; apri la finestra di configurazione di &kmouth;. Questa finestra consiste di due schede, Preferenze e Pronuncia, la pagina Completamento parole e la pagina Servizio vocale Jovie.

#### La scheda Preferenze

La scheda Preferenze Immagine

La scheda Preferenze contiene opzioni che alterano il comportamento di &kmouth; in certe situazioni.

Nel primo menu a cascata, Selezione di frasi nel frasario:, specifichi quale azione viene avviata scrivendo la scorciatoia di una frase o selezionando una frase nel menu Frasario o nella barra dei frasari.

Selezionando Pronuncia subito, la frase selezionata viene immediatamente pronunciata e inserita nella cronologia. Se selezioni Inserisci nel campo di modifica la frase selezionata è solamente inserita nel campo di modifica.

Con la seconda casella combinata, Chiusura della finestra di modifica del frasario:, specifichi se il frasario debba essere salvato se semplicemente chiudi la finestra di modifica del frasario.

Selezionando Salva frasario il frasario verrà salvato. Se selezioni Scarta le modifiche le modifiche sono scartate e il frasario non viene salvato. Se selezioni Chiedi se salvare, &kmouth; ti chiederà se deve salvare il frasario.

#### La scheda Pronuncia

La scheda Pronuncia Immagine

Nel campo di testo della scheda Pronuncia inserisci il comando per chiamare il sintetizzatore vocale. Con il menu a cascata in basso specifichi la codifica usata per passare il testo al sintetizzatore vocale.

&kmouth; conosce due modi per passare il testo: se il comando si aspetta del testo come input standard seleziona la casella.

L'altro modo è passare il testo come parametro. Prima di chiamare il comando &kmouth; sostituisce certi segnaposti con il contenuto vero e proprio:

Segnaposto | Sostituito con
%t | Il testo che dovrebbe essere pronunciato
%f | Il nome di un file temporaneo che contiene il testo che dovrebbe essere pronunciato
%l | Il codice della lingua associata con l'attuale dizionario di completamento delle parole
%% | Un segno di percentuale

Ovviamente il comando per pronunciare i testi dipende da quale sintetizzatore vocale usi. Controlla la documentazione del tuo sintetizzatore vocale riguardo il comando per pronunciare testi. Puoi trovare esempi del comando nell'appendice.

Selezionando Usa il servizio vocale Jovie se possibile dici a &kmouth; di provare prima a inviare al servizio vocale Jovie. Se ciò ha successo le altre voci di configurazione in questa scheda sono ignorate. Il servizio vocale Jovie è un demone di &kde; che dà alle applicazioni &kde; un'interfaccia standardizzata per la sintesi vocale ed è attualmente in sviluppo in Git. È sicuro selezionare questa opzione anche se Jovie non è installato.

#### La pagina Completamento delle parole

La pagina Completamento delle parole Immagine

La pagina Completamento delle parole contiene un elenco di dizionari usati per il completamento delle parole (&kmouth; mostrerà una casella combinata di fianco al campo di modifica nella finestra principale se questo elenco contiene più di un dizionario. Puoi usare questa casella combinata per selezionare il dizionario che viene usato all'atto pratico per il completamento delle parole).

Con i pulsanti sul lato destro della pagina puoi aggiungere ed eliminare dizionari, cambiare l'ordine dei dizionari o esportare dizionari in un file. Con il campo Modifica e la casella combinata sotto l'elenco puoi cambiare il nome e la lingua associati al dizionario.

Quando aggiungi un nuovo dizionario puoi scegliere tra diverse fonti:

- Crea un nuovo dizionario dalla documentazione di &kde;

  Se usi questa fonte &kmouth; ti chiederà la lingua desiderata e quindi analizzerà la documentazione di &kde;. La frequenza delle singole parole è rilevata semplicemente contando le presenze di ciascuna parola. A tua scelta puoi confrontare l'elenco delle parole con un dizionario di OpenOffice.org per aggiungere al nuovo dizionario solo parole ortograficamente corrette.

- Crea un nuovo dizionario da un file

  Se usi questa fonte, &kmouth; ti chiederà il file desiderato. Puoi scegliere un file &XML;, un normale file di testo o un file contenente un dizionario di completamento delle parole creato da &kmouth; o GOK (la tastiera a schermo di GNOME). Se scegli un normale file di testo o un file &XML;, la frequenza delle singole parole è rilevata semplicemente contando le presenze di ciascuna parola. A tua scelta puoi confrontare l'elenco delle parole con un dizionario di OpenOffice.org per aggiungere al nuovo dizionario solo parole ortograficamente corrette.

- Crea un nuovo dizionario da una cartella

  Se usi questa fonte, &kmouth; ti chiederà la cartella desiderata. &kmouth; aprirà tutti i file in quella cartella e nelle sue sottocartelle. Ogni file è caricato come dizionario di completamento, come file &XML; o come un file di testo semplice. Nell'ultimo caso le presenze di ciascuna parola sono contate. A tua scelta puoi confrontare l'elenco delle parole con un dizionario di OpenOffice.org per aggiungere al nuovo dizionario solo parole ortograficamente corrette.

- Unisci dizionari

  Puoi usare questa opzione per unire i dizionari disponibili. &kmouth; ti chiederà quali dizionari dovranno essere uniti e come i singoli dizionari dovranno essere pesati.

- Crea un elenco di parole vuoto

  Puoi usare questa opzione per creare un dizionario vuoto senza nessuna voce. Siccome &kmouth; aggiunge continuamente le parole scritte di recente ai dizionari, esso imparerà il tuo vocabolario col tempo.

#### La pagina Servizio vocale Jovie

La configurazione del servizio vocale di &kde; viene descritta in dettaglio nel manuale di Jovie.

### La finestra di modifica dei frasari

Usando la voce del menu Frasari Modifica apri la finestra di modifica dei frasari.

La finestra di modifica dei frasari Immagine

L'area principale della finestra di modifica dei frasari è divisa in due parti. All'interno della parte superiore i frasari sono mostrati in qualche vista ad albero.

All'interno della parte inferiore puoi modificare un elemento selezionato. Se hai selezionato una frase puoi modificarne sia il contenuto che la sua scorciatoia. Se hai selezionato un frasario, puoi solo modificarne il nome.

Azioni come aggiungere nuove frasi e frasari, e cancellare frasi e frasari selezionati, si possono eseguire selezionandoli nella barra del menu, la barra degli strumenti o un menu a comparsa.

Puoi cambiare l'ordine dei frasari e delle frasi trascinandoli ai loro nuovi posti, o usando i tasti freccia tenendo premuto il tasto &Alt;.

## Guida ai comandi

### Comandi all'interno della finestra principale

#### Il menu File

&Ctrl;O File Apri come cronologia

- Apre un file di testo come una cronologia di frasi pronunciate.

&Ctrl;S File Salva cronologia come

- Salva la cronologia in un file di testo.

&Ctrl;P File Stampa cronologia

- Stampa la cronologia.

&Ctrl;Q File Esci

- Termina &kmouth;

#### Il menu Modifica

&Ctrl;X Modifica Taglia

- Taglia la sezione selezionata e la inserisce negli appunti. Se c'è del testo selezionato nel campo modifica, è messo negli appunti. Altrimenti le frasi selezionate (se ce ne sono) nella cronologia sono messe negli appunti.

&Ctrl;C Modifica Copia

- Copia la sezione selezionata negli appunti. Se c'è del testo selezionato nel campo modifica, è messo negli appunti. Altrimenti le frasi selezionate (se ce ne sono) nella cronologia sono copiate negli appunti.

&Ctrl;V Modifica Incolla

- Incolla i contenuti degli appunti nella posizione corrente del cursore nel campo modifica.

Modifica Pronuncia

- Pronuncia le frasi attualmente attive. Se c'è del testo nel campo modifica è pronunciato. Altrimenti le frasi selezionate nella cronologia (se ce ne sono) sono pronunciate.

#### Il menu Frasari

Frasari Modifica

- Apre la finestra di modifica dei frasari.

&kmouth; ha le normali voci del menu di &kde; Impostazioni e Aiuto; per maggiori informazioni leggi la sezione sul menu Impostazioni e sul menu Aiuto dei fondamentali di &kde;.

#### Il menu a comparsa delle voci di cronologia

Pronuncia

- Le frasi selezionate sono pronunciate.

Elimina

- Le frasi selezionate sono rimosse dalla cronologia.

Taglia

- Le frasi selezionate sono cancellate e messe negli appunti.

Copia

- Le frasi selezionate sono copiate negli appunti.

Seleziona tutte le voci

- Tutte le voci della cronologia vengono selezionate.

Deseleziona tutte le voci

- Tutte le voci della cronologia vengono deselezionate.

&Ctrl;O Apri come cronologia

- Apre un file di testo come una cronologia di frasi pronunciate.

&Ctrl;S Salva cronologia come

- Salva la cronologia in un file di testo.

### Comandi all'interno della finestra di modifica dei frasari

#### Il menu File

File Nuova frase

- Aggiunge una nuova frase.

File Nuovo frasario

- Aggiunge un nuovo frasario.

&Ctrl;S File Salva

- Salva il frasario.

File Importa

- Importa un file e ne aggiunge i contenuti al frasario

File Importa frasario standard

- Importa un frasario standard e ne aggiunge i contenuti nel frasario

File Esporta

- Esporta le frasi o i frasari correntemente selezionati in un file

&Ctrl;P File Stampa

- Stampa le frasi o i frasari attualmente selezionati

&Ctrl;W File Chiudi

- Chiude la finestra

#### Il menu Modifica

&Ctrl;X Modifica Taglia

- Taglia gli elementi selezionati e li mette negli appunti.

&Ctrl;C Modifica Copia

- Copia gli elementi selezionati negli appunti.

&Ctrl;V Modifica Incolla

- Incolla il contenuto degli appunti nel frasario.

Modifica Elimina

- Elimina gli elementi selezionati.

#### Il menu Aiuto

Gli elementi di questo menu sono gli stessi della finestra principale.

#### Il menu a comparsa

Nuova frase

- Aggiunge una nuova frase.

Nuovo frasario

- Aggiunge un nuovo frasario.

Importa

- Importa un file e ne aggiunge i contenuti al frasario

Importa frasario standard

- Importa un frasario standard e ne aggiunge i contenuti nel frasario

Esporta

- Esporta le frasi o i frasari correntemente selezionati in un file

&Ctrl;X Taglia

- Taglia gli elementi selezionati e li mette negli appunti.

&Ctrl;C Copia

- Copia gli elementi selezionati negli appunti.

&Ctrl;V Incolla

- Incolla il contenuto degli appunti in questa posizione del frasario.

Elimina

- Elimina gli elementi selezionati.

## Domande e risposte

&reporting.bugs; &updating.documentation;

Non sento nulla.

Probabilmente non hai configurato correttamente (o per niente?) il comando di pronuncia. Usa Impostazioni Configura &kmouth;, apri la pagina Opzioni generali, e inserisci il comando per pronunciare testi nella scheda Pronuncia (Vedi la sezione riguardo alla finestra di configurazione per il sintetizzatore vocale per ulteriori dettagli).

## Riconoscimenti e licenza

&kappname;

Copyright del programma 2002-2004 Gunnar Schmi Dt gunnar@schmi-dt.de

Copyright della documentazione 2002-2004 Gunnar Schmi Dt gunnar@schmi-dt.de

Copyright della documentazione italiana 2003 Federico Zenithfederico.zenith@member.fsf.org

&underFDL; &underGPL;

## Esempi per la configurazione della pronuncia

Festival

Festival è un sistema di pronuncia scritto dall'università di Edimburgo. Attualmente supporta parlato inglese, spagnolo e gallese. La sua licenza ne permette l'uso e la redistribuzione gratuiti senza restrizioni.

Per creare l'esempio da riga di comando per la configurazione di pronuncia assumiamo che Festival sia installato nella cartella `/usr/local/festival/`. Il comando per pronunciare testi è come segue:

    /usr/local/festival/bin/festival --tts

L'opzione Invia i dati come ingresso standard deve essere attivata.

FreeTTS

FreeTTS è un sintetizzatore vocale scritto interamente nel linguaggio di programmazione &Java;™. Attualmente ha supporto solo per la pronuncia inglese. La sua licenza ne permette l'uso e la redistribuzione gratuiti senza restrizioni.

Per creare l'esempio da riga di comando per la configurazione di pronuncia assumiamo che FreeTTS sia installato nella cartella `/usr/local/freetts/`. Il comando per pronunciare testi è uno dei tre esempi seguenti:

    java -jar /usr/local/freetts/lib/freetts.jar -text %t

    java -jar /usr/local/freetts/lib/freetts.jar -file %f

    java -jar /usr/local/freetts/lib/freetts.jar

Per il terzo esempio l'opzione Invia i dati come ingresso standard deve essere abilitata (questo è l'esempio preferito per l'uso con FreeTTS).

MBROLA

MBROLA è un sintetizzatore vocale per un gran numero di lingue. Converte un elenco di fonemi in un file wave, quindi hai bisogno di qualche altro strumento per convertire il testo in una lista di fonemi. La licenza di MBROLA ne permette l'uso gratuito per applicazioni non commerciali e non militari.

Per il nostro esempio useremo Hadifax per convertire testo tedesco in un elenco di fonemi adatto a MBROLA. Assumeremo che Hadifax e MBROLA siano installati in `/usr/local/hadifax/` e `/usr/local/mbrola/`.

Sfortunatamente Hadifax tende a ingoiarsi l'ultimo carattere di testo, quindi potremo aggiungere al testo un carattere aggiuntivo. Il comando completo è quindi più complesso che negli esempi precedenti:

    (cat -; echo " ") | /usr/local/hadifax/txt2pho -f
              | /usr/local/mbrola/mbrola -e
              /usr/local/mbrola/de1/de1 - /tmp/tmp.wav;
              paplay /tmp/tmp.wav; rm /tmp/tmp.wav

Tutte le parti di questo comando devono essere scritte in una riga. L'opzione Invia i dati come ingresso standard deve essere abilitata.

Il demone di pronuncia di &kde;

Il demone di pronuncia di &kde; (Jovie) è un servizio di pronuncia esteso a tutto &kde; che dà alle applicazioni di &kde; un'interfaccia standard per la sintesi vocale, ed è attualmente in sviluppo su Git. Usa delle estensioni per supportare vari sistemi di pronuncia.

Essendo la configurazione del sintetizzatore vocale fatta in Jovie, l'unica opzione di &kmouth; che devi attivare è Usa il servizio vocale Jovie se possibile.

Ovviamente devi configurare Jovie. Puoi farlo con la pagina di configurazione Servizio vocale Jovie che viene aggiunta alla finestra di configurazione di &kmouth; se Jovie è installato.

## Installazione

### Come ottenere &kmouth;

&install.intro.documentation;

### Requisiti

Per usare correttamente &kmouth; serve un sintetizzatore vocale.

### Compilazione e installazione

&install.compile.documentation;