# El manual del &kmouth;

## Introducció

El &kmouth; és un programa que fa possible que les 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 el &kmouth; no inclou cap sintetitzador de veu. Pel que requereix tenir-ne un d'instal·lat en el sistema.

## Usar el &kmouth;

### La configuració per primera vegada

Durant la primera execució del &kmouth; es mostrarà un assistent des del qual podreu configurar-lo.

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, vegeu 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 emprades més sovint de manera que no sigui necessari escriure-les. Per descomptat, el &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 la regularitat de les distintes paraules. De manera opcional 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 del &kmouth; és força senzilla. Bàsicament consisteix d'un camp d'edició en el qual s'escriuen les frases (el camp en blanc a la part inferior de la captura de pantalla) i un historial de les frases sintetitzades (el camp en blanc a la part superior de la captura de pantalla).

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

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

Des dels llibres de frases (ubicats a sota de la barra d'eines) es poden seleccionar les frases emprades sovint.

### El diàleg de configuració

Utilitzant l'entrada de menú Arranjament Configura el &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 Captura de pantalla

La pestanya Preferències conté opcions per a modificar el comportament del &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ó pel 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, el &kmouth; demanarà si ha de desar el llibre de frases.

#### La pestanya Text-a-veu

La pestanya Text-a-veu Captura de pantalla

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 sota del camp d'edició especifiqueu la codificació de caràcters que s'utilitza per a passar el text al sintetitzador de veu.

El &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 conté el text que s'ha de parlar
%l | L'idioma associat amb el diccionari per a la compleció de paraules
%% | Un signe de percentatge

Per descomptat, l'ordre per a parlar texts dependrà del sintetitzador de veu que empreu. Si us plau, consulteu la documentació del vostre sintetitzador de veu per a l'ordre a emprar. 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 Captura de pantalla

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

Amb els botons a la part dreta de la pàgina podeu afegir o suprimir els 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 diccionari nou, podreu escollir entre diverses fonts:

- Crear un diccionari nou a partir de la documentació del &kde;

  Si empreu aquesta font, el &kmouth; demanarà especificar l'idioma a emprar i després analitzarà la documentació del &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 empreu aquesta font, el &kmouth; demanarà pel fitxer a emprar. És possible emprar tant fitxers XML, com de text net o un fitxer creat prèviament amb el &kmouth; o GOK (la utilitat de teclat dinàmic en pantalla del Gnome). Si se selecciona un fitxer de text net 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 diccionari nou a partir d'una carpeta

  Si empreu aquesta font, el &kmouth; demanarà per la carpeta a emprar. 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 net estàndard. En els dos últims casos es comptarà 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 les paraules que poguessin contenir errors ortogràfics o d'altre tipus.

- Fusionar els diccionaris

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

- Crear una llista de paraules buida

  Aquesta opció s'utilitza per a crear un diccionari en blanc sense cap entrada. Com el &kmouth; afegeix automàticament les 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ó pel llibre de frases

Utilitzant l'entrada de menú Llibres de frases Edita... obrireu la finestra d'edició pel llibre de frases.

La finestra d'edició pel llibre de frases Captura de pantalla

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

A la part inferior podeu modificar un element seleccionat. Si heu seleccionat una frase en podeu modificar el contingut 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, suprimir llibres frases i frases, podeu o bé seleccionar dites accions a la barra de menús, a 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 utilitzant el cursor 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 les frases sintetitzades.

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

- Desa l'historial a un fitxer de text.

&Ctrl;P Fitxer Imprimeix l'historial...

- Imprimeix l'historial.

&Ctrl;Q Fitxer Surt

- Surt del &kmouth;

#### El menú Edita

&Ctrl;X Edita Retalla

- Talla la secció seleccionada i la posa al porta-retalls. Si hi ha cap text seleccionat en el camp d'edició, aquest serà ubicat al porta-retalls. D'altra manera, les frases seleccionades en l'historial (si n'hi ha cap) seran ubicades al 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 a l'historial (si n'hi ha cap) seran ubicades al 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ó pels llibres de frases.

El &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

Pronuncia

- Sintetitza les frases seleccionades.

Suprimeix

- Suprimeix les frases seleccionades de l'historial.

Retalla

- Les frases seleccionades són suprimides 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.

Desselecciona 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 les frases sintetitzades.

&Ctrl;S Desa l'historial com a...

- Desa l'historial a un fitxer de text.

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

#### El menú Fitxer

Fitxer Frase nova

- Afegeix una frase nova.

Fitxer Llibre de frases nou

- Afegeix un llibre de frases nou.

&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 un 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/es frase/s o llibre/s de frases actualment seleccionat/s

&Ctrl;W Fitxer Tanca

- Tanca la finestra

#### El menú Edita

&Ctrl;X Edita Retalla

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

- Suprimeix 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 frase nova.

Llibre de frases nou

- Afegeix un llibre de frases nou.

Importa...

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

Importa un 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 Retalla

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

Suprimeix

- Suprimeix 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 la veu. Utilitzeu Arranjament Configura el &kmouth; , obriu la pàgina Opcions generals i introduïu l'ordre per a sintetitzar el text a la pestanya Text a veu. (Per a més detalls vegeu 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

El 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 emprar i distribuir el 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 el Festival es troba instal·lat en el directori `/usr/local/festival/`. Aleshores, l'ordre per a parlar el text serà la següent:

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

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

FreeTTS

El 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 emprar i distribuir el 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 el FreeTTS es troba instal·lat en el directori `/usr/local/freetts/`. Aleshores, l'ordre per a parlar el text serà una 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 utilitzar amb el FreeTTS).

MBROLA

El 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 del MBROLA permet el seu ús lliure de càrrec per a aplicacions no comercials i no militars.

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

Malauradament, el 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 en 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; d'una interfície estandarditzada, per a la síntesi de veu i que actualment està en desenvolupament en el Git. Aquest empra 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 del &kmouth; és activar Usa el servei de síntesi Jovie si és possible.

De moment us caldrà configurar el 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 el &kmouth;

&install.intro.documentation;

### Requeriments

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

### Compilació i instal·lació

&install.compile.documentation;