Manual para la correcta maquetación de ePubs, escrito por y para los miembros de la comunidad del Proyecto Scriptorium.

Este primer tomo es una recopilación de tutoriales, normas y consejos que los miembros del foro han ido definiendo para una correcta elaboración de epubs según los estándares de calidad exigidos en el Proyecto Scriptorium. El objetivo es que cualquier candidato a editor, únicamente con la información aquí proporcionada, pueda de manera sencilla realizar su primera maquetación. De esta forma, al evitar la constante repetición de las mismas explicaciones y de los errores más frecuentes, se facilita la presentación de candidaturas y su revisión.

En los tomos siguientes de carácter más avanzado, se intentarán resolver las dudas que puedan surgir en nuestros editores ya consolidados, así como estandarizar códigos cuya compatibilidad haya sido ampliamente probada.

Si consideras que el Manual no abarca algún tema necesario, que en su redacción cierto punto no ha sido abordado con la suficiente claridad, que no es correcto o que tienes un método mejor de trabajo, por favor, ponte en contacto con la editora responsable: Fénix.

Proyecto Scriptorium

Aprende a maquetar I: Manual básico

Manual para maquetar libros electrónicos - 1

ePub r3.1

Fénix 10.11.2018

Título original: Aprende a maquetar: Manual básico

Proyecto Scriptorium, 2013

Edición revisada y actualizada, 2018

Diseño de cubierta: Erlodafer

Editora responsable: Fénix

ePub base r2.0

A todos los editores,

del pasado, presente y futuro.

FÉNIX

¿Cómo usar este manual?

Aunque este manual va dirigido principalmente a los candidatos a editor y a los editores noveles, se ha procurado recoger información útil para toda la comunidad de editores.

Leerlo de principio a fin posiblemente no sea una buena idea siendo más adecuado utilizarlo como manual de referencia, leyendo en cada ocasión solo las partes que se precisen.

Los candidatos a editor sí deberán leer este primer tomo entero, puesto que es el que realmente «enseña» a editar.

Para facilitar su uso se han elaborado dos métodos de organización complementarios:

Por un lado puedes utilizar una TOC (Table of Contents, Tabla de contenidos) realmente amplia que permite localizar casi cada detalle del manual.

Por otro, un Índice temático que recoge buena parte de los contenidos más interesantes que puedas necesitar o consultar.

Teniendo en cuenta que la mayoría de los usuarios de este manual comenzará a utilizarlo antes de adquirir muchos conocimientos sobre el arte de maquetar ePubs, se han estructurado los temas en dos partes diferenciadas: una básica, de conocimiento indispensable, que constituye este primer tomo y otra avanzada que es tratada en los tomos siguientes.

Es por ello sumamente recomendable dominar la parte básica antes de profundizar en la parte avanzada.

Por último, debe tenerse en cuenta que una parte de lo expuesto en este primer tomo hace referencia a las distintas herramientas que empleamos habitualmente para la maquetación. La información relativa a estas aplicaciones, que evolucionan a lo largo del tiempo, podrá ser actualizada en futuras ediciones de esta obra.

Algunas de las aplicaciones mencionadas en este manual son:

Sigil

FlightCrew

ePubCheck

css-validator (accesible desde el menú Herramientas de Sigil).

ePLValidator

SOBRE EL PROYECTO SCRIPTORIUM

El proyecto y su estándar de calidad

La comunidad del Proyecto Scriptorium nació a finales del año 2012 impulsada por un grupo de internautas que deseaban disponer de un medio para obtener y proporcionar libros correctamente maquetados y de forma totalmente altruista. Dicho deseo se hizo realidad el 23 de abril de 2013 con el lanzamiento de la web ePubLibre (EPL).

Durante siglos hemos prestado y regalado nuestros libros favoritos a nuestros allegados, pero con la aparición de Internet nuestros vínculos sociales se han extendido hasta límites antes insospechados. Desde el principio, a través de foros, webs, blogs y otros medios, las personas se han agrupado buscando intereses comunes, conocimientos o simplemente compañerismo. En nuestro caso, lo que nos une es el amor por los libros. El Proyecto Scriptorium surgió así por la necesidad y el deseo de compartir cultura.

A pesar de la gran cantidad de lugares en la red donde es factible obtener dichos libros, en ocasiones el formato no es el más adecuado, les falta texto o están llenos de errores de ortografía u OCR (Optical Character Recognition, Reconocimiento óptico de caracteres). Incluso los libros que se compran adolecen en ocasiones de algunos de estos errores, de precios abusivos en muchos casos (a menudo más caros incluso que el formato en papel) y de la imposibilidad de adquirirlos desde algunos países por circunstancias diversas. A todo esto hay que añadir aquellos libros descatalogados, olvidados por las editoriales o al desaparecer estas, y que ahora resultan casi imposibles de conseguir.

Por ello, desde nuestra comunidad se ha creado epublibre.org. Puedes considerarla una biblioteca, una web de descargas, una editorial, un club literario… porque es todo eso y mucho más. Representa nuestro deseo de compartir, comentar, recomendar (o no) nuestros libros y autores favoritos… Además, como buenos lectores, sabemos de la importancia que para los escritores representa vivir de su trabajo y por ello consideramos que, si a alguien le gusta realmente una obra, o la ha leído y disfrutado, debe adquirirla.

Nuestra biblioteca va creciendo lentamente, primando la calidad de los aportes a su número, y asegurándonos de la máxima compatibilidad con la mayoría de lectores electrónicos actuales. Las revisiones continuas nos permiten tener los libros casi sin errores ortotipográficos.

Eso es lo que diferencia a ePubLibre de otras muchas páginas de descarga de libros. En nuestra comunidad existen normas específicas y rigurosas para compartir libros; y estos libros deben estar necesariamente adaptados a una plantilla común que garantiza compatibilidad y limpieza. La aportación de los usuarios que informan de errores o erratas, unida a la labor de BibliotecariAs, Colaboradores, Editores, Revisores y Coordinadores consigue que los libros alcancen la gran calidad que nos caracteriza.

Antes de comenzar…

Aunque el proceso de maquetar no presenta una especial dificultad, sí requiere de ciertos conocimientos previos para poder llevarlo a cabo. El presente tomo cubre todo lo necesario para una correcta maquetación, así como las características especiales definidas específicamente para los libros de nuestra web.

Es frecuente que en una primera impresión el futuro maquetador se sienta abrumado ante la cantidad de nuevos conceptos presentados. Por ello se aconseja una lectura relajada, sin tratar de entender todo lo explicado, sino simplemente con el objetivo de captar la idea global.

Posteriormente, y ya con el objetivo de aprender a maquetar en mente, el primer paso es descargar e instalar todo el material necesario, que está disponible en el foro, para presentar la candidatura. De esta forma se puede proceder a la lectura del manual con el programa Sigil y el ePub Base abiertos, lo que facilitará una mejor comprensión de los conceptos aquí explicados.

En cualquier caso, si se tienen dudas, siempre se podrán consultar en el foro. Somos una comunidad muy activa y participativa, que valora mucho la colaboración en todos los ámbitos. Las respuestas a las consultas no son solo para el que pregunta, sino también para que todos los demás aprendamos de ellas y por lo tanto, recomendamos evitar el uso de los mensajes privados con este fin.

Cómo convertirte en editor

Si estás leyendo esto es probable que te estés planteando el convertirte en editor y compartir tus propios libros. Queremos recordarte que en nuestra web primamos la calidad sobre la cantidad y que, para ello, se ha establecido un proceso de revisiones que han de pasar todos los usuarios que quieran convertirse en editores. El objetivo de este proceso es garantizar que el candidato ha comprendido cómo funcionan las herramientas que debe utilizar, así como el estándar establecido para nuestra web, lo que garantiza la calidad, compatibilidad y homogeneidad que caracteriza a nuestros libros.

Aunque no es este un manual para ser leído de principio a fin, es más que recomendable que el aspirante a editor se familiarice con él antes de empezar con su candidatura.

Una vez hecho esto, seguirás este procedimiento:

Presentar la candidatura: deberás abrir un hilo en el subforo «Presenta tu candidatura» con la estructura siguiente: Nick - Título (Autor).

Ej: Titivillus - Cuento de Navidad (Dickens)

Esperar confirmación: alguno de los revisores comprobará que el libro no esté ya reservado y que además sea apto para la candidatura según nuestras normas internas.

Comenzar la maquetación: una vez que recibas la confirmación de que el libro es apto, se te proveerá de todo el material necesario para empezar tu candidatura.

Solicitar revisión: una vez que lo tengas preparado, que los validadores confirmen que no tiene errores y siempre siguiendo los pasos indicados en este mismo manual, se podrá comenzar el proceso de revisión. Tres revisores, uno a continuación de otro, incidirán sobre diferentes aspectos de la maquetación, revisarán tu trabajo, propondrán ejercicios que mejorarán tus destrezas y finalmente darán su visto bueno, si procede, a tu candidatura.

Una vez conseguidos los 3 OK ya serás editor y podrás subir aportes a la web. Puedes conseguir más información sobre este proceso en el foro. Es importante que la leas, pues hay ciertas restricciones a considerar a la hora de proponer un aporte para tu candidatura.

NOTA: Ten en cuenta que para presentar candidatura es preciso llevar al menos tres meses registrado en la web.

Si en un primer momento crees que maquetar pudiera ser demasiado difícil, pásate por el foro, te animaremos para que lo intentes, estaremos a tu lado para aconsejarte y comprobarás por ti mismo que no es tan complicado como parece. Y si al final no te interesa, siempre tienes muchas otras formas de colaborar si lo deseas. Puedes dirigirte a la sección de preguntas frecuentes en nuestra web para saber más.

¿Qué puedo maquetar y qué no?

Por norma general, en nuestro Proyecto se puede maquetar cualquier libro. Sin embargo existen algunas excepciones indicadas en la normativa interna que no permitirán que sean subidos determinado aportes a ePubLibre. Es importante tenerla presente en todo momento, ya que puede ser modificada con el tiempo.

Como editor no puedes maquetar

Libros cuya traducción no sea oficial, esto es, que no provengan de alguna editorial, a menos que superen el procedimiento de revisión y aprobación establecido.

Libros que tenga asignado otro editor en sus aportes «Futuros». Recuerda que puedes y debes consultar esta posibilidad en la web, dentro de Mi cuenta → Menú Editor → Comprobar títulos en la web.

Y, por supuesto, libros ya existentes en nuestro Proyecto, estén disponibles o en «Próximamente».

Nótese que sí se admiten varias ediciones de un mismo libro cuando hay diferencias significativas entre ellas, tales como versiones ilustradas o no, traducciones diferentes… En todo caso, si la comunidad considera que la diferencia entre ellos no es significativa, el último que se haya subido será retirado.

Como candidato no puedes maquetar

Libros que incumplan las limitaciones impuestas a los editores.

Libros que pertenezcan a alguna saga o colección ya existente —parcial o totalmente— en EPL.

Libros muy cortos o cuya maquetación sea excesivamente simple.

Libros en idiomas distintos del español.

Libros de poesía.

Y, por supuesto, libros ya existentes en nuestro Proyecto. Ten en cuenta que hay libros que pueden estar reservados de forma interna por algún editor pero que no aparecen en la búsqueda a los usuarios. Si fuera ese el caso cuando propongas tu libro, se podrá contactar con el editor para preguntarle si te cede la reserva.

Si cuando presentes tu candidatura en el foro que corresponde surgiera algún inconveniente con el aporte que hayas propuesto, no te preocupes, siempre tendrás la posibilidad de presentar sin problema otro libro u otros.

Todo lo que necesitas para maquetar en EPL

Producir un archivo ePub no es complicado, existen numerosos programas e incluso versiones online automáticas que permiten convertir de un formato a otro. Sin embargo, el resultado dependerá en la mayoría de los casos del tipo de archivo desde el que se parta, y probablemente, el resultado y compatibilidad entre dispositivos lectores esté muy alejado de los estándares de calidad que pretendemos alcanzar en los libros publicados por el Proyecto Scriptorium.

Así pues, para facilitar la tarea y poder controlar la calidad final del aporte, el editor de EPL dispone de varias herramientas cuyo empleo se explicará con mayor detalle a lo largo del presente tomo, y que se ampliará en el Tomo III: Herramientas útiles. Todas ellas están disponibles para su descarga en el foro, algunas incorporando manuales de uso detallados.

Veamos una breve descripción de cada una de ellas:

Editor de ePub: Sigil

Aunque cada editor puede elegir su programa favorito de maquetación, EPL recomienda la utilización de Sigil. No solo porque es software libre y multiplataforma sino que además se trata del editor de ePub más completo de los disponibles en la red, con una gran cantidad de herramientas para ayudar en las tareas de edición.

La posibilidad de añadir plugins personalizados creados por la comunidad de EPL facilita en gran medida esta tarea. Utilidades como las RegEx, por ejemplo, representan una ayuda inestimable para cualquier candidato o editor.

ePub Base

El uso del ePub Base, creado por los editores y desarrolladores de EPL, es un distintivo de nuestra comunidad. Gracias a él aseguramos la homogeneidad de los libros de nuestra web a la vez que respetando las normas que lo acompañan garantizamos que nuestros aportes puedan ser leídos en la mayoría de los eReader actuales, objetivo fundamental de nuestro estándar. No es de extrañar, por tanto, que sea de uso obligatorio.

Plantillas para portadas

Todas las portadas de nuestros libros tienen que incluir nuestro logo oficial (así como eliminarse todas las referencias a las editoriales). Para ello, están disponibles unas plantillas con el logo en la posición y tamaño estandarizados. Para el caso de las traducciones no oficiales autorizadas o propias de EPL existe un segundo logo cuya utilización será aprobada si procede.

RegEx

Las RegEx son un conjunto de búsquedas guardadas escritas en el lenguaje de Expresiones Regulares, que nos permiten localizar y solucionar una amplia gama de erratas de OCR y multitud de errores gramaticales y de formato. Si bien no se puede aseverar que un texto que supere las RegEx de EPL es un texto libre de errores, sí se puede afirmar que la corrección del mismo será más fácil, rápida y cómoda y que el nivel de calidad del futuro aporte será bastante elevado después de aplicarlas.

Validadores

En EPL se usan cuatro validadores distintos para comprobar el buen funcionamiento de los libros que se editan:

FlightCrew: Es el validador de Sigil. Al estar integrado en él, analiza el libro abierto en ese momento y nos facilita mucho la localización de errores, pues solo con hacer clic sobre el error nos lleva al punto del texto donde se localiza. En las versiones actuales se encuentra en Herramientas → Comprobar EPUB.

ePub Validator de IDPF: Se trata de una herramienta creada por el International Digital Publishing Forum y que detecta una gran cantidad de problemas que podrían hacer que el libro no se lea en los eReader. Como se trata de una herramienta online, no es necesaria la instalación de ningún software en nuestro ordenador. También existe una versión offline llamada ePub Checker, un ejecutable que no necesita instalación y que nos permite validar el libro sin necesidad de estar conectados a la red.

css-validator: Integrado en Sigil, puedes acceder a él en Herramientas → Validar Hojas de estilo con W3C.

ePLValidator: Es un programa propio creado específicamente para complementar esta tarea que además de reconocer fallos generales en el libro, controla su adecuación al ePub Base, detectando errores que no localiza ningún otro validador.

Su uso es fundamental para cerciorarnos de que nuestros aportes no incorporan errores graves de formato que les impidan ser leídos en los dispositivos actuales.

Ortografía

Controlar el correcto uso de la ortografía en nuestros aportes es algo realmente complicado (sobre todo porque en muchos casos son los propios autores quienes no lo hacen), por eso desde EPL se pone a disposición de los editores una amplia gama de ayudas:

La RAE: Es nuestro referente en asuntos de ortografía y gramática. Por eso vamos recopilando en el foro una completa lista de enlaces a temas concretos referentes a las dudas que se nos presentan más frecuentemente.

El diccionario c2c_epublibre: Con un total de 1.101.661 palabras, a las que puedes ir añadiendo más, y pensado para ser incluido en Sigil, es una ayuda imprescindible para localizar erratas en nuestros libros.

Corrector ortográfico de Sigil: Combinado con el diccionario c2c_epublibre nos da una lista de palabras que no pertenecen al diccionario, junto con el número de veces que aparece en el texto. Es especialmente útil para detectar palabras o nombres extranjeros que se han escrito de dos (o más) formas diferentes por error o por desconocimiento del idioma al que pertenecen.

Adobe Digital Editions/Count Pages

Debido a que cada lector contabiliza las páginas de forma diferente, en EPL se ha estandarizado el uso de estas dos herramientas para calcularlas de la forma más exacta posible.

Adobe Digital Editions: Solo disponible para Windows y Mac. Es importante destacar que la última versión de ADE no es muy respetuosa con la privacidad, y envía el catálogo de libros a los servidores de Adobe, incluso aunque los libros estén almacenados en otros lugares de tu disco duro. Por eso, se recomienda instalar la versión 1.7.2.1131, cuyo enlace está disponible en el foro.

Count Pages: Se trata de un complemento para Calibre que cuenta las páginas como ADE, para quien no quiera instalar Adobe Digital Editions o bien use GNU/Linux y no pueda hacerlo.

Esta lista de herramientas está en continua evolución por lo que resulta aconsejable estar atentos al foro para seguir su progreso y participar, si es posible, en su desarrollo y mejora.

Una vez que ya se posee todo lo necesario, se puede comenzar con la maquetación propiamente dicha.

CONCEPTOS GENERALES

¿Qué es un ePub?

EPUB o ePub (acrónimo de la expresión inglesa Electronic publication, Publicación electrónica) es un formato estándar y redimensionable de código abierto para documentos que puede contener textos e imágenes creado en 1997 por el International Digital Publishing Forum (IDPF). Al ser de libre uso es utilizado por la mayoría de los lectores de libros electrónicos.

El formato ePub tiene como principal ventaja la portabilidad, es decir, la independencia entre su contenido y el dispositivo que lo muestra. Esto le permite adaptarse a las diferentes medidas de pantalla e incluso variar el tipo y tamaño de sus fuentes de forma rápida y automática, ajustando lo mostrado según sea necesario. Es decir, el número de palabras contenidas en una línea es variable, y dependerá de las dimensiones de la pantalla sobre la que leemos, del tamaño y del tipo de letra escogido.

Este hecho provoca que un mismo código no se muestre de igual forma en todos los aparatos, por lo que cuando un editor se enfrenta a la necesidad de incluir códigos extraños o fuentes, debe presentarlos previamente en el foro de pruebas para que sean validados y así asegurar su compatibilidad y correcta visualización en el mayor número de dispositivos.

En nuestra comunidad se usa el programa Sigil para crear los ePubs, que son esencialmente contenedores de archivos XHTML (el mismo formato utilizado para generar páginas web), por lo que es necesario tener unas nociones básicas de HTML y CSS para poder trabajar en ellos. En este primer tomo se incluyen los conocimientos precisos para poder empezar.

Si nos fijamos en la estructura de un fichero ePub, observaremos que consiste en un archivo comprimido .zip (rebautizado con la extensión .epub) que contiene:

XHTML básico para el contenido del libro.

CSS para compaginarlo y darle forma (las llamadas hojas de estilos).

XML para crear el llamado document manifest, la tabla de contenidos y la metainformación del ePub (cuya función es describir el autor, el título del libro, etc).

Los tres ficheros XML que incluye están basados en tres estándares de código abierto (open source), en uno de los cuales se insertan los metadatos de la publicación respecto al estándar Dublin Core (DC). Estos tres archivos son:

OPS (Open Publication Structure): Describe la estructura del documento ePub en formato XML.

OPF (Open Packaging Format): Contiene las instrucciones de formato del contenido.

OCF (Open Container Format): Almacena todos los archivos que componen un ePub y los comprime en formato ZIP.

Para finalizar, una de las críticas que se han hecho a este formato es que, siendo muy útil para libros cuyo contenido es principalmente texto, no resulta adecuado para publicaciones que requieran de una presentación distinta o compleja, o la inclusión de audio y vídeo. El nuevo formato ePub3 ofrece mejoras que solventan estas limitaciones iniciales. En EPL exigimos subir primero los libros maquetados en formato ePub compatible con todos los dispositivos y una vez hecho esto, pueden usarse otros formatos existentes pero no obligatorios, como el epub3, azw3, mobi, fb2, pdf, cbr o cbz. Este punto se tratará con más detalle una vez terminado nuestro primer libro.

Lo que necesitas saber de Sigil

Introducción

Sigil es la herramienta que recomendamos para editar ePub, es un software libre WYSIWYG (What You See Is What You Get, Lo que ves es lo que obtienes) muy potente bajo licencia GNU, está en constante desarrollo y se puede descargar gratuitamente de la red. Muy intuitivo y visual, resiste cualquier comparación con programas de pago en el resultado final.

No es el único editor de ePub que se puede encontrar, ni siquiera de software libre (eCub, LibreOffice Writer, Baker eBook Framework…), así que la comunidad de EPL busca constantemente alternativas, aunque hasta el momento no ha encontrado un programa que supere a este en posibilidades.

Dado que su utilización no es obligatoria y cada cual puede optar por el que prefiera debe tenerse en consideración que si no maqueta con Sigil perderá bastantes utilidades casi imprescindibles para el editor, en especial el uso de las RegEx, que se tratarán en otro capítulo posterior.

Instalación y configuración de Sigil

Los desarrolladores de Sigil publican para cada nueva versión un conjunto de ejecutables preparados para ser instalados en los distintos sistemas operativos. Se pueden obtener de la página oficial.

Una vez descargado el instalador, solo hay que ejecutarlo y seguir unas instrucciones que no entrañan mayor dificultad.

Lo primero que debemos hacer tras la instalación es configurar la aplicación para que su uso sea el adecuado.

A la configuración de Sigil se accede pulsando la tecla F5 o escogiendo la opción Preferencias del menú Edición.

Hay tres puntos que debemos establecer adecuadamente:

El idioma: El idioma de la interfaz será el que por defecto se asignará a los metadatos de los libros creados con Sigil, pudiéndose cambiar este parámetro según queramos.

La limpieza de código: En las versiones anteriores a la 0.9, se podía activar las opciones limpiar al Abrir y al Guardar, usando el método Recolocar con Tidy, y se limpiaba automáticamente. Ahora, si se desea, hay que hacerlo de manera manual, con el menú Herramientas → Reformatear HTML → Corregir y arreglar todos los archivos HTML. Para facilitar la automatización de esta tarea se puede asignar una tecla de acceso rápido yendo al menú Complementos → Administrar complementos → Accesos rápidos del teclado.

Aunque esto permitirá a Sigil eliminar o modificar código incorrecto de forma automática, es muy recomendable escoger la opción «solucionar manualmente» cuando se nos pide permiso para arreglar algo, pues se trata de casos en los que Sigil no tiene claro como proceder y la solución automática puede hacer que perdamos contenido importante.

El diccionario de ortografía: Aunque Sigil incorpora un diccionario para la corrección ortográfica en distintos idiomas y el correspondiente al español es perfectamente válido para ello, nuestra comunidad ha desarrollado un diccionario especialmente pensado para usar en los libros que editamos. Para su instalación debemos adoptar los siguientes pasos:

Descargaremos el diccionario desde el enlace colocado al efecto en el foro (Material para la candidatura).

La descarga consiste en un archivo comprimido, que descomprimiremos para obtener los dos ficheros que contiene: c2c_1_epublibre.dic y c2c_1_epublibre.aff.

Localizamos la carpeta donde está instalado Sigil y abrimos hunspell_dictionaries que está en su interior.

Copiamos ambos archivos en la carpeta hunspell_dictionaries que acabamos de abrir.

Abrimos Sigil y nos vamos a Edición → Preferencias y escogemos la opción Diccionarios de ortografía.

En el desplegable superior que hay junto a la palabra «Diccionario», escogemos c2c_1_epublibre.

Por último pulsamos OK para terminar.

Esto último es válido para todas las modificaciones que hagamos en Preferencias: al pulsar OK se guardan los cambios y comienzan a tener efecto.

Vista general

Cada vez que abrimos el programa Sigil sin cargar previamente un epub podemos observar esta estructura:

En la parte superior tenemos la barra de menús, debajo dos líneas con barras de herramientas y el resto de la ventana está dividida en tres zonas: a la izquierda vemos el explorador de archivos, a la derecha el índice de contenidos y en el centro el archivo que tengamos abierto en ese momento.

Abrir – Guardar – Hacer copia

Como en la mayoría de los procedimientos en Sigil, estas tareas rutinarias las podemos realizar de distintas formas: Mediante la ejecución a través del menú, usando la barra de herramientas o empleando las teclas de acceso rápido.

Para abrir un ePub basta con dirigirnos al menú Fichero y escoger la opción Abrir (o también optar por el botón indicado en la barra de herramientas o pulsar Ctrl-O). Se nos abrirá un cuadro de diálogo típico y así navegar por nuestro sistema de archivos para buscar y abrir el que deseemos.

Para guardar un ePub modificado vamos al menú Fichero y escogemos la opción Guardar (o también cliquear directamente sobre el icono de guardar o Ctrl-S).

Al pulsar sobre Guardar se graban todos los cambios realizados en el ePub sin pedirnos más confirmación.

Obsérvese que Sigil nos ayuda avisándonos de si se ha modificado el libro que está abierto colocando un asterisco al final del nombre en la barra de título.

En ocasiones puede que queramos hacer una copia de nuestro ePub, por ejemplo cuando hayamos hecho cambios de los que no estemos muy seguros. Tenemos dos opciones en el menú Fichero: Guardar como… y Guardar una copia…

Ambas funcionan del mismo modo: Se nos abre un cuadro de diálogo donde seleccionamos la carpeta y el nombre con el que se guardará nuestro ePub. La única diferencia es que Guardar una copia nos añade automáticamente la palabra «copy» al final del nombre de nuestro ePub.

Vista de código – Vista de libro – Vista previa

Sigil nos permite visualizar nuestro ePub de distintas formas, cada una de ellas muy útil en el proceso de maquetar.

La vista de código es la que nos permite ver las etiquetas HTML escritas dentro de nuestro ePub, es la vista que más usaremos pues en ella tendremos el control de todo el código interno que da forma a nuestro libro.

La vista de libro nos permite ver el texto tal como aparecería en un eReader, es lo que se suele llamar wysiwyg (vista de impresión o lo que ves es lo que obtendrás), y es muy útil para tener una idea del resultado final de nuestro documento.

Para pasar de una vista a la otra tenemos un par de botones muy útiles en la barra de herramientas.

También podemos alternar entre una vista y la otra pulsando la tecla F2 o haciendo doble clic en la pestaña superior donde aparece el nombre del xhtml.

Por último tenemos la vista previa, a la que podemos acceder desde el menú Vista, con la opción Vista previa (o más rápido, con la tecla F10).

Normalmente nos aparece en pequeño en la parte de la derecha de la pantalla, bajo la lista de contenido, aunque podemos arrastrarla fuera pulsando en la barra de título (donde dice Vista previa).

Esta vista es muy parecida a la Vista de libro pero nos proporciona una utilidad adicional: Si hemos escrito mal alguna etiqueta o algún código, nos da un error inmediato.

Al ser instantánea la aparición del error nos resultará más fácil localizarlo y solucionarlo que si esperamos a activar la vista de libro o guardar el ePub.

Separar – Unir – Deshacer

Durante el proceso de maquetado en ocasiones realizamos cambios en nuestro libro que no deberíamos haber hecho. Con el botón Deshacer podemos revertir esa situación.

Para que funcione este botón hay que tener la Vista de código activada en la mayor parte de los casos.

Sin embargo debemos ser previsores porque su funcionamiento no es tan efectivo como en otros programas de edición.

Un error típico es pulsar el botón Dividir en el cursor en vez del botón Vista de código, pues están muy cerca uno del otro. Esa acción no puede revertirse y el botón Deshacer es inútil en este caso.

Cuando queremos separar un texto largo en dos archivos distintos, posicionamos el cursor en el punto adecuado y pulsamos el botón Dividir en el cursor. El resultado es que todo el texto que estuviera arriba del cursor se quedará en el archivo original, todo el texto que esté situado por debajo pasará a un nuevo archivo cuyo nombre será SectionXXX, con el siguiente número al último que se haya creado.

NOTA: Es importante colocar el cursor en un punto adecuado, pues el comportamiento de la división no siempre corresponde con lo deseado. Como recomendación, siempre lo haremos en la vista de código y situados en una línea en blanco, que no contenga texto ni código, asegurándonos así de que la división se hace correctamente.

Para deshacer una división hemos de usar la utilidad Unir archivos.

Seleccionamos el primer archivo a unir, luego hacemos clic en el siguiente mientras mantenemos pulsada la tecla control, se nos seleccionarán (en azul) ambos archivos, por último pulsamos en la zona azul con el botón derecho y elegimos la opción Unir en el menú que nos aparece (también podemos usar el método rápido: Ctrl-M).

Si hemos hecho la división de forma adecuada (siguiendo las recomendaciones descritas más arriba), la unión será correcta. Pero si la división la hicimos de forma accidental puede que la unión no sea acertada (por ejemplo, se nos puede dividir un párrafo en dos), por eso hemos de comprobar que se hizo como pretendíamos.

Guardar y añadir ficheros

En ocasiones nos interesa guardar los archivos que componen nuestro ePub de forma independiente. Para ello actuaremos como se ha descrito en el apartado anterior para la unión de ficheros: Hacemos clic en el primero, luego hacemos clic en el resto mientras mantenemos pulsada la tecla control, pulsamos con el botón derecho sobre la zona azul y, por último pulsamos en la opción Guardar como…

Nos aparecerá un cuadro de diálogo para que podamos elegir la carpeta donde guardar los ficheros seleccionados.

Para realizar la operación inversa (incorporar archivos existentes a nuestro ePub), pulsamos con el botón derecho del ratón sobre cualquier carpeta del explorador de ficheros de nuestro libro y escogemos la opción Añadir ficheros existentes…

En este caso podemos seleccionar ficheros de distinto tipo (xhtml, imágenes,…) en una misma operación y Sigil ya se encarga de colocarlos en la carpeta adecuada.

Renombrar ficheros

Si necesitamos cambiar el nombre a cualquiera de los ficheros que componen nuestro libro, podemos hacer clic con el botón derecho del ratón sobre su nombre y escoger la opción Renombrar.

Una vez cambiado, Sigil se encarga de renombrarlo automáticamente en todos los puntos de nuestro ePub donde se use.

En caso de querer renombrar un grupo de archivos debes seleccionarlos todos haciendo clic en el primero de ellos y, manteniendo pulsada la tecla MAYÚSCULAS hacer de nuevo clic sobre el último. Si el grupo a renombrar no es consecutivo entonces deberás hacer la selección de cada archivo manteniendo pulsada la tecla CONTROL (o CTRL). Ya solo queda hacer clic con el botón derecho del ratón sobre cualquiera de los archivos seleccionados y aparecerá la ventana Renombrar ficheros con un nombre sugerido. Una vez dado el nombre y pulsado Aceptar quedarán renombrados todos los archivos de manera secuencial.

Por ejemplo:

Si renombramos a Capitulo_05, los siguientes quedarán Capitulo_06, Capitulo_07…

Si renombramos a Cita, quedarán renombrados añadiendo un número al final de la cadena, Cita1, Cita2, Cita3…

Si alguno de los nombres asignados con este proceso coincide con algún otro archivo, Sigil muestra un aviso.

Si los archivos renombrados tienen extensiones diferentes, se conserva la extensión original a no ser que en el renombrado especifiquemos una concreta.

Insertar código

Sigil tiene una serie de botones para introducir los códigos usados más frecuentemente.

Se pueden usar de distinta forma: podemos pulsarlos y nos aparecerán las etiquetas de apertura y cierre, entre las cuales podemos escribir el texto que corresponda; o también seleccionar el texto al que queramos aplicar ese formato y luego pulsar el botón, las etiquetas se colocarán delante y detrás del texto elegido.

El botón de subrayado no debe usarse, ya que introduce código que está en desuso y no está definido en el ePub Base (<u> que debe ser <ins>).

Por supuesto, también es posible escribir directamente las etiquetas como un texto más y sin usar los botones. Si lo llevamos a cabo correctamente, el resultado será el mismo.

Hacerlo empleando los botones nos asegura que las etiquetas se abren y cierran correctamente. El editor novel debería usar esta opción.

Si optamos por su aplicación manual nos aseguramos de que las etiquetas se colocan en el sitio exacto donde queremos que estén, es la opción más usada por el editor veterano.

Insertar imágenes y caracteres especiales

Como en el caso de la inserción de código, podemos incorporar imágenes directamente escribiendo el código o podemos utilizar el botón Insertar fichero.

La forma más sencilla y segura es emplear la segunda opción. Para ello colocaremos el cursor en el punto adecuado en la Vista de código, pulsamos el botón Insertar fichero, elegimos la imagen adecuada en la lista (previamente hemos de añadirla siguiendo el proceso Añadir ficheros descrito en un apartado anterior) y pulsamos en OK.

Observa que a la derecha del cuadro de diálogo aparece una miniatura de la imagen seleccionada, lo que nos ayudará a elegirla correctamente.

También es frecuente que necesitemos incluir caracteres especiales, de los que no suelen estar presentes en los teclados de los ordenadores. Sigil nos permite hacerlo de una forma cómoda pulsando sobre el botón Insertar carácter especial, que nos abre un cuadro de herramientas donde aparecen los caracteres especiales más usados.

Con pulsar sobre el símbolo deseado se nos insertará en el punto en que esté situado el cursor.

Metadatos

Podemos editar los metadatos de nuestro libro con el botón Editor de metadatos.

Al pulsarlo se nos abre un cuadro de diálogo donde podemos modificar los metadatos contenidos en nuestro libro. Este proceso equivale a editar directamente el archivo content.opf.

NOTA: El editor novel debería usar el editor de metadatos para evitar desajustar el fichero content, pues si lo estropeamos puede que perdamos todo el contenido del ePub (aunque en ocasiones es inevitable).

El editor veterano puede modificar directamente el fichero content, para asegurarse de que el contenido del metadato es exactamente el que quiere.

TOC

En la columna de la derecha está el Índice de contenidos (TOC, del inglés Table Of Contents). El ePub debe tener una TOC en la que se enumeren, por este orden: Cubierta, Título del libro, Partes y Capítulos del libro, autor y notas, precisamente en este orden, si bien algunas de estas páginas son opcionales y no necesariamente deben aparecer.

Su generación debe ser automática, pulsando en el botón Generar índice de contenido (también puedes usar las teclas rápidas, Crtl-T, o ir al menú Herramientas → Índice de contenidos → Generar índice de contenidos), que nos abre un cuadro de diálogo donde podemos ocultar o modificar el rango de cada título.

Si no queremos que alguna etiqueta <hx> aparezca en la TOC, basta con desmarcarla (columna Incluír) y al generar se incorporará la expresión «sigil_not_in_toc», de la siguiente manera:

<h1 class="sigil_not_in_toc"/>

También se puede seleccionar el nivel de profundidad de los encabezados que se desea que aparezcan en la TOC.

Hay que tener en cuenta que pueden reaparecer, según la versión de Sigil, cada vez que generemos la TOC. Si queremos que aparezca de nuevo, solo tenemos que volver a generar la TOC, elegir la opción Mostrar solo los elementos del índice de contenidos y podremos activar el item correspondiente.

Para regenerar el archivo TOC.xhtml que está situado debajo del archivo info.xhtml lo haremos desde Herramientas → Índice de contenido → Crear índice de contenido HTML.

NOTA: Cada vez que hagamos cambios en nuestro libro, sobre todo si se han modificado los títulos, los archivos xhtml o los metadatos, es necesario regenerar la TOC antes de guardar el ePub, pues todos ellos le afectan y el no hacerlo provocaría incongruencias y errores.

Herramientas

Sigil nos proporciona varias herramientas muy útiles para la maquetación y corrección de los ePubs.

