# Manuale di &jovie;

Jeremy
Whiting
jpwhiting@kde.org
Gary
R.
Cramblitt
garycramblitt@comcast.net
Federico
Zenith

    federico.zenith@member.fsf.org

Traduzione della documentazione in italiano
2009
Jeremy Whiting
2004-2005
Gary R. Cramblitt
&FDLNotice;
2010-05-31
0.6 (&kde; 4.5)

&jovie; - il sistema di pronuncia di &kde; - è un servizio basato su estensioni che permette a qualsiasi applicazione di &kde; (o non di &kde;) di parlare usando l'interfaccia &DBus;.

&jovie; vuole essere l'implementazione dell'API di pronuncia di &kde;.

KDE
accessibilità
kdeaccessibility
TTS
Pronuncia
Jovie
speech-dispatcher
espeak
festival
flite
hadifix
MBROLA
freetts
epos
SSML

## Introduzione

&jovie; è un sottosistema all'interno di &kde; per la pronuncia (TTS). Fornisce un'API comune per i programmatori di &kde; per dare capacità TTS alle loro applicazioni. Fornisce alcune capacità interessanti anche agli utenti.

Funzionalità per gli utenti:

- Pronuncia i contenuti di un file di testo.

- Pronuncia gli eventi di notifica di &kde; (KNotify).

- Pronuncia tutto o parte del testo di una pagina Web in &konqueror;.

- Pronuncia tutto o parte del testo nell'editor di testo &kate;, inclusi i casi in cui &kate; sia incorporato in un'altra applicazione di &kde;.

- Il testo viene pronunciato dal programma speech-dispatcher, che può usare diversi motori (espeak, festival, eccetera).

- Filtri configurabili dall'utente per sostituire le parole pronunciate male, scegliere i sintetizzatori vocali, e trasformare i documenti XHTML/&XML;.

Funzionalità per i programmatori:

- Sistema di priorità per gli output di lettura a schermo, gli avvertimenti e i messaggi, durante la riproduzione di testi normali.

- Permette la generazione di parlato dalla riga di comando (o attraverso script della shell) usando il programma &qdbus;.

- Fornisce un'interfaccia leggera e facile da usare per far generare output parlato alle applicazioni.

- Le applicazioni non devono preoccuparsi di contendersi il dispositivo di pronuncia.

- In futuro: fornirà supporto per linguaggi a marcatori per il parlato, come VoiceXML, Sable, &Java; Speech Markup Language (JSML), e Speech Markup Meta-language (SMML).

- In futuro: fornirà supporto limitato per i marcatori di pronuncia incorporati.

- Asincrono per evitare il blocco del sistema.

&jovie; consiste in realtà di più programmi:

`jovie`

  il demone di pronuncia di &kde;, che è un'applicazione che fornisce servizi TTS alle applicazioni attraverso &DBus;. È anche presente nel vassoio di sistema.

`libkhtmlkttsdplugin`

  Un'estensione per il browser Web &konqueror; che ti permette di pronunciare tutto o parte del testo di una pagina Web.

`ktexteditor_kttsd`

  Un'estensione per l'editor di testo &kate; che ti permette di pronunciare tutto o una parte di un file di testo.

### Supporto

