Korisnički priručnik

1.1 Što je Laprdus?

Laprdus je sintetizator govora (TTS - Text-to-Speech) za hrvatski i srpski jezik. Koristi tehnologiju konkatenativne sinteze, spajajući unaprijed snimljene fonemske jedinice za proizvodnju govora. Iako ne doseže kvalitetu modernih neuronskih TTS sustava, Laprdus nudi visoke performanse i minimalnu potrošnju memorije.

Laprdus je razvijen kako bi korisnicima čitača ekrana pružio jednostavan i brz pristup računalima i mobilnim uređajima na njihovom materinjem jeziku, besplatno.

Laprdus, započet kao moj osobni hobi projekt, također je zamišljen kao eksperimentalan, što mi omogućuje da vidim dokle mogu dogurati s njim.

1.2 Kome je Laprdus namijenjen?

Laprdus nije namijenjen svima. Dobar je izbor za one koji uživaju u nostalgičnom zvuku retro sintetizatora govora iz 1980-ih i 1990-ih godina.

Možda neće odgovarati korisnicima naviklim na visoku kvalitetu glasa modernih sintetizatora koji koriste umjetnu inteligenciju i neuronske mreže. Međutim, Laprdus bi mogao biti idealan za one kojima su performanse i minimalna potrošnja resursa važniji od kvalitete glasa.

Ukratko: moderni sintetizatori nude kvalitetu po cijenu resursa; Laprdus nudi performanse po cijenu kvalitete.

1.3 Podržane platforme

Laprdus je dostupan na sljedećim platformama:

• Windows 7 do Windows 11 - putem Microsoft SAPI5 standarda, što omogućuje korištenje Laprdusa u svim programima koji podržavaju Windows govor, što uključuje i čitače ekrana poput Narrator-a, NVDA-a i JAWS-a
• Direktna integracija sa NVDA čitačem ekrana - dostupan i kao poseban dodatak za besplatan Windows čitač ekrana NVDA
• Linux - putem Speech Dispatcher sustava za Orca čitač ekrana, te kao naredbeni program
• Android - kao ugrađen sintetizator govora za Android uređaje

1.4 Mogućnosti

Laprdus nudi sljedeće mogućnosti:

• Govor na hrvatskom i srpskom jeziku (podržano latinično i ćirilično pismo)
• Pet različitih glasova (dva osnovna i tri izvedena)
• Podešavanje brzine govora
• Podešavanje visine glasa
• Podešavanje glasnoće
• Prirodna intonacija koja prati interpunkciju
• Čitanje punih brojeva ili znamenku po znamenku
• Podešavanje trajanja pauza za različite interpunkcijske znakove
• Korisničke rječnike za prilagodbu izgovora riječi, fraza, simbola i emodžija

2.1 Windows SAPI5

Da biste instalirali Laprdus na Windows sustavu, slijedite ove korake:

Korak 1: Preuzimanje

1. Posjetite službenu stranicu Laprdusa: hrvojekatic.com/laprdus
2. Pronađite odjeljak za preuzimanje i kliknite na poveznicu za Windows SAPI5
3. Preuzmite instalacijski program (datoteka s nazivom Laprdus_SAPI5_Setup.exe)
4. Datoteka će se spremiti u vašu mapu Preuzimanja (Downloads)

Korak 2: Pokretanje instalacije

1. Otvorite Windows Explorer (tipka Windows+E)
2. Strelicom dolje pronađite mapu Preuzimanja i otvorite ju tipkom Enter
3. Pronađite preuzeti instalacijski program Laprdusa (datoteka s nazivom Laprdus_SAPI5_Setup.exe)
4. Preporučeno: Aplikacijska tipka ili Shift+F10 na datoteku, zatim odaberite "Pokreni kao administrator"
   • Alternativno: Pritisnite Enter za normalno pokretanje
5. Ako se pojavi prozor Kontrole korisničkog računa (UAC), odaberite "Da"

Korak 3: Proces instalacije

1. Odaberite jezik instalacije strelicom dolje i pritisnite Enter
2. Odaberite lokaciju instalacije (zadano: C:\Program Files\Laprdus) i tipkom Tab odaberite "Dalje" pa zatim Enter
3. Označite razmaknicom ako želite da vam se na radnoj površini kreira ikona za Laprdus konfigurator, a zatim tipkom Tab pronađite "Dalje" i pritisnite Enter
4. Tipkom Tab pronađite "Instaliraj", pritisnite Enter i pričekajte završetak instalacije
5. Na kraju instalacije, pritisnite Enter na "Završi" za zatvaranje instalacijskog programa

Korak 4: Provjera instalacije

1. Otvorite Upravljačku ploču (Control Panel):
   • Pritisnite tipku Windows
   • Upišite "Upravljačka ploča" i pritisnite Enter
2. Odaberite "Olakšani pristup" > "Prepoznavanje govora"
3. Tipkom Tab pronađite "Tekst u govor" i pritisnite Enter
4. U padajućem izborniku "Odabir glasa" trebali biste vidjeti Laprdus glasove:
   • Laprdus Josip
   • Laprdus Vlado
   • Laprdus Detence
   • Laprdus Baba
   • Laprdus Djedo

2.2 NVDA dodatak

Za korištenje Laprdusa s NVDA čitačem ekrana:

Korak 1: Preuzimanje

