# Het handboek van &jovie;

## Inleiding

&jovie; is een subsysteem binnen &kde; om spraakuitvoer (TTS) mogelijk te maken. Het geeft &kde; programmeurs een gemeenschappelijke API om TTS mogelijkheden aan hun toepassingen te geven. Het geeft ook enige aardige mogelijkheden voor de gebruiker.

Eigenschappen voor de gebruiker

- Spreekt de inhoud van een tekst bestand

- Spreekt de &kde; notificatie meldingen (KNotify)

- Spreekt de tekst of een gedeelte van de tekst van een web pagina in &konqueror;.

- Spreekt een gedeelte of de gehele tekst in de &kate; tekstverwerker, ook als &kate; door een andere &kde; toepassing gestart wordt

- De tekst wordt gesproken via een spraak-verdeler, dus iedere spraak-verdeler-backend kan worden gebruikt (espeak, festival, &etc;)

- Door de gebruiker te configureren filters voor het vervangen van verkeerd uitgesproken woorden, kiezen van spraak synthesizers, en transformeren van XHMTL/&XML; documenten.

Eigenschappen voor de programmeur

- Voorrang systeem voor de schermlezeruitvoer, waarschuwingen en berichten, terwijl de reguliere tekst uitgespoken wordt

- Staat het genereren van spraak vanaf de commandoregel (of via shell scripts) toe door het &qdbus;-programma te gebruiken .

- Voorziet in een gemakkelijk te gebruiken interface om spraak te genereren

- Toepassingen hoeven geen details over het geluidsysteem te weten.

- In de toekomst: Voorziet in ondersteuning voor Speech-Markup-talen zoals VoiceXML, Sable, &Java; Speech Markup Language (JSML), en Speech Markup Meta language (SMML).

- In de toekomst: Voorziet in gelimiteerde ondersteuning voor embedded spraak markers.

- Asynchronisch om blokeren van het systeem te voorkomen.

&jovie; bestaat uit diverse programma's:

`jovie`

- De spraakuitvoer-daemon van &kde;,.die een niet-&GUI;-toepassing is, voorziet in TTS diensten voor toepassingen via &DBus;. Het is ook aanwezig in het systeemvak.

`libkhtmlkttsdplugin`

- Een plugin voor de webbrowser &konqueror; die het mogelijk maakt om de tekst van een web pagina of een gedeelte ervan uit te spreken.

`ktexteditor_kttsd`

- Een plugin voor de tekst editor &kate; die het mogelijk maakt om de tekst van een tekst bestand of een gedeelte ervan uit te spreken.

### Ondersteuning