Oltre alla banca dati Bugzilla di &kde; (http://bugs.kde.org/), le discussioni su &jovie; hanno attualmente luogo sulla mailing list kde-accessibility. Iscriviti a https://mail.kde.org/mailman/listinfo/kde-accessibility. Gli sviluppatori si possono incontrare anche su IRC (irc.kde.org, canale #kde-accessibility).

## Usare &jovie;

Prima di poter usare &jovie;, devi installare speech-dispatcher e assicurarti che funzioni. Vedi .

### Avviare `jovie`

Per avviare il sistema &jovie;, digita il comando seguente in una &konsole;

`jovie`

e fai clic su &jovie; nel menu di &kde;.

Se questa è la prima volta che esegui `jovie`, o se non hai ancora configurato nessun oratore, appare la schermata Oratori. Vedi . Se hai già configurato almeno un oratore, appare la schermata Generale. Vedi .

### Configurare gli oratori

La maggior parte dei sintetizzatori da voce a testo offrono più lingue e voci, e possono offrire più generi, volumi e velocità. Puoi configurare più di un'istanza di un sintetizzatore. Ogni combinazione di lingua, sintetizzatore, voce, genere, volume e velocità è detta un oratore. Dovresti configurare almeno un oratore prima di usare &jovie;, altrimenti speech-dispatcher userà una voce predefinita.

Avere più oratori per lo stesso sintetizzatore è simile ad avere più code di stampa per la stessa stampante fisica.

Quando fai clic sulla linguetta Oratori in `jovie`, appare la schermata Oratori. Questa schermata appare automaticamente anche se avvii `jovie` e non hai ancora configurato nessun oratore.

Il gestore della pronuncia di &kde; (scheda Oratori). Il gestore della pronuncia di &kde; (scheda Oratori)

Fai clic per aggiungere un nuovo oratore.

Qui sono elencati tutti gli oratori configurati. Gli oratori di priorità massima sono elencati in alto. L'oratore in cima sarà usato per la pronuncia quando un'applicazione non ne specifica uno.

Fai clic su un oratore nell'elenco per evidenziarlo e fai clic su questo pulsante per rimuoverlo.

Fai clic su un oratore nell'elenco per evidenziarlo e fai clic su questo pulsante per cambiarne la configurazione. Vedi sotto.

Fai clic su un oratore nell'elenco per evidenziarlo e fai clic su questo pulsante per spostarlo in basso di una riga nell'elenco. Più in basso un oratore è nell'elenco, minore è la sua priorità.

Fai clic su questi pulsanti per applicare i cambiamenti apportati al sistema &jovie; in esecuzione.

Quando fai clic sul pulsante Aggiungi, appare la schermata Aggiungi oratore.

La schermata Aggiungi oratore. La schermata Aggiungi oratore

Dovresti dare al nuovo oratore un nome, può essere qualsiasi cosa.

Scegli qui una lingua e un sintetizzatore.

Scegli qui il tipo di voce, ci sono tre voci maschili, tre femminili, una maschile infantile e una femminile infantile tra cui scegliere.

Imposta qui eventuali altri parametri di voce.

Quando fai clic qui, il tuo nuovo oratore apparirà nell'elenco della schermata Oratori. Fai clic sul pulsante Modifica per modificarne la configurazione.

Sei quasi pronto per iniziare a usare &jovie;. Ora ritorna alla schema Generale e segna la casella Abilita il sistema di pronuncia (Jovie). Ciò avvierà il demone TTS di &kde;. Vedi . Puoi ora iniziare a usare &jovie; per pronunciare del testo. Fai clic sulla scheda Processi per creare e gestire processi di testo. Vedi .

### Avviare &jovie; e impostare le opzioni generali

Una volta che hai configurato almeno un oratore, puoi avviare il sistema di pronuncia di &kde;. Fai clic sulla scheda Generale. Apparirà la schermata Generale. Puoi anche impostare alcune opzioni generali in questa schermata.

Il gestore della pronuncia di &kde; (scheda Generale). Il gestore della pronuncia di &kde; (scheda Generale)

Segna questa casella per attivare il sistema &jovie;. Ciò avvia il demone TTS di &kde; (&jovie;). Se &jovie; è avviato correttamente, apparirà la scheda Processi. Una volta che &jovie; è stato avviato, puoi iniziare a creare e pronunciare processi di testo. Vedi . Deselezionarla fermerà &jovie; e disattiverà il sistema TTS di &kde;.

Assicurati di fare clic qui per salvare le tue impostazioni.

### Gestire i processi di testo

Quando fai clic sulla linguetta Processi in `jovie`, appare la schermata Processi.

Il gestore della pronuncia di &kde; (scheda Processi).
Il gestore della pronuncia di &kde; (scheda Processi)

Questi controlli permettono di cambiare gli attributi della voce attuale.

I pulsanti in questa riga ti permettono di fermare, annullare, mettere in pausa e riprendere il processo di testo attuale.

I pulsanti in questa riga ti permettono di pronunciare il testo attualmente negli appunti di &kde;, o aprire un file di testo da pronunciare. Puoi anche cambiare l'oratore di un processo.

Quando fai clic su OK o Applica, tutte le modifiche alle impostazioni su altri schermi vengono applicate (se ce ne sono).

La scheda Processi appare solo quando Jovie è in esecuzione. Se non vedi la scheda Processi, fai clic sulla linguetta Generale e segna la casella Abilita il sistema di pronuncia (Jovie).

### Pronunciare il testo di pagine Web

Mentre usi il browser Web &konqueror; di &kde;, puoi pronunciare il testo della pagina Web visualizzata. Innanzi tutto assicurati che &jovie; sia in esecuzione. Evidenzia il testo che vuoi sia pronunciato e scegli StrumentiPronuncia testo nel menu principale. Dopo poco, il testo evidenziato dovrebbe iniziare a essere pronunciato.

È quasi sempre una buona idea evidenziare il testo della pagina Web che vuoi sia pronunciato. Puoi saltare questo passo, ma sentirai molte intestazioni &HTML; e altri tag invisibili che vengono pronunciati.

### Pronunciare testo nell'editor di testo &kate;

Quando usi l'editor di testo avanzato di &kde; (&kate;), puoi pronunciare il testo visualizzato. Prima assicurati che &jovie; sia in esecuzione e abilita l'Estensione di pronuncia Jovie di KTextEditor nella finestra di configurazione di &kate;. Evidenzia il testo che vuoi sia pronunciato e scegli StrumentiPronuncia testo nel menu principale. Poco dopo, il testo evidenziato dovrebbe iniziare a essere pronunciato.

Non devi per forza evidenziare il testo prima. In quel caso, sarà pronunciato tutto il file.

Ciò funziona anche quando &kate; è in esecuzione incorporato in un'altra applicazione, come &konqueror; o &quanta;.

### Notifiche vocali (KNotify)

KNotify è il sottosistema di notifica di &kde;, che ti avverte di eventi che configuri all'interno del sistema &kde;. Puoi configurare &jovie; per pronunciare le notifiche testuali.

Per esempio, &konversation;, un'applicazione IRC per &kde;, ti permette di configurare un'ampia varietà di notifiche. Per esempio, puoi dire a &konversation; di notificarti ogni volta che un messaggio contenente il tuo nome appare in un canale IRC. Insieme a &jovie;, puoi far pronunciare a &kde; il testo del messaggio IRC.

In generale, se un'applicazione &kde; supporta KNotify, apparirà un elemento Notifiche nel menu Impostazioni dell'applicazione. Le specifiche per la configurazione di ogni applicazione con KNotify cambiano con l'applicazione.

I filtri di sostituzione delle stringhe sono un buon modo di ripulire i messaggi inviati dalle applicazioni se vengono pronunciati male da &jovie;. Il file `kmail.xml`, incluso in &jovie;, è un buon esempio. Rimuove i tag `br` e `b` dai messaggi di notifica di &kmail;, e rimuove anche l'espressione `/local/inbox`, siccome questo è un assunto ragionevole nella maggior parte dei casi. Vedi .

### Filtri (Avanzato)

I filtri sono una funzionalità avanzata di &jovie;. Non sono necessari per l'uso di base di &jovie;.

I filtri sono usati per preelaborare il testo prima di inviarlo a speech-dispatcher. Sono utili per migliorare la pronuncia, per sostituire le parole pronunciate male o per le abbreviazioni, scegliere la lingua e l'oratore appropriati per la pronuncia, o aggirare certi limiti dei sintetizzatori vocali e delle loro voci.

#### Tipi di messaggi di &jovie;

Per capire come si usano i filtri, è utile prima capire come viene elaborato il testo da &jovie;. Il testo pronunciato da speech-dispatcher può essere di quattro tipi.

- Output del lettore dello schermo.

- Avvertimenti.

- Messaggi

- Processi di testo

Il tipo è determinato dall'applicazione che invia il testo a &jovie;.

L'output del lettore dello schermo ha la massima priorità. È riservato all'uso da parte delle applicazioni del lettore dello schermo. L'output del lettore dello schermo blocca tutti gli altri messaggi, mettendo quei processi in pausa. Una volta che l'output del lettore dello schermo sarà stato pronunciato, i messaggi interrotti riprenderanno automaticamente.

Gli avvertimenti sono la seconda priorità. È riservata a messaggi ad alta priorità, come La CPU si sta surriscaldando. Un avvertimento bloccherà i messaggi e il testo normale, mettendoli in pausa. Una volta che l'avvertimento sarà stato pronunciato, i messaggi interrotti riprenderanno automaticamente.

I messaggi seguono nell'ordine di priorità. Un messaggio bloccherà i processi di testo normale. &kmouth; è un esempio di applicazione che usa i messaggi. Per esempio, mentre leggi un lungo testo da una pagina Web, &kmouth; può essere usato per salutare qualcuno che entra nella stanza. Anche le notifiche di &kde; sono messaggi (vedi ).

Il resto sono normali processi di testo. Qualsiasi processo che avvii dalla scheda Processi è un processo di testo. KSayIt è un esempio di applicazione che usa i processi di testo. I processi di testo sono fatti per la pronuncia, non urgente, di lunghi spezzoni.

Tutti i quattro tipi di processi sono code, eccetto l'output del lettore dello schermo. Se un output del lettore dello schermo viene inviato da un'applicazione mentre &jovie; sta pronunciando un altro output del lettore dello schermo, il messaggio pronunciato viene interrotto e perso.

#### Tipi di filtri

La prima cosa che devi sapere dei filtri è che non sono mai applicati all'output del lettore dello schermo. Sono applicati agli avvertimenti, ai messaggi, ai processi di testo e alle notifiche di &kde; (KNotify).

I filtri elaborano il testo e lo passano al prossimo filtro. Attualmente ci sono tre tipi di filtri.

- Sostitutori di stringhe.

- Trasformatori &XML;

- Selettori dell'oratore.

I filtri sono implementati usando un'architettura a estensioni. Nel futuro, ci potrebbero essere altri tipi di filtri.

I filtri sostitutori di stringhe sostituiscono pezzi di testo con altro testo. I pezzi sostituiti sono identificati o con parole o con espressioni regolari. &jovie; è equipaggiato con dei filtri predefiniti di sostituzione delle stringhe per pronunciare le abbreviazioni, le faccine come :-), o riformattare i messaggi di notifica da &konversation; o &kmail; in una forma più comprensibile.

