Prosím prečitaj si toto ak máš otázky ohľadom programu.

Účelom tohoto programu (TCBR Shell) je vytvoriť knihy čitateľné na mobilných telefónoch, s použitím TequilaCat BookReader midlet-u.

Nižšie, je popísané prostredie programu. Bližšie informácie a detaily o samotnom midlet-e BookReader-u nájdeš na domovskej stránke programu:
http://tequilacat.narod.ru/dev/br/
Odporúčam skontrolovať či sa na web stránke programu nenachádza novšia verzia, s viacerými vlastnosťami odstránenými chybami.

Prostredie BookReader-u umožňuje:
1. Knihy vytvorené týmto prostredím môžu byť rozdelené do častí, na základe čísla kapitoly alebo by maximalej veľkosti ktorú si zvolíš
2. Rôňy značky mobilných telefónov sú podporované: Nokia, Siemens atď.
3. Keď vytváraš knihu, môžeš si zvoliťpísmo aké sa bude zobrazovať na displey-i, zo všetkých nainštalovanýchpísem vo Windows-e.
  Zatiaľ sú podporované iba štandardné písma ako Courier, v daľších verziách budú prístupné aj proporčné písma.
4. Môžeš si zvoliť farbu pozadia a písma, pre lepšiu čitateľnosť.
5. Môžeš si zvoliť z niekoľkých nastavení pre čítanie.
6. Ak prostredie obsahuje lokalizáciu midlet-u , môžeš localizovať midlet, tak aj vŠetky príkazy a menu v aplikácii telefónu budú zobrazené v tvojom rodnom jazyku.

================================================
Ako používať prostredie BookReader-u:
================================================
1. Stlač tlačidlo "+" na pridanie textového súboru(ov) ktoré chceš pridať do knihy
2. Stlač tlačidlo "-" na odstránenie textov zo zoznamu
3. Premenuj texty použitím tlačidla "Premenuj" na zmenu názvov ktoré budeš vidieť v telefóne
4. V záložke "Nastavenia", zvoľ verziu zodpovedajúcu výrobcovy tvojho telefónu a modelu
5. Zvoľ požadované nastavenia a obmedzenia veľkosti (viac si prečítaj o obmedzeniach veľkosti nižšie)
  Nastavenie "Zmeň veľkosť obrazovky o" je použiťeľné iba u telefónov Motorola a Samsung , na povolenie celoobrazovkového zobrazenia použitím hustejšieho riadkovania obrazovky kde sa obyčajne zobrazujú príkazy.

6. V záložke "Písma", zvoľ písmo a farby. Vyber "Použi písmo telefónu" na využitie priestoru pre knihy (1-2 kilobytes textu), ak tvoj telefón má obmedzenie veľkosti (opäť, pozri nižšie)
7. Napíš meno knihy na spodku okna. Toto meno bude použité v telefóne, tak použi proím len písmená latinka, čísla a podtržítka.
8. Zvoľ adresár do ktorého budú vygenerované knihy, stlačením tlačidla "...". Keď vytvoríš knihy, môžes otvoriť tento adresár kliknutím na jeho zvýraznenú cestu.
9. Klikni "Vytvor!" na vytvorenie kníh

Zapamätaj si prosím: Midlet BookReader-u podporuje iba textové súbory. Na čítanie súborov MS Word-u musíš ich  najskôr skonvertovať do textového formátu, tým že ich uložíš použitím "Ulož ako..." a zvolíš "Text formát"

Tento program generuje knihy: páry súborov JAD a JAR, ich počet závisí na zvolených nastaveniach a veľkosti textu. Každá kniha je tvorená párom JAR a JAD súborov.

JAR súbor obsahuje knihy - každý obsahuje textové súbory a midlet BookReader-u. V podstate JAR súbory sú ZIP archívy s príponou .JAR, a môžu byť prezerané akýmkoľvek archivačným programom podporujúcim ZIP kompresiu.
JAD súbory sú krátke textové súbory popisujúce midlety. Všeobecne každý JAR súbor by mal mať rovnaký JAD súbor ktorý popisuje jeho vlastnosti. Niektoré telefóny nepotrebujú JAD súbory, napr. SE T6x0 a Motorola Accompli.

