EpubCheck はEPUBの検証ソフトウェアで、EPUBが正しく作られているのかを確認する上で欠かせないツールです。

しかし、出力されるメッセージが日本語化されていないことや、メッセージの内容の専門性が高いため対処に困る人もいることでしょう。このページではメッセージの意味を日本語で解説し、代表的な対処方法について紹介します。

メッセージの一覧と分類は、”EPUB 3 Best Practices” の記載を参考にしました。この本の翻訳ではありません。

公開日
2013-5-20
最終更新日
2013-5-28
作成者
ろす (@lost_and_found) from 電書ちゃんねる

XMLファイルに共通するエラー

文書のエラー

メッセージ
Content is not allowed in prolog
意味

プロローグ部分にはコンテンツを記述できません

原因と対処

ルート要素よりも前にテキストノードが存在していることが原因です。ルート要素より前にはXML処理命令とDOCTYPE宣言しか記述することはできません。問題のある記述部分を取り除いてください。

下の例はDOCTYPE宣言とルート要素の間にテキストノードを記述しているためエラーとなります(こんなところにネタバレ書かないでください)。

<?xml version="1.0" encoding="UTF-8"?><!-- XML宣言 -->
<!DOCTYPE html><!-- DOCTYPE宣言 -->
犯人はヤス
<html xmlns="http://www.w3.org/1999/xhtml"><!-- ルート要素 -->
…
</html>

メッセージ
Content is not allowed in trailing section
意味

ルート要素よりも後ろのセクションにはコンテンツを記述できません

原因と対処

ルート要素よりも後ろにテキストノードが存在していることが原因です。問題のある記述部分を取り除いてください。

下の例はルート要素以降にテキストノードを記述しているためエラーとなります。

<?xml version="1.0" encoding="UTF-8"?><!-- XML宣言 -->
<package xmlns="http://www.idpf.org/2007/opf" …><!-- ルート要素 -->
…
</package><!-- ルート要素の終わり -->
かゆい
うま

要素のエラー

メッセージ
Element [要素名A] not allowed here; expected the element end-tag, text or element [要素名B]
意味

ここには [要素名A] を記述できません。(閉じタグ、テキスト、 [要素名B])である必要があります

原因と対処

正しい構文に従って要素が使われていない場合に表示されます。特にXHTMLの一部の要素では、中に書くことのできる要素が決まっています。問題のある要素の親要素との関係に注意してください。またタグの閉じ忘れがある場合も考えられます。


メッセージ
Element [要素名A] incomplete; expected [要素名B]
意味

[要素名A] が不完全です。[要素名B]が必要です

原因と対処

[要素名A]の中に、必要なはずの[要素名B]が欠けていることが原因です。例えばパッケージ文書の metadata 要素には、 dc:titledc:identifierdc:language が必要です。[要素名B]を加えてください。


メッセージ
The prefix [接頭辞名] for element [要素名] is not bound
意味

[要素名]の[接頭辞名]に関連付けがありません

原因と対処

名前空間宣言を行わずにdc などの接頭辞を利用した場合に出力されます。接頭辞に対応した名前空間宣言を行なってください。

次の例では dc の接頭辞が何の名前空間を指すのかわからないためエラーとなります。

<metadata>
<dc:title>タイトル</dc:title>
…
</metadata>

次は正しい例です。名前空間宣言によって接頭辞 dc をダブリンコアメタデータ要素集合の名前空間に結びつけています。

<metadata xmlns:dc="http://purl.org/dc/elements/1.1/">
<dc:title>タイトル</dc:title>
…
</metadata>

メッセージ
Element [要素名] missing required attribute [属性名]
意味

[要素名]に必須な[属性名]が欠けています

原因と対処

要素によっては特定の属性が必須となるものがあります。指摘された属性を要素に加えてください。


メッセージ
Element type [要素名] must be followed by either attribute specifications, ">" or "/>"
意味

[要素名]の後ろには仕様に従った属性か、”>"または"/>"が必要です

原因と対処

要素が正しく書かれていません。属性の値の引用符やタグのとじ忘れがあった場合に出力されます。対象の要素の属性と閉じタグを確認してください。


属性のエラー

メッセージ
Attribute [属性名A] not allowed here; expected attribute [属性名B]
意味

[属性名A] はここでは利用できません。利用できる属性は[属性名B]です

原因と対処

誤った属性を利用している場合に出力されるメッセージです。正しい属性を利用しているか、属性名のスペルミスがないか確認してください。


メッセージ
The prefix [接頭辞名] for attribute [属性名] associated with an element type [要素名] is not bound
意味

[要素名]の[属性名]で使われている[接頭辞名]に関連付けがありません

原因と対処

名前空間宣言を行わずに、epub などの接頭辞を利用した場合に出力されます。接頭辞に対応した名前空間宣言を行なってください。

次の例は、接頭辞 epub が宣言されていないためエラーになります。

<html xmlns="http://www.w3.org/1999/xhtml">
<body epub:type="cover">
…
</body>
</html>

次は正しい例です。接頭辞 epub が名前空間宣言されています。

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/opf">
<body epub:type="cover">
…
</body>
</html>

メッセージ
Duplicate ID [値]
意味

IDの[値]が重複しています

原因と対処

文書の中に同じID属性の値を持った要素が複数存在しています。ID属性が重複しないようにしてください。


メッセージ
Value of attribute "id" is invalid; must be an XML name without colons
意味

"id" 属性の値が不正です。コロンを含まないXML名を指定してください

原因と対処

id 属性の値が適切ではありません。値にはアルファベット、数字、アンダースコア、ハイフンが利用できますが、先頭の文字に数字、ハイフンは利用できません。


