EPUB Content Documents 3.2 日本語訳

要約

この仕様は、EPUB® 出版物のコンテキストで使用する HTML、SVG、CSS のプロファイルを定義する。

この仕様は、[EPUB32] を構成する仕様群のひとつであり、XML や Web 規格に基づいたデジタル出版物の交換や配信形式である。この仕様は EPUB 3 を構成する以下の他の仕様と共に読み、理解することになっている。

この仕様と前身の多くの相違についての詳細情報は [EPUB32Changes] を参照されたい。

プリフィックス	URI
`epub`	`http://www.idpf.org/2007/ops`
`ssml`	`https://www.w3.org/2001/10/synthesis`

2. XHTMLコンテンツドキュメント

2.1 まえがき

この仕様は、XHTML コンテンツドキュメント制作のために [HTML] のプロファイルを定義する。このプロファイルに準拠する XML ドキュメントのインスタンスはコアメディアタイプリソースであり、XHTML コンテンツドキュメントとしてこの仕様で言及される。

他の指定のない限り、この仕様は、[HTML] 仕様からセマンティクスと構造、処理動作の全ての定義を継承する。

2.2 コンテンツの適合性

XHTML コンテンツドキュメントは、次の基準を全て満たさなければならない（MUST）。

ドキュメントのプロパティ

XHTML 構文に従った [HTML] ドキュメントでなければならない（MUST）。

XML 適合性 [EPUB32] で定義された XML ドキュメントの適合性の制約を満たさなければならない（MUST）。

全てのドキュメントの為に使用されている構成概念は [HTML] により定義され、それは HTML の許容性と制約で明確に上書きされていない限り、その仕様でこれらの構成概念のために定義された適合性の基準に準拠しなければならない（MUST）。

HTML の拡張で定義されている [HTML] 文法の拡張を包含してもよく（MAY）、これらに定義されている全てのコンテンツの適合性の制約に適合しなければならない（MUST）。

Note

[EPUBAccessibility] のアクセシビリティ要件に従う EPUB 出版物の推奨は、XHTML コンテンツドキュメントに適用する。アクセシビリティ [EPUB32] を見よ。

ファイルのプロパティ

XHTML コンテンツドキュメントのファイル名は、ファイル拡張子 .xhtml を使用するべきである（SHOULD）。

2.3 リーディングシステムの適合性

適合した EPUB リーディングシステムは、XHTML コンテンツドキュメントの処理のために、次の基準を全て満たさなければならない（MUST）：

この仕様によって上書きなどが明確に定義されていない限り、[HTML] 仕様により定義されたセマンティクスを使用して XHTML コンテンツドキュメントを処理し、その中に表れる適切なユーザーエージェントの適合性の制約を尊重しなければならない（MUST）。
HTML の拡張で定義された全てのリーディングシステムの適合性基準を満たさなければならない（MUST）。
HTML の許容性と制約で定義された制約の挙動を認識し、適応しなければならない（MUST）。
スクリプトコンテンツドキュメント — リーディングシステムの適合性で定義されたリーディングシステムの適合性基準を満たさなければならない（MUST）。
CSS スタイルシート — リーディングシステムの適合性で定義された XHTML コンテンツドキュメントの視覚的レンダリングをサポートしなければならない（MUST）。
埋め込まれた ARIA マークアップを認識し、アクセシビリティ APIs [WAI-ARIA] の任意の ARIA ロール（role）やステート（state）、プロパティ（property）がプラットフォームに出現するのをサポートするべきである（SHOULD）。

2.4 HTML の拡張

このセクションは、[HTML] ドキュメントモデルを基礎にして、EPUB 3 の XHTML コンテンツドキュメントの拡張を定義する。

Note

このような拡張がこのセクションに掲載されていない限り、[HTML] は、ベンダーの中立的な拡張のサポートをユーザーエージェントに許可しているが、それらは、EPUB 3 でサポートされた機能ではない。

2.4.1 意味の変化

2.4.1.1 まえがき

このセクションは規定ではない。

意味の変化は XHTML コンテンツドキュメント内で使用している要素に特定の意味と、または性質に関するさらなる意味を付与する行為である。epub:type 属性は、[HTML] の語彙を補足する変化をもたらし、XHTML コンテンツドキュメント内のドメイン固有の意味を表現するのに使用される。

適用されるセマンティクスは、それらを含んでいる要素の意味を取り込むことが意図されており、（例えば、属性は、section が作品の章を示すために使用できるが、適切なリスト構造を回避するために、リスト項目に p 要素を動作するもとして設計されていないように）それらの性質を上書きするために提供されていない。

セマンティックメタデータは、出版のワークフローにおける使用および製作者が定義した目的におけるコンテンツの充実を意図している。それはまた、リーディングシステムが文書の構造とコンテンツについて更に学ぶことを可能にするが、この仕様によってセマンティクスのために定義された特定の振る舞いはない。そのような振る舞いは全てリーディングシステムに依存する。

この仕様は、新しい要素を追加する代わりに、axis 属性を使用して意味の変化のための方法を定義し、epub:type 属性で求められる意味の変化を既存の要素に付与できる。属性の制御値を提供する外部のボキャブラリを識別するためのメカニズムもまた定義されている。

2.4.1.2 `epub:type` 属性

属性名

type

名前空間

http://www.idpf.org/2007/ops

使用方法

グローバル属性。全ての要素に指定してもよい（MAY）。

値

語彙の関連性で定義された制約による、プロパティ [Packages32] 値の空白で区切られたリスト。

空白は、[XML] に定義されている文字の集合である。

epub:type 属性は、それが出現する要素の意味を変化させる。その値は、語彙の関連性で定義された文書のインスタンスに関連付けられた外部の語彙から抽出される空白で区切られたひとつ以上の用語である。

変化された意味は、含んでいる要素の意味のサブクラスを表現しなければならない（MUST）。例えば [HTML] の div や span 要素など、意味的に中立な要素の場合、変化された意味は、（例えば、div は段落や節を表現している）既存の要素によってすでに含まれている意味を加えてはならない（MUST NOT）。リーディングシステムは含んでいる要素と矛盾する変化された意味を無視しなければならない（MUST）。

[HTML] head 要素がドキュメントのメタデータを含むように、構造的なセマンティクスは、この要素上または意味を持たない任意の子孫に表れる。リーディングシステムは、これらのセマンティクスを無視しなければならない（MUST）。

例

Example 1

次の例は、序文が、[HTML] section 要素に含まれていることを epub:type 属性でマークアップできる方法を示している。

<html … xmlns:epub="http://www.idpf.org/2007/ops">
    …
<section epub:type="preamble">
        …    
</section>
    …
</html>

Example 2

次の例は、[HTML] の定義リストに用語集のセマンティクスを追加するために用いられる epub:type 属性を示している。

<html … xmlns:epub="http://www.idpf.org/2007/ops">
    …
<dl epub:type="glossary">
        …    
</dl>        
    …
</html>

Example 3

次の例は、改ページのセマンティクスを追加するために使用する epub:type 属性を示している。

<html … xmlns:epub="http://www.idpf.org/2007/ops">
   …
<p> … <span epub:type="pagebreak" id="p234"/> … </p>    
   … 
</html>

2.4.1.3 語彙の関連性

この仕様は、次の変更を伴う語彙の関連付けメカニズム [Packages32] で定義された語彙の関連性メカニズムを採用する。

2.4.1.3.1 標準の語彙

コンテンツドキュメントの標準の語彙は、[EPUB-SSV] で定義される。[EPUB-SSV] の一部でないプリフィックスがつかない用語を包含してもよいが（MAY）、これらの使用は、推奨されない。プリフィックスの使用は、カスタムセマンティクスを追加するための望ましい方法である。

2.4.1.3.2 予約済みのプリフィックス

製作者は、宣言をすることなく、epub:type 属性に次の予約済みのプリフィックスを使用してもよい（MAY）。

Warning

予約済みのプリフィックスは、オーサリング時に便利だが、それらの依存は、相互互換性の問題に繋がる。適合性ツールは、ツールが更新されるまで、新しいプリフィックスを拒否するだろう。製作者は、このような問題を避けるために、使用する全てのプリフィックスを宣言することを強く推奨する。