I trasformatori &XML; usano un file &XML; Style Language - Transforms (XSLT) per convertire &XML; da un formato a un altro. &jovie; ha un paio di file XSLT per convertire &XHTML; in SSML.

I selettori degli oratori ti permettono di inviare i processi a un oratore in base ai contenuti del testo, o in base all'applicazione che li ha inviati a &jovie;. Per esempio, se hai configurato un oratore femminile nella scheda Oratori, puoi ridirezionare il testo proveniente da KSayIt a quell'oratore. Vedi .

Ognuno di questi tipi di filtro ha delle regole configurabili per quando il filtro dovrebbe essere applicato al testo da pronunciare. Se il filtro determina che non dovrebbe essere applicato, il testo viene passato al prossimo filtro senza modifiche.

Quando un processo di testo, un messaggio, un avviso, o una notifica di &kde; viene inviato a &jovie;, passa attraverso ciascuno dei filtri abilitati che hai configurato nella schermata sotto. L'ordine è dall'alto in basso.

#### Configurare i filtri

Per usare i filtri, fai clic sulla scheda Filtri in `jovie`.

Il gestore della pronuncia di &kde; (scheda Filtri). Il gestore della pronuncia di &kde; (scheda Filtri)

Questo è l'elenco di filtri ordinari configurati. Se non è segnato, il filtro è inattivo e sarà saltato. I filtri sono applicati nell'ordine qui specificato, dall'alto in basso.

