EBookME - Guia de inicio rpido

EBookME - Gua de inicio rpido

Instalacin y uso de la aplicacin para generar libros electrnicos

versin 2.6.7

EbookME Gua de inicio rpido

Pgina 1

http://ebookme.sourceforge.net/

ndice de contenido

1 - Introduccin a EBookME...............................................................................................................31.1 - Licencia...................................................................................................................................31.2 - Historia....................................................................................................................................31.3 - Autores.....................................................................................................................................31.4 - Cmo apoyar a EBookME.......................................................................................................32 - Requisitos previos...........................................................................................................................42.1 - Java SE....................................................................................................................................42.2 - Dispositivo mvil con Java ME..............................................................................................43 - Instalacin.......................................................................................................................................43.1 - Paquete de instalacin para Windows.....................................................................................43.2 - Paquete ZIP.............................................................................................................................84 - Ejecucin.........................................................................................................................................84.1 - Men de inicio de Windows....................................................................................................84.2 - Sin men de inicio...................................................................................................................85 - Crear e-books usando el entorno grfico de EBookME..................................................................95.1 - Uso rpido...............................................................................................................................95.2 - Uso detallado.........................................................................................................................105.2.1 - Apartado "Libros"..........................................................................................................105.2.2 - Apartado "Detalles".......................................................................................................115.2.3 - Apartado "Ajustes de la aplicacin"...............................................................................115.2.4 - Opciones avanzadas.......................................................................................................125.2.5 - Apartado "Registro".......................................................................................................125.2.6 - Microemulador..............................................................................................................126 - Uso de EBookME desde la lnea de comandos (consola).............................................................136.1 - Ejecucin...............................................................................................................................136.2 - Argumentos............................................................................................................................146.2.1 - Opciones........................................................................................................................146.2.2 - Propiedades bsicas.......................................................................................................146.3 - Ejemplos................................................................................................................................157 - Solucin de problemas..................................................................................................................157.1 - Error "Fuera de memoria" (Out of memory).........................................................................158 - Apndice A: Tabla de las propiedades de la aplicacin.................................................................16

Documento traducido al espaol por Manuel Novoa. Documento creado en formato ODT usando OpenOffice.ORGversin 3.3.0 y exportada a PDF usando la misma aplicacin. Puede enviar sus sugerencias, comentarios y correcciones a mnovoar@gmail.com

Document translated into spanish by Manuel Novoa. Created in ODT format using OpenOffice.ORG version 3.3.0 and exported to PDF using the same app. You can address your suggestions, comments or ammendments to the email address provided above. Developers: If you want me to help with the localization of your GNU app, please feel free to contact at anytime. I will be more than glad to help!1 Introduccin a EbookME

EBookME es una aplicacin de cdigo abierto (open source) que crea libros electrnicos (e-books y e-bibliotecas) para dispositivos mviles. Se ha escrito en el lenguaje de programacin Java y puede ejecutarse desde la mayor parte de sistemas operativos actuales (MS Windows, Linux, Mac OS X, etc.). Se inicia con un entorno grfico sencillo o bien como programa de consola controlado por argumentos desde la lnea de comandos.

1.1 Licencia

EBookME ha sido editado bajo la licencia LGPL, lo que significa que es de libre uso personal, no lucrativo, acadmico, comercial y gubernamental. Existe informacin detallada en los ficheros de licencia.

1.2 Historia

Tom Darmovzal comenz el proyecto en el ao 2003. La primera versin fue de libre uso pero no de cdigo abierto.

Dos aos ms tarde Josef Cacek se hizo cargo del mismo, reescribindolo parcialmente. Aadi nuevas caractersticas y soporte de localizacin.

1.3 Autores

Tom Darmovzal inici el proyecto y lanz las primeras versiones. Ha llevado a cabo varios proyectos interesantes de cdigo abierto. Puede visitar su sitio web en http://darmovzal.nuabi.com:7180/

Josef Cacek es el administrador y programador principal del proyecto EBookME. Es miembro de la comunidad de desarrollo de OpenOffice.org y ha creado aplicaciones de cdigo abierto para aadir firmas digitales a los documentos PDF. Ms informacin en http://jsignpdf.sourceforge.net/

Ji Barto ayuda a la localizacin del software y corrige fallos en las aplicaciones.

Eduard Hatr ha implementado el conmutador del ajuste de lnea.

1.4 Cmo apoyar a EbookME

El proyecto EBookME tiene una necesidad constante de diversos tipos de apoyo por parte de la comunidad de usuarios. Si usted encuentra til EbookME, le animamos encarecidamente a encontrar una forma de contribuir.

Si ninguna de las sugerencias que siguen le acomoda, sintase libre de proponer una alternativa enviando un mensaje de correo electrnico a josef.cacek@gmail.com