El uso de las mismas se describe en otros apartados de este Manual, aquí solo las nombraremos:

Informes: Nos presentan detalladas informaciones sobre diferentes aspectos internos de nuestro libro.

Búsquedas guardadas: Son las famosas RegEx que tan útiles nos resultan a los editores.

Validar ePub: Validar nuestro ePub con el validador FlightCrew.

Revisión ortográfica: Listado de las palabras que no están presentes en el diccionario.

Todas ellas se encuentran en el menú Herramientas y las dos últimas además disponen de botones en la barra de herramientas inferior.

Estas utilidades que nos proporciona Sigil, y otras varias, se comentan con detalle en el Tomo II: Herramientas útiles.

INTRODUCCIÓN AL LENGUAJE

Introducción al lenguaje HTML

HTML es un lenguaje que se utiliza fundamentalmente en el desarrollo de páginas web y también para crear ebooks en el formato ePub.

HTML son las siglas de HiperText Markup Language (Lenguaje de Marcación de Hipertexto) y es un lenguaje que se utiliza comúnmente para establecer la estructura y contenido de una página web o en nuestro caso, de los archivos de contenido en un epub.

El lenguaje HTML funciona por medio de «etiquetas» que describen la función del texto u objeto insertado entre ellas, entre la etiqueta de apertura (<x>) y la etiqueta de cierre (</x>).

Un capítulo de un libro en formato ePub, por ejemplo, al igual que sucede en una página web, tiene la siguiente estructura básica:

<html>

    <head>

        <title>CAPÍTULO 1</title>

        <!--llamada a las páginas de CSS-->

    </head>

    <body>

        <!--CONTENIDO EL CAPÍTULO-->

    </body>

</html>

Etiquetas de encabezado

<html>

Nos indica el punto de partida del código que creará la página o capítulo. El final se indica, como en todas las sentencias, con </html>

<head>

Nos indica el punto de partida de la cabecera del archivo, área que se utiliza para incluir códigos y textos no visibles que definen algunas características del contenido.

Dentro del elemento head, las etiquetas <link> son una manera de acceder o declarar contenido externo al archivo actual, que puede cumplir distintos objetivos, pero en un epub generalmente es una hoja de estilo que contiene las reglas CSS que el dispositivo o programa debe aplicar al presente archivo.

<title>

En las páginas web se utiliza para adjudicarle un título a la página que será visto en la barra superior de la página de internet. En los ebook se utiliza también como título que no se ve en los lectores, pero sí es usado, por ejemplo, en aparatos de lectura para discapacitados, como invidentes o sordos. No es obligatorio rellenarlo, pero sí se recomienda para cumplir con los requisitos de accesibilidad. Si no se quiere utilizar, hay que dejar igualmente las etiquetas <title> </title>

Etiqueta de seccionamiento básico

<body>

La etiqueta <body> nos indica el inicio del cuerpo del capítulo o sección donde se coloca el texto, imágenes y el contenido principal de este. Podemos compararlo con una página o folio en blanco, donde quedará plasmado el contenido.

Etiquetas de seccionamiento del contenido

Las etiquetas para seccionamiento del contenido le permiten organizar los contenidos del libro en partes lógicas.

<h1>, <h2>, <h3>, <h4>, <h5>, <h6>

Las etiquetas de seccionamiento corresponden a las que definen los encabezados: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>.

Los elementos de encabezado implementan seis niveles de encabezado del documento, <h1> es el más importante, y <h6>, el de menor importancia. Un elemento de encabezado describe brevemente el tema de la sección de texto que presenta. La información de los encabezados puede ser usada, por ejemplo, para construir una tabla de contenidos automáticamente.

Ejemplo:

<h1>Encabezado nivel 1</h1>

<h2>Encabezado nivel 2</h2>

<h3>Encabezado nivel 3</h3>

<h4>Encabezado nivel 4</h4>

<h5>Encabezado nivel 5</h5>

<h6>Encabezado nivel 6</h6>

Resultado:

Encabezado nivel 1

Encabezado nivel 2

Encabezado nivel 3

Encabezado nivel 4

Encabezado nivel 5

Encabezado nivel 6

No se deben usar niveles inferiores para reducir el tamaño de la fuente: Aplica la propiedad CSS font-size para eso (véase capítulo sobre CSS).

Evita omitir niveles de encabezado: siempre comienza con <h1>, después emplea <h2> y así sucesivamente.

Asegúrate de que TODOS los encabezados estén identificados. Podemos conseguir en el mercado ebooks donde los encabezados están marcados, por ejemplo, con negrita y una fuente mayor, pero sin usar una etiqueta <hx>. Utiliza la etiqueta <hx> que corresponda y el aspecto lo determinas con el CSS.

Etiquetas de contenido del texto

Utiliza los elementos HTML de contenido del texto para organizar bloques o secciones de contenido colocados entre la etiqueta de apertura <body> y su cierre.

<p>

El elemento p (párrafo) es el usado para distribuir el texto en párrafos. Sus etiquetas son: <p> y </p>

Ejemplo:

<p>Esto es un párrafo</p>

Los dispositivos de lectura y aplicaciones tratan automáticamente este texto como un bloque, insertando saltos de línea antes y después del mismo, y un espaciado o margen que puede ser modificado con CSS.

Estos son los valores CSS predeterminados en los lectores, que definen el aspecto general del texto.

p {

    display: block;

    margin-top: 1em;

    margin-bottom: 1em;

    margin-left: 0;

    margin-right: 0;

}

Para más información sobre el CSS, puedes consultar: Introducción al lenguaje CSS en este mismo tomo, y en el Tomo III: Código avanzado.

<div>

El elemento div de division (división). Sirve para crear secciones o agrupar contenidos.

Sus etiquetas son: <div> y </div> (ambas obligatorias).

<div class="centrado">

    <h2>Ejemplo de div y span</h2>

    <p>Esto es un párrafo dentro de un div,

        <span style="negrita">y esto un span dentro de un párrafo.</span>

    </p>

</div>

Valores CSS predeterminados:

div {

    display: block;

}

<blockquote>

El elemento <blockquote> (cita en bloque) se usa para marcar las citas a otros autores o documentos.

Sus etiquetas son: <blockquote> y </blockquote> (ambas obligatorias).

Puede y debe contener uno o más elementos en bloque, por ejemplo, párrafos definidos por <p>.

<blockquote>

    <p>Lorem ipsum dolor sit amet consectetur adipiscing elit interdum hendrerit auctor.</p>

</blockquote>

Que se visualizará de la siguiente manera:

Texto normal: Lorem ipsum dolor sit amet consectetur adipiscing elit interdum hendrerit auctor.

Texto en blockquote: Lorem ipsum dolor sit amet consectetur adipiscing elit interdum hendrerit auctor.

El <blockquote> tiene un hermano menor: <q> que sirve para citas en línea. A diferencia de <q>, <blockquote> no entrecomilla los contenidos.

La etiqueta <q> no está soportada por los dispositivos basados en ADE para el formato ePub2 (los que creamos por defecto), por lo que debemos evitar su uso en libros en ese formato. Solo la soporta en libros basados en ePub3.

Y sus valores CSS predeterminados en el ePub Base son:

blockquote {

    display: block;

    margin-top: 1em;

    margin-bottom: 1em;

    margin-left: 40px;

    margin-right: 40px;

}

<hr>

El elemento HTML <hr> refleja una variación de tema entre párrafos (por ejemplo, un cambio de escena en una historia). Por defecto, la etiqueta <hr> se presentaría como una línea. Aquí, sin embargo, la hemos definido en términos semánticos y no tanto en términos visuales, por lo que generará una separación de 2.5em. Para dibujar una línea horizontal deberemos usar el CSS apropiado. Mediante ajustes en el CSS, podemos mostrarlo además de como un espacio en blanco entre párrafos, también con alguna imagen como por ejemplo tres asteriscos.

Solo tiene una etiqueta: <hr/>.

Valores CSS predeterminados:

hr {

    display: block;

    margin-top: 0.5em;

    margin-bottom: 0.5em;

    margin-left: auto;

    margin-right: auto;

    border-style: inset;

    border-width: 1px;

}

NOTA: Este elemento solo debe usarse para indicar cambios de contexto o tema.

Otras etiquetas de interés relacionadas con el contenido

Además de las ya citadas, existen muchas otras que puedes consultar en el Tomo III: Código avanzado.

<ol>: Crea una lista ordenada.

<ul>: Crea una lista no ordenada.

<li>: Declara cada uno de los elementos de una lista. Va asociada a <ol> o <ul>

<dl>: Crea una lista de definiciones, con términos y descripciones.

<dt>: Contiene un término a definir dentro de una lista de definiciones. Va asociado a <dl>

<pre>: representa texto preformateado.

Etiquetas de texto en línea

Utiliza las etiquetas HTML de texto en línea para definir el significado, estructura, o el estilo de una palabra, una línea o cualquier pieza arbitraria de texto.

<span>

span (abarcar). Es un contenedor en línea. Sirve para aplicar estilo al texto o agrupar elementos en línea.

Sus etiquetas son: <span> y </span> (ambas obligatorias).

Puede contener: Texto, y/o Elementos en línea.

Por definición span no debe tener ningún estilo predefinido. Estos dos párrafos deben verse igual:

<p>Esto es un párrafo, el texto se ve igual.</p>

<p>Esto es un párrafo, <span>el texto se ve igual</span>.</p>

En los ebooks por lo general se usa para aplicar clases css al texto.

Ejemplo:

<span class="versalita">TEXTO</span>

<i>

La etiqueta <i> se utiliza para señalar una parte de texto que se quiere representar con una entonación de voz diferente, o bien para distinguirlo del texto normal. Una palabra o frase en idioma extranjero, un nombre científico, un término técnico, un pensamiento, o un nombre de barco o nave, etc.

Por defecto el texto marcado con esta etiqueta se presenta en cursiva o itálica.

Sus etiquetas son <i> y </i> (Ambas obligatorias)

Utiliza la etiqueta <i> solo cuando no haya un elemento semántico más apropiado, como por ejemplo:

<em> (texto enfatizado)

<strong> (texto importante)

<mark> (texto marcado o resaltado)

<cite> (título de una obra)

<dfn> (un término de definición)

Estas etiquetas se han definido y explicado detenidamente en el Tomo III: Código avanzado, y se recomienda su uso para cumplir de manera estricta con el estándar ePub y las normas de accesibilidad y html semántico.

NOTA: Para un uso correcto de estas etiquetas resulta indispensable leer y revisar el texto, determinando en cada situación cual es la etiqueta apropiada. En caso de no poder realizar esta revisión exhaustiva, se puede usar simplemente <i> para el texto en cursivas, y <b> para las negritas.

Valores CSS predeterminados de la etiqueta <i>:

i {

    font-style: italic;

}

<b>

b de bold (negrita). Representa una sección de texto al que se le presta atención con fines utilitarios, pero sin indicar ninguna importancia adicional y sin la implicación de una voz o modalidad alternativa, como palabras clave en un documento, nombres de productos en una revisión, etc.

Sus etiquetas son <b> y </b> (Ambas obligatorias).

Por defecto el texto marcado con esta etiqueta se presenta en negrita.

Valores CSS predeterminados:

b {

    font-weight: bold;

}

<small>

El elemento HTML <small> define un fragmento de texto que se debe mostrar, por razones tipográficas, más pequeño que el tramo principal del texto.

Sus etiquetas son <small> y </ small> (Ambas obligatorias).

Ejemplo:

<p><small>Copyright 1999-2050 por Random House</small></p>

Se visualiza así:

Copyright 1999-2050 por Random House

Valores CSS predeterminados:

small {

    font-size: smaller;

}

<a>

La etiqueta <a> define un hipervínculo, que se usa para conectar texto de una parte del libro con otra (como notas al pie de página), o a un vínculo externo, como una página web. Puedes encontrar más información al respecto en el Tomo III: Código avanzado.

El atributo más importante de la etiqueta <a> es href, que indica el destino del enlace.

Las notas son un caso especial de estos enlaces internos, que tienen la particularidad de que están diseñadas para un viaje de ida y vuelta.

Capitulo08.xhtml

<p>En este texto hay una nota<a href="../Text/notas.xhtml#nt1" id="rf1"><sup>[1]</sup></a>.</p>

notas.xhtml

<p id="nt1" ><sup>[1]</sup> Nota explicativa. <a href="../Text/Capitulo08.xhtml#rf1">&lt;&lt;</a></p>

En este texto hay una nota[1].

[1] Nota explicativa. <<

El uso y colocación de las notas se explicará con más detalle en el apartado Maquetando el contenido.

Otras etiquetas de interés referidas al texto en línea

Como ya se ha indicado, en el Tomo III: Código avanzado se explicará con mayor detalle las siguientes etiquetas, para un adecuado uso semántico:

<em>: Texto enfatizado.

<strong>: Texto importante.

<cite>: Título de una obra.

<dfn>: Término de definición.

Además, también se explicará:

<sub>: Subíndice.

<sup>: Superíndice.

<br>: Produce un salto de línea.

<s>: Marca texto que ya no es correcto, preciso o relevante.

<del> e <ins>: <del> se usa para marcar una sección de texto que ha sido borrado, e <ins> para marcar la sección de texto nueva.

<abbr>: Marca un texto como una abreviatura o acrónimo.

<code>, <kbd>, <samp>, <var>: Propias de un manual de informática, definen los textos de computación del mismo.

Si estás interesado en hacer algo concreto y no conoces la etiqueta que lo hace, o bien has visto una etiqueta que no sabes para qué sirve, puedes preguntar en el foro o consultar páginas como las siguientes (en inglés), o similares:

www.quackit.com

www.w3schools.com

Ante cualquier código dudoso o nuevo, debe pasarse la prueba de código en los todos los lectores del banco de pruebas del foro.

Introducción al lenguaje CSS

El lenguaje CSS nos sirve para asignar propiedades a las etiquetas HTML, lo que nos permite separar «contenido» de «continente» en un documento concreto (por ejemplo, en una página web). De esta forma podemos darle estructura y diseño de una manera sencilla.

Definir un estilo en CSS

Un estilo CSS consta de dos partes principales: un selector y una o más declaraciones.

body { margin:1em; }

Donde body corresponde al selector (etiqueta html) y «margin:1em» es una declaración.

Una declaración CSS siempre termina con un punto y coma. Las clases están rodeadas por llaves. Para hacer que el CSS sea más legible se puede optar por poner las declaraciones de cada clase en diferentes líneas, si bien ambas formas son perfectamente válidas.

p { margin:0; text-align:justify; text-indent:1.5em; line-height:1.3em; }

p {

margin:0;

text-align:justify;

text-indent:1.5em;

line-height:1.3em; }

Para poder explicar la función de las clases o algún otro punto que se considere necesario, se utilizan los comentarios. La sintaxis de los comentarios CSS es muy diferente a la de los comentarios HTML, por lo que no deben confundirse:

style.css

/* esta línea es opcional */

Section0001.xhtml

<!--esta línea es opcional-->

Los delimitadores son, como se ve en el ejemplo: /* COMENTARIO */.

Cuando hagamos nuestras clases personalizadas es siempre conveniente comentarlas, siendo aconsejable, a veces, anotar como debe ser llamada en el archivo .xhtml. De esta forma, sabremos en el futuro para qué creamos exactamente una clase concreta, facilitando su modificación.

Cómo llamar un estilo desde HTML

Hay tres formas de insertar estilos en HTML:

Estilo en línea. Cuando las declaraciones se expresan directamente con la sentencia style dentro del cuerpo de un archivo .xhtml (en este caso las declaraciones no van encerradas entre comillas y tampoco entre llaves):

<p style="color:sienna; margin-left:20em">Párrafo de color siena</p>

NO debe utilizarse en el ebook

Hoja de estilos interna. Se define en la sección head de un archivo .xhtml mediante la etiqueta <style>. Aparecerá así:

<head>

<style>

hr {color:sienna;}

p {margin-left:20px;}

body {background-image:url("images/back40.gif");}

</style>

</head>

NO debe utilizarse en el ebook

Hojas de estilos externas. Todos los estilos van agrupados en archivos externos a los archivos de texto, con extensión .css (en el ePub Base de nuestra comunidad se denominan epl.css, sgc-toc.css y style.css).

epl.css: Se enlaza en todas las páginas .xhtml de nuestros ePub. NO se debe modificar.

style.css: Es nuestra página de estilos personalizada. En ella definiremos nuestras etiquetas y estilos personales y se enlazará en los .xhtml del cuerpo del ePub, siempre en segundo lugar, después de enlazar epl.css. Se pueden crear varias hojas de estilos personales con diferentes nombres y la extensión .css, y enlazar solamente la que necesitemos en cada .xhtml.

sgc-toc.css: Se enlaza con la página indice.xhtml. No es una página obligatoria, de modo que si no queremos crear indice.xhtml (se explicará cómo se hace en el capítulo MAQUETANDO EL CONTENIDO), deberemos eliminar esta página y también la indice.xhtml.

Cada .xhtml debe enlazar a la hoja de estilos obligatoria, epl.css, y a la hoja de estilos personalizada, style.css o como hayas llamado a tu hoja de estilos, con la etiqueta <link>, dentro de la sección de la cabecera (<head>).

<head>

<title></title>

<link href="../Styles/style.css" rel="stylesheet" type="text/css" />

</head>

NOTA: Es la forma correcta de utilizar los estilos en los eBook.

ePub Base: epl.css, style.css y sgc-toc.css

En la plantilla de ePubLibre, el archivo ePub Base, se incluyen las tres hojas de estilos externas que hemos descrito en el apartado anterior, llamadas epl.css, sgc-toc.css y style.css, que se ubican dentro de la carpeta Styles. La hoja de estilos style.css contiene una serie de estilos predefinidos para agilizar nuestra tarea, que han sido probados en diversos lectores electrónicos para asegurar su compatibilidad y adecuada visualización.

Estructura

La página epl.css, que es la que se enlaza con las páginas fijas, NO SE DEBE MODIFICAR.

La página sgc-toc.css, que se enlaza con el índice, se eliminará si no se utiliza.

Veamos con más detalle la página style.css:

La primera etiqueta <p> está definida de dos maneras diferentes. Primero, en la descripción del párrafo por defecto u ordinario:

p {

    margin: 0;

    text-align: justify;

    text-indent: 1.5em;

}

Sin margen alrededor, texto justificado e indentado de 1.5em. Donde em es la medida de la letra eme y, por lo tanto, es una unidad de medida escalable, que aumentará o disminuirá al modificar el tamaño de la fuente en el lector electrónico. Este modelo de párrafo es el más usado tanto en libros como en novelas.

Y segunda, cuando está incluida dentro de un comentario (se nota porque está en verde), y que habrá que habilitar si se quiere utilizar o si se pretende crear una definición nueva de párrafo, personalizada, que se adapte al libro que se está maquetando. La definición de párrafo alemán o moderno se podrá emplear si eliminamos las características de la anterior:

p {

    margin: 1em 0;

    text-align: justify;

    text-indent: 0;

}

Con margen arriba y abajo y ninguno a la derecha e izquierda, alineación del texto justificada y sin indentado. Se usa generalmente en manuales, obras técnicas, etc.

Aunque estos dos son los estilos de párrafo más comunes en los libros, el editor puede ajustarlos o crear otros nuevos según su necesidad, cambiando los márgenes o el tamaño por defecto de la fuente. Son apropiados, por ejemplo, para libros infantiles .

Encabezados:

h1 {

    font-size: 1.5em;

    margin: 20% 0 2em;

}

h2, h3, h4, h5, h6 {

    margin: 2em 0 1em;

}

h2 { font-size: 1.4em; }

h3 { font-size: 1.3em; }

h4 { font-size: 1.2em; }

h5 { font-size: 1.1em; }

h6 { font-size: 1em; }

Se definen los tamaños de la fuente y los márgenes de los diferentes encabezados.

Se pueden modificar del modo más apropiado, variando márgenes, tamaños, añadiendo fuentes, etc. Todo lo que no se utilice se tiene que eliminar.

Dedicatoria:

.dedicatoria {

    margin: 25% 3% 0 15%;

    text-align: right;

}

.dedicatoria p {

    text-align: right;

    text-indent: 0;

}

Define los márgenes en %, que también es una medida escalable y la alineación del texto a la derecha.

Es una manera de definir la forma de poner las dedicatorias, pero se puede modificar personalizándola.

Observa que en la definición, hay un punto antes del nombre del estilo. Eso es lo que diferencia la definición de un selector de elemento html (etiqueta) que no lleva punto y un selector de estilo o clase, que se define situando el punto delante. Las etiquetas se pueden aplicar solas en los .xhtml, pero los estilos tienen de aplicarse dentro de una etiqueta, como se explicará a continuación.

Saltos:

.sintop { margin-top: 0; }

.saltoinicio { margin-top: 25%; }

.salto05 { padding-top: 0.5em; }

.salto10 { padding-top: 1em; }

.salto25 { padding-top: 2.5em; }

hr {

    height: 2.5em;

}

El estilo "sintop" elimina el margen superior. Los demás "saltoXX" aplican un margen o padding superior, del valor que indica la definición, al texto que haya en la etiqueta donde se aplica.

Recuerda que la etiqueta <hr>, cuando va sola, proporciona un salto de dos líneas para los cambios de escena.

hr.linea {

    width: 25%;

    margin: 1em 37.5%;

    height: 0;

    border: none;

    border-top: 0.125em solid grey;

}

hr.imagen {

    width: auto;

    border: none;

    margin: 1em 0;

    height: 1em;

    text-indent: 0;

    text-align: center;

    background: url("../Images/asterisco3.png") no-repeat center;

    background-size: 3em 1em;

    overflow: hidden;

}

La primera definición indica que si lo aplicamos en el .xhtml

<hr class="linea"/>

se insertará una línea gris (que se puede modificar a conveniencia).

La última barra / es la barra de cierre de la etiqueta, lo que significa que la abrimos y cerramos a la vez.

La segunda definición es para insertar una imagen de separación. En este caso utilizamos la imagen asteriscos.png, que viene también en el ePub Base, aunque podemos utilizar otra cualquiera.

En el .xhtml ponemos:

<hr class="imagen"/>

Para imágenes simples y centradas tenemos la clase "ilustra".

.ilustra {

    margin: 1em 0;

    text-align: center;

    text-indent: 0;

    display: block;

}

Para controlar el silabeo, es decir, evitar que el lector electrónico divida una palabra con guiones, se aplica a cualquier estilo en el que lo necesitemos:

.dedicatoria {

    adobe-hyphenate: none;

    -ms-hyphens: none;

    -moz-hyphens: none;

    -webkit-hyphens: none;

    -epub-hyphens: none;

    hyphens: none;

}

Este código:

h1 + p, h2 + p, h3 + p, h4 + p, h5 + p, h6 + p, hr + p, blockquote + p, ol + p, ul + p, table + p, dl + p {

    text-indent: 0;

}

Equivale a eliminar el indentado al párrafo siguiente a la etiqueta que se especifica. Es decir, sería como aplicar el estilo "asangre" a la etiqueta <p> siguiente a un <h1>, <h2>, <hr>, <blockquote>, etc. Como siempre, se podrán eliminar los que no se necesiten o añadir los que hagan falta.

Para citas textuales enmarcadas con la etiqueta blockquote se puede incorporar una imagen. A modo de ejemplo se incluye en el ePub Base la imagen comilla1.png:

blockquote.comilla {

    text-align: left;

    font-style: italic;

    margin: 1em 8%;

    padding: 0 6%;

    background: url('../Images/comilla1.png') no-repeat top left;

    background-size: 1.25em 1.25em;

    page-break-inside: avoid;

    break-inside: avoid;

    overflow: hidden;

}

blockquote.comilla p {

    font-style: inherit;

    margin: 0;

}

Se aplicará en el .xhtml:

<blockquote class="comilla">Texto (o varios párrafos con la etiqueta <p>

</blockquote>

Aplicación de estilos

La utilización de las clases almacenadas en nuestra «hoja de estilos» se realiza de dos formas, según sea un selector de algún elemento de HTML (etiqueta) o un selector de clase o estilo.

El estilo de un elemento de HTML (como <body> o <p>) se declara en el style.css para llamarlo desde un .xhtml:

style.css

body { margin:1em; }

Section0001.xhtml

<body>…</body>

La llamada a un selector de clase (como «.versalita») necesita declararse igualmente en el style.css para llamarlo desde un .xhtml:

style.css

.versalita { font-size:0.8em; } /*fijate en el punto que antecede al nombre*/

Section0001.xhtml

<span class="versalita">TEXTO</span>

Ejemplos

Veamos algunos ejemplos de cómo aplicar clases y los resultados que producen para que puedas familiarizarte con el código CSS.

Algunos editores prefieren eliminar el indentado al comienzo de cada capítulo o tras una pausa. Es suficiente con aplicar el estilo «.asangre» para conseguirlo:

<p class="asangre">Párrafo</p>

Párrafo (texto con identado 1.5 em por defecto)

Párrafo (asangre)

Este no es el caso del presente manual, en el que se ha tenido que crear una clase para realizar el indentado, ya que se ha usado el css específico para este tipo de libros, como se puede ver en el fichero style.css:

/* El estilo por defecto es el de párrafo normal, apto para novelas, relatos, ensayos, etc.*/

p {

    margin: 0

    text-align: justify;

    text-indent: 1.5em;

}

/* Estilo de párrafo aleman o moderno. Apto para obras como manuales, obras de referencia, obras científicas o técnicas, etc.*/

p {

    margin: .65em 0;

    text-align: justify;

    text-indent: 0;

}

Por tanto, mientras que en una novela el indentado se realizará por defecto y será necesario crear una clase para evitarlo, en un manual estará definido sin él. Por supuesto, al estar en el fichero style.css, estos estilos son totalmente personalizables.

También es posible indicar que tras una determinada etiqueta siempre se elimine el indentado, de la siguiente forma:

style.css

h1 + p, h2 + p, h3 + p, h4 + p, h5 + p, h6 + p, hr + p, blockquote + p, ol + p, ul + p, table + p, dl + p, .banner + p { text-indent:0.8em; } /*Este es el código incluído en el ePub Base, se pueden agregar otros a la lista*/

Section0001.xhtml

<h1>TITULO</h1>

<p>Párrafo sin indentado</p>

Para indicar una pausa en la lectura podemos emplear el estilo «.salto25» o <hr/> (usado para saltos de escena) o «.salto10» y <p>&nbsp;</p> (adecuado para saltos en cartas, sinopsis, poemas). Si bien ambas formas son válidas, es preferible no utilizar los estilos de salto:

<p class="salto10">Párrafo</p>

Párrafo

Sino usar <hr/> y <p>&nbsp;</p>, ya que existen lectores que no detectan correctamente los ficheros .css, por lo que en esos dispositivos solo estas resultarían visibles.

Para destacar un bloque de texto, como una carta o un recorte de periódico es muy útil el estilo «blockquote»:

<blockquote><p>Carta</p></blockquote>

Carta

Podemos combinar diferentes estilos para conseguir efectos distintos. Aquí podemos ver un ejemplo de la combinación de los estilos «.centrado» y «.negrita»:

<blockquote class="centrado negrita">Párrafo</p>

Párrafo

Por defecto todos los párrafos aparecen justificados. Para alinear el texto disponemos de los estilos «.derecha», «.izquierda» y «.centrado».

<p class="derecha">Párrafo</p>

Párrafo

Si te encuentras con alguna clase que no sabes qué es o para qué sirve, puedes consultar webs como las siguientes (en inglés):

www.blooberry.com

www.w3schools.com

CREANDO UN EPUB

PRIMEROS PASOS

Aquí aprenderás los puntos clave para comenzar a maquetar y también cómo rellenar los datos básicos con el sistema común a todos los ePubs de EPL.

Plantilla base
Elementos fundamentales

La «plantilla», que también se conoce como el «ePub Base», es el libro en formato ePub a partir del cual maquetamos todas y cada una de las obras que publicamos. Ese ePub Base tiene todas las páginas y elementos necesarios para maquetar un libro según el estándar de calidad que seguimos en EPL, y su uso garantiza la compatibilidad con la mayor cantidad posible de lectores actuales.

En resumen, estos son los apartados generales que verás en la plantilla, incluidos dentro de la carpeta «Text»:

cubierta.xhtml

sinopsis.xhtml

titulo.xhtml

info.xhtml

TOC.xhtml

dedicatoria.xhtml

Section0001.xhtml

autor.xhtml

notas.xhtml

Cada uno de ellos tiene sus propias características que serán explicadas con detalle en su apartado correspondiente. Algunos, como el autor o las notas, son opcionales.

Por otro lado, existen otros apartados a tener en cuenta, y que van a ser referenciados a la hora de realizar ciertas tareas:

Carpeta Styles: En su interior están las hojas de estilo de las que ya hemos hablado, epl.css, sgc-toc.css y style.css.

Carpeta Images: Cualquier imagen que se añada irá aquí. Por defecto están la imagen del autor (autor.jpg), la cubierta (cover.jpg), el logo de EPL (EPL_logo.png), el ex-libris (ex_libris.png), los asteriscos (asteriscos.png), las comillas (comilla1.png) y la que indica que hay fuentes incrustadas (fuente.png).

Los archivos autor.jpg, asteriscos.png, comilla1.png y fuente.png, se eliminarán si no se utilizan.

content.opf

toc.ncx: Nunca se debe modificar este archivo directamente para modificar la TOC.

Finalmente, debes saber que hay ciertos puntos del ePub Base que no se permite alterar. No pueden ser borrados ni cambiados:

Los códigos CSS irán colocados siempre en su archivo correspondiente de la carpeta styles (style.css). No debe aparecer dicho código en ninguna otra parte del ePub.

El fichero epl.css NO debe modificarse de ninguna manera.

No se puede modificar el aspecto general de algunos apartados, con el objetivo de conseguir uniformidad en los aportes. Más adelante se hablará más extensamente sobre ello.

Primeros pasos
El Book-Id y los metadatos

Lo primero que debes hacer es crear tu propio fichero ePub. Los pasos a seguir son los siguientes:

Descarga la última versión del ePub Base si todavía no lo has hecho.

Guárdala en un lugar de tu ordenador que te resulte cómodo (la usarás más veces en el futuro).

Haz una copia de ese archivo y utilízala para maquetar tu libro. De este modo, siempre tendrás intacto el ePub Base.

Utiliza un nombre reconocible o, si quieres, usa el que al final de todo el proceso tendrá que tener obligatoriamente y que puedes consultar en «Cómo nombrar los archivos», dentro del apartado «Publicación en la web».

Ahora que ya tienes la plantilla, vamos a empezar a trabajar.

Repetimos la importancia de GUARDAR UNA COPIA del ePub Base en alguna parte nada más empezar, para evitar realizar modificaciones sobre ella y tener que volver a descargarla cada vez que empecemos una maquetación.

Asignar al fichero un Book-Id

Todo archivo ePub debe tener una clave que lo identifique. Se trata de una combinación de letras y números que es única y exclusiva para cada archivo, algo así como «a3f1898a-db6a-4619-84a4-2ca8cc51490a». Y eso es el «Book-Id» (Book Identifier, Identificador del libro).

El ePub Base tiene, lógicamente, su propio Book-Id, formado enteramente por ceros.

<dc:identifier id="BookId" opf:scheme="UUID">urn:uuid:00000000-0000-0000-0000-000000000000</dc:identifier>

Cada vez que necesitemos crear otro libro, tendremos que obtener un nuevo Book-Id. Existen tres formas de hacerlo:

Generador de Book-ID de Sigil

Aprovecha el generador de Book-ID propio de Sigil, que asigna un número nuevo a cada ebook nuevo creado con él. La ventaja de este método es que no necesita conexión a Internet:

Debes abrir Sigil sin ningún libro o le dices que cree uno nuevo.

En el menú de la izquierda, haz doble clic sobre el archivo «content.opf» y copia la línea

<dc:identifier id="BookId" opf:scheme="UUID">urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</dc:identifier>

(en lugar de x, saldrá una combinación de letras y números).

(Re)Abre el ePub en proceso de edición, y reemplaza la línea respectiva en su «content.opf» (la forma más fácil es seleccionarla completa y pegar encima).

Regenera la TOC.

Dale a «Guardar».

Generador de Book-ID de la ficha web

La segunda forma es utilizar el generador disponible en las fichas de los libros. Este método solo podrás utilizarlo una vez que seas editor:

Ve a la ficha de tu libro y en la esquina inferior derecha verás 2 botones:

El primero te servirá para generar el nombre del archivo automáticamente, según unas normas que veremos más adelante y que conviene que conozcas. El segundo, que es el que ahora nos interesa, te generará automáticamente un código alfanumérico que será el que debes sustituir en tu ePub.

Abre tu libro en Sigil y, en el menú de la izquierda, haz doble clic sobre el archivo «content.opf».

En ese documento verás la siguiente línea:

<dc:identifier id="BookId" opf:scheme="UUID">urn:uuid:00000000-0000-0000-0000-000000000000</dc:identifier>

Borra la lista de ceros (00000000-0000-0000-0000-000000000000) y sustitúyelo por el Book-Id que conseguiste.

Regenera la TOC.

Dale a «Guardar».

Cambio automático realizado por ePLValidator

La tercera es la más sencilla: no hacer nada. Eso supondrá que nuestro libro contiene el mismo Book-Id que el ePub Base. Al utilizar la versión auto del ePLValidator, el programa detectará esta situación y le asignará uno nuevo de forma automática.

NOTA: Cualquier cambio que se realice en el «content.opf» obliga a regenerar la TOC (Tabla de contenidos) para que el ID se copie también en toc.ncx.

Antes de manipular el «content.opf», guarda una copia de tu trabajo. Este archivo es muy sensible, y un error a la hora de modificarlo podría destruir todo tu trabajo.

Ten en cuenta que si modificas el uuid algunos dispositivos identificarían 2 libros diferentes, en lugar del mismo, por lo que en lugar de sustituir automáticamente el libro convivirían ambas versiones.

Si no lo tocas, permanecerá igual independientemente de los cambios que realices en el libro.

Introducir los metadatos

Los metadatos son informaciones básicas de cada ePub. Esos datos no son inmediatamente visibles al lector (de ahí lo de «meta» datos), pero son imprescindibles para que los distintos lectores electrónicos (eReader) muestren las portadas, títulos, autores, editoriales, etc.

Rellenar estos metadatos es obligatorio, y es conveniente hacerlo al comenzar la maquetación del ePub, ya que resulta muy fácil olvidarse de ellos.

Los metadatos se incluyen usando Sigil. Puedes acceder a ellos de tres formas:

Desde el menú Herramientas → Editor de metadatos.

Pulsando la tecla F8

pulsando el icono «i» de la Barra de herramientas.

Con cualquiera de las tres formas se abre la ventana de edición de metadatos.

Una vez en ella, pasamos a introducir los metadatos en el formulario. En nuestro estándar de calidad, exigimos que, como mínimo, estén completados los metadatos de título, autor, idioma, fecha de publicación, descripción, traductor (si es el caso), género literario, el EPL_id y el número de revisión. Si usas como plantilla el ePub Base ya tendrás los metadatos incluidos y solo deberás actualizar los valores con los datos del libro.

Idioma. Por defecto viene «español». Si el libro está en un idioma distinto, selecciónalo de la lista.

Título. Escribe el título de la obra. Sigue el mismo criterio que para el nombre del archivo cuidando que tenga las mayúsculas normalizadas. Puedes consultar dudas al respecto en el apartado de ortografía.

Si se está trabajando en el Sigil con un ePub en blanco debemos seleccionar los metadatos siguientes de la lista que aparece al presionar el botón de «Añadir metadatos»:

Autor. Introduce el nombre y apellidos del autor. Para más información, consulta el apartado específico que viene a continuación (Cómo rellenar el campo «Ordenar como»).

Editorial. Por defecto viene «ePubLibre», no debes cambiarlo.

Fecha [modification]. No hace falta que hagas nada: Sigil almacena automáticamente la fecha de la última modificación del archivo.

Fecha [publicación]. Escribe en este campo la fecha de la primera publicación en el idioma original del libro (no de la primera versión en el idioma en que lo subes ni tampoco el año de publicación de tu edición). Si, como es frecuente, no sabes el día o el mes, invéntatelos. Muchos editores optan por poner el 1 de enero.

Materia. Género y subgénero/s al que pertenece la obra maquetada separados por comas. La lista de géneros y subgéneros que usamos en EPL puedes verla en el apartado de géneros y subgéneros. No es necesario incluir Tipo (Ficción / No ficción).

Descripción. Es la sinopsis de la obra. Tiene que ser la misma que aparecerá en el libro. Asegúrate de copiar solo el texto, sin etiquetas (código). Si tenía cursivas (en títulos de obras, por ej.), debes reemplazarlas por «».

EPL_id. Es el número de identificación que se le asigna al libro cuando se crea su ficha en la web. En "Añadir metadatos" selecciona "Identificador: personalizado", rellena donde dice [Identificador personalizado aquí] con el valor numérico del EPL_id y donde dice [Valor de lugar aquí] coloca las siglas "EPL".

Revisión. Es el número de revisión del libro. Si se trata de un libro nuevo su valor es "1.0". En "añadir metadatos" selecciona "Identificador: personalizado", rellena donde dice [Identificador personalizado aquí] con número de revisión y donde dice [Valor de lugar aquí] escribe la palabra "revision".

Y hay un último dato que es imperativo en el caso de libros traducidos:

Traductor. Aparece en la lista que se abre al darle al botón «Añadir participación».

Además, en el caso de libros que pertenezcan a una saga o serie, debes incluir dicha información en los metadatos, que será utilizada por varios dispositivos / aplicaciones (p. ej. Calibre) en sus búsquedas y clasificaciones. A partir de la versión de Sigil 0.9.10 podrás introducir los datos de la serie directamente desde la ventana del formulario de metadatos, donde ya están disponibles las propiedades "serie" e "índice de serie". De no ser el caso, deberás editar el archivo «content.opf» y, debajo de

<meta name="cover" content="cover.jpg" />

modifica las siguientes líneas, cambiando por lo que corresponda:

<meta name="calibre:series" content="Nombre de la saga" />

<meta name="calibre:series_index" content="Índice de la saga" />

Una vez introducidos todos los datos, pulsamos en «OK». Se cerrará la ventana de los metadatos. Y luego salvaremos nuestro trabajo pulsando en «Guardar».

Los campos nombrados son básicos y deben constar en todos los ePub. Opcionalmente, se pueden añadir otros datos que consideremos interesantes.

Siempre que se añada, modifique o elimine algún metadato, habrá que volver a generar el «Índice de contenidos» (TOC). Además, es recomendable repetir esta operación cuando terminemos la maquetación, para garantizar que no se pierda nada.

Cómo rellenar el campo «Ordenar como»

¿Qué campo hay que rellenar: «Autor», «Ordenar como» o los dos? Pues lo obligatorio es rellenar AMBOS campos.

Para aquellos que sean curiosos, se puede ver que en el content.opf se añade la siguiente etiqueta:

<dc:creator opf:file-as="Le Fanu, Joseph Sheridan" opf:role="aut">Joseph Sheridan Le Fanu</dc:creator>

La mayoría de dispositivos / aplicaciones usa la norma inglesa de ordenación. Es decir, 1.er Nombre (2.º Nombre) 1.er Apellido. Hay autores con nombres complejos, así que es mejor tomar precauciones mediante el campo «Ordenar como» (File-As).

En EPL seguimos lo indicado en el catálogo de la BNE para saber la forma de ordenar a los autores.

Veamos unos ejemplos:

Un solo autor

Pongamos que tenemos dos grandes autores latinoamericanos: Jorge Luis Borges y Adolfo Bioy Casares. Si no especificamos «Ordenar como», en las listas podría aparecer el segundo por delante (pues usará «Bioy» como 2.º nombre y «Casares» como apellido). Si, por el contrario, rellenamos ambos campos (Autor → Ordenar como), nos aseguramos que la mayoría de lectores sí los reconozca de forma adecuada.

Jorge Luis Borges → Borges, Jorge Luis

Adolfo Bioy Casares → Bioy Casares, Adolfo

José Faustino Sánchez Carrión → Sánchez Carrión, José Faustino

Joseph Sheridan Le Fanu → Le Fanu, Joseph Sheridan

Juan Pablo Vizcardo y Guzmán → Vizcardo y Guzmán, Juan Pablo

Pero incluso si nuestro autor no es «complicado», también es obligatorio rellenar «Ordenar como» (por consistencia: no hacerlo, frente a otros que sí lo tienen, podría alterar el orden de lista, y debe evitarse).

Horacio Quiroga → Quiroga, Horacio

Oliverio Girondo → Girondo, Oliverio

Casos especiales

Cuando el nombre del autor va seguido de una sigla, la ordenación se hará por el apellido que le sigue y que está escrito completo, pasando la sigla a formar parte del nombre, aun en el caso de que realmente se trate de un apellido abreviado.

George R. R. Martin → Martin, George R. R.

Cuando el primer apellido va precedido de partículas como «de» «de la», «del» o con partículas de otros idiomas tales como «von», la partícula pasará a formar parte del nombre.

Miguel de Cervantes Saavedra → Cervantes Saavedra, Miguel de

Nombres de dificil ordenación (como el japonés) y otros casos especiales: se seguirá el criterio de la BNE.

San Agustín → San Agustín

Sun Tzu → Sun Tzu

AA. VV. → AA. VV.

Cuando el autor no ha querido darse a conocer ni directamente ni con un seudónimo, se utiliza como autor: Anónimo.

Dos o más autores

No hay una forma universal (100% estándar), pero la más compatible es colocar en una sola línea los autores unidos con ampersand (&), como se observa en los siguientes ejemplos (Autor → Ordenar como):

Adolfo Bioy Casares & Jorge Luis Borges → Bioy Casares, Adolfo & Borges, Jorge Luis

Jean-Claude Barreau & Guillaume Bigot → Barreau, Jean-Claude & Bigot, Guillaume

Lo que difiere entre dispositivos / aplicaciones es cuál se usa como principal (Calibre y muchos otros tomarán el primer autor; una minoría, Nook STR entre ellos, el segundo). Pero ese es un tema que ya no se puede controlar.

Traductor(es), ilustrador(es), otros colaboradores

En los metadatos del ePub tenemos definido como obligatorio añadir al traductor. No obstante, no existen limitaciones a la hora de añadir otros colaboradores, y en algunos casos puede ser interesante, por ejemplo, añadir al ilustrador de una novela.

También, cuando añadimos colaboradores, es obligatorio rellenar su campo «Ordenar como» para normalizar nuestras bibliotecas virtuales (en Calibre, por ejemplo). En la siguiente imagen se muestran los metadatos de un libro al que se ha añadido el ilustrador de la portada, además del traductor, y se han rellenado ambos campos «Ordenar como» (o «Mostrar como», depende de la traducción):

En el archivo «content.opf» tendremos las siguientes líneas:

<dc:contributor opf:file-as="Cortes Rodríguez, Raquel" opf:role="trl">Raquel Cortes Rodríguez</dc:contributor>

<dc:contributor opf:file-as="Spencer, Ron" opf:role="ill">Ron Spencer</dc:contributor>

Si en el libro existe más de un colaborador de un tipo concreto (por ejemplo, dos o más traductores o ilustradores) se siguen las mismas reglas que en el caso de los autores, enlazándolos con ampersand (&) y rellenando «Ordenar como» del modo que seguiríamos con los autores.

NOTA: En ocasiones las editoriales no aportan datos del traductor oficial del libro y no hay forma de averiguar su identidad. Para esos casos se ha creado en nuestra web un autor / traductor especial: Desconocido (no confundir con autor Anónimo).

Añadir las imágenes de la portada y del autor

Recordemos que para maquetar nuestro libro hemos usado como plantilla el «ePub Base» de EPL. Ese ePub tiene una imagen para la portada y otra para el autor (puedes verlas en Sigil, en la carpeta Images, con los nombres cover.jpg y autor.jpg, respectivamente).

Por supuesto, no son las imágenes que queremos para nuestro libro y tenemos que cambiarlas por las nuestras. Los nombres de las nuevas imágenes deben ser iguales porque esos nombres son los que usan los archivos de la portada (cubierta.xhtml) y del autor (autor.xhtml).

El nombre debe ser EXACTAMENTE el mismo: «cover.jpg» y «autor.jpg» (todo en minúsculas, o no funcionará).

La imagen que vayamos a usar como portada debe tener las siguientes características:

Nombre obligatorio: cover.jpg (exactamente igual, todo en minúsculas).

Dimensiones: Desde 600 píxeles de ancho por 900 píxeles de alto hasta 1.200 px de ancho y 1.800 px de alto, guardando una proporción 2:3.

Peso: Recomendamos que ni la imagen de portada, ni ningún archivo del ePub excedan los 300 kb de peso.

Concepto: Debe tener activado el concepto Imagen de portada.

Logo: Debe incorporar el logo oficial de ePubLibre en el lugar y con el color que veas que mejor se adapta. Para ello debes utilizar las plantillas predefinidas.

Otros logos editoriales: Es obligatorio eliminar los logos preexistentes de la editorial. Si no eres muy hábil en el retoque de imágenes, seguro que alguien del foro te ayudará.

Si en tu libro vas a añadir una breve biografía del autor (u otro colaborador), su foto debe tener las siguientes características:

Nombre obligatorio: autor.jpg (escrito así, todo en minúsculas).

Formato: Debe estar en formato «jpg».

Dimensiones: Es recomendable que tenga una resolución mínima de 270 píxeles de ancho por 360 de alto (y nunca pasar de 400 (de alto) x 600 (de ancho) píxeles).

Las últimas comprobaciones de nuestro banco de pruebas han demostrado que los lectores que usamos como control para las pruebas de compatibilidad soportan imágenes de hasta 2Mb y tamaños de 1500×2250 en imágenes tipo retrato y 1600×1117 en imágenes apaisadas, e incluso tamaños mucho mayores en la mayoría de ellos. Aun así, recomendamos no utilizar imágenes excesivamente pesadas.

NOTA: las pantallas de los eReader son pequeñas y no ganamos demasiado poniendo imágenes excesivamente grandes, a la vez que perdemos velocidad de carga al aumentar el peso del conjunto.

Una vez que tengas las imágenes (o la imagen, si solo vas a usar la de portada) preparadas, sigue estos pasos:

Nos aseguramos de que los ficheros de imagen tienen los nombres adecuados (cover.jpg, autor.jpg), letra por letra, todas en minúsculas, incluidas las extensiones.

Para incluirlas en el libro, pulsa una vez en la carpeta «Images» para realzarla. Luego, ve a Fichero → Añadir → Ficheros existentes para seleccionar y añadir tus imágenes.

Haces lo mismo si, tras realzar «Images», pulsas el icono «+» de la barra superior de herramientas.

Un tercer sistema es pulsar con el botón derecho del ratón sobre esa carpeta «Images» y elegir «Añadir ficheros existentes».

Responde sí cuando te pida permiso para sobrescribir las imágenes existentes.

Por último, algo muy importante. Pulsa con el botón derecho del ratón el archivo cover.jpg, y en la opción «Añadir concepto» selecciona «Imagen de portada». Si no lo haces, algunos lectores no mostrarán la portada.

Es importante recordar que la portada no debe ser muy pesada, guardar una proporción 2:3 y medir desde 600 × 900 px (ancho-alto) hasta 1.200 x 1.800 px, y tiene que eliminarse el logo editorial y llevar el logo de EPL.

Esos límites son especialmente importantes para la imagen de la portada. Aunque las imágenes interiores los pueden superar hasta cierto punto según el lector de que se trate. Para más información, visita nuestro banco de pruebas.

Cómo añadir otras imágenes

Para incluir imágenes en el interior del archivo, puedes consultar el Tomo III: Código avanzado → Inserción de imágenes.

Y si lo que necesitas es modificar o arreglar una portada ya existente, puedes consultar el próximo apartado (Diseño básico de portadas) para un arreglo simple o el Tomo IV para una información más avanzada.

Dónde encontrar las portadas

Existen muchas formas de encontrar las portadas oficiales. Una simple búsqueda en Google debería bastar. Es obligatorio eliminar el logo editorial e incluir el de EPL. Si no sabes hacerlo, puedes consultar el apartado correspondiente, o pedir ayuda en el foro, hay editores y colaboradores que te ayudarán.

Algunos buscadores especializados son:

http://bigbooksearch.com/books

http://www.googleimageripper.com/

Por otro lado, si lo deseas, también puedes crear tus propias portadas.

Diseño básico de portadas

Para maquetar nuestro libro necesitaremos como mínimo una imagen, la portada. A continuación se explica brevemente cómo crearla utilizando Gimp, un editor de imágenes libre y multiplataforma y las plantillas de portada que pueden descargarse de la web.

Elementos necesarios

Materiales

Gimp: Es un programa libre de manipulación de imágenes. Se descarga de http://www.gimp.org/ y existen versiones para Windows, Mac y Linux (aunque es probable que en Linux ya esté instalado o sea más fácil instalarlo desde los repositorios de la distribución y no descargarlo de la página). Si tienes cualquier otro programa de manipulación de imágenes, como Photoshop, también servirá.

Las plantillas de portada de EpubLibre: Se descargan del foro en epublibre.org. En este tutorial usaremos las plantillas en formato .psd con la posibilidad de cambiar el color y la ubicación del logo.

Una imagen base para la portada: En este caso hay dos opciones: o utilizamos una portada ya diseñada, con el nombre del libro y autor ya incorporados o diseñamos nuestra portada a partir de una foto o imagen cualquiera. En este segundo caso necesitaremos también añadir el título y autor, por lo que necesitaremos elegir una tipografía.

A tener en cuenta

La imagen a utilizar debe tener una resolución lo suficientemente grande como para que no se pixele al acomodarla al tamaño de la plantilla. Como guía, debería tener al menos 600px por 900px (el tamaño de la portada de EpubLibre), sin que estas medidas deban ser exactas, ya que en esta guía veremos cómo recortar, achicar y adaptar al tamaño de la portada.

La plantilla del logo tiene un tamaño exacto de 600 × 900. Si vas a utilizar una portada mayor, lo primero debes aumentar el tamaño de dicha plantilla para que el logo quede proporcional.

A continuación explicamos cómo crear la portada trabajando con el tamaño de 600 × 900 px.

Trabajando en Gimp

Lo primero que necesitamos es redimensionar la imagen que usaremos para que tenga el tamaño de la portada de EpubLibre. Abrimos (menú Archivo → Abrir) la imagen base para empezar a trabajar.

Seleccionamos la herramienta de recorte y abrimos el menú de «Opciones de herramienta» (menú Ventanas → Opciones de herramientas). En las opciones seleccionamos «Fijo» y en el desplegable «Proporción de aspecto». Nuestra relación de aspecto será de 2:3, para lo que introducimos la opción «2:3» o «6:9», asegurándonos de tener seleccionada la opción «Vertical».

Las opciones nos deben quedar de la siguiente manera:

Ahora dibujamos la caja de recorte sobre nuestra imagen, la cual mantendrá la relación 2:3 sin importar el tamaño que le demos. Lo ideal al recortar un diseño ya existente es tratar de mantener la mayor parte, minimizar lo que será «recortado»; para eso lo ideal es que uno de los lados de la caja de recorte coincida con el tamaño de la imagen a recortar. De esta forma solo desperdiciaremos una franja, sea lateral u horizontal, de la portada. Qué parte de la imagen descartamos depende totalmente del diseño original: a veces el título está pegado a un borde, otras una parte central de la imagen está en una de las esquinas, etc. Debemos mover la caja de recorte buscando la opción que mejor se adapte a lo que queremos obtener.

En este caso hemos recortado el nombre de la editorial que se encontraba sobre el nombre del autor y una pequeña franja de color en la parte inferior

Una vez que tenemos la caja ubicada con un doble clic o un enter realizamos el recorte. Nos quedará entonces una imagen cuya relación de aspecto es de 2:3. Ahora vamos a cambiar la resolución para llevarla a los 600×900 px exactos. Para eso seleccionaremos el menú «Escalar la imagen»:

Y en el cuadro seleccionamos «px» en el desplegable y marcamos la opción de «mantener relación» (el icono de los eslabones junto a los cuadros de anchura y altura debe estar conectado). Introducimos 600 en la anchura y automáticamente, dado que estamos manteniendo la proporción, debe aparecernos 900 en la altura.

Seleccionamos «Escala» y ya tenemos nuestra imagen de portada en el tamaño correcto. Aquí puede ser necesario algún otro retoque para quitar logos de editorial, algún texto, etc. Para esto Gimp tiene varias herramientas con las que se puede experimentar, como pueden ser la herramienta de clonación, saneado, pinceles, dibujar formas geométricas, etc. Para conocer más sobre estas opciones véase el Tomo IV: Imágenes y gráficos svg.

Sólo nos falta el logo de EpubLibre.

Abrimos la plantilla de extensión .psd del color que necesitemos, y desde la ventana de capas de la portada que acabamos de crear arrastramos la imagen a la ventana de la plantilla.

Una vez que tenemos la portada en el archivo con el logo nos aseguramos, en la ventana de capas, que la capa con el logo esté por encima de la capa con la imagen. Utilizando la herramienta mover lo desplazaremos hasta la posición deseada.

NOTA: Recordamos que la plantilla del logo es de 600 × 900 px. Si se utiliza una portada de un tamaño superior, será preciso escalarla antes de pasar el logo.

Solo nos queda salvar nuestra imagen para poder usarla en el ePub. Para eso vamos al menú «Archivo» y seleccionamos «Exportar». Nos aparecerá el siguiente cuadro:

En la parte inferior, hacemos clic en «Seleccionar el tipo de archivo» y marcamos la opción «Imagen JPEG». Navegamos en el sistema de archivos hasta la carpeta donde guardaremos nuestra portada y hacemos clic en «Exportar».

En el cuadro que se abre marcamos la casilla «Mostrar vista previa en la ventana de origen». Esto nos permitirá saber el tamaño en kB que tendrá la imagen final, además de ver en una ventana cómo quedará, lo que nos permite chequear que se vea bien.

Finalmente usamos la barra deslizante de «Calidad» en la parte superior del cuadro, buscando la mejor relación entre calidad y peso en kB. Para eso podemos ayudarnos con la vista previa para encontrar el punto en que no hay pérdida visible de calidad, siendo aconsejable mantener el tamaño por debajo de los 300 kB, al menos en las portadas. Cuando estemos satisfechos con el resultado hacemos clic en «Exportar» para finalizar el proceso.

Con esto ya tenemos nuestra imagen de portada para usar en el ePub. Ahora necesitamos una versión reducida a 400 px por 600 px para subir en la ficha de la página. Para eso, antes de cerrar el archivo del gimp (.xfc), usaremos de nuevo la herramienta «Escalar imagen», pero ahora pondremos 400 px en el ancho. Automáticamente nos reducirá a 600 px el alto. Aceptamos y salvamos la imagen al nuevo tamaño (mediante exportar o la opción «Guardar cómo», con un nombre que nos permita identificarla fácilmente cómo la imagen para web), teniendo cuidado de no sobrescribir la imagen de portada del ePub.

Si nos olvidamos de este último paso, se puede utilizar la imagen de la portada (.jpg) para ello. Normalmente no se va a notar la pérdida de calidad, pero puede haber portadas en las que sí, por lo que es recomendable usar el sistema anterior siempre que sea posible.

Completar las páginas básicas

Vamos a empezar. Recuerda que en Sigil siempre hay que trabajar en «Vista de código» si no queremos encontrarnos con código no deseado.

Como ya se comentó, el ePub Base trae unas páginas estándar (esto es, que usamos de igual modo y con la misma maquetación todos los editores) para determinados contenidos:

La cubierta del libro (cubierta.xhtml).

El título, la versión, y la fecha de edición del libro (titulo.xhtml).

Una sinopsis —breve resumen— del mismo (sinopsis.xhtml).

La información básica de la obra (info.xhtml).

El índice de contenido HTML (TOC.xhtml)

La dedicatoria (dedicatoria.xhtml), suponiendo que el libro original la tenga, claro; no se trata de una dedicatoria que quieras hacer tú.

La biografía del autor (autor.xhtml).

Las notas (notas.xhtml).

Veámoslas una a una:

cubierta.xhtml

No es preciso que hagas nada. Al sustituir la imagen de portada, darle el nombre cover.jpg, y añadirle el concepto, el enlace existente automáticamente recupera la nueva imagen.

Si la imagen de la portada tiene unas dimensiones distintas de 600 × 900 debes modificarlo en viewBox, width y height del código del archivo cubierta.xhtml

sinopsis.xhtml

Es el segundo .xhtml que debe estar presente en nuestro ePub. Su texto coincide con la variable «Description» (Descripción) de los metadatos.

Has de sustituir el texto predeterminado en la plantilla por la sinopsis del libro que hayas preparado. Recuerda que debe ser el mismo texto que introdujiste en los metadatos, o nuestro validador te indicará un error. Y adelantamos que ese mismo texto será el que uses cuando crees la ficha del libro en la página web de ePubLibre.

Si no se dispone del original en papel, puedes encontrar buenas sinopsis de las obras buscando por Internet. Muchas páginas de librerías online las contienen.

El código para los párrafos de la sinopsis tiene que ser como figura en el ePub Base. Es decir, debe estar dentro de una división:

<div class="sinopsis">

<p>Texto</p>

</div>

Es importante indicar que los indicadores de párrafo (<p>) no pueden ser eliminados ya que son los que definen el formato del texto.

titulo.xhtml

Es el tercer .xhtml que debe estar presente en nuestro ePub. Está ajustado para que pueda mostrarse en todos los lectores.

No están permitidas las imágenes ni las fuentes incrustadas, dado que pueden desajustar la visualización en diferentes lectores.

Si se quiere añadir imágenes o fuentes tipográficas, se deberá hacer un segunda página a gusto del editor (Portadilla), situada después de la página Info.

En esta página tenemos que cambiar varias cosas. Y, como es normal, recuerda ir guardando con frecuencia tu trabajo en Sigil (bien con Fichero → Guardar, o bien con el botón correspondiente de la barra de herramientas, que tiene el icono de una flecha azul bajando hacia un disco duro):

Autor

El escritor de la obra, no el editor. Por ejemplo: Erle Stanley Gardner.

Título

El título del libro. Debe tener las mayúsculas normalizadas y en el idioma en que está el libro que vas a ofrecer (no en el idioma original). Por ejemplo: El caso del gato del portero.

Subtítulo

Si el libro tiene subtítulo, ponlo aquí. Si el libro no tiene subtítulo ni saga, elimina toda la línea (también <p> y </p>).

Serie

Si el libro pertenece a una saga o colección, añádela aquí (por ejemplo, Perry Mason 07).

ePUB r1.0

Si es la primera versión de tu libro, déjalo tal cual. Si es una revisión en la que ya has corregido erratas o lo que sea, sustituye ese texto por el que corresponda. Por ejemplo, ePub r1.1. Existe una normativa a la hora de indicar la revisión de que se trata, que puedes consultar en el apartado Revisiones.

Editor

Se sustituye por tu alias. O puedes mantener el anonimato utilizando «Titivillus». Muchos editores optan ahora por esta opción.

Fecha

«23.10.14». Cambia esa fecha por aquella en la que hayas realizado la edición o revisión del libro. Por ejemplo, 23.04.15

Siempre que se actualice un aporte en la web, hay que ACTUALIZAR el número de VERSIÓN y la FECHA en titulo.xhtml. Y anotar en el apartado notas de la ficha de la web las modificaciones realizadas.

info.xhtml

Es el cuarto .xhtml que debe estar presente en nuestro ePub. También aquí hay que cambiar varias cosas. Hay que ser cuidadoso y modificar solo los textos que se indican a continuación, pero no tocar los códigos como <p> o cualquier otro. En cualquier caso, si te equivocas, recuerda que siempre tienes un archivo «limpio» en el ePub Base. Y, por supuesto, guarda con frecuencia tu trabajo.

En este caso, debe reemplazarse:

Título original

Reemplázalo por el título en el idioma original en que fue escrito el libro. Como siempre, procura cuidar la ortografía, en este caso, según el idioma en cuestión.

Autor, año de 1.ª publicación en idioma original

Se trata de cambiarlo por el nombre y apellidos del autor y por el año (no es preciso día y mes) en que se publicó por vez primera el libro en su idioma original. Los datos deben coincidir con los que pusimos en los metadatos. Por ejemplo: Erle Stanley Gardner, 1935

Traducción

«Traductor» ha de cambiarse por el nombre del mismo. Si la editorial nunca lo indicó, utiliza «Desconocido».

Si el libro que vas a publicar está en su idioma original, borra toda la línea.

Ilustraciones

«Ilustrador» debe cambiarse por el nombre del autor de las imágenes o láminas del interior del libro. Si no es el caso, borra toda la línea.

Diseño/Retoque de portada

Se escribirá «Diseño de portada» o «Retoque de portada», según las necesidades:

Si se conserva la portada original aun con algún ajuste menor de contraste y color (de la que, eso sí, es obligatorio quitar el logo o cualquier referencia a la editorial) debes mantener al diseñador original o no poner nada.

Si la portada original se ha modificado significativamente (traducción de título, cambio de marco o encuadre, reordenación de los elementos que la componen…), debes poner «Retoque de portada» y sustituir «Diseñador» por los nombres del diseñador original y el alias de quien la haya retocado, si así lo desea.

Si la portada es una creación original, debes mantener «Diseño de Portada» y sustituir «Diseñador» por el nombre del creador, si así lo desea.

Editor digital

«Editor» (va después de «Editor digital») se sustituye por tu alias. La línea quedaría así:

<p class="salto10">Editor digital: Titivillus</p>

Pero, como puedes comprobar en la plantilla de este archivo, puede haber más casos. Puede ser que otro editor (o varios) te hayan cedido el ePub. En ese caso, lo primero que debes hacer es contactar con él y averiguar si quiere mantener el crédito. En caso de que esté de acuerdo, estas líneas del documento podrían quedar de la siguiente manera:

Si eres el primer editor, no es preciso especificarte como «Primer editor», se pondrá únicamente «Editor digital». Tampoco será necesario indicar en qué número de revisión se ha trabajado, ya que se presupone que has sido el primero y único, por lo que todas las versiones previas son tuyas también.

Si se trata de un ePub cedido por otro editor, mantén su crédito original, indicando qué revisiones le corresponden, y pon tu alias como «Segundo editor» (o el número que te corresponda), indicando en qué revisiones has trabajado.

Si hay más de un editor trabajando en la misma versión, se colocarán ambos nombres juntos.

Los casos pueden ser muy variados, pero con esos ejemplos puedes hacerte una idea y si tienes dudas estamos en el foro para resolverlas.

ePub Base r2.0

No lo modifiques. No se refiere a la versión de tu libro, sino a la de la plantilla del ePub Base que estás usando para maquetar. Esto permite definir un estándar de calidad, en caso de que más adelante se realice otra revisión del ePub Base para mejorar su compatibilidad o diseño.

Si alguno de los parámetros anteriores es inútil en el caso de tu libro, borra la línea sin más. Y, atención, puedes borrar también todos los «comentarios», esto es, todo lo que aparece en verde. Si te fijas, solo ves esos comentarios en «Vista de código», pero no en «Vista de libro». Para eso son esos comentarios, para ayudarnos según vamos maquetando, pero no para que los vean los futuros lectores del libro.

<p>Párrafo</p><!--Comentario-->

Párrafo

¿Y qué pasa si tienes datos que no vienen en el ePub Base? Lo mejor es que uses tu propio criterio. Como puedes ver en el ejemplo anterior, hay añadidos que no se han comentado anteriormente. A destacar el hecho de que la portada está formada por una foto, y en el libro venía tanto el fotógrafo como el diseñador de la portada. O que se especifica la fecha de la traducción porque existe otra de la misma autora, ligeramente diferente.

Para mantener la privacidad de las personas, la inclusión de los nicks no es en ningún caso obligatoria, debiendo OBTENERSE EL PERMISO de los colaboradores para incluirlos dentro de tus libros.

Si tienes problema para encontrar algún dato, puedes consultar la web de la editorial del libro o alguno de los siguientes catálogos de bibliotecas:

Catálogo de la Biblioteca Nacional de España

Base de datos del ISBN de España

World Cat

TOC.xhtml

Es el quinto .xhtml incluido en el ePub Base, y el primero opcional, pudiendo ir colocado detrás de la página info o bien al final del libro. Lleva asociado un fichero CSS específico, sgc-toc.css, que puede ser modificado a tu gusto.

Sólo se considera obligatorio si el ePub tiene una jerarquía <h3> o inferior, ya que algunos lectores no visualizan dichos niveles en la TOC y de esta forma se les ofrece una solución alternativa para desplazarse por el mismo. En ePub3 sí es obligatorio en todos los libros.

Puedes consultar información sobre como crear y generar la TOC y el fichero TOC.xhtml a tu gusto en los apartados correspondientes de Lo que necesitas saber de Sigil y Maquetando el contenido.

dedicatoria.xhtml

Este documento es opcional: si no existe una dedicatoria, debe eliminarse.

El código es parecido a info.xtml, pero esta vez con class="dedicatoria".

<div class="dedicatoria">

<p>A mis padres por su apoyo.</p>

</div>

Section0001.xhtml

Este archivo se explicará con detalle en el apartado Maquetando el contenido.

autor.xhtml

Si queremos incluir en el libro una breve biografía del autor usamos este fichero, sustituyendo su texto y borrando los párrafos del ePub Base que no necesitemos (o, al revés, creando más párrafos: estos siempre van entre <p> y </p>).

El código que contiene el ePub Base hay que respetarlo, además debemos poner en mayúsculas el nombre del autor al comienzo de la biografía.

Si el autor ya existe en la web puedes utilizar esa biografía o crea otra. Y no olvides informar en caso de ver alguna errata en la ficha o si tienes alguna nueva información

Este documento es opcional, debe eliminarse de ser innecesario junto con la imagen «autor.jpg» de la carpeta Images.

Cuando vayamos a editar varios libros del mismo autor, un buen recurso es «Guardar como» el archivo e importarlo en cada uno de los nuevos libros (aparece pulsando el archivo con el botón derecho). Ahorramos tiempo y se garantiza la uniformidad del contenido.

<h1 class="oculto" title="Autor"></h1>

<p>NOMBRE DEL AUTOR. Lorem ipsum dolor sit amet</p>

<p>…</p>

El título (title="Autor") figura como <h1> en el libro. Deberá cambiarse a "Autora" o "Autores" de ser necesario.

El primer párrafo debe empezar con el nombre del autor en mayúsculas, seguido del texto.

De haberlos, los demás párrafos son normales.

notas.xhtml

En este archivo irá el texto de todas las notas del libro. En el ePub Base puedes ver un ejemplo de las mismas, y puedes consultar su funcionamiento en el apartado correspondiente dentro de Maquetando el contenido. Dado que el código que empleamos ha sido ampliamente probado en muchos tipos de lectores, es obligatorio usarlo, debiéndose sustituir cualquier otro código existente anteriormente.

Casos especiales: Libros en otros idiomas

En el caso de libros en un idioma distinto del español ten en cuenta que hay que modificar algunos términos y ponerlos en el idioma del libro.

La traducción ha sido consensuada en el foro, y debe ajustarse al listado existente.

En concreto, has de traducir:

«Cubierta» en cubierta.xhtml.

<h1 class="oculto" title="Cubierta"</h1>

<div class="cubierta">

<svg viewBox="0 0 600 900" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="100%" preserveAspectRatio="xMidYMid meet" height="100%"><image xlink:href="../Images/cover.jpg" width="600" height="900"/></svg>

</div>

«Título original», «Traductor», «Editor digital», «Ilustrador», etc. en info.xhtml

<p>Título original: <cite>…</cite/></p>

<p>Autor, año</p>

<p>Traductor: …</p>

<p>Ilustrador: …</p>

<p>&nbsp;</p>

<p>Editor digital: …</p>

<p>ePub base r1.2</p>

«Autor» en autor.xhtml

<h1 class="oculto" title="Autor"></h1>

«Notas» en notas.xhtml

<h1>Notas</h1>

Si se desea, se pueden traducir también los nombres de los archivos .xhtml (opcional).

Guía para los distintos géneros y subgéneros

Para facilitar la organización de los libros tanto en nuestra web como en programas como Calibre, hemos desarrollado una guía de los distintos géneros y subgéneros disponibles para nuestros ePubs. Todos los libros deben estar catalogados como mínimo con un tipo, un género, y entre uno y cinco subgéneros (en los metadatos no debe incluirse el tipo).

Al colocar estos géneros y subgéneros en los metadatos hemos de respetar la grafía con que aparecen aquí pues cualquier pequeño cambio (como una mayúscula / minúscula) puede ser interpretado por el gestor de libros como una palabra distinta y, por tanto, colocarlo en un grupo diferente del que se pretendía.

En los libros en otros idiomas, se utilizarán estos mismos géneros, en castellano, por uniformidad.

Tipo «Ficción»

GÉNERO

Guion: Obra compuesta o adaptada para medios masivos (cine, televisión, radio, Internet).

Novela: Obra narrativa en prosa, extensa y compleja, de sucesos imaginados y parecidos a la realidad.

Poesía: Obra lírica, usualmente en verso, con fines estético-emocionales.

Publicaciones periódicas: Todas aquellas publicaciones que se alarguen por un período de varios años de forma continuada, tales como revistas, periódicos, etc.

Relato: Obra narrativa en prosa, de menor extensión que la novela. Puede ser corta (Cuento) o mediana (Relato propiamente dicho).

Teatro: Obra compuesta para ser representada en un escenario, ante público.

SUBGÉNERO

Aventuras: Narra sucesos fuera de lo común, a menudo en escenarios exóticos. Incluye Acción, Exploradores, Piratas, Viajeros, Western.

Bélico: Trata de campañas, batallas o guerras. Suele presentar con detalle estrategias militares (reales o verosímiles).

Ciencia ficción: Explora el impacto de posibles avances científicos, tecnológicos, sociales o culturales (presentes o futuros), sobre la sociedad o los individuos.

Didáctico: Con clara intención de dejar una enseñanza. Incluye Fábulas, Parábolas.

Drama: Narra hechos que conmueven al lector, usualmente desembocando en un final trágico. Incluye, por supuesto, Tragedia.

Erótico: Se relaciona directamente con la sensualidad y el sexo, presentándolos de forma implícita o explícita.

Fantástico: Utiliza la magia y otras formas sobrenaturales como un elemento primario del argumento, la temática o el ambiente. Incluye Mitología.

Filosófico: Una parte significativa de la obra se dedica a la filosofía discursiva (en temas como la función y el papel de la sociedad, el propósito de la vida, la ética o la moral, el papel del arte en la vida humana y el rol de la experiencia o la razón en el desarrollo del conocimiento). Incluye Novela de ideas.

Histórico: Ofrece una visión verosímil de una época histórica (preferiblemente lejana). Suele utilizar acontecimientos verídicos aunque los personajes principales sean inventados.

Humor: Usa el absurdo, en personajes o situaciones, para provocar la hilaridad. Incluye Comedia.

Infantil: Dirigido a los niños. Incluye Cuentos de hadas.

Interactivo: Exige una participación más activa del lector, que puede escoger varios «caminos» argumentales.

Intriga: Las acciones se ejecutan con inteligencia y astucia, y ocultan acontecimientos importantes para suscitar interés y tensión en el lector. Incluye Misterio, Suspense.

Juvenil: Dirigido a adolescentes y jóvenes.

Policial: Su móvil principal es la resolución de un enigma, generalmente criminal, mediante procesos mentales (como la deducción). Incluye Novela negra, Espionaje.

Psicológico: Enfatiza la caracterización interior de sus personajes, sus motivos, circunstancias y acción interna. Usa técnicas como flujo de conciencia o monólogo interior.

Realista: Apela a recursos pseudo documentales, principalmente para denunciar una situación injusta (social o individual). Incluye Costumbrismo, Narrativa social.

Romántico: Su tema primordial es el amor y las relaciones de pareja. (No se trata del movimiento Romanticismo de los siglos XVIII y XIX).

Sátira: A diferencia del mero humor, apela a la ironía y el sarcasmo, con propósito moralizador, lúdico o meramente burlesco. Incluye Parodia, Picaresca.

Terror: Busca provocar el espanto en el lector, frecuentemente a través de elementos paranormales. Incluye Gore, Gótico, Horror, Thriller.

Otros: De no ubicarse en ninguno de los subgéneros anteriores.

Tipo «No Ficción»

GÉNERO

Crónica: Texto con estructura esencialmente cronológica, que suele emplear recursos literarios o periodísticos.

Divulgación: Texto informativo, sin excesivo rigor metodológico, que interpreta y hace accesible el conocimiento científico al público general.

Ensayo: Texto que presenta un punto de vista personal y subjetivo, sin aparato documental, de manera libre y asistemática y con voluntad de estilo.

Publicaciones periódicas: Todas aquellas publicaciones que se alarguen por un período de varios años de forma continuada, tales como revistas, periódicos, etc.

Referencia: Texto con rigor académico/científico y estructura sistematizada, normalmente dividida en apartados o lecciones.

SUBGÉNERO

Arte (Arquitectura, Danza, Escultura, Música, Pintura…)

Autoayuda (Superación)

Ciencias exactas (Lógica, Matemática…)

Ciencias naturales (Astronomía, Biología, Geología, Geografía, Física, Química…)

Ciencias sociales (Administración, Antropología, Arqueología, Demografía, Derecho, Economía, Educación, Política, Sociología…). Excepciones, por popularidad: Historia, Psicología

Comunicación (Cine, Diseño gráfico, Espectáculo, Fotografía, Historieta, Lingüística, Periodismo, Publicidad, Televisión…)

Crítica y teoría literaria

Deportes y juegos

Diccionarios y enciclopedias

Espiritualidad (Esoterismo, Religión)

Filosofía

Historia

Hogar (Bricolaje, Cocina, Decoración, Jardinería, Mascotas…)

Humor

Idiomas

Manuales y cursos

Memorias (Autobiografía, Biografía, Cartas, Diarios…)

Padres e hijos

Psicología (Psiquiatría…). Excepciones: Autoayuda, Sexualidad, Padres e hijos

Salud y bienestar (Medicina, Nutrición, Terapias alternativas…)

Sexualidad

Tecnología (Electrónica, Industria, Informática, Telecomunicaciones…)

Viajes

Otros: de no ubicarse en ninguno de los subgéneros anteriores.

MAQUETANDO EL CONTENIDO

Capítulos y el archivo Section0001.xhtml

A continuación vamos a ver cómo hacer y numerar los diferentes capítulos de nuestro libro. Crear un nuevo archivo (capítulo) es tan sencillo como seguir estos pasos:

Ve a la barra lateral izquierda y haz clic derecho sobre la carpeta Text o sobre cualquier archivo .xhtml.

Tienes tres opciones, que te servirán según el origen del contenido:

Selecciona «Añadir fichero HTML en blanco» si deseas crear una hoja en blanco,

Selecciona «Añadir copia» si deseas crear un duplicado del archivo que estás seleccionando, para posteriormente modificarlo, o

Selecciona «Añadir Ficheros existentes» si quieres incorporar archivos .xhtml ya creados previamente y que tengas guardados en alguna carpeta de tu ordenador.

Los archivos se crearán incrementando un número al mayor existente con el nombre Section000n.xhtml. Es decir, si tenemos un archivo llamado Section0014.xhtml, nos creará un archivo llamado Section0015.xhtml. En principio, los archivos se pueden dejar con esos nombres, pero es aconsejable cambiarlos para que nos sea fácil saber qué contiene cada uno de ellos. Algo como cap1, cap2, etc., puede ayudarnos. No obstante, estos nombres no pueden llevar espacios, acentos ni caracteres extraños. Sigil nos permite renombrar los archivos, de uno en uno —una vez seleccionado el archivo, haciendo clic derecho, eligiendo la opción Renombrar—, o varios a la vez —si se pone de nombre «cap01», por ejemplo, los numerará como «cap01», «cap02», etc.—.

Veamos ahora las características principales de cada archivo «Section0001.xhtml»: En este «.xhtml» y los siguientes irá el texto de la obra y cada uno de ellos no debería de exceder los 300 kb, ya que si no el ebook no será visto correctamente en algunos lectores. Conseguir la información sobre el tamaño de los distintos ficheros que forman parte de nuestro ePub es fácil usando los informes de Sigil.

Cada capítulo debe estar en un archivo distinto. Cuando la obra no disponga de capítulos propiamente dichos y excedamos los tamaños máximos antes indicados, una solución, a la hora de subirlos a la página web, consiste en crear dos epub, uno con los archivos tal como nos queden una vez finalizada la edición y otro habiendo dividido los archivos para que cumplan los límites de tamaño indicados, siendo el epub principal aquel con mayor compatibilidad.

Todos los «Section» deben tener el «head», con el siguiente código:

<link href="../Styles/epl.css" rel="stylesheet" type="text/css" />

<link href="../Styles/style.css" rel="stylesheet" type="text/css" />

El primer enlace ha de ser siempre a la página de estilos epl.css, y el segundo será a la página style.css o a la que necesitemos para esa xhtml.

NINGÚN XHTML PUEDE QUEDAR VACÍO (un body sin contenido o únicamente con contenido oculto) pues de ser así puede producirse un error en algunos eReader que hará que se cierre el libro.

En este punto es recomendable tener instalado nuestro diccionario de ePubLibre en Sigil (consultar enlaces en el foro), ya que el corrector ortográfico nos ayudará a detectar y corregir errores de OCR. Otra alternativa es usar el corrector de Word. Es obligatorio pasar algún corrector ortográfico a todo el texto, ya que los errores de este tipo son muy evidentes y no ayudan en absoluto a conseguir un ePub de calidad.

Las diferentes partes de un libro pueden tener distinta estructura. El libro puede estar organizado en partes y estas en capítulos, por ejemplo. Además hay otras zonas del mismo que deben tenerse en cuenta. Esta dependencia jerárquica se determina con las etiquetas de encabezamiento de html, que deben figurar al principio de cada archivo de contenido.

Teniendo esto en cuenta, el ebook se organizará de la siguiente forma:

<h1> → Cubierta, título del libro, autor y notas (máxima jerarquía).

<h1> → Partes, Libro, Sección, etc. del libro o división superior. Si directamente están los capítulos, estos llevarán <h1>.

<h2, h3, …> → Partes subordinadas a lo anterior. Pueden ser capítulos u otra división menor.

Nunca se deben saltar estas etiquetas, siempre se debe empezar con h1, seguir con h2, y así consecutivamente. El salto de h1 a h3 directamente, por ejemplo, puede dar problemas en algunos lectores.

Este encabezamiento tiene la siguiente forma:

<h1>Capítulo 1</h1>

Capítulo 1

Si el texto que queremos que aparezca en el índice (TOC) es diferente del que se va a mostrar en la «Vista de libro», utilizaremos la propiedad «title», que contiene el texto que aparecerá en el índice. Es aconsejable su utilización siempre que nos encontremos en este caso.

<h1 title="Capítulo 1">*** CAPÍTULO PRIMERO ***</h1>

*** CAPÍTULO PRIMERO ***

El índice NUNCA debe modificarse directamente en el archivo toc.ncx

También se puede utilizar la clase "oculto" cuando por alguna razón no queramos que aparezca en la «Vista de libro», además el texto aparecerá sin margen superior.

style.css

.oculto { display:none; visibility:hidden; }

Section0001.xhtml

<h1 class="oculto">Capítulo 1</h1>

<p>Texto</p>

Capítulo 1

Texto

Si una sección no lleva encabezado (no hay título <h3>, por ejemplo) y queremos crear un margen superior, se debe usar la clase «saltoinicio» en el primer <p>:

<p class="saltoinicio">Y aquí todo el párrafo…</p>

Y aquí todo el párrafo…

Las implicaciones de esto en el índice las veremos cuando hablemos de ello (véase TOC) más adelante.

Si un capítulo lleva un título de dos líneas se puede usar:

<p>1.<br />

El saltamontes</p>

1.
El saltamontes

Para este mismo fin, podemos también usar una clase «subtitulo»:

style.css

.subtitulo { text-align:center; text-indent:0; font-size:1.4em; }

Section0001.xhtml

<h1>1.</h1>

<p class="subtitulo">El saltamontes</p>

Siempre hay que trabajar en Sigil usando la «VISTA DE CÓDIGO», ya que la edición en «Vista de libro» genera código que luego hay que limpiar.

Si quieres presentar tu candidatura, ten en cuenta que exigimos que nuestros ePubs estén limpios de código indeseado. Las candidaturas que se vea claramente que no han seguido esta norma es más difícil que sean revisadas. Nadie quiere revisar un ePub lleno de códigos extraños, principalmente porque dicho código no se puede simplemente eliminar. Ese código no se genera porque sí, sino que es el resultado de aplicar algún estilo: espaciados, negritas, cursivas, tamaño de la fuente… y que nosotros no teníamos definido como tal. Por lo que hay que saber qué es lo que querías hacer y reemplazarlo nosotros en función del que tengamos en esos momentos definido en la hoja de estilos, o incluso tendremos que crearlo… Como ves, complica mucho la vida a la hora de revisar.

Añadir y aplicar estilos CSS y etiquetas

Como ya hemos indicado, todo código CSS deberá colocarse en su archivo correspondiente. Y para aplicarlo en el texto, se indicará con «class»:

<p class="nombre-clase">

Si queremos que entre dos párrafos haya una separación mayor de la normal, lo único que tendremos que hacer es incluir en el segundo párrafo la clase .saltoXX.

El párrafo que dejará un espacio mayor empezará con

<p class="salto25">Texto del párrafo…</p>

si queremos que la separación sea de 2.5em. En la medición es conveniente utilizar la unidad «em» en lugar de la unidad «px». La unidad «em» es la medida de la letra M, lo cual quiere decir que cambia con el tamaño de la fuente en el lector, mientras que «px» es un píxel de pantalla, siempre igual, pero que variaría mucho en función de la resolución del dispositivo en que se visualice el ePub).