メッセージ
The value of attribute [属性名] associated with an element type [要素名] must notcontain the '<' character
意味

[要素名]にある[属性名]の値は ’<’ 文字を含んではなりません

原因と対処

’<’は属性の値に使えない文字です。この文字を取り除いてください。


文字のエンコーディング

UTF_NOT_SUPPORTED

メッセージ
Only UTF-8 and UTF-16 encodings are allowed, detected [エンコーディング名]
意味

エンコーディングにはUTF-8、UTF-16のみが利用できますが [エンコーディング名] が使われています

原因と対処

ファイルがUTF-8またはUTF-16でエンコーディングされていません。エンコーディングを確認してください。


UTF_NOT_SUPPORTED_BOM

メッセージ
Only UTF-8 and UTF-16 encodings are allowed, detected [エンコーディング名] BOM
意味

エンコーディングにはUTF-8、UTF-16のみが利用できますがBOM付き [エンコーディング名] が使われています

原因と対処

ファイルがUTF-8またはUTF-16でエンコーディングされていません。エンコーディングを確認してください。


MALFORMED_BYTE_SEQUENCE

メッセージ
Malformed byte sequence: [内容]. Check encoding
意味

不正なバイト文字列[内容]があります。エンコーディングを確認してください

原因と対処

Unicodeの仕様に従っていないバイト文字列があります。別の文字集合からUnicodeに変換した場合に起こりえます。不正な箇所は視認できません。不正な箇所を検出できるXMLエディタで修正してください。


INVALID_XML_VERSION

メッセージ
Any Publication Resource that is an XML-Based Media Type must be a conformant XML 1.0 Document. XML Version retrieved: [バージョン番号]
意味

XMLベースのメディアタイプを持つあらゆる出版物リソースはXML 1.0に適合した文書でなければなりません。XMLバージョンが[バージョン番号]になっています。

原因と対処

XMLバージョンが1.0以外のものを指定したXML文書で出力されるメッセージです。XML宣言のversion属性が 1.0 になっているか確認してください。


リンクのエラー

メッセージ
'[ファイル名]': referenced resource missing in the package
意味

参照されているリソース[ファイル名]がパッケージの中に存在しません

原因と対処

他のファイルを参照する際、参照先のファイルがZipアーカイブの中に存在しないとこのメッセージが出力されます。参照先のファイルの存在を確認してください。参照パスの記述に誤りがある場合も考えられます。


メッセージ
'[識別子名]': fragment identifier is not defined in '[ファイル名]'
意味

フラグメント識別子'[識別子名]'が'[ファイル名]'に定義されていません

原因と対処

他のファイルを参照する際、参照先のファイルの中にフラグメント識別子に指定した id 属性を持つ要素が存在しないとこのメッセージが出力されます。参照先のファイルのフラグメント識別子を確認してください。参照パスの記述に誤りがある場合も考えられます。

コンテナのエラー

FILENAME_DISALLOWED_CHARACTERS

メッセージ
File name contains characters disallowed in OCF file names: [文字]
意味

OCF内のファイル名に不正な文字[文字]が含まれています

原因と対処

OFCの仕様にはファイル名に使えない文字が定義されています。該当する文字を使わないようにしてください。


SPACES_IN_FILENAME

メッセージ
Filename contains spaces. Consider changing filename such that URIescaping is not necessary
意味

ファイル名にスペースが含まれています。URIエスケープの必要がないファイル名への変更を検討してください。

原因と対処

ファイル名にスペースが含まれているとうまく動作しないリーディングシステムがあります。スペースを含まないファイル名にしてください。URIエスケープとはスペース文字をURIに含める際に「%20」に変換する方法です。


FILENAME_ENDS_IN_DOT

メッセージ
Filename is not allowed to end with '.'
意味

ファイル名は '.' で終わってはなりません。

原因と対処

ファイル名の最後の文字を '.' 以外のものにしてください。


FILENAME_NON_ASCII

メッセージ
File name contains non-ascii characters: [文字]. Consider changing filename
意味

ファイル名に非アスキー文字[文字]が含まれています。別のファイル名への変更を検討してください。

原因と対処

ファイル名に日本語などの文字が含まれているとうまく動作しないリーディングシステムがあります。アスキー文字だけを使ったファイル名に変更してください。(EPUB 3の仕様上は非アスキー文字のファイル名も認められていますが、動作しない実装があるため警告しています)


CORRUPTED_ZIP_HEADER

メッセージ
Corrupted ZIP header
意味

ZIPのヘッダー部が壊れています。

原因と対処

ファイルのヘッダ部ーがZIPの仕様に従っていません。もう一度ZIP圧縮しなおしたり、別のZIPライブラリを試したりしてみましょう。


CANNOT_READ_HEADER

メッセージ
Cannot read header
意味

ヘッダー部が読み取れません

原因と対処

ZIPファイルが壊れています。もう一度ZIP圧縮しなおしたり、別のZIPライブラリを試したりしてみましょう。


LENGTH_FIRST_FILENAME

メッセージ
Length of first filename in archive must be 8, but was [数値]
意味

TODO

原因と対処

ZIPファイルの先頭には mimetype ファイルが配置されている必要があります。それ以外のファイルが配置されている場合にこのメッセージが出力されます。EPUBの仕様に従って正しくZIP圧縮してください。

参考

MIMETYPE_ENTRY_MISSING

メッセージ
Mimetype entry missing or not the first in archive
意味

Mimetype のエントリが欠けているか、アーカイブの先頭にありません

原因と対処

