EPUBCheck · Documents de contenu XHTML

EPUBCheck HTM-007 : prononciation ssml:ph vide

Mis à jour : 4 novembre 2026

EPUBCheck HTM-007 est un message d'avertissement : “Empty or whitespace-only value of attribute ssml:ph.” Un attribut ssml:ph est vide ou ne contient que des espaces. L'attribut donne une prononciation phonétique pour le texte à voix haute, donc un attribut vide ne fournit rien au moteur de synthèse vocale.

Le message officiel

Empty or whitespace-only value of attribute ssml:ph.

Gravité par défaut: Avertissement. Le EPUB est toujours valide, mais quelque chose risque de causer des problèmes dans certaines applications de lecture. EPUBCheck sort avec 0 sauf si vous passez --failonwarnings.
version EPUBCheck: 5.4.0

Causes typiques

Un attribut de prononciation ajouté par un outil ou un modèle et jamais rempli.
Une valeur supprimée manuellement tout en gardant l'attribut.

Comment le corriger

Ouvrez le fichier EPUBCheck (le message indique le chemin, la ligne et la colonne) dans un éditeur de texte ou EPUB tel que Sigil, ou décompressez le EPUB et ouvrez-le là.
Remplissez la prononciation dans l'alphabet que le document déclare (ssml:alphabet), ou retirez l'attribut ssml:ph.
Si aucun élément n'utilise plus SSML, supprimez également la déclaration xmlns:ssml.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Cela concerne uniquement les indications de prononciation SSML ; cela ne dit rien sur la narration des médias overlays.

Termes utilisés ici

Qu'est-ce que XHTML dans EPUB ?

Autres messages HTM

HTM-009 The DOCTYPE provided is obsolete or irregular and can be removed.
HTM-004 Irregular DOCTYPE: found "…", expected "…".
HTM-010 Namespace "…" is unusual for the prefix "epub".
HTM-003 External entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-011 Entity is undeclared.
HTM-001 Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….

Sources

EPUBCheck 5.4.0 message texts (MessageBundle.properties, w3c/epubcheck on GitHub) · lire 4 novembre 2026

Texte et gravité du message de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explication par EpubCC.

FAQ

Que signifie EPUBCheck HTM-007 ?

Est-ce que HTM-007 une erreur ?

HTM-007 est signalé par défaut comme avertissement. Le EPUB est toujours valide, mais quelque chose pourrait causer des problèmes dans certaines applications de lecture. EPUBCheck se termine avec 0 à moins que vous passiez --failonwarnings.