EPUBCheck · Paquete y contenedor ZIP

EPUBCheck PKG-001: discrepancia de versión EPUB

Actualizado: 4 de noviembre de 2026

EPUBCheck PKG-001 es un mensaje de advertencia: “Validating the EPUB against version … but detected version ….” EPUBCheck fue instruido para validar una versión EPUB pero el documento del paquete declara otra. La versión proviene del atributo version del elemento package, y EPUBCheck informa la discrepancia como una advertencia antes de aplicar las reglas de la versión que solicitaste.

El mensaje oficial

Validating the EPUB against version %1$s but detected version %2$s.

Severidad por defecto: Advertencia. El EPUB sigue siendo válido, pero es probable que algo cause problemas en algunas aplicaciones de lectura. EPUBCheck sale con 0 a menos que pases --failonwarnings.
versión de EPUBCheck: 5.4.0

%1$s, %2$s… se completan con el archivo, valor o elemento EPUBCheck encontrado.

Causas típicas

EPUBCheck se ejecutó con -v 2.0 o -v 3.0 y el elemento de paquete del archivo tiene un atributo de versión diferente.
Un script de construcción o un servicio de validación que siempre pasa la misma opción -v, sea cual sea el libro.
Un libro medio convertido de EPUB 2 a EPUB 3 cuyo atributo de versión no fue actualizado.

Cómo arreglarlo

Ejecute EPUBCheck sin -v en un archivo .epub empaquetado: lee la versión del documento del paquete.
Si el atributo de versión es incorrecto, configúralo a la versión que el contenido realmente sigue: version="3.0" para EPUB 3.
Valida nuevamente y corrige los mensajes para la versión correcta.

Cuándo no es esto

Si EPUBCheck dice que está validando contra 2.0 con el perfil por defecto, eso es la informativa PKG-023, no una discrepancia.

Términos usados aquí

Otros mensajes de PKG

PKG-003 Unable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004 Corrupted EPUB ZIP header.
PKG-005 The mimetype file has an extra field of length …. The use of the extra field feature of the ZIP format is not permitted for the mimetype file.
PKG-006 Mimetype file entry is missing or is not the first file in the archive.
PKG-007 The content of the mimetype file must be the string "application/epub+zip"…
PKG-008 Unable to read file "…".

Fuentes

EPUB 3.3, §5.4 The package element · leer 4 de noviembre de 2026
EPUBCheck wiki: Running EPUBCheck (command-line options) · leer 4 de noviembre de 2026

Texto y severidad del mensaje de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicación por EpubCC.

FAQ

¿Qué significa EPUBCheck PKG-001?

¿Es PKG-001 un error?

PKG-001 se informa como advertencia por defecto. El EPUB sigue siendo válido, pero algo puede causar problemas en algunas aplicaciones de lectura. EPUBCheck sale con 0 a menos que pases --failonwarnings.