プリフィックス	IRI
msv	http://www.idpf.org/epub/vocab/structure/magazine/#
prism	http://www.prismstandard.org/specifications/3.0/PRISM_CV_Spec_3.0.htm#

2.4.1.3.3 prefix 属性

prefix 属性の定義は変わらないが、属性は EPUB コンテンツドキュメント内で使用されるとき、名前空間 http://www.idpf.org/2007/ops で定義される。

prefix 属性は、[HTML] のルート html 要素のみ有効である。

2.4.1.4 処理の要件

リーディングシステムは、次のように epub:type 属性を処理しなければならない（MUST）。

標準の語彙で定義されている用語のいくつかまたは全てに、動作を結びつけなくてもよい（MAY）。
他の語彙からの用語に、動作を結びつけてもよい（MAY）。
認識できない用語を無視しなければならない（MUST）。

指定した epub:type 値に関連付けられているリーディングシステムの動作がネイティブの動作と衝突するとき、要素に関連付けられている動作の優先順位を指定しなければならない（MUST）。

2.4.2 意味の強化

2.4.2.1 まえがき

このセクションは規定ではない。

マークアップした構造を改良することに関して、意味の変化とは異なり、意味の強化は、機械の処理を容易にするためにコンテンツ内の意味の階層化を可能にする。

[Microdata] と [RDFA-CORE] 仕様の両方は、コンテンツを意味論的に強化する XHTML コンテンツドキュメントで使用できる属性のセットを定義する。

2.4.2.2 RDFa

[RDFA-CORE] 属性の使用は、XHTML コンテンツドキュメントで許可されているが、全ての使用方法は、[[!HTML+RDFA]] に定義されている要件に適合しなければならない（MUST）。

[RDFA-CORE] 仕様は、RDFa 属性を使用したときの [HTML] コンテンツモデルの変更を定義している。この修正されたコンテンツモデルは、XHTML コンテンツドキュメントに妥当である。

属性処理モデル [RDFA-CORE] の EPUB リーディングシステムのサポートは、省略可能（OPTIONAL）である。

2.4.2.3 Microdata

[Microdata] 属性の使用は、XHTML コンテンツドキュメントで許可されているが、全ての使用方法は、[HTML+RDFa11] に定義されている要件に適合しなければならない（MUST）。

[Microdata] 仕様は、マイクロデータの属性を使用したときの [HTML] コンテンツモデルの変更を定義している。この修正されたコンテンツモデルは、XHTML コンテンツドキュメントに妥当である。

JSON への変換 [Microdata] と同様に、属性処理モデルに対する EPUB リーディングシステムのサポートは省略可能（OPTIONAL）である。

2.4.3 SSML 属性

2.4.3.1 まえがき

W3C Speech Synthesis Markup Language [SSML] は、同期スピーチを生成するテキスト読み上げ（TTS）エンジンを支援するために使われる言語である。SSML は独立したドキュメント形式として設計されているが、他のマークアップ言語内で使用するのにも適した意味も定義している。

この仕様は、[SSML] phoneme 要素の二つの属性（ssml:ph と ssml:alphabet）について見直し、XHTML コンテンツドキュメント内で利用可能にする。

テキスト読み上げ（TTS）機能のあるリーディングシステムは上記で定義されている SSML 属性をサポートするべきである（SHOULD）。

Note

同期スピーチに関連する EPUB 3 の機能に関するより詳細な情報は、テキスト読み上げ [EPUB3Overview] を参照されたい。

2.4.3.2 `ssml:ph` 属性

ssml:ph 属性は、属性を加えられた要素によって表現されるテキストとしての発話音素や発音記号表記を規定している。

属性名

ph

名前空間

https://www.w3.org/2001/10/synthesis

使用方法

グローバル属性。当て字は論理的に関連付ける（例えば、テキスト情報が含まれている要素）ことのできる全ての要素に指定してもよい（MAY）。

すでにこの属性を含んでいる要素の子孫に指定してはならない（MUST NOT）。

値

使用されている音韻字母/音声記号に関する構文的に妥当な音素表現/表音。

この属性は、次を追加した [SSML] phoneme 要素 ph 属性の全てのセマンティクスを継承する。

ssml:ph 属性がテキストノードの子孫要素に出現するとき、発音を適用するのに対応するドキュメントのテキストは、ドキュメントの順で、対応する子孫のテキストノードの結果を一続きにする。指定された発音記号表記は、（すなわち、その内容の孤立した部分だけではなく）全体の中のテキストデータの要素と論理的に一致しなければならない（MUST）。

SSML の属性と PLS ドキュメントをサポートするリーディングシステムは、これらの二つの構造のために定義された優先順位の規則を履行しなければならない（MUST）。

2.4.3.3 `ssml:alphabet` 属性

ssml:alphabet 属性は、発話音素や発音記号表記のアルファベットが ssml:ph 属性の値で使用されることを規定している。

属性名: alphabet
名前空間: https://www.w3.org/2001/10/synthesis
使用方法: グローバル属性。任意の要素に指定してもよい（MAY）。
値: （継承した）ssml:ph の値で使用される発音アルファベットの名前。

この属性は、次の追加を伴った、[SSML] phoneme 要素 alphabet 属性の全てのセマンティクスを継承する：

ssml:alphabet 属性の値はドキュメントツリーに継承される。指定された ssml:ph 属性値に使用される発話アルファベットは、最も近い親要素に続く、ssml:ph 属性が出現する要素から始まる ssml:alphabet 属性の最初に発生する位置によって決定される。

Note

[SSML] 仕様は、アルファベットのレジストリを参照していますが、公開されていない。W3C Voice Browser ワーキンググループの憲章は有効期限が切れているため、このようなレジストリの公開は期待されない。したがって、製作者は、サポートされているアルファベット値を決定するために、リーディングシステムのサポートドキュメントを参照する必要がある。x-JEITA（x-JEITA-IT-4002 と x-JEITA-IT-4006）および x-sampa などの一般的なアルファベットも包含する。

この仕様の SSML 属性の機能をサポートするリーディングシステムは、値「ipa」で表現される IPA アルファベット [IPA] をサポートするべきである（SHOULD）。

2.4.4 コンテンツの切り替え（非推奨）

switch 要素は、EPUB リーディングシステムのスクリプト機能に依存せず、製作者が、読者へ表示するコンテンツを調整できる単純なメカニズムを提供する。

switch 要素の使用は、非推奨（deprecated）である。使用法の情報は、[ContentDocs301] の定義を参照されたい。

2.4.5 `epub:trigger` 要素（非推奨）

trigger 要素は、スクリプト化及び非スクリプト化のコンテキストの両方において、例えば、音声や動画の再生など、マルチメディアオブジェクトを制御するマークアップ定義のユーザーインターフェースの作成を可能にする。

trigger 要素の使用は、非推奨（deprecated）である。使用法の情報は、[ContentDocs301] の定義を参照されたい。

2.4.6 カスタム属性

リーディングシステムは、EPUB 出版物のレンダリングを強化するために、この仕様で定義されていない機能を導入してもよい（MAY）。この実験を容易にするために、ベンダーは、XHTML コンテンツドキュメントで使用するためにカスタム属性を定義してもよい（MAY）。

カスタム属性は、次の URI のいずれにも一致しない名前空間 [XML-NAMES] として定義されている外部の名前空間から、そのような属性が提供されている XHTML コンテンツドキュメント内の任意の要素に包含されてもよい（MAY）。

http://www.w3.org/1999/xhtml
http://www.idpf.org/2007/ops

カスタム属性と、それに結びついた挙動は、EPUB 出版物の整合性を変更してはならない（MUST NOT）。コンテンツは、リーディングシステムのレンダリングに関わらず、任意の情報の損失や他の重要な劣化なしに、読者によって消費できるままにしなければならない（MUST）。

Note

リーディングシステムを横断するカスタム属性の相互互換性を容易にするために、ベンダーは、[AttributeExtensions] で実装される任意の拡張をドキュメント化することを強く推奨する。

2.5 HTML の許容性と制約

このセクションは、EPUB 3 の XHTML コンテンツドキュメントで許可されている基本的な [HTML] ドキュメントモデルから許容性と制約を定義する。

2.5.1 埋め込み MathML

2.5.1.1 まえがき

このセクションは規定ではない。

XHTML コンテンツドキュメントは、埋め込み [MATHML3] をサポートするが、完全な MathML マークアップ言語の制限されたサブセットの使用法に限定をする。