1. Posjetite službenu stranicu Laprdusa: hrvojekatic.com/laprdus
2. Pronađite odjeljak za preuzimanje i kliknite na poveznicu za NVDA dodatak
3. Preuzmite NVDA dodatak (datoteka s nastavkom .nvda-addon)
4. Datoteka će se spremiti u vašu mapu Preuzimanja

Korak 2: Instalacija dodatka

1. Otvorite Windows Explorer (tipka Windows+E)
2. Pronađite mapu Preuzimanja
3. Pronađite preuzetu datoteku Laprdus NVDA dodatka (datoteka s nastavkom .nvda-addon)
4. Pritisnite Enter na datoteci
   • Alternativno: Pritisnite aplikacijsku tipku (ili Shift+F10) za kontekstni izbornik, zatim odaberite "Otvori"
5. NVDA će prikazati dijalog s pitanjem "Želite li instalirati ovaj dodatak?"
6. Tipkom Tab pronađite gumb "Da" i pritisnite Enter, ili jednostavno pritisnite D za DA
7. Pričekajte završetak instalacije

Korak 3: Ponovno pokretanje NVDA

1. NVDA će zatražiti ponovno pokretanje
2. Odaberite "Da" za trenutačno ponovno pokretanje
3. Pričekajte da se NVDA ponovno pokrene

Korak 4: Odabir Laprdusa kao sintetizatora

Metoda 1: Putem NVDA izbornika

1. Otvorite NVDA izbornik: pritisnite NVDA tipka+N (Napomena: NVDA tipka na vašem sustavu može biti Insert ili Caps Lock, zavisno o tome kako ste ju konfigurirali.)
2. Strelicom dolje pronađite "Opcije" i pritisnite Enter
3. Strelicom dolje pronađite "Postavke" i pritisnite Enter
4. U dijaloškom okviru Postavke, strelicom dolje pronađite kategoriju "Govor"
5. Tipkom Tab pronađite gumb "Promijeni..." koji se nalazi odmah pored opcije "Govorna jedinica"
6. Pritisnite Enter na gumbu "Promijeni..."
7. U popisu sintetizatora strelicom dolje pronađite "Laprdus" i pritisnite Enter
8. Pritisnite Escape za zatvaranje postavki

Metoda 2: Brza prečica (preporučeno)

1. Pritisnite prečicu Ctrl+NVDA tipka+S
2. Otvorit će se dijalog za odabir sintetizatora
3. Strelicom dolje pronađite "Laprdus" i pritisnite Enter

2.3 Linux

Debian i Ubuntu

Otvorite terminal i pokrenite sljedeću naredbu (zamijenite naziv datoteke s nazivom preuzete .deb datoteke):

sudo dpkg -i laprdus_amd64.deb

Fedora

Pokrenite sljedeću naredbu (zamijenite naziv datoteke s nazivom preuzete .rpm datoteke):

sudo rpm -i laprdus.x86_64.rpm

Arch Linux

1. Preuzmite PKGBUILD datoteku s web stranice
2. U terminalu se pozicionirajte u direktorij s PKGBUILD datotekom
3. Pokrenite:

   makepkg -si

Ručna instalacija (iz tarball arhive)

1. Raspakirajte arhivu (zamijenite naziv datoteke s nazivom preuzete arhive):

   tar xf laprdus-linux-x86_64.tar.xz
   cd laprdus-linux-x86_64

2. Pokrenite instalacijski skript:

   sudo ./install.sh

Konfiguracija za Orca čitač ekrana

Nakon instalacije, Laprdus se automatski konfigurira za Speech Dispatcher. Za korištenje s Orca čitačem ekrana:

1. Za svaki slučaj, preporuča se da ponovno pokrenete Speech Dispatcher:

   systemctl --user restart speech-dispatcher

2. Otvorite Orca postavke:
   • Pritisnite Insert+Razmaknica za otvaranje postavki (ili Caps Lock+Razmaknica ukoliko je Orca modifikator namješten na Caps Lock ili Laptop layout)
   • Ili u Gnome ili Mate desktop okruženju: Alt+F2, upišite orca -s pa zatim Enter
3. Tipkom Tab ili Shift+Tab pozicionirajte se na kartice postavki, strelicom desno pronađite karticu "Voice" (Glas), a zatim ponavljanjem pritiska na tipku Tab odaberite:
   • Speech system: Pritisnite Razmaknicu za proširenje padajućeg izbornika, strelicom dolje odaberite Speech Dispatcher ukoliko već nije tako namješteno i pritisnite Enter
   • Speech synthesizer: Pritisnite Razmaknicu za proširenje padajućeg izbornika, strelicom dolje odaberite Laprdus pa zatim Enter
   • Voice: Pritisnite Razmaknicu za proširenje padajućeg izbornika, strelicom dolje odaberite željeni glas (josip, vlado, itd.) i pritisnite Enter
4. Tipkom Tab pronađite "Apply" (Primijeni) i zatvorite postavke

2.4 Android

Korak 1: Instalacija putem Google Play trgovine

1. Na svom Android uređaju otvorite Laprdus stranicu na Google Play trgovini (otvara se u novoj kartici)
2. Dodirnite "Instaliraj" i pričekajte završetak instalacije
3. Dodirnite "Otvori" za pokretanje aplikacije ili se vratite na početni zaslon

Korak 2: Postavljanje Laprdusa kao zadanog TTS-a