Ayude a internacionalizar. Buscamos personas que aadan traducciones nuevas o mejoren las actuales. Las partes ms importantes a traducir son la aplicacin en s misma y esta gua.

Done su tiempo y habilidades. Naturalmente, los programadores que disfrutan escribiendo aplicaciones Java son siempre bienvenidos.

Hable a sus conocidos sobre el proyecto y sus beneficios.

2 Requisitos previos

Este captulo explica qu se necesita antes de comenzar a usar EBookME.

2.1 Java SE

Para ejecutar EBookME es preciso que el Entorno de Ejecucin de Java (JRE) versin 1.4 o superior se encuentre instalado en el ordenador. Si todava no lo tiene, puede descargarlo gratis desde el sitio web de Sun localizado en la siguiente direccin web:

http://java.sun.com/javase/downloads/index.jsp

El paquete de instalacin de EbookME para Windows ya incluye una versin actual deJava como paquete opcional.

2.2 Dispositivo mvil con Java ME

Para leer los libros electrnicos creados con EBookME en el dispositivo mvil, ste debe tener implementado Java ME (refirase a las caractersticas de su equipo o bien consulte en el punto de venta). La aplicacin emplea tan slo un conjunto muy bsico de las funcionalidades de Java ME (especificaciones: perfil MIDP-1.0, configuracin CLDC-1.0).

Nota del traductor: Virtualmente cualquier telfono mvil que soporte juegos Java tambin ejecutar EbookME sin problemas.

Translator Note: Virtually each and every mobile phone that support Java games will runEbookME without hassle.

3 Instalacin

Este captulo describe cmo instalar EBookME usando el paquete de instalacin paraWindows o el archivo ZIP.

3.1 Paquete de instalacin para Windows

Este paquete contiene una versin del programa lista para su uso, y tambin el Entorno de Ejecucin de Java como paquete opcional. Descargue el fichero EbookME_setup_2.6.7_wjre.exe y ejectelo:

Acepte el Acuerdo de Licencia:

Escoja la ruta de instalacin:

Seleccione los componentes que se debern instalar:

Componentes:

Program Files (Archivos del Programa) (obligatorio) Aplicacin base.

Import Filters (Filtros de Importacin) Filtros adicionales para el soporte directo de ficheros de documentos del tipo MS Office, Adobe PDF, Open Document Format y otros.