Po vytvorení kníh, nahraj ich do telefónu a môžeš začať čítať.
Viac detailov ako nahrať vytvorené midlety (.jar súbory) získaš v manuály svojho mobilného telefónu alebo internetových fórach - tu je dostatok dostatok informácií na túto tému. Pre niektoré modely (napríklad Nokia 3410) ktoré nepodporujú  priame nahrávanie Java midletov prostredníctvom kábla, IRDA alebo BlueTooth, je stále možnosť nahrať ich vzduchom cez WAP, tu ale musíš vygenerované knihy uploadnúť najprv na WAP stránku.

====================================
FAQ (Dôležité!)
====================================

Prečo obmedzovať veľkosť JAR súborov a textových dokumentov?

Mobilné telefóny sú malé zariadnia s obmedzenými možnosťami. Na margo ostatných reštrikcií, veľkosť pamäte týchto zariadení je niekedy moc malá. Ako reštrikciu, výrobcovia mobilných telefónov limitujú maximálnu veľkosť aplikácií.

Takisto kvôli malej pamäte, sú obmedzenia aj vo veľkosti jednorázovo otváraného textu. Ak je jedna jeho časť príliš veľká, telefón ju nedokáže otvoriť, Buď sa zobrazí chyba, alebo sa nahrá nekompletný text.

Na obídenie týchto reštrikcií, TCBR Shell umožnje rozdeliť text do jednotlivých častí, čo má vpliv na veľkosť JAR súboru.

Takže, ak máš nasledujúce problémy:

Problém:
JAD a JAR súbory sa nedajú nahrať do telefónu, alebo nemôžu byť spustené po úspešnom nahratí (s chybami ako napríklad "Chyba aplikácie", "súbor priveľký" atď.)

Riešenie 1:
vytvorný JAR súbor je príliš veľký pre tvoj telefón - prosím obmedz veľkosť JAR súboru v záložke "Nastavenia".

Riešenie 2:
Vybral si si zlú verziu midletu - od iného výrobcu mobilného telefónu, alebo pre iný model telefónu. Modely telefónov sa odlišujú v podpore rôznych nastavení použitých bookreaderom. Inštalovanie verzie bookreaderu vytvoreného pre iný model väčšinou havaruje.

Problém:
JAR súbor sa úspešne nahrá a beží, ale obsiahnuté knihy nemôžu byť otvorené. Alebo, knihu je možné otvoriť ale časť textu sa stratí (v porovnaní s textom ktorý môžeš nájsť obsiahnutý v JAR archíve)

Riešenie:
Generované časti sú príliš veľké aby sa zmestili do pamäťi tvojho telefónu. Prosím zmenši veľkosť častí textu v nastaveniach.

Problém:
Je generované veľké množstvo textov v JAR súbore, alebo veľa JAR súborov.

Riešenie:
Špecifikoval si veľkosť v kilobytoch (napr. 60) ale veľkosť musí byť v bytoch (v tomto prípade je správne, 60000).

Doporučené veľkosti pre niektoré telefóny sú:

Nokia S40 (Je veľké množstvo Nokia telefónov) - JAR max 64000, Text max 60000

SonyEricsson T6x0 a Motorola T720 - veľkosť JAR sa zdá byť neobmedzená (alebo 200-300 kb), max veľkosť textu je 120000-150000.

Ak tu nie je uvedený tvoj telefón, a spozoruješ problémy, vyskúšaj sám iné čísla.
Použi veľkosti pre Nokiu (max JAR veľkosť alebo max veľkosť textu v závyslosti aký máš problém), vyskúšaj a nájdi čo ti bude vyhovovať.
Budem opatrný (a ostatní používatelia Bookreaderu tiež) ak mi pošleš tieto veľkosti aby som ich tu uviedol.



Tento program je pod ochrannou známkou TequilaCat, pozri detaily license.txt.

Použitý ostatný free software (ako DLL):
* FreeImage knižnice
* infozip' zip knižnice
* ZipBuilder knižnice súčasťou infozip' zip knižníc
Ďakujem ich autorom, čoskoro pridám licenčné info.