このサブセットは、[HTML] ユーザーエージェントとの互換性を保持しながら、リーディングシステムの実装負荷の軽減とアクセシビリティを促進するよう設計されている。

Note

マニフェスト item 要素の mathml プロパティは、XHTML コンテンツドキュメントが埋め込み MathML を含んでいることを示している。

2.5.1.2 コンテンツの適合性

XHTML コンテンツドキュメント内の MathML マークアップのいずれかの発生には、次にある追加の制約付きで、MathML 仕様 [MATHML3] 内に述べられている制約に準拠しなければならない（MUST）。

Presentation MathML

math 要素は、annotation-xml 要素を除外して、Presentation MathML のみ含まなければならない（MUST）。

Content MathML

Content MathML は、XHTML コンテンツドキュメントの MathML マークアップ内に包含してもよく（MAY）、そして、表示されるとき、semantics 要素の annotation-xml 子要素に生じなければならない（MUST）。

Content MathML は、上記の条件のように包含するとき、指定された annotation-xml 要素の encoding 属性は、機能的に同等な値の MathML-Content かそれとも application/mathml-content+xml を設定しなければならず（MUST）、その name 属性は contentequiv に設定されなければならない（MUST）。

Deprecated MathML

[MATHML3] で非推奨にマークされた要素と属性は、XHTML コンテンツドキュメントの MathML マークアップ内に包含してはならない（MUST NOT）。

2.5.1.3 リーディングシステムの適合性

適合した EPUB リーディングシステムは、XHTML コンテンツドキュメントに埋め込まれた MathML をサポートするために次の基準を全て満たさなければならない（MUST）。

[MATHML3] 仕様で定義されているように、Presentation MathML の入力に対応するレンダラーでなければならない（MUST）。
annotation-xml 要素にある Content MathML のレンダリングをサポートしてもよい（MAY）。
ビューポートを持つ場合、Presentation MathML の視覚的なレンダリングをサポートしなければならない（MUST）。

Note

EPUB リーディングシステムは、例えば MathML のレンダリングを提供する MathJax など、サードパーティのライブラリの使用を選択してもよい。

2.5.2 埋め込み SVG

XHTML コンテンツドキュメントは、（参照を介しての埋め込み、たとえば、img や object 要素による）参照と、（XHTML コンテンツドキュメント内の svg 要素の直接な包含を介しての埋め込みによる）包含による SVG ドキュメントフラグメント [SVG] の埋め込みをサポートする。

XHTML コンテンツドキュメントに埋め込まれた SVG のコンテンツの適合性の制約は、SVG の制約の SVG コンテンツドキュメントために定義されたものと同じである。

リーディングシステムは、SVG コンテンツドキュメント - リーディングシステムの適合性に定義された XHTML コンテンツドキュメントに埋め込まれた SVG を処理しなければならない（MUST）。

Note

マニフェスト item 要素 [Packages32] の svg プロパティは、XHTML コンテンツドキュメントに埋め込み SVG を含んでいることを示している。

2.5.2.1 埋め込み SVG と CSS

参照によって XHTML コンテンツドキュメントに埋め込まれた SVG のスタイリングのために、リーディングシステムは、参照先の SVG ドキュメントに含まれるドキュメントの CSS スタイルルールを適用してはならない（MUST NOT）。

包含によって XHTML コンテンツドキュメントに埋め込まれた SVG のスタイリングのために、リーディングシステムは、包含された SVG 要素に含まれているドキュメントの CSS ルールを適用しなければならない（MUST）。

Note

参照によって包含された SVG は、別のドキュメントのように処理され、SVG コンテンツドキュメントと同様に独自の CSS スタイルルールを包含できる。これは、外部の [HTML] 要素を参照する [HTML] object 要素の状況と一致していると注意されたい。

2.5.3 Unicode の制限

本セクションは、Unicode 文字のレパートリーの制約を記載する。

外字文字と埋め込みフォント: [Unicode] に定義された通りに私用領域（PUA）範囲のひとつの中の符号位置にマッピングされた任意の包含された文字は、その符号位置のために適したグリフを含む埋め込みフォント [CSS-Fonts-3] を参照し包含する方法で、設定または起因し、文字列内に発生しなければならない（MUST）。

2.5.4 推奨されない構造

このセクションは規定ではない。

2.5.4.1 `rp` 要素

[HTML] rp 要素は、（例えば、丸括弧表示で囲む ruby マークアップなど）ルビのマークアップを見分けられない古いリーディングシステムのためのフォールバックの提供を意図している。EPUB 3 リーディングシステムがルビを認識し、またフォールバックを提供できるなら、rp 要素の使用は推奨されない。

2.5.4.2 `embed` 要素

[HTML] embed 要素は、スクリプトをサポートしないリーディングシステムのために、フォールバックコンテンツンツを提供するための固有の設備を提供しないので、製作者は、参照されたリソースにスクリプトが包含されているときは、要素の使用が推奨されない。[HTML] object 要素は、固有のフォールバック機能を包含するため、代わりに使用できる。

2.5.5 管理外リソースの制約

管理外リソースは、管理外リソースがサポートされていないとき、固有のフォールバック手法で代替表現を提供することが可能である場合には、固有のフォールバックメカニズムを持つ要素から参照されてもよい（MAY）。例えば、多くの [HTML] 埋め込まれたコンテンツ要素は、複数のソースを指定できるようにするか、リソースがレンダリングできないときのために埋め込みの HTML コンテンツを許可するなど、代替レンダリングをオプションを提供する。コアメディアタイプリソースまたは埋め込まれた HTML コンテンツは、管理外リソースを参照するとき、特定の要素固有のフォールバックメカニズムを介して提供されなければならない（MUST）。

[HTML] フローコンテンツは、（例えば、EPUB 2 リーディングシステムなど）これらの要素が認められていない古いリーディングシステムでレンダリングするために、audio 及び video 要素内に埋め込まれてもよいが（MAY）、フォールバックのコアメディアタイプリソースを表すものではない。

[HTML] img 要素に関連付けることができる様々なソースのために、以下のフォールバック条件がその使用に適用される。

それが picture 要素である場合、
- それらの属性が指定されたとき、その src と srcset 属性からコアメディアタイプリソースを参照しなければならない（MUST）。そして、
- 各兄弟 source 要素は、type 属性でコアメディアタイプではないメディアタイプを指定しない限り、その src と srcset 属性からコアメディアタイプリソースを参照しなければならない（MUST）。
さもなければ、マニフェストフォールバック [Packages32] が定義されているという条件において、src と srcset 属性で管理外リソースを参照してもよい（MAY）。

次の [HTML] 要素は、フォールバックのコアメディアタイプリソースを提供することなく、管理外リソース [EPUB32] を参照できる。

link — rel 属性が、値「pronunciation」を持つ場合
track
video — 任意の子 source 要素を包含している

管理外リソースは、フォールバックのコアメディアタイプリソースの提供なしに、前述の三つの要素から参照されてもよい（MAY）。

Note

このような [HTML] iframe など、固有のメカニズムのない要素のフォールバックを提供するためにマニフェストフォールバック [Packages32] を参照されたい。

2.5.6 フォーム送信

[HTML] フォームの送信に対するリーディングシステムのサポートは、省略可能である（OPTIONAL）。例えば、リーディングシステムは、ネットワークへのアクセスを制限することで、フォーム送信を防ぐかもしれない。

3. SVG コンテンツドキュメント

[SVG] の一部の機能は、リーディングシステムにおいて完全にサポートされていないか、リーディングシステムが動作する全てのプラットフォームを横断してサポートされていない。そのような機能を利用する場合、製作者は、相互運用性とドキュメントの寿命への潜在的な影響の面で、固有のリスクを考慮する必要がある。

3.1 まえがき

このセクションは規定ではない。

Scalable Vector Graphics (SVG) 仕様 [SVG] は、最終型のベクターグラフィックとテキストを表現するためのフォーマットを定義する。

EPUB 出版物は、典型的に、トップレベルの文書型に XHTML コンテンツドキュメントを使用するが、SVG コンテンツドキュメントの使用も許可されている。SVG は、典型的に、最終型のページ画像がコンテンツの唯一な適切な表現である場合など、（例えば、カバーアート及びマンガやコミックブックのコンテクスト内など）特殊な状況でのみ使用する

