EBookME - Gua de inicio rpido

Instalacin y uso de la aplicacin para generar libros electrnicos

versin 2.6.7
Pgina 1
EbookME Gua de inicio rpido
http://ebookme.sourceforge.net/
ndice de contenido 1 - Introduccin a
EBookME...............................................................................................................3 1.1 Licencia.................................................................................................................................
..3 1.2 Historia..................................................................................................................................
..3 1.3 Autores..................................................................................................................................
...3 1.4 - Cmo apoyar a
EBookME.......................................................................................................3 2 - Requisitos
previos...........................................................................................................................4 2.1
- Java
SE....................................................................................................................................4
2.2 - Dispositivo mvil con Java
ME..............................................................................................4 3 Instalacin.............................................................................................................................
..........4 3.1 - Paquete de instalacin para
Windows.....................................................................................4 3.2 - Paquete
ZIP.............................................................................................................................8 4 Ejecucin...............................................................................................................................
..........8 4.1 - Men de inicio de
Windows....................................................................................................8 4.2 - Sin men
de inicio...................................................................................................................8 5 Crear e-books usando el entorno grfico de
EBookME..................................................................9 5.1 - Uso
rpido...............................................................................................................................9
5.2 - Uso
detallado.........................................................................................................................10
5.2.1 - Apartado
"Libros"..........................................................................................................10 5.2.2 Apartado "Detalles".......................................................................................................11
5.2.3 - Apartado "Ajustes de la
aplicacin"...............................................................................11 5.2.4 - Opciones
avanzadas.......................................................................................................12 5.2.5 Apartado "Registro".......................................................................................................12
5.2.6 Microemulador..............................................................................................................12 6 -

Uso de EBookME desde la lnea de comandos

(consola).............................................................13 6.1 Ejecucin...............................................................................................................................
13 6.2 Argumentos...........................................................................................................................
.14 6.2.1 Opciones........................................................................................................................14
6.2.2 - Propiedades
bsicas.......................................................................................................14 6.3 Ejemplos................................................................................................................................
15 7 - Solucin de
problemas..................................................................................................................15 7.1
- Error "Fuera de memoria" (Out of
memory).........................................................................15 8 - Apndice A: Tabla de las
propiedades de la aplicacin.................................................................16
Pgina 2
EbookME Gua de inicio rpido
Documento traducido al espaol por Manuel Novoa. Documento creado en formato ODT
usando OpenOffice.ORG
versin 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
Pgina 3
EbookME Gua de inicio rpido
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
Pgina 4
EbookME Gua de inicio rpido
El paquete de instalacin de EbookME para Windows ya incluye una versin actual de
Java 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 run
EbookME without hassle.
3 Instalacin
Este captulo describe cmo instalar EBookME usando el paquete de instalacin para
Windows 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:
Pgina 5
EbookME Gua de inicio rpido
Acepte el Acuerdo de Licencia:
Escoja la ruta de instalacin:
Seleccione los componentes que se debern instalar:
Pgina 6
EbookME Gua de inicio rpido

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.
Pgina 7
EbookME Gua de inicio rpido
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
Pgina 8
EbookME Gua de inicio rpido
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):
Pgina 9
EbookME Gua de inicio rpido
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
Pgina 10
EbookME Gua de inicio rpido
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)
Pgina 11
EbookME Gua de inicio rpido
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
Pgina 12
EbookME Gua de inicio rpido
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.
Pgina 13
EbookME Gua de inicio rpido
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]

Pgina 14
EbookME Gua de inicio rpido
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
--help Muestra en pantalla el texto de ayuda.
--version Muestra en pantalla el nmero de versin de EbookME
-f<fichero> Carga los parmetros iniciales desde el fichero de propiedades <fichero>. La
aplicacin intenta 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.
-F<fichero> Lo mismo que la opcin -f pero pone a cero todas las propiedades antes de
cargar las nuevas desde el fichero especificado.
-D<propiedad=valor> Aade o reemplaza el valor de la propiedad indicada.
6.2.2 Propiedades bsicas
Para una lista ms completa consulte el Apndice A.
Name Nombre del libro
Pgina 15
EbookME Gua de inicio rpido
description Descripcin del libro.
charset Juego 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'] part Tamao de la porcin de libro y del buffer de
EbookME. [Valor por defecto: 5000]

out Base 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']
libraryname Nombre de la aplicacin (MIDlet-1) [el valor por defecto es el valor de la
propiedad out]
6.3 Ejemplos
% java -jar EBookME.jar libro.txt Genera el libro electrnico (ficheros libro.jar, libro.jad),
usa la codificacin por defecto del Sistema 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.txt Genera 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<tamao> a su consola de Java. El siguiente
ejemplo permitir que Java emplee 512MB para el tamao de memoria dinmica:
java -Xmx512m -jar EBookME.jar
Pgina 16
EbookME Gua de inicio rpido
8 Apndice A: Tabla de las propiedades de la aplicacin
Nombres de las propiedades usadas en el empaquetador de EbookME
Propiedad Descripcin Nombre de la clave en la clase
Constantes
Comentarios (valores especiales,
etc.)
Valor por
defecto
name Nombre del libro PROP_NAME
description Descripcin del libro PROP_DESCRIPTION
charset Juego de caracteres a usar PROP CHARSET Valor default aplicar el juego por
defecto del Sistema

default
part Tamao de la parte y del buffer de
EBookME
PROP_PARTSIZE 5000
debug Modo de depuracin PROP_DEBUG Si valor = true (verdadero) se
muestran los mensajes de
depuracin
False (falso)
out Nombre base para los ficheros de
salida
PROP_OUT ebook
libraryname Nombre del Midlet PROP_LIBRARYNAME Valor de la
propiedad out
autoformat Texto para el formato automtico PROP_AUTOFORMAT True (verdadero)
splashimage Ruta de la imagen PROP_SPLASH La imagen HA de tener el tamao
adecuado, EbookME no las adapta.
righttoleft Texto de derecha a izquierda PROP_RIGHT_TO_LEFT Tipo Booleano False (falso)
Pgina 17