Por favor, lee esto si tienes alguna pregunta sobre el programa.

El propósito de este programa (TCBR Shell) es el de preparar libros para su lectura en teléfonos móviles, usando el midlet de TequilaCat "BookReader".

A continuación, se describirá la interfaz del programa. Puedes encontrar más detalles e información en el mismo Midlet o en la página del programa:
http://tequilacat.narod.ru/dev/br/
Te recomiendo que visites la página frecuentemente para actualizaciones del programa, con más funciones y más libre de fallos.

Características de la interfaz de "BookReader":
1. El libro preparado con esta interfaz puede ser dividido en capítulos, por cabeceras en los capítulos o por el tamaño máximo que se especifique.
2. Son soportadas diversas marcas de móviles: Nokia, Siemens, etc...
3. Mientras estás preparando un libro, puedes elegir una fuente para leerlo en tu móvil, entre todos los diferentes tamaños de fuentes que tengas instalado en tu sistema.
Por ahora, tan solo las fuentes fijas están soportadas, como Courier, en las próximas     versiones las fuentes proporcionales estarán disponibles también.
4. Puedes seleccionar el color del fondo y del primer plano para una lectura más cómoda.
5. Puedes establecer numerosas opciones de lecturas.
6. Si la interfaz incluye la localización del midlet, puedes optar por localizarlo, así como todos los comandos y menús en el teléfono. Las aplicaciones se mostraran en tu lenguaje nativo.

================================================
Como usar la Interfaz de "BookReader":
================================================
1. Presionar el botón "+" para añadir el archivo(s) a incluir en el libro.
2. Presionar "-" para eliminar textos de la lista.
3. Renombrar el texto usando el botón "Renombrar" para cambiar las etiquetas que se verán en el teléfono.
4. En la pestaña "Opción", seleccionar la versión para tu marca y modelo de teléfono.
5. Configurar las opciones deseadas para las restricciones de tamaño (ver más en las restricciones de tamaño, más abajo)
La opción "Extender pantalla al tamaño por" es tan solo aplicable a los teléfonos Motorotas y Samsung, para activar la visualización a pantalla completa, usando los bordes de la pantalla donde normalmente están los comandos.
6. En "Fuentes", seleccionar la fuente y el color. Seleccionar "Usar fuentes del móvil" para salvar espacio en el libro (1 ó 2 Kb de texto), si tu teléfono tiene restricciones en el tamaño (ver más abajo).
7. Introducir el nombre del libro en el botón de la ventana. Este nombre será el usado en tu  móvil, pero asegurarse de usar tan solo números latinos, dígitos y subrayados.
8. Seleccionar la carpeta donde el libro será creado presionando l botón "..." Después puedes acceder a esta carpeta presionando en el vínculo azul.
9. Clic en "Build!" para crear el libro.

Por favor: el Midlet "BookReader" soporta tan solo archivos de texto. Para leer archivos de MS Word debes de convertirlos antes en texto plano txt salvándolo con "Guardar como..." y seleccionando formato de texto plano .TXT

La generación de libros: Dos tipos de archivos son los creados, JAD y JAR, sus números dependen de las opciones seleccionas sobre el tamaño de archivos. Cada libro es una pareja de estos dos archivos.

El archivo JAR es el libro completo - Cada uno incluye los archivos de textos y el midlet del BookReader. De hecho los archivos JAR son archivos ZIP con una extensión .JAR, y pueden ser examinados como cualquier archivo de esta clase usando la compresión ZIP.
Los archivos JAD son pequeños archivos de texto que describen cada uno de los Midlets. Generalmente cada archivo JAR debería de tener su correspondiente JAD que describa sus detalles. No todos los teléfonos necesitan estos JAD, p.e. SE T6x0 y la familia Motorola.

Ahora tan pronto tengas el libro generado, instálalo en tu móvil y a leer.
Para encontrar más detalles sobre la instalación del Midlet mira el manual de tu terminal o incluso también en foros de internet, donde hay gran información sobre esto. Para algunos modelos (como Nokia 3410) que no tienen soporte directo para los Midlet Java mediante cable, IRDA o BlueTooth, deberás instalarlo al 'aire', subiendo a algún sitio WAP tu libro generado para descargarlo más tarde.

====================================
FAQ (¡Importante!)
====================================
¿Por qué  restringir el tamaño de los archivos jar y el texto de los capítulos?

Los teléfonos móviles son pequeños dispositivos con ciertas restricciones de capacidad. A menos de otras descripciones, el tamaño de la memoria de la mayoría de estos dispositivos es pequeña. Como resultado, el fabricante del teléfono móvil incorpora restricciones en el tamaño aceptado de las aplicaciones.

También la memoria es pequeña, con lo que afecta a como de grande podrá ser el archivo para abrirlo de golpe si el capítulo es demasiado grande. Si lo es el dispositivo fallará al abrirlo, sacando a pantalla un mensaje de error o simplemente obiando la parte excesiva del texto de forma silenciosa.

Para pasar estas restricciones, la interfaz TCBR permite separar por tamaño de capítulos y resultando el tamaño JAR deseado.

Si tienes los siguientes problemas:

Problema:
Los archivos JAD y JAR no pueden instalarse en el teléfono o no pueden ejecutarse después de haberlos instalados (error como "error de aplicación", "archivo demasiado grande" etc)

Solución 1:
El archivo generado JAR file es demasiado grande para tu móvil - Restringe el tamaño del archivo JAR en la pestaña de las opciones.

Solución 2:
Has escogido una versión de Midlet errónea - Para diferentes marcas de teléfonos o modelos se debe seleccionar el Midlet adecuado, dado que cada cual puede tener opciones diferentes en BookReader

Problema:
El archivo JAR se instala y ejecuta perfectamente, pero contiene libros q no pueden abrirse, o libros q se abren pero con partes del texto q desaparecen.

Solución:
La generación de capítulos son demasiados grandes para colocarlos en memoria. Restringe el tamaño de los capítulos en las opciones.

Problema:
Hay demasiados capítulos generados o demasiados archivos jar.

Solución:
A menos que sea porque es un libro enorme, debes introducir el tamaño específico en bytes, no KiloBytes (p.e 60, cuando en realidad el tamaño introducido debería de ser 60000).

Los tamaños recomendados para los teléfonos:

Nokia S40 (estos valores son aplicables para la mayoría de Nokia) - Máx tamaño del JAR 64000, y de tamaño del capítulo 60000

SonyEricsson T6x0 y Motorola T720 - El tamaño del jar no hace falta restringirlo (200-300 kilos), y el máximo para cada capítulo en unos 120000-150000.

Si tu teléfono no está listado arriba y experimentas problemas similares a los descritos, prueba con tamaños menores. El tamaño de los Nokia (max tamaño JAR o de los capítulos, dependiendo del problema) puede ser fallo de la compatibilidad.
Estaré encantado de que me mandéis los tamaños que vayáis probando y así tener la lista actualizada de modelos.


Este programa tiene copyrighted por TequilaCat, ver la licencia en license.txt para más detalles.

Incluye otros archivos como software libre (como DLL):
* Librerías FreeImage
* Librerías ZIP infozip
* Librerías ZIP ZipBuilder librerias para construir en infozip
Gracias a sus autores, añadiré las licencias pronto.