1. Otvorite Postavke na svom uređaju
2. Idite na: Pristupačnost > Tekst u govor (Text-to-speech)
   • Na nekim uređajima: Postavke > Sustav > Jezik i unos > Tekst u govor
   • Na Samsung uređajima: Postavke > Opće upravljanje > Jezik i unos > Tekst u govor
3. Dodirnite "Preferirani mehanizam" ili ikonu zupčanika
4. Odaberite "Laprdus TTS" iz popisa
5. Vratite se na prethodni zaslon i dodirnite "Slušaj primjer" za testiranje

3.1 Osnovna uporaba

Nakon instalacije, Laprdus je automatski dostupan svim programima koji koriste govornu sintezu na vašem sustavu. To uključuje:

• Čitače ekrana (NVDA, Orca, Narrator)
• Web preglednike s mogućnošću čitanja
• Programe za čitanje dokumenata
• Bilo koji program koji koristi Windows SAPI5 ili Android TTS

3.2 Naredbena linija (Linux i Windows)

Laprdus uključuje naredbeni program koji možete koristiti za pretvaranje teksta u govor direktno iz terminala.

Osnovni primjeri

# Izgovor teksta
laprdus "Dobar dan!"

# Korištenje drugog glasa
laprdus -v vlado "Zdravo svete!"

# Podešavanje brzine govora
laprdus -r 1.5 "Brži govor"

# Spremanje u WAV datoteku
laprdus -o govor.wav "Tekst za snimanje"

# Čitanje iz datoteke
laprdus -i dokument.txt

# Čitanje iz standardnog ulaza
echo "Tekst" | laprdus

Opcije naredbenog programa

3.3 NVDA postavke

Kada koristite Laprdus s NVDA čitačem ekrana, postavke glasa možete promijeniti na sljedeći način:

1. Otvorite NVDA izbornik (NVDA tipka+N)
2. Odaberite Opcije podizbornik pa zatim Postavke > kategorija Govor
3. U dijalogu možete podesiti:
   • Glas (odaberite jedan od 5 Laprdus glasova)
   • Brzinu govora
   • Visinu glasa
   • Glasnoću
   • Dodatnu brzinu ili Rate Boost (proširuje maksimalnu brzinu s 2x na 4x)

3.4 Android aplikacija

Laprdus Android aplikacija uključuje zaslon s postavkama gdje možete:

1. Odabrati glas
2. Podesiti brzinu govora
3. Podesiti visinu glasa
4. Podesiti glasnoću
5. Podesiti mogućnost čitanja emodžija
6. Podesiti način čitanja brojeva
7. Podesiti trajanje pauza

Za pristup postavkama:

1. Otvorite Laprdus aplikaciju iz ladice aplikacija
2. Pritisnite na gumb "Laprdus postavke"
3. Promijenite postavke po želji (Promjene se automatski spremaju)

4.1 Brzina govora

Brzina govora određuje koliko brzo Laprdus izgovara tekst. Raspon je od 0.5 (upola sporije) do 2.0 (dvostruko brže), pri čemu je 1.0 normalna brzina.

• 0.5 - Vrlo sporo, korisno za početnike ili kada trebate pažljivo slušati svaku riječ
• 1.0 - Normalna brzina, prikladna za većinu situacija
• 1.5 - Umjereno brzo, za iskusne korisnike
• 2.0 - Brzo, za napredne korisnike

4.2 Visina glasa

Visina glasa omogućuje podešavanje osnovne frekvencije glasa. Raspon je od 0.5 (niži glas) do 2.0 (viši glas), pri čemu je 1.0 prirodna visina glasa.

• 0.5 - Niži glas
• 1.0 - Prirodna visina
• 2.0 - Viši glas

4.3 Glasnoća

Glasnoća određuje koliko će govor biti glasan. Raspon je od 0.0 (tiho) do 1.0 (maksimalna glasnoća).

• 0.0 - Tiho (nema zvuka)
• 0.5 - Umjerena glasnoća
• 1.0 - Maksimalna glasnoća

4.4 Pauze

Laprdus automatski ubacuje pauze nakon interpunkcijskih znakova kako bi govor zvučao prirodnije. Možete podesiti trajanje pauza za:

• Točka - Pauza nakon točke (zadano: 100 ms u korisničkim postavkama, 80 ms u naredbenom programu)
• Uskličnik - Pauza nakon uskličnika (zadano: 100 ms u korisničkim postavkama, 70 ms u naredbenom programu)
• Upitnik - Pauza nakon upitnika (zadano: 100 ms u korisničkim postavkama, 60 ms u naredbenom programu)
• Zarez - Kratka pauza unutar rečenice (zadano: 100 ms)
• Novi red - Pauza za prijelom retka (zadano: 100 ms)

Vrijednosti se izražavaju u milisekundama (ms). Raspon je od 0 do 2000 ms.

4.5 Način čitanja brojeva

Laprdus može čitati brojeve na dva načina:

1. Riječima (zadano) - Brojevi se čitaju kao pune riječi
   • Primjer: "123" se čita kao "sto dvadeset tri"
2. Znamenkama - Brojevi se čitaju znamenka po znamenka
   • Primjer: "123" se čita kao "jedan dva tri"

Način čitanja riječima podržava brojeve do centiljuna (10^303) i koristi ispravne hrvatske gramatičke oblike.

4.6 Infleksija

Infleksija je prirodna promjena visine glasa koja prati interpunkciju:

• Točka na kraju rečenice uzrokuje pad visine glasa
• Upitnik uzrokuje porast visine glasa na kraju
• Uskličnik daje naglasak
• Zarez uzrokuje blagi porast visine glasa

Infleksiju je moguće uključiti ili isključiti. Kada je uključena, govor zvuči prirodnije.

4.7 Laprdus Konfigurator (Windows)

Na Windows sustavu, dodatne postavke možete podesiti putem Laprdus Konfiguratora:

1. Otvorite Windows Start izbornik, a zatim pronađite Laprdus konfigurator u programskoj mapi Laprdus i otvorite ga tipkom Enter.
2. Ili ako vam je Laprdus instaliran kao NVDA dodatak, otvorite NVDA izbornik > Laprdus podizbornik > Laprdus Konfigurator

Konfigurator omogućuje podešavanje:

• Brzine, visine i glasnoće govora
• Načina čitanja brojeva
• Trajanja pauza
• Infleksije
• Prilagodbu korisničkih rječnika

Postavke se spremaju u korisničkoj mapi %APPDATA%\Laprdus i dijele se između SAPI5 i NVDA dodatka.

5.1 Vrste rječnika

Laprdus koristi tri vrste rječnika, od kojih svaki ima posebnu namjenu:

5.2 Lokacije datoteka rječnika

Lokacija datoteka rječnika ovisi o platformi koju koristite:

Windows (SAPI5 i NVDA)

Sve datoteke rječnika nalaze se u korisničkom direktoriju Laprdusa:

%APPDATA%\Laprdus\

Puna putanja je obično: C:\Users\VašeKorisničkoIme\AppData\Roaming\Laprdus\

Kako otvoriti ovaj direktorij:

1. Pritisnite tipke Windows+R za otvaranje dijaloga "Pokreni"
2. Upišite: %APPDATA%\Laprdus
3. Pritisnite Enter

Datoteke u ovom direktoriju:

Linux

Datoteke rječnika nalaze se u:

~/.config/Laprdus/

Koristite iste nazive datoteka kao na Windowsu (user.json, spelling.json, emoji.json).

Android

Na Androidu, rječnici se uređuju isključivo putem sučelja Laprdus aplikacije. Datoteke se pohranjuju u internoj memoriji aplikacije i nisu izravno dostupne korisniku.

5.3 Glavni rječnik (user.json)

Glavni rječnik služi za zamjenu riječi ili fraza prilagođenim izgovorom. Koristan je za:

• Strane riječi i brandove - npr. "Facebook" izgovarati kao "Fejzbuk"
• Kratice - npr. "TV" izgovarati kao "Te Ve"
• Tehnički pojmovi - npr. "ChatGPT" izgovarati kao "ČetDžipiti"
• Imena s neuobičajenim izgovorom - npr. "Sean" izgovarati kao "Šon"

Format datoteke

Datoteka user.json koristi JSON format. Evo primjera:

{
    "version": "1.0",
    "entries": [
        {
            "grapheme": "Facebook",
            "phoneme": "Fejzbuk",
            "caseSensitive": false,
            "wholeWord": true,
            "comment": "Društvena mreža"
        },
        {
            "grapheme": "TV",
            "phoneme": "Te Ve",
            "caseSensitive": false,
            "wholeWord": true,
            "comment": "Kratica za televiziju"
        },
        {
            "grapheme": "ChatGPT",
            "phoneme": "ČetDžipiti",
            "caseSensitive": false,
            "wholeWord": true,
            "comment": "AI chatbot"
        }
    ]
}

Opis polja

Objašnjenje opcija

caseSensitive (razlikovanje velikih i malih slova):

• false (zadano): "Facebook", "facebook", "FACEBOOK" će svi biti zamijenjeni
• true: Samo točno podudaranje će biti zamijenjeno

wholeWord (samo cijela riječ):

• true (zadano): Zamjenjuje samo kada je tekst cijela riječ
  • "TV" u "TV program" će biti zamijenjeno
  • "TV" u "aktivator" neće biti zamijenjeno (jer je dio veće riječi)
• false: Zamjenjuje i unutar drugih riječi - korisno za sufikse i prefikse

5.4 Rječnik slovkanja (spelling.json)

Rječnik slovkanja definira kako se izgovaraju pojedinačni znakovi kada čitač ekrana slovka tekst (čitanje znak po znak). Koristan je za:

• Slova abecede - npr. "B" izgovarati kao "Be"
• Brojeve - npr. "5" izgovarati kao "pet"
• Interpunkciju - npr. "." izgovarati kao "točka"
• Posebne znakove - npr. "@" izgovarati kao "at"

Format datoteke

{
    "version": "1.0",
    "entries": [
        { "character": "A", "pronunciation": "A" },
        { "character": "B", "pronunciation": "Be" },
        { "character": "Č", "pronunciation": "Če" },
        { "character": "1", "pronunciation": "jedan" },
        { "character": ".", "pronunciation": "točka" },
        { "character": "@", "pronunciation": "at" }
    ]
}

Ugrađeni izgovori znakova

Laprdus dolazi s ugrađenim rječnikom slovkanja za hrvatski jezik. Evo pregleda:

Slova hrvatske abecede:

Brojevi:

Uobičajena interpunkcija:

Posebni znakovi:

5.5 Rječnik emodžija (emoji.json)

Rječnik emodžija pretvara emoji simbole u govorni tekst.

