EPUBCheck · Documento de paquete (OPF)

EPUBCheck OPF-003: archivo faltante en el manifiesto

Actualizado: 4 de noviembre de 2026

EPUBCheck OPF-003 es un mensaje de uso: “Item "…" exists in the EPUB, but is not declared in the OPF manifest.” Un archivo está en el archivo pero no declarado en el manifiesto. Las aplicaciones de lectura funcionan a partir del manifiesto, por lo que un archivo no declarado puede ser ignorado; esta es una nota de uso, mostrada solo cuando EPUBCheck se ejecuta con -u.

El mensaje oficial

Item "%1$s" exists in the EPUB, but is not declared in the OPF manifest.

Severidad por defecto: Uso. Informativo solo y oculto por defecto: aparece cuando EPUBCheck se ejecuta con -u (--usage). No hace que el EPUB sea inválido.
versión de EPUBCheck: 5.4.0

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

Causas típicas

Archivos del sistema sobrantes como .DS_Store o Thumbs.db comprimidos junto con el libro.
Imágenes antiguas, copias de seguridad o borradores que quedaron en la carpeta del libro después de editar.
Un archivo nuevo añadido a la carpeta sin actualizar el manifiesto.

Cómo arreglarlo

Mira los nombres de archivo EPUBCheck y decide si el libro lo utiliza.
Si el libro no lo utiliza, elimínalo de la carpeta y vuelve a construir el archivo.
Si el libro lo utiliza, añade un elemento de manifiesto con un id único, su ruta y su tipo de medio, por ejemplo <item id="img2" href="images/map.png" media-type="image/png"/>.

Cuándo no es esto

Si el archivo no declarado también está referenciado en el contenido, EPUBCheck informa sobre RSC-008 también, que es el que debes corregir primero.

Términos usados aquí

Otros mensajes de OPF

OPF-002 The OPF file "…" was not found in the EPUB.
OPF-004 Invalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-001 There was an error when parsing the EPUB version: ….
OPF-005 Invalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006 Invalid prefix declaration: URI "…" is not a valid URI.
OPF-007 Re-declaration of reserved prefix "…".

Fuentes

EPUB 3.3, §5.6.2 The item element · 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 OPF-003?

¿Es OPF-003 un error?

OPF-003 se informa como uso por defecto. Solo informativo y oculto por defecto: aparece cuando EPUBCheck se ejecuta con -u (--usage). No hace que el EPUB sea inválido.