Fai clic qui per aggiungere un nuovo filtro. Ti sarà chiesto il tipo di filtro da aggiungere. Dopo aver scelto il tipo, vedi le finestre di configurazione sotto.

Fai clic qui per rimuovere un filtro.

Fai clic qui per cambiare la configurazione di un filtro. Vedi le finestre di configurazione sotto.

Fai clic su questi pulsanti per spostare un filtro in alto o in basso nell'elenco.

Assicurati di fare clic qui, altrimenti le tue impostazioni non avranno effetto.

#### Configurare i filtri di sostituzione delle stringhe

Configuri i filtri di sostituzione delle stringhe dando un elenco di parole o espressioni regolari che devono essere sostituite. Quando nel testo vengono trovate le parole o le espressioni regolari corrispondenti, ciascuna viene sostituita con una stringa sostitutiva che fornisci tu.

Sostituzione delle stringhe Sostituzione delle stringhe

Inserisci un nome per il tuo filtro. Usa qualsiasi nome tu voglia che lo distingua da tutti gli altri.

Questo è l'elenco di parole ed espressioni regolari. Il filtro cerca corrispondenze in ciascuna stringa nella colonna Corrispondi a, sostituendo le stringhe che corrispondono con la stringa nella colonna Sostituisci con. L'elenco è elaborato nell'ordine visualizzato, dall'alto in basso.