NOTA: Para definir una separación entre párrafos, se aconseja el uso de «em», ya que el cambio del tamaño de la letra puede hacer que no se muestre adecuadamente usando porcentajes. En cambio, para definir los márgenes laterales con respecto al borde de la pantalla, es preferible usar %, ya que esto asegura que el espacio se mantenga siempre igual, con respecto a un marco fijo.

Aunque, si es un cambio de escena, se aconseja el uso de las etiquetas semánticas, aplicando <hr/> de la siguiente forma:

<hr/>

<p>Texto del párrafo…</p>

Y si quisiéramos que el espacio fuera mayor, por ejemplo de 5em, nos veríamos obligados a definir una clase nueva. Solo tendríamos que escribir en el archivo style.css lo siguiente:

.salto50 { padding-top: 5em; }

y emplearlo de la misma forma que anteriormente.

Una pregunta que siempre nos surge cuando estamos editando es cuándo es conveniente crear una clase nueva en vez de incluir varias clases ya definidas en nuestra sentencia. Veamos un ejemplo.

En nuestro libro aparecen varias cartas, todas con su correspondiente nombre en la firma. Resolvemos incluir en la primera de ellas el siguiente código:

En el párrafo del nombre del remitente ponemos:

<p class="derecha cursiva salto25">Perico Palotes</p>.

Y el párrafo siguiente lo comenzamos con:

<p class="salto10">.

O colocando un <p>&nbsp;</p> antes del párrafo siguiente

Esto nos obliga a poner el mismo código en cada una de las firmas, con dos inconvenientes, uno estético, pues se repite código de manera innecesaria, y otro, la dificultad de modificarlo.

Supongamos que después de pasar el libro al lector vemos que es mejor que el primer salto sea «salto10» y que el segundo solo «salto05». Esto nos obligará a realizar estos cambios en cada una de las firmas, teniendo en cuenta que los cambios masivos son delicados.

En este caso, lo conveniente sería definir una nueva clase. En el archivo style.css escribiremos:

.firma { text-align:right; text-indent:0; font-style:italic; padding-top:2.5em; padding-bottom:1em; }

Una vez descubierta la necesidad de modificar los saltos, solo tendríamos que cambiar la asignación del valor de los «padding».

Los estilos CSS se pueden aplicar en principio a cualquier etiqueta. Por ejemplo, si ponemos

<i class="negrita">Texto</i>

o

<b class="cursiva">Texto</i>

Obtendremos exactamente lo mismo:

Texto

En el ePub base hay varias etiquetas cuya definición es la misma:

i, em, cite, dfn, .cursiva, .cursiva p {

    font-style: italic;

}

Y lógicamente hay dudas sobre cuándo usar cada una de ellas. Visualmente se puede utilizar cualquiera, aunque, si queremos tener corrección semántica y además, ayudar a quienes leen en braille, es mejor usar cada etiqueta para lo que fue diseñada:

Va con <i>

Los nombres científicos.

Notas musicales.

Los nombres de aviones, barcos, naves espaciales, trenes, etc.

Los nombres de las mascotas. Los nombres de mascotas que actúan como personajes deben ir en redonda (Pato Donald, Tom y Jerry, Rin Tin Tin, Mickey Mouse, Goofie, Ayudante de Santa). Los nombres de animales clásicos deben ir en redonda (Bucéfalo, Cerbero, Rocinante, Babieca, Platero).

Los sobrenombres, alias vulgares y apodos solo cuando acompañan al nombre propio.

Palabras, términos y expresiones en idiomas extranjeros no asimilados al castellano, incluidos los términos y locuciones latinas de uso poco habitual y nombres científicos de plantas, animales, etc. En las traducciones deben ir en cursiva las palabras o expresiones que en el original, en otro idioma, aparezcan en español (y que deberán llevar una nota al pie aclarándolo).

En las palabras o frases en idioma extranjero, se puede añadir a la etiqueta el código del idioma, lo que facilita también la lectura en braille.

<i xml:lang="en">palabras en inglés</i>

<i xml:lang="fr">palabras en francés</i>

Palabras o expresiones jergales, dialectales o intencionadamente mal escritas.

Neologismos como contranovela o blogósfera.

Palabras o expresiones usadas como metalenguaje.

Va con <cite>

Los títulos de libros (cómics, ensayo, narrativa, poesía, teatro, ya sean publicados o inéditos), periódicos, semanarios, revistas, enciclopedias, fascículos, etc. Igualmente las siglas correspondientes a los títulos de las publicaciones.

Los títulos de toda clase de manifestaciones artísticas (escultura, música, pintura, etc.).

Los títulos de películas y los programas de radio y televisión.

Van con <em>

Palabras o frases a las que el autor quiere dar un énfasis especial.

Van con <dfn>

Para definiciones. Se suele usar solo en la primera aparición de un término en el texto.

Van con class="cursiva" o con font-style:italic en el css

Todo aquello donde la cursiva sea meramente decorativa.

El fichero epl.css es intocable. Cualquier nueva clase o modificación de lo existente debe hacerse en styles.css.

Añadir notas al ebook

Las notas se utilizan para dirigir la lectura a un texto que aclara o amplía; en el texto origen normalmente aparecen como notas al pie o al final del libro. Para crearlas es necesario poner el número (llamada) con superíndice y enlace en el texto, y guardar la nota en sí en el archivo correspondiente (notas.xhtml).

Recuerda antes de desarrollar el procedimiento que siempre debemos trabajar en «Vista de código».

Si queremos crear notas en un libro, procederemos de la siguiente forma:

Las notas se deberán guardar en el archivo notas.xhtml. Si se examina, se verá que la plantilla tiene creadas dos notas de ejemplo y vamos a utilizar el código que en dicho archivo existe para anotar las nuestras.

Lo primero que hay que hacer es vaciar las notas de ejemplo y dejar el código limpio. Para evitar errores posteriores en aconsejable dejar una marca, tres asteriscos por ejemplo, donde deberá ir nuestro texto de las notas. La nota quedará así:

<div class="nota">

<p id="nt1"><sup>[1]</sup> *** <a href="../Text/Section0001.xhtml#rf1">&lt;&lt;</a></p>

</div>

Una vez que las notas del archivo notas.xhtml estén vacías, procedemos a copiar tantas como vayamos a crear en este archivo. Es conveniente hacerlo ahora, cuando las notas están vacías, por comodidad. Para ello, siempre en Vista de código, copiamos el código completo de una nota, desde la línea <div class="nota"> hasta la línea </div>, todo incluido, y pegamos justo antes de la línea de código </body>.

A continuación hay que numerar todas las notas creadas. Como tenemos ya hay dos, la 1 y la 2, la primera a modificar será la que ocupa el tercer lugar. Para ello sustituiremos los tres números iguales que lleva el código por el número 3. Quedará la nota así:

<div class="nota">

<p id="nt3"><sup>[3]</sup> *** <a href="../Text/Section0001.xhtml#rf3">&lt;&lt;</a></p>

</div>

y así hasta el final.

A continuación, procederemos a incluir el texto de la nota del ejemplo, la nota 1, en su correspondiente lugar. Para ello copiamos el texto de la nota, en nuestro ejemplo «Es un lugar imaginario de la Mancha», y lo pegamos en donde se encuentran los tres asteriscos. Nos quedará el asiento de la siguiente forma:

<div class="nota">

<p id="nt1"><sup>[1]</sup> Es un lugar imaginario de la Mancha. <a href="../Text/Section0001.xhtml#rf1">&lt;&lt;</a></p>

</div>

Hacemos lo mismo con todas nuestras notas.

A continuación debemos indicar donde va a ir el número de llamada correspondiente a cada llamada.

Si quisiéramos poner una nota en la palabra «Mancha» del Quijote se procederá de la siguiente forma:

En el texto, detrás y pegado a la palabra «Mancha» (dejaremos fuera siempre los signos de puntuación, comillas, paréntesis, etc. Los signos de exclamación e interrogación, también, a no ser que la nota abarque toda la frase, incluidos los signos indicados) se pondrá el siguiente código:

<p>En un lugar de la Mancha<a href="../Text/notas.xhtml#nt1" id="rf1"><sup>[1]</sup></a> de cuyo nombre no quiero acordarme…</p>

Donde el número que aparece tres veces, en este ejemplo el 1, indica el correspondiente a la nota de que se trata.

Seguidamente buscamos el lugar de la siguiente llamada y volvemos a copiar el código, tal como hicimos con la primera. Pegaremos:

<a href= "../Text/notas.xhtml#nt1" id="rf1"><sup>[1]</sup></a>

Procedemos a cambiar el 1 que aparece tres veces por el número 2, ya que se trata de la segunda llamada.

Y de igual forma ponemos todas las llamadas en su lugar.

Nos queda únicamente el enlazar en el código de la nota el nombre del archivo donde se encuentra la llamada a la nota.

En nuestro ejemplo el texto iría en el primer capítulo que bien podríamos haber llamado c01.xhtml. Este es el nombre que debemos poner en sustitución del que venía. En el código donde pone "../Text/Section0001.xhtml#rf1" cambiaremos Section0001.xhtml por el nombre de nuestro archivo y lo dejaremos como "../Text/c01.xhtml#rf1". El código definitivo de la nota nos quedará:

<div class="nota">

<p id="nt1"><sup>[1]</sup> Es un lugar imaginario de la Mancha. <a href="../Text/c01.xhtml#rf1">&lt;&lt;</a></p>

</div>

El número de la nota (en el ejemplo, el 1) aparece entre corchetes y enlazando a su nota: #rf1. En Vista de libro veremos la nota como un superíndice entre corchetes:

En un lugar de la Mancha[1] de cuyo nombre no quiero acordarme…

y la nota la veremos en el archivo notas.xhtml de la siguiente forma:

[1] Es un lugar imaginario de la Mancha. <<

NOTA: Es conveniente saber que si partimos un archivo en dos, las referencias a las notas del archivo notas.xhtml se adecuan de forma automática. Esto nos puede venir bien en algunos casos, ya que a veces es mejor trabajar con un archivo que contenga todos los capítulos y hacer la partición en los archivos correspondientes una vez enlazadas las notas, a tener que enlazar cada nota a su capítulo correspondiente.

A continuación conviene comprobar que las notas están correctamente ubicadas y enlazadas. En Vista de libro abrimos el archivo notas. Hacemos clic al final de la nota 1 y nos llevará a la parte del texto donde está su llamada. A continuación clic en la llamada y nos volverá a enviar al archivo notas.xhtml, a la nota 1. Pasamos a la nota 2 y hacemos clic al final de la nota, nos envía a su llamada, clic para ir a ver el contenido de la nota 2. Y así hasta revisar todas las notas.

Casos especiales

Cuando una nota vaya en un encabezado la llamada aparecerá en un tamaño excesivo. Para corregir este efecto, crearemos una clase en el archivo style.css con la fuente del tamaño adecuado:

.font05 { font-size:0.5em; }

Y en el archivo de texto pondremos lo siguiente:

<h1 title="Este es el título">ESTE ES EL TÍTULO<a href="../Text/notas.xhtml#nt1" id="rf1"><sup class="font05">[1]</sup></a></h1>

evitando así que el número con superíndice aparezca demasiado grande.

Las notas pueden ir agrupadas en un solo archivo o en varios, dependiendo del número y extensión de las notas. Para libros con muchas notas, te recomendamos usar algún sistema automático, tal y como se explica en el Tomo II: Herramientas útiles.

Finalmente, si deseas añadir tus propias anotaciones, asegúrate de indicarlas como «Nota del Editor Digital», colocando al final de la nota (N. del E. D.) o, si eres mujer, (N. de la E. D.). Si además eres el traductor del libro, puedes indicarlas como (N. del T.) o (N. de la T.).

Tabla de contenido (TOC)

La tabla de contenidos es el índice de nuestro libro, y nos permitirá navegar por él mostrando en forma de menú de árbol la ordenación que hayamos diseñado. Para ello, tendremos que asignar a cada elemento su estilo correspondiente como ya se indicó en el apartado específico de Lo que necesitas saber de Sigil.

Como vimos en el primer apartado de Maquetando el contenido (Capítulos), los distintos contenidos de un libro están jerarquizados desde el punto de vista del índice. Cuando lo generemos aparecerá reflejada esta jerarquía.

Si hemos usado correctamente las etiquetas <h1>, <h2>, <h3>, <h4>… entonces con solo darle al botón Generar índice de contenido (menú Herramientas → Índice de contenidos → Generar índice de contenidos) nos generará una TOC completa, que deberemos analizar para ver si corresponde a lo que pretendíamos.

Gracias a esto podemos hacernos una idea del resultado final, que es lo que cualquier lector tendrá a su disposición para navegar por nuestro ePub cuando lo consulte en su dispositivo.

Después de cualquier cambio significativo en el ePub, es recomendable actualizar la TOC.

En ciertos casos especiales, como ya hemos comentado, nos puede interesar que el texto que aparezca en la TOC sea distinto al título que aparece en el texto. Para conseguir esto, explicamos como usar la etiqueta «title»:

<h1 title="El saltamontes">1. EL SALTAMONTES</h1>

En este caso, en la TOC se mostrará «El saltamontes», en minúsculas; mientras que en el texto aparece en mayúsculas y con un «1.» delante.

Otra forma posible es hacer doble clic sobre la columna Entrada del índice, en el texto a modificar, escribimos lo que nos interese y ya tenemos la etiqueta «title» creada, si no existía, o modificada.

Cuando queramos que las distintas partes en que se divide un libro aparezcan en su índice, pero que no tengan ningún encabezamiento en el inicio del texto de estas, tenemos que tener en cuenta varias cosas. La forma de que no aparezca un encabezamiento es asignarle la clase «.oculto», de la siguiente forma:

<h1 class="oculto">8 de septiembre</h1>

o bien

<h1 class="oculto" title="8 de septiembre"/>

En estos dos casos el texto empezará sin ningún margen superior, pegado a la parte de arriba de la página.

Si queremos que exista un margen, a cualquiera de las formas anteriores habrá que añadir la clase «.saltoinicio» al primer párrafo.

Nos quedará como sigue:

<h1 class="oculto">8 de septiembre</h1>

<p class="saltoinicio">Texto del primer párrafo</p>

o bien

<h1 class="oculto" title="8 de septiembre"/>

<p class="saltoinicio">Texto de primer párrafo</p>

El texto aparecerá con un margen del 33%, el correspondiente a la clase «.saltoinicio».

Otra forma de conseguir esto, de forma más económica, es:

<h1 title="8 de septiembre"/>

El texto aparecerá con un margen del 25%, el mismo que los capítulos normales, que es el correspondiente a la definición de estilo para «h1» que hay en el style.css.

Cuando el inicio del capítulo sea mediante una imagen y queramos que esta guarde el margen que habitualmente tiene el inicio de capítulo, así como que aparezca en el índice, tendremos que recurrir a este último código.

Nuestro código tendrá la siguiente forma:

<h1 title="8 de septiembre"/>

<p class="ilustra"><img alt="" src="../Images/Fig-inicio-capitulo1.jpg" /></p>

En todos estos casos, en el índice aparecerá el texto:

Índice (TOC)
8 de septiembre

Hay que intentar preservar la correlación entre TOC y títulos, para que la estructura del ePub sea clara.

NUNCA modificar directamente el archivo toc.ncx. Además del riesgo de cometer algún error de trascendencia, al generar la TOC no se tienen en cuenta los cambios introducidos.

Código sucio y cómo limpiarlo

Como hemos comentado anteriormente, los ebook funcionan con etiquetas de HTML, pero hay que tener en cuenta que no todas las etiquetas válidas para páginas web lo son para los ebook.

Además, según vamos editando los ebook podemos introducir errores que pueden, incluso, imposibilitar su lectura en según que tipo de lectores.

Otras fuentes de código erróneo pueden ser el propio material a partir del cual creamos el ebook, otros ebook con edición defectuosa, páginas web, etc., y sobre todo si provienen de conversiones automáticas, por ejemplo con Calibre.

Está claro, por lo tanto, que tenemos que saber qué código no puede utilizarse y de qué forma podemos depurar nuestros archivos.

Hay algunas etiquetas HTML, válidas en otros ámbitos, páginas web, por ejemplo, con las que hay que tener precauciones, ya que pueden crear problemas en algunos lectores. Como es el caso de:

<style> y <etiqueta style="…">

Al hablar del CSS ya comentamos que no está permitido crear estilos en línea. Quiere decir esto que no debemos incluir ninguna sentencia del tipo:

<p style="color:sienna;margin-left:20em">Párrafo de color siena</p>

Tampoco está permitido incluir el estilo en el encabezado:

<head>

<style>…</style>

</head>

Ni tampoco las sentencias autogeneradas por Calibre.

Herramientas para detección de errores

Herramientas para detección de errores

En el propio Sigil, tenemos una herramienta, INFORMES, que puede ayudarnos a detectar clases de CSS erróneas. Esta herramienta se encuentra en el menú: Herramientas → Informes.

Esta herramienta nos da información de:

Ficheros HTML, donde podremos ver el tamaño de cada fichero y las faltas de ortografía.

Ficheros de imagen, donde encontraremos las imágenes que no se han utilizado (Con menú: Herramientas → Borrar imágenes sin usar, deberemos eliminarlas antes de publicar el libro) y que quizá pensábamos que sí lo habíamos hecho.

Ficheros CSS: Nos dice los archivos CSS que estamos utilizando. Deben existir al menos dos: epl.css, que es intocable, y styles.css, donde colocaremos nuestras clases personalizadas. Si además se va a incluir una página con el índice, también deberá incluirse sgc-toc.css.

Clases: Aquí encontrarás información muy relevante para detectar clases erróneas.

Clases en ficheros html: donde se indica las clases de que disponemos en el ebook y las utilizadas, de manera que podremos localizar las clases personalizadas que no hayamos usado y eliminarlas. Una manera rápida de hacerlo es con el menú: Herramientas → Borrar clases sin usar en hojas de estilos y dejando seleccionadas para eliminar solamente nuestras clases personalizadas que no hayamos utilizado.

Si observamos la figura anterior, veremos que la segunda clase tiene vacías las columnas «Selector aplicable» y «Encontrado en el fichero HTML». Eso nos indica que hay algún error en el ebook. Probablemente la clase no existe o está mal definida o llamada.

Para más información sobre la herramienta Informes de Sigil, consulta el apartado de los anexos dedicado a Informes en el TOMO 2.

Es conveniente pasar las EXPRESIONES REGULARES incluidas en el primer grupo, Limpieza de código, ya que detectan varios de estos problemas.

Aplicando los procedimientos explicados en el apartado VALIDANDO EL EBOOK es posible encontrar algún error que nos haya pasado desapercibido.

Se dispone en la comunidad de un BANCO DE PRUEBAS para asegurar la compatibilidad de cualquier código nuevo en todos los lectores. Aunque no se localicen errores aplicando todos los sistemas de detección de errores y todos los procedimientos de validación que se explican en este manual, no quiere decir que vaya a verse bien en todos los lectores. Por eso es importante que sigas los consejos de este Manual y que si tienes dudas hagas las consultas en el foro.

Ante cualquier código dudoso o nuevo, debe pasarse la prueba de código en los todos los lectores del banco de pruebas del foro.

CORRECCIÓN DEL TEXTO

Cómo revisar el texto para eliminar la mayor cantidad de errores ortotipográficos posibles.

Expresiones regulares

Una vez finalizada la maquetación del texto, llega el momento de revisarlo a fondo, tanto para librarlo de todas las posibles erratas de texto y de código que se puedan haber pasado por alto, como para hacer mejoras en algunos casos. Para este fin se dispone de una herramienta fascinante: las expresiones regulares (en adelante RegEx).

Cuando se usan por primera vez ya se experimenta el verdadero potencial de esta herramienta. A pesar de lo complejo que se ve el código y de todo el trabajo que hay detrás, a la hora de la verdad, son absolutamente sencillas de utilizar.

Qué son las RegEx

En plan técnico, la Wikipedia lo explica bastante bien:

Una expresión regular es una secuencia de caracteres que forma un patrón de búsqueda, principalmente utilizada para la búsqueda de patrones de cadenas de caracteres u operaciones de sustituciones. Por ejemplo, el grupo formado por las cadenas «Handel», «Händel» y «Haendel» se describe mediante el patrón:

H(a|ä|ae)ndel

En informática, las expresiones regulares proveen una manera muy flexible de buscar o reconocer cadenas de texto.

Dicho de un modo sencillo: las RegEx son una herramienta que permite buscar en el libro ya maquetado muchos de los errores que se dan frecuentemente. Y, a la vez, permiten de forma muy simple corregir esos errores y sustituirlos (si corresponde) por el texto correcto.

Esto se entiende mucho mejor cuando se utilizan. A continuación se van a dar los pasos a seguir.

Instalar las RegEx

En primer lugar deberás solicitar las RegEx al revisor de tu candidatura para que te las haga llegar. Esto es así debido a que un uso indiscriminado de las mismas provocarán más mal que bien en tu ePub, y es conveniente conocerlas y entenderlas antes de empezar a usarlas.

El archivo tiene la extensión «.ini» y es un fichero de texto que almacena todas las RegEx.

Una vez que las tengas, abre Sigil. Dentro del menú «Herramientas», pulsa «Búsquedas guardadas…». Luego pulsa con el botón derecho del ratón en cualquier parte de la ventana y elige la opción «Importar…».

Se selecciona el archivo «.ini» descargado y acepta.

Una vez cargadas, en esa misma ventana se pulsa abajo el botón «Save» para que queden guardadas en Sigil (la ventana no se cerrará, pero se guardarán para posteriores usos).

Se cierra la ventana con el botón «Close».

Usando las RegEx

Lo primero y absolutamente imprescindible es evitar «ser víctima del modo normal» (algo bastante habitual).

Para ello, y siempre con el libro maquetado en Sigil, se pulsa «Ctrl+F» para que aparezca el cuadro inferior de búsqueda (si no está abierto ya). Hay que asegurarse que la opción «Modo» no esté en «Normal» sino en «Expresión regular», y no esté en «Fichero actual» ni en «Ficheros seleccionados» sino en «Todos los ficheros HTML» (no hace falta explicar por qué).

Es importante el paso anterior, porque si no, las búsquedas no detectarán nada y se puede caer en el error de pensar que el libro carece de erratas.

Para usar las RegEx se abre de nuevo «Búsquedas guardadas…». Aparecerá la ventana con las RegEx importadas. Con las flechitas se van plegando / desplegando los grupos (resaltados en negrita) que contienen las entradas.

Para probar su funcionamiento se va a usar de ejemplo un grupo de entradas. Se selecciona el primer («0. Limpieza de código») y se pulsa el botón «Contar todos».

