# El manual de &kmouth;

## Introducció

&kmouth; és un programació que fa possible que persones que no poden parlar, l'ordinador ho faci per elles. Inclou un historial de frases que l'usuari pot seleccionar per a que siguin sintetitzades.

Tingueu present que &kmouth; no inclou un sintetitzador de veu. Pel que requereix tenir-ne un d'instal·lat en el sistema.

## Usar &kmouth;

### La primera execució

Durant la primera execució de &kmouth; es mostrarà un assistent en el qual és possible introduir alguna configuració bàsica.

Configuració de la síntesi Configuració de la síntesi

En la primera pàgina de l'assistent s'especifica quina ordre s'usarà més endavant per a la conversió de text a veu. Per a més detalls veieu la descripció del diàleg de configuració.

Llibre de frases inicial Llibre de frases inicial

En la segona pàgina seleccioneu quins llibres de frases estàndard us calen. Més endavant veureu que dels llibres de frases es poden seleccionar frases usades més sovint de manera que no sigui necessari escriure-les. Per descomptat, &kmouth; també ofereix un diàleg d'edició per al cas que més endavant vulgueu editar els vostres llibres de frases.

Compleció de paraules Compleció de paraules

A la tercera pàgina definiu el diccionari per a la compleció de paraules. El &kmouth; analitzarà la documentació del &kde; per a l'idioma seleccionat amb l'objectiu de detectar les freqüències de les distintes paraules. Opcionalment podeu comparar la llista de paraules contra un diccionari de l'OpenOffice.org amb l'objectiu d'afegir només a la compleció de paraules aquelles que estiguin escrites correctament.

### La finestra principal

La finestra principal de &kmouth; és força simple. Bàsicament consisteix d'un camp d'edició en el qual s'escriuen les frases (el camp en blanc a la part inferior en la instantània) i un historial de frases sintetitzades (el camp en blanc a la part superior en la instantània).

La finestra principal del &kmouth; La finestra principal del &kmouth;

Assumint que heu configurat &kmouth; correctament podeu usar el camp d'edició per a introduir frases que vulgueu sentir. Una vegada que la frase ha estat dita, aquesta serà afegida a l'historial. Des de l'historial podeu seleccionar frases per a que es tornin a dir.

