Saltar al contenido
EPUBCheck · Documento de paquete (OPF)

EPUBCheck OPF-004: atributo de prefijo malformado

Actualizado:

EPUBCheck OPF-004 es un mensaje de advertencia: “Invalid prefix declaration: leading or trailing whitespace is not allowed.” El atributo de prefijo en el elemento del paquete no está escrito en la sintaxis que EPUB requiere. Ese atributo mapea prefijos cortos (como ibooks) a URIs de vocabulario, y EPUBCheck informa sobre cada tipo de error de sintaxis con su propia variante de OPF-004.

El mensaje oficial

Invalid prefix declaration: leading or trailing whitespace is not allowed.

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

Causas típicas

  • OPF-004: espacios o saltos de línea al inicio o al final del valor del atributo; OPF-004a: un prefijo vacío, un dos puntos sin nombre antes de él.
  • OPF-004b: un nombre de prefijo que no es un nombre XML válido (NCName), por ejemplo uno que comience con un dígito o contenga una barra; OPF-004c: un espacio entre el nombre y su dos puntos, como en "ibooks : http://…".
  • OPF-004d: sin espacio entre los dos puntos y el URI, como en "ibooks:http://…"; OPF-004e: una tabulación, salto de línea u otro espacio en blanco ilegal entre el prefijo y el URI.
  • OPF-004f: mapeos separados por algo que no sea un espacio en blanco simple, o juntos.

Cómo arreglarlo

  1. Encuentra el atributo prefix en el elemento package del archivo .opf.
  2. Escribe cada asignación como el nombre de prefijo, dos puntos, un espacio y la URI del vocabulario, y separa las asignaciones con espacios en blanco, por ejemplo prefix="ibooks: http://vocabulary.itunes.apple.com/rdf/ibooks/vocabulary-extensions-1.0/ foaf: http://xmlns.com/foaf/spec/".
  3. Elimina los espacios en blanco al principio y al final del valor, da a cada mapeo un nombre que comience con una letra (solo letras, dígitos, guiones y guiones bajos), y coloca el dos puntos justo después del nombre.
  4. Los prefijos reservados como dcterms, rendition y schema no necesitan declaración, por lo que a menudo puedes eliminar el atributo por completo si solo mapea esos.

Cuándo no es esto

Si la sintaxis es correcta pero un prefijo no tiene URI o tiene una inválida, eso es OPF-005 o OPF-006.

También reportado como

  • OPF-004a (error): Invalid prefix declaration: found empty prefix.
  • OPF-004b (error): Invalid prefix "%1$s": must be a valid non-colonized name (aka "NCName").
  • OPF-004c (error): Invalid prefix declaration: prefix "%1$s" must be immediately followed by a colon character (":").
  • OPF-004d (error): Invalid prefix declaration: prefix "%1$s" must be separated by its URI with a space.
  • OPF-004e (advertencia): Invalid prefix declaration: found illegal whitespace between prefix and URI.
  • OPF-004f (advertencia): Invalid prefix declaration: found illegal whitespace between prefix mappings.

Términos usados aquí

Otros mensajes de OPF

  • OPF-003 Item "…" exists in the EPUB, but is not declared in the OPF manifest.
  • OPF-005 Invalid prefix declaration: URI for prefix "…" doesn’t exist.
  • OPF-002 The OPF file "…" was not found in the EPUB.
  • OPF-006 Invalid prefix declaration: URI "…" is not a valid URI.
  • OPF-001 There was an error when parsing the EPUB version: ….
  • OPF-007 Re-declaration of reserved prefix "…".

Fuentes

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

FAQ

¿Qué significa EPUBCheck OPF-004?

EPUBCheck OPF-004 es un mensaje de advertencia: “Invalid prefix declaration: leading or trailing whitespace is not allowed.” El atributo de prefijo en el elemento del paquete no está escrito en la sintaxis que EPUB requiere. Ese atributo mapea prefijos cortos (como ibooks) a URIs de vocabulario, y EPUBCheck informa sobre cada tipo de error de sintaxis con su propia variante de OPF-004.

¿Es OPF-004 un error?

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

Herramientas de PDF a EPUB

Cada herramienta utiliza el mismo motor. Hasta 3 libros al día son gratuitos.

Ver todas las herramientas