EPUBCheck · Obrazy, dźwięk i nakładki multimedialne

EPUBCheck MED_017: overlay fragment nie jest id

Zaktualizowane: 4 listopada 2026

EPUBCheck MED_017 jest komunikatem ostrzegawczym: „URL fragment should indicate an element ID, but found '#…'.” Odwołanie tekstowe w media overlay używa fragmentu, który nie jest identyfikatorem elementu. Dla XHTML rozdziałów, EPUB zaleca wskazanie elementu przez jego id; inne schematy fragmentów mogą nie być wspierane przez aplikacje do czytania. EPUBCheck ostrzega i pokazuje fragment.

Oficjalna wiadomość

URL fragment should indicate an element ID, but found '#%1$s'.

Domyślna powaga: Ostrzeżenie. EPUB jest wciąż ważny, ale coś może powodować problemy w niektórych aplikacjach do czytania. EPUBCheck kończy działanie z wynikiem 0, chyba że przekażesz --failonwarnings.
Wersja EPUBCheck: 5.4.0

EPUBCheck drukuje ten identyfikator z podkreśleniem zamiast myślnika; ta strona używa identyfikatora dokładnie tak, jak EPUBCheck go raportuje.

%1$s, %2$s… wypełnione są plikiem, wartością lub elementem EPUBCheck znalezionym.

Typowe przyczyny

Schematy fragmentów tekstu lub przesunięć znaków napisane przez narzędzie do wyrównania.
Fragment z literówką lub wiodącym znakiem, który nie jest częścią identyfikatora.

Jak to naprawić

Nadaj frazie element z identyfikatorem w rozdziale, na przykład <span id="s12">.
Wskaż src tekstu na to, jak chapter1.xhtml#s12.
Odbuduj EPUB i uruchom ponownie EPUBCheck, aby potwierdzić, że komunikat zniknął.

Kiedy to nie to

Jeśli cel jest dokumentem SVG, fragment powinien być identyfikatorem fragmentu SVG (MED_018).

Terminy używane tutaj

Inne komunikaty MED

MED_016 Media Overlays total duration should be the sum of the durations of all Media Overlays documents.
MED_018 URL fragment should be an SVG fragment identifier, but found '#…'.
MED_015 Media overlay text references must be in reading order. Text target "…" is before the previous link target in … order.
MED_014 Media overlay audio file URLs must not have a fragment, but found '#…'.
MED_013 Media Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_012 The "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.

Źródła

EPUB 3.3, §9.3.2.2 Referencing document fragments · czytaj 4 listopada 2026

Tekst wiadomości i poważność z EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Wyjaśnienie przez EpubCC.

FAQ

Co oznacza EPUBCheck MED_017?

Czy MED_017 to błąd?

MED_017 jest zgłaszane jako ostrzeżenie domyślnie. EPUB jest nadal ważny, ale coś może spowodować problemy w niektórych aplikacjach do czytania. EPUBCheck kończy z 0, chyba że przekażesz --failonwarnings.