Uključivanje čitanja emodžija

Windows (Laprdus Konfigurator):

1. Otvorite Laprdus Konfigurator (Start > Laprdus > Laprdus Konfigurator)
2. Tipkom Tab pronađite opciju "Čitaj emodžije"
3. Označite potvrdni okvir
4. Tipkom Tab odaberite "U redu" i pritisnite Enter

NVDA:

1. Otvorite NVDA izbornik (NVDA tipka+N) > Laprdus podizbornik > Laprdus Konfigurator
2. Tipkom Tab pronađite opciju "Čitaj emodžije"
3. Označite potvrdni okvir
4. Tipkom Tab odaberite "U redu" i pritisnite Enter

Android:

1. Otvorite Laprdus aplikaciju
2. Dodirnite "Laprdus postavke"
3. Pronađite prekidač "Čitaj emodžije" i uključite ga

Format datoteke

{
    "version": "1.0",
    "entries": [
        { "emoji": "😀", "text": "nasmijano lice" },
        { "emoji": "👍", "text": "palac gore" },
        { "emoji": "❤️", "text": "crveno srce" },
        { "emoji": "🎉", "text": "konfeti" }
    ]
}

Ugrađeni emodžiji

Laprdus dolazi s opsežnim ugrađenim rječnikom emodžija koji sadrži preko 1100 emodžija s hrvatskim opisima. Evo nekoliko primjera:

5.6 Uređivanje rječnika na Windowsu (Laprdus Konfigurator)

Laprdus Konfigurator pruža grafičko sučelje za jednostavno upravljanje rječnicima. Ovo je preporučena metoda za korisnike koji preferiraju grafičko sučelje.

Kako otvoriti Konfigurator:

• Iz Start izbornika: Start > Laprdus > Laprdus Konfigurator
• Iz NVDA izbornika: NVDA tipka+N > Laprdus podizbornik > Laprdus Konfigurator

Uređivanje rječnika:

1. U Laprdus Konfiguratoru tipkom Tab ili Shift+Tab pronađite gumb "Rječnici..." i pritisnite Enter
2. Otvorit će se prozor Uređivač rječnika
3. Na vrhu prozora nalazi se padajući izbornik za odabir vrste rječnika koji želite prilagoditi:
   • Glavni rječnik - za zamjenu riječi i fraza
   • Rječnik slovkanja - za izgovor pojedinačnih znakova
   • Rječnik emodžija - za pretvaranje emodžija u tekst
4. Odaberite željenu vrstu rječnika strelicom dolje

Dodavanje novog unosa:

1. Kliknite gumb "Dodaj..."
2. Otvorit će se dijalog za unos:
   • Originalan (izvorni) niz: Upišite tekst koji želite zamijeniti
   • Zamjenski niz: Upišite kako želite da se tekst izgovara
   • Razlikuj velika/mala slova: Označite ako je bitno točno podudaranje
   • Samo cijela riječ: Označite ako ne želite zamjenu unutar drugih riječi
   • Komentar: Opcionalni opis unosa
3. Pritisnite Enter ili tipkom Tab pronađite gumb "U redu" pa zatim potvrdite tipkom Enter za spremanje unosa

Uređivanje postojećeg unosa:

1. Odaberite unos u popisu krećući se strelicama dolje ili gore
2. Tipkom Tab locirajte gumb "Uredi...", a za korisnike miša moguć je i dvoklik na unos
3. Izmijenite željene vrijednosti
4. Pritisnite Enter, ili tipkom Tab pronađite gumb "U redu" i pritisnite Enter

Brisanje unosa:

1. Odaberite unos u popisu strelicama gore ili dolje
2. Tipkom Tab locirajte gumb "Izbriši" i pritisnite Enter

Dupliciranje unosa:

1. Odaberite unos koji želite duplicirati
2. Tipkom Tab locirajte gumb "Dupliciraj" i pritisnite Enter
3. Novi unos s kopiranim vrijednostima bit će dodan u popis
4. Uredite duplicirani unos prema potrebi

5.7 Uređivanje rječnika na Androidu

Android aplikacija pruža ugrađeno sučelje za upravljanje rječnicima.

Korak 1: Otvorite rječnike

1. Otvorite Laprdus aplikaciju iz ladice aplikacija
2. Dodirnite gumb "Laprdus postavke"
3. Dodirnite gumb "Upravljanje rječnicima"

Korak 2: Odaberite vrstu rječnika

Na vrhu zaslona nalazi se padajući izbornik za odabir vrste rječnika:

• Glavni rječnik - za zamjenu riječi i fraza
• Rječnik slovkanja - za izgovor znakova
• Rječnik emodžija - za pretvaranje emodžija

Dodirnite padajući izbornik i odaberite željenu vrstu.

Korak 3: Dodavanje novog unosa

1. Dodirnite gumb "+" (plus) u donjem desnom kutu zaslona
2. Otvorit će se zaslon za unos:
   • Izvorni tekst: Upišite riječ ili frazu koju želite zamijeniti
   • Zamjenski izgovor: Upišite kako želite da se izgovara
   • Razlikuj velika i mala slova: Uključite ako je bitno točno podudaranje
   • Samo cijela riječ: Uključite ako ne želite zamjenu unutar drugih riječi
   • Komentar: Opcionalni opis
3. Dodirnite gumb "Spremi" na dnu zaslona

Korak 4: Uređivanje postojećeg unosa