本セクションは、[SVG] ドキュメントのプロファイルを定義する。この仕様に準拠した XML ドキュメントのインスタンスはコアメディアタイプリソースであり、SVG コンテンツドキュメントとしてこの仕様を参照している。

Note

本セクションは SVG コンテンツドキュメントのための適合性の制約を定義している。XHTML コンテンツドキュメントに埋め込まれた SVG のための適合性の制約は埋め込み SVG を参照されたい。

3.2 コンテンツの適合性

SVG コンテンツドキュメントは、次の基準を全て満たさなければならない（MUST）。

ドキュメントのプロパティ

XML 適合性 [EPUB32] で定義されている XML ドキュメントのための適合性の制約を満たさなければならない（MUST）。

コアメディアタイプリソースを包含するためにフォールバックを提供する管理外リソースへの参照を包含してもよい（MAY）。

SVG ドキュメントフラグメント [SVG] であり、SVG の制限で述べられている全てのコンテンツの適合性要件に準拠しなければならない（MUST）。

Note

[EPUBAccessibility] のアクセシビリティ要件に従う EPUB 出版物の推奨は、SVG コンテンツドキュメントに適用する。アクセシビリティ [EPUB32] を見よ。

ファイルのプロパティ

SVG コンテンツドキュメントのファイル名は、ファイル拡張子 .svg を使用するべきである（SHOULD）。

3.3 SVG の制限

この仕様は、次のように SVG コンテンツドキュメントのコンテンツモデルと XHTML コンテンツドキュメントに埋め込む SVGを制限する。

[SVG] foreignObject 要素は、次の条件を順守しなければならない（MUST）。
- [HTML] フローコンテンツかひとつの [HTML] body 要素のいずれかを含めなければならない（MUST）。
  
  Note
  
  埋め込まれた SVG の場合、body 要素は、[HTML] で定義された SVG の制約に従って許可されない。
- コンテンツは、XHTML コンテンツドキュメント — コンテンツの適合性に定義された XHTML コンテンツドキュメントモデルに適合する、妥当なドキュメントフラグメントでなければならない（MUST）。
- もし指定されているなら、requiredExtensions 属性は、「http://www.idpf.org/2007/ops」を設定しなければならない（MUST）。
[SVG] title 要素は、妥当な XHTML コンテンツドキュメントのフレージングコンテンツのみを含めなければならない（MUST）。

3.4 リーディングシステムの適合性

適合した EPUB リーディングシステムは、SVG コンテンツドキュメントと XHTML コンテンツドキュメントに埋め込む SVG の処理のための次の基準を全て満たさなければならない（MUST）。

上書きとしてこの仕様によって明確に定義されない限り、[SVG] 仕様によって定義されたセマンティクスを使用して、SVG コンテンツドキュメントを処理し、その中で述べられる全ての利用可能なユーザーエージェントの適合性の制約を尊重しなければならない（MUST）。
スクリプトコンテンツドキュメント — リーディングシステムの適合性で定義されているリーディングシステムの適合性の基準を満たさなければならない（MUST）。
ビューポートを持つ場合、Styling [SVG] で定義されているように CSS を使用した SVG の視覚レンダリングをサポートしなければならず（MUST）、Property Index [SVG] で定義されている全てのプロパティをサポートすべきである（SHOULD）。埋め込み SVG の場合、埋め込み SVG と CSS で定義されている制約にも適合しなければならない（MUST）。
SVG 要素内にあるテキストを、ユーザーによる選択と検索をサポートするべきである（SHOULD）。
（例えば属性が、foreignObject 要素または switch 要素の子に包含されるとき）XHTML コンテンツドキュメントフラグメントの存在を表現する requiredExtensions 属性の値「http://www.idpf.org/2007/ops」を認識しなければならない（MUST）。

3.5 意味の変化

XHTML の意味の変化で定義された構文とセマンティクスは、SVG コンテンツドキュメントで epub:type と epub:prefix 属性を使用するために継承される。

epub:prefix 属性の使用は、SVG コンテンツドキュメントにおけるルート svg 要素でのみ有効である。埋め込まれた SVG で使用されるプリフィックスは、XHTML の意味の変化で定義されているように、[HTML] ルートの html 要素に宣言されなければならない（MUST）。

4. CSS スタイルシート

4.1 まえがき

このセクションは規定ではない。

CSS は、オープン Web プラットフォームの不可欠な一部である。読者や出版社、ドキュメントの製作者は、HTML がうまく動作するように、CSS が「うまく動作する」と期待している。

過去に、EPUB は、特定のプロパティのサポートを義務付け、他の多数のプロパティにおいてプレフィックス付きバージョンを提供する CSS のプロファイルを定義した。CSS ワーキンググループはプリフィックス付きプロパティの使用をもはや推奨されていないけれども、この仕様は、既存コンテンツとの断絶を避けるためにいくつかのプリフィックス付きプロパティを保持する。しかし、このセクションで定義されているマイナーな例外を除き、EPUB は、CSS を定義する W3C に従う。

4.2 コンテンツの適合性

適合している CSS スタイルシートは、次の基準を全て満たさなければならない（MUST）。

次の例外を除いて、任意の CSS プロパティを包含してもよい（MAY）。
- direction プロパティ [CSS-Writing-Modes-3] を使用してはならない（MUST NOT）。インラインの基本方向を設定するには [HTML] dir 属性を使用する。
- unicode-bidi プロパティ [CSS-Writing-Modes-3] を使用してはならない（MUST NOT）。双方向性をコントロールするには [HTML] bdo 要素と dir 属性を使用する。
CSS スタイルシート — プリフィックス付きプロパティで定義されているプレフィックス付きプロパティを包含してもよい（MAY）。
UTF-8 または UTF-16 [Unicode] でエンコードしなければならない（MUST）。

Note

いくつかのリーディングシステムは、CSS の全ての要求される機能をサポートしていないことに注意されたい。具体的には、次の問題があることが知られている。

リーディングシステムによって誘発されたページネーションは、スタイルシートに対して不完全に作用する。時折、ページネーションは、ビューポートサイズに対して不完全な値をもたらし、カラムに使用される。。固定及び絶対配置は、特に問題である。
スクリーンの一部のタイプは、（例えば、レイテンシが高いなど）アニメーションとトランジションを不完全にレンダリングするかもしれない。

4.3 リーディングシステムの適合性

適合した EPUB リーディングシステムは、CSS スタイルシートを処理するために次の基準を全て満たさなければならない（MUST）。

[CSSSnapshot] に記載されているような CSS の正式な定義をサポートしなければならない（MUST）。
最新の勧告候補ステータス [W3CProcess] に達しており（また、広く実装されている） [CSSSnapshot] の利用可能な全てのモジュールをサポートするべきである（SHOULD）。
@font-face ルールから参照された [TrueType]、[OpenType]、[WOFF] 及び [WOFF2] フォントリソースをサポートしなければならない（MUST）。
CSS スタイルシート — プリフィックス付きプロパティに定義されている全てのプリフィックス付きプロパティをサポートしなければならない（MUST）。
上記で定義された CSS プロパティのサポートに加えて、そのユーザーエージェントスタイルシートは、[HTML] で提案されたデフォルトのレンダリングをサポートするべきである（SHOULD）。
リーディングシステムによる上書きで定義されているように、著者は、CSSとユーザースタイルを尊重するべきである（SHOULD）。

リーディングシステムの開発者は、主要なブラウザのレベルで CSS のサポートを実装することが推奨される。

4.4 プリフィックス付きプロパティ

製作者は、プリフィックスのないプロパティと、現在の CSS 仕様をサポートするリーディングシステムを使用することが強く推奨される。[ContentDocs301] から広く使用されているプリフィックス付きプロパティは保留されたが、他のプロパティのサポートは取り除かれた。製作者は、必要な時に必要な場所で利用できる、取り除かれたプロパティのためのネイティブな CSS のソリューションを使用することを勧める。

現在、これらプリフィックス付きプロパティを使用している製作者は、これらプロパティが、EPUB の次のメジャーバージョンでサポートされる見込がないため、すぐにサポートできるプリフィックスのないバージョンに移行することが推奨される。

4.4.1 CSS Writing Modes