ZIPファイルの先頭に mimetype ファイル以外のファイルが配置されており、かつファイル名が8文字だった場合に出力されます。EPUBの仕様に従って正しくZIP圧縮してください。


EXTRA_FIELD_LENGTH

メッセージ
Mimetype entry must not have an extra field in its ZIP header
意味

TODO

原因と対処

TODO


メッセージ
Extra field length for first filename must be 0, but was [数値]
意味

最初のファイル名の extra field length は 0 でなければなりませんが[数値]になっています

原因と対処

ZIPコンテナにメタデータが加えられており、EPUBの仕様に反しています。別のZIPライブラリを試したりしてみましょう。


MIMETYPE_WRONG_TYPE

メッセージ
Mimetype contains wrong type (application/epub+zip expected).
意味

Mimetype に不正なメディアタイプが使われています。application/epub+zip である必要があります

原因と対処

mimetype ファイルをテキストエディタで編集して、内容が "application/epub+zip" となるようにしてください。


メッセージ
Mimetype file should contain only the string "application/epub+zip"
意味

Mimetype ファイルには "application/epub+zip" の文字列のみであるべきです

原因と対処

mimetype ファイルをテキストエディタで編集して、"application/epub+zip" 以外の文字を取り除いてください。スペースや改行が含まれていてはなりません。


メッセージ
Required META-INF/container.xml resource is missing
意味

必須ファイル META-INF/container.xml が見つかりません

原因と対処

META-INF/container.xml が欠けているため作成してください。


メッセージ
No rootfiles with media type 'application/oebps-package+xml'
意味

メディアタイプが 'application/oebps-package+xml' であるルートファイルがありません

原因と対処

META-INF/container.xml にパッケージ文書を記述した rootfile 要素が欠けています。また、 rootfile 要素の media-type 属性の値にスペルミスがある場合も考えられます。エントリを正しく記述してください。

参考

メッセージ
Entry [ファイル名] not found in zip file
意味

エントリの[ファイル名]がZIPファイルの中に見当たりません

原因と対処

META-INF/container.xml の rootfile 要素に記述されたパッケージ文書が見つからない場合に出力されます。rootfile 要素の full-path 属性の値がパッケージ文書を正しく指しているか確認してください。

パッケージの検証

OPF_UNIQUE_ID_REF_NOT_EXISTING

メッセージ
unique-identifier attribute in package element must reference an existing identifier element id
意味

パッケージ要素の unique-identifier 属性は既存の identifier 要素の id を参照しなければなりません

原因と対処

package 要素の unique-identifier 属性の値に一致する id 属性を持った dc:identifier 要素が metadata 要素の中に存在しない場合に出力されるメッセージです。package 要素と dc:identifier 要素を確認してください。


メッセージ
character content of element "[要素名]" invalid; must be a string with length at least 1
意味

[要素名]の内容テキストが不正です。少なくとも1文字以上なければなりません

原因と対処

要素の内容が空だったりスペース文字だけである場合に出力されます。適切な文字列を記述してください。


メッセージ
Package dcterms:modified meta element must occur exactly once
意味

パッケージ文書の dcterms:modified meta要素は1つだけ存在しなければなりません

原因と対処

パッケージ文書には property 属性が dcterms:modified である meta 要素が1つ必要です。欠けていたり複数あったりしないか確認してください。

参考

メッセージ
dcterms:modified illegal syntax (expecting: 'CCYY-MM-DDThh:mm:ssZ')
意味

dcterms:modified の記法が不正です('CCYY-MM-DDThh:mm:ssZ'形式である必要があります)

原因と対処

dcterms:modified を指定した meta 要素の値が CCYY-MM-DDThh:mm:ssZ の形式であるか確認してください。


メッセージ
@refines missing target id: '[値]'
意味

refines 属性の参照先アイテムが見つかりません。id: '[値]'

原因と対処

meta 要素の refines 属性には、'#' に続けて参照する要素が持つ id 属性の値を記述します。指定した id 属性を持った要素が正しく記述されているか確認してください。


メッセージ
[種類] file [ファイル名] is missing
意味

[種類]のファイル[ファイル名]が見つかりません

原因と対処

manifestitem 要素で宣言されているファイルが、実際のZipアーカイブの中に存在しない場合に出力されます。[種類]の箇所には例えば画像ファイルなら 'image' のように、ファイルの種類が入ります。ファイルの存在を確認してください。


メッセージ
item ([ファイル名]) exists in the zip file, but is not declared in the manifest file
意味

マニフェストに宣言されていないアイテム ([ファイル名]) がZipファイルの中にあります

原因と対処

実際のZipアーカイブの中に存在するファイルが manifestitem 要素として宣言されていない場合に出力されます。このファイルの item 要素を記述してください。


メッセージ
'[URI]': remote resource reference not allowed; resource must be placed in the OCF
意味

リモートリソース '[URI]' を参照することはできません。リソースをOCFの中に配置してください

原因と対処

インターネット上のアイテムを利用できるのは、それがオーディオとビデオの場合のみです。それ以外のファイルはすべてZipファイルの中に配置しなければなりません。


メッセージ
Item property: [プロパティ] is not defined for: [メディアタイプ]
意味

アイテムのプロパティ[プロパティ]は[メディアタイプ]には使えません

原因と対処

指定できる properties 属性の値はメディアタイプ毎に決まっています。指定できないプロパティは取り除いてください


メッセージ
This file should not declare in opf the properties: X
意味

このファイルには OPF で次のプロパティの宣言が必要です: [プロパティ]

原因と対処

パッケージ文書中で必要な properties 属性を宣言していないアイテムがあります。例えば JavaScriptを利用したXHTMLコンテンツ文書が scripted のプロパティを宣言していない場合が挙げられます。

