5курс / антимонопольное / tcbr22633 / i18n / readme1

Please read this if you have questions about the program.

This program purpose is to prepare books for reading on mobile phones, using TequilaCat BookReader midlet.

Here the shell program is described. You can find more details and information on the BookReader midlet itself on the program's homepage:
http://tequilacat.narod.ru/dev/br/

The BookReader shell features are:
1. The books prepared with the shell can be split onto chapters, by chapter header or by maximal size you specifiy
2. Various brands of mobile phones are supported: Nokia, Siemens etc
3. When preparing book, you may choose a font to read on your phone, amongst all fixed width fonts installed in your Windows.
So far only fixed fonts are supported like Courier, in next versions the proportional fonts will be available too.
4. You may choose background and foreground colors, for most comfortable reading.
5. You may set numerous options for reading.
6. If the shell includes midlet localization file, you may opt to localize the midlet, so all the commands and menus in phone application will be shown in your native language.

================================================
How to use BookReader shell:
================================================
1. Press "+" button to add text file(s) to include into book
2. Press "-" to remove texts from the list
3. Rename the texts using "Rename" button to change labels you will see in the phone
4. On "Option" tab, select version for your phone brand and model
5. Set desired options and size restrictions (see more on size restrictions below)
6. On "Fonts" tab, select font and colors. Select "Use phone fonts" to save space for books (1-2 kilobytes of text), if your phone places size restrctions (again, see below)
7. Enter book name at bottom of the window. This name will be used in phone, so please use only latin numbers, digits and underscores.
8. Select the directory where books will be generated, by pressing "..." button. After you create books, you may open this directory by chilcking on its highlighted path.
9. Click "Pack" to generate books

Please note: The BookReader midlet supports only text files. To read MS Word files you first have to convert them to text format by saving them with "Save As..." and selecting "Text format"

The program generates books: pairs of files of types JAD and JAR, their number depends on options and text sizes. Each book is a pair of JAR and JAD files.

JAR files are the very books - each includes text files and the BookReader midlet.
JAD files are short text files describing midlets. Generally each JAR file should have corresponding JAD describing its details. Some phones do not need JAD files althought, e.g. SE T6x0 and Motorola Accompli families.

Then as you have your books generated, install them on your mobile phone and enjoy reading.
To find more details on midlet installation refer to phone manual or internet forums - there is a lot of info on this subject. For some models which do not support direct Java midlet installation via cable, IRDA or BlueTooth, you still may install them over the air, uploading the generated books to some WAP site first.

====================================
ВАЖНО ! ЧАВО и ФАК (FAQ!)
====================================

Зачем нужно ограничивать размеры JAR файлов и отдельных глав?

Мобильные телефоны обладают ограниченным количеством памяти. Поэтому производители иногда накладывают ограничения на размер JAR файлов допустимых для установки на конкретной модели телефона.

Так же из-за ограниченности памяти аппаратов существуют определённые ограничения на размер одной главы текста. Если глава текста превышает допустимый для вашего аппарата размер, её нельзя будет открыть или прочитать полностью.

Для этого TCBR Shell даёт возможность ограничивать максимальный размер производимых им глав и JAR файлов. Если выбранные вами тексты не помещаются в JAR файл максимального размера,

Итак, если у вас следующие проблемы:

Проблема:
Произведённые JAR и JAD файлы не грузятся в телефон или не запускаются после установки (Возможные сообщения - "ошибка приложения", "файл слишком велик" или что угодно) -

Решение:
Слишком большой JAR файл. Поставьте ограничение на размер JAR файла.

Проблема:
JAR файл грузится, и приложение запускается, но книги не открываются. Или, книги открываются, но показываются не до конца (пропадает текст между концом этой и началом следующей)

Решение:
Главы текста слишком большие. Поставьте ограничение на размер главы текста.

Проблема:
Производится туча коротких глав со строчкой-двумя, или огромное число JAR файлов.

Решение:
Вы указали макс. размер в килобайтах (например 60) , а надо - в байтах (60000).

Рекомендуемые значения максимальных размеров JAR файла и глав текста:

Nokia S40 (большинство телефонов Nokia) - JAR max 64000, Глава max 60000

SonyEricsson T610 - Глава max 120000, JAR файл - вроде не особо чувствителен.

Motorola T720, 720i и т.д. - Глава макс. 150000, JAR файл - вроде не особо чувствителен.

Если вашего телефона в списке нет, а проблемы возникают, то возьмите значения для Nokia (max JAR или max размер главы в зависимости от ваших проблем), и подберите размер, пригодный для чтения. Буду благодарен, если вы пришлёте этот размер мне для включения в этот список.



This program is copyrighted by TequilaCat, see license.txt for details.

Includes other free software (as DLL):
* FreeImage library
* infozip' zip library
* ZipBuilder library built on infozip' zip library
Thanx to their authors, I will add license info soon.