Des dels llibres de frases (localitzats a sota de la barra d'eines) es poden seleccionar frases usades sovint.

### El diàleg de configuració

Usant l'entrada de menú Arranjament Configura &kmouth;... s'obrirà el diàleg de configuració del &kmouth;. Aquest diàleg consisteix de la pàgina Opcions generals amb les dues pestanyes Preferències i Text-a-veu, la pàgina Compleció de paraules i la pàgina Servei de síntesi Jovie.

#### La pestanya Preferències

La pestanya Preferències Instantània

La pestanya Preferències conté opcions per a modificar el comportament de &kmouth; en certes situacions.

En el primer quadre combinat, Selecció de frases en el llibre de frases, s'especifica quina acció executar en escriure l'abreujament d'una frase o al seleccionar una frase en el menú Llibre de frases o en la barra del llibre de frases.

Al seleccionar Pronuncia immediatament la frase seleccionada serà pronunciada immediatament i introduïda en l'historial. Si seleccioneu Insereix en el camp d'edició la frase seleccionada tan sols serà inserida en el camp d'edició.

En el segon quadre combinat, Tanca la finestra d'edició del llibre de frases:, s'especifica si el llibre de frases serà desat en tancar la finestra d'edició del llibre de frases.

Seleccionant Desa el llibre de frases es desarà el llibre de frases. Si seleccioneu Descarta els canvis, els canvis seran descartats i el llibre de frases no serà desat. Si seleccioneu Demana si s'ha de desar &kmouth; us demanarà si ha de desar el llibre de frases.

#### La pestanya Text-a-veu

La pestanya Text-a-veu Instantània

En el camp d'edició de la pestanya Text-a-veu introduïu l'ordre per a cridar al sintetitzador de veu. Amb el quadre combinat a sotadel camp d'edició especifiqueu la codificació de caràcters que s'usa per a passar el text al sintetitzador de veu.

&kmouth; coneix dues maneres de passar el text. Si l'ordre espera el text des de l'entrada estàndard, seleccioneu la casella de selecció.

L'altra manera és passar el text com a paràmetre. Abans de cridar l'ordre, el &kmouth; substituirà els marcadors de posició pel contingut real:

Marcador de posició | Substituït amb
%t | El text real que s'ha de parlar
%f | El nom d'un fitxer temporal que contingui el text que s'ha de parlar
%l | L'idioma associat amb el diccionari de compleció de paraules actual
%% | Un signe de percentatge

Per descomptat, l'ordre per a parlar texts dependrà del sintetitzador de veu que useu. Si us plau, consulteu la documentació del vostre sintetitzador de veu per l'ordre a usar. Podreu trobar exemples per a les ordres en l'apèndix.

Seleccionant Usa el servei de síntesi Jovie si és possible, se li diu al &kmouth; que primer miri d'enviar el text al servei de síntesi Jovie. Si això funciona, s'ignorarà la resta de les entrades de configuració en aquesta pestanya. El servei de síntesi Jovie és un dimoni del &kde; que dóna a les aplicacions &kde; una interfície estàndard, per a la síntesi de veu i que actualment està en desenvolupament en el Git. És segur escollir aquesta opció fins i tot quan el Jovie no està instal·lat.

#### La pàgina Compleció de paraules

La pàgina Compleció de paraules Instantània

La pàgina Compleció de paraules conté una llista de diccionaris usats per a la compleció de paraules. (Si dita llista contingués més d'un diccionari, &kmouth; mostrarà un quadre combinat junt al camp d'edició en la finestra principal. La funció d'aquest quadre combinat és la de permetre seleccionar el diccionari a usar en la compleció de paraules).

Amb els botons en la part dreta de la pàgina podeu afegir o treure diccionaris, canviar el seu ordre o exportar-los a un fitxer. Amb el camp d'edició i el quadre combinat de a sota, és possible canviar l'idioma associat amb el diccionari.

Quan vulgueu afegir un nou diccionari podreu escollir entre diverses fonts:

- Crear un diccionari nou a partir de la documentació de KDE

  Si s'usa aquesta font, &kmouth; us demanarà especificar l'idioma a usar i després analitzarà la documentació de KDE. La freqüència de cada paraula serà detectada mitjançant l'enumeració de les ocurrències de cada paraula. De manera opcional també és possible comparar la llista de paraules obtingudes, contra un diccionari OpenOffice.org. Aquest últim mètode ajuda a que tan sols s'afegeixin al diccionari aquelles paraules expressades correctament.

- Crear un diccionari nou a partir d'un fitxer

  Si s'usa aquesta font, &kmouth; us demanarà pel fitxer a usar. És possible usar tant fitxers XML, com de text pla o un fitxer creat prèviament amb &kmouth; o GOK (la utilitat de teclat dinàmic en pantalla de Gnome). Si se selecciona un fitxer de text pla o un XML, la freqüència de les paraules serà detectada per la simple enumeració d'ocurrències de cada paraula. De manera opcional també és possible comparar la llista de paraules obtingudes, contra un diccionari OpenOffice.org de manera que tan sols s'afegeixin al diccionari aquelles paraules expressades correctament.

- Crear un nou diccionari a partir d'una carpeta

  Si useu aquesta font, el &kmouth; demanarà per la carpeta a usar. El &kmouth; obrirà tots els fitxers en aquesta carpeta i els seus subdirectoris. Cada fitxer es carregarà com a un diccionari de compleció, un fitxer &XML; o un fitxer de text pla estàndard. En els dos últims casos es comptaran cadascuna de les paraules en cada ocurrència. De manera opcional podeu comparar la llista de paraules contra un diccionari OpenOffice.org amb l'objectiu d'eliminar paraules que poguessin contenir errors ortogràfics o d'altre tipus.

- Fusionar diccionaris

  Podeu usar aquesta opció amb l'objectiu de fusionar els diccionaris disponibles. &kmouth; demanarà pels diccionaris a fusionar i mostrarà com serà ponderat cada diccionari.

- Crear una llista de paraules buida

  Aquesta opció s'usa per a crear un diccionari en blanc sense cap entrada. Com &kmouth; afegeix automàticament paraules noves als diccionaris, aquest que en un començament estava en blanc, amb el temps anirà aprenent el vostre vocabulari.

#### La pàgina Servei de sintetització Jovie

La configuració del Servei de sintetització del &kde; es descriu en detall en el Manual del Jovie.

### La finestra d'edició del llibre de frases

Usant l'entrada del menú Llibres de frases Edita... obriu la finestra d'edició del llibre de frases.

La finestra d'edició del llibre de frases Instantànies

La finestra d'edició del llibre de frases es divideix en dues parts. En la part superior, les frases apareixen en una estructura en arbre.

En la part inferior podeu modificar un element seleccionat. Si heu seleccionat una frase en podeu modificar els continguts així com la seva drecera. Si heu seleccionat un llibre de frases tan sols podreu canviar el seu nom.

Per a executar accions com afegir llibres de frases i frases, esborrar frases seleccionades i llibres de frases, podeu o bé seleccionar dites accions en la barra de menús, en la barra d'eines o en un menú emergent.

Podeu canviar l'ordre dels llibres de frases i les frases arrossegant-les a la seva nova ubicació o usant els cursors del teclat mentre es prem la tecla &Alt;.

## Referència d'ordres

### Ordres dins de la finestra principal

#### El menú Fitxer

&Ctrl;O Fitxer Obre com a historial...

- Obre un fitxer de text com a historial de frases sintetitzades.

&Ctrl;S Fitxer Desa historial com a...

- Desa l'historial a un fitxer de text.

&Ctrl;P Fitxer Imprimeix historial...

- Imprimeix l'historial.

&Ctrl;Q Fitxer Surt

- Surt de &kmouth;

#### El menú Edita

&Ctrl;X Edita Talla

- Talla la secció seleccionada i la posa al porta-retalls. Si hi ha cap text seleccionat en el camp d'edició, aquest serà ubicat en el porta-retalls. D'altra manera, les frases seleccionades en l'historial (si n'hi ha cap) seran ubicades en el porta-retalls.

&Ctrl;C Edita Copia

- Copia la secció seleccionada i la posa al porta-retalls. Si hi ha cap text seleccionat en el camp d'edició, aquest serà copiat al porta-retalls. D'altra manera, les frases seleccionades en l'historial (si n'hi ha cap) seran ubicades en el porta-retalls.

