EBookME - Guía de inicio rápidoInstalación y uso de la aplicación para generar libros electrónicos versión 2.6.7 Página 1 EbookME – Guía de inicio rápido http://ebookme.sourceforge.net/ Índice de contenido 1 - Introducción a EBookME...............................................................................................................3 1.1 Licencia................................................................................................................................. ..3 1.2 Historia.................................................................................................................................. ..3 1.3 Autores.................................................................................................................................. ...3 1.4 - Cómo apoyar a EBookME.......................................................................................................3 2 - Requisitos previos...........................................................................................................................4 2.1 - Java SE....................................................................................................................................4 2.2 - Dispositivo móvil con Java ME..............................................................................................4 3 Instalación............................................................................................................................. ..........4 3.1 - Paquete de instalación para Windows.....................................................................................4 3.2 - Paquete ZIP.............................................................................................................................8 4 Ejecución............................................................................................................................... ..........8 4.1 - Menú de inicio de Windows....................................................................................................8 4.2 - Sin menú de inicio...................................................................................................................8 5 Crear e-books usando el entorno gráfico de EBookME..................................................................9 5.1 - Uso rápido...............................................................................................................................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 aplicación"...............................................................................11 5.2.4 - Opciones avanzadas.......................................................................................................12 5.2.5 Apartado "Registro".......................................................................................................12 5.2.6 Microemulador..............................................................................................................12 6 - .................................................................................. 15 7 ............ please feel free to contact at anytime........... comments or ammendments to the email address provided above.......14 6.................1 ..... comentarios y correcciones a [email protected].. I will be more than glad to help! 1 Introducción a EbookME EBookME es una aplicación de código abierto (open source) que crea libros electrónicos (e-books y e-bibliotecas) para dispositivos móviles...........................15 7...Error "Fuera de memoria" (Out of memory). You can address your suggestions..3 Ejemplos..........Apéndice A: Tabla de las propiedades de la aplicación..........................com Document translated into spanish by Manuel Novoa...................0 and exported to PDF using the same app.....................................Propiedades básicas.....................Uso de EBookME desde la línea de comandos (consola).................................... Mac OS X.......................... 1.....0 y exportada a PDF usando la misma aplicación................................14 6............2............................................................ORG version 3..16 Página 2 EbookME – Guía de inicio rápido Documento traducido al español por Manuel Novoa.....................3................ Se inicia con un entorno gráfico sencillo o bien como programa de consola controlado por argumentos desde la línea de comandos.................................................................................................. Developers: If you want me to help with the localization of your GNU app........................14 6......................... etc..................1 Opciones.. Linux........................ Puede enviar sus sugerencias.......... Se ha escrito en el lenguaje de programación Java y puede ejecutarse desde la mayor parte de sistemas operativos actuales (MS Windows........)...................................2 ............... Created in ODT format using OpenOffice............3................... 13 6..............................Solución de problemas............................1 Licencia .....2 Argumentos...15 8 ..1 Ejecución.......................13 6.......... ..............ORG versión 3..... Documento creado en formato ODT usando OpenOffice........................... net/ Jiří Bartoš ayuda a la localización del software y corrige fallos en las aplicaciones.com:7180/ Josef Cacek es el administrador y programador principal del proyecto EBookME. Dos años más tarde Josef Cacek se hizo cargo del mismo.2 Historia Tomáš Darmovzal comenzó el proyecto en el año 2003. Más información en http://jsignpdf. 1. Naturalmente. académico. Existe información detallada en los ficheros de licencia. comercial y gubernamental. le animamos encarecidamente a encontrar una forma de contribuir.sourceforge. Ha llevado a cabo varios proyectos interesantes de código abierto. 1.org y ha creado aplicaciones de código abierto para añadir firmas digitales a los documentos PDF. . Añadió nuevas características y soporte de localización. siéntase libre de proponer una alternativa enviando un mensaje de correo electrónico a josef.EBookME ha sido editado bajo la licencia LGPL.nuabi. Es miembro de la comunidad de desarrollo de OpenOffice. los programadores que disfrutan escribiendo aplicaciones Java son siempre bienvenidos.com ● Ayude a internacionalizar.3 Autores Página 3 EbookME – Guía de inicio rápido Tomáš Darmovzal inició el proyecto y lanzó las primeras versiones. 2 Requisitos previos Este capítulo explica qué se necesita antes de comenzar a usar EBookME. Buscamos personas que añadan traducciones nuevas o mejoren las actuales. lo que significa que es de libre uso personal. La primera versión fue de libre uso pero no de código abierto. ● Hable a sus conocidos sobre el proyecto y sus beneficios. Las partes más importantes a traducir son la aplicación en sí misma y esta guía. Si usted encuentra útil EbookME. 1. reescribiéndolo parcialmente. Si ninguna de las sugerencias que siguen le acomoda. Eduard Határ ha implementado el conmutador del ajuste de línea.cacek@gmail. ● Done su tiempo y habilidades.4 Cómo apoyar a EbookME El proyecto EBookME tiene una necesidad constante de diversos tipos de apoyo por parte de la comunidad de usuarios. Puede visitar su sitio web en http://darmovzal. no lucrativo. 4 o superior se encuentre instalado en el ordenador. puede descargarlo gratis desde el sitio web de Sun localizado en la siguiente dirección web: http://java.1 Paquete de instalación para Windows Este paquete contiene una versión del programa lista para su uso.7_wjre. Si todavía no lo tiene. La aplicación emplea tan sólo un conjunto muy básico de las funcionalidades de Java ME (especificaciones: perfil MIDP-1.2 Dispositivo móvil con Java ME Para leer los libros electrónicos creados con EBookME en el dispositivo móvil. éste debe tener implementado Java ME (refiérase a las características de su equipo o bien consulte en el punto de venta).exe y ejecútelo: Página 5 EbookME – Guía de inicio rápido Acepte el Acuerdo de Licencia: Escoja la ruta de instalación: Seleccione los componentes que se deberán instalar: Página 6 EbookME – Guía de inicio rápido .0.0). 3 Instalación Este capítulo describe cómo instalar EBookME usando el paquete de instalación para Windows o el archivo ZIP. configuración CLDC-1. 3. Nota del traductor: Virtualmente cualquier teléfono móvil que soporte juegos Java también ejecutará EbookME sin problemas. Descargue el fichero EbookME_setup_2.jsp Página 4 EbookME – Guía de inicio rápido El paquete de instalación de EbookME para Windows ya incluye una versión actual de Java como paquete opcional.6. Translator Note: Virtually each and every mobile phone that support Java games will run EbookME without hassle. y también el Entorno de Ejecución de Java como paquete opcional.com/javase/downloads/index.sun.2.1 Java SE Para ejecutar EBookME es preciso que el Entorno de Ejecución de Java (JRE) versión 1. 2. habrá un nuevo grupo en su menú de inicio con las entradas correspondientes a EbookME. Adobe PDF. podrá instalar EbookME a partir del archivo ZIP.6.exe para ejecutar la aplicación. debería ver en su pantalla la siguiente ventana de diálogo: 3.6. Página 7 EbookME – Guía de inicio rápido Verifique sus ajustes y permita que el programa se instale: Si la instalación finaliza correctamente.1 Menú de inicio de Windows Si ha instalado EBookME desde el paquete de instalación para Windows. ● Microemulator (Microemulador) – EBookME usa este emulador de código abierto para probar las aplicaciones generadas (http://www.7.2 Sin menú de inicio Si por el contrario ha instalado EBookME a partir del paquete ZIP y usa Windows. Por ejemplo: Inicio → Todos los programas → EbookME → EbookME 2.7.org/). Open Document Format y otros.zip y descomprímalo en la carpeta o directorio que prefiera. .zip -d /mi/ruta/favorita Página 8 EbookME – Guía de inicio rápido 4 Ejecución 4.microemu.2 Paquete ZIP Si es un usuario avanzado o bien si el Sistema Operativo que usted emplea no es MS Windows. o simplemente use una orden del tipo: unzip EBookME_2. haga doble clic sobre el fichero EbookME.6. Escoja un nombre para el grupo de programas en el menú de inicio de Windows.7 4.Componentes: ● Program Files (Archivos del Programa) (obligatorio) – Aplicación base. ● Import Filters (Filtros de Importación)– Filtros adicionales para el soporte directo de ficheros de documentos del tipo MS Office. ● Java Runtime Environment – Versión del Entorno de Ejecución de Java actualizado a la fecha de edición de la presente versión de EbookME. Descargue EBookME_2. 5. arrástrelos con el puntero del ratón y suéltelos sobre la ventana que contiene la lista. Seleccione los documentos que desee a través de su administrador de archivos favorito (Explorador de Windows. Sea paciente.1 Uso rápido Rellene todos los campos del formulario y haga clic en el botón Crear Jar (Create Jar): Página 9 EbookME – Guía de inicio rápido Compruebe el resultado en la ventana del Microemulador: 5. etc). pues la carga de ciertos tipos de fichero puede ser algo lenta. Intente el siguiente comando desde el directorio donde haya descomprimido el paquete ZIP: java -jar EBookME. Use el primer botón de la parte derecha para añadir (Add) nuevas entradas a esta lista.2. Hay una manera más simple de hacer esto usando el método estándar de Arrastrar y soltar (Drag and Drop). ya que han de convertirse.jar. Si por el contrario desea eliminar (Remove) cualquier libro de la biblioteca. puede almacenar el proyecto (Store Project) o por el contrario cargar (Load) . Seleccione el libro que desee mover arriba o abajo en la lista y haga clic sobre el botón correspondiente. Gnome Commander.2 Uso detallado A continuación sigue una explicación detallada de las diversas opciones. Konqueror.jar 5 Crear e-books usando el entorno gráfico de EBookME 5.Todas las plataformas (que tengan Java instalado) deberían permitir la ejecución directa de la aplicación EBookME. para aquellos a los que no les guste explorar el programa por sí mismos. selecciónelo en la lista y haga clic sobre el botón que presenta el icono de Eliminar: También puede cambiar el orden (Change Ordering) de los libros de la biblioteca usando los botones con los iconos de flechas . grabar y cargar proyectos): El campo Lista de libros (Book list) a la izquierda muestra los libros que se encuentran actualmente en la biblioteca.1 Apartado “Libros” Página 10 EbookME – Guía de inicio rápido Este apartado ofrece las funciones necesarias para administrar los contenidos de su biblioteca digital (añadir y eliminar libros. Si desea almacenar el proyecto (biblioteca) para seguir trabajando sobre él en otro momento. la imagen de inicio y el botón principal del programa Crear JAR (Create JAR) Para que este botón se habilite hay que rellenar correctamente el campo Fichero de salida (Output file). y los ficheros JAR y JAD correspondientes estarán en la ruta que haya escogido (más tarde deberá instalarlos en su dispositivo móvil según el método que el fabricante del mismo haya previsto). Escriba el nombre (o ruta completa) o use el botón Escoger fichero (Choose file) para que aparezca un diálogo donde podrá escoger el nombre del fichero (o sobreescribirlo si ya existe). Los campos Nombre del libro (Book name) y Descripción del libro (Book description) Página 11 EbookME – Guía de inicio rápido se explican solos. según prefiera: Los ficheros de proyecto de EBookME tienen la extensión .2. También puede cambiar la imagen de inicio (splash screen) si no le gusta la que aparece por defecto. Enseguida aparecerá una vista previa de la misma. usando los botones con los iconos de Abrir o Cerrar. simplemente haga clic en Crear JAR (Create Página 12 EbookME – Guía de inicio rápido JAR) y revise los mensajes que aparecerán en la Sección de Registro (Log Section). En ese momento ya debería haberse creado la aplicación Java ME.2. Por su parte. al tamaño deseado.uno almacenado previamente. . el contenido de Texto del Libro (Text of Book) se puede rellenar por medio del método estándar “copiar/pegar” o bien cargando directamente el texto en cuestión usando el botón Abrir fichero (Open file): Si realiza algún cambio en un libro se habilitará el botón Confirmar (Confirm) y deberá hacer clic sobre el mismo para validar los cambios realizados: 5. y luego use el segundo botón Escoger fichero (Choose file) para seleccionarla. Cree la imagen en cualquier editor. Para volver a la imagen de inicio por defecto haga clic en el botón Atrás (Back): Cuando termine de editar su biblioteca.3 Apartado “Ajustes de la aplicación” Ajustes de la aplicación (Application Settings) contiene los ajustes a realizar sobre la aplicación que se va a generar.2 Apartado “Detalles” En esta zona se editan los detalles del libro que se haya seleccionado en la lista de libros.eme 5. borrando espacios y cambios de línea innecesarios (Esta útil opción está habilitada por defecto) Tamaño de las partes (Size of parts) – Número de caracteres por cada parte del libro (el término “parte” se refiere aquí a un fichero de datos con texto existente en el interior del archivo JAR). Compruebe ahí si se ha producido algún error durante el proceso.5.bat [argumentos] . De ese modo puede comprobar si la aplicación generada funcionará razonablemente bien en el terminal donde tenga previsto ejecutarla. Codificación (Encoding) – Ajusta el juego de caracteres de entrada (solo para texto plano).5 Apartado “Registro” En esta sección se muestran los mensajes que el programa genera durante su ejecución. 6. Todas ellas deberán modificarse antes de añadir nuevos libros a la biblioteca.2. Página 13 EbookME – Guía de inicio rápido 6 Uso de EBookME desde la línea de comandos (consola) Este capítulo describe cómo ejecutar EBookME desde la línea de comandos. 5. Esta opción hay que usarla con cuidado para que más tarde no se presenten errores del tipo “fuera de memoria” en su aparato. 5.exe [argumentos] o ebookme. que simulará un teléfono móvil con la aplicación cargada.1 Ejecución Windows: EBookME. normaliza todos los textos introducidos para que se muestren mejor en los dispositivos móviles.4 Opciones avanzadas Esta sección contiene más ajustes de EbookME. Texto de dcha. a izda. Formato automático (Autoformat) – Si se habilita. (Right to left text) – Habilitando esta opción los textos se mostrarán en su dispositivo de derecha a izquierda.2.2. y también si el programa se ha generado correctamente.6 Microemulador Si ha escogido instalar el paquete Microemulator. Primero hay que habilitar las opciones avanzadas marcando la casilla de verificación correspondiente. tal y como si se tratase de un teléfono móvil real. Puede navegar a través de ella haciendo clic sobre los botones de control (en el centro del terminal emulado) o haciendo clic sobre las teclas numéricas del mismo. aparecerá una ventana de vista previa cada vez que cree un nuevo e-book. En la memoria RAM de un dispositivo móvil siempre hay dos partes cargadas. en lugar de la forma usual de izquierda a derecha. jar [argumentos] Si ejecuta la aplicación sin argumentos aparecerá el entorno gráfico.[idioma].2 Argumentos [fichero] Nombre del fichero de texto de entrada.o.1 Opciones --help Muestra en pantalla el texto de ayuda.2. [Valor por defecto: 5000] . Pueden especificarse varios. Ejecute el programa con argumentos solo si desea trabajar desde consola (modo batch). para versiones localizadas en otro idioma: ebookme. 6.2. 6.estas propiedades (o añadir unas nuevas) cargándolas desde un nuevo fichero.bat [argumentos] Página 14 EbookME – Guía de inicio rápido Desde Linux: ebookme. --version Muestra en pantalla el número de versión de EbookME -f<fichero> Carga los parámetros iniciales desde el fichero de propiedades <fichero>. 6. -F<fichero> Lo mismo que la opción -f pero pone a cero todas las propiedades antes de cargar las nuevas desde el fichero especificado. Name Nombre del libro Página 15 EbookME – Guía de inicio rápido description Descripción del libro. [Valor por defecto: 'default'] part Tamaño de la porción de libro y del buffer de EbookME. aunque las opciones para cada uno han de indicarse antes del nombre del fichero en cuestión. -D<propiedad=valor> Añade o reemplaza el valor de la propiedad indicada. Se pueden reescribir -cambiar.properties y cargar las propiedades desde él. charset Juego de caracteres de codificación para el fichero de entrada. Puede emplearse el valor 'default' (por defecto) si se desea emplear el juego de caracteres por defecto del Sistema.sh [argumentos] Desde cualquier sistema con Java instalado: java -jar EBookME.2 Propiedades básicas Para una lista más completa consulte el Apéndice A. La aplicación intenta leer el fichero application. ) Valor por defecto name Nombre del libro PROP_NAME description Descripción del libro PROP_DESCRIPTION charset Juego de caracteres a usar PROP CHARSET Valor “default” aplicará el juego por defecto del Sistema .jar. que contendrán dos libros.txt -Dname=Robocop robo. Añada el conmutador -Xmx<tamaño> a su consola de Java. los ficheros de salida serán abc.jad). "Harry Potter" y "Robocop".jar Página 16 EbookME – Guía de inicio rápido 8 Apéndice A: Tabla de las propiedades de la aplicación Nombres de las propiedades usadas en el empaquetador de EbookME Propiedad Descripción Nombre de la clave en la clase “Constantes” Comentarios (valores especiales.jar libro.jad [Valor por defecto: 'ebook'] libraryname Nombre de la aplicación (MIDlet-1) [el valor por defecto es el valor de la propiedad “out”] 6.txt Genera los ficheros biblioteca.txt Genera el libro electrónico (ficheros libro.3 Ejemplos % java -jar EBookME. libro. ambos con codificación iso-8859-1. usa la codificación por defecto del Sistema y el tamaño de parte por defecto (5000) % java -jar EBookME. necesitará permitir que Java emplee más memoria.jar y abc.jar -Dcharset=iso-8859-1 -Dout=biblioteca "..Dname=Harry Potter" hp.1 Error “Fuera de memoria” (Out of memory) Si aparece este error en la consola del programa. 7 Solución de problemas 7. Por ejemplo.jar|jad. etc. El siguiente ejemplo permitirá que Java emplee 512MB para el tamaño de memoria dinámica: java -Xmx512m -jar EBookME.out Base para los nombres de los ficheros de salida (los que produce la aplicación). si se fija como valor de out='abc'. righttoleft Texto de derecha a izquierda PROP_RIGHT_TO_LEFT Tipo Booleano False (falso) Página 17 . EbookME no las adapta.default part Tamaño de la parte y del buffer de EBookME PROP_PARTSIZE 5000 debug Modo de depuración PROP_DEBUG Si valor = true (verdadero) se muestran los mensajes de depuración 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 automático PROP_AUTOFORMAT True (verdadero) splashimage Ruta de la imagen PROP_SPLASH La imagen HA de tener el tamaño adecuado.