Fai clic qui per aggiungere una parola o un'espressione regolare all'elenco.

Fai clic qui per spostare la parola o l'espressione regolare attualmente evidenziata in alto o in basso nell'elenco.

Fai clic per cambiare una parola o un'espressione regolare nell'elenco.

Fai clic per rimuovere dall'elenco la parola o l'espressione regolare attualmente evidenziata.

Usa questi pulsanti per caricare un elenco di parole o espressioni regolari da un file, salvare l'elenco attuale in un file, o svuotare l'intero elenco. Quando carichi da un file, gli elementi del file sono aggiunti all'elenco esistente.

Se non è in bianco, il filtro sarà applicato solo se la lingua dell'oratore del processo corrisponde alla lingua che inserisci qui. Fai clic sul pulsante per visualizzare un elenco di lingue. Puoi selezionarne più d'una premendo &Ctrl; mentre fai clic.

Se non è in bianco, il filtro sarà applicato solo se il testo viene da una delle applicazioni elencate. Potresti inserire più applicazioni separate da virgole. Per esempio: ``konversation,kmail``

Puoi conoscere l'ID dell'applicazione dei programmi in esecuzione usando il programma `&qdbus;`. Dovresti togliere i numeri &DBus;. Per esempio, se &qdbus; mostrasse un'ID dell'applicazione `kopete-3432`, inseriresti semplicemente ``kopete``.

Il filtro di sostituzione delle stringhe sarà applicato al testo solo se tutte le condizioni non in bianco saranno soddisfatte nel riquadro Applica questo filtro quando. Se tutti i riquadri sono in bianco, il filtro sarà applicato a tutto il testo.

Quando cerca le corrispondenze delle parole, il filtro di sostituzione delle stringhe usa internamente un'espressione regolare nella forma `\s`parola`\s`. In altre parole, la parola deve avere dei limiti di parola (spazi) su entrambi i suoi lati.

Una discussione su come scrivere le espressioni regolari è oltre l'ambito di questo manuale. Se avete installato l'editor di espressioni regolari di &kde;, è disponibile un pulsante sulle schermate Aggiungi o Modifica che ti aiuterà a costruire le espressioni regolari. L'editor di espressioni regolari di &kde; fa parte del pacchetto `kdeutils`.

&jovie; ha alcuni file di elenchi di parole, incluso un elenco di faccine, come :-), alcune abbreviazioni usate tipicamente su IRC o applicazioni di messaggeria istantanea, e un elenco di altre abbreviazioni. C'è anche un elenco di caratteri speciali che la versione attuale della voce polacca di Festival non può gestire. Se sviluppi da te degli elenchi di parole utili, usa il pulsante Salva per salvarli in un file e inviarli alla squadra di &jovie; per includerli nella prossima versione.

#### Configurare i filtri di trasformazione &XML;