&Ctrl;V Edita Enganxa

- Enganxa el contingut del porta-retalls a la posició actual del cursor en el camp d'edició.

Edita Sintetitza

- Sintetitza les frases actualment actives. Si hi ha text en el camp d'edició se sintetitzarà aquest. D'altra manera se sintetitzaran les frases seleccionades a l'historial (si n'hi ha cap).

#### El menú Llibres de frases

Llibres de frases Edita...

- Obre la finestra d'edició de llibres de frases.

&kmouth; té la configuració comuna al &kde; i els elements del menú Arranjament i Ajuda, per obtenir més informació llegiu les seccions sobre El menú Arranjament i El menú Ajuda dels fonaments del &kde;.

#### El menú emergent d'entrades a l'historial

Pronunciació

- Sintetitza les frases seleccionades.

Esborra

- Elimina les frases seleccionades de l'historial.

Talla

- Les frases seleccionades són esborrades de l'historial i se situen al porta-retalls.

Copia

- Les frases seleccionades són copiades al porta-retalls.

Selecciona totes les entrades

- Selecciona totes les entrades de l'historial.

Desseleccionar totes les entrades

- Desselecciona totes les entrades de l'historial.

&Ctrl;O Obre com a historial...

- Obre un fitxer de text com a historial de frases sintetitzades.

&Ctrl;S Desa historial com a...

- Desa l'historial a un fitxer de text.

### Ordres dins de la finestra d'edició de llibres de frases

#### El menú Fitxer

Fitxer Frase nova

- Afegeix una nova frase.

Fitxer Llibre de frases nou

- Afegeix un nou llibre de frases.

&Ctrl;S Fitxer Desa

- Desa el llibre de frases.

Fitxer Importa...

- Importa un fitxer i afegeix el seu contingut al llibre de frases

Fitxer Importa el llibre de frases estàndard

- Importa un fitxer de frases estàndard i afegeix el seu contingut al llibre de frases

Fitxer Exporta...

- Exporta les frases o llibres de frases seleccionats a un fitxer

&Ctrl;P Fitxer Imprimeix...

- Imprimeix la frase(s) o llibre(s) de frases seleccionats actualment

&Ctrl;W Fitxer Tanca

- Tanca la finestra

#### El menú Edita

&Ctrl;X Edita Talla

- Talla els elements seleccionats i els situa al porta-retalls.

&Ctrl;C Edita Copia

- Copia els elements seleccionats al porta-retalls.

&Ctrl;V Edita Enganxa

- Enganxa el contingut del porta-retalls en el llibre de frases.

Edita Elimina

- Elimina els elements seleccionats.

#### El menú Ajuda

Els elements d'aquest menú són els mateixos que a la finestra principal.

#### El menú emergent

Frase nova

- Afegeix una nova frase.

Llibre de frases nou

- Afegeix un nou llibre de frases.

Importa...

- Importa un fitxer i afegeix el seu contingut al llibre de frases

