EbookME Gua de inicio rpido

EBookME - Gua de inicio

rpido

Instalacin y uso de la aplicacin para generar libros electrnicos

versin
Pgina 1

EbookME Gua de inicio rpido

2.6.7

Pgina 2

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

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
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 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:

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)
plano).

5.2.5

Ajusta el juego de caracteres de entrada (solo para texto

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

--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

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

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 Comentarios (valores

Valor

Constantes

por

name

Nombre del libro

PROP_NAME

description

Descripcin del libro

PROP_DESCRIPTION

charset

Juego de caracteres a usar

PROP CHARSET

especiales, etc.)

defecto

Valor default aplicar el juego por

default

defecto del Sistema

part

Tamao de la parte y del buffer de

PROP_PARTSIZE

5000

EBookME
debug

Modo de depuracin

PROP_DEBUG

Si valor = true (verdadero) se

False (falso)

muestran los mensajes de

depuracin
out

Nombre base para los ficheros de

PROP_OUT

ebook

PROP_LIBRARYNAME

Valor de la

salida
libraryname

Nombre del Midlet

propiedad out
autoformat

Texto para el formato automtico

PROP_AUTOFORMAT

splashimage

Ruta de la imagen

PROP_SPLASH

True (verdadero)
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)