1. Pronađite unos u popisu
2. Dodirnite unos za otvaranje zaslona za uređivanje
3. Izmijenite željene vrijednosti
4. Dodirnite "Spremi"

Korak 5: Brisanje unosa

1. Pronađite unos u popisu
2. Povucite unos ulijevo za prikaz opcije brisanja
3. Dodirnite ikonu koša za smeće
4. Potvrdite brisanje

5.8 Ručno uređivanje JSON datoteka (napredno)

Ova metoda je namijenjena naprednim korisnicima koji žele izravno uređivati JSON datoteke rječnika. Za većinu korisnika preporučujemo korištenje Laprdus Konfiguratora (Windows) ili sučelja Android aplikacije.

Prednosti ručnog uređivanja:

• Brže masovno dodavanje/uređivanje velikog broja unosa
• Mogućnost dijeljenja rječnika s drugim korisnicima
• Stvaranje sigurnosnih kopija rječnika

Korak 1: Otvorite direktorij s rječnicima

Windows:

1. Pritisnite Windows+R
2. Upišite: %APPDATA%\Laprdus
3. Pritisnite Enter

Linux:

1. Otvorite upravitelj datoteka
2. Otvorite skrivenu mapu .config u vašem osobnom direktoriju
3. Otvorite mapu Laprdus
4. Ili u terminalu: cd ~/.config/Laprdus

Korak 2: Otvorite ili stvorite datoteku

• Ako datoteka već postoji, otvorite je u tekstualnom editoru (Windows: Notepad, Linux: gedit, nano, vim)
• Ako datoteka ne postoji, stvorite novu tekstualnu datoteku s odgovarajućim imenom:
  • user.json za glavni rječnik
  • spelling.json za rječnik slovkanja
  • emoji.json za rječnik emodžija

Korak 3: Uredite sadržaj

Koristite JSON format opisan u prethodnim odjeljcima (5.3, 5.4, 5.5). Primjer za user.json:

{
    "version": "1.0",
    "entries": [
        {
            "grapheme": "YouTube",
            "phoneme": "Jutjub",
            "caseSensitive": false,
            "wholeWord": true,
            "comment": "Video platforma"
        },
        {
            "grapheme": "Google",
            "phoneme": "Gugl",
            "caseSensitive": false,
            "wholeWord": true,
            "comment": "Tražilica"
        }
    ]
}

Korak 4: Spremite datoteku

• Obavezno spremite datoteku s UTF-8 kodiranjem (za podršku hrvatskih znakova)
• Windows Notepad: Datoteka > Spremi kao > Encoding: UTF-8
• Linux: Većina editora automatski koristi UTF-8

Korak 5: Ponovno pokrenite sintetizator

• Windows SAPI5: Zatvorite i ponovno otvorite aplikaciju koja koristi Laprdus
• NVDA: Pritisnite NVDA tipku+Q i ponovno pokrenite NVDA, ili prijeđite na drugi sintetizator pa se vratite na Laprdus
• Linux: Ponovno pokrenite aplikaciju ili Speech Dispatcher: systemctl --user restart speech-dispatcher

5.9 Primjeri praktične uporabe

Primjer 1: Strane tvrtke i brandovi

Mnoge strane tvrtke i brandovi imaju izgovor koji se razlikuje od pisanog oblika:

{ "grapheme": "Microsoft", "phoneme": "Majkrosoft", "caseSensitive": false, "wholeWord": true }
{ "grapheme": "Google", "phoneme": "Gugl", "caseSensitive": false, "wholeWord": true }
{ "grapheme": "WhatsApp", "phoneme": "Watsap", "caseSensitive": false, "wholeWord": true }

Primjer 2: Kratice

Kratice koje želite da se čitaju slovo po slovo:

{ "grapheme": "TV", "phoneme": "Te Ve", "caseSensitive": false, "wholeWord": true }
{ "grapheme": "HR", "phoneme": "Ha Er", "caseSensitive": false, "wholeWord": true, "comment": "Kratica za Hrvatsku" }
{ "grapheme": "EU", "phoneme": "E U", "caseSensitive": false, "wholeWord": true, "comment": "Europska unija" }

Primjer 3: Tehnički pojmovi

{ "grapheme": "ChatGPT", "phoneme": "ČetDžipiti", "caseSensitive": false, "wholeWord": true }
{ "grapheme": "WiFi", "phoneme": "Vajfaj", "caseSensitive": false, "wholeWord": true }
{ "grapheme": "USB", "phoneme": "U Es Be", "caseSensitive": false, "wholeWord": true }

Primjer 4: Imena s neuobičajenim izgovorom

{ "grapheme": "Sean", "phoneme": "Šon", "caseSensitive": false, "wholeWord": true, "comment": "Irsko ime" }
{ "grapheme": "Elon", "phoneme": "Ilon", "caseSensitive": false, "wholeWord": true }

Primjer 5: Zamjena unutar riječi (wholeWord: false)

Za zamjenu sufiksa ili prefiksa, postavite wholeWord na false:

{ "grapheme": "tion", "phoneme": "šen", "caseSensitive": false, "wholeWord": false, "comment": "Engleski sufiks -tion" }

S ovim unosom, riječi poput "information" će sadržavati izgovor "šen" umjesto "tion".

5.10 Rješavanje problema s rječnicima

Problem: Promjene u rječniku se ne primjenjuju

