gsLitGen

Utilidad para crear eBooks


Publicado el 03/Ago/2001
Actualizado el 23/Oct/2002

Pulsa para ver la versión del 23/Oct/02

commercial content distribution license

This certificate signifies that  Guillermo Som of Comunicaciones Sur on Friday, July 20, 2001 entered into a Commercial Use License Agreement, and therefore is entitled to create, publish and commercially distribute content created using the Microsoft® Reader Content SDK version 1.5 under the terms of that License Agreement.

 


Notas del 10/Ago/01:
Lee los nuevos comentarios sobre esta utilidad.
Así como las Recomendaciones "básicas" para crear eBooks


Aquí tienes esta utilidad, completamente funcional, para crear eBooks.

A diferencia de "otras" utilidades gratuitas, con esta puedes crear libros con las imágenes y los ficheros que quieras, sin ningún tipo de restricciones.

Con esta utilidad, se generan ficheros con extensión .OPF (OEB Package File) los cuales puedes usar con otras aplicaciones que "entiendan" cómo manejar los ficheros de ese tipo.

Para que gsLitGen pueda funcionar al 100%, se necesitan estos otros ficheros:
gsLITConvert.exe: utilidad de la línea de comandos para crear eBooks.
litgen.dll: Librería usada por gsLITConvert para crear los libros.
oeb1.ent: Fichero con definiciones de "entities" o lo que es lo mismo, un conversor de caracteres especiales, basados en Character entities for the Open eBook publication structure version 1.0.1

Espero tus comentarios sobre esta utilidad (al menos dime si la has probado... gracias)


Aquí tienes una captura de la aplicación en ejecución:


Pulsa este link para bajarte los ejecutables: gsLitGen.zip 325 KB (actualizado a la versión 1.0.2200)

Aquí solo está el ejecutable gsLitGen.exe: gsLitGenSE.zip 111 KB (actualizado a la versión 1.0.2200)

Las imágenes usadas por defecto: gsLitGenImagenes.zip 123 KB

Este otro es para el libro: Crear eBooks con gsLitGen (comprimido: 144 KB)

 

Estas son las versiones, fechas y tamaños de las utilidades:

gsLitGen.exe 1.0.2200 23/Oct/2002 376 KB
gsLITConvert.exe 1.0 (No la muestra) 22/Jul/2001 64 KB
litgen.dll 1.5.1.280 5/Oct/2000 352 KB
oeb1.ent N.A. 27/Jun/2001 28.7 KB
       

Nota:
El código usado para crear la utilidad gsLITconvert.exe, (que es la utilidad que realmente genera el libro), está basado en un ejemplo del Content Reader SDK 1.5 de Microsoft; así mismo la librería litgen.dll forma parte del mencionado SDK, y por si te interesa saberlo, tengo autorización, mediante el certificado mostrado a continuación, para usarla en la utilidad gsLitGen.


commercial content distribution license

This certificate signifies that  Guillermo Som of Comunicaciones Sur on Friday, July 20, 2001 entered into a Commercial Use License Agreement, and therefore is entitled to create, publish and commercially distribute content created using the Microsoft® Reader Content SDK version 1.5 under the terms of that License Agreement.


Nota del 10 de Agosto de 2001

Después de varias pruebas con distintos ficheros HTML, (por ahora sólo se pueden usar ficheros con la extensión HTM o HTML o al menos que sigan el mencionado formato), he observado que algunas veces no se crean los libros incluso con ficheros "correctamente" escritos en el formato HTML. Es un problema de la librería litgen.dll y de la utilidad que usa dicha librería, ya que mi utilidad, simplemente lo que hace es hacer unas pequeñas modificaciones a los ficheros para que sean compatibles con las especificaciones OEB, además de crear el fichero OPF que es el que "necesita" dicha librería para poder crear los eBooks.
Normalmente los editores HTML hacen las cosas bien, pero según he podido comprobar no siempre es así, por tanto habrá algunas modificaciones que tendrás que hacer manualmente si el susodicho editor HTML no es capaz de crear los ficheros en el formato correcto.
Por ejemplo, todos los TAGS deben tener un TAG de cierre, salvo pocas excepciones, la mayoría de ellos suelen tenerlos, tal es el caso del tag para crear un nuevo párrafo: <p> ... </p>. Ejemplo de un tag que no tiene el correspondiente cierre es el comando para cambio de línea: <br>, el cual se convierte en <br />, de esto se encarga mi utilidad, así como de "arreglar" también los <meta ..., los <hr ... y los <img ...
Pero las especificaciones OEB dicen que todos los TAGS deben estar correctamente "indentados", por ejemplo si se empieza con un párrafo nuevo y se indica un "link", se debe cerrar el link antes que el párrafo. Los navegadores "aceptan" que esto no sea así y no pasa nada, pero la utilidad de creación de eBooks es más "kiskillosa" y no se lo traga... mostrando un error y dejando la creación del libro para cuando el fichero tenga el formato correcto.