Behalve in de Bugzilla databank van &kde; (http://bugs.kde.org/ zijn er ook discussies over &jovie; in de kde-accessibility mailing lijst. Aanmelden bij https://mail.kde.org/mailman/listinfo/kde-accessibility Ontwikkelaars zijn ook te vinden in het IRC kanaal (irc.kde.org, channel #kde-accessibility).

## &jovie; gebruiken

Voordat u &jovie; kunt gebruiken dient u minstens een spraak-verdeler te installeren en te controleren of deze werkt. Zie installation.

### Beginnen van `jovie`

Om het &jovie; systeem te beginnen, type het volgende commando in een &konsole;

`jovie`

of klik op &jovie; in het &kde; menu

Bij de eerste keer opstarten van `jovie` of indien er geen sprekers ingesteld zijn, zal het Sprekers scherm verschijnen. Zie configure-talkers . Indien u reeds minstens één spreker ingesteld heeft zal het Algemeen scherm verschijnen. Zie general.

### Sprekers instellen

De meeste TTS-synthesizers bieden meerdere talen en stemmen aan, en ook verschillende mannelijke of vrouwelijke stemmen die zich in geluidssterkte en snelheid onderscheiden U kunt ook meerdere varianten voor een synthesizer instellen. Elke combinatie van taal, synthesizer, stem, geslacht, geluidssterkte, en snelheid wordt een spreker genoemd. U dient minstens één spreker te configureren voordat u &jovie; kunt starten om tekst voor te lezen, anders wordt een standaard stem gebruikt.

Meerdere sprekers voor dezelfde synthesizer is vergelijkbaar met meerdere printopdrachten voor dezelfde printer.

Wanner u op de sprekers tab in `jovie` klikt zal het spekers scherm verschijnen. Dit scherm verschijnt ook automatisch wanneer u `jovie` opstart en er geen sprekers geconfigureerd zijn.

De Tekst-tot-spaak beheerder van &kde; (tab Sprekers). De Tekst-tot-spaak beheerder van &kde; (tab Sprekers)

- Klik om een nieuwe spreker toe te voegen.

- Alle reeds geconfigureerde sprekers worden hier weergegeven De spreker met de hoogste prioriteit wordt bovenaan weergegeven. De bovenste spreker zal gebruikt worden wanneer een toepassing niet een spreker gedefinieerd heeft.

- Wanneer u door een muisklik een spreker in de lijst markeert kunt u deze verwijderen door op deze knop te drukken.

- Klik op een spreker in de lijst en klik op deze knop de configuratie te wijzigen. Zie hier onder.

- Wanneer u door een muisklik een spreker in de lijst markeert kunt u deze door deze knop een regel naar beneden verplaatsen. De positie van een spreker in de lijst bepaalt ook zijn prioriteit.

- Klik op een van deze knoppen om de wijzigingen die u gemaakt heeft op het reeds lopende &jovie; systeem toe te passen.

Wanneer u de knop Toevoegen selecteert zal het Spreker toevoegen scherm verschijnen.

Spreker toevoegen scherm Spreker toevoegen scherm

- U zou uw nieuwe spreker een naam moeten geven, dit kan alles zijn.

- Hier kiest u de taal en de synthesizer.

- Kies hier het stemtype, er zijn drie mannelijke, drie vrouwelijke, één jongens- en een meisjesstem om uit te kiezen.

- Hier elke aangepaste stemparameter instellen.

- Wanneer u hier klikt zal de nieuwe spreker in de lijst op het Sprekers-scherm verschijnen. Klik op de knop Bewerken om de instellingen van de spreker te bewerken.

U bent bijna klaar om &jovie; te gebruiken. Ga nu terug naar de tabblad Algemeen en controleer of het vakje Tekst-tot-spraak-systeem (Jovie) activeren aangekruist is. Nu is de TTS dienst van &kde; gestart. Zie general. Nu kunt u &jovie; gebruiken om tekst te laten uitspreken. Klik op het tabblad Taken om tekstopdrachten in te stellen en te beheren.Zie jobmgr.

### Starten van &jovie; en instellen van algemene opties

Wanneer u tenminste een spreker geconfigureerd heeft, kunt u het &kde; Tekst-tot-spraak systeem starten. Klik op de tab Algemeen. Het scherm Algemeen zal verschijnen. U kunt enige algemene opties instellen in dit scherm.

De Tekst-tot-spaak beheerder van &kde; (tab Algemeen). De Tekst-tot-spaak beheerder van &kde; (tab Algemeen)

- Markeer dit vakje om het &jovie; systeem te activeren. Dit start de &kde; TTS-daemon (Jovie). Wanneer &jovie; met succes gestart is, zal het tabblad Taken verschijnen en kunt u beginnen met het instellen en uitspreken van tekstopdrachten . Zie jobmgr. Na het verwijderen van deze markering zal &jovie; stoppen en het TTS systeem van &kde; gedeactiveerd worden.

- vergeet niet hier te klikken om u instellingen te bewaren.

### Beheren van tekst taken

Wanneer u op de Taken tab in `jovie` klikt zal het Taken scherm verschijnen.

De Tekst-tot-spaak beheerder van &kde; (tab Taken). De Tekst-tot-spaak beheerder van &kde; (tab Taken)

- De besturing hier stelt u in staat attributen te wijzigen van de huidige stem. Merk op dat dit alleen werkt als u geen stemmen hebt geselecteerd in het tabblad Sprekers.

- Met de knoppen in deze rij kunt u tekstopdrachten stoppen, afbreken, pauzeren en herstarten.

- Met de knoppen in deze rij kunt u de huidige tekst in het &kde; klembord laten voorlezen of een tekstbestand openen om te laten voorlezen. U kunt ook de spreker voor een taak wijzigen.

- Als u op de knop OK of Toepassen klikt worden alle nieuwe instellingen op andere schermen ook geactiveerd (indien aanwezig).

Het tabblad Taken verschijnt alleen wanneer &jovie; actief is. Als u geen tabblad Taken ziet, klikt u op het tabblad Algemeen en activeer het vakje Tekst-tot-spraak-systeem (Jovie) activeren.

### Het voorlezen van tekst van webpagina's.

In &konqueror;, de webbrowser van &kde;, kunt u de tekst van de getoonde webpagina laten voorlezen. Kontroleer eerst of &jovie; actief is. Markeer de tekst die voorgelezen moet worden, en kies dan in het hoofdmenu Hulpmiddelen Tekst uitspreken .Na een korte tijd begint het voorlezen.

Het is bijna altijd zinvol om de tekst op een webpagina, die u wilt laten voorlezen, te selecteren. Wanneer u deze niet selecteert worden ook de &HTML; koppen en ander onzichtbare markeringen voorgelezen.

### Het voorlezen van tekst in de tekstbewerker &kate;.

In &kate;, de geavanceerde tekstbewerker van &kde;, kunt u de getoonde tekst laten voorlezen. Controleer eerst of &jovie; actief is en schakel KTextEditor Jovie tekst-naar-spraak-plugin in in de instellingendialoog van &kate;. Markeer de tekst die voorgelezen moet worden, en kies dan in het hoofdmenu Hulpmiddelen Tekst uitspreken . Na een korte tijd begint het voorlezen.

Wanneer u de tekst niet selecteert, wordt het gehele bestand voorgelezen.

Dit werkt ook wanneer &kate; in een andere toepassing aangeroepen wordt, zoals in &konqueror; of in &quanta;.

### Het voorlezen van berichten (KNotify).

KNotify is het berichtensysteem van &kde;, dat u waarschuwt voor gebeurtenissen die u in het &kde; systeem ingesteld heeft. U kunt de tekst van deze berichten door &jovie; laten voorlezen.

In &konversation;, de IRC toepassing van &kde;, kunt u verschillende soorten van berichten instellen. U kunt &konversation; bijvoorbeeld zo instellen, dat u een bericht krijgt wanneer in een IRC kanaal een bericht verschijnt waarin uw bijnaam voorkomt. Met &jovie; kunt u dan dit IRC bericht laten voorlezen.

In het algemeen geldt dat als een &kde; toepassing KNotify ondersteund, zal er in een Notificaties menu verschijnen in het Instellingen menu van deze toepassing. De instellingen van KNotify kunnen voor elke toepassing verschillend zijn.

Tekstvervangerfilters bieden in &jovie; een goede oplossing om een verkeerde klemtoon of een fout bericht te corrigeren. Het `kmail.xml` bestand, die met &jovie; geleverd wordt, is een goed voorbeeld. Het verwijdert de `br` en `b` elementen uit de &kmail; notificatieberichten en het verwijdert ook de `/local/inbox` uitdrukkingen, dit zal in de meeste gevallen geen problemen geven. Zie ook stringreplacer.

### Filters (Geavanceerd)

Filters zijn een van de geavanceerde mogelijkheden van &jovie;. Voor de normale werking van &jovie; zijn ze niet nodig.

In filters wordt de tekst voorbewerkt, voordat die naar de spraakverdeler gestuurd wordt. Ze zijn handig voor het verbeteren van spraakuitvoer, om verkeerd uitgesproken woorden of afkortingen te vervangen, een passende taal en spreker te kiezen of om bepaalde beperkingen van spraaksynthesizers en hun stemmen te vervangen.

#### Soorten van &jovie; berichten

Om te begrijpen hoe filters werken, is het belangrijk te weten, hoe de spraak-verdeler met tekst omgaat. &jovie; kent vier soorten tekst.

- Schermlezeruitvoer

- Waarschuwingen.

- Berichten

- Tekst opdrachten

Het soort wordt door de toepassing bepaald, die de tekst naar &jovie; verstuurt.

Schermlezeruitvoer heeft de hoogste prioriteit. Ze heeft voorrang op alle andere opdrachten en zal alle andere opdrachten onderbreken. Nadat de schermlezer uitgespoken is, worden de andere opdrachten hervat.

Waarschuwingen hebben een lagere prioriteit. Het is voorbehouden voor belangrijke berichten zoals "Processor wordt te heet". Een waarschuwing onderbreekt berichten en reguliere tekstuitvoer. Deze opdrachten worden na het uitspreken van de waarschuwing weer hervat.

Berichten hebben een lagere prioriteit. Een bericht onderbreekt reguliere tekst uitvoer. &kmouth; bijvoorbeeld is een toepassing die berichten voorleest. Wanner u bijvoorbeeld een lange tekst van een webpagina laat voorlezen, kunt u iemand die op dat moment binnenkomt door &kmouth; laten begroeten. &kde; notificaties zijn ook berichten (zie ook knotify).

De rest zijn gewone tekstopdrachten. Elke opdracht die u vanaf de Taken tab aanroept is een tekstopdracht. KSayit is bijvoorbeeld een toepassing die tekstopdrachten gebruikt. Tekstopdrachten zijn bedoeld voor langere tekstuitvoer, die niet belangrijk zijn.

Alle vier de soorten van opdrachten worden na elkaar uitgevoerd, behalve schermlezeruitvoer. Wanneer een toepassing een schermlezeruitvoer begint, terwijl &jovie; er een voorleest, wordt deze uitvoer gestopt.

#### Soorten van filters

Als eerst dient u te weten dat filters nooit op schermlezeruitvoer worden toegepast. Ze worden toegepast op waarschuwingen, berichten en tekstopdrachten, en ook op &kde; notificaties (KNotify).

Filters bewerken de tekst en geven het door aan het volgende filter. Op dit moment zijn er drie soorten van filters.

- Tekstvervangers.

- &XML; omzetters.

- Spreker kiezers

Filters worden geïmplementeerd door een plugin architectuur te gebruiken. In de toekomst zullen er meer soorten van filters komen.

Tekstvervangerfilters vervangen een deel van een tekst door andere tekst. De te vervangen delen kunt u als woorden of als reguliere expressies opgeven. &jovie; komt met vooringestelde tekenreeks vervangende filters voor het voorlezen van afkortingen, het voorlezen van chat smileys zoals ":-)", of het omzetten van notificatie berichten van &konversation; of &kmail; in een beter verstaanbare vorm.

&XML; vertalers gebruiken een &XML; Style Language - Transforms (XSLT) bestand om &XML; van het ene formaat in het andere formaat te converteren. &jovie; komt met enige XSLT bestanden om &XHTML; in SSML te converteren.

Met sprekerkiezer kunt u opdrachten afhankelijk van de inhoud van de tekst of van de toepassing, die de tekst aan &jovie; verstuurt, naar een spreker sturen. Wanneer u bijvoorbeeld een vrouwelijke stem ingesteld heeft op het tabblad Sprekers, kunt u tekst, die van KSayit komt, naar die spreker sturen. Zie configure-talkers.

Elke van dit soort filters heeft instelbare parameters die bepalen of het filter op de uit te spreken tekst toegepast zal worden. Wanneer het filter niet toegepast wordt, zal het de tekst onveranderd aan het volgende filter doorgeven.

Als een teksttaak, bericht, waarschuwing of &kde;-melding naar &jovie; wordt gezonden, gaat het door elk van de ingeschakelde filters die u hebt geconfigureerd in het onderstaande scherm. De volgorde is van boven naar beneden.

#### Het instellen van filters

Om filters in te stellen klikt u op de Filter tab in `jovie`.

De Tekst-tot-spaak beheerder van &kde; (tab Filters). De Tekst-tot-spaak beheerder van &kde; (tab Filters)

- Dit is de lijst van ingestelde normale filters. Wanneer het niet aangekruist is, is het filter niet actief en zal het niet gebruikt worden. De filters worden van boven naar beneden doorlopen.

- Klik hier om een nieuw filter toe te voegen. Na het kiezen van het soort van filter krijgt u een van de onderstaande filterinstellingenschermen te zien.

- Klik hier om een filter te verwijderen.

- Klik hier om de instellingen van een filter te veranderen. Er zal nu een van onderstaand filterinstellingenschermen verschijnen.

- Klik op deze knoppen om een filter in de lijst naar boven of beneden verplaatsen.

- Klik hier anders worden u instellingen niet toegepast.

#### Het instellen van tekstvervangerfilters

Voor het instellen van tekstvervangerfilters dient u een lijst van woorden of reguliere expressies te maken die vergeleken worden. Wanneer deze in de tekst gevonden worden, worden ze vervangen door een vervangende tekst die u opgeeft.

Tekstvervanger Tekstvervanger

- Geef het filter een naam. U kunt elke naam gebruiken zolang die maar niet hetzelfde is als de andere filters.

- Dit is de lijst van woorden en reguliere expressies. Het filter zoekt naar overeenkomst op elke tekenreeks die in de Overeenkomst kolom voorkomt, en vervangt deze met overeenkomstige tekenreeks uit de Vervangen door kolom. De lijst wordt van boven naar beneden doorlopen.

- Klik hier om een woord of reguliere expressie aan de lijst toe te voegen.

- Klik hier om het gemarkeerde woord of de reguliere expressie naar boven of beneden te verschuiven.

- Klik hier om het gemarkeerde woord of de reguliere expressie in de lijst te bewerken.

- Klik hier om het gemarkeerde woord of de reguliere expressie uit de lijst te verwijderen.

- Gebruik deze knoppen om een lijst met woorden of reguliere expressies uit een bestand te laden, de huidige lijst naar een bestand te bewaren of te verwijderen. Wanneer u een lijst uit een bestand laadt, worden de items in het bestand onderaan de lijst toegevoegd.

- Is hier een taal opgegeven, wordt het filter alleen toegepast, wanneer de spreker voor de tekstopdracht een van de hier aangegeven talen spreekt. Gebruik deze knop om een lijst van talen te laten verschijnen. U kunt meerdere talen kiezen door tijdens het klikken ook de &Ctrl; toets ingedrukt te houden.

- Is hier een waarde ingegeven, wordt het filter alleen toegepast, wanneer de tekst van een van de opgegeven toepassingen komt. U kunt meerdere toepassing opgeven, gescheiden door komma's. Bijvoorbeeld: ``konversation,kmail``

  U kunt het Programma-id van het uitvoerende programma ontdekken door door middel van het `&qdbus;` programma. De &DBus;-nummers dient u weg te laten. Wanneer bijvoorbeeld &qdbus; het Programma-id `kopete-3432` laat zien, dient u alleen ``kopete`` op te geven.

Het tekstvervangerfilter wordt alleen dan op de tekst toegepast, wanneer aan alle voorwaarden in het veld Dit filter toepassen wanneer is voldaan. Wanneer alle velden leeg zijn, wordt het filter op alle tekst toegepast.

Bij het vergelijken van woorden gebruikt het tekstvervangerfilter een reguliere expressie in de vorm `\s`woord`\s`. De woorden moeten dus aan beide kanten gescheiden zijn door een spatie.

Een handleiding over het schrijven van reguliere expressies valt buiten het doel van dit handboek. Wanneer de &kde; reguliere expressie editor (kregexpeditor) geïnstalleerd is, is er in het Toevoegen of Bewerken scherm een knop die u helpt bij het maken van reguliere uitdrukkingen. De &kde; reguliere uitdrukkingen editor vindt u in de module Utils Git in playground.

&jovie; wordt geleverd met een aantal woordenlijst bestanden, onder andere een lijst met smiley's zoals ":-)", enige afkortingen die in IRC of chatprogramma's gebruikt worden en een lijst van andere afkortingen. Er is ook een lijst met speciale tekens waarmee de huidige Poolse festivalstem problemen heeft. Wanneer u zelf een woordenlijst maakt, kunt u deze met de Opslaan knop in een bestand bewaren en aan het &jovie;-team opsturen, die het dan in de volgende versie opnemen.

#### Het instellen van &XML;-omvormerfilters

&XML;-omvormerfilters gebruiken XSLT bestanden om &XML; van het ene formaat in het andere formaat te transformeren. XSLT (&XML; Style Language - Transforms) is een W3C-standaard voor dit soort omvormingen. Het kan alleen op &XML; toegepast worden die helemaal aan deze standaard voldoen. Het hulpprogramma `xsltproc` dient geïnstalleerd te zijn.

&XML;-omvormer &XML;-omvormer

- Geef het filter een naam. U kunt elke naam gebruiken zolang die maar niet hetzelfde is als de andere filters.

- Geef het volledige pad naar een bestaande XSLT bestand, die voor de omvorming gebruikt wordt.

- Geef het pad naar het hulpprogramma `xsltproc` op. Wanneer xsltproc door de omgevingsvariabele Path bereikbaar is, kan volstaan worden met enkel ``xsltproc``.

- Wanneer hier een waarde opgegeven is, zal het filter alleen dan op een &XML;-bestand toegepast worden wanneer het aan het opgegeven hoofdelement voldoet of een `<!DOCTYPE` specificatie heeft die met de opgegeven tekst begint. Bijvoorbeeld: ``html`` in het invoerveld DOCTYPE komt overeen met `<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" >`.

- Is hier een waarde ingegeven, wordt het filter alleen toegepast, wanneer de tekst van een van de opgegeven toepassingen komt. U kunt meerdere toepassing opgeven, gescheiden door komma's. Bijvoorbeeld: ``konversation,kmail``

  U kunt het Programma-id van het uitvoerende programma ontdekken door door middel van het `&qdbus;` programma. De &DBus;-nummers dient u weg te laten. Wanneer bijvoorbeeld &qdbus; het Programma-id `kopete-3432` laat zien, dient u alleen ``kopete`` op te geven.

Het &XML;-omvormerfilter wordt alleen dan op deze tekst toepepast wanneer het voldoet aan het opgegeven hoofdelement of het DOCTYPE en het programma-id, die in het Dit filter toepassen wanneer invoerveld opgegeven zijn. Als een item in dit veld leeg is, zal de test niet uitgevoerd worden. Wanneer alle items leeg zijn zal het filter op elke tekst toepepast worden. U dient echter tenminste een veld in te vullen daar de meeste tekstopdrachten niet in het &XML; formaat zijn.

#### Het instellen van sprekerkiezerfilters

Met een sprekerkiezerfilter kunt u tekst aan een gewenste spreker doorgeven, die op het tabblad Sprekers ingesteld is, of aan een spreker met bepaalde attributen.U kunt bijvoorbeeld opgeven, dat een tekst die van `kmail` komt door een vrouwelijke stem voorgelezen wordt. Zie configure-talkers.

Voordat &jovie; een tekst aan een van de filters doorgeeft, kiest het een spreker om deze tekst uit te spreken. De gekozen spreker wordt gebaseerd door de sprekerattributen die bepaald worden door de toepassing die de tekst naar &jovie; stuurt en de eigenschappen van de sprekers die u in de Sprekers tab ingesteld heeft. Met het sprekerkiezerfilter kunt u de gekozen spreker vervangen.

Sprekerkiezer Sprekerkiezer

- Geef het filter een naam. U kunt elke naam gebruiken zolang die maar niet hetzelfde is als de andere filters.

- Wanneer hier een waarde opgegeven is, zal het filter alleen dan toegepast worden, wanneer de tekst de opgegeven reguliere expressie bevat. Wanneer op uw systeem de &kde; reguliere expressie editor (kregexpeditor) geïnstalleerd is, kunt u deze door een klik op de knop ... starten om u te helpen bij het opgeven van de reguliere expressie.

  Om een snelere verwerking te verkrijgen, dient u te proberen de reguliere expressie aan het begin van de tekenreeks te "koppelen". Met andere woorden, begin de reguliere expressie met ``^``.

- Is hier een waarde ingegeven, wordt het filter alleen toegepast, wanneer de tekst van een van de opgegeven toepassingen komt. U kunt meerdere toepassing opgeven, gescheiden door komma's. Bijvoorbeeld: ``konversation,kmail``

  U kunt het Programma-id van het uitvoerende programma ontdekken door door middel van het `&qdbus;` programma. De &DBus;-nummers dient u weg te laten. Wanneer bijvoorbeeld &qdbus; het Programma-id `kopete-3432` laat zien, dient u alleen ``kopete`` op te geven.

- Geef hier de attributen van de door u gewenste spreker op. Wanneer de tekst aan de hierboven getoonde filtervoorwaarde voldoet, wordt een spreker gekozen die het beste aan de gewenste voorwaarde voldoet. Klik op de rechter knop om het Spreker selecteren scherm te laten verschijnen.

- Gebruik deze knoppen om u sprekerkiezerinstellingen te bewaren, instellingen uit een bestand te laden, of alle instellingen te wissen.

Het sprekerkiezerfilter wordt alleen dan op de tekst toepepast wanneer het voldoet aan het opgegeven waarde in het Dit filter toepassen wanneer veld. U dient echter tenminste een van de velden in te vullen.

## Aanwijzingen voor ontwikkelaars van &jovie;

&jovie; heeft twee Application Programmer Interfaces (APIs):

- De Tekst-tot-spraak API van &kde; waarmee programmeurs hun toepassing TTS mogelijkheden meegeven. Toepassingen communiceren met &jovie; via &DBus;.

- De &jovie; tekst-naar-spraak-plugin API, die gebruikt wordt om de spraaksynthesizer-plugins aan &jovie; toe te voegen, zodat &jovie; met een nieuwe spraaksynthesizer-engine kan werken.

De volgende sectie geeft een korte beschrijving van de Tekst-tot-spraak API &DBus; interface van &kde;. De volledige documentatie van beide API's kunt u vinden op de &kde; Accessibility website (http://accessibility.kde.org).

### De &jovie; &DBus; interface

Toepassingen vragen Tekst-tot-spaak diensten aan via het &kde; &DBus; interface naar het programma `jovie` object `KSpeech`.

Geef het volgende opdrachten in een &konsole;.

Wanneer &jovie; nog niet actief is

`jovie`

Om een tekstopdracht in de wachtrij te plaatsen

`qdbus org.kde.jovie /KSpeech zegt "`tekst`" "`opties`"`

waarbij ``tekst`` de tekst is die voorgelezen dient te worden en ``opties`` de taalcode is zoals bijvoorbeeld ``en``, ``nl``, &etc;

Voorbeeld.

`qdbus org.kde.jovie /KSpeech zegt "Dit is een test." "nl"`

Er zijn nog meer opdrachten die u gebruiken kunt. Voor een lijst van alle mogelijke opdrachten

`qdbus org.kde.jovie /KSpeech`

of lees de &kde; Tekst-tot-spraak API online.

## Vragen en Antwoorden

&reporting.bugs; &updating.documentation;

Ik moet helemaal opnieuw beginnen. Hoe kan ik &jovie; volledig afsluiten?

Geef de volgende opdracht in een &konsole;:

    kquitapp jovie

Hoe kan ik de debuguitvoer van `jovie` zien?

Open een &konsole;-venster. Start dan `jovie`.

Geen van de genoemde spraaksynthesizers ondersteunen mijn taal. Waar kan ik een synthesizer voor mijn taal krijgen?

Probeer het met Google(tm). Deze link kan ook helpen. Wanneer u een vrijgegeven synthesizer-engine vindt die de door u gewenste taal ondersteunt en ondersteuning voor &jovie; wilt toevoegen, neem dan contact op met het ontwikkelteam. Open-source synthesizers zijn speciaal welkom. Wanneer u een commerciële synthesizer kent, kunt u misschien de maker ervan overtuigen een vrije kopie aan het &jovie; ontwikkelteam te geven. In de tussentijd kunt u proberen de synthesizer te laten werken met een backend met spraak-verdeler commando's.

Ik heb het &HTML; &XML;-omvormerfilter geconfigureerd, maar bij het gebruiken van de Festival-plugin worden internetpagina's niet voorgelezen.

Door een fout in Festival 1.95 beta, dient u de `rab_diphone` stem (Britse man) te installeren om SABLE te laten werken, zelfs wanneer u deze stem niet gebruikt om internetpagina's te laten voorlezen. En kontroleer ook of het `xsltproc` hulpprogramma geïnstalleerd is en in u PATH-omgevingsvariabelen staat

Bepaalde karakters of punctuaties schijnen fouten in de synthesizer te veroorzaken, zodat gehele zinnen weggelaten of Bargoens uitgesproken worden. Wat kan ik daartegen doen?

Kontroleer eerst of de Tekensetcodering optie in het sprekerinstellingenscherm op de goede waarde voor de betreffende taal ingesteld is. Wanneer bepaalde woorden of karakters problemen geven, kunnen deze misschien door een tekstvervangerfilter opgeheven worden. Zie filters.

## Dankbetuigingen en Licentie

&jovie;

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

Huidige onderhouder: Jeremy Whiting jpwhiting@kde.org

Medewerkers:

- Gary Cramblitt garycramblitt@comcast.net

- Olaf Schmidt ojschmidt@kde.org

- Gunnar Schmi Dt gunnar@schmi-dt.de

- Paul Giannaros ceruleanblaze@gmail.com

Documentatie Copyright © 2009 Jeremy Whiting jpwhiting@kde.org © 2004 Gary R. Cramblitt garycramblitt@comcast.net

&meld.fouten;&vertaling.antoon; &underFDL; &underGPL;

De spraaksynthesizers, die door &jovie; gebruikt worden, hebben hun eigen licenties die u in de betreffende documentatie of op de webpagina kunt vinden. Enkele stemmen hebben hun eigen licentie.

## Installatie

### Hoe &jovie; te verkrijgen

&install.intro.documentation;

Debian installatiecommando: `apt-get install jovie`

U kunt koppelingen naar bron en binaire pakketten vinden op de &kde; Accessibility webpagina (http://accessibility.kde.org).

Wanneer u toegang heeft tot het &kde; broncodearchief, kunt u het pakket `jovie`-archief. &jovie; vindt u in de map `jovie`. Bovendien kunt u broncode van &jovie; vinden onder http://download.kde.org/stable/.

### Benodigdheden

Verplichte benodigdheden:

- &kde; versie 4.8 of hoger.

- spraak-verdeler versie 0.67 of hoger.

- Een spraaksynthesizer. De volgende synthesizers en gesproken talen worden op dit moment ondersteund.

  Espeak | Controleer http://espeak.sourceforge.net/languages.html voor de huidige lijst van ondersteunde talen
  Festival | Amerikaans engels, Brits, Spaans, Duits, Fins, Tsjechisch, Pools, Russisch, Italiaans, Frans-canadees, Kiswahili, Zulu, en Ibibio

  KTTSD werkt ook met elke spraaksynthesizer, die vanuit een &konsole; gestart kan worden.

  De lijst van de hierboven getoonde talen kan niet volledig of verouderd zijn. Kijk naar de specificatie van elke synthesizer voor een volledige lijst van de ondersteunde talen. Kijk voor extra informatie, die nog niet in dit handboek opgenomen is, op de &jovie; website .

  spraak-verdeler gebruikt een flexibele plugin architectuur voor spraaksynthesizers. Wanneer u &jovie; wilt uitbreiden met een ander synthesizer, kunt u contact opnemen met het ontwikkelteam.

  Specifieke instructies voor elk van de synthesizers kunt u in configuration vinden.

Optionele komponenten:

- Het hulpprogramma `xsltproc` wordt voor de ondersteuning van SSML en voor de XML-omvormerfilter gebruikt, maar is niet vereist. Debian gebruikers kunnen xsltproc installeren met het commando `apt-get install xsltproc`.

### Compileren en installeren

Om &jovie; te kunnen compileren heeft u een recente (&kde; 4.8 of hoger) kopie van de &kde; ontwikkelbestanden, inclusief kdelibs en de ontwikkelbestanden voor de spraak-verdeler nodig.

Wanneer u de &jovie; broncode uit het `kdeaccessibility` broncodearchief gedownload heeft of de tarball die elke nacht gemaakt wordt, gebruik dan de volgende commando's om te compileren en te installeren.

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

### Configuratie

Verzeker u ervan dat de spraak-verdeler werkt met uw spraaksynthesizerengine alvorens &jovie; te gebruiken. Het shell-script spd-conf kan daarvoor worden gebruikt.

&jovie; in &kde; 4.5 is hernoemd van KTTSD en kttsmgr. In de toekomst zal &jovie; worden gebruikt om de spraak-verdeler direct te gebruiken zonder spd-conf.

&documentation.index;