次の表は、[CSS-Writing-Modes-3] の -epub- プリフィックス付きプロパティの一覧である。値の列は、プロパティに対応する値を示している。以前の EPUB マッピングの列は、EPUB 3 の前のバージョンで使用されていた値/プロパティを示している。古いプロパティや値を意味するアスタリスク（*）は、現在は廃止されている。最後の列は、[CSS-Writing-Modes-3-20151215] に基いてプリフィックス付きプロパティを実装する方法を説明している。

プロパティ	値	以前の EPUB マッピング	[CSS-Writing-Modes-3-20151215] へのマッピング
`-epub-text-orientation`	`upright`	`upright`	`upright`
`-epub-text-orientation`	`mixed`	`vertical-right`*	`mixed`
`-epub-text-orientation`	`sideways-right`	`sideways-right`	`sideways`
`-epub-text-orientation`	`sideways-right`	`rotate-right`*	`sideways`
`-epub-text-orientation`	`sideways`	`rotate-normal`*	`sideways`
`-epub-text-orientation`	`sideways`	`sideways`	`sideways`
`-epub-text-orientation`	`mixed`	`mixed`	`mixed`
`-epub-writing-mode`	`horizontal-tb`	`horizontal-tb`	`horizontal-tb`
`-epub-writing-mode`	`vertical-rl`	`vertical-rl`	`vertical-rl`
`-epub-writing-mode`	`vertical-lr`	`vertical-lr`	`vertical-lr`
`-epub-text-combine`*	`-epub-text-combine-horizontal: none`	`none`	`text-combine-upright: none`
`-epub-text-combine`*	`-epub-text-combine-horizontal: all`	`horizontal`	`text-combine-upright: all`
`-epub-text-combine`*	Error	`horizontal <number>`	`text-combine-upright: digits <number>`

4.4.2 CSS Text Level 3

プロパティ	値	[CSS-Text-3-20160119] へのマッピング
`-epub-hyphens`	`none \| manual \| auto`	変更なし
`-epub-hyphens`	`all`	非サポート
`-epub-line-break`	`auto \| loose \| normal \| strict`	変更なし
`-epub-text-align-last`	`auto \| start \| end \| left \| right \| center \| justify`	変更なし
`-epub-word-break`	`normal \| keep-all \| break-all`	変更なし
`text-transform`	`-epub-fullwidth`	`text-transform: full-width`

4.4.3 CSS Text Decoration Level 3

プロパティ	値	[CSS-Text-Decor-3] へのマッピング
`-epub-text-emphasis-color`	`<color>`	変更なし
`-epub-text-emphasis-position`	`[ over \| under ] && [ right \| left ]`	変更なし
`-epub-text-emphasis-style`	`none \| [ [ filled \| open ] \|\| [ dot \| circle \| double-circle \| triangle \| sesame ] ] \| <string>`	変更なし
`-epub-text-underline-position`	`auto \| [ under \|\| [ left \| right ] ]`	変更なし
`-epub-text-underline-position`	`alphabetic`	`text-underline-position: auto`

Component value combinators [CSS-Values-3] に定義されているプロパティ値の構文。

4.5 リーディングシステムによる上書き

EPUB リーディングシステムは、EPUB コンテンツドキュメントに書かれているように、製作者のスタイルシートを適用するべきである（SHOULD）。リーディングシステムが許可している場合、ユーザーが必要に応じて製作者のスタイルシートを上書きできるようにするべきである（SHOULD）。EPUB リーディングシステムは、特に必要でない限り、製作者のスタイルシートを上書きするべきではない（SHOULD NOT）。

リーディングシステムが製作者のスタイルシートを上書きする場合、ユーザーエージェントスタイルシートや getOverrideStyle メソッド [DOM-Level-2-Style]、[HTML] style 属性を介するカスケードを保持する方法で行うべきである（SHOULD）。

リーディングシステムの開発者は、ユーザーエージェントスタイルシートおよび製作者のスタイルシートとやり取りする方法を、公の文書にすることを強く推奨する。

5. スクリプト

5.1 スクリプトのコンテクスト

EPUB コンテンツドキュメントは、個別の基本的な仕様（[HTML] と [SVG]）でこのために定義された機能を使用してスクリプトを含んでもよい（MAY）。EPUB コンテンツドキュメントがスクリプトを含むとき、この仕様やスクリプトコンテンツドキュメントを参照する。このラベルは、それらが [HTML] フォームのインスタンスを含む時、XHTML コンテンツドキュメントに適用する。

この仕様は、スクリプトが現れてもよい（MAY）、二つのコンテクストを定義する。

スパインレベル

トップレベルコンテンツドキュメントに包含される [HTML] の script または [SVG] script 要素のインスタンス。

コンテナ制約

次のいずれか。

[HTML] script 要素のインスタンスは、[HTML] iframe 要素を使用して親の XHTML コンテンツドキュメントに埋め込まれている XHTML コンテンツドキュメントに包含される。
[SVG] script 要素のインスタンスは、[HTML] iframe 要素を使用して親の XHTML コンテンツドキュメントに埋め込まれている SVG コンテンツドキュメントに包含される。

上記の定義されたコンテクストの両方で、JavaScript のコードは、script 要素内に直接埋め込まれるか、src 属性経由で参照されているどうかで、実行するコンテクストに差はない。

どちらのコンテクストのスクリプトも、リーディングシステムがそこに設置する権利と制約を決定して利用する。（全てのリーディングシステムが同じスクリプト機能を提供するであろう）順守する必要のあるいくつかの固有の要求事項については、コンテンツの適合性とリーディングシステムの適合性を参照されたい。

例

Example 4

次の例はパッケージドキュメントと見なす。

<package …>
    …
<manifest>
        …
<item id="chap01" 
href="scripted01.xhtml" 
media-type="application/xhtml+xml"
properties="scripted"/>
<item id="inset01" 
href="scripted02.xhtml" 
media-type="application/xhtml+xml"
properties="scripted"/>
<item id="slideshowjs" 
href="slideshow.js" 
media-type="text/javascript"/>
</manifest>
    
<spine …>
<itemref idref="chap01"/>
        …
</spine>
    …
</package>

そして付随するファイルである scripted01.xhtml。

<html …>
<head>
        …
<script type="text/javascript">
            alert("Reading System name: " + navigator.epubReadingSystem.name);
</script>
</head>
<body>
        …
<iframe src="scripted02.xhtml" … />
        …
</body>
</html>

そして付随するファイルである scripted02.xhtml。

<html …>
<head>
        …
<script type="text/javascript" href="slideshow.js"></script>
</head>
<body>
        …
</body>
</html>

これらの例から、次に当てはまる。

ドキュメントはスパインから参照されるので、scripted01.xhtml の head にある script 要素内のコードは、スパインレベルのスクリプトであり、
そこで発生した HTML ファイルは、iframe 要素を介して scripted01.xhtml に包含されるので、scripted02.xhtml の script 要素内のコードはコンテナ制約のスクリプトである。

5.2 コンテンツの適合性

コンテナ制約のスクリプト

コンテナ制約のスクリプトは、親のコンテンツドキュメントまたは EPUB 出版物内の他のコンテンツの DOM を変更する指示を含んではならず（MUST NOT）、含んでいる矩形のサイズを操作するための指示を含んではならない（MUST NOT）。

スパインレベルのスクリプト

スパインレベルのスクリプトを包含している EPUB コンテンツドキュメントは、この仕様の目的のために次のように定義されている、プログレッシブエンハンスメントの技法を利用しなければならない（MUST）。ドキュメントが、スクリプトのサポートをしない、またはスクリプトのサポートが無効になっているリーディングシステムによってレンダリングされるとき、トップレベルコンテンツドキュメントは、いかなる情報も失われたり、他の重大な劣化なしに読者によって消費できるように整合性を保たなければならない（MUST）。

アクセシビリティ

フォールバック

スクリプトを包含している EPUB コンテンツドキュメントは、固有のフォールバックメカニズム（例えば [HTML] object と canvas 要素のためにそれらを利用できるもの）を使用するか、それとも固有のフォールバックを適用できないとき、マニフェストレベルのフォールバック [Packages32] を使用して、そのようなコンテンツのためにフォールバックを提供してもよい（MAY）。

製作者は、スクリプトが、コアメディアタイプリソース又はフラグメントの [EPUB32] を生成するだけであることを保証しなければならない（MUST）。