Il filtro di trasformazione &XML; usa dei file XSLT per trasformare &XML; da un formato a un altro. XSLT, &XML; Style Language - Transforms, è una lingua standard del W3C per effettuare queste trasformazioni. Può essere usata solo su &XML; correttamente formattato. Devi avere installato il programma `xsltproc`.

Trasformatore &XML; Trasformatore &XML;

Inserisci un nome per il tuo filtro. Usa qualsiasi nome tu voglia che lo distingua da tutti gli altri.

Inserisci il percorso completo a un file XSLT che effettuerà la trasformazione.

Specifica il percorso al programma `xsltproc`. Se xsltproc è nella tua variabile d'ambiente PATH, inserisci semplicemente ``xsltproc``.

Se non è in bianco, il filtro si applicherà solo se l'&XML; ha l'elemento radice specificato o una specificazione `<!DOCTYPE` che comincia per la stringa inserita. Ciò distingue una forma di &XML; dall'altra. Per esempio, ``html`` nel riquadro DOCTYPE corrisponderà a `<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" >`.

Se non è in bianco, il filtro sarà applicato solo se il testo viene da una delle applicazioni elencate. Potresti inserire più applicazioni separate da virgole. Per esempio: ``konversation,kmail``

Puoi conoscere l'ID dell'applicazione dei programmi in esecuzione usando il programma `&qdbus;`. Dovresti togliere i numeri &DBus;. Per esempio, se &qdbus; mostrasse un'ID dell'applicazione `kopete-3432`, inseriresti semplicemente ``kopete``.

Il filtro di trasformazione &XML; sarà applicato al testo solo se l'elemento radice o il DOCTYPE corrispondono, e se l'ID dell'applicazione corrisponde nella casella Applica questo filtro quando. Se un elemento in questa casella è in bianco, non viene effettuato il controllo, quindi se tutte le caselle sono in bianco il filtro sarà applicato al testo. Tuttavia, dovresti riempire almeno una casella, perché molti processi di testo non saranno in formato &XML;.

#### Configurare i filtri di selezione degli oratori

I filtri di selezione degli oratori sono usati per indirizzare il testo a un oratore desiderato configurato nella scheda Oratore, o a qualsiasi oratore che abbia certi attributi. Per esempio, puoi specificare che il testo in arrivo da `kmail` sia pronunciato usando un oratore configurato con una voce femminile. Vedi .

Appena prima che &jovie; cominci a inviare il testo a ciascun filtro, sceglie un oratore per pronunciare il testo. L'oratore è scelto in base agli attributi specificati dall'applicazione che ha inviato il testo a &jovie; e gli attributi degli oratori che hai configurato nella scheda Oratori. Il filtro di selezione degli oratori ti permette di cambiare l'impostazione dell'oratore selezionato.

Selettore degli oratori Selettore degli oratori

Inserisci un nome per il tuo filtro. Usa qualsiasi nome tu voglia che lo distingua da tutti gli altri.

Se non è in bianco, il filtro sarà applicato solo se il testo contiene l'espressione regolare inserita. Se è installato, fai clic sul pulsante Sfoglia per avviare l'editor di espressioni regolari di &kde; per aiutarti a inserire l'espressione regolare.

Per prestazioni migliori, prova ad ancorare l'espressione regolare all'inizio della stringa. In altre parole, avvia la tua espressione regolare con ``^``.

Se non è in bianco, il filtro sarà applicato solo se il testo viene da una delle applicazioni elencate. Potresti inserire più applicazioni separate da virgole. Per esempio: ``konversation,kmail``

Puoi conoscere l'ID dell'applicazione dei programmi in esecuzione usando il programma `&qdbus;`. Dovresti togliere i numeri &DBus;. Per esempio, se &qdbus; mostrasse un'ID dell'applicazione `kopete-3432`, inseriresti semplicemente ``kopete``.

Specifica qui gli attributi dell'oratore che preferisci pronunci il testo. Se il testo soddisfa le condizioni del filtro sopra, sarà scelto un oratore che corrisponda il più vicino possibile agli attributi che specifichi qui. Fai clic sul pulsante a destra per visualizzare la schermata Seleziona oratore.

