Generar archivos exportados

Corregir errores de validación

Los archivos EPUB y PDF de Pressbooks están hechos para ser compatibles con las especificaciones de envío de las principales tiendas de libros electrónicos y servicios de impresión bajo demanda. Sin embargo, a veces el marcado que no es compatible con los formatos de archivo EPUB o PDF puede ser importado a Pressbooks cuando usted trae su contenido. Le recomendamos que pruebe sus archivos antes de enviarlos al distribuidor de su elección para asegurarse de que cumplen todas las especificaciones.

Envíe sus propios registros de validación por correo electrónico

Puede decidir si quiere recibir o no los registros de validación de todos sus archivos exportados. Para activar o modificar esta configuración:

  1. Vaya a Configuración > Exportación en el menú de la barra lateral izquierda de Pressbooks
  2. Junto a «Registros de validación por correo electrónico», elija «Sí» o «No».
  3. Haga clic en Guardar cambios

Por defecto, la configuración del registro de validación de correo electrónico de todos los libros está establecida en «No. Ignorar errores de validación». Si elige recibir los registros de validación (o informes de errores) de Pressbooks, todos los registros de errores de validación de archivos se enviarán a la dirección de correo electrónico asociada a su cuenta de Pressbooks.

Export Settings screen on Pressbooks.com

Después, recibirás un mensaje cada vez que cualquier archivo que exportes tenga un error. Sabrás que los archivos exportados contienen errores si ves un cartel en la parte superior de la pantalla de exportación que dice «Advertencia: La exportación tiene errores de validación. Consulte los registros para obtener más detalles».

Export validation error banner on the Exports screen.

Cada tipo de archivo se valida con arreglo a normas diferentes, por lo que sus registros de validación también serán diferentes.

Interpretar los registros de validación de EPUB

Los registros de validación de EPUB aparecerán en su bandeja de entrada de correo electrónico con el siguiente asunto: Pressbooks\Modules\Export\Epub\

A continuación, se muestra un ejemplo de cómo puede ser un informe de error.

Array
(
[time] => Mon Dec 10 22:17:33 2018
[user] => tmcgrath
[site_url] => https://yourbooktitle.pressbooks.com/wp
[blog_id] => 107381
[theme] => Atwood
)
ERROR(RSC-020): /srv/www/pressbooks.com/releases/20181205114740/web/app/uploads/sites/107381/pressbooks/exports/Test-Book-2-1544480239.epub/OEBPS/chapter-056-your-chapter.html(26,268): ‘http://bit.ly/btb-v092″>http://bit.ly/btb-v092′ is not a valid URL.

Check finished with errors.

Este ejemplo de registro de validación puede dividirse en secciones. La parte inicial incluye metadatos específicos sobre su libro. Verá la hora en que se exportó el libro, el nombre de usuario de la persona que exportó el libro y la URL del libro en Pressbooks, su número de identificación y su tema. El propio mensaje de error incluye varios datos importantes:

ERROR(RSC-020): La Sección entre paréntesis se refiere al tipo de error de validación producido por EPUBCheck. Este código de error en particular se muestra cuando el validador encuentra una URL no válida.

/srv/www/pressbooks.com/releases/20181205114740/web/app/uploads/sites/107381/pressbooks/exports/Test-Book-2-1544480239.epub/OEBPS/chapter-035-your-chapter.html: La parte en negrita de esta cadena le indica en qué parte del archivo EPUB se encontró el error de validación. En este ejemplo, el mensaje nos dice que el error se produjo en el capítulo 35, que se ha titulado «Tu capítulo». Si has guardado un capítulo antes de darle un título, esta URL tendrá el slug generado aleatoriamente en lugar del título del capítulo.

(26,268): El último dato de esta URL es la línea y el carácter exactos en los que se produce el error en el HTML de su archivo EPUB. Puedes descomprimir tu archivo EPUB y utilizar un editor de texto (o Calibre) para abrir el archivo en cuestión e inspeccionar la ubicación exacta.

‘http://bit.ly/btb-v042″>http://bit.ly/btb-v042’ is not a valid URL: Esta Sección del mensaje nos da más información sobre el RSC-020 (error de URL no válida). En este caso, el mensaje de error ha proporcionado el texto ofensivo que debería ayudarle a encontrar y solucionar más rápidamente el problema en el capítulo correspondiente.

Interpretar los registros de validación de PDF

Los archivos PDF suelen tener menos errores de validación que los archivos de libros electrónicos. Sin embargo, a veces se producen errores. Los registros de validación de PDF aparecerán en su bandeja de entrada de correo electrónico con la línea de asunto: Pressbooks\Modules\Export\Prince\Pdf

A continuación se muestra un ejemplo de cómo puede ser el registro de validación de un PDF.

Array
(
[time] => Tue Sep 19 01:09:21 2017
[user] => tmcgrath
[site_url] => https://yourbooktitle.pressbooks.com
[blog_id] => 64631
[theme] => Adunis
[url] => http://yourbooktitle.pressbooks.com/format/xhtml?timestamp=1505783354&hashkey=d5f7474bad00cfde913572c9fe1caaa9&pb-latex-zoom=3&fullsize-images=1
)
Mon Sep 18 21:09:16 2017: —- begin
Mon Sep 18 21:09:20 2017: page 163: warning: no font for Emoticons character U+1F609, fallback to ‘?’
Mon Sep 18 21:09:21 2017: finished: success
Mon Sep 18 21:09:21 2017: —- end