Mogući uzroci i rješenja:

1. Primjena korisničkih rječnika je isključena - Uključite opciju "Primjena korisničkih rječnika" u Laprdus konfiguratoru (Windows) ili u Laprdus postavkama (Android)
2. Sintaksna greška u JSON datoteci - Provjerite jesu li svi navodnici ispravno zatvoreni i jesu li zarezi na pravim mjestima. Koristite online JSON validator za provjeru sintakse.
3. Datoteka nije spremljena s UTF-8 kodiranjem - U Notepadu: Datoteka > Spremi kao > Encoding: UTF-8
4. Sintetizator nije ponovno pokrenut - Zatvorite i ponovno otvorite aplikaciju. Za NVDA: Insert+Q > Ponovno pokreni NVDA
5. Datoteka je na krivoj lokaciji - Windows: %APPDATA%\Laprdus\, Linux: ~/.config/Laprdus/

Problem: Riječ se zamjenjuje na krivim mjestima

Rješenje: Uključite opciju "Samo cijela riječ" za problematični unos, ili ručno promijenite vrijednost za taj unos u konfiguracijskoj datoteci, wholeWord: true

Problem: Zamjena ne radi za velika/mala slova

Rješenje: Provjerite opciju "Osjetljivost na velika i mala slova" za problematičan unos, ili provjerite upis u konfiguracijskoj datoteci za taj unos, caseSensitive

• Za zamjenu neovisno o veličini slova: caseSensitive: false odnosno Isključeno
• Za točno podudaranje: caseSensitive: true odnosno Uključeno

Problem: Emodžiji se ne čitaju

Rješenje: Provjerite je li čitanje emodžija uključeno

1. Otvorite Laprdus Konfigurator ili Android postavke
2. Pronađite opciju "Čitaj emodžije"
3. Uključite opciju
4. Spremite postavke

6.1 Dostupni glasovi

Laprdus uključuje pet glasova - dva osnovna i tri izvedena:

6.2 Osnovni i izvedeni glasovi

Osnovni glasovi (Josip i Vlado) koriste fizičke snimke fonema - stvarne zvučne zapise govornika.

Izvedeni glasovi (Detence, Baba, Djedo) koriste iste zvučne zapise kao osnovni glasovi, ali s prilagođenom visinom glasa:

• Detence koristi Josipove foneme s visinom 1.5x (viši glas)
• Baba koristi Josipove foneme s visinom 1.2x (blago viši glas)
• Djedo koristi Vladove foneme s visinom 0.75x (niži glas)

6.3 Odabir glasa

Windows SAPI5

1. Otvorite Upravljačku ploču
2. Odaberite "Olakšani pristup" > "Prepoznavanje govora" > "Tekst u govor"
3. U padajućem izborniku "Odabir glasa" odaberite željeni Laprdus glas
4. Kliknite "Primijeni"

NVDA

Metoda 1: Postavke govora

1. Otvorite NVDA izbornik (NVDA tipka+N)
2. Odaberite Opcije > Postavke > Govor
3. U padajućem izborniku "Glas" odaberite željeni glas
4. Pritisnite "U redu" ili "Primijeni"

Metoda 2: Brzi prsten postavki

• Ctrl+NVDA tipka+Strelica lijevo/desno za promjenu glasa
• Ili koristite Ctrl+NVDA tipka+V za otvaranje dijaloga za odabir glasa

Linux (Speech Dispatcher)

# Lista dostupnih glasova
spd-say -o laprdus -L

# Korištenje određenog glasa
spd-say -o laprdus -y josip "Tekst na hrvatskom"
spd-say -o laprdus -y vlado "Tekst na srpskom"

Za trajnu promjenu u Orca čitaču ekrana:

1. Otvorite Orca postavke (Insert+Razmaknica)
2. Na kartici "Voice" odaberite željeni glas iz padajućeg izbornika

Android

1. Otvorite Laprdus aplikaciju
2. Dodirnite "Laprdus postavke"
3. U odjeljku "Glas" dodirnite padajući izbornik "Glas"
4. Odaberite željeni glas iz popisa

Za promjenu zadanog glasa u sustavu:

1. Otvorite Postavke > Pristupačnost > Tekst u govor
2. Dodirnite ikonu zupčanika pored "Laprdus TTS"
3. Odaberite željeni glas

7.1 Windows SAPI5

Laprdus se s Windows sustava uklanja putem standardnog Windows programa za uklanjanje.

Metoda 1: Putem Upravljačke ploče

1. Otvorite Upravljačku ploču (pritisnite tipku Windows, upišite "Upravljačka ploča" i pritisnite Enter)
2. Odaberite "Programi" > "Programi i značajke"
3. U popisu programa pronađite "Laprdus" strelicom dolje
4. Pritisnite Enter ili kliknite "Deinstaliraj"
5. Potvrdite uklanjanje kada se pojavi upit

Metoda 2: Putem Windows postavki

1. Otvorite Postavke (Windows+I)
2. Odaberite "Aplikacije" > "Instalirane aplikacije"
3. Pronađite "Laprdus" u popisu
4. Kliknite na tri točkice ili pritisnite Enter i odaberite "Deinstaliraj"
5. Potvrdite uklanjanje

Program za uklanjanje automatski briše:

• Sve datoteke iz instalacijskog direktorija (C:\Program Files\Laprdus)
• Registracijske ključeve za SAPI5 glasove
• Prečace iz Start izbornika
• Prečac s radne površine (ako je bio stvoren)

