
Kydpdict
(c) 2007 Maciej Witkowiak <ytm@elysium.pl>
http://members.elysium.pl/ytm/html/kydpdict.html
http://ytm.bossstation.dnsalias.org/html/kydpdict.html



1. CO TO JEST

Program Kydpdict jest graficzn nakadk pozwalajc na atwe i efektywne
korzystanie w rodowisku graficznym z darmowego i komercyjnych sownikw
dostpnych pod Windows.
Dziaa pod systemem Linux i (prawdopodobnie nadal) MacOS X. Wbrew swojej
nazwie nie jest programem zalenym od rodowiska KDE. Od wersji 0.9.0
rwnie wbrew swojej nazwie nie jest li tylko nakadk na sownik YDP.

1.1 WYMAGANIA

Konieczne jest posiadanie biblioteki Qt w wersji >=3.1, jeli kompilujemy
program konieczny bdzie take pakiet Qt-devel.

1.2 KOMPILACJA

Wykonaj
    ./configure
ewentualnie (zobacz niej komu mogoby si to przyda):
    ./configure --without-x
Wykonaj
    make

Jeli skrypt ./configure zakoczy si bdem, to prawdopodobnie nie moe znale cieek
do Qt. Naley wwczas jawnie je poda, np.
    ./configure --with-qt-includes=/usr/X11R6/include/qt --with-qt-libs=/usr/X11R6/lib
Jeli Qt zostao zainstalowane bezporednio ze rde to prawdopodobnie wystarczy co
podobnego do:
    ./configure --with-qt-dir=/usr/local/qt

W razie kopotw zajrzyj do dokumentacji Qt (to o $QTDIR te przeczytaj :).

Jeli wywoasz ./configure --without-x, to program bdzie bezporednio zalea tylko
od biblioteki Qt. Moe mie to zastosowanie na systemach, na ktrych nie ma X11, ale
jest dostpne Qt (MacOS X z natywnym Qt (nie-X11)?) oraz u tych purystw, ktrzy nie
chc w ogle niczego zwizanego z ryb na tacce systemowej.

Instalacja - wykonaj
    make install

Na FreeBSD moe by konieczne korzystanie z gmake oraz jawne dodanie biblioteki pthread,
mona to zrobi nastpujco:

CXXFLAGS="$CXXFLAGS -lpthread" ./configure



2. OBSUGIWANE TYPY SOWNIKW


2.1 SAP

SAP, czyli sownik angielsko-polski (i polsko-angielski) to domylny modu
sownikowy. Jest najmodszy, dlatego jeszcze wymaga poprawek, jednak ju
uyteczny. Pierwotna, konsolowa, wersja SAP nie ma dziaajcej wasnej strony
domowej, mona go pobra z zasobw PLD: http://www.pld-linux.org/ lub std:
http://pbs.linux.net.pl/?op=pr&f=sap


2.2 YDP

Ten modu obsuguje pliki danych sownikw wydanych przez Young Digital Poland,
czyli sownikw Collins i Langenscheidt. Do dziaania niezbdne jest posiadanie
plikw z zainstalowanego pod Windows programu. Dla wersji angielskiej chodzi o
pliki:
    dict100.dat, dict101.dat, dict100.idx, dict101.idx
a dla niemieckojzycznej:
    dict200.dat, dict201.dat, dict200.idx, dict201.idx.
Najwygodniej skopiowa je do domylnego katalogu danych, to jest:
    /usr/share/kydpdict lub /usr/local/share/kydpdict
albo umieci tam tylko linki symboliczne do plikw na partycji windowsowej.
Nazwy plikw powinny zawiera tylko mae litery.

Do odtwarzania wymowy sw potrzebny bdzie zewntrzny program. Moe to by play
do oryginalnych plikw wav lub jeli zostay przekodowane: mpg123, ogg123 i wiele
innych.
Odtwarzacz jest wsplny dla plikw dwikowych obu jzykw, wic musisz zadba,
aby byy one w jednakowym formacie.
Jeli korzystasz z serwera dwiku by moe zamiast play trzeba bdzie uy
esdplay lub artsplay. (mplayer si _nie nadaje_ - le odtwarza krtkie pliki
dwikowe)


2.3 PWN Oxford 2003