En la parte baja de la ventana (tanto en «Búsquedas guardadas» como en «Buscar y sustituir») aparecerá el mensaje «Coincidencias encontradas:» y el número de posibles erratas localizadas. Si no sale nada o aparece «Coincidencias encontradas: 0» pasa al siguiente grupo («1. Comillas "») hasta encontrar alguna búsqueda positiva.

Cuando aparecen resultados, la herramienta te está indicando el número de casos referentes a ese grupo que hay que revisar. Para ello, y siguiendo con el ejemplo del grupo 0, se van revisando una a una todas las entradas y en orden (es importante el orden de búsqueda). Es decir, «0.01», «0.02», «0.03», etc. y se pulsa «Buscar».

En las entradas donde no aparezcan resultados se continúa adelante. Pero si Sigil marca un punto concreto de un archivo concreto y lo resalta, se está señalando el texto a revisar. En el cuadro de texto «Buscar:» indica qué está buscando esa RegEx, y en «Sustituir:», la sustitución que se propone. En algunos casos la RegEx no dispone de una respuesta y se solicita que se introduzca la sustitución manualmente. Esto se indica con el texto «***MANUALMENTE***».

A menos que se tenga un nivel avanzado de las RegEx no se entenderá nada de los códigos, así que se pulsa el botón «Sustituir» (en el cuadro de búsqueda de Sigil o en la ventana «Búsquedas guardadas», es indiferente). Se observa el cambio que se realiza en el texto.

Si no es correcto, se pulsa en Sigil el icono de deshacer (la flecha amarilla girada hacia la izquierda) y se sigue buscando nuevas coincidencias. Si es correcto, vuelve a pulsar en «Buscar» (o, si se tiene seguridad, en «Sustituir/buscar») hasta que no haya resultados.

Periódicamente y por seguridad, hay que guardar la maquetación. Es conveniente validar antes de hacerlo para que Sigil no realice cambios automáticos en casos de error en el código.

A la hora de decidir si el cambio que proponen las RegEx es correcto o no, hay que tener en cuenta que todas están pensadas para ajustarse al estándar de calidad del Proyecto Scriptorum, a las normas de ortografía y gramática, al uso de códigos compatibles con la mayoría de los lectores electrónicos, etc. Así que, en principio, si las RegEx detectan un error, es muy probable que verdaderamente lo sea.

Y esto lleva a otra cuestión importante. Si las RegEx son tan buenas (y lo son), ¿por qué ir buscando una a una y, en cambio, no usar el botón «Sustituir todos» (que, efectivamente, sustituye todas las coincidencias encontradas sin ir una a una)?

Pues porque las RegEx son muy buenas, pero no dejan de ser una herramienta no humana. No toman decisiones en función de lo que encuentran. El único que sabe qué debe decir realmente el texto y cómo deben ser sus códigos en todos y cada uno de los miles de casos posibles es el editor.

NUNCA hay que hacer sustituciones globales y automáticas de ninguna de las RegEx: incluso en aquellas que parece evidente que pudiera hacerse, es preferible pecar de prudente que no arriesgarse a dejar las cosas peor de lo que estaban.

El qué y el por qué de cada RegEx

Con todo lo visto anteriormente es fácil aprender a usar las RegEx. Pero falta algo, y es saber qué hace cada una: qué busca cada una de ellas y qué cambio propone.

Al descargar el conjunto completo de las RegEx, se accede también a una guía explicativa.

En esa guía se encuentra el por qué de cada cosa, lo que es imprescindible para ir entendiendo lo que van haciendo. Comprender bien su estructura puede ayudarte a crear RegEx propias para los casos concretos que se te puedan presentar. En el foro de editores de ePL hay no pocas consultas de editores solicitando RegEx que les eviten tener que hacer manualmente cambios numerosísimos de algo, y no son pocos los editores que saben ayudarles creando una RegEx específica.

Recordando lo imprescindible

Comprobar el modo de sustitución («Expresión regular»).

No hacer reemplazos masivos; revisar caso a caso.

Entender qué hace cada RegEx.

No creer que se está perdiendo el tiempo al usarlas. Lo que se dedica a ellas es, en realidad, tiempo ganado.

Puedes encontrar una explicación más detallada sobre las RegEx y su funcionamiento en el Tomo II: Herramientas útiles.

Localización y solución de errores

En esta sección se verán diferentes estrategias para detectar (y por ende corregir) erratas ortotipográficas y otros errores frecuentes con los que nos encontramos al maquetar nuestro ePub.

Erratas ortográficas

Digitalización de un aporte

Si trabajas digitalizando un libro en papel: antes de pasar el OCR, se recomienda depurar las imágenes con ScanTailor para mejorar su calidad. Para el OCR va muy bien Abby FineReader.

Elección de una fuente digital

En internet hay acceso a múltiples libros en diferentes formatos. Es frecuente por lo tanto que te encuentres con diferentes versiones de un mismo libro. ¿Cuál es la que tiene mejor calidad? ¿Cómo elegir uno para empezar a maquetar?

Puedes utilizar programas como Beyond Compare, el Editor de Calibre u otros programas similares. Con ellos puedes comparar diferentes documentos, y ver en qué difieren, lo que permite identificar desde diferentes traducciones, fallos ortográficos y de OCR corregidos, o modificaciones libres que hayan podido realizar otros usuarios. Si dispones además del libro en papel, estas comprobaciones son mucho más sencillas de realizar, ya que te dirigen hacia puntos concretos del texto a comparar.

Preparación para comparar dos fuentes

Como los documentos pueden estar en diferente formato, la forma más sencilla de homogeneizarlos es convertirlos en txt (eso evita la comparación de etiquetas propias de HTML) y desde ahí a ePub si fuera necesario.

NOTA: para evitar que salten diferencias que no son estrictamente ortográficas, se puede complementar el método sustituyendo de forma masiva algunos caracteres, como por ejemplo pasando todas las comillas (angulares, inglesas y simples) a las comillas rectas equivalentes en ambos txt.

Desde un ePub (con Sigil)

Se fusionan todos los archivos xhtml de texto en uno solo. Para ello, se seleccionan en el «Explorador del libro» con el ratón el primer xhtml a unir, se mantiene pulsada la tecla de mayúsculas («Shift») y se utiliza la flecha abajo para seleccionar el resto de archivos. Luego se pulsa el botón derecho del ratón y en el menú desplegable se selecciona «unir».

Se pasa luego a «Vista de libro», y pulsando el botón derecho del ratón en el desplegable se elige «Seleccionar todo», se pulsa de nuevo en el botón derecho del ratón y se elige ahora «Copiar».

Se abre el Bloc de notas y se pega el texto.

Es recomendable trabajar sobre una copia del libro antes de fusionar los archivos, o bien señalar el inicio de cada uno con una marca de división automática para deshacer luego la fusión, lo que se puede hacer fácilmente con una RegEx diseñada al efecto:

Buscar:
<body>

Sustituir:
<body>
<hr class="sigil_split_marker"/>

Desde otros formatos

Desde un documento de texto (word, open office, winRAR, …): al guardar el archivo se elige «guardar como» y se selecciona txt.

Desde un pdf: elegir «guardar como» y seleccionar txt. Si no se dispone de esta opción, seleccionamos el texto, lo copiamos, y luego lo pegamos en el Bloc de notas.

Desde cualquier formato electrónico (mobi, azw3, …): con Calibre se convierte el libro utilizando como formato de salida txt.

Comparando dos fuentes

Beyond Compare (para Windows, Mac y Linux): http://www.scootersoftware.com/

Abrimos la aplicación, seleccionamos «Text Compare» y se abrirá una ventana en la que se indicará la ruta de acceso a cada uno de los archivos txt a comparar. Seleccionando «Diffs» se mostrarán únicamente las diferencias entre ambos documentos.

Editor de Calibre (para Windows, Mac y Linux): http://calibre-ebook.com/

Se instala a la vez que la biblioteca Calibre, aunque luego su uso puede ser independiente: accedemos a la carpeta donde se ha instalado Calibre, y en ella creamos un acceso directo de la aplicación «ebook-edit» que colocamos en donde deseemos (por ejemplo en el escritorio).

En la aplicación, abrimos el primer libro (en formato «epub»), luego desde el Menú Archivo seleccionamos «Comparar con otro libro», añadiendo la ruta de acceso al 2.º archivo (también en formato «epub»).

Trabajando en el aporte

Una vez que ya tenemos nuestro primer borrador del aporte a partir del documento fuente, procederemos a corregir las erratas detectadas por el método anterior. Como es muy difícil que se repita una errata en fuentes diferentes salvo que la misma proceda del original, el documento del que partimos ya estará muy depurado.

Para detectar otras erratas, disponemos en Sigil de varias herramientas que también utilizaremos.

Herramienta «Ortografía» de Sigil (menú Herramientas → Revisión de ortografía → Ortografía): te permitirá identificar palabras con errores ortográficos y también extranjerismos. Otra utilidad es que indica el número de veces que aparece una palabra.

Para que funcione correctamente, debes seleccionar el diccionario que se corresponda al idioma en el que está el aporte (para el español se recomienda el diccionario c2c que encontrarás en materiales para la candidatura).

Se puede combinar esta herramienta con «Búsqueda y sustitución» de Sigil, utilizando coincidencias exactas o expresiones regulares para sustituir un error que se repite muchas veces en lugar de ir uno por uno.

Buscar: | estabá
Sustituir: | estaba

Herramienta «Búsquedas Guardadas» de Sigil (menú Herramientas → Búsquedas guardadas): permite buscar expresiones regulares (RegEx) que se han guardado previamente. En la comunidad existen un conjunto de expresiones regulares desarrolladas para esta función que incluyen aspectos relativos a la ortografía: errores comunes de OCR, ajuste en la posición de las rayas, modificación de comillas rectas por comillas angulares, localización de minúsculas después de un punto, sustitución de «...» (3 puntos seguidos, por lo tanto 3 caracteres) por «…» (símbolo especial, por lo tanto un único carácter), sustitución de «&nbsp;» por un « » (espacio en blanco), etc.

Herramienta «Búsqueda y sustitución» de Sigil: nos permite localizar coincidencias exactas de texto o desarrollar expresiones regulares (RegEx) personalizadas.

Como ejemplo de coincidencia exacta: se puede utilizar para localizar erratas de OCR que no se detectan con la herramienta de «Ortografía» ni con las «Búsquedas guardadas» ya preestablecidas.

Buscar: | muías |  | La palabra «muías» puede ser correcta (2.º persona del singular del verbo muir) pero con frecuencia es un error de OCR.
Sustituir: | mulas

Como ejemplo de expresión regular personalizada: para poner en cursiva la expresión N. de… (Nota del autor(a) / del traductor(a) / del editor(a)) se podría utilizar la siguiente RegEx:

Buscar: | (?<!i>|em>)(\(N. de(.*?)\))
Sustituir: | <i>\1</i>

Corrección por lectura

Un ojo experimentado puede detectar cualquier errata que se haya escapado a los métodos anteriores. Cuando un libro está corregido por lectura, se puede pasar a «verificado».

NOTA: No es imprescindible la lectura antes de subir un aporte a la web, puesto que en ePubLibre se dispone de un sistema de notificación de erratas para ir mejorando los aportes en las sucesivas revisiones, con la colaboración de todos los usuarios de la web.

En caso de duda, se puede consultar el Tomo II: Herramientas útiles para las normas ortográficas más frecuentes.

Erratas tipográficas

Homogeneidad de estilos

Al maquetar el aporte conviene revisar los elementos comunes para darles el mismo aspecto: títulos, subtítulos, saltos de escena, etc. Para ello utilizaremos las clases personalizadas que hay que definir en style.css.

NOTA: Podemos ayudarnos con el «Editor de fragmentos», creando en él las clases que utilizamos combinadas con más frecuencia (o creando un grupo específico para el libro que estamos maquetando en ese momento y que podremos borrar cuando terminemos).

Saltos de escena

Se pueden mejorar comprobando no solo con la fuente digital utilizada, sino con otras fuentes digitales disponibles, incluyendo el libro en su idioma original, y si se dispone de él, del libro impreso en cualquiera de los dos idiomas.

Cursivas

Para minimizar la utilización errónea de cursivas, hay varios herramientas y métodos a nuestra disposición.

Enfatizados propios del autor

Aquí no queda más remedio que comparar con la fuente original, preferiblemente impresa. Si no se dispone de ella, se pueden comparar las diferentes fuentes digitales disponibles, o incluso con el libro en su idioma original.

Extranjerismos crudos

Dados los cambios de la RAE 2010, hay palabras que antes no se escribían en cursiva y ahora sí (el ejemplo más claro son algunas locuciones latinas, que ahora tienen carácter de extranjerismo crudo). Para revisar este aspecto, se utilizan dos herramientas:

Herramienta de «Ortografía» de Sigil (menú Herramientas → Revisión de ortografía → Ortografía): los extranjerismos crudos en su mayor parte no figuran en el diccionario que se está utilizando, por lo que son palabras que se van a detectar con esta utilidad.

Utilizando «Búsquedas guardadas» (menú Herramientas → Búsquedas guardadas): se dispone de expresiones regulares específicamente diseñadas para detectar los extranjerismos crudos y locuciones latinas que están recogidos en el diccionario de la RAE (etiquetados en el mismo como «voces extranjeras» / «voces latinas»). No los detecta todos, pero sí los más frecuentes, y admite modificaciones para ampliar la lista si se precisa.

A continuación, un ejemplo simplificado:

Buscar: | (?<!em>|i>)(miss|sir|lady)
Sustituir: | <i>\1</i>

Versalitas

Es obligatorio su uso en el caso de los números romanos cuando acompañan a un nombre que va en minúscula y recomendable en las siglas. Hay otras situaciones donde se aconseja utilizar versalitas (ver sección del TOMO 2), y también deberían mantenerse en cualquier otro caso en que así se utilicen en el original.

Podemos ayudarnos con un conjunto de expresiones regulares diseñadas para detectar los números romanos que están en minúscula y transformarlos en mayúsculas, y con otro conjunto de expresiones regulares diseñadas para transformar las palabras / frases en mayúscula a versalita (menú Herramientas → Búsquedas guardadas). Pero hay muchos casos en que estas mayúsculas se han perdido en la conversión de la fuente original a ePub, y las expresiones regulares no lo detectarán.

Caracteres especiales

Hay que sustituir las entidades del lenguaje HTML por sus caracteres especiales correspondientes e igualmente evitar el uso equivocado de algunos símbolos.

Uso incorrecto.

Uso de 3 puntos suspensivos seguidos (...). Hay que sustituir por el símbolo equivalente (…).

Uso de comillas rectas dobles (" "). Hay que sustituir por comillas angulares (« ») o comillas inglesas (“ ”), según proceda. La única excepción es cuando se utiliza para medidas angulares (segundos).

Uso de comillas rectas simples (' '). Hay que sustituir por comillas simples curvas (‘ ’). La única excepción es cuando se utiliza para medidas angulares (minutos).

Uso de apóstrofo recto ( ' ). Hay que sustituir por comilla simple ( ’ ).

Para indicar grados, hay que utilizar el símbolo de grado (°) y no la «o» volada (º).

En expresiones matemáticas para indicar restas o números negativos se utilizará el signo menos (−) y no la semirraya (–).

Entidades HTML (códigos) vs. símbolos: De estar disponible, se deben sustituir las entidades por su símbolo equivalente (utilizando la ventana emergente de los caracteres especiales de Sigil). Las de uso más frecuente se muestran en la siguiente tabla:

| Código | Símbolo
Puntos suspensivos (...) | &hellip; | …
Raya | &mdash; | —
Semirraya | &ndash; | –
Signo menos | &minus; | −
«a» volada | &ordf; | ª
«o» volada | &ordm; | º
Símbolo de grado | &deg; | °
Comillas angulares | &ldaquo; y &rdaquo; | « »
Comillas inglesas | &ldquo; y &rdquo; | “ ”
Comillas simples | &lsquo; y &rsquo; | ‘ ’

En las entidades HTML que no disponen de símbolo equivalente se mantiene el código. A modo de ejemplo:

| Código | En «Vista de libro»
Non-breaking space | &nbsp; |
Signos mayor y menor | &lt; y &gt; | < >

Antes de utilizar una entidad HTML hay que confirmar en el banco de pruebas su compatibilidad con los diferentes eReader (muchas de ellas dan problemas de visualización en algún lector).

Para su detección y sustitución, utilizaremos:

Herramienta «Informes…» de Sigil (menú Herramientas → Informes… → Caracteres en ficheros HTML): te permitirá identificar qué caracteres especiales se están utilizando, para valorar si su uso es adecuado (por ejemplo, tildes pertenecientes a otros idiomas, el uso del signo de grado «°», …).

Expresiones regulares, bien en «Búsqueda y sustitución» o bien en «Búsquedas guardadas» (menú Herramientas → Búsquedas guardadas): permitirá localizar en el texto los caracteres especiales detectados previamente y realizar las correcciones que procedan.

Errores de maquetación

Etiquetas sin cerrar

En HTML todas las etiquetas tienen que estar cerradas. Si además se utiliza XHTML, las mismas deben ir cerradas en orden inverso a como se abrieron.

NOTA: Para cerrar fácilmente una etiqueta, basta situar el cursor en el lugar en que le corresponde ir a la etiqueta de cierre y presionar «Ctrl + . (punto)» simultáneamente.

Para evitar perder el trabajo realizado, conviene ir comprobando paso a paso que las etiquetas están bien cerradas. Para ello puedes utilizar las siguientes estrategias:

Cambiando a «Vista de libro» en Sigil: si las etiquetas no están bien cerradas, saltará un aviso que nos indicará en qué consiste el error. El «dónde» a veces es equívoco, pues nos puede dirigir directamente al final del documento en lugar de a la línea donde falta la etiqueta de cierre.

Utilizando la pestaña de Previsualización en Sigil: en el momento en que hay una etiqueta mal cerrada, saltará un aviso donde se especifica en qué consiste el error y donde se localiza (la etiqueta mal cerrada se encontrará localizada en las líneas anteriores a la que nos señala, no necesariamente en esa).

Al guardar el documento, si las etiquetas no están correctamente utilizadas saltará un aviso.

NOTA: Es necesario haber configurado correctamente el programa: Edición / Preferencias / Limpiar código → seleccionar «Abrir» y «Guardar». Se recomienda además seleccionar «Recolocar con Tidy».

NUNCA permitir una CORRECCIÓN AUTOMÁTICA. Los resultados son imprevisibles, incluyendo la pérdida de texto.

El fichero se ha guardado con errores, por lo que es imperativo corregirlos lo antes posible y volver a guardar. Una forma de detectar donde está el error es visualizar cada uno de los archivos xhtml del ePub hasta encontrarlo (bien en «Vista de libro» o bien con la previsualización), y utilizar la información del aviso para localizar el fallo.

Si por algún motivo dejamos la corrección para otro momento y cerramos el archivo, hay que tener la precaución al volver a abrirlo de NO permitir la corrección automática que nos vuelve a ofrecer.

Simplificación del código

Eliminar código innecesario

Cuando se utilizan fuentes digitales encontradas en internet o se realizan conversiones de formato utilizando programas como Calibre, verás que aparece gran cantidad de código innecesario, que hay que revisar y simplificar, adaptándolo en lo posible a las clases ya definidas en el archivo style.css del ePub Base, y en el resto de los casos creando las clases personalizadas correspondientes.

El siguiente es un ejemplo de un ePub generado por Calibre:

style.css

.calibre6 { font-size: 1.66667em; font-style: normal; font-weight: bold; line-height: 1.2; text-align: left; }

.calibre7 { color: inherit; cursor: inherit; line-height: 1.2; text-decoration: inherit; }

.t1 { font-size: 0.85em; line-height: 1.2; }

.calibre8 { display: block; line-height: 1.2; }

Section0001.xhtml

<h1 class="calibre6" id="calibre_toc_1"><a class="calibre7" id="TOC_id501653"></a><a class="calibre7" id="TOC_id501808"></a> P<span class="t1">RIMERA PARTE</span><br class="calibre8" />

Las centellas vuelan hacia el cielo<br class="calibre8" /></h1>

Eliminando el código innecesario, nos quedaríamos únicamente con la clase «.calibre6», que vamos a redefinir como «.parte», dejando únicamente las características que no estén ya definidas por defecto para la etiqueta <h1> en el ePub Base:

style.css

.parte { font-size:1.66em; text-indent:0; text-align:left; margin-top:1em; }

Section0001.xhtml

<h1 class="parte">P<small>RIMERA PARTE</small><br />

Las centellas vuelan hacia el cielo</h1>

Agrupar clases y / o etiquetas

Con frecuencia es posible simplificar código agrupando etiquetas o clases, de la siguiente manera:

Agrupar varios <p> que comparten una misma clase en un <div>.

<p class="cursiva">Lorem ipsum…</p>

<p class="cursiva">Lorem ipsum…</p>

<p class="cursiva">Lorem ipsum…</p>

<div class="cursiva">

<p>Lorem ipsum…</p>

<p>Lorem ipsum…</p>

<p>Lorem ipsum…</p>

</div>

Si la característica de la clase no es heredable, hay que definir el comportamiento de <p> en style.css.

Añadir la característica como clase en <p> cuando afecta a toda la frase:

<p><span class="azul">Lorem ipsum<span></p>

<p><ins>Lorem ipsum<ins></p>

<p class="azul">Lorem ipsum</p>

<p class="subrayado">Lorem ipsum</p>

Añadir la característica como clase en otra <etiqueta> cuando afecta al mismo contenido:

<p>Lorem <i><span class="azul">ipsum<span></i> dolor sit amet…</p>

<p>Lorem <i class="azul">ipsum</i> dolor sit amet…</p>

Crear una nueva clase cuando se repite muchas veces una misma combinación de clases:

<p class="cita cursiva versalita">Lorem ipsum</p>

<p class="carta">Lorem ipsum</p>

Estilos personales

Propiedades no heredables

Algunas propiedades no son heredables, por lo que deberemos definir también el comportamiento de los subelementos que contendrán (<p>, <img>, …).

Fíjate por ejemplo en la siguiente clase:

style.css

.banner { margin:1.5em 12%; padding:0.5em 1em; text-align:center; text-indent:0; border:2px solid black; border-left:none; border-right:none; }

.banner p { text-align:center; text-indent:0; }

Section0001.xhtml

<div class="banner">

<p>En un lugar de la Mancha</p>

<p>de cuyo nombre no quiero acordarme</p>

<div>

En un lugar de la Mancha

de cuyo nombre no quiero acordarme

Clases no utilizadas

Al maquetar un aporte es habitual que tengas que crear clases nuevas para conseguir efectos específicos.

Para facilitar la búsqueda posterior de estas clases entre las ya definidas del ePub Base, es recomendable iniciarlas con un mismo código personal, por ejemplo un número o una letra (evita los guiones porque darán falsos positivos con las RegEx).

En el proceso de maquetación no es infrecuente que se creen clases que luego no se utilizan. Disponemos de una herramienta en Sigil que nos detecta estas situaciones, para poder borrar estas clases: Menú Herramientas → Informes… → Clases en ficheros CSS.

Nótese la diferencia entre una clase no utilizada («.xseccion») y una clase utilizada en un <div> en lugar de en <p> («.xletterizda»).

Clases no definidas

Menú Herramientas → Informes… → Clases en ficheros HTML.

También puede ocurrir que utilices una clase que aún no has definido en style.css, y que por error quede sin definir (por poner un ejemplo, identificas los pie de foto como «class="xpie"», para definir a posteriori las características: tipo de letra, tamaño, márgenes, …). Se localizan fácilmente con la herramienta «Informes…» de Sigil.

Enlaces a notas

Se debe comprobar que los enlaces (links) funcionan adecuadamente. Esto se puede realizar de forma manual (uno por uno) o con la herramienta correspondiente en Sigil: Menú Herramientas → Informes… → Enlaces. Se comprueba la correspondencia de n.º en todos los campos de cada línea, y de texto en cada columna (rf, nt, [ ], <<). Debido a la estructura de las notas de EPL, se pueden diferenciar dos bloques:

Section.xhtml

ID | Texto | Fichero destino | ID destino | Texto destino | Fichero dest. del dest. | ID dest. del dest.
rf1 | [1] | notas.xhtml | nt1 |  |  |
rf2 | [2] | notas.xhtml | nt2 |  |  |

notas.xhtml

ID | Texto | Fichero destino | ID destino | Texto destino | Fichero dest. del dest. | ID dest. del dest.
| << | Section.xhtml | rf1 | [1] | notas.xhtml | nt1
| << | Section.xhtml | rf2 | [2] | notas.xhtml | nt2

Imágenes no utilizadas

Al finalizar la maquetación de nuestro aporte, es conveniente borrar las imágenes no utilizadas, para aligerar el tamaño del ePub. Para identificarlas utilizaremos la siguiente herramienta de Sigil: Menú menú Herramientas → Borrar ficheros sin usar. La herramienta nos muestra las que no se están utilizando, y permite seleccionar / deseleccionar las imágenes antes de proceder a su borrado, por si finalmente deseamos utilizarlas.

Validador de Sigil (FlightCrew)

Esta herramienta nos informa de errores estructurales en el ePub. En el propio mensaje de error encontramos las claves para solucionarlos, además de indicarnos la localización de los mismos.

Por ejemplo:

OEBPS/Text/Section0001.xhtml | 33 | no character data is allowed by content model

Nos localiza un error en Section0001, en la línea 33. Lo que nos indica el error es que entre las etiquetas <blockquote> (content model) no puede ir el texto (character data), por lo que debe añadirse la etiqueta <p>.

29| <blockquote>

31| Texto de prueba

33| </blockquote>

29| <blockquote>

31| <p>Texto de prueba</p>

33| </blockquote>

Validador de IDPF (ePubCheck)

Al igual que el anterior, detecta errores estructurales en el ePub, y el mensaje que nos devuelve nos indica dónde y en qué consiste el error.

NOTA: Solo admite archivos de 10 Mb, por lo que si nuestro aporte lo excede, se recomienda usar la versión offline de ePubChecker cuyo enlace está disponible en el hilo de materiales del foro de candidaturas a editor.

Errores en el estándar EPL

Antes de finalizar nuestra maquetación, conviene comprobar de nuevo que se cumple el estándar de EPL. Dado que son aspectos que se han tratado en detalle en otras partes del manual, aquí solo los enumeraremos a modo de recordatorio:

En content.opf: asegurarse de que el UUID no coincide con el del ePub Base.

content.opf

<dc:identifier id="BookId" opf:scheme="UUID">urn:uuid:00000000-0000-0000-0000-000000000000</dc:identifier>

En style.css: Eliminar los estilos no utilizados (opcional).

HTML: Comprobar que están en formato XHTML y que ninguno supera los 300 kb (Herramientas → Informes… → Ficheros HTML).

NOTA: Solo se puede subir un ePub con xhtml de > 300 kb como ePub alternativo (r1.0a), siendo obligatorio subir también el ePub estándar con xhtml de de <= 300 kb como r1.0.

Notas: Confirmar que siguen el formato establecido en EPL.

Capítulo08.xhtml

<p>En este texto hay una nota aclaratoria<a href="../Text/notas.xhtml#nt1" id="rf1"><sup>[1]</sup></a>.</p>

notas.xhtml

<p id="nt1" ><sup>[1]</sup> Nota explicativa. <a href="../Text/Capitulo08.xhtml#rf1">&lt;&lt;</a></p>

Metadatos: Confirmar que se han rellenado los campos obligatorios, con especial atención al escribir correctamente el género y subgénero. Si el aporte pertenece a una serie, confirmar que se han añadido los campos específicos en content.opf.

content.opf

<meta name="calibre:series" content="Nombre de la saga" />

<meta name="calibre:series_index" content="Número" />

Páginas fijas: Si se ha modificado el código, comprobar que los cambios realizados estén permitidos (cubierta, sinopsis, título, info, autor y notas).

N.º de revisión (titulo.xhtml): Confirmar que se ha modificado el dato si procede.

Fecha de actualización (titulo.xhtml): Actualizar el dato.

Regenerar la TOC al finalizar todas las modificaciones.

Pasar los validadores: «FlightCrew» de Sigil y «ePubCheck» de IDPF detectan errores estructurales que deben ser corregidos; ePLValidator detecta errores en el estándar de EPL (hay que revisarlos detalladamente, sin olvidar que puede haber falsos positivos).

Si se detectan errores, tras su corrección es conveniente repasar de nuevo las secciones que se hayan visto modificadas de esta lista y los últimos 4 pasos (n.º de revisión, fecha de actualización, regenerar TOC y validadores).

Números de revisión

El cambio en el número de revisión indica que un aporte de la web ha sido modificado, bien en la maquetación, bien por correcciones de erratas o por cambio en el nombre del archivo. No se modificará el n.º de revisión en cambio si lo único que se hace es cambiar el magnet-link por problemas de descarga, sin tocar el aporte.

Se modifica el número de revisión SIEMPRE al subir un APORTE MODIFICADO.

Normas para modificar el número de revisión

Para editores

El número de revisión inicial al subir un aporte por primera vez será r1.0.

Los siguientes números serán renombrados incrementando un decimal (r1.1, r1.2, r1.3, …). Cuando se alcance el r1.9, el siguiente número será r2.0. Nunca podrá tener más de un decimal, por incompatibilidad técnica con otras herramientas de la web.

En el caso de que el cambio sea radical (añadido de ilustraciones, notas, y situaciones similares), se permite saltar directamente al siguiente número entero. Por ejemplo, de r1.4 a r2.0.

Hay casos donde se suben simultáneamente a la web dos ePub: al ePub alternativo que incumple el estándar (por contener xhtml de > 300 kb, por incluir etiquetas no soportadas por ePub2 o por cualquier otra circunstancia) se añadirá una «a» al final: r1.0a, r1.1a, …

Para candidatos a editor

Durante la candidatura cada vez que se suba un enlace para su revisión hay que cambiar el número de revisión.

Se iniciará en r0.1, y se irá aumentando progresivamente (r0.1, r0.2, r0.3…). En caso de ser necesario, pasará a tener dos decimales (r0.10, r0.11…).

El ePLValidator dará error cuando se usan dos decimales (r0.10 y superiores). Es un mensaje que se puede obviar durante la candidatura, puesto que no se va a subir con esa numeración a la web.

Dónde modificar el número de revisión

Se debe modificar tanto en el aporte como en la ficha del libro (esto último no aplicable a la candidatura).

En el aporte: En titulo.xhtml, modificar el campo correspondiente (no confundir con el campo similar en info.xhtml, que indica la revisión del ePub Base que se está utilizando como plantilla).

En la ficha de la web

Publicación inicial: en «Datos de esta edición», en «Estado», se selecciona «disponible». Se añade el magnet-link y al guardar la ficha automáticamente aparece el aporte en la web en «Novedades».

Actualización del aporte: en «Datos de esta edición», en «Revisión», se modifica el n.º de la revisión y se marca «Actualización». Se elimina el magnet-link antiguo y se añade el nuevo. Al guardar la ficha el aporte aparece en la web en «Actualizaciones». Se agradece si además en la ficha del libro se añade una nota donde se resuman los cambios de la nueva revisión.

En los metadatos

Siga las instrucciones como se indica en la sección El Book-Id y los metadatos.

VALIDANDO EL EPUB

Generalidades

Una herramienta útil para conseguir el objetivo de alta calidad en nuestros aportes es la validación.

Validar un ePub consiste en analizar sus componentes para ver si son conformes con los estándares. Como esta tarea no puede hacerse «a mano», utilizaremos distintas herramientas especializadas en ese trabajo.

Previo al proceso de validación propiamente dicho realizamos dos tareas que podrían incluirse en lo que llamamos «validación»:

Por un lado está la experiencia y el buen hacer del editor. A medida que aprendemos a maquetar y ganamos experiencia vamos detectando errores típicos a medida que los cometemos, corrigiéndolos sobre la marcha. Esto parece una verdad de Perogrullo, pero esta parte de la validación será cada vez más importante en cada aporte nuevo que maquetemos.

Por otro lado está la corrección automática de Sigil, desconocida por los editores noveles y cuyo comportamiento es, a veces, desconcertante. Profundizaremos un poco más en esto.

En la opción Preferencias del menú Edición de Sigil (tecla rápida: F5) encontramos el cuadro de diálogo que se ve en la imagen: corrección automática del código fuente al abrir y al guardar.

Esta utilidad elimina todo el código inútil del libro, pero en ocasiones puede borrar parte del texto, por ejemplo si se queda una etiqueta mal escrita puede que se borre todo lo que contiene.

Para evitar que nos desaparezca información sin que nos demos cuenta (Sigil no da ningún mensaje de aviso), muchos editores trabajan con la vista previa (tecla rápida: F10) siempre abierta, pues cuando hay una etiqueta mal formada se produce un mensaje de error en la vista previa que no se ve de otra forma:

En la imagen se puede ver cómo aparece el error al olvidarnos de cerrar la etiqueta.

Especial mención hay que hacer en este momento a las etiquetas personales. Aunque es de esperar que funcionen correctamente si están bien definidas, e incluso Sigil las representa adecuadamente, son borradas en cuanto se activa la corrección automática.

Bueno, hemos creado un ePub cuidando de no cometer ningún error, Sigil ha limpiado todo lo que cree que no debe estar presente, pero aún no podemos estar seguros de que el ePub se va a ver correctamente en los distintos lectores, para asegurarnos de que nada se nos ha pasado buscaremos la ayuda de aplicaciones especializadas en validar los ePub:

FlightCrew.

ePubChecker.

ePLValidator.

El uso de estos validadores es obligatorio para los editores de EPL. No basta usar uno de ellos, hay que usarlos todos pues se complementan, aunque coincidan en algunos aspectos, hay otros muchos en los que difieren y se puede dar el caso en que uno o dos de ellos dan su conformidad mientras que el restante indica un error que hay que solucionar.

Veámoslos con más detalle.

FlightCrew

FlightCrew es, normalmente, el primer validador que usamos, la razón es que está integrado en Sigil y actúa sobre el ePub que esté abierto en ese momento.

Su integración en Sigil tiene sus ventajas:

Un solo clic: Al actuar sobre el ePub activo basta con hacer clic en el botón de validación y todo se realiza automáticamente.

Localización de errores: Si el error está localizado en una sola línea, al hacer doble clic sobre la línea del error, Sigil nos situará directamente sobre la línea que lo produce.

Corrección: Como estamos validando el ePub activo, podemos corregir los errores sin tener que cambiar de ventana, todo está a la vista.

Para iniciar la validación del ePub activo podemos usar una de estas tres formas:

Usar la opción Validar ePub del menú Herramientas.

Usar el botón de validación (un check verde que aparece a la derecha, junto al botón de ortografía).

Usar la tecla rápida: F7.

Como se ve en la imagen, lo mejor que nos puede pasar es que no haya ningún problema, quiere decir que, al menos en los asuntos que FlightCrew controla, nuestro ePub está correcto.

Pero se pueden dar situaciones en las que aparezcan errores, hemos recopilado una lista de errores con sus correspondientes posibles soluciones que se puede consultar en el apartado «Códigos de error».

Epubcheck

ePubCheck es un buen complemento del FlightCrew y digo complemento porque ambos detectan cosas distintas, aunque coinciden en muchos errores típicos.

La peculiaridad de ePubCheck es que podemos usarlo online a través del EPUBValidator de la página validator.idpf.org:

Basta con pulsar en Examinar, se abrirá un cuadro de diálogo para buscar el ePub en nuestro disco duro, aceptamos y luego pulsamos en Validate, tras un instante nos dará el informe.

Tiene dos limitaciones:

Debemos disponer de conexión a Internet para poder usarlo.

El ePub no puede pesar más de 10Mb, así que los libros con muchas ilustraciones no pueden usar este método.

Otra peculiaridad de este validador es que también existe en versión offline.

Si necesitamos validar libros con mucho peso o no disponemos de una conexión constante a Internet, podemos descargar alguna de las dos versiones offline que hay disponibles:

epubcheck-3.0.1.jar: es una aplicación java que se puede usar en la línea de comandos (los usuarios de Windows deben escribir: java -jar "rutacompleta1\epubcheck-3.0.1\epubcheck-3.0.1.jar" "rutacompleta2\nombredellibro.epub"). El manejo de la línea de comandos puede ser tedioso y complicado, el uso de archivos por lotes puede ser una ayuda.

EPUB-Checker: se trata de un ejecutable con interfaz gráfica y un funcionamiento muy similar a la página de idpf.

Las tres versiones usan el mismo motor (epubcheck, versión 3.0.1) y, por tanto, dan el mismo resultado. Elegir una u otra va a depender de las preferencias de cada editor.

Hemos recopilado una lista de errores con sus correspondientes posibles soluciones que se puede consultar en el apartado «Códigos de error».

ePLValidator

El ePLValidator es un validador hecho por y para EPL, así que su especialidad es validar la parte del ePub específica de nuestros libros, es decir, lo correspondiente al ePub Base y al estándar de calidad, aunque también revisa algunos aspectos generales como los otros validadores.

Está disponible en versión multiplataforma (necesita Python) y en ejecutable compilado para Windows. Ambas funcionan exactamente igual.

Para usar el ePLValidator solo tenemos que ejecutar la aplicación, nos aparece un cuadro de diálogo donde seleccionar el archivo a validar y pulsamos aceptar, a continuación nos sale el informe.

Con respecto a los anteriores validadores comentados, el ePLValidator tiene dos peculiaridades:

Por un lado, es el único que puede analizar varios archivos. En el cuadro donde seleccionamos el archivo a analizar se pueden seleccionar varios y el ePLValidator nos mostrará el informe de cada uno de ellos de forma consecutiva.

Por otro lado, es el único que incorpora una versión que corrige los errores de forma automática (ejecutaremos ePLValidator_manual para que no se realicen correcciones automáticas o ePLValidator_auto para que se corrijan). Por supuesto, no todos los errores son susceptibles de ser solucionados de forma automática, en la lista de errores que se puede consultar más adelante se indica cuáles de ellos se pueden solucionar automáticamente.

Hemos recopilado una lista de errores con sus correspondientes posibles soluciones que se puede consultar en el apartado «Códigos de error».

Errores solucionados automáticamente

Como hemos explicado, ePLValidator dispone de una versión automática que corrige algunos de los errores que detecta. Esos errores son:

Los relacionados con el Book-Id, pues el ePLValidator incorpora un generador de códigos UUID y lo coloca en el lugar adecuado, ahorrándole al editor tener que entrar en alguna página de internet que lo genere.

Los relacionados con la desaparición del archivo com.apple.ibooks.display.xml, de presencia obligatoria. Si no está presente, se genera de forma automática.

Los relacionados con los conceptos de los archivos incluidos en el ePub (especialmente respecto al concepto Portada), colocando los faltantes y eliminando los sobrantes.

Los relacionados con la presencia de archivos que no deberían estar, pues los borra de forma automática.

Solución especial al error «your opf file was broken»

En ciertas ocasiones, al cambiar el Book-Id o rellenar las calibre_series, es decir, al modificar el archivo content.opf, el usuario borra un < o > de más.

Sigil trata de reconstruirlo, añadiendo el mensaje 'Your OPF file was broken…', y, aunque la mayoría de veces lo consigue (solo agrega innecesarios «xmlns="http://www.idpf.org/2007/opf"» en las líneas siguientes), también puede arruinarlo completamente.

No deben aplicarse soluciones automáticas. El proceso recomendado es:

Exportar xhtml, imágenes y fuentes (clic derecho, Guardar como), exceptuando cubierta.xhtml (pues su código no cambia).

En un ePub Base «limpio», borrar todos los xhtml e imágenes (clic derecho, Borrar), exceptuando cubierta.xhtml.

Importar los elementos del paso 1 (clic derecho, Añadir ficheros existentes). Verificar que el orden de las secciones fijas sea correcto.

Rellenar metadatos, Book-Id y calibre_series en el nuevo content.opf con cuidado.

Si el aporte está en otro idioma, cambiar el término equivalente <h1 class="cubierta" title="Cubierta">.

Finalmente, volver a pasar las validaciones.

Solución especial al error «fecha de publicación original faltante»

La fecha de publicación original es obligatoria.

Un ejemplo de este problema es cuando tenemos que añadir fechas remotas en Sigil. Una sugerencia de cómo hacerlo:

- En la página info: solo el año, con a. C. / d. C. opcional (se permite enmarcado con <span class="nosep">, con &nbsp; intermedio, o sin nada).

- En content.opf: rellenar manualmente campo «publication» (año-mes-día) con ceros delante (hasta cuatro caracteres), sin signo negativo.

Ahora pasa correctamente la validación de Sigil y epubchecker.

Ejemplos

info.xhtml

<p>Tito Maccio Plauto, 254 a.&nbsp;C.</p>

content.opf

<dc:date opf:event="publication">0254-01-01</dc:date>

Correcto, el ePLValidator dará OK.

info.xhtml

<p>Cayo Petronio Arbitro, 60 d.&nbsp;C.</p>

content.opf

<dc:date opf:event="publication">0060-01-01</dc:date>

Correcto, el ePLValidator dará error (falso positivo)**.

**Los años de solo dos dígitos (primer siglo a. C. o d. C.) no se han incluido, pues no hay forma de diferenciarlos de días o meses (casos más frecuentes).

Afortunadamente, su aparición es menor.

Solución especial al error «archivo innecesario»

El archivo que se indica no se usa en el ePub, dejarlo solo incrementa su peso, así que debemos borrarlo o, en su caso, averiguar por qué no se usa y modificar el código para que se use como debiera.

Este error se corrige automáticamente, borrándose los archivos, cuando se valida con la versión auto.

Un caso habitual de esto es «calibre_bookmarks.txt», lo genera el Visor de Calibre, cuando se tiene activada la opción Preferencias, General, Recordar la página actual al salir. Aunque viene así por defecto, es recomendable desactivarla permanentemente.

Códigos de error

Flight Crew

A continuación os pongo una lista de los errores que se pueden presentar (lamentablemente solo están disponibles en inglés, aunque la versión compilada en Sigil está traducida, el FlightCrew no) con alguna sugerencia de solución:

All OK.

El mensaje más deseado: todo está bien.

Error.

Error genérico (sin especificar).

The epub file is not a valid ZIP archive.

Los archivos .epub son en realidad archivos comprimidos .zip. Pues el nuestro está roto y FlightCrew no puede abrirlo, hay que recuperar la última copia de seguridad.

The META-INF/container.xml file was not found.

No se encuentra el archivo de metadatos, algo grave le ha pasado a nuestro libro, hay que recuperar la última copia de seguridad.

An OPF file is not listed as a <rootfile>.

No hay un punto raíz en la estructura de archivos, una vez más a recuperar la última copia de seguridad.

The specified OPF file \"%1%\" does not exist.

El archivo indicado no existe. Habrá que comprobar si debe existir o no para recuperarlo o eliminarlo de la lista de contenido.

Bytes 30-60 of your epub file are invalid. This means that one or more of the following rules are not satisfied:\n

1. There needs to be a \"mimetype\" file in the root folder.\n

2. Its content needs to be *exactly* the ASCII string \"application/epub+zip\".\n

3. It needs to be the first file in the epub zip archive.\n

4. It needs to be uncompressed.

La cabecera del archivo .epub (es decir, del .zip) no es correcta por alguna razón, probablemente de las que aparecen en la lista. Todas difíciles de solucionar, es fácil que tengamos que buscar la última copia de seguridad.

XML syntax error.The <%1%> element is missing.

Falta algo o está mal escrito en XML en el elemento que se indica. Si se sabe lo que falta o está mal, podrá corregirse.

There needs to be one and only one <%1%> element.

El elemento indicado debe ser único y hay más de uno, hay que corregir y eliminar los demás. Esto puede aparecer por ejemplo si se coloca más de una etiqueta body en un mismo archivo .xhtml.

The <%1%> element is not an allowed child of the <%2%> element.

El primer elemento no puede anidarse dentro del segundo.

The \"%1%\" attribute is not an allowed attribute of the <%2%> element.

El atributo especificado no es válido para el elemento indicado. En muchos casos esto lo ignoran los reproductores, pero es conveniente localizarlos y eliminarlos.

The required attribute \"%1%\" is missing from the <%2%> element.

Hay un atributo obligatorio que no se localiza. Hay que encontrarlo y colocarlo en su sitio.

An element with ID value \"%1%\" already exists in the document.

Se ha colocado dos elementos con el mismo identificador en el mismo archivo .xhtml. Esto puede ser especialmente contraproducente en el caso de las notas o sus puntos de retorno pues hará que no funcionen. Hay que localizar la duplicidad y corregirla.

An ID value of \"%1%\" is not a valid value for an ID.

Se ha colocado un identificador no válido en el punto que se indica. Para que funcione hay que corregirlo.

The file declares the use of the \"%1%\" encoding, but only UTF-8 and UTF-16 are allowed.

La codificación de caracteres declarada en la cabecera del archivo .xhtml no coincide con los caracteres usados. Este error es difícil de encontrar si usamos correctamente el ePub Base.

The file declares the use of UTF-8 or UTF-16, but the bytestream of the file’s contents does not match either encoding.

Error similar al anterior.

The <package> element is not the root element.

El elemento indicado no es el elemento raíz, aunque esté identificado como tal. Error en la estructura del ePub. Si usamos el ePub Base adecuadamente no debe aparecer nunca.

The <itemref> element’s \"idref\" attribute is pointing to an <item> with id=\"%1%\" which does not exist in the <manifest>.

Hay un enlace hacia un punto con una identificación que no existe.

The <spine> element’s \"toc\" attribute is pointing to an <item> with id=\"%1%\" which does not exist in the <manifest>.

Hay una referencia en la TOC a un archivo .xhtml que no existe. La solución es muy sencilla: regenerar la TOC.

The <item> element’s \"linear\" attribute has value \"%1%\", but only \"yes\" and \"no\" are allowed.

Se ha utilizado un valor distinto de sí o no en un atributo del tipo boolenao (los llamados valores lógicos).

The <item> element’s \"media-type\" attribute has value \"%1%\", but the file’s media type is \"%2%\.

Se ha definido mal el tipo de archivo que se incluye. Hay que mirar bien el tipo de archivo de que se trate y definirlo correctamente o, en su caso, sustituir el archivo dañado.

The <reference> element’s \"type\" attribute has value \"%1%\" which is not an OPF-specified value. Either use a predefined type or start your type with \"other.\.

Se ha usado un tipo de archivo no predefinido en la inclusión de un archivo, los tipos de archivo válidos han de escribirse correctamente.

The <date> element’s value is \"%1%\", which is not a valid date format.

Se ha escrito una fecha con un formato incorrecto.

The <item> element’s \"href\" attribute value is \"%1%\", which is not a valid URI.

Se ha escrito un link de forma incorrecta.

The <item> element’s \"href\" attribute value is \"%1%\", which contains a fragment identifier.

El link especificado se ha escrito de forma incompleta.

The <item> element’s \"href\" attribute points to file \"%1%\" which does not exist.

El link especificado apunta a un archivo que no existe, hay que corregirlo o incluir el archivo olvidado en su caso.

There is no <item> element in the <manifest> that has the NCX mimetype (\"application/x-dtbncx+xml\"). The use of an NCX is mandatory in EPUB.

No se encuentra el archivo NCX, obligatorio en los ePub2 (y prohibidos en los ePub3). Dado que no tenemos acceso a este archivo de forma directa, lo más probable es que el ePub en el que estamos trabajando sea un ePub3, esté roto o hallamos trasteado donde no se debe. Probablemente la solución pasa por buscar la última copia de seguridad.

This <content> element’s \"src\" attribute value is \"%1%\", but that file does not exist.

Falta el archivo indicado. Habrá que corregir la referencia o restaurar el archivo perdido.

Warning.

Advertencia genérica. No se trata de un error, pero sí de algo que debemos mirar y corregir si es posible.

This resource is present in the OPF <manifest>, but it’s not reachable (it’s unused).

Hay un archivo en nuestro ePub que no se usa, es conveniente borrarlo para quitarle peso o bien comprobar dónde debería usarse y no se hace.

Non-ASCII characters were detected in this filename. While valid, it is recommended to only use ASCII characters in filenames.

Hay un archivo que incluye un carácter que, sin ser prohibido, no pertenece al juego de caracteres ASCII, lo que puede dar problemas, por lo que se recomienda que se sustituya por otro carácter adecuado.

class="salto05">The corresponding schema constraints were not satisfied.

No se dispone de explicación.

The <itemref> element’s \"idref\" attribute has value \"%1%\", but that value is already in use in a previous <itemref>.

No se dispone de explicación.

The <package> element’s \"unique-identifier\" attribute is pointing to an <identifier> with id=\"%1%\" which does not exist in the <metadata>.

No se dispone de explicación.

The <package> element’s \"version\" attribute value needs to be \"%1%\", but is \"%2%\".

No se dispone de explicación.

The \"role\" value \"%1%\" is not a registered MARC value. Either use a valid MARC relator or start your relator with \"oth.\".

No se dispone de explicación.

The <item> element’s \"href\" attribute value is \"%1%\" which is already in use in a previous <item>.

No se dispone de explicación.

The <item> element has a \"required-modules\" attribute but doesn’t have a \"required-namespace\" attribute.

No se dispone de explicación.

This OPS document is reachable but not present in the OPF <spine>. \"Reachable\" means that a reference of some kind that points to this resource exists in the epub.

No se dispone de explicación.

This resource is reachable but not present in the OPF <manifest>. \"Reachable\" means that a reference of some kind that points to this resource exists in the epub.

No se dispone de explicación.

This <content> element’s \"src\" attribute value is \"%1%\", but an element with an ID the fragment is referring to does not exist in that file.

No se dispone de explicación.

The file specifies an incorrect DTD. The correct public ID for the DTD is \"" ) + XHTML11_PUBLIC_ID + "\", while the correct system ID is \"" + XHTML11_SYSTEM_ID + "\". Do note that using a DTD is optional; but if used, it must be correct.

No se dispone de explicación.

ePubCheck

Conseguir una lista de errores y soluciones no ha sido fácil en este caso, veamos algunos, gentileza de la manzana:

Errores de archivo encontrado que no aparece en el manifiesto o de falta de recurso con referencia.

Los errores de archivo que no aparece en el manifiesto y de falta de recurso con referencia indican el mismo problema, pero a la inversa. A continuación aparecen los errores que podrían aparecer en la entrega.

Se ha encontrado un archivo que no aparece en el manifiesto.

El error de archivo encontrado que no aparece en el manifiesto indica que el ePub contiene archivos que no aparecen en el elemento <manifiesto> de tu OPF, un archivo de la carpeta OEBPS. Si tu archivo no está en el <manifiesto>, es imposible confirmar que debe aparecer en el libro.

Falta recurso con referencia.

El error de falta de recurso con referencia indica que en el ePub falta un archivo del <manifiesto> de OPF.

Para resolver este problema, asegúrate de que todos los archivos de tu ePub también están en el <manifiesto> de OPF:

Errores de atributos.

Los atributos añaden información o modifican las propiedades o contenido de un elemento de HTML. Puedes introducir atributos en la etiqueta de un elemento después del nombre del elemento. Los nombres de atributos van seguidos de «=» y un valor correspondiente (como alt="los tres ositos miran a ricitos de oro"). En este ejemplo, img es el elemento y src y alt son los atributos:

<img src="imagenes/ositos.jpg" alt="los tres ositos miran a ricitos de oro"/>

El atributo src define la URL de la imagen que quieres incrustar en la página HTML.

El atributo alt define el texto alternativo para su accesibilidad.

Aunque puedes usar atributos estándar con la mayoría de elementos HTML, solo puedes utilizar algunos atributos para modificar determinados elementos. Si hay problemas con los elementos, podrían producirse estos errores en la entrega.

Si utilizas un atributo no válido para un elemento específico, se produce un error de atributo erróneo. Esto podría suceder si se omite el espacio de nombres o si el atributo no puede modificar el elemento al que se aplica. Para resolver el problema, sustituye el atributo no válido por otro que sí sea compatible con el elemento.

Errores de elementos.

Un elemento es un componente básico de HTML que determina la estructura. Los elementos se indican entre paréntesis angulares (< >) y están formados por una etiqueta inicial y otra final. Por ejemplo, un párrafo se define mediante una etiqueta de inicio <p> y otra final </p>. Si hay problemas con los elementos, podrías ver estos errores en el resultado.

Elemento desconocido.

El error de elemento desconocido indica que estás utilizando un elemento HTML no permitido. No todos los elementos HTML son compatibles en XHTML. Por ejemplo, <font> no está permitido. Puedes utilizar CSS en lugar de HTML para añadir estilo a tu libro.

Elemento no permitido.

Algunos elementos que suelen estar permitidos no lo están en determinados contextos.

Elemento no finalizado.

El error de elemento no finalizado indica uno de estos problemas en el archivo EPUB: un elemento XHTML no tiene etiqueta de cierre o un elemento XHTML tiene una etiqueta de cierre incorrecta.

Asegúrate de que todas las etiquetas de cierre tienen el formato correcto, como </div>.

ePLValidator

Respecto del ePLValidator hemos de tener en cuenta que es un programa en continua adaptación a las necesidades de la comunidad ePL, por lo que aparecen nuevas versiones constantemente. Una de las cosas que cambia en cada versión suele ser la lista de errores, con nuevas incorporaciones y con ligeras modificaciones de los existentes. Además, al estar agrupados los errores por tipo, la aparición de uno nuevo suele provocar el cambio de numeración en los siguientes, por eso es recomendable buscarlos por el texto del error y no por su número.

En la lista que se muestra a continuación pueden encontrarse referencias a las correcciones realizadas por la versión auto del ePLValidator. Esto sólo es válido hasta la versión 1.18 pues la actual 1.19 a eliminado esa versión y no realiza correcciones automáticas.

Por otra parte, algunos de los mensajes se han marcado con la palabra Obsoleto para indicar que, si se valida un epub con la plantilla 2.0 (la actual) no es probable que nos pueda aparecer.

Errores

Veamos a continuación los errores que puede darnos ePLValidator y las posibles soluciones que harán que desaparezcan:

Atención, no se pueden comprobar los archivos basura, guarde el epub con otro nombre para eliminarlos si los hubiera.

Por desgracia, Sigil tiene un sistema extraño para trabajar con los epub que consiste en mantener tres copias simultáneas y aplicando las tareas a cada una de ellas según lo que se quiera hacer. Los ficheros basura solo se pueden encontrar en una de esas copias y Sigil no proporciona a los plugins información sobre dónde se encuentra almacenada dentro del sistema operativo. Para poder localizar los ficheros basura, el ePLValidator incluye una utilidad que busca el epub original dentro del disco de nuestro equipo basándose en una utilidad de los sistemas operativos: archivos recientes, pero su manejo desde el plugin no es cien por cien seguro, habiendo casos en los que no es posible localizarlo, en esos casos se muestra este error, que no nos está indicando que haya ficheros basura, sino que el ePLValidator no puede comprobar si están o no.

La solución sugerida (guardar con otro nombre), por desgracia, solo es efectiva en algunos casos. Es más efectivo cerrar Sigil, cambiar de carpeta el epub realizando una copia con el sistema operativo y luego volver a abrirlo con Sigil y validarlo. Aunque la solución más segura, totalmente segura, es usar la versión independiente de ePLValidator (bien la compilada para windows, bien ejecutar directamente el plugin con python.

Afortunadamente, estas dificultades han llegado al equipo de desarrollo de Sigil y, a partir de la versión 0.9.10, se ha habilitado un método seguro para proporcionar la dirección del epub de origen a los plugins.

Carácter no permitido en el nombre de identificador.

Los identificadores usados en el epub para localizar puntos concretos dentro del texto necesitan que estén compuestos por letras, mayúsculas o minúsculas, números y algunos pocos símbolos (guión normal y bajo). Colocar otra clase de símbolo puede hacer que los distintos validadores den diferentes mensajes de error, aunque se ha comprobado que pueden ser un poco confusos, por eso se añade este que, aunque redundante, resulta más claro.

Código sucio (%s).

Entre los paréntesis se indica el texto o código inadecuado que se haya localizado en el texto del epub. Ha de eliminarse o cambiarse por el adecuado.

Concepto sin traducir: %s --> %s.

El Base 2.0 permite el uso de todos los tipos de conceptos disponibles en el estándar epub (anteriormente sólo se permitía el uso de los conceptos portada y cubierta), pero se da la circunstancia de que la herramienta principal que usamos, Sigil, usa en las descripciones de estos conceptos el idioma que tenga establecido como idioma del interfaz, ignorando el idioma del epub. Este mensaje nos avisa de que debemos cambiarlo al idioma del epub. Advertencia: distintas versiones de Sigil usan distintas descripciones para un mismo concepto en algunos casos, lo cual puede llevar a mensajes de este tipo aunque la descripción esté en el idioma adecuado, pero no coincide con la esperada.

Definición de fuente incrustada sin referencia a un fichero de fuente tipográfica.

Se ha definido una fuente en la hoja de estilos, pero no se ha indicado qué fichero de fuentes contiene la fuente usada. Esto solo se puede hacer con las fuentes indicadas en ePub Base: sans, monospace, etc.

El estilo %s no dispone del carácter %s.

La clase indicada, que hace referencia a una fuente incrustada no puede representar el carácter indicado porque la fuente a la que está asociada no lo ha definido. Para mayor comodidad, se indica entre paréntesis el código decimal del carácter que, por cierto, puede que no sea representado o lo sea de forma extraña si la fuente con la que se representa el texto en pantalla tampoco lo contiene, de ahí la utilidad del código que nos facilitará la localización del carácter que sea con ayuda de los informes de Sigil.

El valor en metadatos de %s (%s) no coincide con el de%s (%s).

Al darle categoría de metadato al ePLID y al número de revisión es posible que se nos olvide modificarlos en los metadatos después de cambiarlos en los lugares correspondientes del epub. Este mensaje nos recuerda que hay que cambiarlos también en los metadatos.

Encontrado enlace (%s) sin destino.

El enlace mostrado entre paréntesis no lleva a ningún lado. Habría que estudiar si lo hemos escrito mal o si se nos ha olvidado incluir el id al que debe llevar en el lugar deseado.

ERROR 01: Archivo content.opf con errores ('Your OPF file was broken'). Es necesario recrear el aporte.

En ciertas ocasiones, al cambiar el BookId o rellenar las calibre_series, es decir, al modificar el archivo content.opf, el usuario borra un < o > de más.

Sigil trata de reconstruirlo, añadiendo el mensaje «Your OPF file was broken…», y, aunque la mayoría de veces lo consigue (solo agrega innecesarios xmlns="http://www.idpf.org/2007/opf" en las líneas siguientes), también puede arruinarlo completamente.

ERROR 02: Metadatos faltantes: %s.

Faltan los metadatos que se indican. La solución es ponerlos (para no cometer errores quizá sea conveniente copiarlos del ePub Base).

ERROR 03: Metadatos vacíos: %s.

Aparece el metadato indicado, pero no se han introducido datos. Solución: hay que completar los metadatos obligatorios o eliminar la línea del metadato no obligatorio del que no se dispongan datos.

ERROR 04: Metadatos repetidos: %s.

Hay dos líneas en el content.opf con el mismo metadato. La solución es dejar uno solo e incluir los datos necesarios todos en la misma línea.

ERROR 05: Descripción en metadatos (%s) coincide con ePub base. Debe cambiarse en cada aporte.

El ePub Base es un ePub como otro cualquiera y tiene sus metadatos completados. Este error nos indica que alguno de ellos no se ha completado con los datos específicos de nuestro libro, sino que hemos dejado los que lleva el ePub Base, la solución es editarlos y colocar los propios de nuestro libro.

ERROR 06: Idioma en metadatos (%s) no es uno de los aceptados actualmente.

El metadato idioma se ha completado erróneamente. Es muy frecuente encontrar esto cuando ponemos como idioma “es-es” (español de España), pues lo correcto es poner “es” (español).

ERROR 07: Editorial (%s) incorrecta. Debe ser ePubLibre (respetando las mayúsculas).

El metadato correspondiente a la editorial está limitado a un solo contenido: “ePubLibre”. Algún editor despistado cambia esto por alguna de las editoriales que han publicado anteriormente el mismo libro, provocando el error.

ERROR 08: Título interno difiere entre content.opf y toc. Debe regenerarse esta antes de guardar el aporte.

El título del libro lo colocamos en varios sitios (archivo titulo.xhtml, metadatos,…) el ePLValidator comprueba que lo hemos escrito de la misma forma en los sitios adecuados. Cualquier pequeña variación (una tilde, un espacio de más o de menos,…) hace que no sean exactamente iguales y se produzca este error.

ERROR 09: BookId (%s) coincide con ePub base. Debe cambiarse en cada aporte.

En los metadatos colocamos un código de identificación distinto para cada libro. Este error nos indica que hemos dejado el propio del ePub Base (ojo, que no avisa si se ha dejado el de otro libro distinto).

Este error se corrige automáticamente, generándose uno válido, cuando se valida con la versión auto.

ERROR 10: BookId vacío.

Hemos borrado el metadato correspondiente al BookId, que es obligatorio. La solución más sencilla es copiar la línea correspondiente del ePub Base y luego modificar el número generando uno nuevo para nuestro libro.

Este error se corrige automáticamente, generándose uno válido, cuando se valida con la versión auto.

ERROR 11: BookId debe ser de tipo UUID. Obsoleto

El formato de los BookId está estandarizado internacionalmente, no podemos escribir lo que nos parezca adecuado, hay que generarlo con la aplicación adecuada. Este error indica que el BookId de nuestro libro no cumple con el estándar, hay que sustituirlo por uno adecuado.

Este error se corrige automáticamente, generándose uno válido, cuando se valida con la versión auto.

ERROR 12: Formato incorrecto de BookId (%s).

Error similar al anterior.

Este error se corrige automáticamente, generándose uno válido, cuando se valida con la versión auto.

ERROR 13: BookId difiere entre content.opf y toc. Debe regenerarse esta antes de guardar el aporte.

Si modificamos los metadatos y guardamos los cambios antes de regenerar la TOC se produce este tipo de errores. La solución es regenerarla antes de guardar.

Este error se corrige automáticamente, generándose uno válido, cuando se valida con la versión auto.

ERROR 14: Archivo 'style.css' renombrado o no encontrado.

El archivo style.css forma parte del ePub Base y es de uso obligatorio. Si usamos otro distinto salta este error para indicárnoslo. La solución es usar el style.css que viene en el ePub Base y poner en él todos nuestros estilos personalizados.

Si usamos el Base 2.0 este mensaje no hace referencia a style.css sino a epl.css que es la hoja de estilos que contiene la parte obligatoria de los estilos.

ERROR 15: Encontrado más de un archivo CSS. Obsoleto

Si incluimos más de un archivo de hoja de estilos nos saltará este error. Como en el caso anterior, la solución es usar solo el archivo style.css proporcionado por el ePub Base e incluir en él todo el código que necesitemos.

ERROR 16: Primera sección de la CSS ('ESTILOS GLOBALES Y DE SECCIONES FIJAS') no es la aprobada del ePub base.

Se ha modificado una parte del archivo style.css que no es modificable. La solución es poner las modificaciones en la parte final (estilos personales), aunque hay que tener en cuenta que no podemos modificar los estilos protegidos a menos que pasen antes por el banco de pruebas.

Para la plantilla 2.0, este mensaje se refiere a la hoja epl.css que es la que no debe modificarse y la solución consiste en dejarla tal como estaba originalmente y colocar todas las modificaciones en la hoja style.css o cualquier otra que estemos usando.

ERROR 17: Género faltante o erróneo.

El metadato materia debe contener el género y el subgénero de nuestro libro separados por una coma y un espacio (“Género, Subgénero”), además ambos han de pertenecer a la lista aprobada de géneros y subgéneros. Este error nos está indicando que el género no es correcto, hay que cambiarlo.

ERROR 18: Subgénero faltante o erróneo.

Este error es idéntico al anterior, pero referido al subgénero.

ERROR 19: Géneros o subgéneros repetidos: %s.

El género o subgénero indicado está repetido en los metadatos, hay que eliminar la duplicidad.

ERROR 20: Uso de tipo innecesario (%s).

No es necesario indicar Ficción o No ficción.

ERROR 21: Uso de género o subgénero no aprobado (%s).

El género o subgénero indicados no corresponde a la lista aprobada.

ERROR 22: Uso de géneros de %s en libro de %s.

Se ha colocado un género de la lista de No ficción en un libro calificado de Ficción o viceversa. Hemos de cambiarlo por uno de la lista adecuada.

ERROR 23: Uso de subgéneros de %s en libro de %s.

Se ha colocado un subgénero de la lista de No ficción en un libro calificado de Ficción o viceversa. Hemos de cambiarlo por uno de la lista adecuada.

ERROR 24: Uso simultáneo de géneros de Ficción y No ficción.

Género y subgénero se han tomado de listas distintas, han de coincidir.

ERROR 25: Título en %s (%s) coincide con ePub base. Debe cambiarse en cada aporte.

El título encontrado donde se indica es el del ePub Base, hemos de colocar el de nuestro libro.

ERROR 26: Título no encontrado en %s.

No se ha encontrado el título del libro en el lugar indicado (alguno de los obligatorios: metadatos, archivo titulo.xhtml).

ERROR 27: Título %s (%s) difiere de %s (%s).

El título que aparece en los lugares que se indica no son exactamente iguales y deben serlo.

ERROR 28: %s en %s (%s) coincide con ePub base. Debe cambiarse en cada aporte.

El texto indicado corresponde al ePub Base, hay que colocar el correspondiente a nuestro libro.

ERROR 29: Autor no encontrado en %s.

No se encuentra el autor del libro en el sitio que se indica, donde debería aparecer obligatoriamente.

ERROR 30: Autor en %s (%s) difiere de %s (%s).

El autor que se ha puesto en los sitios que se indican (donde debe aparecer obligatoriamente) no se ha escrito de forma idéntica, deben coincidir.

ERROR 31: Traductor encontrado en %s (%s) pero faltante en %s.

Se ha encontrado el nombre del traductor de la obra en alguno de los sitios donde debe aparecer, pero no en otro. Debe aparecer en los sitios adecuados, escrito siempre de la misma forma.

ERROR 32: Traductor en metadatos (%s) difiere de página info (%s).

El nombre del traductor que aparece en los metadatos no coincide con el que aparece en la página info. Han de ser idénticos.

ERROR 33: File-as [Ordenar como] de %s (%s) coincide con ePub base. Debe cambiarse en cada aporte.

El nombre del autor o traductor en formato Apellidos, Nombre (la forma de ordenarlo alfabéticamente) no se ha modificado, dejando el del ePub Base. Hay que poner el correspondiente a nuestro libro.

ERROR 34: File-as [Ordenar como] faltante para %s (%s).

El nombre que se indica (autor, traductor) no se ha puesto en la forma Apellidos, Nombre, preparado para la ordenación alfabética.

ERROR 35: File-as [Ordenar como] de %s (%s) parece incorrecto al compararlo con metadatos (%s).

Se ha colocado el nombre para ordenación alfabética, pero parece no estar correcto, hay que comprobarlo.

ERROR 36: File-as [Ordenar como] de %s incorrecto. Falta coma de separación.

No hay coma de separación entre los apellidos y el nombre, hay que ponerla en el sitio adecuado.

ERROR 37: La notación aprobada para varios %ses es 'AA. VV.'. Debe corregirse en %s.

Si nuestro libro ha sido escrito por varios autores, el nombre del autor es “AA. VV.”, si lo escribimos de otra forma saltará este error.

ERROR 38: %s en metadatos (%s) añadido con rol de %s.

Ha habido una confusión con el rol indicado en metadatos para autores, colaboradores o traductores. Hay que editar los metadatos para corregirlo.

ERROR 39: Tamaño de archivo interno (%s) excede límite de 300 Kb.

El tamaño de cada archivo que forma parte de nuestros libros no puede superar los 300Kb pues ello hará que funcione con lentitud o incluso que no funcione en absoluto en algunos de los lectores. La solución dependerá de qué tipo de archivo se trate. Si es un capítulo demasiado extenso podemos partirlo en varios capítulos; si se trata de una imagen demasiado grande, podemos reducirla con algún programa de manejo de imágenes.

ERROR 40: Tamaño de imagen de cubierta %s incorrecto. Debe estar entre 600 x 900 px y 1200 x 1800 px en razón de 2 x 3.

El tamaño de la imagen de portada está regulado: 600 x 900 píxeles como mínimo y 1200 x 1800 píxeles como máximo, manteniendo siempre una relación de 2 x 3 entre la anchura y la altura de la imagen. Las imágenes que no cumplan estos requisitos no son adecuadas para usarlas de portada y han de ser sustituidas por otras correctas.

ERROR 41: Error al procesar imagen (%s). Debe revisarse.

El ePLValidator no ha podido analizar la imagen que se indica. Puede ser porque esté en un formato raro o porque el archivo se haya corrompido. Debemos revisarlo y corregirlo.

ERROR 42: Imagen faltante (%s).

Nuestro libro hace referencia a una imagen que no se encuentra. O eliminamos la referencia o incluimos el archivo.

ERROR 43: Imagen (%s) parece coincidir con ePub base. Debe cambiarse en cada aporte.

El ePub Base incluye una imagen para la portada y otra para el autor que debemos cambiar por las propias de nuestro libro, si no se hace aparecerá este error.

ERROR 44: Imagen (%s) no es la aprobada del ePub base.

El ePub Base también incluye algunas imágenes correspondientes al logo y a la imagen corporativa que son de uso obligatorio. Si sustituimos alguna de ellas aparecerá este error.

ERROR 45: Ancho de imagen %s (%s px) sobrepasa límite permitido (600).

La imagen que se indica está situada en un lugar donde se limita el alto permitido, hay que reducirla.

ERROR 46: Alto de imagen %s (%s px) sobrepasa límite recomendado (400).

La imagen que se indica está situada en un lugar donde se limita el ancho permitido, hay que reducirla.

ERROR 47: Probable imagen de autor (%s) encontrada sin %sdicha página.

Nuestro libro incorpora una imagen del autor, pero se ha borrado el archivo autor.xhtml.

ERROR 48: Imagen guardada como jpeg progresivo (%s). Debe ser sólo optimizado (de preferencia) o línea de base. Obsoleto

La imagen que se indica tiene el formato progresivo que no está permitido porque impiden su visualización en muchos lectores/apps (como el propio ADE v1.x), hay que editarla y cambiarle el formato.

ERROR 49: Entrada 'calibre:series%s' vacía en content.opf.

Si nuestro libro pertenece a una colección hemos de indicarlo en los metadatos rellenando la entrada «calibre:series». Si no pertenece a ninguna colección hemos de borrar esa línea.

ERROR 50: Saga/serie encontrada en %s (%s) pero faltante en %s.

Cuando nuestro libro pertenece a una colección debemos indicarlo en varios sitios, este error indica que se ha colocado en uno pero no en otro.

ERROR 51: Saga/serie en metadatos (%s) difiere de página título (%s).

Este error es idéntico al anterior, pero específico para indicar que el nombre de la colección que se ha indicado en metadatos no coincide con el indicado en la página título.

ERROR 52: Número de volumen encontrado en %s (%s) pero faltante en %s.

Este error es idéntico al número 50, pero referido al número de orden que ocupa nuestro libro dentro de la colección.

ERROR 53: Número de volumen en metadatos (%s) difiere de página título (%s).

Este error es idéntico al número 51, pero referido al número de orden que ocupa nuestro libro dentro de la colección.

ERROR 54: Número de revisión no encontrado en %s.

El número de revisión de nuestro libro no se ha encontrado en el sitio que se indica, donde debe aparecer de forma obligatoria.

ERROR 55: Número de revisión en página título (%s) difiere de nombre de archivo (%s).

El número de revisión indicado en la página título no coincide con el indicado en el nombre del archivo.

ERROR 56: Número de revisión con dos decimales en %s. Debe aumentarse dígito principal (excepto en candidaturas).

El número de revisión solo puede tener un decimal. Caso de que lleguemos al 1.9 el siguiente será el 2.0.

ERROR 57: Fecha de publicación original en metadatos (%s) coincide con ePub base. Debe cambiarse en cada aporte.

La fecha indicada como fecha de publicación original de nuestro libro coincide con la fecha de publicación del ePub Base. Hemos de asegurarnos de que realmente coinciden o corregirla.

ERROR 58: Fecha de publicación original en %s (%s) es posterior al año actual.

No podemos maquetar libros “futuros”, la fecha de publicación original del libro ha de ser anterior a la fecha actual.

ERROR 59: Fecha de publicación original faltante en %s.

Hay que colocar la fecha de publicación en el lugar que se indica.

ERROR 60: Fecha de publicación original en metadatos (%s) difiere de página info (%s).

La fecha de publicación original aparece en metadatos y en la página info. En ambas debe aparecer la misma (aunque en la página info normalmente solo se indica el año y en la de metadatos se pone completa, indicando el uno de enero si no se conoce el día concreto).

ERROR 61: Fecha de modificación en %s (%s) coincide con ePub base. Debe cambiarse en cada aporte.

La fecha de modificación del libro no se ha modificado y coincide con la indicada en el ePub Base. Hemos de colocar la correcta.

ERROR 62: Fecha de modificación no encontrada en %s.

La fecha de modificación debe aparecer obligatoriamente en la página título, si no es así saltará este error.

ERROR 63: Fecha de modificación en metadatos (%s) difiere de página título (%s).

Además de la página título, los metadatos también incluyen la fecha de la última modificación de nuestro libro. Esta última se coloca automáticamente, tomándola del reloj del sistema de nuestro ordenador. Si el reloj está mal o no hemos modificado la de la página título, no coincidirán.

ERROR 64: Alias de editor no encontrado en %s.

El nombre del editor ha de aparecer en el sitio que se indica.

ERROR 65: Alias de editor en página título (%s) difiere de página info (%s).

El nombre del editor ha de escribirse igual en todos los sitios donde debe colocarse.

ERROR 66: Caracteres no permitidos en nombre de archivo%s.

Los nombres de los archivos no deben contener caracteres no permitidos (por ejemplo, espacios).

ERROR 67: Identificador único [ePL-ID] faltante en nombre de archivo.

Los libros publicados en EPL disponen de un identificador único, el ePL-ID, que debe colocarse únicamente en el nombre del archivo, respetando el formato establecido, y no en su interior. La mejor forma de evitar los errores en el nombre del archivo es generándolo a través de la web (esto solo es posible para los editores, los candidatos no tienen acceso).

ERROR 68: Idioma en nombre de archivo [%s] no es uno de los aceptados actualmente.

El nombre del epub contiene un código de idioma no admitido.

ERROR 69: Idioma [ES] innecesario en nombre de archivo.

Cuando el idioma del libro es el español no hay que indicarlo en el nombre del epub.

ERROR 70: Idioma encontrado en metadatos (%s) pero faltante en nombre de archivo.

Los metadatos indican que el libro está escrito en un idioma distinto del español, pero no se ha indicado en el nombre del epub.

ERROR 71: Idioma en metadatos (%s) difiere de nombre de archivo [%s].

El idioma indicado en el nombre del epub y el indicado en los metadatos son diferentes, hay que ver cuál es incorrecto y modificarlo.

ERROR 72: Formato de nombre de archivo incorrecto. Es recomendable generarlo desde la ficha web.

El formato del nombre del libro no es el adecuado (no se especifica la razón). Como en el caso anterior, lo mejor es usar el nombre generado por la web (solo para editores).

ERROR 73: Aporte con fuentes incrustadas sin archivo 'com.apple.ibooks.display.xml'.

El archivo com.apple.ibooks.display.xml forma parte del ePub Base y es necesario para que puedan verse las fuentes incrustadas en los iBooks.

Este error se corrige automáticamente, incluyéndose de nuevo el archivo, cuando se valida con la versión auto.

ERROR 74: Archivo 'com.apple.ibooks.display.xml' es obligatorio a partir del ePub base r1.1.

Complementario del anterior, este error indica que no está presente el archivo obligatorio.

Este error se corrige automáticamente, incluyéndose de nuevo el archivo, cuando se valida con la versión auto.

ERROR 75: Orden de las cuatro primeras secciones fijas (%s) parece incorrecto.

Las secciones que aparecen en el ePub Base son de obligatoria presencia (aunque se pueden borrar algunas que pueden no estar presentes en algunos libros, como dedicatoria, autor, notas) y el orden en que aparecen en el ePub Base es en el que deben quedar.

ERROR 76: Orden de las secciones autor (%s) y notas (%s) parece incorrecto.

Autor y notas deben ser los dos últimos archivos del ePub, en ese orden (aunque puede no estar presente uno o ambos si no son necesarios).

ERROR 77: Concepto erróneo (Imagen de portada) para %s.

Se le ha dado el concepto de imagen de portada a una imagen que no lo es. Hay que eliminar ese concepto y colocárselo a la imagen adecuada.

ERROR 78: Concepto faltante (Imagen de portada) para %s.

La imagen de la portada debe llevar activado el concepto portada. Solución: desde Sigil hacemos clic con el botón derecho sobre el archivo indicado y elegimos Añadir concepto y luego Imagen de portada.

Este error se corrige automáticamente, incluyéndose el concepto, cuando se valida con la versión auto.

ERROR 79: Concepto no permitido (%s) para página %s. Obsoleto

Además del concepto Portada podemos usar otros. Si colocamos un concepto innecesario a algún archivo de los que componen nuestro ePub, este error nos lo indicará.

Este error se corrige automáticamente, eliminándose el concepto, cuando se valida con la versión auto.

ERROR 80: Concepto faltante (Portada) para página %s.

Es el mismo error que el ERROR 78, pero referido esta vez al archivo de la cubierta.

Este error se corrige automáticamente, incluyéndose el concepto, cuando se valida con la versión auto.

ERROR 81: Texto sin modificar en %s (%s).

El dato que se indica ha de cambiarse, no puede quedar como en el ePub Base, este error lo recuerda.

ERROR 82: Signo de puntuación innecesario en %s final de línea %s (%s).

En la línea que se indica hay código incorrecto, en concreto un signo de puntuación innecesario.

ERROR 83: Jerarquía de partes o capítulos debe comenzar en <h1>

Los capítulos del libro (o las secciones en caso de existir) deben ser <h1> y no otro.

ERROR 84: Jerarquía de sección fija debe ser <h1> (%s).

Los encabezados de las secciones fijas del ePub Base han de ser h1, tal como aparecen en el ePub base.

ERROR 85: Código modificado en sección fija (%s). Comparar con ePub base.

La sección fija que se indica parece contener un código distinto del establecido en el ePub Base, hay que compararlos para corregir el error.

ERROR 86: Código del ePub base anterior en %s%s (%s).

Se ha encontrado código como se hacía en una versión anterior del ePub Base. Este error es frecuente cuando se cambia el base de un libro al actualizarlo y pasársenos algún detalle. La mejor solución es usar las herramientas disponibles para actualizar el base en vez de hacerlo manualmente.

ERROR 87: Código erróneo o no permitido en %s%s (%s).

Hay un código que no se permite en el punto que se indica. Hay que sustituirlo por un código que esté permitido o eliminarlo.

ERROR 88: Código de notas no estándar en %s línea %s (%s).

Se está usando un código que no corresponde con el estándar en las notas que se indican.

ERROR 89: Código no permitido en <head> de %s a partir de línea %s (%s).

No se admite la definición de clases en head (como sí que se permiten en las páginas web), todas las definiciones deben ir en el archivo style.css.

ERROR 90: Carácter erróneo en lugar de raya en %s (dec:%s). Reemplazarlo con Informes de Sigil.

Se ha usado un carácter erróneo en el lugar de la raya, hay que buscarlos y sustituirlos.

ERROR 91: Carácter erróneo o combinado en %s (dec:%s). Reemplazarlo con Informes de Sigil.

Se ha usado un carácter erróneo en el lugar indicado, hay que buscarlo y sustituirlo.

ERROR 92: Error al procesar archivo %s. Debe revisarse.

Error no especificado en el archivo que se indica que impide su análisis, hay que mirarlo para comprobar que todo está correcto.

ERROR 93: Entrada no permitida en content.opf (%s).

Calibre introduce código propio en los metadatos de los libros que maneja (también el propio editor y otras aplicaciones) y no está permitido. Este error los está detectando y nos pide que lo eliminemos. La solución es no hacer nada con Calibre mientras maquetamos los libros o, al menos, hacerlo con una copia; una vez introducido el código incorrecto, la única solución es borrarlo manualmente del content.opf.

ERROR 94: Entrada incompleta en content.opf (%s).

Hay una línea en content.opf que no está completa, lo que hace que alguno de los metadatos no esté correcto.

ERROR 95: Entrada innecesaria en content.opf (%s).

Se ha encontrado un metadato innecesario, hay que borrarlo del content.opf.

ERROR 96: Archivo referido en content.opf pero no encontrado (%s) (posible error en caracteres).

La lista de ficheros que hay en el content.opf indica la existencia de un fichero que luego no se encuentra en los ficheros del epub. Este error suele producirse cuando el nombre del fichero contiene caracteres no permitidos (como el espacio). La solución pasa por corregir los caracteres no permitidos, aunque puede que haya que modificar manualmente el content.opf para eliminar el error definitivamente.

ERROR 97: Archivo encontrado pero no referido en content.opf (%s).

Este error nos indica que hay un archivo en nuestro ePub que no aparece declarado en el content.opf. Eso suele indicar que la llegada del archivo fue irregular. La solución pasa por borrar el archivo y volver a incluirlo adecuadamente si lo necesitáramos.

ERROR 98: Archivo innecesario (%s).

El archivo que se indica no se usa en el ePub, dejarlo solo incrementa su peso, así que debemos borrarlo o, en su caso, averiguar por qué no se usa y modificar el código para que se use como debiera.

Este error se corrige automáticamente, borrándose los archivos, cuando se valida con la versión auto.

Este epub tiene un error estructural, guárdalo desde Sigil para corregirlo.

Se han detectado epubs que no funcionan en ADE por tener más longitud de la debida o por contener más de una copia del fichero mimetype. Este fichero es un fichero especial que todo epub debe contener, en la raíz del fichero zip, con un contenido concreto y sin comprimir. Debido a lo controlado que está, no es probable que ninguna aplicación que maneje epubs cometa este error, pero aun así se han dado casos, así que ha añadido la detección. Para corregirlo únicamente hay que pulsar guardar desde Sigil, quien se encarga de corregirlo todo. Advertencia: esta detección se hace junto a la comprobación de ficheros basura así que si no se pueden comprobar estos, tampoco se podrá comprobar el número de ficheros mimetype o la longitud del fichero epub.

Estilo definido pero no usado (%s).

Los estilos personales que no se usen han de eliminarse de la hoja de estilos, el que aparece entre los paréntesis del mensaje no se usa en el epub, así que habría que eliminarlo. Esto no afecta a los estilos pertenecientes al ePub Base, que deben quedarse aunque no se usen.

Estilo no definido (%s).

El estilo que aparece entre paréntesis se ha usado en nuestro epub, pero no se ha definido en la hoja de estilos. Frecuentemente se trata de un error a la hora de escribir el nombre del estilo, aunque, tras la liberación del número de hojas de estilo permitidas con la aparición del Base 2.0, también se han dado casos de confusión al definir un estilo en una hoja de estilos no enlazada a la sección donde se usa, lo cual nos lleva a recomendar que se extreme la precaución en los casos de epubs con múltiples hojas de estilo.

Fuente aplicada (%s) pero no incrustada.

Únicamente podemos usar fuentes sin incrustarlas primero si se trata de las estándar (serif, sans, monoespace), en todos los demás casos hemos de incrustarlas primero con @font-face. Si vamos a usar la misma fuente en distintas hojas de estilo, hemos de incrustarla en cada una de ellas.

Fuente incrustada (%s), pero no usada.

Se ha encontrado en la hoja de estilos una definición de fuente incrustada pero no se ha aplicado a ningún estilo, por lo que habría que aplicarla o eliminarla.

Fuente tipográfica encontrada (%s), pero no usada.

El epub contiene un fichero de fuentes que no se ha usado en la hoja de estilos. Habría que comprobar que no hay ningún error en los nombres de los ficheros que impidan localizarlos en las definiciones o eliminar el fichero si no va a usarse.

Hay más de un encabezado en una misma sección sin su correspondiente identificador, no se puede comprobar la TOC automáticamente, debe generarse desde Sigil.

Si la TOC no se ha generado nunca y hay varios encabezados en una misma sección, Sigil no ha podido distinguirlos incluyendo los id automáticos que suele colocar. El ePLValidator no está preparado para hacer esa labor así que no puede comprobar si la TOC es correcta por sus propios medios y nos solicita que lo hagamos a través de Sigil.

Hay una estructura de encabezados no consecutivos, no se puede comprobar la TOC.

Los niveles de encabezados han de ir aumentando escalonadamente, sin saltos, según el estándar ePL. El mecanismo de comprobación de la TOC incluido en ePLValidator tiene en cuenta esa circunstancia y si encuentra una situación de encabezados mal escalonados (por ejemplo, un h3 a continuación de un h1), aborta la comprobación de la TOC emitiendo este error.

Hoja de estilos no usada: %s.

La posibilidad de usar más de una hoja de estilos y usarlas o no en cada uno de los capítulos a criterio de cada uno puede dar pie a que añadamos una nueva hoja de estilos y luego olvidemos enlazarla en las secciones donde queremos usarla. Este mensaje nos recuerda que hay una hoja de estilos sin enlazar para que la enlacemos o la borremos según proceda.

Identificador de tipo no aceptado (%s).

A partir del Base 2.0 se admiten tres tipos de identificadores en los metadatos del epub: el bookId, el ePLID y el número de revisión del epub (para las versiones anteriores sólo se admiten los bookId). Este mensaje aparece cuando se usa un identificador de cualquier otro tipo, que habría que eliminar (o corregir si se trata de un error en el identificador).

Identificador del tipo %s duplicado.

Se ha encontrado más de una entrada para algunos de los identificadores permitidos (bookId, ePLID o número de revisión), por lo que hay que eliminar el que sobre.

Identificador del tipo %s no encontrado.

Los identificadores permitidos (bookId, ePLID o número de revisión para el Base 2.0 o el bookId únicamente para los anteriores) son obligatorios, si no se encuentra alguno de ellos saltará este mensaje para recordarnos que hay que ponerlos.

La hoja de estilos %s debe aparecer en cada sección.

El Base 2.0 introduce la posibilidad de usar más de una hoja de estilos, pero también aporta una hoja de estilos propia de la plantilla: epl.css que debe estar presente en cada sección del epub, excepto en el índice temático creado automáticamente por Sigil.

La hoja de estilos %s debe ser la primera en la cabecera de la sección.

La hoja de estilos propia de la plantilla ha de ser la primera en la cabecera de cada sección, a continuación se podrán poner otras hojas distintas.

Las dimensiones establecidas en la cubierta deben coincidir con el tamaño real de la portada (%s).

La sección cubierta, a partir del Base 2.0, coloca la imagen de portada dentro de un svg, por lo que necesita especificar las dimensiones reales de la portada. Si la imagen tiene unas dimensiones distintas de las que aparecen por defecto, hay que cambiarlas a las reales de forma manual.

No se encuentra el fichero de fuentes referenciado (%s).

El fichero indicado entre paréntesis se ha incluido en una definición de fuente incrustada, pero el fichero en sí no parece estar cargado en el epub. Si se trata de un error en la transcripción del nombre del fichero de fuentes, se solucionará corrigiéndolo; si se trata de que no se ha incluido el fichero de fuentes en el epub, se solucionará cargándolo.

Posible nosep o nbsp innecesario.

Tanto los nosep como los nbsp son usados en nuestro estándar para evitar que partes de una palabra o varias palabras que deban ir juntas se separen al final de la línea, por eso no son necesarios cuando se aplican a texto que esté cerca del comienzo del párrafo. En concreto saltará este aviso cuando se aplique a una parte del texto que tenga menos de 20 caracteres hasta el comienzo del párrafo. Por supuesto, puede que un párrafo al que se le aplique un tipo de letra grande aconseje que se aplique más cerca del comienzo del párrafo que esos 20 caracteres, así que el editor tendrá que valorar la conveniencia de dejarlo o no.

Propiedad desaconsejada en la hoja de estilos (%s).

La propiedad indicada no ha superado el banco de pruebas, por lo que se aconseja que no se use.

Se ha encontrado el icono de fuentes incrustadas pero ninguna fuente.

El Base 2.0 establece que se coloque un icono en la sección info cuando el epub contiene fuentes incrustadas para avisar al lector por si tiene que cambiar la configuración del eReader para poder verlas. Si no se encuentran fuentes incrustadas hay que eliminar el icono para evitar confusiones.

Se ha encontrado texto fuera de un contenedor adecuado.

Aunque el estándar HTML permite que se pueda representar texto contenido en diversos contenedores, e incluso sin ninguno de ellos, la versión del estándar HTML presente en los eReaders no tiene por qué comportarse de forma tan relajada. Por otra parte, el estándar ePL es más estricto en este sentido y la lista de los contenedores permitidos para contener texto no es tan amplia y, por supuesto, no se permite un texto fuera de contenedor pues de esa forma no se le puede aplicar el formato adecuado. Este mensaje nos avisa de esta circunstancia, aunque puede darse el caso de que señale a una línea anterior al punto donde se encuentra el texto en cuestión pues la ausencia de etiquetas complica la detección.

Se han encontrado fuentes incrustadas pero no el icono correspondiente en info.

El Base 2.0 establece que se coloque un icono en la sección info cuando el epub contiene fuentes incrustadas para avisar al lector por si tiene que cambiar la configuración del eReader para poder verlas. Si no se encuentra el icono pero sí fuentes incrustadas, este mensaje nos recuerda que lo coloquemos.

Avisos

Aparte de los errores también nos podemos encontrar avisos.

La función principal de estos mensajes de aviso es señalar al editor que el epub contiene errores que, aunque no comprometan su funcionalidad sí incrementan el código usado, aunque no choquen con el estándar ePL, sí lo hacen con los principios generales de limpieza y claridad establecidos por nuestra comunidad. Se recomienda solucionarlos, aunque no es obligatorio. Veamos una lista detallada:

Código innecesario (%s).

Este aviso muestra códigos que no son necesarios para el resultado final de la maquetación o que no afectan para nada. El editor tendrá que estudiar si es realmente necesario mantenerlo pues se pueden dar falsos positivos, como por ejemplo la etiqueta span sin un estilo asignado pues puede ser un residuo de un epub procedente de kepub o puede ser un recurso usado por el editor y gestionado desde la hoja de estilos.

El aporte usa una versión anterior del ePub base. Se recomienda actualizar a la %s.

Usar una plantilla obsoleta no es un error, aunque se recomienda usar la vigente en todos los casos.

El autor/título normalizado (%s) parece no estar en el nombre del epub. Es recomendable generarlo desde la ficha web.

Si el nombre del epub tiene una estructura adecuada pero no se puede encontrar el nombre del autor o el título del libro en su interior, se emite este aviso para recomendar que se use el nombre que se genera a través de la web. Para realizar esta comprobación se usan los valores correspondientes que aparecen en metadatos, pues la comprobación del resto de los sitios donde aparecen ya se realiza en otros momentos de la validación. Típicamente, este aviso aparece en dos circunstancias: cuando se realiza un cambio en título o autor en uno de los lugares comparados y no en el otro (en cuyo caso el aviso nos servirá de recordatorio para cambiarlo en el otro lugar) o cuando el editor realiza una normalización atípica en algún carácter especial del nombre del epub (en cuyo caso se puede ignorar el aviso pues las reglas de normalización no son obligatorias).

Este epub tiene datos adicionales (%s) a modo de metadatos, guárdalo desde Sigil para corregirlo.

Algunas aplicaciones que están por determinar incluyen datos en la estructura zip del epub a modo de metadatos. Esta información es totalmente inútil y potencialmente peligrosa si incluye algún tipo de identificación del editor, por lo que se recomienda eliminarla. Sigil elimina automáticamente toda esta información adicional, así que, para corregir el error, únicamente tenemos que guardar el epub desde Sigil (aunque no se hayan hecho modificaciones). Advertencia: esta detección se hace junto a la comprobación de ficheros basura así que si no se pueden comprobar estos, tampoco se podrá comprobar la presencia de datos extra en el fichero epub.

HTML semántico: se recomienda indicar el idioma en cada sección.

Para facilitar el acceso de las aplicaciones al contenido del epub se recomienda indicar el idioma en cada sección usando el parámetro xml:lang="es" (para español, otros códigos para otros idiomas) en la etiqueta html.

HTML semántico: se recomienda indicar un título en cada sección.

Para facilitar el acceso de las aplicaciones al contenido del epub se recomienda utilizar la etiqueta title de la cabecera para colocar un título explicativo del contenido de la sección.

HTML semántico: se recomienda indicar una descripción de cada imagen.

Para facilitar el acceso de las aplicaciones al contenido del epub se recomienda usar el parámetro alt de las imágenes para colocar un texto que la describa. Esto sólo debe hacerse si el contenido de la imagen está relacionado con el texto, porque si se trata de una imagen puramente decorativa ha de dejarse vacío y, para que salte el aviso, colocar el parámetro role="none".

Se recomienda no usar div para un solo párrafo. Obsoleto

El principal uso de div en el entorno epub es poder aplicar un estilo a un conjunto de párrafos sucesivos, ahorrándonos así el código correspondiente a la aplicación del estilo a varios párrafos. Si se detecta que hay un div aplicado a un solo párrafo se emite este aviso para que comprobemos si los efectos serían los mismos si en vez de al div se le aplica el estilo al propio párrafo.

Sólo debe usarse la palabra '%s' si es parte del nombre original (encontrada en %s).

Palabras como Saga o Serie pueden aparecer formando parte de un nombre de saga/serie, pero no es lo habitual aunque hay despistes a la hora de colocarlos en el epub; este mensaje se encarga de recordárnoslo para que comprobemos que el nombre es correcto.

PUBLICACIÓN EN LA WEB

Cómo nombrar los archivos

Por norma general, todos los nombres de archivo de nuestros ePubs deben seguir la misma pauta:

Apellido(s), Nombre(s) - [Serie/Colección Número] Título [EPL_ID] (r1.0 Editor)

El titulo debe hacer un uso correcto de las mayúsculas normalizadas: solo se escribe con mayúscula la primera palabra del título, el resto van con minúscula (salvo que se trate de nombres propios).

El nombre de archivo no puede contener ni tildes, ni eñes, ni caracteres no latinos, ni signos adicionales.

Los caracteres especiales admitidos son:

, . - _ ( ) & (ampersand)

Se debe evitar el uso de corchetes [ ] salvo de la forma indicada en el ejemplo. En caso contrario, el archivo dará problemas con la identificación de la serie o del ID.

Lo de «r1.0» significa «revisión 1.0». Todos los libros maquetados por primera vez son «revisión 1.0». Cuando, posteriormente, haya correcciones (de erratas, de maquetación, o de lo que sea), esas mejoras se expresarán con un número superior de revisión: 1.1, 1.2, etc. Si no tienes claro como nombrar tu revisión, consulta el apartado correspondiente.

Opcional: En «Editor», puedes poner tu alias en EPL, o no poner nada. Queda a tu elección.

Excepciones

No obstante, como veremos, existen excepciones: Las grandes sagas y las colecciones con varios autores.

Dos autores

Si el libro ha sido escrito por dos autores, escribe los apellidos y los nombres de cada uno de ellos seguido por un & (signo ampersand).

Samaniego, Felix Maria & Iriarte, Tomas de - Fabulas [8348] (r1.0 Editor)

Varios autores

Si el libro ha sido escrito por tres o más autores, en vez de poner ningún nombre, se indicará mediante «AA. VV.».

AA. VV. - Título [EPL_ID] (r1.0 Editor)

AA. VV. - Antologia de la literatura fantastica [6238] (r1.0 Editor)

Colecciones

En el caso de que el libro pertenezca a una colección, completa el apartado «[Serie Número]». Si la colección tiene más de 10 volúmenes, numera los 10 primeros con dos dígitos: 01, 02, 03… (por supuesto, si sabes de antemano que tendrá más de 100 volúmenes, usa tres dígitos).

[Recetas de la Abuela 051] Abuela Amparo - Platos con garbanzos [12211] (r1.0 Editor)

Subcolecciones

Existen colecciones muy extensas y que, a veces, tienen subcolecciones, en este caso la pauta es diferente. Esto se ha fijado así para que a la hora de guardar dichas colecciones, los archivos aparezcan ordenados. La pauta es:

[Saga] [Serie Número] Apellido(s), Nombre(s) - Título [EPL_ID] (r1.0 Editor)

[Fabulas de todos los tiempos] [Griegas 1] Esopo - Fabulas [111] (r1.0 Editor)

Las colecciones con libros de diferentes autores seguirán la misma pauta:

[Saga] [Serie Número] Apellido(s), Nombre(s) - Título [EPL_ID] (r1.0 Editor)

Las colecciones con libros de varios autores seguirán la pauta de colecciones y varios autores:

[Saga] [Serie Número] AA. VV. - Título [EPL_ID] (r1.0 Editor)

Traducciones

En algunos casos podemos encontrar que el libro que tenemos ya está publicado pero con una traducción diferente, en estos casos se indica el traductor como parte del título del libro, según la siguiente pauta:

Apellido(s), Nombre(s) - [Serie/Colección Número] Título (trad. Nombre Traductor) [EPL_ID] (r1.0 Editor)

Por ejemplo: Kafka, Franz - El proceso (trad. Miguel Vedda) [20388] (r1.1 Editor)

Ilustradas / Anotadas

Algo similar puede ocurrir respecto a ediciones anotadas o ilustradas, donde se pueden usar las siguientes pautas:

Apellido(s), Nombre(s) - [Serie/Colección Número] Título (ilustrada) [EPL_ID] (r1.0 Editor)

Apellido(s), Nombre(s) - [Serie/Colección Número] Título (anotada) [EPL_ID] (r1.0 Editor)

Libros en otros idiomas

Los libros en otros idiomas, especialmente cuando su título coincida con la traducción al español, llevarán incluido el código de idioma entre corchetes al final del nombre.

Apellido(s), Nombre(s) - [Serie/Colección Número] Título [EPL_ID] (r1.0 Editor) [IDIOMA]

Si el nombre de la colección fuera igual en castellano, también hay que incluir la anotación en la misma.

Apellido(s), Nombre(s) - [Serie/Colección (IDIOMA) Número] Título [EPL_ID] (r1.0 Editor) [IDIOMA]

Un truco que se puede utilizar es añadir alguna palabra que diferencie ambas colecciones, por ejemplo:

Pratchett, Terry - [Johnny Maxwell 01] Solo tu puedes salvar a la humanidad [43409] (r1.0)

Pratchett, Terry - [Johnny Maxwell Trilogy 01] Only You Can Save Mankind [43412] (r1.0) [EN]

o

Hamilton, Laurell K. - [Anita Blake, cazavampiros 01] Placeres Prohibidos [1807] (r1.1)

Hamilton, Laurell K. - [Anita Blake, Vampire Hunter 01] Guilty Pleasures [23346] (r1.0) [EN]

Siempre que haya que incluir la notación del idioma, se indicará con el código de 2 letras regulado en la norma ISO 639-1.

Ejemplos

Un autor

Cervantes Saavedra, Miguel de - Don Quijote de la Mancha [1284] (r1.0 Editor)

Dos autores, con serie

Samaniego, Felix Maria & Iriarte, Tomas de - [Fabulas Griegas 1] Fabulas [8348] (r1.0 Editor)

Tres autores o más

AA. VV. - Antologia de la literatura fantastica [6238] (r1.0 Editor)

Colecciones extensas y con varios autores

[Fábulas de todos los tiempos] [Griegas 1] Esopo - Fábulas [111] (r1.0)

[La Biblioteca de Babel 29] AA. VV. - Cuentos rusos [18065] (r1.1 Editor)

[La Biblioteca de Babel 08] Alarcon, Pedro Antonio de - El amigo de la Muerte [19116] (r1.1 Titivillus)

Libros en otros idiomas

Ende, Michael - Die unendliche Geschichte [18712] (r1.0) [DE]

Hearst, Dorothy - [The Wolf Chronicles 01] Promise of the Wolves [41696] (r1.0) [EN]

Kent, Alexander - [Richard Bolitho (EN) 15] Success to the Brave [33658] (r1.0) [EN]

Cómo rellenar las fichas

Una vez que tu candidatura ha sido aprobada, es el momento de subir tu trabajo a la web. Para rellenar una ficha, primero tienes que tener activados tus permisos de editor. En caso contrario, no podrás hacerlo.

Para empezar, echemos una ojeada a tu página personal. Nada más loguearte, apareces en «Mi cuenta». También puedes acceder allí desde la esquina superior derecha de la web.

Como usuario, solo tenías un apartado. Como editor, comprobarás que tienes otro con tus aportes, ya sean fichas de libros, autores, colecciones o premios. Te aconsejamos darte una vuelta por las opciones para ir familiarizándote con ellas.

Si haces clic sobre la opción «Mis aportes», te llevará a la sección donde gestionar tus libros. En este apartado existen tres pestañas:

Los finalizados: Son libros que están terminados (estado: «disponible» o «verificado»)

En los que trabajo: Son libros que no están terminados (estado: «próximamente»)

Trabajos futuros: Son libros que no aparecen en la web, pero que sí son visibles para el resto de editores. Su función es ir reservando aportes que queremos maquetar (estado: «sin estado»)

Si nunca has subido ningún aporte, las secciones aparecerán vacías.

Crear nuevo aporte

Antes de crear la ficha debemos asegurarnos que el libro no está siendo preparando por otro editor.

Para ello iremos a nuestra cuenta de la web y abriremos el desplegable del botón «Menú editor» y elegiremos la opción «Comprobar títulos en la web». Se nos abrirá una nueva pantalla donde aparece un campo donde escribir algún dato del libro que buscamos (título o autor) y al pulsar sobre el botón «buscar» se nos mostrarán todos los libros que hay en la web que contengan lo que hayamos dicho que busque. Para hacer una búsqueda adecuada y segura, se deberían seguir estos consejos:

Nunca poner el título o el autor completos, solamente una palabra del título o el nombre o el apellido del autor solos.

Nunca poner palabras incompletas pues el motor de búsqueda trabaja con palabras completas.

Si tenemos sospechas de que la palabra que buscamos ha podido ser escrita de otra forma, buscarla también (esto es frecuente en los nombres de autores extranjeros, sobre todo los rusos).

Siempre hacer varias búsquedas cambiando lo buscado para asegurarnos.

Una vez hecho esto dentro del menú editor vamos a «Crear libro» y «Crear nuevo». Si estás preparando la candidatura esto ya lo ha hecho algún revisor por ti y ha realizado la reserva.

Existen dos formas de crear la ficha:

Pulsa el botón «Menú editor» y selecciona la opción «Crear libro».

Ve a «Trabajos Futuros».

Al seleccionar cualquiera de las opciones, te llevará a la sección de «Futuros Trabajos». Una vez allí, haz clic sobre «Crear nuevo» y se abrirá el formulario de creación de libros. En realidad no se va a crear nada, sino modificar algo existente. Por eso el título del formulario es «Editar libro». El libro ya existe, pero sin datos.

Un usuario editor puede crear tantos libros vacíos como quiera, e ir preparando los datos de cada uno de ellos poco a poco. Cuando termine la introducción de los datos de un libro, tan solo tiene que cambiarle el estado a ese libro para que pase a formar parte del contenido de la web.

Echemos una ojeada a sus partes:

Datos básicos.

Datos adicionales.

Datos de esta edición.

Enlaces.

Datos básicos

Estos son los datos imprescindibles para poder pasar la ficha a «En los que trabajo» y que sea visible ya en la web. Si no son rellenados, no te dejará hacerlo.

Título: El título del libro en el idioma en el que lo publiques.

Autor: Si el autor a introducir no aparece en el listado, haz clic en el signo «+» para introducir un nuevo autor. Si deseas introducir más de un autor, ve a la sección de «Otros autores».

Sinopsis: No tiene por qué ser exactamente como la de tu ePub, aunque es recomendable.

Ten cuidado a la hora de añadir el texto. Debe estar libre de formatos añadidos, que no serán aceptados y pueden dar problemas. Te recomendamos copiar primero el texto en algún programa como el «Bloc de notas», para quitarle el formato.

Idioma: El del libro que vas a publicar.

Año de publicación: El año de publicación EN EL IDIOMA ORIGINAL.

Páginas: El número de páginas del libro. Dado que cada programa da un valor diferente de este dato, se ha optado por unificar criterios mediante el programa Adobe Digital Editions o el Count Pages.

Reserva indefinida: Si sabes que este aporte tiene una gran carga de trabajo y excederá los plazos normales, puedes marcarlo como «reserva indefinida» así esta reserva no podrá ser solicitada por otro editor (Recuerda que hay un máximo de reservas indefinidas).

Datos adicionales

Los siguientes datos son necesarios para poder pasar la ficha a «Los finalizados» y que aparezca como novedad en la web. Géneros es obligatorio. El resto es opcional según el libro.

Otros autores: Aquí puedes añadir coautores, traductores, ilustradores… recuerda que por cada uno que añadas, se creará su correspondiente ficha de autor.

Géneros: Deben ser iguales a las etiquetas que introdujiste en los metadatos. Se utilizan para las secciones de libros y autores similares. También son utilizadas para realizar filtros en la web y por programas como Calibre.

Colección: Si tu libro pertenece a una colección, indícalo aquí. Si dicha colección no existe puedes crearla. Ten cuidado con la ortografía. Asegúrate de utilizar correctamente las mayúsculas y tildes.

Volumen: El número del libro, si pertenece a una colección. Debe ser introducido con números arábigos (1, 2, 3…). Si el libro está incluido entre dos volúmenes, deberá emplearse un punto para los decimales: 1.5, 3.5…

Datos de esta edición

Son los datos específicos de tu aporte, tales como la revisión o las notas. La portada es obligatoria si quieres que el libro aparezca en la web (Sección «En los que trabajo»).

Revisión: El número de tu revisión. Acuérdate de que debe estar indicado en tu ePub y seguir las normas indicadas en este manual.

Estado: Existen cuatro opciones: «Vacío», «Próximamente», «Disponible» y «Verificado».

Vacío: Para colocarlo en «Trabajos Futuros». No será visible más que para los editores.

Próximamente: Para colocarlo en «En los que trabajo». Cuando ya estés trabajando en serio con algún aporte, para avisar al resto de usuarios su próxima subida.

Disponible: Para pasar la ficha a novedades. También se usa cuando se sube alguna actualización menor.

Verificado: Si tú o alguien más ha revisado el libro por lectura y confirmado que no hay erratas, puedes pasarlo a este nivel. Los libros así indicados deberían estar libres de erratas. Aunque ya sabemos que Titivillus siempre hace de las suyas…

Notas: Aquí debes indicar las correcciones y añadidos realizados en cada nueva revisión, así como cualquier comentario añadido que desees hacer, como agradecer a otro usuario por su apoyo en la edición.

Portada: Aquí irá el enlace a la imagen de la portada. Como se indica, dicha portada debe ocupar exactamente 400×600 píxeles. Si ocupa más o menos, no la aceptará y no podrás pasar tu aporte a «En los que trabajo». Más adelante se indica cómo conseguir el enlace. [→SUBIR PORTADAS]

Enlaces

Aquí irá el enlace magnet. [→SUBIR ENLACE]

Colecciones en otros idiomas

Se creará una ficha por idioma. En caso de que una saga tenga el mismo nombre en varios idiomas, aún si sus fichas todavía no han sido creadas, se incluirá al final del título el idioma entre paréntesis en aquellas que no estén en castellano. Por ejemplo:

Miss Marple → castellano

Miss Marple (en) → Inglés

Miss Marple (eo) → Esperanto

Siempre que haya que incluir la notación del idioma, se indicará con el código de 2 letras regulado en la norma ISO 639-1.

Gestión de fichas

Sin embargo, a la hora de crear la ficha de un libro, se crean una serie de fichas asociadas: autor, traductor, ilustrador, colección… Y de la misma forma, al rellenar la ficha de un autor, puede ser que se creen fichas para sus premios.

¿Y que pasa si no quiero encargarme de todo eso? No te preocupes, solo es obligatorio mantener la ficha de los libros que aportes, así como hacer las revisiones de erratas y mantener el magnet activo.

Para el resto de fichas, si no quieres encargarte de ellas, puedes pasárselas a «Titivillus».

Los pasos a seguir son los siguientes:

Ve a la ficha de la que quieres deshacerte. En la parte superior de la página verás la opción «Editar». Haz clic allí.

Se abrirá la ventana para editar la ficha. A la derecha, verás una opción que pone: «Responsable» y debajo estará tu alias. Si haces clic sobre él, se abrirá un desplegable y puedes pasársela al usuario Titivillus.

Como rellenar las fichas asociadas

Mientras que el mantenimiento de las fichas de los libros es obligatorio, el resto de fichas son opcionales y su creación no implica que deban ser rellenadas. No obstante, se anima a los editores a que colaboren en la medida de lo posible con la labor de las bibliotecarias, bien haciéndose cargo de ellas o bien cediéndolas a Titivillus para que otros lo hagan.

A continuación se presentan una serie de pautas y recomendaciones a la hora de rellenar estas fichas. Son las pautas que en el momento de redactar este manual se siguen en la biblioteca, y se incluyen con el objetivo de homogeneizar las fichas de la web. No son obligatorias, aunque sí aconsejables, y ante cualquier duda, lo mejor es acudir a las bibliotecarias y consultarles.

Si no se tiene intención de rellenar las fichas creadas, se deben pasar a Titivillus para que las bibliotecarias u otros editores puedan hacerlo.

Es importante recordar que todas las fichas de autores y premios deben estar en castellano (incluso si los libros existentes no lo están). Para las colecciones, se rellenarán en el mismo idioma que los libros.

Nombre del autor

Para rellenarlo, se sigue en criterio de la BNE. En caso de duda, lo mejor es consultar a las bibliotecarias, que te indicarán la mejor forma de proceder.

Es importante que los nombres de los autores creados sean correctos, ya que otros editores los tomarán como referencia a la hora de maquetar.

Biografía

La información, para respetar una cierta homogeneidad dentro de lo posible, debe estar ordenada de la siguiente manera:

Presentación del autor: nombre completo (si lo sabemos), indicar si es seudónimo, añadir fecha de nacimiento y muerte, también incluir la nacionalidad o país de nacimiento. Incluir su profesión (escritor, músico, actor, periodista…). Por último, su formación o características especiales.

Su trayectoria, estilos, experiencia, en qué ha participado… quizás añadir algunas obras.

Enumeración de premios (si los tuviera) y su ocupación o situación actual.

No tiene que formar cada parte un párrafo, simplemente que en conjunto se entienda una continuidad, no simplemente echar ahí datos sueltos. Usar el párrafo moderno (sin sangría y con espacio entre párrafos) para facilitar la lectura.

Respecto al uso de otros elementos:

Cursivas: Todos los títulos de las obras, de revistas, obras de teatro, programas de televisión o similar deben ir en cursiva, sin comillas ni negritas.

Comillas: Usar mejor «…» y no "…"

Editoriales: Evitar poner editoriales a no ser que tenga relevancia. No aporta nada incluirlo cuando citamos bibliografía.

Repetición de nombres: No repetir el nombre del autor en exceso. Ya entendemos que dentro de la ficha del autor hablaremos de él, mejor usar… su trabajo, su trayectoria, a él…

Extensión: No debe ser excesivamente larga, para eso ya está Google o la Wikipedia misma. Solo conseguiremos que la lectura sea incómoda, debemos ser claros y concisos, contar lo principal del autor.

Etiquetas

Las etiquetas sirven para añadir apodos, seudónimos o nombres alternativos de los autores. No se deben utilizar para añadir temáticas, épocas ni nada por el estilo, solo otros nombres por los que un usuario podría buscar a ese autor. No añadimos el nombre, puesto que ya aparece en la ficha.

Las etiquetas deben servir para que sea más fácil localizar al autor, y deben usarse con moderación para evitar falsear los resultados de las búsquedas.

Seudónimos

Podemos distinguir dos casos:

1. Si tenemos solo una ficha en la web, ya sea la del nombre real o el seudónimo.

En este caso completamos la información que tengamos y dejamos claro si se trata de un autor que usa seudónimo o si es un seudónimo. Aportamos todos los datos que conozcamos.

Tenemos que completar las etiquetas añadiendo los seudónimos (si tenemos la ficha con el nombre real) o el nombre real (si tenemos un seudónimo). En caso de existir más de un nombre real o seudónimos también los incluimos en las etiquetas. No hay que crear la ficha que nos falte.

2. Si tenemos las dos fichas en la web, con el nombre real y el seudónimo.

Lo primero que intentaremos es que la foto y los datos biográficos coincidan para que tengamos un reconocimiento visual más rápido.

Ficha del autor real: Añadimos el seudónimo con un enlace, igual que hacemos aquí en el foro utilizando [url][/url].

Ficha del seudónimo: Añadimos el nombre real con un enlace, igual que hacemos aquí en el foro utilizando [url][/url]. Cuando editamos una ficha, a la derecha, podemos ver que hay una casilla que se llama seudónimo. Ahí tenemos que introducir el nombre del autor real.

NOTA: Siempre se hace en la ficha del seudónimo e introduciendo el nombre real. Si lo hacemos de esta forma, en la bibliografía del autor en la ficha del nombre real, aparecerán todos sus libros, los que firma con su nombre real y los firmados con su seudónimo.

Bibliografía

Es muy recomendable añadir algunos libros a la bibliografía, así parecen las fichas más completas y mejor presentadas. Dentro de la ficha que vayamos a completar, le damos a la derecha a Bibliografía, veremos que nos sale un menú nuevo. Le damos a «Nuevo título» y nos saldrá algo así:

La primera casilla (título en epublibre) la dejamos vacía, no es necesario completarla. Ponemos el título en su lugar y la fecha de primera publicación en su idioma original.

Si queremos modificar alguna fecha porque nos hayamos equivocado tendremos que eliminarla y volver a empezar. Tampoco es cuestión de añadir 30 libros, pero unos 10 o así estaría bien si son bibliografías muy extensas.

Premios

Lo primero que tenemos que tener bien claro es que hay dos tipos de premios, para autores y para obras. Es importante no mezclarlos ya que puede dar lugar a duplicados y equívocos.

Para saber qué tenemos que premiar, lo mejor es buscar la descripción del premio en su web oficial, si ello no es posible, acudimos a Wikipedia e incluso en las biografías de los autores se especifica.

Para crear un premio, lo primero es ir a nuestro menú Mis premios → Crear premio. Nos aparecerá una pantalla como esta:

Responsable: Nuestro nick.

Nombre del premio: Nombramos el premio sin la palabra Premio ni sus variantes en otros idiomas. Ante la duda lo mejor es preguntar en la Biblioteca. En el caso de los Premios Nacionales, es importante que al final añadamos el país entre paréntesis, o será imposible identificar su país. Por ejemplo: Nacional de narrativa (España).

Se premian: Elegir bien si premia a un autor o a una obra. Si nos equivocamos, luego podemos editarlo, pero mejor hacerlo bien desde el principio.

Wikipedia: escribimos la url de la página web en su lugar correspondiente.

Foto: Si disponemos de ella, la colocamos (200×300), en este caso es una imagen del premio o del logo (lo mejor es acudir a la web oficial).

Descripción: Añadimos lo que podamos, cuanto más clara sea la información mejor. Sobre todo, dejar bien claro si se premia a autores y trayectorias o a una obra en concreto, y de qué tipo.

Si el premio ya está creado y queremos añadirlo a un autor, tenemos que entrar dentro de la ficha del autor. Ahí pulsamos en premios y se nos abrirá un pequeño menú de este tipo:

Si el premio no existe podemos crearlo desde ahí mismo, pero si lo que queremos es asignarlo, daremos a asignar premio y nos saldrá un listado de los premios para autores que existen. Seleccionamos el que corresponda y su fecha y listo.

Aquí es donde vemos la importancia de distinguir bien qué se premia: si lo hacemos mal no aparecerá el premio y, casi seguro, lo duplicaremos al crearlo de nuevo.

Para editar un premio ya asignado lo tenemos que eliminar y asignar de nuevo. Puede ocurrir si nos equivocamos en la fecha en la que lo recibió.

Casos especiales: Premios para traductores/ilustradores

Excepcionalmente se crearán premios para autores cuando realmente son para obras, en el caso de tratarse de traductores o ilustradores. Esto es así por las características técnicas de la propia web, y se señalará con un texto similar a este en su descripción:

Este es un premio concedido a una obra pero, de manera excepcional y hasta que encontremos un método mejor, lo asignaremos como autores en caso de tratarse de traductores o ilustradores.

Añadiremos autores a estos premios siempre que sus fichas estén creadas en la web, aunque las novelas premiadas no estén de momento en EPL. Además, se añadirá al autor tantas veces como sea necesario (en el caso de haber ganado el premio en varias ocasiones).

Colecciones

Para completarlas, se hace lo mismo que con las biografías y premios.

Cómo subir portadas

Para la web, debes crear una versión de tu portada con un tamaño de 400×600 y pesar menos de 100K. Ten mucho cuidado de que su tamaño no sea superior o inferior, o no te dejará subirla. El formato es irrelevante, pero te recomendamos JPG.

El siguiente paso es colgarla en un servidor como:

tinypic (http://tinypic.com)

ImageShack (http://imageshack.us/)

Imgur (http://imgur.com/)

Se recomienda usar sitios sin registro para evitar bloqueos, ya que si se bloquea tu cuenta, se bloquearán todas las portadas. Si de todos modos deseas crear una cuenta te aconsejamos no usar cuentas personales para estos temas, para evitar problemas derivados de los derechos de autor.

Cómo subir enlaces magnet

Para compartir libros en nuestra web, solo se permite el uso de magnet links. A continuación se explica brevemente cómo hacerlo.

BitTorrent es la red P2P utilizada para compartir archivos en ePubLibre. Existen multitud de clientes BitTorrent en el mercado, pero se recomienda el uso de qBittorrent, que es un cliente P2P multiplataforma, gratuito y de código abierto para la red BitTorrent.

A continuación se explica cómo crear un enlace magnet en él.

Los pasos a seguir para compartir archivos son básicamente los mismos que para otros clientes.

Los nombres de los archivos deben estar normalizados con el objeto de facilitar su gestión y organización una vez descargados.

Crear un torrent

En este caso, se abre qBittorrent.

Para crear un nuevo enlace hay que ir a Herramientas → Crear Torrent. Ahora aparecerá una ventana similar a la siguiente:

Hay que asegurarse siempre de tener activada la casilla «Comenzar con la siembra después de la creación», tal como se indica en la imagen. Por defecto, viene desmarcada.

A continuación, pulsar sobre «Nuevo archivo» y seleccionar el archivo que se quiere compartir. Hay que utilizar el mismo nombre que aparece en nuestro ePub para nombrar el archivo torrent.

Una vez agregado el archivo, ya se puede «Crear y guardar» y aparece en el cliente qBittorrent.

Compartir el torrent

Una vez creado el enlace en qBittorrent y comprobado que el estado del archivo es «Sembrando», hacer clic con el botón derecho sobre el ePub y pulsar sobre «Copiar enlace magnet». También existe la opción de seleccionar directamente el Hash del torrent, como se muestra en la siguiente imagen:

Pegar el enlace en un editor de texto y extraer la secuencia alfanumérica de 40 caracteres entre «magnet:?xt=urn:btih:» y «&dn», esta secuencia es conocida como hash, o copiarla directamente como hemos visto en el punto anterior.

En la ficha del libro, hacer clic en el icono del imán (es el símbolo de los enlaces magnet). Pegar el hash en su lugar correspondiente y seleccionar el formato del libro.

Se recuerda que EL FORMATO EPUB ES OBLIGATORIO. No está permitido subir el libro en otros formatos si no se ha subido primero en formato ePub.

El ePub que se sube a la web debe ser COMPATIBLE CON TODOS los eReader del banco de pruebas (listado disponible en el foro). Si se desea subir una versión más avanzada (no completamente compatible), utilizar la opción «ePub alternativo».

Como en todas las redes P2P, los archivos solo estarán disponibles para descargar si son compartidos por otros usuarios. Recuerda tener el cliente de torrent compartiendo durante al menos un par de horas después de subir un nuevo ePub o actualizarlo. Si hay que apagar el ordenador por los motivos que sea, deja la publicación para otro momento.

CONVERSIÓN A OTROS FORMATOS

En esta parte del manual se explica cómo se pueden convertir los libros electrónicos con herramientas como Calibre.

Herramientas de conversión de formato

Existe una gran variedad de formatos de e-book (o libro electrónico), pero el más extendido es el ePub. Sin embargo, la elaboración de un e-book bajo este formato puede realizarse de dos formas: crearlo desde su inicio bajo este tipo de archivo, o bien obtenerlo mediante un proceso de conversión aplicado a otros formatos más frecuentes.

En este manual se va a explicar cómo utilizar dos de las aplicaciones más populares que existen para la conversión de formatos: Calibre y KindleGen.

Calibre

Calibre es un gestor y organizador de libros electrónicos libre, que permite la conversión de numerosos formatos de archivos para libros electrónicos. Sus desarrolladores promueven la difusión de formatos compatibles junto con numerosos fabricantes de lectores de libros electrónicos. Es multiplataforma, siendo compatible con los tres principales sistemas operativos: GNU/Linux, Mac OS X y Microsoft Windows.

Calibre facilita la conversión de numerosos formatos, tanto de entrada como de salida. Puede convertir varios formatos de entrada (epub, html, pdf, rtf, txt, cbc, fb2, lit, mobi, odt, prc, pdb, pml, rb; formatos de archivo de cómic: cbz y cbr) a varios formatos de salida (epub, fb2, oeb, lit, lrf, mobi, pdb, pml, rb). La conversión de formato incluye la composición avanzada con características como tablas, iniciales, imágenes y fuentes incrustadas.

A continuación se van a detallar los pasos generales a seguir para la conversión de formatos.

Descargar e instalar Calibre

El programa se puede descargar gratuitamente desde su página web: calibre-ebook.com/download. La instalación es bastante sencilla.

Ajustar las preferencias

Una vez instalado es conveniente ajustar las preferencias del programa.

En la ventana de preferencias se encuentran las opciones de conversión y apariencia de la aplicación.

Si el programa no se muestra en español, se puede cambiar el idioma dentro del apartado «Apariencia».

Las opciones de conversión son muy complejas, pero lo normal es que no se necesite cambiar nada salvo que se tenga un problema específico. Lo mejor es dejar las opciones de conversión como están por defecto. Todas estas opciones se podrán modificar también en el momento de convertir el fichero, de modo que los cambios solo afectarían a ese archivo.

Algunas opciones interesantes son las siguientes:

En la pestaña «Apariencia» se encuentran las opciones relacionadas con el formato del tipo de letra que se usará.

En «Detección de estructura» se puede establecer cómo se detectarán y marcarán los distintos capítulos.

En «Buscar y sustituir», se tiene la posibilidad de reemplazar texto a lo largo del documento. Permite el uso de expresiones regulares.

Añadir los archivos

Para abrir el documento que se quiere agregar se hace usando el botón «Añadir libros» o arrastrando el archivo dentro de la interfaz.

Convertir los archivos

Para iniciar la conversión de los archivos hay que seleccionar el archivo que se quiere convertir y pulsar el botón «Convertir».

Se abrirá la ventana de conversión que dispone de gran cantidad de apartados. En los siguientes capítulos se entrará en detalle con las opciones para la conversión a y desde EPUB.

Se desaconseja convertir desde formato PDF a EPUB mediante Calibre. Es preferible utilizar herramientas de OCR como FineReader que consigue unos resultados más óptimos.

KindleGen

KindleGen es una aplicación de línea de comandos que se utiliza para generar libros electrónicos destinados a la plataforma de Kindle de Amazon. Esta herramienta es la solución ideal para los editores y personas que conocen bien el formato HTML y desean convertir sus archivos fuente EPUB en un e-book de Kindle.

Esta herramienta está disponible para plataformas Windows, Mac y Linux. Además puede utilizarse para automatizar conversiones masivas.

Kindle Previewer

Kindle Previewer es una herramienta que emula la forma en que se visualizarán los libros en los dispositivos y aplicaciones de Kindle. Esta herramienta (usando KindleGen) permite la conversión de libros electrónicos desde su interfaz gráfica. Está disponible tanto para plataformas Windows como para Mac OS X.

Electronic publication (EPUB)

EPUB es el acrónimo de Electronic publication (Publicación electrónica). Es un formato de código abierto para leer textos e imágenes. Fue creado por el International Digital Publishing Forum (IDPF), como un formato específico para visualizar libros.

Se diseñó redimensionable para adaptarse a distintos tamaños de pantalla. Permite incrustar tipos de letra. Los archivos EPUB tienen la extensión «.epub».

Un fichero EPUB consiste en un archivo comprimido Zip que contiene tres ficheros XML basados en tres estándares abiertos, como son Open Publication Structure (OPS), Open Packaging Format (OPF) y OEBPS Container Format (OCF).

A ePub con Calibre

En este apartado se va a explicar cómo convertir desde el formato Mobipocket (.mobi), Kindle Format (.azw3) o FictionBook (.fb2) a EPUB con la herramienta Calibre.

El primer paso es comprobar que están bien seleccionados los formatos de entrada y salida. Después se pueden rellenar los metadatos del archivo para una correcta catalogación del libro.

Los formatos MOBI y AZW3 no tienen perfil de entrada. En cambio, el formato FB2 sí tiene una opción para seleccionar. La casilla se puede dejar como viene por defecto.

Las opciones de salida de EPUB son pocas y están bien explicadas en la ayuda de Calibre. Pueden dejarse como están por defecto.

El resto de paneles contienen las mismas opciones que se vieron en «Preferencias». No es necesario modificarlas salvo casos particulares. Ya estaría todo listo para pulsar «Aceptar».

La conversión se inicia en segundo plano, con un indicador de progreso en la esquina inferior derecha. Si se pulsa sobre el indicador se abre la ventana de tareas donde se muestra el estado y si hubo algún problema.

En la biblioteca de Calibre no se verá ningún libro añadido. Los títulos son los mismos pero al seleccionar el libro se puede comprobar que está disponible en dos formatos.

El ePub creado trae bastante código generado por la aplicación automáticamente. Es necesario limpiar este código en Sigil y adaptarlo a la plantilla de EPL.

Mobipocket (MOBI)

Mobipocket es un formato para libros electrónicos creado por Mobipocket SA. Está basado en las especificaciones Open eBook. Soporta protección DRM. Los archivos Mobipocket utilizan la extensión «.mobi». En el formato se marca el contenido, pero no se delimita su formato, que se adapta a los diferentes tamaños de pantalla.

De ePub a mobi con Calibre

En este apartado se va a explicar cómo convertir desde el formato EPUB a Mobipocket (.mobi) con la herramienta Calibre.

El primer paso es comprobar que están bien seleccionados los formatos de entrada (EPUB) y salida (MOBI). Después se comprueba que los metadatos del archivo estén correctos.

Las opciones de salida se pueden dejar como vienen por defecto. Solo hay que tener en cuenta el dispositivo al que va dirigido el archivo. En «Tipo de archivo MOBI» se puede elegir entre tres tipos: «old» (MOBI clásico), «new» (es internamente un AZW3), y «both» (el mismo archivo contiene ambos formatos).

El resto de paneles contienen las mismas opciones que se vieron en «Preferencias». No es necesario modificarlas salvo casos particulares. Ya estaría todo listo para pulsar «Aceptar».

La conversión se inicia en segundo plano, con un indicador de progreso en la esquina inferior derecha. Si se pulsa sobre el indicador se abre la ventana de tareas donde se muestra el estado y si hubo algún problema.

En la biblioteca de Calibre no se verá ningún libro añadido. Los títulos son los mismos pero al seleccionar el libro se puede comprobar que está disponible en dos formatos.

Para que respete bien el formato del EPUB, fuentes incrustadas incluidas, es preferible el uso del formato AZW3 en lugar de MOBI.

De ePub a mobi con KindleGen

KindleGen es una aplicación de línea de comandos. Para su uso requiere que el usuario tenga unos conocimientos avanzados del sistema operativo. Para un perfil de usuario básico se recomienda el uso de Kindle Previewer.

En primer lugar hay que descargar y descomprimir el archivo en una carpeta del disco.

Mover el archivo EPUB a convertir a la misma carpeta del programa.

Desde el «Terminal» o «Símbolo del sistema» (según el sistema operativo) ejecutar el comando:

kindlegen NOMBRE_ARCHIVO.epub -c2 -locale es

Donde «NOMBRE_ARCHIVO» es el nombre del archivo a convertir.

El archivo generado se ubicará en la misma carpeta.

De ePub a mobi con Kindle Previewer

Para los usuarios que no tengan conocimientos del uso de aplicaciones de línea de comandos tienen la posibilidad de utilizar la interfaz gráfica de Kindle Previewer (solo Windows y Mac).

Una vez descargado e instalado Kindle Previewer, se ejecuta la aplicación.

Se abre el fichero EPUB desde el menú «Archivo» y la opción «Abrir libro».

Seleccionar el e-book para convertir a formato Kindle.

Automáticamente al abrir el libro se convierte a MOBI. En la ventana se muestra un enlace a la carpeta que contiene el archivo generado.

Metadatos

Si en Kindle se desea utilizar el campo «Ordenar como», por encima del simple «Autor», en Calibre debe hacerse lo siguiente:

En el cuadro de conversión, sección «Salida MOBI/AZW3» (flecha azul), activar «Usar el orden de autor como autor(es)».

Kindle Format (AZW3)

Los lectores Kindle de Amazon son los más extendidos actualmente en el mercado. Una de las principales desventajas es el formato de los libros; no guardan compatibilidad con uno de los formatos más empleados en el mundo de la lectura digital, el EPUB.

El formato KF8 (Kindle Format 8) es básicamente un EPUB3 con formato de base de datos Palm (PDB) al que se le ha añadido el DRM de Amazon.

El texto está basado en HTML5. El formato no es HTML5, pues se admiten etiquetas que están obsoletas y no todas las etiquetas de HTML5 están soportadas. La de hojas de estilos está basada en CSS3. De nuevo no todas las etiquetas CSS3 están soportadas. También soporta las fuentes incrustadas.

Un AZW en formato KF8 contiene un fichero MOBI al principio del archivo que tendrá anexado el mismo contenido en formato KF8, asegurando de esta manera la compatibilidad con los antiguos lectores. Desgraciadamente esto duplica el tamaño del archivo.

De ePub a azw3 con Calibre

En este apartado se va a explicar cómo convertir desde el formato EPUB a Kindle Format (.azw3) con la herramienta Calibre.

El primer paso es comprobar que están bien seleccionados los formatos de entrada (EPUB) y salida (AZW3). Después se comprueban que los metadatos del archivo estén correctos.

Las opciones de salida se pueden dejar como vienen por defecto.

El resto de paneles contienen las mismas opciones que se vieron en «Preferencias». No es necesario modificarlas salvo casos particulares. Ya estaría todo listo para pulsar «Aceptar».

La conversión se inicia en segundo plano, con un indicador de progreso en la esquina inferior derecha. Si se pulsa sobre el indicador se abre la ventana de tareas donde se muestra el estado y si hubo algún problema.

En la biblioteca de Calibre no se verá ningún libro añadido. Los títulos son los mismos pero al seleccionar el libro se puede comprobar que está disponible en dos formatos.

Metadatos

Si en Kindle se desea utilizar el campo «Ordenar como», por encima del simple «Autor», en Calibre debe hacerse lo siguiente:

En el cuadro de conversión, sección «Salida MOBI/AZW3» (flecha azul), activar «Usar el orden de autor como autor(es)».

FictionBook (FB2)

FictionBook es un formato abierto para archivos de libros electrónicos creado por un grupo de desarrolladores rusos.

Los archivos usan la extensión «.fb2», aunque a menudo se distribuyen dentro de archivos Zip. La mayoría de hardware y software de los lectores puede trabajar con archivos comprimidos FictionBook (.fb2.zip) directamente.

El formato FictionBook consiste en un único archivo XML (archivo de texto basado en un lenguaje de marcado como el HTML), que contiene los metadatos, el texto y las imágenes. Adicionalmente se puede especificar la forma de presentar los elementos XML usando un subconjunto de atributos basado en el lenguaje CSS. No soporta ningún tipo de DRM.

De ePub a fb2 con Calibre

En este apartado se va a explicar cómo convertir desde el formato EPUB a FictionBook (.fb2) con la herramienta Calibre.

El primer paso es comprobar que están bien seleccionados los formatos de entrada (EPUB) y salida (FB2). Después se comprueban que los metadatos del archivo estén correctos.

Las opciones de salida se pueden dejar como vienen por defecto.

El resto de paneles contienen las mismas opciones que se vieron en «Preferencias». No es necesario modificarlas salvo casos particulares. Ya estaría todo listo para pulsar «Aceptar».

La conversión se inicia en segundo plano, con un indicador de progreso en la esquina inferior derecha. Si se pulsa sobre el indicador se abre la ventana de tareas donde se muestra el estado y si hubo algún problema.

En la biblioteca de Calibre no se verá ningún libro añadido. Los títulos son los mismos pero al seleccionar el libro se puede comprobar que está disponible en dos formatos.

PDF

Para desgracia de los editores, el formato PDF es muy popular y no es infrecuente encontrar en ese formato las fuentes de nuestros aportes. El problema es que, dadas sus características, la conversión de PDF a otro formato es complicada y, en la mayor parte de los casos, con una cantidad de errores tal que la hace casi inservible.

Si nos vemos obligados a trabajar con un PDF como fuente inicial de nuestro aporte, tenemos dos métodos para pasarlo a ePub:

Calibre: usando el método explicado en los capítulos precedentes podemos convertir el PDF a ePub, con la advertencia de que el contenido original ha de estar en formato texto para ser convertido correctamente, en caso contrario se pasará al ePub cada página como imagen. Este método provocará que el ePub resultante esté plagado con el código sucio propio de Calibre, además de los errores propios de la conversión de PDF (párrafos rotos y separados, párrafos fusionados, texto desordenado, texto desaparecido,…).

OCR: las aplicaciones de OCR suelen admitir como material de partida un PDF en vez de una imagen. El archivo se procesará siguiendo los pasos habituales de la aplicación de OCR y el resultado final será por norma general tan válido como cuando se usan imágenes. Este método es el más válido de los dos y funciona tanto si el PDF contiene imágenes como si contiene texto. Se puede ver todo el proceso en el capítulo donde se describe el OCR en el TOMO 2.

Índice temático

Si tienes dudas, nosotros tenemos las preguntas.

Sobre la candidatura a editor

¿Cómo se usa este manual? >>

¿Qué debes saber antes de empezar? >>

¿Qué herramientas necesito para maquetar? >>

¿Cuál es el procedimiento para llegar a ser editor? >>

¿Qué libros puede maquetar un editor? >>

¿Qué libros puede presentar un aspirante en su candidatura a editor? >>

¿Qué número de revisión le pongo a mi libro? >>

¿Qué nombre debo darle a mi epub para poder publicarlo? >>

Sobre la web de ePL

¿Quienes somos y qué hacemos? >>

¿Cómo se rellena la ficha de mi aporte? >>

¿Cómo puedo saber si un libro está reservado? >>

¿Qué hago para introducir un nuevo aporte en la web? >>

¿Cómo creo una nueva colección en otro idioma si tiene el mismo nombre que la colección en español? >>

¿Puedo traspasar el control de mis aportes a otro editor? >>

¿Cómo averiguo las páginas que tiene mi aporte? >>

¿Cómo colocar una portada en la ficha de mi aporte? >>

¿Cómo colocar el magnet en la ficha de mi aporte? >>

¿Cómo comenzar a compartir mi aporte? >>

Sobre los distintos formatos de ebook

¿Qué es un ePub? >>

¿Cómo puedo cambiar el formato (ePub, fb2, azw3,…) de un libro? >>

¿Cómo se instala y prepara Calibre? >>

¿Cómo se prepara KindleGen? >>

¿Cómo se prepara Kindle Previewer? >>

¿Cómo uso Calibre para pasar cualquier formato a ePub? >>

¿Cómo uso Calibre para pasar de ePub a mobi? >>

¿Cómo uso KindleGen para pasar de ePub a mobi? >>

¿Cómo uso Kindle Previewer para pasar de ePub a mobi? >>

¿Cómo uso Calibre para pasar de ePub a azw3? >>

¿Cómo uso Calibre para pasar de ePub a fb2? >>

Sobre Sigil

¿Qué es Sigil? >>

¿Cómo puedo instalar Sigil? >>

¿Cómo cambio el idioma de Sigil? >>

¿Cómo hago para que Sigil me arregle o deje de arreglarme el código incorrecto? >>

¿Cómo se instala el diccionario de ePL en Sigil? >>

¿Qué aspecto tiene Sigil? >>

¿Cómo se abre un documento en Sigil? >>

¿Cómo se guarda el trabajo en Sigil? >>

¿Cómo hacer copias de seguridad en Sigil? >>

¿Qué es la vista de código de Sigil? >>

¿Qué es la vista de libro de Sigil? >>

¿Qué es la vista previa de Sigil? >>

¿Cómo funciona «deshacer» en Sigil? >>

¿Cómo dividir un capítulo en dos ficheros con Sigil? >>

¿Cómo unir dos ficheros en uno solo con Sigil? >>

¿Cómo sacar los ficheros que forman un ePub a una carpeta de mi ordenador? >>

¿Cómo añadir ficheros de mi ordenador en un ePub? >>

¿Cómo cambiarle el nombre a los ficheros que forman parte de un ePub? >>

¿Cómo puedo escribir código dentro de mi libro? >>

¿Qué herramientas nos proporciona Sigil? >>

¿Cómo añadir nuevos capítulos a mi libro? >>

Sobre el ePub Base

¿Qué es la plantilla, eso que llaman ePub Base? >>

¿Cómo se trabaja con el ePub Base? >>

¿Cómo cumplimento las páginas obligatorias del ePub Base? >>

¿Cómo se cumplimenta la página de la cubierta? >>

¿Cómo añado una sinopsis a mi libro? >>

¿Cómo cumplimento la página de título de mi libro? >>

¿Cómo cumplimento la página info de mi libro? >>

¿Cómo poner una dedicatoria en mi libro? >>

¿Cómo poner la biografía del autor de mi libro? >>

¿Cómo detecto los errores en el código estándar del ePub Base? >>

Sobre la corrección del libro

¿Cómo puedo localizar las erratas de mi libro? >>

¿Cómo se corrigen los errores producidos por caracteres especiales? >>

Sobre el código usado en los ePub

¿Qué es HTML? >>

¿Qué es CSS? >>

¿Qué es la hoja de estilos? >>

¿Cómo pongo nuevos estilos a mi libro? >>

¿Cómo hacer que mi libro tenga un aspecto homogéneo? >>

¿Qué es el código sucio? >>

¿Cómo limpio el código sucio? >>

¿Cómo encontrar las diferencias entre dos fuentes del mismo libro? >>

¿Cómo arreglar los errores en el código? >>

¿Cómo se simplifica el código? >>

¿Cómo arreglar los estilos que no funcionan bien? >>

¿Cómo consigo poner en mi libro los signos que no están en el teclado? >>

Sobre los metadatos

¿Cómo cambio los metadatos de mi libro? >>

¿Qué es el Book-Id, cómo consigo uno y qué hago con él? >>

¿Podemos ver lo de los metadatos con más detalle? >>

¿Qué es eso de «ordenar como» (file-as) de los nombres de los autores? >>

¿Qué son y cómo se usan los géneros y subgéneros? >>

Sobre la TOC

¿Qué es la TOC y cómo la hago? >>

¿Cómo pongo la TOC a mi gusto? >>

¿Es obligatorio el archivo TOC.xhtml? >>

Sobre las RegEx

¿Qué son las RegEx? >>

¿Cómo se instalan las RegEx? >>

¿Cómo se usan las RegEx? >>

Sobre la validación del ePub

¿Cómo detecto errores con el validador de Sigil? >>

¿Cómo detecto errores con el ePubCheck? >>

¿Qué es la validación? >>

¿Cómo se valida con FlightCrew? >>

¿Cómo se valida con ePubCheck? >>

¿Cómo se valida con ePLValidator? >>

¿Qué errores soluciona automáticamente el ePLValidator? >>

¿Cómo se soluciona el error «your OPF file was broken»? >>

¿Cómo se soluciona el error producido por las fechas de publicación muy antiguas? >>

¿Cómo se soluciona el error provocado por los archivos innecesarios? >>

¿Cuáles son los errores que muestra FlightCrew? >>

¿Cuáles son los errores que muestra ePubCheck? >>

¿Cuáles son los errores que muestra ePLValidator? >>

Sobre las imágenes

¿Cómo puedo poner el logo en la portada? >>

¿Cómo poner mi propia portada o mi propia foto del autor en mi libro? >>

¿Dónde puedo encontrar portadas para mi libro? >>

¿Cómo insertar una imagen en mi libro de forma fácil? >>

¿Cómo poner una imagen dentro de mi libro usando código? >>

¿Cómo averiguar si se han usado todas las imágenes? >>

Sobre las notas

¿Cómo pongo las notas a pie de página? >>

¿Cómo arreglar errores en los enlaces de las notas? >>

Agradecimientos (Ed. 2018)

Quisiera dar las gracias a barbanegra y Rusli por tomarse la molestia de revisar la documentación existente y organizar las pruebas para el nuevo ePub Base, sin cuya actualización este nuevo manual no hubiera sido posible (o hubiera sido totalmente diferente). Y especialmente a Horus, por revisar la sección sobre HTML.

También agradecer a Sagitario y Sedna su intensa revisión de todo el manual, a la búsqueda de aquellas cosas ya obsoletas o incompatibles con el nuevo estándar, actualizando etiquetas, eliminando estilos no usados y renovando algunas imágenes.

Y, como siempre, a todos aquellos que han colaborado en las pruebas del ePub Base, el ePLValidator y demás herramientas en el foro, o bien reportando erratas y errores del propio manual. Sin vuestra ayuda, esto no hubiera sido posible.

Muchas gracias a todos los que con vuestro tiempo e ilusión hacéis posible este Proyecto. Espero que podamos seguir compartiendo nuestra afición por muchos años y veamos muchas y mejoradas revisiones de todas las herramientas EPL.

Más libros, más libres.

Fénix

Agradecimientos (Ed. 2015)

Este manual ha sido elaborado por y para la comunidad del Proyecto Scriptorium, y no habría sido posible sin la colaboración desinteresada de muchas personas, algunas de las cuales paso a nombrar. No están todas las que son, pero son todas las que están. Espero que aquellas que inadvertidamente he omitido, me perdonen por ello.

Para empezar, quisiera dar las gracias a TaliZorah, por organizarlo cuando yo no tenía tiempo para ello, y a Mowgli, Cthulhu e Insaciable, por su colaboración inicial. A Sedna por su incansable búsqueda de códigos CSS para una maquetación avanzada. A gertdelpozo y a los demás integrantes del equipo gráfico, por los apartados de portadas y edición de imágenes. A emiferro, Horus, triangulín y Áuryn, por encargarse entre todos de darle forma. A Trujano, por su breve pero intensa colaboración a la hora de redactar los apartados que no quería nadie. A barbanegra, por tomarse la molestia de revisar y unificar el desaguisado que habíamos montado entre todos. Y finalmente, a aquellos colaboradores que han preferido permanecer en el anonimato, y que espero sigan colaborando en futuras revisiones.

Asimismo, quisiera agradecer también a todos aquellos que con sus consejos y manuales en el foro, y su deseo de mejorar continuamente las herramientas existentes, han ayudado a mejorar la calidad de la biblioteca e, inadvertidamente, también la del presente manual. Y muy especialmente a los encargados de crear y mantener dichas herramientas: Carlos., Jugaor, betatron, Tarloth, Mcphist y capitancebolleta.

Por último, pero no por ello menos importante, me gustaría nombrar a Werth, cuyo manual inicial, en una página ya desaparecida, fue la semilla que sirvió de base para crear la excelente herramienta para la maquetación que tienes ahora entre tus manos.

Muchas gracias a todos los que con vuestro tiempo e ilusión hacéis posible este Proyecto. Espero que podamos seguir compartiendo nuestra afición por muchos años y veamos muchas y mejoradas revisiones de todas las herramientas EPL.

Más libros, más libres.

Fénix

PROYECTO SCRIPTORIUM (23 de abril de 2013).

El Proyecto Scriptorium surgió cuando un grupo de editores fueron expulsados de la página en la que se encontraban por protestar por los cambios que, tras la venta de la página, se realizaron sin consultarles. Cambios que incluían la implantación de malware en las descargas, lucro (para los nuevos dueños) y censura.

Por ese motivo, en octubre de 2012 se creó un foro de emergencia (conocido como el «tk», ya que esa era su extensión), para tratar de seguir con su hobby, la maquetación de libros electrónicos, y para buscar una forma de ponerlos a disposición de todo el mundo de forma libre y gratuita.

El 23 de abril de 2013, tras 7 meses de gestación y coincidiendo con la celebración del día del libro, el escaparate del proyecto, la web epublibre.org, abrió sus puertas.

En el tiempo transcurrido, ha habido gente que se ha distanciado del proyecto, y otros nuevos han llegado para ocupar su lugar, convirtiéndose en algo dinámico y vivo, y que esperamos permanezca mucho tiempo, bajo la forma que sea, como un faro de referencia a nivel cultural y de calidad en las maquetaciones.

Más libros, más libres.