Documentos de Académico
Documentos de Profesional
Documentos de Cultura
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
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
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
2.2
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
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:
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.
3.2
Paquete ZIP
4
Ejecucin
4.1
4.2
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
Uso rpido
Rellene todos los campos del formulario y haga clic en el botn Crear Jar (Create Jar):
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
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
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
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
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
7 Solucin de problemas
7.1
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
Descripcin
Valor
Constantes
por
name
PROP_NAME
description
PROP_DESCRIPTION
charset
PROP CHARSET
especiales, etc.)
defecto
default
PROP_PARTSIZE
5000
EBookME
debug
Modo de depuracin
PROP_DEBUG
False (falso)
PROP_OUT
ebook
PROP_LIBRARYNAME
Valor de la
salida
libraryname
propiedad out
autoformat
PROP_AUTOFORMAT
splashimage
Ruta de la imagen
PROP_SPLASH
True (verdadero)
La imagen HA de tener el tamao
adecuado, EbookME no las adapta.
righttoleft
PROP_RIGHT_TO_LEFT
Tipo Booleano
False (falso)