7.2 NVDA dodatak

Za uklanjanje Laprdus dodatka iz NVDA čitača ekrana:

1. Otvorite NVDA izbornik (NVDA tipka+N)
2. Strelicom dolje pronađite "Alati" i pritisnite Enter
3. Odaberite "Upravljanje dodacima" i pritisnite Enter
4. U popisu dodataka strelicom dolje pronađite "Laprdus"
5. Tipkom Tab pronađite gumb "Ukloni" i pritisnite Enter
6. Potvrdite uklanjanje
7. Ponovno pokrenite NVDA kada se to zatraži

7.3 Linux

Debian i Ubuntu

sudo dpkg -r laprdus

Ili alternativno:

sudo apt remove laprdus

Za potpuno čišćenje, uključujući konfiguracijske datoteke:

sudo dpkg --purge laprdus

Fedora

sudo dnf remove laprdus

Ili alternativno:

sudo rpm -e laprdus

Ako ste instalirali i razvojni paket:

sudo dnf remove laprdus laprdus-devel

Arch Linux

sudo pacman -R laprdus

Za uklanjanje zajedno s ovisnostima koje nisu potrebne drugim paketima:

sudo pacman -Rs laprdus

Ručna instalacija (iz tarball arhive)

Ako ste Laprdus instalirali iz tarball arhive, koristite instalirani skript za uklanjanje:

sudo /usr/local/share/laprdus/uninstall.sh

Ako ste pri instalaciji koristili prilagođeni prefiks (npr. /usr), skript se nalazi na odgovarajućoj lokaciji:

sudo /usr/share/laprdus/uninstall.sh

Instalacija iz izvornog koda

Ako ste Laprdus instalirali putem scons install, koristite odgovarajuću naredbu za uklanjanje:

sudo scons --platform=linux --build-config=release uninstall

7.4 Android

Za uklanjanje Laprdus aplikacije s Android uređaja:

1. Otvorite Postavke na svom uređaju
2. Odaberite "Aplikacije" (ili "Upravljanje aplikacijama")
3. Pronađite "Laprdus" u popisu instaliranih aplikacija
4. Dodirnite "Deinstaliraj"
5. Potvrdite uklanjanje

Alternativno:

1. Pronađite ikonu Laprdus aplikacije u ladici aplikacija
2. Dugo pritisnite ikonu
3. Povucite na opciju "Deinstaliraj" ili odaberite "Deinstaliraj" iz izbornika

7.5 Brisanje korisničkih postavki i rječnika

Uklanjanje Laprdusa ne briše korisničke postavke i rječnike na Windows i Linux sustavima. Ako želite potpuno ukloniti sve tragove Laprdusa, ručno izbrišite sljedeće direktorije:

Windows:

1. Pritisnite tipke Windows+R
2. Upišite: %APPDATA%\Laprdus
3. Pritisnite Enter
4. Izbrišite mapu Laprdus (ili sve datoteke unutar nje)

Linux:

rm -rf ~/.config/Laprdus

Android:

Na Androidu se svi podaci aplikacije automatski brišu prilikom deinstalacije. Nije potrebna dodatna akcija.

8.1 Česti problemi

Nema zvuka

1. Provjerite je li Laprdus odabran kao aktivni sintetizator
2. Provjerite da glasnoća nije postavljena na 0
3. Provjerite sistemsku glasnoću računala
4. Ponovno pokrenite program koji koristite

Govor je prebrz ili prespor

Podesite brzinu govora:

• U NVDA: Ctrl+NVDA tipka+N > Postavke > Govor > Brzina
• Na Androidu: Otvorite Laprdus aplikaciju i podesite klizač brzine u Laprdus postavkama
• U naredbenom programu: koristite opciju -r

NVDA ne pronalazi Laprdus

1. Provjerite je li dodatak ispravno instaliran (NVDA izbornik > Alati > Upravljanje dodacima)
2. Ponovno pokrenite NVDA
3. Provjerite da dodatak nije onemogućen

Speech Dispatcher ne radi na Linuxu

1. Provjerite je li Laprdus modul instaliran:

   ls /usr/lib/speech-dispatcher-modules/sd_laprdus

2. Provjerite konfiguraciju:

   grep laprdus /etc/speech-dispatcher/speechd.conf

3. Ponovno pokrenite Speech Dispatcher:

   systemctl --user restart speech-dispatcher

8.2 Dijagnostički zapisnici

NVDA dodatak

Za uključivanje dijagnostičkih zapisnika za NVDA dodatak:

1. Stvorite praznu datoteku laprdus_debug u privremenom direktoriju
   • Windows: %TEMP%\laprdus_debug
2. Ponovno pokrenite NVDA
3. Zapisnici će se spremati u %TEMP%\laprdus_debug.log

Linux

Koristite opciju -w za opširniji ispis:

laprdus -w "Test"

8.3 Kontakt i podrška

Za pomoć i podršku:

• E-mail: hrvojekatic@gmail.com
• Web stranica: hrvojekatic.com/laprdus
• Izvorni kod: github.com/hkatic/laprdus (otvara se u novoj kartici)

Pri prijavi problema, molimo navedite:

• Verziju Laprdusa
• Operativni sustav
• Korišteni čitač ekrana (ako je primjenjivo)
• Opis problema
• Korake za reprodukciju problema