El registro de validación de PDF es sencillo; verá las marcas de fecha para el comienzo, los errores marcados, el final exitoso y el final del proceso. La única Sección que tendrá que mirar es el error.

Encuentre un error buscando la palabra «warning«. Cada advertencia comenzará con una marca de tiempo. Después, verás una descripción del error. En el ejemplo anterior, en la página 163, el convertidor de PDF no pudo encontrar una fuente en el archivo que proporcionara el carácter del emoticono introducido por el usuario.

Para resolver un error como el anterior, el usuario puede encontrar el número de página del informe de error, ir a su capítulo en Pressbooks y eliminar el emoticono que causó el problema.

Registros de validación de errores de SASS

Los errores SASS informan de problemas con el CSS (hoja de estilo en cascada) de tu libro. Los errores SASS aparecen en su bandeja de entrada de correo electrónico con el asunto: Error SASS.

A continuación se muestra un ejemplo de cómo puede ser un error SASS.

Array
(
[time] => Sun Dec  9 23:44:51 2018
[user] => mcgratay
[site_url] => https://yourbooktitle.pressbooks.com/wp
[blog_id] => 112926
[Exception] => Array
(
=> 0
  [error] => unclosed block: failed at `` (stdin) on line 49
[file] => /srv/www/pressbooks.com/releases/20181205114740/vendor/leafo/scssphp/src/Parser.php
[line] => 128
[trace] => #0 /srv/www/pressbooks.com/releases/20181205114740/vendor/leafo/scssphp/src/Parser.php(173): Leafo\ScssPhp\Parser->throwParseError('unclosed block')
#1 /srv/www/pressbooks.com/releases/20181205114740/vendor/leafo/scssphp/src/Compiler.php(197): Leafo\ScssPhp\Parser->parse('$chapter: 'Chap...')
#2 /srv/www/pressbooks.com/releases/20181205114740/web/app/plugins/pressbooks/inc/class-sass.php(183): Leafo\ScssPhp\Compiler->compile('$chapter: 'Chap...')
#3 /srv/www/pressbooks.com/releases/20181205114740/web/app/plugins/pressbooks/inc/class-styles.php(468): Pressbooks\Sass->compile('$chapter: 'Chap...', Array)
#4 /srv/www/pressbooks.com/releases/20181205114740/web/app/plugins/pressbooks/inc/modules/export/prince/class-pdf.php(245): Pressbooks\Styles->customize('prince', '\n\n@prince-pdf {...', '\n\n@prince-pdf {...')
#5 /srv/www/pressbooks.com/releases/20181205114740/web/app/plugins/pressbooks/inc/modules/export/prince/class-docraptor.php(55): Pressbooks\Modules\Export\Prince\Pdf->kneadCss()
#6 /srv/www/pressbooks.com/releases/20181205114740/web/app/plugins/pressbooks/inc/modules/export/class-export.php(744): Pressbooks\Modules\Export\Prince\Docraptor->convert()
#7 /srv/www/pressbooks.com/releases/20181205114740/web/wp/wp-includes/class-wp-hook.php(286): Pressbooks\Modules\Export\Export::formSubmit('')
#8 /srv/www/pressbooks.com/releases/20181205114740/web/wp/wp-includes/class-wp-hook.php(310): WP_Hook->apply_filters(NULL, Array)
#9 /srv/www/pressbooks.com/releases/20181205114740/web/wp/wp-includes/plugin.php(453): WP_Hook->do_action(Array)
#10 /srv/www/pressbooks.com/releases/20181205114740/web/wp/wp-settings.php(450): do_action('init')
#11 /srv/www/pressbooks.com/releases/20181205114740/web/wp-config.php(9): require_once('/srv/www/pressb...')
#12 /srv/www/pressbooks.com/releases/20181205114740/web/wp/wp-load.php(42): require_once('/srv/www/pressb...')
#13 /srv/www/pressbooks.com/releases/20181205114740/web/wp/wp-admin/admin.php(31): require_once('/srv/www/pressb...')
#14 {main}
))

Los errores SASS son producidos por un CSS mal formado y suelen ser provocados por algo que has añadido utilizando la función de Estilos Personalizados. La parte importante del error SASS es la información que viene después:

  [error] =>

En el ejemplo anterior, el error en el CSS es un "bloque no cerrado". El registro de errores indica que el bloque ha fallado en la línea 49. Puede ir a su CSS, encontrar la línea 49 y modificar el CSS para resolver el error. En este error, el usuario olvidó añadir un corchete de cierre "}" a sus estilos personalizados. La herramienta de validación de CSS del W3C puede ser muy útil para ayudarle a averiguar el origen de los errores en su CSS personalizado (y cómo resolverlos).

Este capítulo es una adaptación de Fix Validation Errors en Pressbooks User Guide por Pressbooks.

Licencia

Icono de Licencia Creative Commons Atribución 4.0 Internacional

Excepto cuando se especifiquen otros términos, Manual de usuario de Libros Multimedia por Pressbooks se distribuye bajo una Licencia Creative Commons Atribución 4.0 Internacional.

Compartir este libro