Note

マニフェスト item 要素の scripted プロパティは、EPUB コンテンツドキュメントがスクリプトコンテンツドキュメントであることを示している。

5.3 リーディングシステムの適合性

スクリプトをサポートするリーディングシステムは、次の基準を満たさなければならない（MUST）。

リフロー可能な EPUB コンテンツドキュメントは、コンテナ制約のスクリプトをサポートするべきである（SHOULD）。
固定レイアウトドキュメントは、スパインレベルのスクリプトをサポートするべきである（SHOULD）。
rendition:flow プロパティ [Packages32] によって定義された「scrolled-doc」または「scrolled-continuous」プレゼンテーションモードを使用するリフロー可能な EPUB コンテンツドキュメント内におけるスパインレベルのスクリプトをサポートするべきである（SHOULD）。同様に、リフロー可能な EPUB コンテンツドキュメント内におけるスパインレベルのスクリプトをサポートする場合、「scrolled-doc」プレゼンテーションモードを実行しなければならなず（MUST）、「scrolled-continuous」プレゼンテーションモードを実行するべきである（SHOULD）。
他のコンテクストでスクリプトをサポートしてもよいが（MAY）、この仕様は、そのようなスクリプトに対応していない。その結果、そのようなコンテクストにおけるスクリプトの使用は、リーディングシステム間で一貫性がないかもしれない。
[HTML] に従ったスクリプトのユーザーエージェントとして、インタラクティブなスクリプトコンテンツドキュメントをレンダリングしてもよい（MAY）。
親のコンテンツドキュメントまたは EPUB 出版物内の他のコンテンツの DOM を変更するコンテナ制約のスクリプトを許可してはならない（MUST NOT）、含んでいる矩形のサイズを操作するための指示を包含してはならない（MUST NOT）。（注：たとえスクリプトはコンテナ制約でなくても、リーディングシステムは、変更に制約を強要してもよい（MAY）（dom-manipulation 機能を参照されたい）。）
（例えば、ネットワークの制限など）スクリプトの実行時に提供される機能に追加の制限を加えてもよい（MAY）。
補足 A JavaScript epubReadingSystem オブジェクトで定義されている JavaScript の navigator 拡張オブジェクト epubReadingSystem を実装しなければならない（MUST）。コンテナ制約のスクリプトのコンテクストの機能で定義されている dom-manipulation と layout-change 機能もサポートしなければならない（MUST）。

スクリプトをサポートしないリーディングシステムは、次の基準を満たさなければならない（MUST）。

スクリプトコンテンツドキュメントのためのフォールバックで定義されているスクリプトコンテンツのためのフォールバックを処理をしなければならない（MUST）。

Note

リーディングシステムは、他の EPUB の機能を無効にしたり、または（例えば、改ページの無効による）異なるレンダリングやユーザーエクスペリエンスを提供する方法でスクリプトコンテンツドキュメントをレンダリングするかもしれない。

コンテナ制約モデルの使用を制限を選択する製作者は、スクリプトと非スクリプトコンテンツの間でより一貫性のあるユーザーエクスペリエンス（例えば、一貫性のあるページネーションの挙動）を確保するであろう。

製作者は、これらの EPUB 出版物の互換性や寿命、アクセシビリティを向上させ、可能な時はスクリプトの包含を避ける現実的な宣言の技法を使用することを勧める。

5.4 セキュリティの考慮事項

このセクションは規定ではない。

全ての EPUB 製作者と EPUB リーディングシステムの開発者は、スクリプトコンテンツが、リーディングシステムによって実行されるときに発生するセキュリティ問題に注意する必要がある。リーディングシステムとブラウザによって採用されている基本的なスクリプトモデルが同じであるように、Web コンテクスト内で発生した問題と同じ種類を考慮する必要がある。

各リーディングシステムは、特定のドキュメント内のスクリプトが信頼できるかそうでないかを、はっきりさせる必要がある。全てのスクリプトが、信頼できない（そして潜在的に悪意のある）ものとして処理され、攻撃の全てのベクトルが分析され、保護されるのを勧める。具体的には、次を考慮する必要がある。

ランタイム環境への攻撃（例えば、ユーザーのハードドライブからファイルを盗む）、
リーディングシステム自体への攻撃（例えば、読者の本のリストを盗んだりまたは予想外の動作を引き起こす）、
他に対するあるコンテンツドキュメントの攻撃（例えば、他のドキュメントに存在するデータを盗む）、
ドキュメントの暗号化された部分に対する非暗号化のスクリプトの攻撃（例えば、保護されているコンテンツを抽出する悪意のあるスクリプトの注入）、
ローカルネットワークへの攻撃（例えば、ファイアウォールの背後にあるサーバからデータを盗む）。

次の推奨事項は、信頼できないスクリプトを処理するためのガイドとして提供する。

ブラウザベースのセキュリティは、ドキュメントの URL とドメインに大きく依存してるように、一意のドメインが各コンテンツドキュメントに割り当てられているように、リーディングシステムは動作する必要がある。この提案を採用することで、外部 URL やクッキー、DOM ストレージなどへアクセスを制限して、互いと他のインターネットドメインからドキュメントを分離する。

スクリプトとネットワークアクセスが有効なリーディングシステムは、ネットワークのアクティビティが発生していること、そして/または、それらを無効にできることを読者に通知する手法の包含をもまた考慮する必要がある。

Note

実際のところ、リーディングシステムは、ドキュメントを跨いでドメインを共有するかもしれないが、それらはまだドキュメント間の分離を維持する必要がある。

ドキュメンの一部が暗号化され、そして他の一部がそうでないとき、または異なる暗号化キーがドキュメントの異なる部分に使用されているとき、一意のドキュメントごとのドメインは、十分な保護が提供できないかもしれない。
リーディングシステムに永続的なデータの保存を許可するとき、そのデータを慎重に処理する必要がある。スクリプトは、クッキーや DOM ストレージを通じて永続的なデータを保存するかもしれないが、リーディングシステムは、そのような試みをブロックするかもしれない。データの保存を許可しているリーディングシステムは、他の関係のないドキュメント（例えば、偽装されているもの）で利用することができないことを保証する必要がある。具体的には、一致するドキュメントの識別子（もしくは同様のメタデータ）のチェックは、永続的なデータへのアクセスを制御するのに妥当な方法ではない。

ローカルストレージを許可しているリーディングシステムは、読者のためにデータの調査、無効化または削除の手段としても提供する必要ある。対象の EPUB 出版物を削除するとき、それのデータは破壊される必要がある。

これらの推奨事項への順守は、上に挙げた可能性のある攻撃からの保護を保証しないことを注意されたい。開発者は、それらのリーディングシステムのコンテクスト内のそれぞれの潜在的な脆弱性を調査する必要がある。

5.5 イベントモデルの考慮事項

このセクションは規定ではない。

リーディングシステムは、[HTML] のような DOM のイベントモデルに従い、これらのイベントに関連付けられている標準のアクションを実行する前に、スクリプト環境に UI イベントを渡す必要がある。リーディングシステムの開発者は、潜在的に悪意のあるスクリプトがこれらのリーディングシステムに影響を与えることができる範囲を制限するために、スクリプトが重要な機能（たとえばナビゲーションなど）を無効にできないことも保証する必要がある。結果として、スクリプト環境は、いかなるイベントの標準アクションをキャンセルできる必要はあるが、一部のイベントは通過させないかもしれないしキャンセルできないかもしれない。

製作者は、これらの EPUB 出版物にスクリプト機能を加えるとき、リーディングシステムの実装の可能性を考慮する必要がある。（例えば、デバイスの全てが物理キーボードを備えているわけではなく、多くの場合、ソフトウェアキーボードが、テキストのインプット要素のためのみに有効化される）。したがって、キーボードのイベントのみに頼るのは勧めない。目的のアクションのトリガーとなる代替の方法は、常に提供される必要がある。

6. 固定レイアウト

6.1 まえがき

このセクションは規定ではない。

このセクションは、パッケージドキュメントに pre-paginated として示された固定レイアウトドキュメント — EPUB コンテンツドキュメントの大きさのプロパティの表現と解釈のための規則を定義する。

この仕様は、初期包含ブロック [CSS2] がどのようにリーディングシステムのコンテンツ表示領域内に配置されるかを定義しない。