参考

メッセージ
Exactly one manifest item must declare the 'nav' property (number of 'nav' items: [数値]).
意味

'nav' プロパティを持つことのできるアイテムは1つだけです('nav' を指定したアイテムの数: [数値])

原因と対処

properties 属性に 'nav' を指定できる item 要素は1つだけです。ナビゲーション文書に使うアイテムを1つ選び、それ以外のアイテムからは 'nav' を取り除いてください。


メッセージ
Multiple occurrences of the 'cover-image' property (number of 'cover-image' items: [数値]).
意味

'cover-image' プロパティを持つアイテムが複数あります('cover-image' を指定したアイテムの数: [数値])

原因と対処

properties 属性に 'cover-image' を指定できる item 要素は1つだけです。表紙画像に使う item を1つ選び、それ以外の item からは 'cover-image' を取り除いてください。


メッセージ
Object type and the item media-type declared in manifest, do not match
意味

オブジェクトの type とマニフェストにあるアイテムの media-type が一致しません

原因と対処

XHTMLコンテンツ文書で object タグが参照するリソースの type 属性が、manifestitem 要素の media-type 属性と一致していない場合に出力されます。正しいメディアタイプを確認して、両者が一致するようにしてください。


メッセージ
Manifest item element fallback attribute must resolve to another manifest item (given reference was 'X')
意味