Lo que te decía, después de hacer varias pruebas, he hecho algunas modificaciones al programa, entre otras cosas, he añadido nuevas conversiones al los ficheros HTML, aunque, como te decía, habrá cosas que tendrás que modificar manualmente si el formato no es el correcto; lo más fácil sería abrir el fichero en cuestión en el editor HTML que uses y lo vuelvas a guardar, por regla general, (salvo que tenga alguna opción que le diga lo contrario), suelen "formatear" de forma correcta los TAGS, excepto los que no tienen tag de cierre, pero de eso se encarga mi utilidad, al menos para estos que te indico:

Una petición: Si te encuentras con otros TAGs que necesiten ser tenidos en cuenta, me lo dices en un mensaje con el siguiente asunto: "TAGs que necesitan ser reformateados", no te pongo un link, para que no lo uses para otras cosas que no sean la de "ayudarme" a mejorar gsLitGen... ¡que hay gente que aprovechan cualquier link para consultas y envío de mensajes "no deseados"!

También he añadido un par de cosillas nuevas y he arreglado otras, por ejemplo la de poder especificar ficheros que estén en distintos directorios, la versión anterior sólo "usaba" los que estaban en el directorio especificado en "Directorio de origen".
Se puede indicar que muestre los mensajes generados por la utilidad de creación de libros (eBooks) para que podamos ver los mensajes de errores que se generan al crear libros, así como los "warnings", de forma que te sea más fácil controlar lo que se hace.
Independientemente de que marques la opción de mostrar los mensajes generados por la utilidad de crear libros, se crea un fichero LOG en el que se añaden los mensajes generados por dicha utilidad, de forma que te sea fácil ver los errores y poder corregirlos, o si así lo prefieres, enviármelos para que te pueda decir cómo solucionarlos, (si es que está en mis "conocimientos" poder solucionarlos)
Otros de los cambios es que si no indicas imágenes para usar con el libro, se usan unas predeterminadas que para tal fin he hecho, dichos ficheros de imágenes deben estar en el directorio del ejecutable. Dichas imágenes las he incluido en un fichero zip cuyo link está junto con los demás links que permiten descargar las utilidades.
También existe una opción, la cual sólo se puede indicar modificando el fichero de configuración de la utilidad: gsLitGen.ini y es para indicarle que no borre el directorio temporal que crea y así puedas echarle un vistazo a las conversiones que se hacen a los ficheros. Para que no se borre dicho directorio, debe existir esta línea en dicho fichero: Borrar los temporales=0, el valor por defecto es 1 (que es lo mismo que si la línea no está especificada).

No se si se me olvida algo, pero de ser así, lo comentaré en otra ocasión.
Por ahora te dejo unas "recomendaciones", para que te resulte fácil poder crear los eBooks.

Recomendaciones para crear eBooks con gsLitGen:

  1. Los ficheros deben tener el formato HTML, no vale usar documentos de Word ni otros tipos de ficheros.
  2. Incluye las imágenes que uses en las páginas, si no, no se mostrarán.
  3. Las imágenes deberían ser en formato JPG, aunque también sirven GIF y BMP
  4. Prueba con pocos ficheros y ve añadiendo nuevos, si ves que todo funciona correctamente.
  5. Comprueba que no haya TAGS mal formateados y que estén debidamente "anidados", es decir sigue la secuencia de apertura y cierre de forma que si se usa un TAG de apertura, debe cerrarse antes de cerrar uno anterior.

Espero que funcione todo como debiera y que esta utilidad realmente sea útil... yo al menos estoy intentando que así sea... ¡espero poder conseguirlo!

Nos vemos.
Guillermo


la Luna del Guille o... el Guille que está en la Luna... tanto monta...