Usa questi pulsanti per salvare le tue impostazioni del Selettore degli oratori, caricare le impostazioni da un file salvato, o azzerare tutte le impostazioni.

Il filtro di selezione degli oratori sarà applicato al testo solo se tutte le condizioni non in bianco saranno soddisfatte nel riquadro Applica questo filtro quando. Devi riempire almeno uno dei riquadri.

## Riferimento dei comandi

DA FARE

## Guida per lo sviluppatore a &jovie;

&jovie; ha due interfacce dell'applicazione per programmatori (API):

- L'API di pronuncia di &kde;, usata dai programmatori di applicazioni per dare alle loro applicazioni delle capacità TTS. Le applicazioni comunicano con &jovie; attraverso &DBus;.

- L'API delle estensioni di pronuncia di &jovie;, usata per aggiungere estensioni di sintesi vocale a &jovie; in modo che funzioni con un nuovo motore di sintesi vocale.

La sezione seguente dà una breve descrizione dell'interfaccia &DBus; dell'API di pronuncia di &kde;. La documentazione completa per entrambe le API è disponibile in rete sul sito Web dell'accessibilità di &kde; (http://accessibility.kde.org).

### L'interfaccia &DBus; di &jovie;

Le applicazioni comunicano le richieste di servizi di pronuncia attraverso l'oggetto `KSpeech` dell'interfaccia &DBus; di &kde; al programma `jovie`.

Inserisci i comandi seguenti in una &konsole;.

Se &jovie; non è ancora in esecuzione

`jovie`

Per mettere in coda un processo di testo da pronunciare

`qdbus org.kde.jovie /KSpeech say "testo" "opzioni"`

dove `testo` è il testo da pronunciare, e `opzioni` è un codice di una lingua come `en`, `it`, eccetera.

Esempio.

`qdbus org.kde.jovie /KSpeech say "Prova microfono, un due tre prova." "it"`

Ci sono molti altri comandi che si possono inviare. Per vedere un elenco dei comandi possibili,

`qdbus org.kde.jovie /KSpeech`

o leggi la API di pronuncia di &kde; in rete.

## Domande e risposte

&reporting.bugs; &updating.documentation;

Devo ripartire da zero. Come faccio fermare completamente &jovie;?

Inserisci i comandi seguenti in una &konsole;:

    kquitapp jovie

Come posso vedere l'output di debug di `jovie`?

Apri una finestra di &konsole;. Avvia quindi `jovie`.

Nessuno dei sintetizzatori vocali supportati supporta la lingua di cui ho bisogno. Dove posso trovare un sintetizzatore per la mia lingua?

Google™ ti è alleato. Anche questo collegamento potrebbe esserti d'aiuto. Se trovi un motore di sintesi gratuito che supporti la lingua che desideri, e vuoi aggiungerne il supporto a &jovie;, per piacere contatta la squadra di sviluppo. I motori liberi sono particolarmente i benvenuti. Se conosci di un sintetizzatore commerciale, forse puoi persuaderne il distributore a donare una copia gratuita alla squadra di sviluppo di &jovie;. Nel frattempo, potresti essere in grado di far funzionare il sintetizzatore usando l'interfaccia di comando di speech-dispatcher.

Ho configurato l'estensione di trasformazione &XML; per &HTML;, ma le pagine Web non vengono pronunciate per niente usando l'estensione di Festival.

A causa di un errore in Festival 1.95 beta, devi installare la voce `rab_diphone` (maschio britannico) affinché SABLE funzioni, anche se non usi quella voce per pronunciare le pagine Web. Inoltre, assicurati che il programma `xsltproc` sia installato e nella variabile d'ambiente PATH.

Certi caratteri o segni di punteggiatura sembrano produrre errori nel sintetizzatore, facendogli saltare intere frasi, o pronunciando cose incomprensibili. Cosa posso fare?