Trzeci modu sownikowy pozwala na korzystanie ze sownika PWN Oxford 2003.
Jest to tylko sownik angielsko-polski, ktry by doczany do papierowego
wydania sownika Oxford.
Niezbdne jest posiadanie pliku danych z ju zainstalowanej aplikacji pod Windows.
W tym wypadku chodzi o plik 'angpol.win'. Dalej naley postpowa podobnie, jak
opisano dla moduu YDP.


2.4 PWN Oxford 2004

Odmiana wersji z 2003 roku, obsuguje sowniki angielsko-polski i polsko-angielski.
Niezbdne jest posiadanie obu plikw danych z ju zainstalowanej aplikacji pod
Windows. Chodzi o pliki 'angpol.win' oraz 'polang.win'. Dalej naley postpowa
tak, jak opisano wyej.



3. ZALETY PROGRAMU

Korzystanie ze sownika nigdy nie byo tak proste jak obecnie. W wikszoci
przypadkw tumaczymy teksty w postaci elektronicznej. Nie ma wic sensu wpisywa
z klawiatury wyrazw (czas znacznie powyej sekundy), ani nawet zaznacza tekstu,
naciska Ctrl+C, zmienia okno na okno sownika i wkleja tekst naciskajc Ctrl+V
(czas rzdu sekundy). Teraz pracujc z tekstem obcojzycznym (np w przegldarce www)
wystarczy tylko zaznaczy wyraz (w wikszoci aplikacji zaznacza si tekst dwukrotnym
klikniciem na wyrazie) aby pojawio si "na grze" okno sownika z tumaczeniem
(czas rzdu uamka sekundy!). Jeli wyrazu, ktry zaznaczye nie ma w sowniku,
pojawi si tumaczenie wyrazu mu najbliszego (np: wyrazu "investigations" nie
ma w sowniku, ale najbliszy mu podobny to "investigation").

Od tej chwili wszystko co zaznaczysz pojawi si przetumaczone, jeli zacznie
Ci to przeszkadza po prostu wycz opcj ledzenia schowka - przez pasek ikon
lub menu z ryby.