マニフェストアイテムの fallback 属性は他のマニフェストアイテムに解決しなければなりません(([値]' を参照しています)

原因と対処

manifest 要素の中の item 要素が fallback 属性を持つ場合、その値はフォールバック先となる item 要素の id 属性でなければなりません。fallback 属性の値にスペルミスがないか確認してください。


OPF_SPINE_NONSTANDARD_MIMETYPE_WITHOUT_FALLBACK

メッセージ
Spine item with non-standard media-type '[メディアタイプ]'' with no fallback
意味

非標準的なメディアタイプ[メディアタイプ]の spine アイテムにフォールバックがありません

原因と対処

XHTML、SVG文書以外のアイテムを spine 要素内の itemref 要素から参照した場合、そのアイテムは同等の内容を持ったXHTMLまたはSVG文書を fallback 属性によって参照する必要があります。


OPF_SPINE_NONSTANDARD_MIMETYPE_WITH_NOTALLOWED_FALLBACK

メッセージ
Spine item with non-standard media-type '[メディアタイプ]' with fallback to non-spine-allowed media-type
意味

非標準的なメディアタイプ '[メディアタイプ]' の spine アイテムが spine に記述できないアイテムをフォールバックに指定しています

原因と対処

XHTML、SVG文書以外のアイテムを spine 要素内の itemref 要素から参照した場合、そのアイテムは同等の内容を持ったXHTMLまたはSVG文書を fallback 属性によって参照する必要があります。それ以外のアイテムをフォールバックに指定すると、このメッセージが出力されます。


OPF_FALLBACK_CIRCULAR_REF

メッセージ
Circular reference in fallback chain
意味

フォールバックチェインに循環参照があります

原因と対処

item 要素は fallback 属性によって何段階にもフォールバックさせることができますが、途中に逆方向のフォールバックが含まれているとこのメッセージが出力されます。フォールバックの順序を確認してください。

次の例は循環参照です。item3 はフォールバック元の祖先である item1 をフォールバック先に指定しているためエラーになります。

<manifest>
<item id="item1" … fallback="item2" />
<item id="item2" … fallback="item3" />
<item id="item3" … fallback="item1" />
</manifest>

メッセージ
Media overlay items must be of the 'application/smil+xml' type (given type was '[メディアタイプ]')
意味

メディアオーバーレイのアイテムはメディアタイプが 'application/smil+xml' でなければなりません('[メディアタイプ]' が指定されています)

原因と対処

item 要素にメディアオーバーレイ文書を宣言した場合、その media-type 属性は 'application/smil+xml' としてください。

参考

メッセージ
Item media:duration meta element not set (expecting: meta property= 'media:duration' refines='#[値]')
意味

media:duration の meta 要素が指定されていません(meta 要素の property属性に 'media:duration', refines属性に '#[値]' を指定する必要があります )

原因と対処

コンテンツ文書にメディアオーバーレイを付与する場合、その文書の再生時間を記述した meta 要素を記述する必要があります。この指定が欠けているとこのメッセージが出力されます。

参考

メッセージ
Global media:duration meta element not set
意味

グローバルな media:duration の meta 要素が指定されていません

原因と対処

メディアオーバーレイを付与したコンテンツでは、文書ごとの再生時間を記述した meta 要素の他に、それらの再生時間を合計したグローバルな meta 要素を記述する必要があります。この指定が欠けているとこのメッセージが出力されます。

参考

メッセージ
spine element toc attribute must reference the NCX manifest item (referenced media type was '[メディアタイプ]')
意味

spine 要素の toc 属性は NCX のマニフェストアイテムを参照しなければなりません('[メディアタイプ]'を参照しています)

原因と対処

spine 要素の toc 属性はNCXを参照しなければなりません。参照する item 要素の media-type属性が 'application/x-dtbncx+xml' となっていない場合にはこのメッセージが出力されます。


メッセージ
spine element toc attribute must be set when an NCX is included in the publication
意味

出版物にNCXがある場合、spine要素のtoc属性を指定しなければなりません

原因と対処

NCXファイルがあるにも関わらず、spine 要素の toc 属性を利用していない場合にこのメッセージが出力されます。toc 属性を記述してください。

コンテンツの検証

文書とヘッダーのエラー

メッセージ
The lang and xml:lang attributes must have the same value
意味

lang 属性と xml:lang 属性は同じ値でなければなりません

原因と対処

lang 属性はHTMLの属性、 xml:lang 属性はXMLの属性で、いずれも言語を表します。両者は併用可能ですが、異なる値を指定すると仕様に反するため、このメッセージが出力されます。両者で同じ値をとるようにしてください。

次の例は、lang 属性は英語'en'、xml:lang 属性は日本語'ja'を指定しているのでエラーになります。

<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="ja">

メッセージ
There must not be more than one meta element with a charset attribute per document
意味

charset 属性を持つ meta 要素は1つよりも多くあってはなりません

原因と対処

meta 要素に charset 属性を指定してコンテンツのエンコーディングを表現しますが、複数記述すると仕様に反するためこのメッセージが出力されます。1つだけ記述してください。


メッセージ
The sizes attribute must not be specified on link elements that do not have a rel attribute that specifies the icon keyword
意味

rel 属性でキーワードに icon を指定しない link 要素では sizes 属性を指定してはなりません

原因と対処

sizes属性はアイコンのピクセル数を指定する属性です。rel 属性に icon 以外の値を指定した link 要素以外では sizes 属性を使えないため取り除いてください。


次のメッセージは最新の仕様に基づいていません。

pubdate 属性は HTML5 の仕様から削除されています。pubdate 属性を使用しないでください。

メッセージ
For each Document, there must be no more than one time element with a pubdate attribute that does not have an ancestor article element
意味

個々の文書では、親要素に article 要素がない場合には、 pubdate 属性を指定した time 要素を複数使ってはなりません

原因と対処

原則として1つの文書の中に pubdate 属性を指定した time 要素は1つだけ記述できます。ただし article 要素がある場合には、article 要素ごとに1つずつ記述できます。このルールに従うようにしてください。


次のメッセージは最新の仕様に基づいていません。

pubdate 属性は HTML5 の仕様から削除されています。pubdate 属性を使用しないでください。

メッセージ
For each article element, there must be no more than one time element child with a pubdate attribute
意味

個々の article 要素の中では、 pubdate 属性を指定した time 要素が複数あってはなりません

原因と対処

article 要素の中に pubdate 属性を持つ time 要素を複数記述することはできません。1つだけ記述してください。


map 要素のエラー

メッセージ
Duplicate map name '[値]'
意味

map 要素の name 属性の値 '[値]' が重複しています

原因と対処

コンテンツ文書の中では map 要素の name 属性の値は一意でなければなりません。複数の要素が同じ値を使用しないようにしてください。


メッセージ
The id attribute on the map element must have the same value as the name attribute
意味

map 要素の id 属性は name 属性と同じ値でなければなりません

原因と対処

メッセージのとおりです。id 属性と name 属性は同じ値にしてください。


form 要素のエラー

メッセージ
A select element whose multiple attribute is not specified must not have more than one descendant option element with its selected attribute set
意味

multiple 属性を指定しない select 要素は、その子要素に selected 属性を指定した option 要素が複数あってはなりません

原因と対処

メッセージのとおりです。select 要素に multiple 属性を指定するか、selected 属性を指定した options 要素が1つだけあるようにしてください。


オーディオ/ビデオのエラー

メッセージ
The track element label attribute value must not be the empty string
意味

track 要素の label 属性は空文字列であってはなりません

原因と対処

メッセージのとおりです。track 要素の label 属性には何らかの文字を指定してください。


メッセージ
There must not be more than one track child of a media element with the default attribute specified
意味

メディア要素の子要素に default 属性を指定した track 属性が複数あってはなりません

原因と対処

メディア要素とは、audio 要素と video 要素を指します。ひとつのメディア要素に対して track 要素が複数ある場合、 default 属性を指定できるのはひとつだけです。デフォルトとする track 要素を選び、それ以外の要素からは default 属性を取り除いてください。


参照のエラー

メッセージ
The [属性名] attribute must refer to an element in the same document (the ID '[値]' does not exist)
意味

[属性名] 属性は同じ文書の中の要素を参照しなければなりません(ID ’[値]’ を持つ要素が見つかりません)

原因と対処

メッセージのとおりです。属性に指定した id 属性を持つ要素があるか、また属性の値にスペルミスがないか確認してください。


メッセージ
The [属性名] attribute must refer to elements in the same document (target ID missing)
意味

[属性名]属性は同じ文書の中の要素を参照しなければなりません(ターゲットIDがありません)

原因と対処

前述のエラーと似ていますが、属性が複数の要素を参照可能な場合にはこのメッセージが出力されます。属性がそれぞれの要素を正しく参照できているか確認してください。


メッセージ
The [属性名] attribute does not refer to an allowed target element (expecting: [要素名])
意味

[属性名]属性が適切な要素を参照していません(要素は[要素名]である必要があります。)

原因と対処

属性の中には特定の種類の要素を参照するものがあります。誤った要素を参照するとこのメッセージが出力されます。メッセージが示す要素を参照するようにしてください。


メッセージ
The [要素名] element must have a [属性名] attribute
意味

[要素名] 要素には [属性名] 属性が必要です

原因と対処

一部の要素には特定の属性が必要なことがあります。指摘された属性を加えてください。


メッセージ
The [要素名1] element must not appear inside [要素名2] elements
意味

[要素名2] 要素の中に [要素名1] を書くことはできません

原因と対処

一部の要素には、書くことのできる子要素が決まっていることがあります。親要素と子要素の関係を確認してください。タグの閉じ忘れでこのメッセージが出力されることもあります。


メッセージ
The [要素名1] element must have an ancestor [要素名2] element
意味

[要素名1] には祖先に [要素名2] が必要です

原因と対処

一部の要素は、親子関係が決まっているものがあります。親要素と子要素の関係を確認してください。


epub:type プロパティのエラー

メッセージ
Undefined property: [プロパティ名]
意味

定義されていないプロパティです: [プロパティ名]

原因と対処

epub:typeのプロパティは予め定義されています。正しいプロパティを使ってください。または、プロパティ名にスペルミスがないか確認してください。

参考

次の例では epub:type に定義されていないプロパティ "foo" を使用しているためエラーになります。

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/opf">
<body epub:type="foo">
…
</body>
</html>

メッセージ
Undeclared prefix: X
意味

未定義の接頭辞です: [接頭辞名]

原因と対処

epub:type のプロパティは接頭辞を付けることで独自の拡張することができますが、接頭辞が宣言されていない場合、このメッセージが出力されます。html 要素の中で epub:prefix 属性を使って接頭辞を宣言してください。

次の例では epub:type を接頭辞 my で拡張し、独自の値を指定しています。しかし my の接頭辞が定義されていないためエラーになります。

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/opf">
<body epub:type="my:foo">
…
</body>
</html>

次は正しい例です。html 要素の中で my の接頭辞を宣言しています。

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/opf" epub:prefix="my: http://example.com">
<body epub:type="my:foo">
…
</body>
</html>

SSMLのエラー

メッセージ
The ssml:ph attribute must not be specified on a descendant of an element that also carries this attribute
意味

ssml:ph 属性を持つ要素の子要素に ssml:ph 属性を指定してはなりません。

原因と対処

ssml:ph 属性はテキストの発音情報を指定する属性です。この属性を指定した要素の子要素に別の ssml:ph 属性を指定しても効果はありませんので取り除いてください。


CSS のエラー

CSS_STRING_PARSE_ERROR

メッセージ
An error occurred while parsing CSS for %1$s.
意味

TODO

原因と対処

TODO


CSS_PROPERTY_NOT_ALLOWED

メッセージ
The \'%1$s\' property must not be included in an EPUB Style Sheet.
意味

TODO

原因と対処

TODO


POSITION_FIXED

メッセージ
The fixed value of the position property is not part of the EPUB 3 CSS Profile.
意味

TODO

原因と対処

TODO


CSS_FONT_MIMETYPE

メッセージ
Font-face reference %1$s to non-standard font type %2$s
意味

TODO

原因と対処

TODO


メッセージ
The scoped style element must occur before any other flow content other than other style elements and inter-element whitespace
意味

scoped 属性を持つ style 要素は他の style 要素や要素間の空白文字を除くあらゆるフローコンテンツよりも先に記述しなければなりません

原因と対処

style 要素に scoped 属性を指定するとそのスタイルは親要素の範囲にだけ適用されます。この style 要素は親要素の中でフローコンテンツよりも先に記述してください。

次の例は、style 要素よりも先にフローコンテンツである div2 が記述されているためエラーになります。

<div class="div1">
  <div class="div2">
    <p>Lorem ipsum</p>
  </div>
  <style scoped="scoped">
    p { color: red; }
  </style>
</div>

次は正しい例です。div2 よりも先に style 要素を記述しています。

<div class="div1">
  <style scoped="scoped">
    p { color: red; }
  </style>
  <div class="div2">
    <p>Lorem ipsum</p>
  </div>
</div>

代替スタイルシートのエラー

CONFLICTING_ATTRIBUTES

メッセージ
Conflicting attributes found: [値]
意味

属性に競合があります: [値]

原因と対処

Alternate Style Tags の定義する値には、同時に指定できないものがあります。どちらか一方を指定してください。

参考

次の例は、横組み:horizontal と 縦組み:vertical を同時に指定しているためエラーになります。

<link rel="stylesheet" href="style.css" class="horizontal vertical"/>

実体のエラー

メッセージ
The entity [実体参照] was referenced, but not declared
意味

実体 [実体参照] を参照していますが、宣言されていません

原因と対処

XML/XHTML5 で使える実体参照は &amp;、&lt;、&gt;、&quot;、&apos; だけです。それ以外の文字を記述した場合このメッセージが出力されます。このような文字は代わりに文字参照を使って記述してください。

次の例は著作権記号 © を実体参照で記述しているためエラーになります。

<p>Copyright &copy; 2013 電書ちゃんねる</p>

次は正しい例です。同じ文字を実体参照ではなく文字参照で記述しています。

<p>Copyright &xA9; 2013 電書ちゃんねる</p>

メッセージ
The entity name must immediately follow the '&' in the entity reference
意味

'&' 文字を実体参照に変えてください

原因と対処

XML/XHTML5 でテキストに '&' の文字を使うことはできません。'&' を表すには '&amp;' と記述してください。

次の例はテキストに '&' を使っているためエラーになります。

<title>ガールズ & パンツァー</title>

次は正しい例です。'&' を実体参照で記述しています。

<title>ガールズ &amp; パンツァー</title>

メッセージ
The reference to entity [実体参照] must end with the ';' delimiter
意味

実体参照 [実体参照] は ';' 文字で終えなければなりません

原因と対処

実体参照の文字は '&' からはじまり ';' で終わる形式で表記します。終わりの ';' が欠けていると、このメッセージが出力されるため、';' を補ってください。


未分類

現在分類中のメッセージです。

FULL_EPUB

メッセージ
File is validated as a complete epub archive.
意味

TODO

原因と対処

TODO


SINGLE_FILE

メッセージ
File is validated as a single file of type %1$s and version %2$s. Only a subset of the available tests is run.
意味

TODO

原因と対処

TODO


MISSING_FILE

メッセージ
File %1$s is missing in the package.
意味

TODO

原因と対処

TODO


INVALID_OPF_Version

メッセージ
Failed obtaining OPF version: %1$s .
意味

TODO

原因と対処

TODO


メッセージ
The nav file is not supported for epub versions other than 3.0.
意味

TODO

原因と対処

TODO


OPV_VERSION_TEST

メッセージ
Tests are done only for the OPF version.
意味

TODO

原因と対処

TODO


MODE_VERSION_NOT_SUPPORTED

メッセージ
The checker doesn't validate type %1$s and version %2$s.
意味

TODO

原因と対処

TODO


VERSION_MISMATCH

メッセージ
Validating the EPUB against version %1$s but detected version %2$s.
意味

TODO

原因と対処

TODO


VERSION_NOT_FOUND

メッセージ
Could not detect the EPUB version. Validating against version %1$s.
意味

TODO

原因と対処

TODO


NO_ERRORS__OR_WARNINGS

メッセージ
No errors or warnings detected.
意味

TODO

原因と対処

TODO


THERE_WERE_ERRORS

メッセージ
\nCheck finished with warnings or errors\n
意味

TODO

原因と対処

TODO


MODE_VERSION_IGNORED

メッセージ
The mode and version arguments are ignored for epubs (They are retrieved from the files.)
意味

TODO

原因と対処

TODO


MODE_REQUIRED

メッセージ
For files other than epubs, mode must be specified! Default version is 3.0.
意味

TODO

原因と対処

TODO


DELETING_ARCHIVE

メッセージ
\nDeleting requested epub archive as it is not valid.\n
意味

TODO

原因と対処

TODO


DISPLAY_HELP

メッセージ
-help displays help
意味

TODO

原因と対処

TODO


ARGUMENT_NEEDED

メッセージ
At least one argument expected
意味

TODO

原因と対処

TODO


AFTER_ARGUMENT_EXPECTED

メッセージ
After the argument %1$s , the %2$s of the file to be checked is expected
意味

TODO

原因と対処

TODO


No file to check was specified in arguments

メッセージ
After the argument %1$s , the %2$s of the file to be checked is expected
意味

TODO

原因と対処

TODO


END_OF_EXECUTION

メッセージ
The tool will EXIT
意味

TODO

原因と対処

TODO


IO_ERROR

メッセージ
IO_ERROR
意味

TODO

原因と対処

TODO


NULL_REF

メッセージ
NULL value reference
意味

TODO

原因と対処

TODO


RESOURCE_NOT_AVAILABLE

メッセージ
Could not find resource %1$s
意味

TODO

原因と対処

TODO


FAILED_PERFORMING_SCHEMATRON_TESTS

メッセージ
Failed performing OPF Schematron tests: %1$s
意味

TODO

原因と対処

TODO


XML_VERSION_NOT_SUPPORTED

メッセージ
Your system doesn't support xml version verification. Make sure your xml files are conformant to XML 1.0
意味

TODO

原因と対処

TODO


EXTERNAL_ENTITIES_NOT_ALLOWED

メッセージ
External entities are not allowed. External entity declaration found: 
意味

TODO

原因と対処

TODO


VALIDATING_VERSION_MESSAGE

メッセージ
Validating against EPUB version %1$s 
意味

TODO

原因と対処

TODO


IRREGULAR_DOCTYPE

メッセージ
Irregular DOCTYPE: found \'%1$s\', expecting \'%2$s\'.
意味

TODO

原因と対処

TODO


MULTIPLE_OPS_RENDITIONS

メッセージ
The container includes multiple OPS renditions
意味

TODO

原因と対処

TODO


EMPTY_HREF

メッセージ
Link attribute with no value
意味

TODO

原因と対処

TODO


MISSING_RESOURCE

メッセージ
resource '%1$s' is missing
意味

TODO

原因と対処

TODO


RESOURCE_CANNOT_BE_DECRYPTED

メッセージ
resource '%1$s' cannot be decrypted
意味

TODO

原因と対処

TODO


OPF_FILE_MISSING

メッセージ
OPF file %1$s is missing
意味

TODO

原因と対処

TODO


OPF_GUIDE_REF_UNMANIFESTED

メッセージ
File listed in reference element in guide was not declared in OPF manifest:
意味

TODO

原因と対処

TODO


OPF_GUIDE_REF_IS_NO_CONTENT_DOCUMENT

メッセージ
Guide reference to an item that is not a Content Document:
意味

TODO

原因と対処

TODO


OPF_SPINE_ONLY_NON_LINEAR

メッセージ
spine contains only non-linear resources
意味

TODO

原因と対処

TODO


OPF_SPINE_MULTI_REFS_TO_SAME_ID

メッセージ
spine contains multiple references to the manifest item with id %1$s
意味

TODO

原因と対処

TODO


OPF_MIMETYPE_TEXTHTML_WRONG_FOR_XHTMLOPS

メッセージ
text/html is not appropriate for XHTML/OPS, use application/xhtml+xml instead
意味

TODO

原因と対処

TODO


OPF_MIMETYPE_TEXTHTML_WRONG_FOR_OEBPS_12

メッセージ
text/html is not appropriate for OEBPS 1.2, use text/x-oeb1-document instead
意味

TODO

原因と対処

TODO


OPF_MIMETYPE_DEPRECATED

メッセージ
deprecated media-type '%1$s'
意味

TODO

原因と対処

TODO


OPF_MIMETYPE_IS_BLESSED_ITEM_TYPE

メッセージ
use of OPS media-type '%1$s' in OEBPS 1.2 context; use text/x-oeb1-document instead
意味

TODO

原因と対処

TODO


OPF_MIMETYPE_IS_BLESSED_STYLE_TYPE

メッセージ
use of OPS media-type '%1$s' in OEBPS 1.2 context; use text/x-oeb1-css instead
意味

TODO

原因と対処

TODO


OPF_FALLBACK_STYLE_ITEM_NOT_FOUND

メッセージ
fallback-style item could not be found
意味

TODO

原因と対処

TODO


OPF_MANIFEST_SCRIPTED_PROPERTY_MISSING

メッセージ
Item should have the scripted property set in order to be a valid mediaType handler.
意味

TODO

原因と対処

TODO


OPF_USING_OEBPS12

メッセージ
OPF file is using OEBPS 1.2 syntax allowing backwards compatibility
意味

TODO

原因と対処

TODO


OPF_MISSING_OR_EMPTY_UNIQUE_ID_ATTRIBUTE

メッセージ
unique-identifier attribute in package element must be present and have a value
意味

TODO

原因と対処

TODO


OPF_ONLY_AUDIO_VIDEO

メッセージ
Only audio and video remote resources are permitted
意味

TODO

原因と対処

TODO


OPF_ITEM_WITH_ID_NOT_FOUND

メッセージ
item with id '%1$s' not found
意味

TODO

原因と対処

TODO


OPF_TOC_ITEM_WRONG_MIMETYPE

メッセージ
toc attribute references resource with non-NCX mime type; "application/x-dtbncx+xml" is expected
意味

TODO

原因と対処

TODO


OPF_DEPRECATED_ELEMENT

メッセージ
use of deprecated element '%1$s'
意味

TODO

原因と対処

TODO


OPF_DC_ROLE_VALUE_INVALID

メッセージ
role value '%1$s' is not valid
意味

TODO

原因と対処

TODO


OPF_EPUB3_META_DATE_INVALID

メッセージ
date value '%1$s' does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime: %2$s
意味

TODO

原因と対処

TODO


OPF_EPUB2_META_DATE_INVALID

メッセージ
date value '%1$s' is not valid as per http://www.w3.org/TR/NOTE-datetime: %2$s
意味

TODO

原因と対処

TODO


OPF_EMPTY_ELEMENT

メッセージ
%1$s element is empty
意味

TODO

原因と対処

TODO


OPF_MIMETYPE_IS_CORE_MEDIATYPE

メッセージ
The media-type '%1$s' is a core media type
意味

TODO

原因と対処

TODO


OPF_MIMETYPE_HANDLER_ALREADY_ASSIGNED

メッセージ
The media-type '%1$s' has already been assigned a handler
意味

TODO

原因と対処

TODO


OPF_ITEMREF_WITH_INVALID_PAGESPREAD

メッセージ
itemref can't have both page-spread-right and page-spread-left properties
意味

TODO

原因と対処

TODO


OPF_ITEM_PROPERTY_NOT_DEFINED

メッセージ
Item property: '%1$s' is not defined for media type: %1$s
意味

TODO

原因と対処

TODO


OPF_REMOTE_RESOURCE_NOT_ALLOWED

メッセージ
'%1$s': remote resource reference not allowed; resource must be placed in the OCF
意味

TODO

原因と対処

TODO


OPF_REF_RESOURCE_MISSING

メッセージ
'%1$s': referenced resource missing in the package.
意味

TODO

原因と対処

TODO


OPF_REF_RESOURCE_NOT_DECLARED

メッセージ
'%1$s': referenced resource is not declared in the OPF manifest.
意味

TODO

原因と対処

TODO


OPF_FRAGMENT_ID_MISSING

メッセージ
fragment identifier missing in reference to '%1$s'
意味

TODO

原因と対処

TODO


メッセージ
hyperlink to non-standard resource '%1$s' of type '%2$s'
意味

TODO

原因と対処

TODO


メッセージ
hyperlink to resource outside spine '%1$s'
意味

TODO

原因と対処

TODO


OPF_NONSTANDARD_IMAGE

メッセージ
non-standard image resource '%1$s' of type '%2$s'
意味

TODO

原因と対処

TODO


OPF_NONSTANDARD_STYLESHEET

メッセージ
non-standard stylesheet resource '%1$s' of type '%2$s'. A fallback must be specified.
意味

TODO

原因と対処

TODO


OPF_FRAGMENT_ID_FOR_IMG

メッセージ
fragment identifier used for image resource '%1$s'
意味

TODO

原因と対処

TODO


OPF_FRAGMENT_ID_FOR_STYLE

メッセージ
fragment identifier used for stylesheet resource '%1$s'
意味

TODO

原因と対処

TODO


OPF_FRAGMENT_ID_NOT_DEFINED_IN

メッセージ
'%1$s': fragment identifier is not defined in '%2$s'
意味

TODO

原因と対処

TODO


OPF_FRAGMENT_ID_DEFINES_INCOMPATIBLE_RES

メッセージ
fragment identifier '%1$s' defines incompatible resource type in '%2$s'
意味

TODO

原因と対処

TODO


OCF_CONTAINERXML_FULLPATH_ATTR_MISSING

メッセージ
element "rootfile" missing required attribute "full-path"
意味

TODO

原因と対処

TODO


OCF_CONTAINERXML_FULLPATH_ATTR_EMPTY

メッセージ
attribute "full-path" on element "rootfile" must not be empty
意味

TODO

原因と対処

TODO


CLI_OUTPUT_XML

メッセージ
Assessment XML document was saved in:
意味

TODO

原因と対処

TODO