Note

ページ分割された様式（つまり、固定の幅や高さの大きさを持つ）でレンダリングされるレンディションまたは個々のスパイン項目を指定する方法についての情報は固定レイアウトプロパティ [Packages32] を参照されたい。

6.2 コンテンツの適合性

適合した固定レイアウトドキュメントは、次の基準を全て満たさなければならない（MUST）。

初期包含ブロックの大きさに定義されているような初期包含ブロック [CSS2] を指定しなければならない（MUST）。

6.3 リーディングシステムの適合性

適合した EPUB リーディングシステムは、固定レイアウトドキュメントを処理するための次の基準を全て満たさなければならない（MUST）。

ビューポートのレンダリングに定義されているように、ドキュメントに全てのコンテンツ表示領域を割り当てるべきである（SHOULD）。
HTML に ICB を表現するで定義されているように、XHTML コンテンツドキュメントをレンダリングするのに viewport meta 内で表現する大きさを使用しなければならない（MUST）。
SVG コンテンツドキュメントをレンダリングするのに SVG に ICB を表現するで定義されているような大きさを使用しなければならない（MUST）。

6.4 ビューポートのレンダリング

固定レイアウトドキュメントをレンダリングするとき、デフォルトの意図は、コンテンツ表示領域を可能な限り、使用可能なビューポートエリアの多くを占めるようにするべきである（SHOULD）。リーディングシステムは、ビューポートに例えばボーダーまたはマージン、ヘッダー、フッターなどの追加のコンテンツを入れるべきではない（SHOULD NOT）。

Note

ユーザーへのリーディングシステムをコントロールするウィジェットは、上記の期待される挙動に包含されていない。

6.5 初期包含ブロックの大きさ

6.5.1 HTML の表現

XHTML の固定レイアウトドキュメントの場合、初期包含ブロック [CSS2] の大きさは、[CSS-Device-Adapt-1] に定義された構文を使用して viewport meta タグで表現されなければならない（MUST）。この仕様のこの版では、幅と高さの表現のみ、リーディングシステムによって認識されなければならない（MUST）。

Example 5

次の例は、viewport meta タグを示している。

<head>
   …
<meta name="viewport" content="width=1200, height=600"/>
   …
</head>

リーディングシステムは、viewport meta タグで宣言された初期包含ブロック（ICB）の大きさに XHTML コンテンツを切り抜かなければならない（MUST）。初期包含ブロックの外側に位置するコンテンツは見えないであろう。ICB のアスペクト比がリーディングシステムのコンテンツ表示領域のアスペクト比と一致していないとき、リーディングシステムはユーザインタフェースに順応するため領域内の ICB を配置してもよく（MAY）、つまり、レターボックスがコンテンツの片側もしくは両側に表示されてもよい（MAY）。

6.5.2 SVG の表現

SVG 固定レイアウトドキュメントの場合、ICB の大きさは、viewBox 属性 [SVG] を使用して表現しなければならない（MUST）。

Example 6

次の例は、高さ 1200 ピクセルに従って幅 844 ピクセルのアスペクト比を持つ SVG コンテンツドキュメントのための viewBox 属性の宣言を示している。

<svg xmlns="http://www.w3.org/2000/svg"
version="1.1" 
viewBox="0 0 844 1200">
   …
</svg>

7. 発音辞書

7.1 まえがき

このセクションは規定ではない。

W3C 発音辞書仕様 (PLS) [PRONUNCIATION-LEXICON] は、自動音声認識とテキスト読み上げ（TTS）エンジンの使用による XML ベースの発音辞書のための構文とセマンティクスを定義している。

次のセクションは、EPUB 出版物を包含している PLS ドキュメントのための基準と、XHTML コンテンツドキュメントに PLS ドキュメントを結びつけるためのルールの適合性を定義している。

Note

合成音声に関連する EPUB 3 の機能の詳細な情報は、テキスト読み上げ [EPUB3Overview] を参照されたい。

7.2 EPUB 出版物の適合性

適合した EPUB 出版物のレンディションは、PLS ドキュメントに含むために次の基準を全て満たさなければならない（MUST）。

PLS ドキュメントは、XHTML コンテンツドキュメントに関連付けてよい（MAY）。それぞれの XHTML コンテンツドキュメントは、0以上の PLS ドキュメントを関連付けて含んでもよい（MAY）。
PLS ドキュメントは、「pronunciation」に設定される rel 属性を持った [HTML] の link 要素とメディアタイプ「application/pls+xml」に設定される type 属性を使用して、それを適用した XHTML コンテンツドキュメントに関連付けられねばならない（MUST）。

link 要素 hreflang 属性それぞれの link に指定するべきであり（SHOULD）、その値が指定されたとき、発音辞書が関連している言語 [PRONUNCIATION-LEXICON] に一致しなければならない（MUST）。
PLS ドキュメントは、PLS ドキュメント — コンテンツの適合性で定義されたコンテンツの適合性の基準に満たさなければならない（MUST）。
PLS ドキュメントは、EPUB パッケージ — 適合性 [Packages32] で定義されているような表現と配置にしなければならない（MUST）。

7.2.1 例

Example 7

次の例は、XHTML コンテンツドキュメントに関連付けられた二つの PLS ドキュメント（中国語とモンゴル語のためのもの）を示している。

<html … >    
<head>
        …
<link rel="pronunciation" type="application/pls+xml" hreflang="zh" href="../speech/zh.pls"/>
<link rel="pronunciation" type="application/pls+xml" hreflang="mn" href="../speech/mn.pls"/>
</head>        
    …
</html>

7.3 コンテンツの適合性

PLS ドキュメントは次の基準を全て満たさなければならない（MUST）。

ドキュメントのプロパティ

XML 適合性 [EPUB32] で定義された XML ドキュメントための適合性の制約を満たさなければならない（MUST）。

URI https://www.w3.org/TR/2008/REC-pronunciation-lexicon-20081014/ [PRONUNCIATION-LEXICON] で利用できる PLS ドキュメントのための RELAX NG スキーマに妥当でなければならない（MUST）。

ファイルのプロパティ

PLS ドキュメントのファイル名はファイル拡張子の .pls を使用するべきである（SHOULD）。

7.4 リーディングシステムの適合性

テキスト読み上げ（TTS）機能を持つリーディングシステムは、PLS ドキュメントをサポートするべきである（SHOULD）。

適合した EPUB リーディングシステムは、PLS ドキュメントの処理のための次の基準を全て満たさなければならない（MUST）。

テキスト読み上げ（TTS）機能を持ったリーディングシステムは、[PRONUNCIATION-LEXICON] をサポートするべきである（SHOULD）。

[PRONUNCIATION-LEXICON] で定義されているように PLS ドキュメントを処理しなければならない（MUST）。

発音辞書が関連している言語 [PRONUNCIATION-LEXICON] に一致する language [HTML] は現在の XHTML コンテンツドキュメント内の全てのテキストノードに供給された発音命令を適用しなければならない（MUST）。言語タグを一致させるためのアルゴリズムは [BCP47] で定義されている。

発音ルールが、特定の言語に特定の文字列の対象に対して複数指定されているとき、任意の事前に定義された発音ルールが上書きされるように、ルールの最後の発生を優先しなければならない（MUST）。

SSML 属性をサポートする場合、ssml:ph 属性経由で提供される任意の発音命令が ssml:ph 属性 [SSML] を含んでいる要素のテキストノードに一致する grapheme 要素 [PRONUNCIATION-LEXICON] に優先することを許可しなければならない（MUST）。

A. JavaScript `epubReadingSystem` オブジェクト

A.1 インターフェースの定義

この仕様は、次のように、[HTML] Navigator オブジェクトを拡張する。

[Exposed=(Window)]
interface EpubReadingSystem {
    [Unforgeable] readonly attribute DOMString name;
    [Unforgeable] readonly attribute DOMString version;
boolean hasFeature(DOMString feature, optional DOMString version);
};

partial interface Navigator {
    [Unforgeable, SameObject] readonly attribute EpubReadingSystem epubReadingSystem;
};

[WEBIDL] notation.

Note

この仕様は、WorkerNavigator オブジェクト [WebWorkers] の epubReadingSystem プロパティ拡張を定義していない。したがって、リーディングシステムは、ワーカーのスクリプトコンテクストで epubReadingSystem オブジェクトの公開を必要とせず、製作者は、その存在に依存することはできない。