Jedn z zalet jest take atwa konfiguracja programu: cieek dostpu do plikw
sownika, cieki do plikw z wymow (oryginalne pliki wav lub zakodowane do
mp3/ogg), a take kolorw tekstu tumaczenia i ta aplikacji. Te i inne parametry
programu (np pozycja na ekranie, wielko okna s przechowywane w katalogu
.kydpdict w Twoim katalogu konfiguracyjnym. Bdzie to katalog okrelony przez
bezwzgldn ciek ze zmiennej $HOME_ETC lub katalog domowy lub katalog poniej
niego okrelony przez zmienn $CONFIG_DIR (testowane w tej kolejnoci).

Kilka najwaniejszych skrtw klawiaturowych:
- ESC pozwala szybko wpisa z klawiatury nowy wyraz - czyci lini edycji i przenosi
  tam kursor
- kolejne nacinicie ESC (ale dopiero po upyniciu co najmniej .5s) pozwala ukry
  sownik - jak przy klikniciu na rybie
- Ctrl+` (znak nad TAB) pozwala szybko zamieni kierunek tumaczenia



4. KONFIGURACJA

W razie problemw po prostu skasuj katalog z plikami konfiguracyjnymi.
Program postara si odtworzy go z domylnych wartoci oraz korzystajc z
/etc/ydpdict.conf jeli korzystasz jednoczenie z konsolowego sownika ydpdict.

Wyboru moduu sownikowego i cieki do plikw danych specyficznych dla
tego sownika dokonujemy w zakadce 'Sownik'. Zmiany zostan uwzgldnione
po ponownym uruchomieniu programu. W danej chwili mona mie aktywny tylko
jeden rodzaj sownika.

Krtki opis opcji konfiguracyjnych z zakadek 'Rne' i 'Schowek'
- 'Wcz ledzenie schowka' - okno sownika wyskakujce na wierzch moe przeszkadza,
   w ten sposb mona wyczy takie zachowanie
- 'Ignoruj wasne zaznaczenia' - jeli zawarto schowka pochodzi z okna tumacze
   kydpdict, to zostanie zignorowana (kto ma lepszy pomys na nazw tej opcji?)
- 'Uywaj pochyej czcionki' - niektre czcionki wygldaj brzydko w odmianie
   pochyej; mona nieco poprawi wygld i czytelno okna wyczajc je t opcj
- 'Wcz podpowiedzi' - opcja kontrolujca wywietlanie wyjanie po najechaniu
   myszk na sownikowe skrty
- 'Wcz ikon na tacce systemowej' - pozwala wyczy ikon dla managerw okien,
   z ktrymi sprawia to problemy
- 'Autoodtwarzanie dwiku' - dotyczy tylko tekstu przechwyconego ze schowka
- 'Ustawiaj focus na siebie' - czasem wygodnie jest mie okno Kydpdict wyskakujce
   na wierzch z tumaczeniem ale nie pozostawiajce jako aktywne poprzednie okno - ta
   opcja kontroluje takie zachowanie (wyjtek: jeli okno byo niewidoczne - po
   trzykrotnym ESC, to zawsze dostanie focus)

Duszego omwienia wymaga opcja 'Wywietlaj znaki Unicode'. Po jej wczeniu,
znaki transkrypcji fonetycznej zamiast pochodzi z wbudowanych plikw graficznych
(ktre nie zmieniaj rozmiaru wraz z fontem) bd konwertowane na odpowiednie kody
Unicode.
Oznacza to, e do prawidowego wywietlania niezbdne jest posiadanie fontu, ktry
takie znaki posiada. Obecnie pod Linuksem nie ma ju wikszego problemu z instalacj
nowych fontw TTF, dlatego opis instalacji pomin i nie bd odpowiada na pytania
w tej sprawie :). Oto kilka adresw, z ktrych mona cign darmowe fonty
obsugujce potrzebny w sowniku zakres znakw:

Lucida Sans Unicode:
http://www.phon.ucl.ac.uk/home/wells/lsansuni.ttf

Doulos:
http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=DoulosSILfont

W poniszych brakuje znaku strzaki w prawo - odsyacza, poza tym s bez zarzutu:

Caslon:
http://bibliofile.mc.duke.edu/gww/fonts/Unicode.html

Gentium:
http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=gentium



5. Q & A (jeszcze nie FAQ, bo to pierwsza edycja :)

Q: Program nie potrafi zapamita swojego pooenia na ekranie
A: Najprawdopodobniej wymusza to twj manager okien, Kydpdict nic na to nie
   poradzi.

Q: W KDE program nie wyskakuje ponad inne okna po znaznaczeniu nowego wyrazu
A: W Centrum Sterowania->Pulpit->Okna->Zaawansowane zmie poziom ochrony przed
   zmian aktywnego okna na 'Brak'.

Q: Skrty klawiaturowe s chore - kto to wymyla?
A: Ja. Jeli masz pomys na atwiejsze, nie kolidujce z domylnymi skrtami
   najpopularniejszych managerw okien - daj mi zna.

Q: Co jest do zrobienia, jakie s znane bdy?
A: Program jest doskonay, nie ma bdw. Co mona byoby jeszcze dopisa,
   znajdziesz w pliku TODO.

Q: Co na tacce robi ryba?
A: Kolejne wersje Kydpdict bd wyposaone nie tylko w ryb na tacce ale i
   plastikowe sztuce. Na serio: nie syszae o babelfish? Id do biblioteki,
   ksigarni i poszukaj ksiek Douglasa Adamsa. Albo wybierz si do kina.

Q: A co ze sownikiem PWN Oxford 2004 w kartonowym pudeku za dwie baki?
A: Podstawowy sownik ju dziaa. Co do sampli z wymow, to nie mam danych do
   testowania. Podobnie z tabelami i dodatkowymi informacjami o gramatyce - niby
   s, ale nie bardzo wiem co z nimi zrobi w obecnej formie programu.
   
Q: Jak wyrazi wdziczno i zmotywowa do dalszej pracy?
   W dobie bankowoci elektronicznej to proste - chcesz zaokrgli stan rachunku w
   d :)? Jest moliwo; oto numer mojego konta: 60 1140 2004 0000 3202 3234 6486



6. KONTAKT
Prosz pisa w sprawie programu na Berdy^W ytm@elysium.pl, sprawami zwizanymi
z moduem YDP moe by rwnie zainteresowany Andrzej Para <kulozik@op.pl>.