Primo, assicurati che l'opzione Codifica dei caratteri nella finestra di configurazione dell'oratore sia correttamente impostata per la lingua. Se certe parole o caratteri stanno causando dei problemi, un filtro di sostituzione delle stringhe potrebbe aiutare. Vedi .

## Riconoscimenti e licenza

&jovie;

Copyright © del programma 2002 José Pablo Ezequiel Pupeno Fernández pupeno@kde.org

Attuale responsabile: Jeremy Whiting jpwhiting@kde.org

Hanno contribuito:

- Gary Cramblitt garycramblitt@comcast.net

- Olaf Schmidt ojschmidt@kde.org

- Gunnar Schmi Dt gunnar@schmi-dt.de

- Paul Giannaros ceruleanblaze@gmail.com

Copyright © della documentazione 2009 di Jeremy Whiting jpwhiting@kde.org, 2004 di Gary R. Cramblitt garycramblitt@comcast.net

Federico Zenithfederico.zenith@member.fsf.org

&underFDL; &underGPL;

I motori di sintesi vocale usati da &jovie; hanno licenze proprie. Vedi la documentazione o il sito Web di ogni motore per i dettagli. Alcune voci hanno anche una licenza propria.

## Installazione

### Come ottenere &jovie;

&install.intro.documentation;

Comando di installazione sotto Debian: `apt-get install kdeaccessibility`

Troverai dei collegamenti a pacchetti sorgente e binari al sito Web dell'Accessibilità di &kde; (http://accessibility.kde.org).

Se hai accesso al deposito del codice di &kde;, puoi scaricare &jovie; ritirando il modulo `kdeaccessibility`. &jovie; si troverà nella cartella `jovie`. Puoi anche scaricare un file compresso del codice sorgente di kdeaccessibility da ftp://ftp.kde.org/pub/kde/.

### Requisiti

Requisiti obbligatori:

- &kde; versione 4.4 o successiva.

- speech-dispatcher versione 0.67 o successiva.

- Un sintetizzatore vocale. Sono attualmente supportati i sintetizzatori e le lingue seguenti.

  Espeak | La maggior parte delle lingue, vedi questo sito per l'elenco di lingue attualmente supportate.
  Festival | Inglese americano, inglese britannico, spagnolo, tedesco, finlandese, ceco, polacco, russo, italiano, francese canadese, Kiswahili, Zulù e Ibibio

  Funziona anche con qualsiasi motore di sintesi che possa essere eseguito da un comando in &konsole;.

  L'elenco di lingue sopra potrebbe non essere completo o aggiornato. Controlla le specifiche di ogni motore per un elenco completo di lingue supportate. Controlla anche il sito Web di &jovie; per maggiori informazioni che potrebbero non essere state incluse in questo manuale.

  speech-dispatcher usa un'architettura flessibile a estensioni per i motori di sintesi vocale. Se vuoi migliorare &jovie; per supportare un altro motore, contatta la squadra di sviluppo.

  Vedi per istruzioni specifiche per ciascuno di questi motori.

Componenti opzionali:

- Il programma `xsltproc` è necessario per il supporto SSML e per il filtro di trasformazione &XML;, ma non è indispensabile. Gli utenti Debian possono installare xsltproc con il comando `apt-get install xsltproc`.

### Compilazione e installazione

Per compilare &jovie;, devi avere una copia recente (&kde; 4.4 o superiore) dei file di sviluppo di &kde;, inclusi kdelibs e i file di sviluppo di speech-dispatcher.

Se hai scaricato il sorgente di &jovie; dal modulo `kdeaccessibility` del deposito del codice, o hai scaricato il file compresso della notte, usa i comandi seguenti per compilare e installare.

    cd kdeaccessibility
    mkdir build
    cd build
    cmake ../
    make
    sudo make install

### Configurazione

Assicurati che speech-dispatcher funzioni con il tuo motore di sintesi vocale prima di usare &jovie;. A tal fine si può usare lo script di shell `spd-conf`.

&jovie; in &kde; 4.5 è il nuovo nome di KTTSD e kttsmgr. In futuro, &jovie; sarà in grado di configurare speech-dispatcher direttamente, senza usare `spd-conf`.

&documentation.index;