A.2 概要

Navigator.epubReadingSystem オブジェクトは、スクリプトコンテンツドキュメントが、ユーザーのリーディングシステムに関する情報を照会できるインターフェースを提供する。

オブジェクトは、リーディングシステムのプロパティ（名前とバージョン）を表示し、そのサポートする機能を決定するために呼び出すことができる hasFeature メソッドを提供する。

Example 8

現在のリーディングシステムの名前を表示させる JavaScript の関数の例。

alert("Reading System name: " + navigator.epubReadingSystem.name);

リーディングシステムは、ネストされたコンテナ制約のスクリプトコンテクストを包含する、ロードされた全てのスクリプトコンテントドキュメントの navigator オブジェクト上に epubReadingSystem オブジェクトを公開しなければならない（MUST）。リーディングシステムは、DOMContentLoaded イベントがトリガー [HTML] されたときよりも遅延することなく、epubReadingSystem オブジェクトを利用できることを担保しなければならない（MUST）。

Note

リーディングシステムの実装は、技術的な実現可能性の理由から、スクリプトコンテンツドキュメント内に epubReadingSystem オブジェクトの複製されたインスタンスを作るかもしれない。このような場合に、リーディングシステムは、（そのプロパティとメソッドの値によって反映されるように）オブジェクトの状態が一貫してコピーされた全てのインスタンス間で維持されることを保証する必要がある。

A.3 プロパティ

次のプロパティで、リーディングシステムに関する情報を読み出せるようにしなければならない（MUST）。

名前	概要
`name`	リーディングシステム（例えば、"`iBooks`" や "`Kindle`"）の名前を表す `String` 値を返す。
`version`	リーディングシステム（例えば、"`1.0`", "`2.1.1`"）のバージョンを表す `String` 値を返す。
`layoutStyle`	`layoutStyle` プロパティの使用は、非推奨（deprecated）である。使用例の情報は、[ContentDocs301] の定義を参照されたい。

A.4 メソッド

A.4.1 hasFeature

A.4.1.1 概要

hasFeature メソッドは、指定された機能のいずれかのバージョンがサポートされているかどうかを示すブーリアン値、または指定した機能が認識されない場合は undefined を返す。

省略可能な（OPTIONAL) version パラメータは、時間とともに互換性のない方法で変更できるカスタム機能を問い合わせるために包含されている。返り値は、機能の特定のバージョンのみサポートすることを示している。

製作者は、この仕様に定義された機能を問い合わせるとき、version パラメータを包含するべきではない（SHOULD NOT）。これらの機能は、バージョンを持たないと見なされる。リーディングシステムがこの仕様に定義された機能をサポートしない場合、全ての提供された version パラメータと true 値の返りを無視しなければならない（MUST）。

Example 9

現在のリーディングシステムが DOM のスクリプト操作をサポートしているかどうかを表す JavaScript の関数の例。

var feature = "dom-manipulation";

var conformTest = navigator.epubReadingSystem.hasFeature(feature);

alert("Feature " + feature + " supported?: " + conformTest);

A.4.1.2 機能

次の表は、epubReadingSystem オブジェクトをサポートするリーディングシステムが（戻り値を提供するため）認識しなければならない（MUST）機能のセットを掲載している。これらの機能のサポートは、省略可能（OPTIONAL）である。

名前	概要
`dom-manipulation`	スクリプトは、ドキュメントの DOM（スパインレベルのスクリプトのみ適用される）に構造の変更をしてもよい（MAY）。
`layout-changes`	スクリプトは、コンテンツのレイアウト（スパインレベルのスクリプトのみ適用される）に影響を及ぼす属性と CSS スタイルの変更をしてもよい（MAY）。
`touch-events`	デバイスはタッチイベントをサポートしており、リーディングシステムは、コンテンツにタッチイベントを渡す。
`mouse-events`	デバイスはマウスイベントをサポートしており、リーディングシステムはコンテンツにマウスイベントを渡す。
`keyboard-events`	デバイスはキーボードイベントをサポートしており、リーディングシステムはコンテンツにキーボードイベントを渡す。
`spine-scripting`	リーディングシステムが、（例えば、コンテナ制約のスクリプトは、トップレベルコンテンツドキュメント内でサポートしているスクリプトに依存している全てのアクションが、それらを試みる前に達成のチャンスがあるかどうか決定できる）スパインレベルのスクリプトをサポートするかどうかを示す。

追加機能は、リーディングシステムの開発者により加えられてもよいが（MAY）、この仕様の将来のバージョンで、そのようなカスタムの追加と競合したり互換性のない方法でこの一覧に追加するかもしれない。

EPUB Content Documents 3.2

Final Community Group Specification 2019年5月8日

要約

このドキュメントのステータス

1. まえがき

1.1 他の仕様との関連性

1.1.1 HTML との関連性

1.1.2 SVG との関連性

1.1.3 CSS との関連性

1.2 用語

1.3 適合性

1.4 名前空間プリフィックスのマッピング

2. XHTMLコンテンツ ドキュメント

2.1 まえがき

2.2 コンテンツの適合性

2.3 リーディング システムの適合性

2.4 HTML の拡張

2.4.1 意味の変化

2.4.1.1 まえがき

2.4.1.2 epub:type 属性

例

2.4.1.3 語彙の関連性

2.4.1.3.1 標準の語彙

2.4.1.3.2 予約済みのプリフィックス

2.4.1.3.3 prefix 属性

2.4.1.4 処理の要件

2.4.2 意味の強化

2.4.2.1 まえがき

2.4.2.2 RDFa

2.4.2.3 Microdata

2.4.3 SSML 属性

2.4.3.1 まえがき

2.4.3.2 ssml:ph 属性

2.4.3.3 ssml:alphabet 属性

2.4.4 コンテンツの切り替え（非推奨）

2.4.5 epub:trigger 要素（非推奨）

2.4.6 カスタム属性

2.5 HTML の許容性と制約

2.5.1 埋め込み MathML

2.5.1.1 まえがき

2.5.1.2 コンテンツの適合性

2.5.1.3 リーディング システムの適合性

2.5.2 埋め込み SVG

2.5.2.1 埋め込み SVG と CSS

2.5.3 Unicode の制限

2.5.4 推奨されない構造

2.5.4.1 rp 要素

2.5.4.2 embed 要素

2.5.5 管理外リソースの制約

2.5.6 フォーム送信

3. SVG コンテンツ ドキュメント

3.1 まえがき

3.2 コンテンツの適合性

3.3 SVG の制限

3.4 リーディング システムの適合性

3.5 意味の変化

4. CSS スタイル シート

4.1 まえがき

4.2 コンテンツの適合性

4.3 リーディング システムの適合性

4.4 プリフィックス付きプロパティ

4.4.1 CSS Writing Modes

4.4.2 CSS Text Level 3

4.4.3 CSS Text Decoration Level 3

4.5 リーディング システムによる上書き

5. スクリプト

5.1 スクリプトのコンテクスト

例

5.2 コンテンツの適合性

5.3 リーディング システムの適合性

5.4 セキュリティの考慮事項

5.5 イベントモデルの考慮事項

6. 固定レイアウト

6.1 まえがき

6.2 コンテンツの適合性

6.3 リーディング システムの適合性

6.4 ビューポートのレンダリング

6.5 初期包含ブロックの大きさ

6.5.1 HTML の表現

6.5.2 SVG の表現

2. XHTMLコンテンツドキュメント

2.3 リーディングシステムの適合性

2.4.1.2 `epub:type` 属性

2.4.3.2 `ssml:ph` 属性

2.4.3.3 `ssml:alphabet` 属性

2.4.5 `epub:trigger` 要素（非推奨）

2.5.1.3 リーディングシステムの適合性

2.5.4.1 `rp` 要素

2.5.4.2 `embed` 要素

3. SVG コンテンツドキュメント

3.4 リーディングシステムの適合性

4. CSS スタイルシート

4.3 リーディングシステムの適合性

4.5 リーディングシステムによる上書き

5.3 リーディングシステムの適合性

6.3 リーディングシステムの適合性

7.4 リーディングシステムの適合性

A. JavaScript `epubReadingSystem` オブジェクト