Importa llibre de frases estàndard

- Importa un fitxer de frases estàndard i afegeix el seu contingut al llibre de frases

Exporta...

- Exporta les frases o llibres de frases seleccionats a un fitxer

&Ctrl;X Talla

- Talla els elements seleccionats i els situa al porta-retalls.

&Ctrl;C Copia

- Copia els elements seleccionats al porta-retalls.

&Ctrl;V Enganxa

- Enganxa el contingut del porta-retalls en aquesta posició en el llibre de frases.

Esborra

- Elimina els elements seleccionats.

## Preguntes i respostes

&reporting.bugs; &updating.documentation;

No escolto res.

El més probable és que no heu configurat correctament l'ordre per a sintetitzar veu. Useu Arranjament Configura &kmouth; , obriu la pàgina Opcions generals i introduïu l'ordre per a sintetitzar el text en la pestanya Text a veu. (Per a més detalls mireu la secció sobre el diàleg de configuració per al sintetitzador de veu).

## Crèdits i llicència

&kappname;

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

Copyright de la documentació 2002-2004 Gunnar Schmi Dt gunnar@schmi-dt.de

Traductor de la documentació: &credits.Antoni.Bella;

&underFDL; &underGPL;

## Exemples per a la configuració de text-a-veu

Festival

Festival és un sintetitzador de text-a-veu escrit des de la Universitat d'Edimburg. Actualment implementa els idiomes anglès, espanyol i gal·lès. La seva llicència permet usar i distribuir Festival lliure de càrrec i sense restriccions.

Per a poder crear la línia d'ordres d'exemple per a la configuració del text-a-veu assumim que Festival es troba instal·lat en el directori `/usr/local/festival/`. Aleshores, l'ordre per a parlar serà el següent:

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

L'opció Envia la informació a l'entrada estàndard haurà d'estar habilitada.

FreeTTS

FreeTTS és un sintetitzador de veu escrit completament en el llenguatge de programació Java™. Actualment només implementa la pronunciació en anglès. La seva llicència permet usar i distribuir FreeTTS lliure de càrrec i sense restriccions.

Per a poder crear la línia d'ordres d'exemple per a la configuració del text-a-veu assumim que FreeTTS es troba instal·lat en el directori `/usr/local/freetts/`. Aleshores, l'ordre per a parlar serà un dels tres exemples següents:

    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 al tercer exemple, l'opció Envia la informació a l'entrada estàndard haurà d'estar habilitada. (Aquest és l'exemple preferit per a usar amb FreeTTS).

MBROLA

MBROLA és un sintetitzador de veu que implementa un gran nombre d'idiomes. Aquest converteix una llista de fonemes a un fitxer wav, pel qual us caldrà alguna eina addicional per a convertir el text en una llista de fonemes. La llicència de MBROLA permet el seu ús lliure de càrrec per a aplicacions no comercials i no militars.

Per al nostre exemple usarem Hadifax amb la finalitat de convertir text en alemany a una llista de fonemes adequada per a MBROLA. Assumirem que Hadifax i MBROLA estan instal·lats en `/usr/local/hadifax/` i `/usr/local/mbrola/`.

Malauradament, Hadifax tendeix a empassar-se l'últim caràcter del text, pel que no estaria malament afegir un caràcter addicional al final del text. L'ordre completa, és en conseqüència, una mica més complexa que els anteriors exemples:

    (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

Totes les parts d'aquesta ordre hauran d'estar escrites en una única línia. A més, l'opció Envia les dades a la sortida estàndard haurà d'estar habilitada.

El dimoni KDE de text-a-veu

El dimoni de síntesi text-a-veu del &kde; (Jovie) és un servei del &kde; que proveeix a les aplicacions &kde; una interfície estandarditzada, per a la síntesi de veu i que actualment està en desenvolupament en el Git. Aquest usa connectors amb l'objectiu d'implementar diversos sistemes de text-a-veu.

Com la configuració del sintetitzador de veu està a càrrec del Jovie, l'únic que haureu de fer dins de &kmouth; és activar Usa el servei de síntesi Jovie si és possible.

De moment us caldrà configurar Jovie. Es pot fer des de la pàgina de configuració Servei de síntesi Jovie. La qual estarà disponible en el diàleg de configuració del &kmouth; si està instal·lat el Jovie.

## Instal·lació

### Com obtenir &kmouth;

&install.intro.documentation;

### Requeriments

Per tal d'usar el &kmouth; correctament necessitareu un sintetitzador de veu.

### Compilació i instal·lació

&install.compile.documentation;