Microemulator (Microemulador) EBookME usa este emulador de cdigo abierto para probar las aplicaciones generadas (http://www.microemu.org/).

Java Runtime Environment Versin del Entorno de Ejecucin de Java actualizado a la fecha de edicin de la presente versin de EbookME.

Escoja un nombre para el grupo de programas en el men de inicio de Windows.

Verifique sus ajustes y permita que el programa se instale:

Si la instalacin finaliza correctamente, debera ver en su pantalla la siguiente ventana de dilogo:

3.2 Paquete ZIP

Si es un usuario avanzado o bien si el Sistema Operativo que usted emplea no es MS Windows, podr instalar EbookME a partir del archivo ZIP. Descargue EBookME_2.6.7.zip y descomprmalo en la carpeta o directorio que prefiera, o simplemente use una orden del tipo:

unzip EBookME_2.6.7.zip -d /mi/ruta/favorita

4 Ejecucin

4.1 Men de inicio de Windows

Si ha instalado EBookME desde el paquete de instalacin para Windows, habr un nuevo grupo en su men de inicio con las entradas correspondientes a EbookME. Por ejemplo:

Inicio Todos los programas EbookME EbookME 2.6.7

4.2 Sin men de inicio

Si por el contrario ha instalado EBookME a partir del paquete ZIP y usa Windows, haga doble clic sobre el fichero EbookME.exe para ejecutar la aplicacin.

Todas las plataformas (que tengan Java instalado) deberan permitir la ejecucin directa de la aplicacin EBookME.jar. Intente el siguiente comando desde el directorio donde haya descomprimido el paquete ZIP:

java -jar EBookME.jar

5 Crear e-books usando el entorno grfico de EBookME

5.1 Uso rpido

Rellene todos los campos del formulario y haga clic en el botn Crear Jar (Create Jar):

Compruebe el resultado en la ventana del Microemulador:

5.2 Uso detallado

A continuacin sigue una explicacin detallada de las diversas opciones, para aquellos a los que no les guste explorar el programa por s mismos.

5.2.1 Apartado Libros

Este apartado ofrece las funciones necesarias para administrar los contenidos de su biblioteca digital (aadir y eliminar libros, grabar y cargar proyectos):

El campo Lista de libros (Book list) a la izquierda muestra los libros que se encuentran actualmente en la biblioteca. Use el primer botn de la parte derecha para aadir (Add) nuevas entradas a esta lista.

Hay una manera ms simple de hacer esto usando el mtodo estndar de Arrastrar y soltar (Drag and Drop). Seleccione los documentos que desee a travs de su administrador de archivos favorito (Explorador de Windows, Konqueror, Gnome Commander, etc), arrstrelos con el puntero del ratn y sultelos sobre la ventana que contiene la lista. Sea paciente, pues la carga de ciertos tipos de fichero puede ser algo lenta, ya que han de convertirse.

Si por el contrario desea eliminar (Remove) cualquier libro de la biblioteca, seleccinelo en la lista y haga clic sobre el botn que presenta el icono de Eliminar:

Tambin puede cambiar el orden (Change Ordering) de los libros de la biblioteca usando los botones con los iconos de flechas . Seleccione el libro que desee mover arriba o abajo en la lista y haga clic sobre el botn correspondiente.

Si desea almacenar el proyecto (biblioteca) para seguir trabajando sobre l en otro momento, puede almacenar el proyecto (Store Project) o por el contrario cargar (Load) uno almacenado previamente, usando los botones con los iconos de Abrir o Cerrar, segn prefiera:

Los ficheros de proyecto de EBookME tienen la extensin .eme

5.2.2 Apartado Detalles

En esta zona se editan los detalles del libro que se haya seleccionado en la lista de libros. Los campos Nombre del libro (Book name) y Descripcin del libro (Book description)

se explican solos.

Por su parte, el contenido de Texto del Libro (Text of Book) se puede rellenar por medio del mtodo estndar copiar/pegar o bien cargando directamente el texto en cuestin usando el botn Abrir fichero (Open file):

Si realiza algn cambio en un libro se habilitar el botn Confirmar (Confirm) y deber hacer clic sobre el mismo para validar los cambios realizados:

5.2.3 Apartado Ajustes de la aplicacin

Ajustes de la aplicacin (Application Settings) contiene los ajustes a realizar sobre la aplicacin que se va a generar, la imagen de inicio y el botn principal del programa Crear JAR (Create JAR)

Para que este botn se habilite hay que rellenar correctamente el campo Fichero de salida (Output file). Escriba el nombre (o ruta completa) o use el botn Escoger fichero (Choose file) para que aparezca un dilogo donde podr escoger el nombre del fichero (o sobreescribirlo si ya existe).

Tambin puede cambiar la imagen de inicio (splash screen) si no le gusta la que aparece por defecto. Cree la imagen en cualquier editor, al tamao deseado, y luego use el segundo botn Escoger fichero (Choose file) para seleccionarla. Enseguida aparecer una vista previa de la misma.

Para volver a la imagen de inicio por defecto haga clic en el botn Atrs (Back): Cuando termine de editar su biblioteca, simplemente haga clic en Crear JAR (Create

JAR) y revise los mensajes que aparecern en la Seccin de Registro (Log Section). En ese momento ya debera haberse creado la aplicacin Java ME, y los ficheros JAR y JAD correspondientes estarn en la ruta que haya escogido (ms tarde deber instalarlos en su dispositivo mvil segn el mtodo que el fabricante del mismo haya previsto).

5.2.4 Opciones avanzadas

Esta seccin contiene ms ajustes de EbookME. Primero hay que habilitar las opciones avanzadas marcando la casilla de verificacin correspondiente. Todas ellas debern modificarse antes de aadir nuevos libros a la biblioteca.

Formato automtico (Autoformat) Si se habilita, normaliza todos los textos introducidos para que se muestren mejor en los dispositivos mviles, borrando espacios y cambios de lnea innecesarios (Esta til opcin est habilitada por defecto)

Tamao de las partes (Size of parts) Nmero de caracteres por cada parte del libro (el trmino parte se refiere aqu a un fichero de datos con texto existente en el interior del archivo JAR). En la memoria RAM de un dispositivo mvil siempre hay dos partes cargadas. Esta opcin hay que usarla con cuidado para que ms tarde no se presenten errores del tipo fuera de memoria en su aparato.

Texto de dcha. a izda. (Right to left text) Habilitando esta opcin los textos se mostrarn en su dispositivo de derecha a izquierda, en lugar de la forma usual de izquierda a derecha.

Codificacin (Encoding) Ajusta el juego de caracteres de entrada (solo para texto plano).

5.2.5 Apartado Registro

En esta seccin se muestran los mensajes que el programa genera durante su ejecucin. Compruebe ah si se ha producido algn error durante el proceso.

5.2.6 Microemulador

Si ha escogido instalar el paquete Microemulator, aparecer una ventana de vista previa cada vez que cree un nuevo e-book, que simular un telfono mvil con la aplicacin cargada.

Puede navegar a travs de ella haciendo clic sobre los botones de control (en el centro del terminal emulado) o haciendo clic sobre las teclas numricas del mismo, tal y como si se tratase de un telfono mvil real. De ese modo puede comprobar si la aplicacin generada funcionar razonablemente bien en el terminal donde tenga previsto ejecutarla, y tambin si el programa se ha generado correctamente.

6 Uso de EBookME desde la lnea de comandos (consola)

Este captulo describe cmo ejecutar EBookME desde la lnea de comandos.

6.1 Ejecucin

Windows:EBookME.exe [argumentos] o ebookme.bat [argumentos]

o, para versiones localizadas en otro idioma:ebookme.[idioma].bat [argumentos]

Desde Linux:ebookme.sh [argumentos]

Desde cualquier sistema con Java instalado:java -jar EBookME.jar [argumentos]

Si ejecuta la aplicacin sin argumentos aparecer el entorno grfico. Ejecute el programa con argumentos solo si desea trabajar desde consola (modo batch).

6.2 Argumentos

[fichero]Nombre del fichero de texto de entrada. Pueden especificarse varios, aunque las opciones para cada uno han de indicarse antes del nombre del fichero en cuestin.

6.2.1 Opciones

--helpMuestra en pantalla el texto de ayuda.

--versionMuestra en pantalla el nmero de versin de EbookME

-fCarga los parmetros iniciales desde el fichero de propiedades . La aplicacinintenta leer el fichero application.properties y cargar las propiedades desde l. Se pueden reescribir -cambiar- estas propiedades (o aadir unas nuevas) cargndolas desde un nuevo fichero.

-FLo mismo que la opcin -f pero pone a cero todas las propiedades antes de cargar lasnuevas desde el fichero especificado.

-DAade o reemplaza el valor de la propiedad indicada.

6.2.2 Propiedades bsicas

Para una lista ms completa consulte el Apndice A.

NameNombre del libro

descriptionDescripcin del libro.

charsetJuego de caracteres de codificacin para el fichero de entrada. Puede emplearse el valor'default' (por defecto) si se desea emplear el juego de caracteres por defecto del Sistema. [Valor por defecto: 'default']partTamao de la porcin de libro y del buffer de EbookME. [Valor por defecto: 5000]

outBase para los nombres de los ficheros de salida (los que produce la aplicacin). Por ejemplo, si se fija como valor de out='abc', los ficheros de salida sern abc.jar y abc.jad [Valor por defecto: 'ebook']

librarynameNombre de la aplicacin (MIDlet-1)[el valor por defecto es el valor de la propiedad out]

6.3 Ejemplos

% java -jar EBookME.jar libro.txtGenera el libro electrnico (ficheros libro.jar, libro.jad), usa la codificacin por defecto delSistema y el tamao de parte por defecto (5000)

% java -jar EBookME.jar -Dcharset=iso-8859-1 -Dout=biblioteca "- Dname=Harry Potter" hp.txt -Dname=Robocop robo.txtGenera los ficheros biblioteca.jar|jad, que contendrn dos libros, "Harry Potter" y"Robocop", ambos con codificacin iso-8859-1.

7 Solucin de problemas

7.1 Error Fuera de memoria (Out of memory)

Si aparece este error en la consola del programa, necesitar permitir que Java emplee ms memoria.. Aada el conmutador -Xmx a su consola de Java. El siguiente ejemplo permitir que Java emplee 512MB para el tamao de memoria dinmica:

java -Xmx512m -jar EBookME.jar

8 Apndice A: Tabla de las propiedades de la aplicacin

Nombres de las propiedades usadas en el empaquetador de EbookME

PropiedadDescripcinNombre de la clave en la claseConstantesComentarios (valores especiales, etc.)Valor por defecto

nameNombre del libroPROP_NAME

descriptionDescripcin del libroPROP_DESCRIPTION

charsetJuego de caracteres a usarPROP CHARSETValor default aplicar el juego por defecto del Sistemadefault

partTamao de la parte y del buffer deEBookMEPROP_PARTSIZE5000

debugModo de depuracinPROP_DEBUGSi valor = true (verdadero) se muestran los mensajes de depuracinFalse (falso)

outNombre base para los ficheros de salidaPROP_OUTebook

librarynameNombre del MidletPROP_LIBRARYNAMEValor de la propiedad out

autoformatTexto para el formato automticoPROP_AUTOFORMATTrue (verdadero)

splashimageRuta de la imagenPROP_SPLASHLa imagen HA de tener el tamao adecuado, EbookME no las adapta.

righttoleftTexto de derecha a izquierdaPROP_RIGHT_TO_LEFTTipo BooleanoFalse (falso)