YASR ("Yet Another Screen Reader") jest moj prb stworzenia lekkiego,
przenonego screenreadera. Dziaa poprzez otwarcie shella w
pseudoterminalu i przechwytywanie caego wejcia/wyjcia uytkownika,
utrzymujc wewntrzny obraz tego, co powinno by wywietlone na ekranie
obserwujc kody i teksty wysyane na ekran. Nie uywa adnych
"linuksizmw" typu /dev/vcsa0 i nie musi by suidowany na roota (jedynym
wymaganiem jest dostp uytkownika do syntezatora). Yasr jest tworzony
na licencji GNU/Linux, lecz podejmowaem prby portowania go na FreeBSD
i powinien on dziaa na uniksopodobnych systemach po maych
przerbkach.

Domylnie Yasr prbuje komunikowa si z syntezatorem poprzez
speech-dispatchera (uywajc nazwy klienta "yasr"), lecz moe on rwnie
wsppracowa z serwerami Emacspeak lub bezporednio z niektrymi
syntezatorami. Szczegy w pliku yasr.conf.

Instrukcja instalacji - patrz plik INSTALL.

Domylnie plik yasr.conf bdzie skopiowany do /usr/local/share/yasr.
Jeli potrzebujesz wasnego pliku konfiguracyjnego ze swoimi opcjami,
powiniene skopiowa ten plik do katalogu domowego jako .yasr.conf i
dokona poprawek w tym pliku. ~/.yasr.conf jest sprawdzany jako
pierwszy. Ten plik zawiera wszystkie definicje klawiszy oraz opcje,
ktre mog by zmieniane poprzez modyfikacj pliku. Wikszo opcji moe
by rwnie ustawiana bezporednio z poziomu programu.

Aktualnie yasr ma dwa zestawy map klawiatury, jedn do "trybu
przegldania" (tzn. przegldania zawartoci ekranu) i jedn dla trybu
standardowego. Klawisze zdefiniowane dla trybu standardowego dziaaj
rwnie w trybie przegldania, jednak w tym trybie klawisze zdefiniowane
dla trybu przegldania sprawdzane s jako pierwsze. Poniej znajduje si
lista klawiszy wraz z przypisanymi im domylnie funkcjami. Klawisze
poprzedzone [n] mog by opcjonalnie poprzedzone cyfr.

-- Tryb przegldania --

spacja: Podaje pozycj kursora przegldu.
^: Skacze do pocztku linii i czyta sowo.
$: Skacze do ostatniego znaku linii i czyta sowo.
[n]b: Czyta poprzedni znak.
[n]c: Czyta znak.
[n]d: Czyta nastpny znak.
e: Czyta od pozycji kursora do koca ekranu.
f: Wyszukuje tekst na ekranie.
<: Szuka od kursora do gry ekranu uywajc wprowadzonego uprzednio
   tekstu.
>: Szuka od kursora do koca ekranu uywajc wprowadzonego uprzednio
   tekstu.
[n]k: Przechodzi do poprzedniej linii i czyta lini (jak strzaka w
   gr).
[n]l: Czyta biec lini.
[n]m: Przechodzi do nastpnej linii i czyta lini (jak strzaka w d).
n: Przekazuje nastpny klawisz do aplikacji.
t: Czyta od pocztku ekranu do pozycji kursora.
w: Czyta cay ekran.
z: Skacze do pocztku poprzedniego sowa i czyta sowo.
x: Skacze do pocztku nastpnego sowa i czyta sowo.
[n]strzaka w gr: Przechodzi do poprzedniej linii i czyta lini.
[n]strzaka w d: Przechodzi do nastpnej linii i czyta lini.
[n]strzaka w lewo: Cofa do poprzedniego znaku i czyta znak.
[n]strzaka w prawo: Przechodzi do nastpnego znaku i czyta znak.
(: Przechodzi do przedniego akapitu.
): Przechodzi do nastpnego akapitu.
alt-i: Reinicjalizuje syntezator.
`: Czyta kod ASCII biecego znaku.

-- tryb standardowy (dziaa rwnie w trybie przegldania) --

ctrl-a: Podaje pozycj kursora aplikacji.
ctrl-l: Czyta lini.
ctrl-n: Przekazuje nastpny klawisz do aplikacji.
ctrl-x: Oprnia bufor mowy.
alt-b: Czyta poprzedni znak.
alt-c: Czyta biecy znak.
alt-d: Czyta sowo.
alt-e: Czyta od kursora do koca ekranu.
alt-k: Czyta poprzedni lini.
alt-l: Czyta lini.
alt-m: Czyta nastpn lini.
alt-r: Przecza tryb przegldania.
alt-t: Czyta od pocztku ekranu do kursora.
alt-w: Czyta cay ekran.
alt-x: Wycza mow a do nacinicia dowolnego klawisza (np.
       wcinicie ponowne wcza mow).
ctrl-alt-k: Asystent ustawie klawiatury. Pozwala na przenoszenie,
       kopiowanie lub usuwanie kombinacji klawiszy.
ctrl-alt-o: Menu opcji.
ctrl-alt-s: Zapis konfiguracji na dysk.
alt-enter: Zawiesza yasr. Yasr nic nie mwi i ignoruje w tym stanie
       wszystkie kombinacje klawiszy.
       Nacinij jeszcze raz dla uaktywnienia.
       Uwaga: ten klawisz jest zdefiniowany w sekcji [options] jako
       "DisableKey".

Sugestie, patche itd. mile widziane.

   -Michael P. Gorse <mgorse@users.sourceforge.net>
   
