EPUB 3.4

概要

EPUB® 3は、デジタル出版物および文書の配布・交換形式を定義します。EPUB 形式は、HTML、CSS、SVG、その他のリソースを含む、構造化され意味的に強化された Webコンテンツを、単一ファイルのコンテナーで配布するために表現、パッケージ化、エンコードする手段を提供します。

この仕様は、EPUB 出版物の作成要件を定義し、この標準の3回目の主要改訂版を表します。

このセクションは非規範的です。

EPUB 3は、デジタル書籍（電子書籍）の形式として広く採用されており、この改訂では、複雑なレイアウト、リッチメディアとインタラクティビティ、グローバルな組版機能を含む、より幅広い出版要件をよりよくサポートするために、この形式の機能を引き続き拡張します。出版者は、書籍、雑誌、教育・専門・科学出版物を含む幅広いコンテンツに、 EPUB 3形式を利用することが期待されます。

この仕様はEPUB 3の中核を表し、この標準の成果物であるEPUB出版物の適合要件を含みます。EPUB 3を構成するその他の仕様は次のとおりです。

EPUB 3 Reading Systems [epub-rs-34] — EPUBリーディングシステム、すなわちEPUB出版物を消費し、そのコンテンツをユーザーに提示するアプリケーションの処理要件を定義します。
EPUB Accessibility [epub-a11y-12] — EPUB出版物のアクセシビリティ適合性および発見可能性の要件を定義します。

これらの仕様は、EPUB 3に属するものとして認識され、標準の一部として規範的に参照される機能を含む正式な一覧を表します。拡張仕様の開発により、EPUB出版物には定期的に新しい機能が追加されます。標準の中核改訂の外で定義される機能は、この仕様では正式に認識されていないものの、 EPUB出版物での使用およびリーディングシステムでの実装に利用できます。

非規範的なEPUB 3 Overview [epub-overview-34] は、 EPUB 3の一般的な紹介を提供します。前バージョンからの技術的変更の一覧も、変更履歴で利用できます。

このセクションは非規範的です。

このセクションでは、この仕様が定義する中心的な成果物である EPUB出版物を通じて、この仕様の構成を概観します。

EPUB出版物は、最も基本的な意味では、コンテンツを論理的な順序で提示するために、それらのリソースをレンダリングする方法の指示を伴うリソースの束です。EPUB出版物で許可されるリソースの種類、およびその使用上の制限は、3. 出版リソースで定義されています。

ファイル拡張子.epubを持つZIPベースのアーカイブは、配布のためにEPUB出版物のリソースを束ねます。適合ZIPアーカイブとして、EPUB出版物は多くのソフトウェアプログラムで展開でき、その作成と利用の両方を簡素化します。

コンテナー形式は、zip化されたコンテンツがEPUB出版物を表していることを判定する手段（mimetypeファイル）を提供するだけでなく、非規範的リソースの普遍的に命名されたディレクトリ（/META-INF）も提供します。これらのリソースの中で重要なのが container.xmlファイルであり、リーディングシステムを利用可能なパッケージ文書へ誘導します。コンテナー形式の詳細については、 4. Open Container Format (OCF)を参照してください。

EPUB出版物は通常、単一のパッケージ文書によって表されます。この文書には、書棚で表示するためのタイトルや著者、ならびにレンダリングメタデータ（例えば、コンテンツがリフロー可能か固定レイアウトか）など、リーディングシステムがユーザーにコンテンツを提示するために使用するメタデータが含まれます。また、リソースのマニフェストを提供し、ユーザーがコンテンツを進める際に文書をレンダリングする既定の順序を列挙するスパインを含みます。パッケージ文書の要件については、5. パッケージ文書を参照してください。

EPUB出版物は既定で、利用可能な画面領域に収まるようにリフローすることを意図しています。画像および/またはCSS配置を使用して、ピクセル単位で正確な固定レイアウトを持つ出版物を作成することも可能です。レイアウトを制御するメタデータは、6. レイアウトで定義されています。

EPUB出版物の実際のコンテンツ、すなわちユーザーが読み始めたときに提示されるものは、 Open Web Platformに基づいており、XHTMLとSVGという2種類があります。EPUBコンテンツ文書と呼ばれるこれらの文書は、適切なレンダリングに必要な画像、音声および動画クリップ、スクリプト、スタイルシートなど、多くの追加リソースを通常参照します。

EPUBコンテンツ文書を作成するための規則と要件の詳細については、7. EPUBコンテンツ文書を参照し、アクセシビリティ要件については[epub-a11y-12]を参照してください。

EPUB出版物には、EPUBナビゲーション文書と呼ばれるもう1つの重要なファイルも含まれます。この文書は、ユーザーがコンテンツを素早く容易に移動できるようにする、目次などの重要なナビゲーション機能を提供します。ナビゲーション文書は、XHTMLコンテンツ文書の特殊な型であり、コンテンツ内での使用も可能にします（すなわち、機械処理用の目次とユーザー利用用の目次を別々に持つことを避けます）。この文書の詳細については、 8. EPUBナビゲーション文書を参照してください。

メディアオーバーレイ文書はEPUBコンテンツ文書を補完します。これらは、EPUBコンテンツ文書内のテキストを録音済み音声と同期させるための宣言的マークアップを提供します。その結果、リーディングシステムが読み上げに合わせてテキストを強調表示する、読み上げ体験を作成できます。メディアオーバーレイ文書の定義については、9.3 メディアオーバーレイを参照してください。

概念的には単純である一方、EPUB出版物はここで示したようなZIPパッケージ内のHTMLページと依存アセットの単なる集合ではありません。EPUB出版物が読書体験を向上させるために提供する主要な機能に関する追加情報は、参照されている仕様から入手でき、EPUB 3の機能に関するより一般的な紹介は、非規範的な[epub-overview-34]で提供されています。

リーディングシステムの処理要件については、[epub-rs-34]を参照してください。EPUB出版物を作成するためにその文書を読む必要はありませんが、リーディングシステムがどのようにコンテンツを提示するかを理解すると、ユーザーに最適に提示される出版物を作成する際に役立ちます。

このセクションは非規範的です。

注意

EPUB 3が基盤とする技術は絶えず進化しています。一部の技術は、通常「living」または「evergreen」標準と呼ばれ、日々変更される可能性があり、 EPUB出版物の妥当性への影響は即時です。その他は更新頻度が低く、その変更は、 EPUB 3が新しい改訂を受けるまでEPUB出版物に影響しない場合があります。

いずれの場合も、以前は妥当だった機能が廃止される可能性があります（例えば、サポート不足やセキュリティ問題によるもの）。また、新しい機能が、リーディングシステムで広くサポートされる前に利用可能になることもあります。

したがって、広くサポートされている機能のみを使用し、EPUB適合性チェッカーを最新に保つことが推奨されます。

[html]標準は継続的に進化しており、もはやバージョン付きリリースはありません。その標準は、MathML、SVG、CSS、JavaScriptなど、同じく進化を続けるさまざまな技術を参照します。

この方式の利点は、EPUB 3が常にWebとともに最新であることですが、この仕様が HTMLおよびそれが参照する技術の変更を追跡しないことも意味します。作成プロセスを最新に保つには、それらの標準を別途監視する必要があります。

[html]標準は、 HTML構文またはXML構文のいずれかを使用してタグセットを表現するための規則を持つ単一のコンテンツモデルを定義します。しかしEPUB 3は、 XHTMLコンテンツ文書と呼ばれるものにおいて、 XML構文を使用したコンテンツ文書の作成のみを許可します。

この仕様で定義されるXHTMLプロファイルは、別途指定されない限り、意味論、構造、処理動作のすべての定義を[html]から継承します。

さらに、この仕様は、XHTMLコンテンツ文書に含めることができる[html]文書モデルへの拡張セットを定義します。

この仕様は、[svg]の特定バージョンを参照せず、日付なしの参照を使用します。この参照に曖昧さがある場合は常に、最新の勧告バージョンが権威ある参照となります。

この方式の利点は、EPUB 3が常にSVG標準とともに最新であることですが、この仕様がSVGへの変更を追跡しないことも意味します。作成プロセスを最新に保つには、 SVG標準を別途監視する必要があります。

EPUB 3は、CSS Working Group Snapshot [csssnapshot]によって定義されるCSSをサポートします。EPUB 3はまた、グローバルな言語の一貫したサポートを確保するために、いくつかの接頭辞付きCSSプロパティも維持します。

EPUB 3はPresentation Markup [mathml3]のみをサポートします。 Content Markupは、構造化されたマークアップ注釈内でのみ許可されます。

この仕様は、[smil3]のサブセットに依存しており、 9.3.2.2 メディアオーバーレイ文書の定義で定義されるメディアオーバーレイ要素および属性はそこから派生しています。

この仕様は、EPUB出版物で表現されるURLに関連する用語および処理について、 [url]標準を参照します。新しい、および改訂されたWeb形式はこの標準を採用すると予想されますが、それまでは、この仕様が一部の形式の内部要件（例えば、妥当な相対パス）と、特に国際化URLの使用に関して衝突する可能性があります。ある形式が国際化URLを許可しない場合（すなわち、 URLが[rfc3986]またはそれ以前に適合しなければならない場合）、その要件がそれらのリソース内で優先されます。

この仕様は、EPUB 3に固有の次の用語を定義します。

注記

セクション内の用語の最初の出現箇所のみが、その定義にリンクします。

コーデック

コーデックとは、最適な圧縮を目的として設計された、または最適化されたストリーミング機能を提供する、動画や音声メディア型など、固有のバイナリ形式の性質を持つコンテンツを指します。

コンテナーリソース

出版リソースのうち、 EPUBコンテナー内に配置されているものを指し、そうではないリモートリソースと対比されます。

リソースの場所に関するメディア型固有の規則については、3.6 リソースの場所を参照してください。

コンテナールートURL

URL [url]であり、 OCF抽象コンテナーを表すルートディレクトリのURLです。コンテナールートURLは実装固有ですが、その性質は4.2.5 OCF抽象コンテナー内のURLで定義されます。

コンテンツURL

URLであり、 OCF抽象コンテナー内のファイルまたはディレクトリのURLです。これは4.2.5 OCF 抽象コンテナー内のURLで定義されます。

コアメディア型リソース

出版リソースのうち、 3.2 コアメディア型に列挙されているMIMEメディア型 [rfc2046] のいずれかに適合するものであり、したがってフォールバックの提供を必要としません（外部リソースと比較してください）。

「コアメディア型リソース」という指定は、そのリソースがEPUBコンテンツ文書および外部コンテンツ文書のレンダリングで使用される場合にのみ適用されます。例えば、コアメディア型リソースは、EPUBコンテンツ文書のメディア型も持たない限り、スパインでフォールバックなしに使用できません。

EPUB 適合性チェッカー

この仕様の要件をEPUB出版物に対して検証し、その適合性を報告するアプリケーションです。

EPUBコンテナー

OCF ZIPコンテナー

EPUB 出版物のZIPベースのパッケージ化および配布形式であり、4.3 OCF ZIPコンテナーで定義されます。

EPUBコンテナーとOCF ZIPコンテナーは同義です。

EPUB コンテンツ文書

出版リソースのうち、スパインまたはマニフェストフォールバックチェーンから参照され、 XHTMLまたはSVGコンテンツ文書の定義のいずれかに適合するものです。

EPUBコンテンツ文書は、EPUB出版物のコンテンツの全部または一部（すなわち、テキスト、視覚、および/または音声コンテンツ）を含みます。

EPUB出版物は、フォールバックを提供せずにEPUBコンテンツ文書をスパインから参照できます。

EPUBマニフェスト（またはマニフェスト）

パッケージ文書のうち、出版リソースを列挙するセクションです。

詳細については、5.7.1 manifest要素を参照してください。

EPUBナビゲーション文書

XHTMLコンテンツ文書の特殊化であり、人間可読および機械可読のグローバルナビゲーション情報を含みます。EPUBナビゲーション文書は、8. EPUBナビゲーション文書で表される制約に適合します。

EPUB出版物

リソースの相互に関連する集合からなり、 EPUBコンテナーにパッケージ化された論理的な文書実体です。

EPUB出版物は通常、単一の知的または芸術的著作物を表しますが、この仕様はコンテンツの性質を制限しません。

EPUB リーディングシステム（またはリーディングシステム）

EPUB出版物を、この仕様に適合する方法でユーザーに提示するために処理するシステムです。

EPUBスパイン（またはスパイン）

パッケージ文書のうち、 EPUBコンテンツ文書および外部コンテンツ文書の順序付きリストを定義するセクションです。このリストは、 EPUB出版物の既定の読書順序を表します。

詳細については、5.8.1 spine要素を参照してください。

免除リソース

免除リソースは、出版リソースの特殊なクラスであり、フォールバックを必要とせず、リーディングシステムがそのレンダリングをサポートする必要もありません。

詳細については、3.4 免除リソースを参照してください。

ファイル名

OCF抽象コンテナー内の任意の種類のファイルの名前であり、ディレクトリであるか、ディレクトリ内のファイルであるかを問いません。

ファイルパス

ファイルまたはディレクトリのファイルパスは、ルートディレクトリに対する完全なパスであり、 4.2.4 ファイルパスの導出で指定されるアルゴリズムによって定義されます。

固定レイアウト文書

EPUBコンテンツ文書のうち、固定寸法を持ち、スパインから直接参照されるものです。固定レイアウト文書は、事前ページ分割済みまたはロールレイアウトのいずれかで表示されます。

外部コンテンツ文書

出版リソースのうち、スパイン itemref 要素、またはマニフェストフォールバックチェーンから参照されるもので、 EPUBコンテンツ文書ではないものです。

外部コンテンツ文書がスパインのitemref要素から参照される場合、少なくとも1つのEPUBコンテンツ文書を含むマニフェストフォールバックチェーンを必要とします。

注記

XHTMLおよびSVGを除き、すべてのコアメディア型リソースは、スパインから直接参照される場合、外部コンテンツ文書です。

外部リソース

出版リソースのうち、MIMEメディア型 [rfc2046] が3.2 コアメディア型に列挙されているいずれにも一致しないものです。外部リソースは、 3.3 外部リソースで定義されるフォールバック要件の対象です。

「外部リソース」という指定は、EPUBコンテンツ文書および外部コンテンツ文書のレンダリングに使用されるリソースにのみ適用されます。

注記

外部リソースと外部コンテンツ文書は相互に置き換え可能な用語ではありません。スパインで使用される場合に外部と見なされるリソースの種類は、EPUBコンテンツ文書で使用される場合に外部と見なされるリソースの種類よりも多くなります。

リンクリソース

パッケージ文書の link 要素からのみ参照されるリソースです（すなわち、 EPUB 出版物のレンダリングにも使用されるわけではありません）。

リンクリソースは出版リソースではありませんが、 EPUBコンテナーに格納できます。これらはフォールバックを必要としません。

メディアオーバーレイ文書

XHTMLコンテンツ文書を録音済み音声ナレーションと関連付け、9.3 メディアオーバーレイで定義されるように、同期再生体験を提供するXML文書です。

非コーデック

非コーデックとは、文字列に基づくファイル形式（例えば、HTML、CSSなど）のように、内部データ構造の性質により圧縮の恩恵を受けるコンテンツ型を指します。

OCF 抽象コンテナー

OCF抽象コンテナーは、OCF ZIPコンテナーの内容に対するファイルシステムモデルを定義し、 4.2 OCF抽象コンテナーで定義されます。

パッケージ文書

出版リソースのうち、 EPUB出版物のレンダリングを記述するものであり、 5. パッケージ文書で定義されます。パッケージ文書は、 EPUB出版物に関するメタ情報を保持し、リソースのマニフェストを提供し、既定の読書順序を定義します。

出版リソース

EPUB出版物の論理とレンダリングに寄与するコンテンツまたは指示を含むリソースです。このリソースがない場合、リーディングシステムは、 EPUB出版物を意図どおりにレンダリングできない可能性があります。出版リソースの例には、パッケージ文書、EPUBコンテンツ文書、CSSスタイルシート、音声、動画、画像、埋め込みフォント、スクリプトが含まれます。

パッケージ文書のマニフェストは、通常EPUB コンテナーにバンドルしなければならないすべての出版リソースの一覧を含まなければなりません（例外として、 3.6 リソースの場所に列挙されるリソースは、 EPUBコンテナーの外に配置できます）。

注記

外部ハイパーリンクで識別されるWeb上のリソース（例えば、 [html] a 要素のhref属性から参照されるもの）は、出版リソースではありません。

Data URLも出版リソースではありません。これらは、埋め込まれているリソースの一部と見なされます。

リモートリソース

出版リソースのうち、 EPUBコンテナーの外、通常は Web上に配置されるものです。

EPUBコンテナー内の出版リソースは、コンテナーリソースと呼ばれます。

リソースの場所に関するメディア型固有の規則については、3.6 リソースの場所を参照してください。

ルートディレクトリ

ルートディレクトリは、OCF抽象コンテナーファイルシステムの基点を表します。このディレクトリは本質的に仮想的です。

スクリプト処理付きコンテンツ文書

スクリプトを含むEPUBコンテンツ文書、または [html] form 要素を含むXHTMLコンテンツ文書です。

詳細については、7.4.2 スクリプト処理を参照してください。

SVG コンテンツ文書

EPUBコンテンツ文書のうち、 7.2 SVG コンテンツ文書で表される制約に適合するものです。

合成見開き

デバイス画面上で2つの隣接ページを同時にレンダリングすることです。

トップレベルコンテンツ文書

EPUBコンテンツ文書または外部コンテンツ文書のうち、スパインから、直接またはフォールバックチェーンを介して参照されるものです。

XHTML コンテンツ文書

EPUBコンテンツ文書のうち、 7.1 XHTMLコンテンツ文書で定義される [html]のプロファイルに適合するものです。

XHTMLコンテンツ文書は、XML 構文 [html]を使用して表現されます。

注記

[html]標準はもはやXML 構文を「XHTML」とは呼びませんが、EPUB 3.0が開発された時点では XHTMLという名称がまだ一般的でした。「XHTMLコンテンツ文書」という名称はEPUB 2でも使用されていたため、変更せずに維持することは新しい形式への移行を容易にすることを意図していました。EPUB 2とは異なり、この文書のXHTMLは、 2018年に正式に置き換えられた[xhtml11]を指しません。

一意識別子

EPUB出版物の主要な識別子です。一意識別子は、 unique-identifier属性によって指定されるパッケージ文書内の dc:identifier 要素の値です。

内容の大幅な改訂、要約などには、新しい一意識別子が必要です。

ビューポート

EPUBリーディングシステムの領域であり、その中でEPUB出版物がユーザーに視覚的にレンダリングされます。

非規範的としてマークされたセクションに加え、この仕様内のすべての作成ガイドライン、図、例、および注記は非規範的です。この仕様内のそれ以外のすべては規範的です。

この文書におけるキーワードMAY、MUST、MUST NOT、OPTIONAL、RECOMMENDED、REQUIRED、SHOULD、およびSHOULD NOTは、ここに示すようにすべて大文字で出現する場合に限り、 BCP 14 [RFC2119] [RFC8174] に記述されているとおりに解釈されます。

すべての注意ボックス、括弧内の説明文、およびアルゴリズム説明も 非規範的です。

このセクションは非規範的です。

パッケージ文書メタデータの例では、予約済み接頭辞が宣言なしで使用されます。

Dublin Core要素 [dcterms] への参照は、dc:接頭辞を使用します。この接頭辞は、その使用が妥当であるためにパッケージ文書内で宣言されなければなりません（xmlns:dc="http://purl.org/dc/elements/1.1/"）。

epub名前空間接頭辞 [xml-names] も、明示的な宣言が常にあるとは限らない状態で、要素および属性に使用されます（xmlns:epub="http://www.idpf.org/2007/ops"）。

このセクションは非規範的です。

EPUB出版物は、多くの異なるカテゴリのリソースで構成されますが、それらすべてが相互排他的であるわけではありません。一部のリソースは出版リソースであり、一部はそうではありません。一部の出版リソースは既定でスパインで許可されますが、それ以外はすべてフォールバックを必要とします。一部のリソースはEPUB コンテンツ文書のレンダリングで使用できますが、その他はフォールバックとともにのみ使用できます。

各カテゴリのリソースの技術的定義を読むことでこれらの違いを理解しようとすると複雑になり得ます。分類を理解しやすくするため、この序論では、異なるプレーンという概念を使用して、リソースがどのようにグループ化され参照されるかを説明します。

3つのプレーンは次のとおりです:

マニフェストプレーン — マニフェストプレーンは、EPUB出版物のすべてのリソースを保持します（すなわち、出版リソースおよびリンクリソース）。
スパインプレーン — スパインプレーンは、スパインのレンダリングに使用されるリソースのみを保持します（すなわち、EPUBコンテンツ文書および外部コンテンツ文書）。
コンテンツプレーン — コンテンツプレーンは、EPUB および外部コンテンツ文書のレンダリングに使用されるリソースのみを保持します（すなわち、コアメディア型リソース、外部リソースおよび免除リソース）。

同じリソースは複数のプレーン上に存在でき、この仕様では、どのプレーンが論じられているかに応じて異なる名前で参照されます。例えば、EPUBコンテンツ文書のレンダリングで使用されるコアメディア型リソース（コンテンツプレーン上）は、それがスパインにも列挙されている場合（スパインプレーン）、外部コンテンツ文書にもなり得ます。

以下のセクションでは、これらのプレーンについてさらに詳しく説明します。

注記

リソースが異なるプレーンにどのように収まるかを示す詳細な例については、 A.1 リソースを参照してください。

マニフェストプレーンは、 EPUB出版物のすべてのリソースを定義します。これは、パッケージ文書のマニフェストに類似していますが、その一覧に存在しないリソースも含みます。

このグループの主要なリソースは出版リソースとして指定され、これは EPUB出版物をユーザーにレンダリングするために使用されるすべてのリソースです。 manifest 要素は、これらのリソースの完全な一覧を含まなければなりません。

出版リソースは、スパインプレーンおよびコンテンツプレーンでの用途により、さらに分類されます。

マニフェストプレーンには、一連のリンクリソースも含まれます。これらのリソースは、直接的なレンダリングには付随的です。例えば、メタデータレコードや外部コンテンツへのリンク（例えば、EPUB出版物を購入する場所）を含みます。

出版リソースとは異なり、これらはパッケージ文書のマニフェストには列挙されません（すなわち、EPUB出版物のレンダリングに必須ではないため）。代わりに、パッケージ文書メタデータの link 要素で定義されます。これらの要素は、マニフェストの item 要素が出版リソースを定義するのと同様に、その性質と目的を定義します。（この意味で、これらはマニフェストの拡張のようなものです。）

リンクリソースの詳細については、5.6.6 link要素を参照してください。

マニフェストプレーン内のリソースは、その場所によって分類されることもあります。ほとんどの出版リソースはEPUBコンテナー内に配置されなければなりませんが（コンテナーリソースと呼ばれます）、EPUB 3では、音声、動画、フォント、およびスクリプトデータリソースをコンテナー外にホストすることが許可されています。これらの例外は、これらのリソースが通常かなり大きく、フォントの場合は提示に必須ではないため、EPUB出版物のダウンロードと読み込みを高速化するために設けられました。リモートでホストされる場合、これらの出版リソースはリモートリソースと呼ばれます。

リンクリソースはEPUB出版物のレンダリングに必須ではないため、それらがどこに配置されるかについての要件はなく、その結果、場所に基づく特別な呼称もありません。EPUBコンテナー内にも外にも配置できます。

注記

EPUBコンテナー外のハイパーリンク先コンテンツ（例えばWebページ）は出版リソースではなく、したがってマニフェストには列挙されません。リーディングシステムは通常、これらのリンクをEPUB出版物の一部としてではなく、別のブラウザーインスタンスで開きます。

スパインプレーンは、スパインによって確立される既定の読書順序で使用されるリソースを定義します。これには線形および非線形コンテンツの両方が含まれます。スパインは、ユーザーがEPUB出版物を進めるにつれて、リーディングシステムにこれらのリソースをどのように読み込むかを指示します。多くのリソースをEPUBコンテナーにバンドルできますが、すべてが既定でスパイン内で許可されるわけではありません。

EPUB 3は、制限なしにスパインで使用できるEPUBコンテンツ文書と呼ばれる特殊なクラスのリソースを定義します。 EPUBコンテンツ文書には、XHTMLコンテンツ文書とSVGコンテンツ文書の両方が含まれます。

コアメディア型リソースを含むその他の種類のリソースをスパインで使用することは、外部コンテンツ文書と呼ばれます。外部コンテンツ文書には、EPUBコンテンツ文書へのマニフェストフォールバックが必要です。このモデルでは、外部コンテンツ文書のマニフェスト項目は、 fallback属性を含まなければなりません。この属性は、リーディングシステムがその形式をサポートしない場合に試すことができる次のリソースを指します。一般的ではありませんが、フォールバックリソースがさらに別のフォールバックを指定し、チェーンが多くのリソース深さになることもあります。唯一の要件は、マニフェストフォールバックチェーン内に少なくとも1つのEPUBコンテンツ文書が存在しなければならないことです。

フォールバックチェーン内のすべてのリソースはスパインに直接列挙されていなくても、いずれのリソースもリーディングシステムによって使用され得るため、スパインの一部であり、ひいてはスパインプレーンの一部と見なされます。

この拡張モデルにより、外部コンテンツ文書のサポートが保証されていなくても、リーディングシステムがユーザーに読むものを常にレンダリングできることを確保しつつ、形式の実験が可能になります。

詳細については、3.5.1 マニフェストフォールバックを参照してください。

注意

マニフェストフォールバックはEPUBの技術的要件を満たしますが、リーディングシステムでの実用的なサポートはほとんどありません。その使用は、読めない出版物につながる可能性があるため、強く推奨されません。

注記

EPUBコンテンツ文書にマニフェストフォールバックを提供することは可能ですが、これは一般的でも要件でもありません。例えば、スクリプト処理付きコンテンツ文書は、スクリプトをサポートしないリーディングシステム向けに、スクリプトなしの代替へのフォールバックを持つことができます。

コンテンツプレーンは、 EPUBコンテンツ文書および外部コンテンツ文書のレンダリング時に使用されるリソースを分類します。これらの種類のリソースには、埋め込みメディア、CSSスタイルシート、スクリプト、フォントが含まれます。これらのリソースは、リーディングシステムのサポートに基づいて、コアメディア型リソース、外部リソース、および免除リソースの3つのカテゴリに分かれます。

コアメディア型リソースは、リーディングシステムがサポートしなければならないものであるため、 EPUBまたは外部コンテンツ文書内で制限なく使用できます。コアメディア型リソースの詳細については、 3.2 コアメディア型を参照してください。

注記

コアメディア型リソースであることは、すべてのリーディングシステムが常にそのリソースをレンダリングすることを意味しません。すべてのリーディングシステムがEPUB 3のすべての機能をサポートするわけではないためです。例えば、ビューポートを持たないリーディングシステムは、画像などの視覚コンテンツをレンダリングしません。

コアメディア型リソースの反対が外部リソースです。これらは、リーディングシステムがレンダリングをサポートすることが保証されていないリソースです。その結果、スパインで外部コンテンツ文書を使用するにはそのレンダリングを確保するためのフォールバックが必要であるのと同様に、コンテンツ文書内で外部リソースを使用する場合もフォールバックが必要です。これらのフォールバックは、ホスト形式の機能を使用して提供されます。例えば、多くのHTML要素には固有のフォールバック機能があります。その一例が、 picture 要素 [html]であり、複数の代替画像形式を指定できます。

外部リソースの詳細については、3.3 外部リソースを参照してください。

コアメディア型リソースと外部リソースの中間にあるのが免除リソースです。これらは、リーディングシステムがレンダリングする保証がないため、外部リソースと最も密接に関連します。しかしコアメディア型と同様に、フォールバックを必要としません。

免除リソースは、コアメディア型が定義されていない特定の場合であって、フォールバックを提供することが煩雑または不要になる場合に対処する傾向があります。これには、動画の埋め込み、アクセシビリティトラックの追加、および[html]のlink要素からのリソースへのリンクが含まれます。

これらの例外の詳細については、3.4 免除リソースを参照してください。

注記

コアメディア型リソースから生じる一般的な混乱点は、XHTMLおよびSVGが、それぞれのEPUBコンテンツ文書定義に適合するという要件とともに、コアメディア型リソースとして列挙されていることです。この共通定義により、XHTMLおよびSVG文書がスパインに列挙されているか、他のEPUBコンテンツ文書に埋め込まれているかにかかわらず、作成およびリーディングシステムサポートに対して同じ要件を持つことが確保されます。

実際には、XHTMLおよびSVGコアメディア型リソースは、適合するXHTMLおよびSVGコンテンツ文書でもあるため、変更やフォールバックなしにスパインで許可されることを意味します。しかし、これは特殊なケースです。その他すべてのコアメディア型リソースは、スパインで使用されると外部コンテンツ文書になります（すなわち、外部コンテンツ文書には、XHTMLおよびSVGを除くすべての外部リソースおよびすべてのコアメディア型リソースが含まれます）。

次の表で定義されるMIMEメディア型 [rfc2046] 仕様に適合する出版リソースは、 EPUBコンテンツ文書および外部コンテンツ文書で使用される場合、 EPUB 出版物にフォールバックなしで含められMAYます。これらのリソースはコアメディア型リソースとして分類されます。

XHTMLコンテンツ文書およびSVGコンテンツ文書のみが、マニフェストフォールバックなしでスパインから参照できます。その他すべてのコアメディア型リソースは、スパインから直接参照される場合、マニフェストフォールバックを含まMUSTなければなりません。この場合、それらは外部コンテンツ文書です。

表の列は次の情報を表します:

メディア型—マニフェスト内で指定された出版リソースを表すために使用されるMIMEメディア型 [rfc2046]。

リソースに複数のメディア型がある場合、最初に列挙されたものが推奨メディア型です。リソースを宣言する際は、このメディア型を使用することが推奨されます。
コンテンツ型定義—指定されたコアメディア型リソースが適合しなければならない仕様。
適用対象—メディア型およびコンテンツ型定義が適用される出版リソースの種類。
EPUB 3での採用時期—そのメディア型を採用したEPUB 3のバージョン。なお、一部の形式にはより長い歴史（EPUB 2まで遡るもの）がありますが、この表では詳述しません。

メディア型	コンテンツ型定義	適用対象	EPUB 3での採用時期
HTML
`application/xhtml+xml`	XHTMLコンテンツ文書	XML構文を使用するHTML文書 [html]	3.0
画像
`image/gif`	[gif]	GIF画像	3.0
`image/jpeg`	[jpeg]	JPEG画像	3.0
`image/png`	[png]	PNG画像	3.0
`image/svg+xml`	SVGコンテンツ文書	SVG文書	3.0
`image/webp`	[rfc9649]	WebP画像	3.3
`image/avif`	[av1-avif]	AVIF画像	3.4
`image/jxl`	[iso18181-1]	JPEG XL画像	3.4
音声
`audio/mpeg`	[mp3]	MP3音声	3.0
`audio/mp4; codecs=aac` `audio/mp4`	[mpeg4-audio], [mp4]	MP4コンテナーを使用するAAC LC音声	3.0
`audio/mp4; codecs=opus`	[mpeg4-audio], [mp4], [rfc8251]	MP4コンテナーを使用するOPUS音声	3.4
`audio/ogg; codecs=opus`	[rfc7845]	OGGコンテナーを使用するOPUS音声	3.3
スタイル
`text/css`	CSSスタイルシート	CSSスタイルシート	3.0
フォント
`font/ttf` `application/font-sfnt` `application/x-font-ttf`	[truetype]	TrueTypeフォント	3.0
`font/otf` `application/font-sfnt` `application/vnd.ms-opentype`	[opentype]	OpenTypeフォント	3.0
`font/woff` `application/font-woff`	[woff]	WOFFフォント	3.0
`font/woff2`	[woff2]	WOFF2フォント	3.2
その他
`application/javascript` `application/ecmascript` `text/javascript`	[rfc4329]	スクリプト。	3.0
`application/x-dtbncx+xml`	[opf-201]	古いNCX	3.0
`application/smil+xml`	メディアオーバーレイ	EPUBメディアオーバーレイ文書	3.0

注記

コアメディア型リソースとして含まれることは、すべてのリーディングシステムがそのリソースのレンダリングをサポートすることを意味しません。リーディングシステムのサポートは、アプリケーションの機能にも依存します（例えば、ビューポートを持つリーディングシステムは画像コアメディア型リソースをサポートしなければなりませんが、ビューポートを持たないリーディングシステムはそうではありません）。どのリーディングシステムのレンダリング機能がどのコアメディア型リソースのサポートを必要とするかの詳細については、 Core media types [epub-rs-34]を参照してください。

注意

作業グループは通常、Webブラウザーコア、すなわちEPUB 3リーディングシステムが基盤とするレンダリングエンジンで広くサポートされている段階になった形式のみをコアメディア型リソースとして含めます。その段階では、最新のリーディングシステムでのレンダリングに依拠できるためです。それにもかかわらず、著者は、より新しい形式（EPUB 3.0以降に導入されたもの。表の最後の列を参照）が、例えば独自のレンダリングエンジンに依存する、または最近更新されていないリーディングシステムではサポートされない可能性があることを認識しなければなりません。

外部リソースは、コアメディア型リソースとは異なり、 EPUBコンテンツ文書または外部コンテンツ文書で使用される場合に、リーディングシステムのサポートが保証されないものです。

外部リソースにはフォールバックを提供しMUSTなければなりません。フォールバックは通常、ホスト形式の固有のフォールバック機構を使用して提供されます（例えば、[html]要素は多くの場合、複数のメディア型を参照したり、あるメディア型をレンダリングできないときに代替の埋め込みメッセージを表示したりする機能を提供します）。

注記

[html]および[svg]仕様を参照して、それらの要素が提供する固有のフォールバック機能を確認してください。

3.5.2 固有のフォールバックも、特定の要素についてフォールバックがどのように解釈されるかに関する追加情報を提供します。

注記

古いコンテンツフォールバック機能は外部リソースにフォールバックを提供するために使用できますが、その使用は強く推奨されません。

免除リソースは、外部リソースおよびコアメディア型リソースの両方と性質を共有します。これは、外部リソースに最も類似しており、リーディングシステムのサポートが保証されませんが、コアメディア型リソースと同様にフォールバックを必要としません。

場合によっては、このセクションで定義される免除は、既存のコアメディア型リソースがEPUBコンテンツ文書に含まれる方法と重なります（例えば、 [html]のlink要素を使用してCSSスタイルシートを含めること、 CSSにフォントをインポートすること、または[html]の script 要素をJavaScriptに使用すること）。これは表面的には、フォールバックを必要としないという点でリソースを類似させますが、コアメディア型は、リーディングシステムにおけるより強いサポート期待を持つ点で区別されます。コアメディア型リソースは、同じ包含機構を共有するだけで免除リソースになるわけではありません。また、免除がなければ、免除リソースは外部リソースになります。

免除リソースには小さな一連の特殊なケースのみがあります。例えば動画は、現時点でコアメディア型の動画形式について合意がないため（すなわち、フォールバック先となる形式がないため）、フォールバックを免除されます。同様に、音声および動画トラックは、リーディングシステムが最もよくサポートする任意の形式を使用できるよう、アクセシビリティ目的で免除されます。

次の一覧は、コンテンツ固有の免除リソースの事例を詳述し、それらを使用できる場所の制限も含みます。

フォント

フォントリソースは免除リソースです。

この免除により、リーディングシステムのサポート期待にかかわらず、任意のフォント形式をフォールバックなしで使用できます。CSS規則により、サポートがない場合にはフォールバックフォントが確保されるためです。

詳細については、フォントに関するリーディングシステムサポート要件 [epub-rs-34]を参照してください。

リンクリソース

[html]のlink要素から参照される任意のリソースは免除リソースです。

スクリプト

[html]が script 要素に参照を許可する任意のリソースは免除リソースです。

トラック

[html] track 要素から参照される音声および動画トラック（例えば、[webvtt]キャプション、字幕、説明）は免除リソースです。

動画

[html]の video から参照される動画コーデック — 子の source 要素を含む — は免除リソースです。

注記

リーディングシステムはH.264 [h264] およびVP8 [rfc6386]動画コーデックの少なくとも一方をサポートすることが推奨されますが、動画コーデックのサポートは適合要件ではありません。含める動画形式を決定する際は、リーディングシステムでのサポート範囲、再生品質、技術使用料などの要因を考慮してください。

注記

上記の免除はスパインには適用されません。免除リソースがスパインで使用され、かつEPUBコンテンツ文書でもない場合、そのコンテキストではフォールバックが必要になります。

コンテンツ固有の免除に加え、次の場合、リソースは免除リソースとして分類されます:

スパインの itemref 要素から参照されていないこと（すなわち、外部コンテンツ文書として使用されていないこと）、かつ
EPUBコンテンツ文書内で、そのネイティブ形式のまま直接レンダリングされないこと。

この免除により、EPUBリーディングシステムによる使用を目的としないリソースを EPUBコンテナーに含めることが可能になります。例えば:

WebAssembly [wasm-core-2]などのスクリプトコードモジュール;
取得された[fetch]データや画像などのスクリプト入力（このようなリソースを EPUBコンテンツ文書に動的に追加する際の制限については、7.4.2.5 スクリプト処理のフォールバックを参照してください）;
外部アプリケーションで使用するデータファイル（例えば、科学雑誌がデータセットを含め、 EPUBコンテナーからそれを抽出する方法の指示を提供する場合）。

CSSスタイルシート内のurl 関数 [css-values]から参照される外部画像リソースは、非コアメディア型形式が表示されることになるため、この規則によって免除されないリソースの例です。

この免除により、リーディングシステムやEPUB適合性チェッカーがそれらのリソースのフォールバック機能を理解する必要なく、外部コンテンツ文書内で外部リソースを使用することも可能になります（すなわち、外部コンテンツ文書に対するフォールバック要件が、その内部のあらゆるレンダリング問題をカバーします）。リソースはEPUBコンテンツ文書から参照されないため、自動的にフォールバックを免除されます。

マニフェストフォールバックは、パッケージ文書の機能であり、代替リソースのマニフェストフォールバックチェーンを作成します。これにより、リーディングシステムはトップレベルコンテンツ文書の代わりにそれらを使用でき、既定リソースがスパインでサポートされない場合、レンダリング可能な形式を選択できます。

フォールバックチェーンは、マニフェストの item 要素上のfallback 属性を使用して作成されます。この属性は、現在のitemのフォールバックである別のマニフェストitemの ID [xml]を参照します。指定されたitemのfallback属性から始めて、リーディングシステムが到達できるすべての参照の順序付きリストは、そのitemの完全な、かつ優先されるフォールバックチェーンを表します。

外部コンテンツ文書は、少なくとも1つの EPUBコンテンツ文書を含むフォールバックチェーンを指定しMUSTなければならず、そのチェーンはスパイン項目をリーディングシステムが常にレンダリングできるようにするため、少なくとも1つのEPUBコンテンツ文書を含まMUSTなければなりません。

EPUBコンテンツ文書はフォールバックを指定しMAYます。例えば、スクリプト処理付きコンテンツのフォールバックを提供する場合です。

フォールバックチェーンに複数のEPUBコンテンツ文書が含まれる場合、 properties属性を使用してそれぞれの目的を区別できます。

マニフェストフォールバックチェーンは、チェーン内の item要素への自己参照または循環参照を含めてはMUST NOTなりません。

以下のセクションでは、[html]の特定要素の固有のフォールバック要件について明確化します。

[html] フローコンテンツがaudioまたはvideo要素内に埋め込まれていても、外部リソースの固有のフォールバックとはみなされません。子の source 要素 [html]のみが固有のフォールバック機能を提供します。

audioまたは video要素を認識しない古いリーディングシステム（例えば、EPUB 2リーディングシステム）のみが、埋め込まれたコンテンツをレンダリングします。リーディングシステムがこれらの要素をサポートしているが利用可能なメディア形式をサポートしていない場合、ユーザー向けに埋め込まれたコンテンツをレンダリングしません。

注記

フォールバックの要件は、audioおよびvideo要素から参照される音声の外部リソースにのみ適用されます。動画リソースにはフォールバックは不要です。それらは免除リソースです。

代替形式のフォールバックを提供するため、 [html] img 要素は、 picture 要素の子として使用できます。ただし、次が真である場合に限ります:

img要素は、srcおよびsrcset属性が設定されている場合、それらの属性からコアメディア型リソースのみを参照しMUSTなければなりません。かつ
各 source 要素は、その src および srcset 属性からコアメディア型リソースのみを参照しMUSTなければなりません。ただし、その type 属性で外部リソースのMIMEメディア型 [rfc2046] を指定する場合を除きます。

imgがpictureの子ではない場合、そのsrcおよび srcset属性は、外部リソースのフォールバックを提供するために使用してはMUST NOTなりません。

データブロックは、それを含む XHTMLコンテンツ文書とは別のMIMEメディア型 [rfc2046] を持ちますが、[html] script 要素にはそのような機構が指定されていないため、固有のフォールバックを提供することはできません。

しかし、script要素はユーザーコンテンツを表しません。データブロックはスクリプトによって操作されない限りレンダリングされず、スクリプトによってレンダリングされるコンテンツにはすでにコアメディア型要件があるため、生データにフォールバックを要求しても有用な目的を果たしません。

したがって、データブロックは、スクリプトによる使用を可能にするため、フォールバック要件を免除されます。

注記

この免除は、データブロックをデータファイルの免除と整合させます。

注記

[svg]は公開時点でデータブロックを定義していませんが、将来の更新でその概念が追加された場合にも、同じ除外が適用されます。

次の種類の出版リソースは、 EPUBコンテナーの外部でホストされMAYます:

音声リソース。
動画リソース。
スクリプト処理APIを介して取得されるリソース（例えば、 XmlHttpRequest [xhr]およびFetch [fetch]）。
フォントリソース。

その他すべてのリソースは、EPUBコンテナー内に格納されMUSTなければなりません。

接続状態に関係なくユーザーが提示全体にアクセスできるように、可能な場合はすべてのリソースを EPUBコンテナー内に格納することが強く推奨されます。

リソースをEPUBコンテナーの外部に配置しなければならない場合は、その出版物およびユーザーをネットワーク攻撃にさらす脅威を制限するため、安全なhttps URIスキーム [rfc9110]を介して参照することがRECOMMENDED されます。リーディングシステムは、httpなどの安全でないスキームを使用して参照されるリモートリソースを読み込まない場合があります。

出版リソースの配置に関するこれらの規則は、指定されたリソースがコアメディア型リソースであるか、外部リソースであるかにかかわらず適用されます。

注記

マニフェスト item がリモートリソースを参照していることを示す方法の詳細については、 remote-resourcesプロパティを参照してください。

例 1: コンテナーリソースの参照

この例では、[html]のaudio要素から参照される音声ファイルが、 EPUBコンテナー内に配置されています。

<html …>
   …
   <body>
      …
      <audio
          src="audio/ch01.mp4"
          controls="controls"/>
      …
   </body>
</html>

例 2: リモートリソースの参照

この例では、[html]のaudio要素から参照される音声ファイルが、Web上でホストされています。

<html …>
   …
   <body>
      …
         <audio
             src="http://www.example.com/book/audio/ch01.mp4"
             controls="controls"/>
      …
   </body>
</html>

data: URLスキーム [rfc2397]は、リソースを URL文字列に直接エンコードするために使用されます。このスキームの利点は、外部ファイルを必要とせずに、リソースを別のものの中に埋め込めることです。

Data URLは、次のシナリオでは使用してはMUST NOTなりません。なぜなら、それらはトップレベルコンテンツ文書またはトップレベル閲覧コンテキスト [html]をもたらすためです:

パッケージ文書内のhref属性での使用 — これはマニフェスト item 要素とメタデータ link 要素の両方に適用されます。
[html]または[svg]のa 要素上のhref属性での使用。ただし、 iframe 要素 [html]内にある場合を除きます。
[html]のarea要素上の href属性での使用。ただし、 iframe要素内にある場合を除きます。
[ecmascript]の window.openまたはdocument.openの呼び出しでの使用。

注記

Data URLの使用に関するこれらの制限は、セキュリティ問題を防ぎ、リーディングシステムがユーザーを次にどこへ連れて行くかを判断できるようにするためのものです（すなわち、Data URLはスパインから参照できないため）。

Data URLの禁止される使用の一覧は、それらの使用を許可する各標準の進化に伴い変更される可能性があります。

埋め込みの結果として、Data URL内のデータは、マニフェスト報告の目的ではそれ自体の一意な出版リソースとは見なされません（すなわち、それを含む出版リソースのみが列挙されます）。ただし、このデータには独自のメディア型があるため、外部リソース制限の対象にはなります。したがって、Data URLはコアメディア型リソースとしてエンコードされるか、ホスト形式の固有のフォールバック機構を使用したフォールバックを持たMUSTなければなりません。

file: URLスキームは、[rfc8089]で「ホスト上の構造化されたオブジェクト命名およびアクセス環境（「ファイルシステム」）に格納されたオブジェクト（「ファイル」）を識別するもの」として定義されています。これは通常、ローカルオペレーティングシステムからファイルを取得するために使用されます。

EPUB出版物でFile URLを使用することは、異なるホスト間で転送される可能性があるため、セキュリティリスクを表し、相互運用性もありません。したがって、File URLは EPUB出版物で使用してはMUST NOTなりません。

XMLベースのメディア型 [rfc2046]である任意の出版リソースは:

文書の適合性 [xml-names]で定義される適合XML 1.0文書でなければMUSTなりません。
そのメディア型に適した外部識別子を参照する、または外部識別子を省略する文書型宣言のみを指定しMAYます — これはB. 許可される外部識別子で定義されます — [xml]。
内部DTDサブセット内に外部エンティティ宣言を含んではMUST NOTなりません [xml]。
XInclude [xinclude]を使用してはMUST NOTなりません。
UTF-8またはUTF-16 [unicode]でエンコードされなければMUSTならず、 UTF-8が RECOMMENDEDされるエンコーディングです。

上記の制約は、指定された出版リソースがコアメディア型リソースであるか、外部リソースであるかにかかわらず適用されます。

注記

XML base属性 [xmlbase] の使用は避けることが推奨されます。 [html]および [svg]がそのサポートを削除しつつあるためです。

このセクションは非規範的です。

OCFはEPUB出版物のためのコンテナー技術です。これは次のワークフローで役割を果たすことができます:

EPUB出版物を制作する準備段階では、OCFを、作業中の出版物を異なる個人および/または異なる組織間で交換する際のコンテナー形式として使用できます。
EPUB出版物を出版社または変換業者から配布または販売チャネルへ提供する場合、OCFは転送用の推奨コンテナー形式です。
最終的なEPUB出版物をEPUB リーディングシステムまたはユーザーに配信する場合、OCFは、出版物を構成するすべてのアセットを保持するコンテナーの形式として使用されなければなりません。

このセクションでは、ファイル集合を抽象的に構造化するための規則、すなわち「抽象コンテナー」を定義します。また、この抽象コンテナーをZIP アーカイブ内で表現するための規則、すなわち「物理コンテナー」も定義します。ZIP物理コンテナーの規則は、 [odf]で使用されるZIP 技術を基礎としています。

OCFは、埋め込みフォントを古い方法で難読化するアルゴリズムも保持していますが、この機能は現在では推奨されません。

このセクションは非規範的です。

OCF抽象コンテナーのファイルシステムモデルは、単一の共通のルートディレクトリを使用します。すべてのコンテナーリソースは、ルートディレクトリを起点とするディレクトリツリー内に配置されますが、この仕様はそれらに対して特定のファイルシステム構造を義務付けません。

ファイルシステムモデルには、ルートディレクトリの直接の子であり、次の特殊ファイルを格納する、 META-INFという名前の必須ディレクトリも含まれます:

container.xml [required]: EPUB出版物を定義する 1つ以上のパッケージ文書を識別します。
signatures.xml [optional]: 各種アセットのデジタル署名を含みます。
encryption.xml [optional]: 出版リソースの暗号化に関する情報を含みます。このファイルは、古いフォント難読化機能を使用する場合に必須です。
metadata.xml [optional]: OCF ZIPコンテナーに関するメタデータを格納するために使用されます。
rights.xml [optional]: デジタル権利に関する情報を格納するために使用されます。
manifest.xml [optional]: Open Document Format [odf] で許可されるコンテナー内容のマニフェストです。

META-INFディレクトリ内の各種ファイルの適合要件については、4.2.6 META-INFディレクトリを参照してください。

OCF抽象コンテナーの仮想ファイルシステムは、コンテナーのすべての内容に対して単一の共通のルートディレクトリを持たMUSTなければなりません。

OCF抽象コンテナーは、コンテナーのルートディレクトリの直接の子である META-INFという名前の構成ファイル用ディレクトリを含まMUSTなければなりません。このディレクトリの内容に関する要件については、4.2.6 META-INFディレクトリを参照してください。

ルートディレクトリ内のファイル名mimetypeは、OCF ZIPコンテナーでの使用のために予約されています。これは4.3 OCF ZIPコンテナーで説明されています。

META-INFディレクトリ内のファイルおよびmimetypeファイルは出版リソースではないため、マニフェストに列挙してはMUST NOTなりません。

OCF抽象コンテナー内のその他すべてのファイルは、META-INFディレクトリ内にない限り、ルートディレクトリの子孫である任意の場所に格納されMAYます。EPUB出版物は、META-INFディレクトリ内のファイルへの参照を含んではMUST NOTなりません。

注記

一部のリーディングシステムは、パッケージ文書が格納されているディレクトリの外にあるリソースへのアクセスを提供しませんが、これは [epub-rs-34]で定義された制限ではありません。これらのリーディングシステムとの相互運用性の問題を避けるため、すべてのリソースをパッケージ文書を含むディレクトリまたはその下に配置することが推奨されます。

OCF抽象コンテナーの文脈では、ファイルパスおよびファイル名は、スカラー値文字列 [infra]です（すなわち、それらの値は大文字と小文字を区別します）。

さらに、次の制限は、ファイルパスおよびファイル名をほとんどのオペレーティングシステムで変更せずに使用できるようにすることを意図しています:

ファイル名は255バイトを超えてはMUST NOTなりません。
OCF抽象コンテナー内の任意のディレクトリまたはファイルのファイルパスは、65535バイトを超えてはMUST NOTなりません。
ファイル名は、一般的に使用されるオペレーティングシステムがこれらの文字を一貫してサポートしない可能性があるため、次の[unicode]文字を使用してはMUST NOTなりません:
- SOLIDUS: / (U+002F)
- QUOTATION MARK: " (U+0022)
- ASTERISK: * (U+002A)
- 最後の文字としてのFULL STOP: . (U+002E)
- COLON: : (U+003A)
- LESS-THAN SIGN: < (U+003C)
- GREATER-THAN SIGN: > (U+003E)
- QUESTION MARK: ? (U+003F)
- REVERSE SOLIDUS: \ (U+005C)
- VERTICAL LINE: | (U+007C)
- DEL (U+007F)
- C0範囲 (U+0000 … U+001F)
- C1範囲 (U+0080 … U+009F)
- 私用領域 (U+E000 … U+F8FF)
- すべてのUnicode非文字、具体的には:
  - 基本多言語面内の32個の連続する文字 (U+FDD0 … U+FDEF)
  - 基本多言語面の最後の2つの符号位置 (U+FFFEおよびU+FFFF)
  - 補助面の末尾にある最後の2つの符号位置 (U+1FFFE, U+1FFFF … U+EFFFE, U+EFFFF)
- 特殊用途文字 (U+FFF0 … U+FFFF)
- 補助私用領域-A (U+F0000 … U+FFFFF)
- 補助私用領域-B (U+100000 … U+10FFFF)
注記

Unicode Character Database [uax44]には、非推奨文字の一覧が含まれます。EPUB適合性チェッカーがそれらの使用にフラグを立てることが予想されるため、これらの文字を避けることも推奨されます。
古いリーディングシステムとの互換性のため、ファイル名はSPACE (U+0020)文字を含むべきではSHOULD NOTありません。
同一ディレクトリ内のすべてのファイル名は、Unicode 正準正規化 [uax15]、その後の完全な大文字小文字畳み込み [unicode]に従って、一意でなければMUSTなりません。（詳細については、Unicode Canonical Case Fold Normalization Step [charmod-norm]を参照してください。）

注記

EPUB出版物がリソースを動的に統合して作成される場合（すなわち、命名が事前に分からない場合）、ファイル名を255バイト制限内に収めるための自動切り詰めが破損につながる可能性があることに注意してください。これは、UTF-8のようなマルチバイト符号化におけるバイトと文字の違いによるものです。したがって、文字の途中での切り詰めを避けることが重要です。詳細については、[international-specs]の「文字列の長さを切り詰める、または制限する」に関するセクションを参照してください。

注記

コンテンツの相互運用性が重要な場合、ファイル名の命名には十分に注意してください。制限文字の一覧は、既知の問題領域の一部を避けるためのものですが、その他すべてのUnicode文字がサポートされることを保証するものではありません。 UnicodeサポートはEPUBの初期の反復よりも大幅に改善されていますが、古いツールやツールチェーンに遭遇する可能性はまだあります（例えば、 [us-ascii]のみをサポートするZIPツールなど）。

OCF抽象コンテナー内のファイルまたはディレクトリfileが与えられたとき、 ファイルパスを導出するには、次の手順を適用します（[infra]の用語を使用して表現）:

pathを空のリストとします。
currentをfileとします。
currentがルートディレクトリでない間:
1. currentのファイル名をpathの先頭に追加します;
2. currentをcurrentの親ディレクトリに設定します。
U+002F (/)文字を使用してpathを連結した結果を返します。

コンテナールートURLは、ルートディレクトリのURL [url]です。コンテナールートURLは実装固有ですが、次の性質を持たMUSTなければなりません:

コンテナールートURLをbaseとして「/」を構文解析した結果は、コンテナールートURLです。
コンテナールートURLをbaseとして「..」を構文解析した結果は、コンテナールートURLです。

OCF抽象コンテナー内のファイルまたはディレクトリのコンテンツURLは、そのファイルのファイルパスをコンテナールートURLをbaseとして構文解析した結果です。

注記

コンテナールートURLは、リーディングシステムが EPUBコンテナーのルートに割り当てるURLです。これは通常、リーディングシステムが内部的にコンテナーのファイルシステムを実装する方法に依存します。

ただし、リーディングシステムは任意のURLを自由に使用できるわけではなく、上で定義された制約を尊重するものを使用しなければなりません。これらの制約により、EPUB内で見つかる任意の相対URL文字列は、常にコンテナー内のリソース（存在する場合も存在しない場合もあります）のURLとして構文解析されます。これらの制約の主な理由は、構文解析されたURLがコンテナーファイルの外へ「漏れる」ことによって生じる潜在的な実行時セキュリティ問題を回避するためです。

例えば、https://localhost:12345/や https://www.example.org:12345/のようなURLはこれらの性質を満たします。しかし、 https://localhost:12345/path/to.epub/、 file:///path/to.epub#path=/、またはjar:file:/path/to.epub!/EPUB/のようなURLは満たしません（これら3つの例をbaseとしてURL文字列「..」を構文解析すると、それぞれhttps://localhost:12345/path/、file:///path/、および構文解析エラーが返されます）。上で定義された性質に適合するURLをルートディレクトリに割り当てることは、リーディングシステムの責任です。

注記

構文解析により、ファイルパス内の一部の文字がそのパーセントエンコードされた代替表現に置き換えられることがあります。例えば、 A/B/C/file name.xhtmlはA/B/C/file%20name.xhtmlになります。

文字列urlは、それが path-relative-scheme-less-url stringであり、任意でU+0023 (#)と url-fragment stringが続き、かつ次の手順がtrueを返す場合、valid-relative-ocf-URL-with-fragment stringです:

コンテナールートURLを https://a.example.org/A/に設定します。

説明

このアルゴリズムの目的は、urlがコンテナー外へ「漏れる」ように見える可能性があるかどうかを検出することです。そのために、標準のURL構文解析アルゴリズムを人工的なルートURLとともに使用します。「漏れ」の検出は、構文解析の結果を最初のテストパスセグメント（A）の存在と比較することで行われます。（このアルゴリズムの目的のために、人工的なコンテナールートURLはその最初のテストパスセグメントを使用することで、要求される性質に意図的に違反していることに注意してください。）
baseを、urlが使用される文脈（文書または環境）によって定義され、パッケージ文書のコンテンツURLに従って、 urlを構文解析するために使用されるbase URLとします（5.2 パッケージ文書内の URLの構文解析を参照）。

説明

パッケージ文書内のURLの場合、base変数はパッケージ文書のコンテンツURLに設定されます。 META-INFディレクトリ内の文書の場合、base変数はコンテナールートURLに設定されます（4.2.6.2 META-INF ディレクトリ内のURLの構文解析を参照）。XHTMLコンテンツ文書内のURLの場合、構文解析に使用されるbase URLは HTML標準によって定義されます。通常、それはコンテンツ文書のコンテンツURLになります（推奨されない base要素が使用されていない限り）。
testURLRecordを、baseとともに、urlに URL parserを適用した結果とします。
testURLStringAを、testURLRecordに URL Serializerを適用した結果とします。
コンテナールートURLを https://b.example.org/B/に設定します。

説明

異なる人工的なコンテナールートURL設定で同じ手順を2回繰り返す理由は、 url文字列にも/A/が含まれる場合に発生し得る衝突を避けるためです。例えば、urlが../../A/doc.xhtmlである場合を考えてください。
baseを、urlが使用される文脈（文書または環境）によって定義され、パッケージ文書のコンテンツURLに従ってurlを構文解析するために使用される base URLに設定します（5.2 パッケージ文書内の URLの構文解析を参照）。
testURLRecordを、baseとともにurlに URL parserを適用した結果に設定します。
testURLStringBを、testURLRecordに URL Serializerを適用した結果とします。
testURLStringAがhttps://a.example.org/で始まらない、または testURLStringBがhttps://b.example.org/で始まらない場合、 trueを返します。

説明

いずれかの結果がテストURLのホストを共有していない場合、それはurl、またはそのbase URL（例えばHTMLでbase要素によって明示的に設定されている場合）が絶対であり、コンテナーの外を指していることを意味します。これは許容されます。
testURLStringAがhttps://a.example.org/A/で始まり、 testURLStringBがhttps://b.example.org/B/で始まる場合、 trueを返します。

説明

最初のテストパスセグメント（それぞれAおよびB）の存在は、 URLがコンテナー外へ漏れていないことを示します。
falseを返します。

OCF抽象コンテナーでは、任意のURL文字列は absolute-url-with-fragment stringまたはvalid-relative-ocf-URL-with-fragment stringでなければMUSTなりません。

さらに、すべてのrelative-URL-with-fragment strings [url]は、構文解析後、OCF 抽象コンテナー内の既存ファイルのコンテンツURLと等しくなければMUSTなりません。

注記

URL文字列に関するこれらの制約は、次のことを意味します:

/ (U+002F)で始まる相対URL文字列（例えば、 /EPUB/content.xhtml）は許可されません;
対象ファイルに到達するために必要な数を超える二重ドットURLパスセグメントを含む相対URL文字列（例えば、EPUB/../../../../config.xml）は許可されません;
その他の絶対または相対URL文字列は許可されます。

いずれの場合でも、上で説明した許可されないURL文字列であっても、構文解析後にコンテナー外へ「漏れる」ことはないことに注意してください（このセクションの最初の注記で説明したとおり）。それでもなお、非適合またはレガシーなリーディングシステムおよびツールチェーンとの相互運用性を高めるために許可されません。

例 3: 同じディレクトリ内のファイルの参照

この例では、ファイルimage1.jpgはXHTML コンテンツ文書と同じディレクトリにあります。

<html …>
   …
   <body>
      <img
          src="image1.jpg"
          alt="…" />
   …
   </body>
</html>

例 4: 「コンテナー外」のURL

次のコンテナー構造が与えられた場合:

/
├── mimetype
├── META-INF
│   └── container.xml
└── EPUB
    └── content.xhtml

content.xhtmlに現れるURL../../../../EPUB/secret.xhtmlは、コンテナールートURLに関する制約に従い、リーディングシステムによってパスEPUB/secret.xhtmlを持つコンテンツURLとして構文解析されます。ただし、そのURLはコンテナー外のリソースの1つとして認識される可能性があり、相互運用性の問題を引き起こすため、チェッカーツールによってエラーとして報告されます。

すべてのOCF抽象コンテナーは、そのルートディレクトリ内にMETA-INFという名前のディレクトリを含まMUSTなければなりません。

このディレクトリは構成ファイル、具体的には4.2.6.3 予約済みファイルで定義されるもののために予約されています。

META-INFディレクトリに配置されたファイルで使用されるURL文字列 urlを構文解析するには、URL parserを、コンテナールートURLをbaseとして、urlに適用しなければMUSTなりません。

例 5: コンテナーファイル内のパスの解決

コンテナーファイル（META-INF/container.xml）が次の内容を持つ場合:

<?xml version="1.0"?>
<container version="1.0" xmlns="urn:oasis:names:tc:opendocument:xmlns:container">
   <rootfiles>
      <rootfile
          full-path="EPUB/Great_Expectations.opf"
          media-type="application/oebps-package+xml" />
   </rootfiles>
</container>

その場合、パスEPUB/Great_Expectations.opfは、OCF抽象コンテナーのルートディレクトリに対する相対パスであり、 META-INFディレクトリに対する相対パスではありません。

META-INFディレクトリ内のREQUIREDの container.xmlファイルは、OCF抽象コンテナー内で利用可能なパッケージ文書を識別します。

このセクションで定義されるすべての[xml] 要素は、特に指定がない限り、 urn:oasis:names:tc:opendocument:xmlns:container名前空間 [xml-names]に属します。

このファイルの内容は、他の名前空間に属するすべての要素および属性（それらの要素のすべての属性と内容を含む）を削除した後、このセクションの定義に対して有効でなければMUSTなりません。

注記

XML Schemaも、このファイルの内容を非形式的に定義します。

container要素は、 container.xmlファイル内のすべての情報をカプセル化します。

要素名:

container

使用法:

container.xmlファイルの REQUIREDなルート要素 [xml]。

属性:

version [required]: この属性は値「1.0」を持たなければMUSTなりません。

内容モデル:

この順序で:

rootfiles [ちょうど1つ]
links [0または1]

rootfiles要素は、EPUBコンテナー内で利用可能なパッケージ文書の一覧を含みます。

要素名:

rootfiles

使用法:

containerの REQUIREDな最初の子。

属性:

なし

内容モデル:

rootfile [1つ以上]

各rootfile要素は、EPUBコンテナー内にある1つのパッケージ文書の場所を識別します。

要素名:

rootfile

使用法:

rootfiles 要素の子として。反復可能。

属性:

full-path [required]

パッケージ文書の場所を識別します。

属性の値はpath-relative-scheme-less-URL string [url]でなければMUSTなりません。パスはルートディレクトリに対する相対パスです。

media-type [required]

パッケージ文書のメディア型を識別します。

属性の値は「application/oebps-package+xml」でなければMUSTなりません。

内容モデル:

空

複数のrootfile要素が指定される場合、それぞれは同じEPUBバージョンに適合するパッケージ文書を参照しなければMUSTなりません。各パッケージ文書は EPUB出版物の1つのレンダリングを表します。

注記

EPUBコンテナーは複数のパッケージ文書を参照する能力を提供しますが、この仕様は、利用可能な選択肢をどのように解釈または選択するかを定義しません。コンテンツの複数のレンダリングをバンドルする方法の詳細については、[epub-multi-rend-11]を参照してください。

links要素は、OCF ZIPコンテナーの処理に必要なリソースを識別します。

要素名:

links

使用法:

containerの OPTIONALな2番目の子。反復可能。

属性:

なし

内容モデル:

link [1つ以上]

注記

この仕様は現在、links 要素の用途を定義していません。その使用例については、[epub-multi-rend-11]を参照してください。

要素名:

link

使用法:

links 要素の子として。反復可能。

属性:

href [required]

リソースの場所を識別します。

link要素のhref 属性の値はpath-relative-scheme-less-URL string [url]でなければMUSTなりません。パスはルートディレクトリに対する相対パスです。

media-type [optional]

参照されるリソースの型および形式を識別します。

属性の値はメディア型 [rfc2046]でなければMUSTなりません。

rel [required]

リソースの関係を識別します。

属性の値は、空白区切りのトークン一覧でなければMUST なりません。

内容モデル:

空

このセクションは非規範的です。

例 6: 基本的なコンテナーファイル

<?xml version="1.0"?>
<container version="1.0" xmlns="urn:oasis:names:tc:opendocument:xmlns:container">
   <rootfiles>
      <rootfile
          full-path="EPUB/My_Crazy_Life.opf"
          media-type="application/oebps-package+xml" />
   </rootfiles>
</container>

META-INFディレクトリ内のOPTIONALな encryption.xmlファイルは、コンテナーの内容に関するすべての暗号化情報を保持します。コンテナー内のいずれかのリソースが暗号化されている場合、使用される暗号化に関する情報を提供するためにencryption.xmlファイルが存在しなければMUSTなりません。

要素名:

encryption

名前空間:

urn:oasis:names:tc:opendocument:xmlns:container

使用法:

encryption.xmlファイルの REQUIREDなルート要素 [xml]。

属性:

なし

内容モデル:

任意の順序で:

EncryptedKey [1つ以上]
EncryptedData [1つ以上]

encryption要素は、 [xmlenc-core1]で定義される EncryptedKeyおよびEncryptedData型の子要素を含みます。

EncryptedKey要素は、コンテナーで使用される各暗号化鍵を記述し、一方、EncryptedData要素は各暗号化ファイルを記述します。各EncryptedData要素は、XML Encryptionで説明されるように、 EncryptedKey要素を参照します。

注記

XML Schemaも encryption.xmlファイルの内容を非形式的に定義します。

OCFは個々のファイルを独立して暗号化し、一定のセキュリティを犠牲にして性能を向上させ、コンテナー内容を段階的に復号できるようにします。この方法での暗号化は、パッケージ全体のディレクトリ構造およびファイル命名を露出します。

OCFは、暗号化の枠組みを提供するためにXML Encryption [xmlenc-core1]を使用し、さまざまなアルゴリズムの使用を可能にします。XML Encryptionは、任意のデータを暗号化し、その結果を XMLで表現するプロセスを規定します。OCF抽象コンテナーに非XMLデータが含まれている場合でも、XML Encryptionを使用してそのデータを暗号化できます。OCF暗号化は、コンテナー内のファイル全体の暗号化のみをサポートし、ファイルの一部の暗号化はサポートしません。

次のファイルは暗号化してはMUST NOT なりません:

mimetype
META-INF/container.xml
META-INF/encryption.xml
META-INF/manifest.xml
META-INF/metadata.xml
META-INF/rights.xml
META-INF/signatures.xml
パッケージ文書

暗号化されたデータは、OCF抽象コンテナー内の暗号化されていないデータを置き換えます。例えば、 photo.jpegという名前の画像が暗号化される場合、 photo.jpegリソースの内容は暗号化された内容で置き換えられます。 ZIPディレクトリ内の暗号化ファイルは圧縮されるべきではSHOULD NOT ありません。

一部の状況では、EPUB出版物が参照する埋め込みフォントの格納を難読化し、制限なしに使用するために抽出することをより困難にする必要があることに注意してください。難読化は暗号化ではありませんが、リーディングシステムは、難読化解除するフォントを識別するために、 encryption.xmlファイルを古いフォント難読化アルゴリズムと組み合わせて使用します。

XML SignatureのDecryption Transform [xmlenc-decrypt]は、その後、署名済みリソースを暗号化するために使用されMAYます。この機能により、リーディングシステムは、署名前に暗号化されたデータと署名後に暗号化されたデータを区別できます。

例 7: 暗号化された画像

この例は、[xmlenc-core1]の Section 2.2.1 から適応したもので、リソース image.jpegは対称鍵アルゴリズム（AES）を使用して暗号化され、その対称鍵はさらに「John Smith」の鍵を用いた非対称鍵アルゴリズム（RSA）で暗号化されます。

<encryption
    xmlns ="urn:oasis:names:tc:opendocument:xmlns:container"
    xmlns:enc="http://www.w3.org/2001/04/xmlenc#"
    xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
   <enc:EncryptedKey Id="EK">
      <enc:EncryptionMethod
          Algorithm="http://www.w3.org/2001/04/xmlenc#rsa-1_5"/>
      <ds:KeyInfo>
         <ds:KeyName>
            John Smith
         </ds:KeyName>
      </ds:KeyInfo>
      <enc:CipherData>
         <enc:CipherValue>
            xyzabc
         </enc:CipherValue>
      </enc:CipherData>
   </enc:EncryptedKey>
   <enc:EncryptedData Id="ED1">
      <enc:EncryptionMethod
          Algorithm="http://www.w3.org/2001/04/xmlenc#kw-aes128"/>
      <ds:KeyInfo>
         <ds:RetrievalMethod
             URI="#EK"
             Type="http://www.w3.org/2001/04/xmlenc#EncryptedKey"/>
      </ds:KeyInfo>
      <enc:CipherData>
         <enc:CipherReference
             URI="image.jpeg"/>
      </enc:CipherData>
   </enc:EncryptedData>
</encryption>

OCF ZIPコンテナーに格納される場合、非コーデックコンテンツ型のデータストリームは、暗号化の前に圧縮されるべきですSHOULD。Deflate 圧縮を使用しなければMUSTなりません。この実践により、ZIPコンテナーに格納されるファイルエントリーのサイズが小さくなります。

コーデックコンテンツ型のデータストリームは、暗号化の前に圧縮されるべきではSHOULD NOTありません。そのような場合、追加の圧縮は生成時に不要な処理オーバーヘッドをもたらし（特に大きなリソースファイルで）、消費時の音声/動画再生性能に影響します。場合によっては、一部の暗号化方式と圧縮の組み合わせにより、メディア再生前にリソース全体の長さを判断することが技術的に不可能なため（例: HTTP Content-Lengthヘッダー）、リーディングシステムが部分コンテンツ要求（例: HTTPバイト範囲）を処理する能力さえ損なわれる可能性があります。

データストリームが暗号化前に圧縮される場合、下で定義される Compression XML要素に従い、初期リソース（すなわち、圧縮および暗号化前）のサイズを指定するために追加の EncryptionPropertiesメタデータが提供されるべきですSHOULD。データストリームが暗号化前に圧縮されない場合、初期リソース（すなわち、暗号化前）のサイズを指定するために追加のEncryptionPropertiesメタデータが提供されMAYます。

要素名:

Compression

名前空間:

http://www.idpf.org/2016/encryption#compression

使用法:

EncryptionPropertyのOPTIONALな子。

属性:

Method [required]

使用される圧縮方式を識別します。

値は「0」（圧縮なし）または「8」（Deflateアルゴリズム）のいずれかです。

OriginalLength [required]

初期リソースのサイズ（バイト数）を表します。

値は正の整数です。

内容モデル:

空

例 8: 圧縮された動画

この例では、MP4ファイルはDeflate圧縮されています。その元のサイズは 3500000バイトでした。

<encryption
    xmlns="urn:oasis:names:tc:opendocument:xmlns:container">
   <enc:EncryptedData
       xmlns:enc="http://www.w3.org/2001/04/xmlenc#">
      …
      <enc:CipherData>
         <enc:CipherReference
             URI="OEPBS/video.mp4"/>
      </enc:CipherData>
      <enc:EncryptionProperties>
         <enc:EncryptionProperty
             xmlns:ns="http://www.idpf.org/2016/encryption#compression">
            <ns:Compression
                Method="8"
                OriginalLength="3500000"/>
         </enc:EncryptionProperty>
      </enc:EncryptionProperties>
      …
   </enc:EncryptedData>
</encryption>

META-INFディレクトリ内のOPTIONALな manifest.xmlファイルは、コンテナー内のファイルのマニフェストを提供します。

OCF仕様は、マニフェストの形式を義務付けません。

パッケージ文書は EPUB出版物の処理に使用される唯一のマニフェストを指定することに注意してください。リーディングシステムはこのファイルを使用しません。

注記

この機能は[odf]との互換性のためだけに存在します。

META-INFディレクトリ内のOPTIONALな metadata.xmlファイルは、コンテナーレベルのメタデータのためだけのものです。

metadata.xmlファイルが含まれる場合、それは名前空間修飾された要素 [xml-names]のみを含むべきですSHOULD。このファイルは、名前空間http://www.idpf.org/2013/metadataにある metadataというルート要素 [xml]を含むべきですがSHOULD、この仕様は後方互換性のために他のルート要素も許可します。

このバージョンの仕様は、 metadata.xmlファイルで使用するメタデータを定義していません。この仕様の将来のバージョンは、コンテナーレベルのメタデータを定義することがありMAYます。

この仕様は、META-INFディレクトリ内のOPTIONALな rights.xmlファイルを、権利者、仲介者、およびユーザー間での EPUB出版物の信頼された交換のために予約します。

rights.xmlファイルが含まれていない場合、OCF抽象コンテナーのどの部分もコンテナーレベルでは権利管理されません。権利表現はEPUB出版物内に存在する可能性があります。

注記

デジタル署名を追加しても、悪意ある行為者がEPUB出版物を改ざんできないことは保証されません。なぜなら、リーディングシステムは署名をチェックする必要がないためです。

META-INFディレクトリ内のOPTIONALな signatures.xmlファイルは、コンテナーおよびその内容のデジタル署名を保持します。

要素名:

signatures

名前空間:

urn:oasis:names:tc:opendocument:xmlns:container

使用法:

signature.xmlファイルの REQUIREDなルート要素 [xml]。

属性:

なし

内容モデル:

Signature [1つ以上]

signature要素は、[xmldsig-core1]で定義される Signature型の子要素を含みます。署名は、EPUB出版物全体またはその部分に適用できます。また、任意の種類のデータ（すなわちXMLだけでなく）に署名するためにも使用できます。

注記

XML Schemaも signatures.xmlファイルの内容を非形式的に定義します。

signatures.xmlファイルが含まれていない場合、OCF抽象コンテナーのどの部分もコンテナーレベルで署名されませんが、デジタル署名は EPUB出版物内に存在する可能性があります。

OCF抽象コンテナーに対してデータ署名が作成される場合、その署名は signatures要素の最後の子 Signature要素として格納されるべきですSHOULD。

注記

signatures.xmlファイル内の各Signatureは、 [xmldsig-core1]の Manifest要素およびそのReference子要素を使用し、署名が適用されるデータをURL [url]で識別します。個々のコンテナーファイルは個別に、またはまとめて署名できます。各ファイルを個別に署名すると、リーディングシステムが独立して検証できるリソースのダイジェスト値が作成されます。この方法では Signature要素が大きくなる可能性があります。ファイルをまとめて署名する場合、署名されたファイルの集合を 1つのXML Signature Manifest要素に列挙し、1つ以上の Signature要素から参照します。

OCF抽象コンテナー内の任意またはすべてのファイルは全体として署名できますが、 signatures.xmlファイルは例外です。そのファイルには計算された署名情報が含まれるためです。

signatures.xmlファイルに署名する方法は、目的によって異なります:

OCF抽象コンテナーの署名を無効化せずに署名を追加または削除できるようにするには、 signatures.xmlファイルに署名すべきではSHOULD NOTありません。
署名の追加または削除がOCF抽象コンテナーの署名を無効にするようにするには、署名者は [xmldsig-core1]の Section 6.6.4で定義される Enveloped Signature transformを使用して、作成中のSignatureを除く既存の署名ファイル全体に署名できます。この変換はすべての以前の署名に署名し、その後の署名がパッケージに追加されると無効になります。

注記

既存の署名の削除のみがOCF抽象コンテナーの署名を無効にする（すなわち、新しい署名の追加を許可する）ことが望まれる場合、XPath変換を使用して既存の署名だけに署名できます。そのような変換の詳細はこの仕様の範囲外です。

[xmldsig-core1] 仕様は署名に意味論を関連付けません。エージェントは、例えば署名を記述する情報を Signature要素に追加することで、意味情報を含めることができます。 [xmldsig-core1] 仕様は、SignatureProperties要素の使用などにより、追加情報を署名に追加する方法を説明しています。

例 9: リソースへの署名

この例は、[xmldsig-core1]の Section 2にある例に基づいており、 1つの署名が2つのリソース（EPUB/book.xhtmlおよび EPUB/images/cover.jpeg）に適用されます。

<signatures
    xmlns="urn:oasis:names:tc:opendocument:xmlns:container">
   <Signature
       Id="sig"
       xmlns="http://www.w3.org/2000/09/xmldsig#">
      <SignedInfo>
         <CanonicalizationMethod
             Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
            <SignatureMethod
                Algorithm="http://www.w3.org/2000/09/xmldsig#dsa-sha1"/>
            <Reference
                URI="#Manifest1">
               <DigestMethod
                   Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
               <DigestValue>j6lwx3rvEPO0vKtMup4NbeVu8nk=</DigestValue>
            </Reference>
      </SignedInfo>
      <SignatureValue>
         …
      </SignatureValue>
      <KeyInfo>
         <KeyValue>
            <DSAKeyValue>
               <P>…</P>
               <Q>…</Q>
               <G>…</G>
               <Y>…</Y>
            </DSAKeyValue>
         </KeyValue>
      </KeyInfo>
      <Object>
         <Manifest
             Id="Manifest1">
            <Reference
                URI="EPUB/book.xhtml">
               <Transforms>
                  <Transform
                      Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
               </Transforms>
               <DigestMethod
                   Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
               <DigestValue>…</DigestValue>
            </Reference>
            <Reference URI="EPUB/images/cover.jpeg">
               <Transforms>
                  <Transform
                      Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
               </Transforms>
               <DigestMethod
                   Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
               <DigestValue>…</DigestValue>
            </Reference>
         </Manifest>
      </Object>
   </Signature>
</signatures>

このセクションは非規範的です。

OCF抽象コンテナーの物理的な単一ファイルの具現化が、OCF ZIPコンテナーです。このコンテナーにより次が可能になります:

作業中のEPUB出版物を異なる個人および/または異なる組織間で交換すること;
EPUB出版物を出版社または変換業者から配布または販売チャネルへ転送すること; および
EPUB出版物をEPUBリーディングシステムまたはユーザーへ配信すること。

OCF ZIPコンテナーは、[zip]で指定されるZIP形式を使用しますが、次の制約および明確化を伴います:

OCF ZIPコンテナーの内容は、適合するOCF抽象コンテナーでなければMUSTなりません。
OCF ZIPコンテナーは、ZIPファイルを複数の記憶媒体にまたがらせたり、複数のファイルに分割したりできるZIP application note [zip]の機能を使用してはMUST NOTなりません。
OCF ZIPコンテナーは、ZIPアーカイブ内に格納（非圧縮）および Deflate圧縮されたZIPエントリーのみを含まなければMUSTなりません。
OCF ZIPコンテナーは、[zip]のsection 4.3.14 ("Zip64 end of central directory record")において "Version 1"として定義されるZIP64拡張を使用しMAY、コンテンツがそれを必要とする場合にのみそれらの拡張を使用すべきですSHOULD。
OCF ZIPコンテナーは、ZIP形式で定義される暗号化機能を使用してはMUST NOTなりません。代わりに、暗号化は4.2.6.3.2 暗号化ファイル（encryption.xml）で説明される機能を使用して行わなければMUSTなりません。
OCF ZIPコンテナーは、UTF-8 [unicode]を使用してファイルシステム名を符号化しなければMUSTなりません。

次の制約は、OCF ZIPコンテナーアーカイブ内の特定のフィールドに適用されます:

ローカルファイルヘッダーテーブルでは、version needed to extractフィールドは、指定されたファイルに必要な最大バージョンレベルに合わせて 10、20、または 45に設定されなければMUSTなりません（例: Deflateでは20、ZIP64では45）。
ローカルファイルヘッダーテーブルでは、compression methodフィールドは0または8に設定されなければMUSTなりません。

mimetypeファイルは、OCF ZIPコンテナー内の最初のファイルでなければMUSTなりません。さらに:

mimetypeファイルの内容は、US-ASCII [us-ascii]で符号化された MIMEメディア型 [rfc2046] 文字列application/epub+zipでなければMUSTなりません。
mimetypeファイルは、先頭または末尾のパディングまたは空白を含んではMUST NOTなりません。
mimetypeファイルは、UnicodeバイトオーダーマークU+FEFFで始まってはMUST NOT なりません。
mimetypeファイルは圧縮または暗号化されてはMUST NOTなりません。
mimetypeファイルは、そのZIPヘッダーに追加フィールドを含んではMUST NOTなりません。

注記

application/epub+zipメディア型に関する詳細情報については、G.2 application/epub+zipメディア型を参照してください。

このセクションで定義されるすべての[xml]要素は、特に指定がない限り、http://www.idpf.org/2007/opf 名前空間 [xml-names]に属します。

このセクションは非規範的です。

パッケージ文書は、XML 文書であり、EPUB出版物の特定の側面に関する情報をそれぞれカプセル化する一連の要素で構成されます。これらの要素は、メタデータを集中管理し、個々のリソースを詳述し、そのレンダリングに必要な読書順序およびその他の情報を提供する役割を果たします。

次の一覧は、パッケージ文書に含まれる情報を要約したものです:

メタデータ — EPUB出版物に関する情報を含める、または参照するための仕組み。
マニフェスト — URL [url]によって識別し、 MIMEメディア型 [rfc4839]によって出版リソースの集合を記述します。
スパイン — リーディングシステムが集合内の他のすべてのリソースへ到達または利用できる、マニフェスト内のトップレベルリソースへのID参照の順序付き列。スパインは既定の読書順序を定義します。
マニフェストフォールバックチェーン — コンテンツ等価物としてトップレベルリソースの順序付き一覧を定義する仕組みです。リーディングシステムは、レンダリング可能なリソースに基づいてそれらのリソースから選択できます。

注記

EPUB出版物は複数のパッケージ文書を参照でき、コンテンツの代替表現を可能にします。詳細については、4.2.6.3.1 コンテナーファイル（container.xml）を参照してください。

注記

パッケージ文書のファイルプロパティに関する情報については、G.1 application/oebps-package+xmlメディア型を参照してください。

パッケージ文書で使用されるURL 文字列urlを構文解析するには、URL parser [url]を、パッケージ文書のコンテンツURLをbaseとして、 urlに適用しなければMUSTなりません。

このセクションは非規範的です。

パッケージ文書は、コンパクトURLを使用することで、メタデータ表現およびメタデータの拡張性を可能にします。コンパクトURLは、URL [url]を表現する方法においてCURIE [rdfa-core]と非常に似ています。どちらの表現も、任意の接頭辞と、それに続く必須の参照で構成されます。

接頭辞は、リテラルであれ暗黙であれ、通常はDublin Core [dcterms]やSchema.org [schema-org]のような語彙へ解決されるURLの短縮マッピングです。例えば、接頭辞dctermsは、毎回完全なURL http://purl.org/dc/terms/を追加する代わりに使用されます。接頭辞を使用すると、使用される語彙の一意性を保持しながら、メタデータの作成時の誤りを減らせます。

参照は、宣言される特定の用語またはプロパティです。これはコロンによって接頭辞から分離されます。いわゆる既定語彙があるため、コンパクトURLでは接頭辞が常に必要とは限りません。コンパクトURLを受け入れる各属性は、用語またはプロパティの既定語彙も定義します。接頭辞がない場合、そのコンパクトURLは既定語彙からの値を表します。

例 10: コンパクトURLの種類

この例では、property属性内のコンパクトURLは、接頭辞（dcterms）と参照（modified）の両方を持っています。

<meta property="dcterms:modified">2025-10-18T12:00:00Z</meta>

この例では、properties属性内のコンパクトURLは、その既定語彙から取得されるため、参照（cover-image）だけが存在します:

<item href="images/cover.jpg" properties="cover-image" media-type="image/jpeg" />

リーディングシステムがコンパクトURLを完全なURLへ変換すると、結果は通常、その語彙内のフラグメントへ解決され、その用語に関する人間可読および/または機械可読の情報を含みますが、これは必須ではありません。接頭辞は、XML名前空間 [xml-names]の働きと同様に、最終的には一意の識別子にすぎません。

注記

コンパクトURLの接頭辞はXML名前空間接頭辞によく似ており、どちらも参照の一意な識別子として機能しますが、類似点はそこまでです。コンパクトURLの接頭辞はxmlns:構文を使用して宣言されません。詳細については、5.3.4 prefix属性を参照してください。

コンパクトURLデータ型の強みは、その容易な拡張性にあります。新しい用語やプロパティを組み込むには、接頭辞を宣言するだけで十分です。さらに作成上の便宜として、この仕様は、一般的に使用される多くの出版語彙のために接頭辞を予約しています（すなわち、それらの宣言は不要です）。

パッケージ文書にはコンパクトURLを受け入れる属性がいくつかあり、より一般的に使用されるものとしては、 meta 要素のproperty属性、 link 要素のrel属性、およびマニフェスト item 要素のproperties属性があります。コンパクトURLは、EPUB 3ではパッケージ文書を超えても使用され、 epub:type 属性が、EPUBコンテンツ文書内で構造的意味を表現するために使用します。

以降のセクションでは、コンパクトURLの作成および使用に関する追加の詳細を提供します。

コンパクトURLデータ型は、URL [url]を表現するための簡潔な手段であり、参照とコロンで分離されたOPTIONALな接頭辞で構成されます。

（EBNF生成規則 ISO/IEC 14977）
すべての終端記号はUnicodeブロック「Basic Latin」（U+0000から U+007F）に含まれます。
XML Schemaデータ型 [xmlschema-2]は接頭辞 `xsd:`を使用します。
compact URL	`=`	[ prefix , ":" ] , reference;
prefix	`=`	? xsd:NCName ? ;
reference	`=`	? path-relative-scheme-less-URL string [url] ? ;	/* [url]で定義されるとおり */

この仕様は、[rdfa-core]で定義されるCURIEデータ型からコンパクトURLデータ型を導出しています。コンパクトURLはCURIEの部分集合を表します。

CURIEとの主な違いは2つあります:

空のreferenceは、上の定義では有効であっても、有効なコンパクトURLを表しません（すなわち、接頭辞とコロンだけで構成されるコンパクトURLは無効です）。
空文字列は、上の定義では有効であっても、有効なコンパクトURLを表しません。

例 11: コンパクトURLの展開

この例では、property属性内のコンパクトURLは、接頭辞dctermsと参照modifiedで構成されます。

<meta property="dcterms:modified">2011-01-01T12:00:00Z</meta>

処理 [epub-rs-34]後、このプロパティは次のURLへ展開されます:

http://purl.org/dc/terms/modified

これは、dcterms:接頭辞がURL「http://purl.org/dc/terms/」へマップされる予約済み接頭辞であるためです。

コンパクトURL値から接頭辞が省略される場合、指定された用語はその属性の既定語彙から取得されます。

例 12: マニフェストのコンパクトURLの展開

この例では、mathmlプロパティがマニフェストの item 要素に指定されています:

<item … properties="mathml"/>

語彙の接頭辞URLが参照と連結されると、このプロパティは次へ展開されます:

http://idpf.org/epub/vocab/package/item/#mathml

既定語彙とは、コンパクトURLが期待される場合に、その用語およびプロパティが接頭辞を持ってはMUST NOT ならない語彙です。

これらの語彙に関連付けられたURLに、prefix属性を使用して接頭辞を割り当ててはMUST NOTなりません。

注記

既定語彙の詳細については、コンパクトURLデータ型を取る各属性の定義を参照してください。

prefix属性は、コンパクトURLで使用する接頭辞マッピングを定義します。

prefix属性の値は、次の形式の1つ以上の接頭辞からURLへのマッピングの空白区切り一覧です:

（EBNF生成規則 ISO/IEC 14977）
すべての終端記号はUnicodeブロック「Basic Latin」（U+0000から U+007F）に含まれます。
XML Schemaデータ型 [xmlschema-2]は接頭辞 `xsd:`を使用します。
prefixes	`=`	mapping , { whitespace, { whitespace } , mapping } ;
mapping	`=`	prefix , ":" , space , { space } , ? xsd:anyURI ? ;
prefix	`=`	? xsd:NCName ? ;
space	`=`	#x20 ;
whitespace	`=`	(#x20 \| #x9 \| #xD \| #xA) ;

予約済み接頭辞を除き、文書内で使用されるすべての接頭辞は宣言されなければMUSTなりません。prefix属性は、それぞれの形式のルート要素 [xml]にのみ指定されなければMUSTなりません。

この属性は、パッケージ文書で使用される場合、名前空間付きではありません。

例 13: パッケージ文書内での接頭辞の宣言

この例では、Friend of a Friend（foaf）およびDBPedia （dbp）語彙の接頭辞がprefix属性で宣言されています。

<package
    …
    prefix="foaf: http://xmlns.com/foaf/spec/
            dbp: http://dbpedia.org/ontology/">
   …
</package>

EPUBコンテンツ文書およびメディアオーバーレイ文書で使用される場合、この属性は http://www.idpf.org/2007/ops名前空間内で宣言されなければMUSTなりません。

例 14: XHTMLコンテンツ文書内での接頭辞の宣言

この例では、Z39.98 Structural Semantics Vocabularyの接頭辞が宣言されています。

<html …
      xmlns:epub="http://www.idpf.org/2007/ops"
      epub:prefix="z3998: https://www.daisy.org/z3998/2012/vocab/structure/">
   …
</html>

注記

prefix属性は、[rdfa-core]の同名のprefix属性をモデルにしていますが、これらの属性を交換可能に使用することはできません。EPUBコンテンツ文書における名前空間なしの prefix属性はRDFa属性です。

RDFa式も指定するEPUBコンテンツ文書では、両方の属性が現れることが一般的です。

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

包含によって埋め込まれるSVGについては、接頭辞は [html]のルート html 要素で宣言されなければMUSTならないことに注意してください。

競合を避けるため、prefix属性は、既定語彙へマップされる接頭辞を宣言するために使用してはMUST NOTなりません。

接頭辞「_」は宣言してはMUST NOTなりません。この仕様は、RDFa [rdfa-core]処理との将来の互換性のためにこの接頭辞を予約しています。

パッケージ文書の代替シリアル化との将来の互換性のため、Dublin Core /elements/1.1/名前空間 [dcterms]に対して接頭辞を宣言してはMUST NOTなりません。パッケージ文書のメタデータで許可されるのは、[dcterms]要素のみです。

注意

予約済み接頭辞は作成上の便宜ではありますが、問題を引き起こす可能性があります。例えばベンダーは、自身のEPUB適合性チェッカーを更新するまで、新しい接頭辞を拒否することがよくあります。問題を避けるため、すべての接頭辞を宣言することが推奨されます。

予約済み接頭辞は、コンパクトURLを期待する属性で、 prefix属性内で宣言せずに使用されMAYます。

予約済み接頭辞は、prefix 属性で上書きされるべきではSHOULD NOTありません。

使用できる予約済み接頭辞は文脈によって異なります:

パッケージ文書

次の接頭辞は、パッケージ文書の属性で、宣言することなく使用されMAYます。

接頭辞	URL	用途
a11y	http://www.idpf.org/epub/vocab/package/a11y/#	EPUB Accessibility名前空間からプロパティを宣言するため。これらは通常、 EPUB Accessibility 1.2 [epub-a11y-12]で定義されます。
dcterms	http://purl.org/dc/terms/	Dublin Core /terms/名前空間 [dcterms]からプロパティを宣言するため。
marc	http://id.loc.gov/vocabulary/	主に`scheme` 属性で使用され、作成者および寄与者の役割が MARC relators code listで定義されていることを示します。Library of Congressが公開する他の語彙を参照するためにも使用できます。
media	http://www.idpf.org/epub/vocab/overlays/#	Media Overlays 語彙からプロパティを宣言するため。
onix	http://www.editeur.org/ONIX/book/codelists/current.html#	`scheme`属性で使用され、値が対応する ONIX code listを識別します。
rendition	http://www.idpf.org/vocab/rendition/#	パッケージレンダリング語彙からプロパティを宣言するため。
schema	http://schema.org/	Schema.org 語彙からプロパティを宣言するため。

このセクションは、共有属性（すなわち、2つ以上の要素で許可される属性）の定義を提供します。

注記

dir属性は現在、十分な実装経験を持っていません。これは、リーディングシステムが通常、メタデータ表示について単一の既定方向性のみをサポートするためです。

必要なリーディングシステムのサポートは不足していますが、この属性はEPUBの基盤となる内容モデル（すなわち、パッケージ文書における国際化サポート）に不可欠です。したがって、この状況が改善された際に適切なレンダリングを確保するため、パッケージ文書内のテキスト値に適切な方向性を設定することが強く推奨されます。

この属性に対する要件の緩和は、EPUBがW3Cに移行される前に開発されていた異なるプロセスを考慮するためだけに行われました。W3Cプロセスの下で開発される新機能は、同様の免除を受けません。

搬送要素およびその子孫のテキスト内容と属性値の基底方向 [bidi]を指定します。

許可される値は次のとおりです:

ltr — 左から右への基底方向;
rtl — 右から左への基底方向; および
auto — Unicode Bidi Algorithm [bidi]を使用して基底方向を決定します。

属性が存在しない、または無効な値を持つ場合、リーディングシステムは値autoを仮定します。

注記

dir属性で指定される基底方向は、方向ラン内の文字の順序には影響せず、それらのランの相対順序および句読点のような弱い方向性文字の配置にのみ影響します。

例 15: パッケージ文書テキストのグローバルな基底方向の設定

<package … dir="ltr">
   …
</package>

許可される要素: collection、Dublin Core要素、 meta、および package。

注記

Working Groupは、EPUB適合性チェッカーがEPUB出版物内で dirに遭遇した場合にはその存在を通知する一方で、その包含は標準違反ではないため、エラーまたは警告を出さないことを助言します。

リソースを参照する有効なURL文字列 [url]。

URL文字列は、パッケージ文書内の要素を介してリソースを参照してはMUST NOTなりません（例えば、マニフェスト item またはスパイン itemref 宣言を介する参照）。

例 16: メタデータレコードへのリンク

<package …>
   <metadata …>
      …
      <link
          rel="record"
          href="meta/9780000000001.xml"
          media-type="application/marc"/>
      …
   </metadata>
   …
</package>

許可される要素: item および link。

要素のID [xml]であり、文書スコープ内で一意でなければMUST なりません。

例 17: 識別子属性の追加

<dc:title id="pub-title">The Lord of the Rings</dc:title>

許可される要素: collection、Dublin Core要素、 item、 itemref、 link、 manifest、 meta、 package、および spine。

参照されるリソースの型および形式を指定するメディア型 [rfc2046]。

例 18: リンクされたレコードのメディア型の追加

<package …>
   <metadata …>
      …
      <link
          rel="record"
          href="http://example.org/meta/12389347?format=onix"
          media-type="application/xml"
          properties="onix"/>
      …
   </metadata>
   …
</package>

許可される要素: item および link。

コンパクトURLの空白区切り一覧。

この属性の既定語彙については、各要素の定義を参照してください。

例 19: マニフェスト内のEPUBナビゲーション文書の識別

<package …>
   …
   <manifest>
      …
      <item
          id="nav"
          href="nav.xhtml"
          properties="nav"
          media-type="application/xhtml+xml"/>
      …
   </manifest>
   …
</package>

許可される要素: item、 itemref、および link。

現在の表現と、その値によって識別される要素またはリソースとの関連付けを確立します。属性の値は、path-relative-scheme-less-URL stringでなければMUSTならず、任意でU+0023 (#)と、記述対象のリソースまたは要素を参照する URL-fragment stringが続きます。

例 20: 作成者が挿絵画家であることの指定

<package …>
   <metadata …>
      …
      <dc:creator id="creator02">
         E.H. Shepard
      </dc:creator>
      <meta
          refines="#creator02"
          property="role"
          scheme="marc:relators">
         ill
      </meta>
      …
   </metadata>
   …
</package>

refines属性は、表現されるメタデータの種類に応じてOPTIONALです。省略された場合、その要素は主要表現を定義します。

出版リソースに関する表現を作成する場合、 refines属性は、そのリソースのマニフェストエントリーの ID [xml]を参照するフラグメント識別子を指定するべきですSHOULD。

精緻化チェーンは、循環参照または自己参照を含んではMUST NOTなりません。

例 21: メディアオーバーレイ文書の長さの設定

<package …>
   <metadata …>
      …
      <meta
          property="media:duration"
          refines="#c01_overlay">
         0:32:29
      </meta>
      …
   </metadata>
   <manifest>
      …
      <item
          id="c01_overlay"
          href="overlays/chapter01.smil"
          media-type="application/smil+xml"/>
      …
   </manifest>
   …
</package>

許可される要素: link および meta。

[xml]の 2.12 Language Identificationで定義されるとおり、搬送要素およびその子孫のテキスト内容と属性値の言語を指定します。各xml:lang属性の値は、整形式の言語タグ [bcp47]でなければMUSTなりません。

例 22: パッケージ文書テキストのグローバル言語の設定

<package … xml:lang="ja">
   …
</package>

許可される要素: collection、Dublin Core要素、 meta、および package。

package要素は、パッケージ文書で表現されるすべての情報をカプセル化します。

要素名:

package

使用法:

パッケージ文書のREQUIREDなルート要素 [xml]。

属性:

dir [optional]
id [optional]
prefix [optional]
xml:lang [optional]
unique-identifier [required]
version [required]

内容モデル:

この順序で:

metadata [ちょうど1つ]
manifest [ちょうど1つ]
spine [ちょうど1つ]
guide [0または1] (古い)
collection [0個以上] (古い)

version属性は、指定されたEPUB出版物が適合するEPUB仕様バージョンを指定します。この属性は、EPUB 3への適合を示すために値「3.0」を持たなければMUSTなりません。

注記

この仕様の更新は、EPUB 3の新しいバージョンを表すものではありません（すなわち、各新しい3.X 仕様はEPUB 3形式の継続です）。Working Groupは、既存コンテンツを無効にする変更を最小限に抑え、version属性値を変更せずに保てるようにすることに取り組んでいます。

unique-identifier属性は、推奨される、または主要な識別子を提供する dc:identifier 要素を識別するIDREF [xml]を取ります。

prefix属性は、この仕様で予約されていない接頭辞の宣言メカニズムを提供します。詳細については、5.3.4 prefix属性を参照してください。

metadata要素はメタ情報をカプセル化します。

要素名:

metadata

使用法:

packageの REQUIREDな最初の子。

属性:

なし

内容モデル:

任意の順序で:

dc:identifier [1つ以上]
dc:title [1つ以上]
dc:language [1つ以上]
Dublin Coreの任意要素 [0個以上]
meta [1つ以上]
OPF2 meta [0個以上] (古い)
link [0個以上]

パッケージ文書のmetadata要素には、2つの主要な機能があります:

リーディングシステムがEPUB出版物を内部的にカタログ化し、ユーザーが利用できるようにする（例えば、本棚に表示する）ために使用する最小限のメタ情報を提供すること。
コンテンツのレイアウトおよび表示を制御するために必要なすべてのレンダリングメタデータ（例えば、パッケージレンダリングプロパティ）へのアクセスを提供すること。

パッケージ文書は複雑なメタデータ符号化機能を提供しません。より詳細な情報を提供する必要がある場合は、（例えば[onix]のような国際標準に適合する、または独自の目的のために作成された）メタデータレコードを、 link 要素を使用してEPUB 出版物に関連付けることができます。この方法により、リーディングシステムはメタデータをそのネイティブ形式で処理でき、最小限のパッケージ文書構造を使用するよう変換することで生じる潜在的な問題や情報損失を避けられます。

この方針に従い、パッケージ文書には次の最小限のメタデータ要件のみがあります: [dcterms]の dc:title、 dc:identifier、および dc:language 要素を、[dcterms]の dcterms:modified プロパティとともに含めなければMUSTなりません。その他すべてのメタデータは OPTIONALです。

例 23: パッケージ文書に必要な最小限のメタデータ集合

<package … unique-identifier="pub-id">
    …
    <metadata …>
       <dc:identifier
           id="pub-id">
          urn:uuid:A1B0D67E-2E81-4DF5-9E67-A64CBE366809
       </dc:identifier>
       <dc:title>
          Norwegian Wood
       </dc:title>
       <dc:language>
          en
       </dc:language>
       <meta
           property="dcterms:modified">
          2011-01-01T12:00:00Z
       </meta>
    </metadata>
    …
</package>

meta 要素は、任意の語彙からのメタデータプロパティを含めるための汎用的なメカニズムを提供します。このメカニズムは任意のメタデータ目的に使用できますが、通常はEPUB仕様で定義されたレンダリングおよびアクセシビリティメタデータを含めるために使用されます。

注記

アクセシビリティメタデータの推奨事項については、[epub-a11y-12]を参照してください。

Dublin Core要素 [dcterms]および meta 要素は、必須の子テキスト内容 [dom]を持ちます。これらの要素の説明では、この仕様はこの内容を要素の値と呼びます。

これらの要素は、先頭および末尾のASCII 空白 [infra]を取り除いた後、空でない値を持たなければMUSTなりません（すなわち、少なくとも1つの非空白文字で構成されている必要があります）。

これらの要素値内の空白は重要ではありません。1つ以上の空白文字の並びは、処理中に単一の空白に畳み込まれます [infra]。

dc:identifier要素 [dcterms]は、 UUID、DOIまたはISBNなどの識別子を含みます。

要素名:

dc:identifier

名前空間:

http://purl.org/dc/elements/1.1/

使用法:

metadataの REQUIREDな子。反復可能。

属性:

id [conditionally required]

内容モデル:

テキスト

EPUB出版物は、それ自体に一意な識別子、すなわちその一意識別子を指定する dc:identifier要素を含めなければMUSTなりません。この要素は、 package 要素のunique-identifier 属性から参照されなければMUSTなりません。

例 24: 一意識別子を持つ要素の指定

<package … unique-identifier="pub-id">
    <metadata …>
       <dc:identifier id="pub-id">
           urn:uuid:A1B0D67E-2E81-4DF5-9E67-A64CBE366809
       </dc:identifier>
       …
    </metadata>
</package>

静的ではありませんが、一意識別子を頻繁に変更することは避けてください。一意識別子は、参照および配布の目的の両方で最大限の永続性を持つことを意図しています。メタデータの更新、正誤の修正、または同様の軽微な変更のような小規模な改訂を行う場合に、新しい識別子を発行しないでください。

追加の識別子を指定してもMAYよいです。

注記

可能な限り、識別子にはabsolute-URL strings [url]を使用することが推奨されます。ドメインを含めることで識別子の一意性を高めることができ、例えば名前空間識別子 [rfc8141]を持つURNを使用すると、リーディングシステムによる処理が向上します。

identifier-typeプロパティは、 dc:identifier要素の値が、確立された体系またはそれを付与した発行機関に適合することを示すために使用してもMAYよいです。

例 25: 識別子の種類の指定

この例では、identifier-typeプロパティをONIX codelist 5スキームとともに使用して、商品識別子の種類がDOIであることを示しています（すなわち、 codelist 5の値06はDOIを表します）。

<metadata …>
   <dc:identifier
       id="pub-id">
      urn:doi:10.1016/j.iheduc.2008.03.001
   </dc:identifier>
   <meta
       refines="#pub-id"
       property="identifier-type"
       scheme="onix:codelist5">
      06
   </meta>
   …
</metadata>

dc:title要素 [dcterms]は、 EPUB出版物の名前のインスタンスを表します。

要素名:

dc:title

名前空間:

http://purl.org/dc/elements/1.1/

使用法:

metadataの REQUIREDな子。反復可能。

属性:

dir [optional]
id [optional]
xml:lang [optional]

内容モデル:

テキスト

文書順で最初のdc:title要素が、EPUB出版物の主題名（すなわち、リーディングシステムがユーザーに提示する主要なもの）です。

例 26: 基本的なタイトル要素

<metadata …>
   <dc:title>
      Norwegian Wood
   </dc:title>
   …
</metadata>

リーディングシステムでタイトルの一貫したレンダリングを確保するため、dc:title要素は1つだけ使用することが推奨されます。

注記

複数部分のタイトルのために複数のdc:title要素を含めることは可能ですが、追加のdc:title要素に対するリーディングシステムのサポートは一貫していません。リーディングシステムは追加の部分を無視したり、予期しない方法で結合したりする可能性があります。

例えば、次の例は基本的な複数部分タイトルを示しています:

<metadata …>
   <dc:title>
      THE LORD OF THE RINGS
   </dc:title>
   <dc:title>
      Part One: The Fellowship of the Ring
   </dc:title>
   …
</metadata>

同じタイトルは、代わりに次のように単一のdc:title 要素を使用して表現できます:

<metadata …>
   <dc:title>
       THE LORD OF THE RINGS, Part One:
       The Fellowship of the Ring
   </dc:title>
   …
</metadata>

この仕様の以前のバージョンでは、複数部分タイトルの各部分を識別して整形するために、title-typeおよびdisplay-seqプロパティを使用することを推奨していました（Great Cookbooksの例を参照）。これらの意味を追加することはなお可能ですが、それらも十分にはサポートされていません。

dc:language要素 [dcterms]は、 EPUB出版物の内容の言語を指定します。

要素名:: dc:language
名前空間:: http://purl.org/dc/elements/1.1/
使用法:: metadataの REQUIREDな子。反復可能。
属性:: id [optional]
内容モデル:: テキスト

各dc:language要素の値は、整形式の言語タグ [bcp47]でなければMUSTなりません。

例 27: EPUB出版物の言語として米国英語を指定する

<metadata …>
   …
   <dc:language>
      en-US
   </dc:language>
   …
</metadata>

多言語のEPUB出版物について、追加のdc:language 要素を指定してもMAYよいですが、リーディングシステムは、文書順で最初の dc:language 要素を主要言語として扱います。

注記

出版リソースは、その言語をdc:language 要素から継承しません。各リソースの言語は、その形式に固有の方法を使用して設定する必要があります。

dc:identifier、 dc:language、および dc:title を除くすべての[dcterms]要素は、 OPTIONALとして指定されます。これらの要素は、次の一般化された定義に適合します:

要素名:

名前空間:

http://purl.org/dc/elements/1.1/

使用法:

metadataの OPTIONALな子。反復可能。

属性:

dir [optional]
id [optional]
xml:lang [optional]

内容モデル:

テキスト

この仕様は、以下のセクションで注記されている場合を除き、[dcterms]要素の定義を変更しません。

dc:contributor要素 [dcterms]は、コンテンツの作成において二次的な役割を果たした人物、組織などの名前を表すために使用されます。

dc:contributor要素の要件は、その他すべての点で dc:creator 要素の要件と同一です。

dc:creator 要素 [dcterms]は、コンテンツの作成に責任を持つ人物、組織などの名前を表します。roleプロパティをその要素に関連付けることで、作成者が果たした機能を示してもMAYよいです。

例 28: 作成者が著者であることの指定

この例では、MARC relatorsスキームを使用して役割を示しています（すなわち、値 autはMARCにおける著者を示します）。

<metadata …>
   …
   <dc:creator
       id="creator">
      Haruki Murakami
   </dc:creator>
   <meta
       refines="#creator"
       property="role"
       scheme="marc:relators"
       id="role">
      aut
   </meta>
   …
</metadata>

dc:creator要素には、リーディングシステムがユーザーに表示することを期待される形式で、作成者の名前を含めることが推奨されます。

file-asプロパティは、作成者名の正規化形式を関連付けるために使用してもMAYよく、 alternate-scriptプロパティは、別の言語または文字体系で作成者名を表すために使用できます。

例 29: 作成者に関する並べ替えおよびレンダリング情報の表現

<metadata …>
   …
   <dc:creator
       id="creator">
      Haruki Murakami
   </dc:creator>
   <meta
       refines="#creator"
       property="alternate-script"
       xml:lang="ja">
      村上 春樹
   </meta>
   <meta
       refines="#creator"
       property="file-as">
      Murakami, Haruki
   </meta>
   …
</metadata>

EPUB出版物に複数の作成者がいる場合は、それぞれを別個の dc:creator要素で指定してください。

metadataセクション内のdc:creator要素の文書順は表示優先度を決定し、最初に現れるdc:creator要素が主要な作成者です。

例 30: 主要な作成者の表現

この例では、Lewis Carrollが最初に列挙されているため、主要な作成者です。

<metadata …>
   …
   <dc:creator
       id="creator01">
      Lewis Carroll
   </dc:creator>
   <dc:creator
       id="creator02">
      John Tenniel
   </dc:creator>
   …
</metadata>

二次的な寄与者は、 dc:contributor 要素を使用して表されます。

dc:date要素 [dcterms]は、 EPUB出版物の出版日を定義します。出版日は最終更新日（EPUB出版物が最後に変更された時点）とは同じではありません。

日付文字列は[iso8601-1]に、特にW3C Date and Time Formats [datetime]で表現される部分集合に適合することが RECOMMENDEDされます。そのような文字列は、人間にも機械にも可読であるためです。

例 31: 出版日の表現

<metadata …>
   …
   <dc:date>
      2000-01-01T00:00:00Z
   </dc:date>
   …
</metadata>

追加の日付は、[dcterms]語彙、または同様の語彙で利用可能な特殊な日付プロパティを使用して表現できます。

EPUB出版物は、複数の dc:date要素を含んではMUST NOTなりません。

dc:subject 要素 [dcterms]は、 EPUB出版物の主題を識別します。要素の値は、人間可読な見出しまたはラベルに設定することが推奨されますが、主題分類体系が別個の記述ラベルを提供しない場合は、コード値を使用できます。

要素の値が由来する体系またはスキームは、 authorityプロパティを使用して識別できます。

スキームが識別される場合、主題コードはterm プロパティを使用して要素に関連付けられなければMUSTなりません。

例 32: BISACコードおよび見出しの指定

<metadata …>
   <dc:subject id="subject01">
      FICTION / Occult &amp; Supernatural
   </dc:subject>
   <meta
       refines="#subject01"
       property="authority">
      BISAC
   </meta>
   <meta
       refines="#subject01"
       property="term">
      FIC024000
   </meta>
</metadata>

例 33: スキームのURLの指定

<metadata …>
   <dc:subject id="sbj01">
      Number Theory
   </dc:subject>
   <meta
       refines="#sbj01"
       property="authority">
      http://www.ams.org/msc/msc2010.html
   </meta>
   <meta
      refines="#sbj01"
      property="term">
     11
  </meta>
</metadata>

termプロパティは、スキームを指定していない dc:subject要素に関連付けてはMUST NOTなりません。

dc:subject要素および termプロパティの値は、指定されたスキームが要求する場合にのみ大文字と小文字を区別します。

dc:type要素 [dcterms]は、EPUB出版物が特殊な種類（例えば、EPUB形式でパッケージ化された注釈または辞書）であることを示すために使用されます。

要素の値は任意のテキスト文字列であってもMAYよいです。

注記

旧IDPF EPUB 3 Working Groupは、この要素で使用するための特殊なEPUB出版物タイプの非規範的レジストリを維持していました。このWorking Groupはもはやそのレジストリを維持しておらず、新しい特殊な出版物タイプを開発する予定もありません。

meta要素は、パッケージメタデータを含めるための汎用的な手段を提供します。

要素名:

meta

使用法:

metadata 要素の子として。反復可能。

属性:

dir [optional]
id [optional]
property [required]
refines [optional]
scheme [optional]
xml:lang [optional]

内容モデル:

テキスト

各meta要素はメタデータ表現を定義します。 property属性は、その表現で行われる文を定義するコンパクトURLを取り、要素のテキスト内容はその表明を表します。（詳細については、5.3 語彙関連付けメカニズムを参照してください。）

この仕様は、meta要素を使用して定義できる 2種類のメタデータ表現を定義します:

主要表現とは、meta要素で定義される表現が EPUB出版物の何らかの側面を確立するものです。 refines属性を省略した meta要素は、主要表現を定義します。
部分表現とは、 meta要素で定義される表現が、 refines属性を使用して別の表現またはリソースと関連付けられ、その意味を強化するものです。例えば、部分表現はメディアクリップをその継続時間を表すことで精緻化したり、作成者または寄与者の表現をその人物の役割を定義することで精緻化したりできます。

部分表現は、他の部分表現の意味を精緻化するために使用してもMAYよく、それによって情報のチェーンを作成できます。

注記

すべての[dcterms]要素は主要表現を表し、 meta要素の部分表現による精緻化を許可します。

Meta Properties Vocabularyは、 property属性とともに使用するための既定語彙です。

他の語彙からの用語は、5.3 語彙関連付けメカニズムで定義されるように追加してもMAYよいです。

例 34: 予約済み接頭辞を持つプロパティの使用

予約済み接頭辞の完全な一覧については、5.3.5 予約済み接頭辞を参照してください。

<metadata …>
   …
   <meta
       property="dcterms:modified">
      2016-02-29T12:34:56Z
   </meta>
   <meta
       property="rendition:layout">
      pre-paginated
   </meta>
   <meta
       property="media:active-class">
      my-active-item
   </meta>
   …
</metadata>

scheme属性は、要素の値が取得された体系またはスキームを識別します。属性の値は、そのスキームを定義するリソースへ解決されるコンパクトURLでなければMUSTなりません。scheme属性には既定語彙はありません（すなわち、すべての値に接頭辞が必要です）。

例 35: スキームからの値の使用

この例では、scheme属性は、そのタグの値が [onix] code list 5からのものであることを示しています（すなわち、値15は13桁のISBNを示します）。

<metadata …>
   …
   <meta
       refines="#isbn-id"
       property="identifier-type"
       scheme="onix:codelist5">
      15
   </meta>
   …
</metadata>

metadataセクションは、最終更新日を含む dcterms:modified プロパティ [dcterms]をちょうど1つ含まなければMUSTなりません。このプロパティの値は、拡張形式に一致する日時の [iso8601-1] 完全表現でなければMUSTなりません:

YYYY-MM-DDThh:mm:ssZ

注記

パターン末尾の「Z」（Zulu）時刻指示子は、最終更新日が常に協定世界時（UTC）で表現されることを意味します。

例 36: 最終更新日の表現

<metadata …>
   …
   <meta
       property="dcterms:modified">
      2016-01-01T00:00:01Z
   </meta>
   …
</metadata>

EPUB出版物に変更が加えられるたびに、最終更新日を更新することが推奨されます。

追加のdcterms:modifiedプロパティは、パッケージ文書メタデータ内で指定してもMAYよいですが、それらは異なる主語を持たなければMUSTなりません（すなわち、要素またはリソースを参照する refines 属性が必要です）。

注記

最終更新日に関する要件は、EPUB出版物のリリース識別子 [epubpackages-32]を定義していたEPUB 3の以前のバージョンとの互換性を確保するためのものです。

link要素は、メタデータレコードなどのリソースをEPUB 出版物に関連付けます。

要素名:

link

使用法:

metadataの子として。反復可能。

属性:

href [required]
hreflang [optional]
id [optional]
media-type [conditionally required]
properties [optional]
refines [optional]
rel [required]

内容モデル:

空

metadata 要素は0個以上のlink要素を含んでもMAYよく、その各々は、 REQUIREDな href属性で、出版リソースまたはリンクされたリソースの場所を識別します。

link要素から参照されるリソースは、次の場合にのみ出版リソースです:

スパインから参照される場合; または
EPUBコンテンツ文書内に包含または埋め込まれる場合（例えば、RDFa [rdfa-core]として、または JSON-LD [json-ld11]として [html] script 要素内に埋め込まれたメタデータレコード）。

その他すべての場合（例えば、独立した[onix]レコードへリンクする場合）、参照されるリソースは出版リソースではなく（すなわち、コアメディア型要件の対象ではなく）、マニフェストに列挙してはMUST NOTなりません。

例 37: XHTML コンテンツ文書に埋め込まれたレコードへの参照

この例では、メタデータレコードはscript要素内に埋め込まれています。埋め込まれたレコードのメディア型（すなわちapplication/ld+json）は script要素上のtype属性から取得され、 link要素内では指定されていないことに注意してください。

Package document:

<package …>
   <metadata …>
      …
      <link rel="record"
          href="front.xhtml#meta-json"
          media-type="application/xhtml+xml"
          hreflang="en"/>
      …
   </metadata>
   …
</package>

XHTML:

<html …>
   <head>
      …
      <script id="meta-json" type="application/ld+json">
          "@context" : "http://schema.org",
          "name" : "…",
         …
      </script>
      …
   </head>
   <body>
      …
   </body>
</html>

リンクされたリソースはEPUBコンテナーの外に配置されてもMAYよいですが、リーディングシステムはリモートリソースを取得する必要はありません。リモートでホストする前に、これがユーザーの読書体験にどのような影響を与えるかを考慮することが推奨されます。

media-type 属性は、EPUBコンテナー内のすべてのリンクされたリソースに対して指定されなければMUSTなりません。EPUBコンテナー外にあるリンクされたリソースについては、同じURL [url]から複数のメディア型が提供され得るため、 OPTIONALです。

OPTIONALなhreflang属性は、リンクされたリソースの言語を識別します。値は整形式の言語タグ [bcp47]でなければMUST なりません。

REQUIREDなrel属性は、リンクされたリソースがEPUB 出版物に対して持つ関係を確立するコンパクトURLの空白区切り一覧を取ります。

例 38: MARC XMLレコードへのリンク

<metadata …>
   …
   <link
       rel="record"
       href="meta/9780000000001.xml"
       media-type="application/marc"/>
   …
</metadata>

media-type属性の値は、リンクされたリソースの種類を識別するのに常に十分とは限りません（例えば、多くのXMLベースのレコード形式はメディア型「application/xml」を使用します）。そのような汎用リソースの識別においてリーディングシステムを支援するため、意味的な識別子を properties 属性で指定してもMAYよいです。

例 39: プロパティによるレコード型の識別

この例では、properties属性は、そのリンクがONIX レコードへのものであることを識別しています。

<metadata …>
   …
   <link rel="record"
       href="http://example.org/meta/12389347?format=onix"
       media-type="application/xml"
       properties="onix"/>
   …
</metadata>

Metadata Link Vocabularyは、 rel属性およびproperties属性の既定語彙です。

他の語彙からの関係およびプロパティは、5.3 語彙関連付けメカニズムで定義されるように追加してもMAYよいです。

例 40: 新しいリンク関係の宣言

この例では、link要素を使用して、FOAF語彙を使用した著者のホームページを関連付けます。 foafは予約済み接頭辞ではないため、 prefix属性で宣言する必要があることに注意してください。

<package
    …
    prefix="foaf: http://xmlns.com/foaf/spec/">
   <metadata …>
      …
      <link
          refines="#creator01"
          rel="foaf:homepage"
          href="http://example.org/book-info/12389347" />
      …
   </metadata>
   …
</package>

1つ以上のリンクされたメタデータレコードを提供してもMAYよいです。

例 41: リンクされたレコードの指定

この例では、ONIXレコードはリモートでホストされ、JSON-LDレコードは EPUBコンテナー内に含まれています。

<metadata …>
   <link rel="record"
       href="http://example.org/onix/12389347"
       media-type="application/xml"
       properties="onix" />

   <link rel="record"
       href="meta/meta.jsonld"
       media-type="application/ld+json" />
    …
</metadata>

注記

EPUB出版物にリンクできるメタデータレコードの形式およびシリアル化は多様であり、それらの間でメタデータプロパティを比較することは複雑であるため、この仕様はリーディングシステムにリンクされたレコードの処理を要求しません。

完全なレコードに加えて、link要素は、代替形式で利用可能な個々のメタデータプロパティを識別するために使用してもMAYよいです。

例 42: 説明へのリンク

この例では、EPUB出版物の説明はHTML 文書に含まれています。

<metadata …>
   …
   <link
       rel="dcterms:description"
       href="description.html"
       media-type="text/html"/>
   …
</metadata>

manifest要素は、コンテンツのレンダリングに使用される出版リソースの網羅的な一覧を提供します。

要素名:: manifest
使用法:: metadataに続く、 packageの REQUIREDな2番目の子。
属性:: id [optional]
内容モデル:: item [1つ以上]

パッケージ文書を除き、 manifestは、出版リソースがコンテナーリソースであるか、リモートリソースであるかに関係なく、すべての出版リソースを列挙しなければMUSTなりません。

パッケージ文書はすでにcontainer.xmlファイルによって識別されているため、 manifestはそれを表すitem要素を指定してはMUST NOTなりません（すなわち、自己参照には目的がありません）。

注記

マニフェストは出版リソースを列挙するためだけのものです。リンクされたリソースおよびOCF コンテナーの処理用の特殊ファイル（すなわち、META-INFディレクトリ内のファイル、および mimetypeファイル）は、包含が制限されます。

出版リソースの完全なマニフェストを提供しないと、レンダリングの問題につながる可能性があります。リーディングシステムは、そのようなリソースを展開しなかったり、セキュリティ上の理由でそれらへのアクセスを防いだりする可能性があります。

item要素は、出版リソースを表します。

要素名:

item

使用法:

manifestの子として。反復可能。

属性:

fallback [conditionally required]
href [required]
id [required]
media-overlay [optional]
media-type [required]
properties [optional]

内容モデル:

空

各item要素は、そのhref 属性内のURL [url]によって出版リソースを識別します。値は absolute-またはpath-relative-scheme-less-URL string [url]でなければMUSTなりません。各URLは、構文解析後、manifestスコープ内で一意でなければMUSTなりません。

item要素によって識別される出版リソースは、 media-type属性に提供されたMIME メディア型 [rfc2046]から推定される適用可能な仕様に適合しなければMUSTなりません。コアメディア型リソースについては、 3.2 コアメディア型で指定されたメディア型を使用しなければMUST なりません。

fallback属性は、参照される出版リソースのフォールバックを指定します。 fallback属性のIDREF [xml]値は、 manifest内の別のitemに解決されなければMUSTなりません。

あるitemのフォールバックは、別の itemへのフォールバックを指定してもMAYよく、さらに続けてフォールバックオプションのチェーンを作成できます。フォールバックチェーンの使用に関する追加要件については、3.5.1 マニフェストフォールバックを参照してください。

media-overlay属性は、このitemによって記述されるリソースのメディアオーバーレイ文書を識別する IDREF [xml]を取ります。詳細については、9.3.3.5 メディアオーバーレイのパッケージ化を参照してください。

注記

manifest内のitem要素の順序は重要ではありません。 spine 要素がコンテンツ文書の提示順序を提供します。

properties属性は、リソースの内容に関する情報をリーディングシステムに提供します。この情報により、カバー画像やEPUBナビゲーション文書などの主要リソースを発見できます。また、リソースが埋め込みスクリプト、MathML、またはSVGを含むかどうかなどを示すことで、リーディングシステムがレンダリングを最適化できるようにします。

Manifest Properties Vocabularyは、 properties 属性の既定語彙です。

item 要素によって参照されるリソースがそれぞれの定義に一致する場合は常に、次のプロパティを設定しなければMUSTなりません:

mathml
remote-resources
scripted
svg
switch

例 43: 埋め込みMathMLを含むスクリプト付きコンテンツ文書の識別

<item
    properties="scripted mathml"
    id="c2"
    href="c2.xhtml"
    media-type="application/xhtml+xml" />

これらのプロパティは、リソースに含められたコンテンツ（例えば [html] iframe 要素を介したもの）には再帰的に適用されません。例えば、スクリプトを持たないXHTMLコンテンツ文書がスクリプト付きコンテンツ文書を埋め込む場合、埋め込まれた文書のマニフェスト itemの properties属性だけがscripted値を持ちます。

EPUBナビゲーション文書として、navプロパティを使用してちょうど1つのitemが宣言されなければMUSTなりません。

例 44: EPUBナビゲーション文書の識別

<item
    properties="nav"
    id="c1"
    href="c1.xhtml"
    media-type="application/xhtml+xml" />

EPUB出版物がカバー画像を含む場合、OPTIONALなcover-image プロパティを設定することが推奨されます。

例 45: カバー画像の識別

<item
    properties="cover-image"
    id="ci"
    href="cover.svg"
    media-type="image/svg+xml" />

他の語彙からの用語は、5.3 語彙関連付けメカニズムで定義されるように追加してもMAYよいです。

例 46: コアメディア型リソースのみを持つマニフェスト

<package …>
   …
   <manifest>
      <item
          id="nav"
          href="nav.xhtml"
          properties="nav"
          media-type="application/xhtml+xml"/>
      <item
          id="intro"
          href="intro.xhtml"
          media-type="application/xhtml+xml"/>
      <item
          id="c1"
          href="chap1.xhtml"
          media-type="application/xhtml+xml"/>
      <item
          id="c1-answerkey"
          href="chap1-answerkey.xhtml"
          media-type="application/xhtml+xml"/>
      <item
          id="c2"
          href="chap2.xhtml"
          media-type="application/xhtml+xml"/>
      <item
          id="c2-answerkey"
          href="chap2-answerkey.xhtml"
          media-type="application/xhtml+xml"/>
      <item
          id="c3"
          href="chap3.xhtml"
          media-type="application/xhtml+xml"/>
      <item
          id="c3-answerkey"
          href="chap3-answerkey.xhtml"
          media-type="application/xhtml+xml"/>
      <item
          id="notes"
          href="notes.xhtml"
          media-type="application/xhtml+xml"/>
      <item
          id="cover"
          href="./images/cover.svg"
          properties="cover-image"
          media-type="image/svg+xml"/>
      <item
          id="f1"
          href="./images/fig1.jpg"
          media-type="image/jpeg"/>
      <item
          id="f2"
          href="./images/fig2.jpg"
          media-type="image/jpeg"/>
      <item
          id="css"
          href="./style/book.css"
          media-type="text/css"/>
   </manifest>
   …
</package>

例 47: フォールバックを持つスパイン内の外部コンテンツ文書

次の例は、マニフェストフォールバックチェーンにより、外部コンテンツ文書（JPEG）を、SVGコンテンツ文書へのフォールバック付きでスパインに列挙できることを示しています。

<package …>
   …
   <manifest>
      …
      <item
          id="page-001"
          href="images/page-001.jpg"
          media-type="image/jpeg"
          fallback="page-001-svg"/>

      <item
          id="page-001-svg"
          href="images/page-001.svg"
          media-type="image/svg+xml"/>
      …
      …
   </manifest>
   <spine>
      …
      <itemref idref="page-001"/>
      …
   </spine>
</package>

例 48: トップレベルコンテンツ文書として表示するリンクを持つ埋め込みコアメディア型リソース

次の例は、EPUBコンテンツ文書に imgタグを介して埋め込まれたJPEGと、それを別ページとして開けるようにするハイパーリンク（例えば、拡大しやすくするため）を示しています。imgタグを使用して画像を埋め込むだけであれば、それをスパインに列挙したり、フォールバックを持たせたりする必要はありませんが、ハイパーリンクを追加すると、その文書はトップレベルコンテンツ文書として開かれます。スパインで使用されることで外部コンテンツ文書になるため、 EPUBコンテンツ文書へのフォールバックを含みます。

XHTML:
<html …>
   …
   <body>
      …
      <img
          src="images/infographic.jpg"
          alt="…"/>
      <a
          href="images/infographic.jpg">
         Expand Image
      </a>
      …
   </body>
</html>

Package document:
<package …>
   …
   <manifest>
      …
      <item
          id="img01"
          href="images/infographic.jpg"
          media-type="image/jpeg"
          fallback="infographic-svg"/>

      <item
          id="infographic-svg"
          href="images/infographic.svg"
          media-type="image/svg+xml"/>
      …
   </manifest>
   <spine>
      …
      <itemref
          idref="img01"
          properties="layout-pre-paginated"
          linear="no"/>
      …
   </spine>
</package>

例 49: 外部リソースをトップレベルコンテンツ文書として表示するリンク

次の例は、生のCSVデータファイルへのリンクを示しています。データはリーディングシステムでトップレベルコンテンツ文書として開かれるため、スパインに列挙する必要があります。スパインで使用されることで外部コンテンツ文書になるため、 EPUBコンテンツ文書へのフォールバックを含みます。ユーザーが生形式のデータにアクセスできる保証はないため、 EPUBコンテナーからファイルを抽出する方法についての説明も提供します。

XHTML:
<html …>
   …
   <body>
      …
      <p>
         <a href="../data/raw.csv">
            [Open the raw CSV data for this project.]
         </a>
      </p>
      <p class="small">To extract the data file
         from this publication, unzip the EPUB file.
         The data is located in the
      	<code>/EPUB/data/raw.csv</code> file.
      </p>
      …
   </body>
</html>

Package document:
<package …>
   …
   <manifest>
      …
      <item
          id="data01"
          href="data/raw.csv"
          media-type="text/csv"
          fallback="data-html"/>

      <item
          id="data-html"
          href="xhtml/data-table.html"
          media-type="application/xhtml+xml"/>
      …
   </manifest>
   <spine>
      …
      <itemref
          idref="data01"
          linear="no"/>
      …
   </spine>
</package>

例 50: 出版リソースであるリモートリソース

次の例は、リモート音声ファイルへの参照を示しています。 audio要素がそのEPUBコンテンツ文書内に音声を埋め込むため、そのファイルは出版リソースと見なされます。したがって、音声ファイルはマニフェストに列挙され、そのホストEPUBコンテンツ文書のエントリーは、それがリモートリソースを含むことを示します。

XHTML:
<html …>
   …
   <body>
      …
      <audio
          src="http://www.example.com/book/audio/ch01.mp4"
          controls="controls"/>
      …
   </body>
</html>

Package document:
<package …>
   …
   <manifest>
      …
      <item
          id="audio01"
          href="http://www.example.com/book/audio/ch01.mp4"
          media-type="audio/mp4"/>

      <item
          id="c01"
          href="XHTML/chapter001.xhtml"
          media-type="application/xhtml+xml"
          properties="remote-resources"/>
      …
   </manifest>
   …
</package>

例 51: 出版リソースではない外部リソース

次の例は、ウェブ上でホストされる音声ファイルへのハイパーリンクを示しています。リーディングシステムはこのような外部コンテンツを新しいブラウザーウィンドウで開きます。音声ファイルは出版物内でレンダリングされません。この場合、そのファイルは出版リソースではないため、マニフェストに列挙されません。

XHTML:
<html …>
   …
   <body>
      …
      <a
          href="http://www.example.com/book/audio/ch01.mp4">
         Listen to audio
      </a>
      …
   </body>
</html>

Manifest:
No Entry

spine要素は、既定の読書順序を表すマニフェスト item参照の順序付き一覧を定義します。

要素名:

spine

使用法:

manifestに続く、 packageの REQUIREDな3番目の子。

属性:

id [optional]
page-progression-direction [optional]
toc [optional] (古い)

内容モデル:

itemref [1つ以上]

spineは、少なくとも1つの EPUBコンテンツ文書または外部コンテンツ文書を指定しなければMUSTなりません。

spine内の出版リソースからハイパーリンクされるすべてのEPUB および外部コンテンツ文書は、spineに列挙されなければMUSTなりません。ここでハイパーリンクとは、ユーザーが現在のリソースから離れて移動することを必要とする任意のリンク機構を含みます。一般的なハイパーリンク機構には、 [html]の a および area 要素の href 属性、ならびにスクリプト化されたリンク（例えば、DOM Eventsおよび/またはform 要素を使用するもの）が含まれます。ハイパーリンクされたリソースを列挙する要件は再帰的に適用されます（すなわち、ハイパーリンクされた文書からハイパーリンクされるすべてのEPUBおよび外部コンテンツ文書も列挙されなければならず、以下同様です）。

EPUBナビゲーション文書からハイパーリンクされるすべてのEPUBおよび外部コンテンツ文書も、EPUBナビゲーション文書が spineに含まれているかどうかにかかわらず、spineに列挙されなければMUST なりません。

注記

EPUBコンテナー外のリソースへのハイパーリンクは出版リソースではないため、スパインに含める要件の対象ではありません（例えば、ウェブページおよびウェブ上でホストされるリソース）。

スパイン項目のレンダリングに使用される出版リソース（例えば、[html]の埋め込みコンテンツから参照されるもの）も同様に、スパインに含める必要はありません。

page-progression-direction 属性は、コンテンツが流れる全体の方向を設定します。許可される値は ltr（左から右）、rtl（右から左）およびdefaultです。 default値が指定された場合、優先方向は表明されず、リーディングシステムがレンダリング方向を選択できます。

page-progression-direction属性は全体の流れ方向を設定しますが、個々のEPUBコンテンツ文書およびEPUBコンテンツ文書の一部は、この設定を上書きしてもMAY よいです（例えば、CSSのwriting-modeプロパティを介して）。リーディングシステムも、既定方向を上書きする仕組み（例えば、代替スタイルシートの適用を可能にするボタンまたは設定）を提供する場合があります。

古いtoc属性は、IDREF [xml]を取り、 NCXを表すマニフェスト項目を識別します。

itemref要素は、既定の読書順序内のEPUBコンテンツ文書または外部コンテンツ文書を識別します。

要素名:

itemref

使用法:

spineの子として。反復可能。

属性:

id [optional]
idref [required]
linear [optional]
properties [optional]

内容モデル:

空

各itemref要素は、その idref属性内の IDREF [xml]を介して、マニフェスト内の itemの ID [xml]を参照しなければMUSTなりません。 item要素のIDは複数回参照してはMUST NOTなりません。

参照される各マニフェストitemは、a) EPUBコンテンツ文書、または b) そのマニフェストフォールバックチェーンに EPUBコンテンツ文書を含む外部コンテンツ文書のいずれかでなければMUST なりません。

注記

EPUB出版物はEPUBナビゲーション文書を必要としますが、それをスパインに含めることは必須ではありません。

linear属性は、参照される itemが、主要な読書順序に寄与し、リーディングシステムが順番に読むことを期待されるコンテンツ（「yes」）を含むのか、またはリーディングシステムが順序外でアクセスできる、主要コンテンツを強化または補強する補助コンテンツ（「no」）を含むのかを示します。補助コンテンツの例には、注、説明、および解答キーがあります。

linear属性により、リーディングシステムは、ユーザーが既定の読書順序の一部としてアクセスする必要があるコンテンツと、リーディングシステムが例えばポップアップウィンドウで提示したり音声レンダリングから省略したりする可能性のある補足コンテンツを区別できます。

コンテンツが非線形であると指定しても、リーディングシステムに特定の方法で提示することを要求するわけではありません。それは目的に対するヒントにすぎません。リーディングシステムは、例えば非線形コンテンツをスパイン内で出現する位置に提示する場合もあれば、ユーザーがスパインの末尾に到達するまでそれをスキップする場合もあります。

注記

ユーザーが線形スパイン項目の間でそれに出会うことが意味を持つ場合を除き、非線形コンテンツはスパインの末尾に列挙することが推奨されます。

線形itemref要素とは、そのlinear 属性値が明示的に「yes」に設定されているもの、またはその属性を省略しているものです — リーディングシステムは、属性を持たない itemref要素について値「yes」を仮定します。スパインは少なくとも1つの線形itemref要素を含まなければMUSTなりません。

リーディングシステムはスパインを進めている間に非線形コンテンツへのアクセスを提供しない可能性があるため、すべての非線形コンテンツへアクセスする二次的な手段を提供しなければMUSTなりません（例えば、コンテンツ内のハイパーリンクまたは EPUBナビゲーション文書を介して）。

Spine Properties Vocabularyは、 properties属性の既定語彙です。

他の語彙からの用語は、5.3 語彙関連付けメカニズムで定義されるように追加してもMAYよいです。

例 52: 基本的なスパイン

この例では、スパインのエントリーは上記のマニフェスト例に対応しています。

<spine
    page-progression-direction="ltr">
   <itemref
       idref="intro"/>
   <itemref
       idref="c1"/>
   <itemref
       idref="c1-answerkey"
       linear="no"/>
   <itemref
       idref="c2"/>
   <itemref
       idref="c2-answerkey"
       linear="no"/>
   <itemref
       idref="c3"/>
   <itemref
       idref="c3-answerkey"
       linear="no"/>
   <itemref
       idref="notes"
       linear="no"/>
</spine>

このセクションは非規範的です。

XHTMLコンテンツ文書は、 HTML Standard [html]の XML構文を使用して表現されるXML 文書のインスタンスです。

このプロファイルに適合するXHTMLコンテンツ文書は、コアメディア型リソースであり、 EPUBコンテンツ文書を構成する2つの形式のうちの 1つです — これは spine内でフォールバックなしに使用できます。

注記

EPUB 3は、[html]の HTML構文をコアメディア型としてサポートしません。どちらのシリアル化でも同じ要素を表現できますが、すべてのJavaScriptライブラリおよびAPIが XML構文、特に shadow DOMを扱うように設計されているわけではありません。これは、例えば、 template 要素 [html]はXML構文で作成できますが、HTML構文と同じ方法では使用できない可能性があることを意味します。

Publishing Maintenance Working Groupは、HTML StandardがXML構文の使用をもはや推奨していないことを認識しています。しかし、XMLは多くの出版ワークフローに不可欠であり、多くのベンダーの取り込みシステムおよびリーディングシステムで期待されています。また、将来、構文間に追加のサポート差異が生じるとしても、 XHTMLのサポートがブラウザーから削除されることは想定されていません。HTML構文のサポートは、 EPUB 3の後継形式で扱われる可能性があります。

注記

EPUB 3の以前のバージョンでは、EPUBコンテンツ文書を定義するために W3CのHTML5標準を参照していましたが、その標準は主にWHATWGによって維持されているHTML Standardのスナップショットでした。 2019年にHTMLの開発に関する合意に達した後、W3C標準は廃止され、EPUB 3は現在、 HTML Standardのみを参照しています。これは、EPUB 3がXHTMLコンテンツ文書でHTML5をもはやサポートしないことを意味するものではなく、HTML5が現在、HTML 4.01および XHTML 1.1の後継であるHTML Standardを指すマーケティング用語になったことを意味するだけです。

XHTMLコンテンツ文書は:

7.1.4 HTML からの逸脱および制約で明示的に上書きされている場合を除き、[html]によって定義されるすべての文書構成要素の適合基準に適合しなければMUSTなりません。
7.1.3 HTML拡張で定義されるように、[html]文法への拡張を含んでもMAYよく、そこで定義されるすべてのコンテンツ適合制約に適合しなければMUSTなりません。
XML構文に適合する [html]文書でなければMUSTなりません。

別途指定がない限り、XHTMLコンテンツ文書は、意味、構造、および処理動作に関するすべての定義を [html]仕様から継承します。

注記

EPUB出版物が [epub-a11y-12]のアクセシビリティ要件に従うという推奨は、 XHTMLコンテンツ文書にも適用されます。アクセシビリティを参照してください。

このセクションは、基礎となる[html] 文書モデルに対するEPUB 3 XHTMLコンテンツ文書拡張を定義します。

注記

[html]は、ユーザーエージェントがベンダー中立の拡張をサポートすることを認めていますが、そのような拡張がこのセクションに列挙されていない限り、それらは EPUB 3でサポートされる機能ではありません。

epub:type 属性は、XHTMLコンテンツ文書内で構造セマンティクスを表現するために使用してもMAYよいです。

この属性は、head要素またはメタデータコンテンツ [html]で使用してはMUST NOTなりません。

[html-rdfa]仕様は、コンテンツを意味的に豊かにするためにXHTMLコンテンツ文書内で使用してもMAYよい属性の集合を定義します。これらの属性の使用は、[html-rdfa]で定義される要件に適合しなければMUSTなりません。

[html-rdfa]仕様は、作成者が RDFa属性を使用する場合の[html]コンテンツモデルへの変更を定義します。この変更されたコンテンツモデルは、XHTMLコンテンツ文書で有効です。

注記

RDFaを列挙していることは、Working Group側の優先を表すものではなく、これらの属性がHTML文法の拡張を表すことだけを意味します。Microdata属性 [html]およびリンクトデータ [json-ld11]は、XHTML コンテンツ文書でネイティブにサポートされており、同様に使用できます。

[its20]仕様は、国際化、翻訳、およびローカライズのサポートを追加するために、XHTMLコンテンツ文書内で使用してもMAYよい属性の集合を定義します。

ITS属性は、Using ITS markup in HTML [its20]で定義されるとおりにのみ使用されなければMUSTなりません（すなわち、EPUB 3は名前空間付き属性をサポートしません）。

これらの属性の使用は、[its20]で定義される要件に適合しなければMUSTなりません。

注記

[html]の link 要素からITS文書にリンクすることも可能です。これは、 Global approach in HTML5 [its20]のセクションで定義されています。そのようにリンクされたファイルは免除リソースであるため、このユースケースに対応するための [html]への拡張は不要です。

XHTMLコンテンツ文書は、カスタム属性を含んでもMAYよいです。これは、名前空間 URLのドメイン [url]に次の文字列のいずれも含まない接頭辞付き [xml-names]属性です:

w3.org
idpf.org

カスタム属性を使用する場合、コンテンツは、どのリーディングシステムでレンダリングされるかにかかわらず、情報の損失またはその他の重大な劣化なしに、ユーザーが利用可能なままでなければMUST なりません。

注記

カスタム属性は通常、リーディングシステム固有の方法で定義され、他のリーディングシステムで使用されることは意図されていません。複数の独立したリーディングシステムが使用できる拡張を追加するための推奨される方法は、この仕様を拡張することです。

このセクションは、EPUB 3 XHTMLコンテンツ文書に適用される、基礎となる[html]文書モデルからの逸脱および制約を定義します。

XHTMLコンテンツ文書は、埋め込み [mathml3]をサポートします。MathMLマークアップの出現は、次の追加制限とともに、 MathML仕様 [mathml3]で表現される制約に適合しなければMUST なりません:

表示MathML

math要素は、 annotation-xml要素内を除き、表示MathMLのみを含まなければMUST なりません。

内容MathML

内容 MathMLは、XHTMLコンテンツ文書内のMathMLマークアップの中に含めてもMAYよく、存在する場合は、semantics要素の annotation-xml子要素内に含まれなければMUSTなりません。

前の条件に従って内容MathMLが含まれる場合、指定されたannotation-xml要素のencoding 属性は、機能的に等価な値である MathML-Contentまたはapplication/mathml-content+xmlのいずれかに設定され、name属性はcontentequivに設定されなければMUSTなりません。

このサブセットは、リーディングシステムの実装負担を軽減し、アクセシビリティを促進しながら、[html]ユーザーエージェントとの互換性を保持します。

注記

mathmlプロパティは、マニフェストの item 要素において、XHTMLコンテンツ文書が埋め込みMathMLを含むことを示します。

XHTMLコンテンツ文書は、SVGの埋め込みをサポートします:

参照による — 例えば、[html]の img または object 要素から。参照によって埋め込まれたSVGはSVG コアメディア型であるため、その要件はすでに7.2 SVGコンテンツ文書で定義されています。
包含による — XHTMLコンテンツ文書内にSVG文書フラグメント [svg]を直接含めることによる。包含によって埋め込まれたSVGは、 SVGコンテンツ文書に対して 7.2.3 SVGに関する制限で定義されるものと同じコンテンツ適合制約を持ちます。

注記

svgプロパティは、マニフェストの item 要素において、XHTMLコンテンツ文書が埋め込みSVGを含むこと（参照によるもの、または包含によるもの）を示します。

このセクションは非規範的です。

[html]のbase 要素は、URLを構文解析する目的で文書ベースURLを指定するために使用できます。 EPUB出版物でそれを使用すると、 base要素の解釈により、意図せずリモートリソースへの参照が生じる可能性があります。また、リーディングシステムがハイパーリンクの場所を誤って解釈する原因にもなり得ます（例えば、base要素が絶対URLを指定している場合、出版物内の他の文書への相対リンクがウェブサイトへのリンクのように見える可能性があります）。重大な相互運用性の問題を避けるため、base要素の使用は推奨されません。

[html]の rp 要素は、ルビマークアップを認識しない古いリーディングシステムにフォールバックを提供することを意図しています（すなわち、rubyマークアップの周囲に括弧を表示します）。EPUB 3リーディングシステムはルビを認識し、フォールバックを提供できるため、 rp要素の使用は推奨されません。

[html]のembed 要素は、スクリプティングをサポートしないリーディングシステム向けの固有のフォールバック機能を含まないため、スクリプト付きリソースとともにこの要素を使用することは推奨されません。[html]の object 要素は、固有のフォールバック機能を含むため、よりよい代替です。

このセクションは非規範的です。

Scalable Vector Graphics（SVG）仕様 [svg]は、最終形のベクターグラフィックスおよびテキストを表現する形式を定義します。

XHTMLコンテンツ文書はトップレベルコンテンツ文書としてより一般的に使用されますが、 SVGコンテンツ文書の使用も許可されています。SVGは通常、コンテンツの表現として最終形のページ画像しか適さない場合など、特定の特殊ケースでのみ必要になります（例えば、表紙アートやマンガまたはコミックブックの文脈で）。

このセクションは、[svg]文書のプロファイルを定義します。このプロファイルに適合するXML文書のインスタンスはコアメディア型リソースであり、この仕様ではSVGコンテンツ文書と呼ばれます。

注記

このセクションは、SVGコンテンツ文書の適合要件を定義します。XHTML コンテンツ文書に埋め込まれたSVGの適合要件については、7.1.4.2 埋め込みSVGを参照してください。

SVG コンテンツ文書は、適合するSVG スタンドアロンファイル [svg]でなければMUSTならず、7.2.3 SVGに関する制限で表現されるすべてのコンテンツ適合制約に適合しなければなりません。

注記

EPUB出版物が [epub-a11y-12]のアクセシビリティ要件に従うという推奨は、 SVGコンテンツ文書にも適用されます。アクセシビリティを参照してください。

この仕様は、SVG コンテンツ文書およびXHTML コンテンツ文書に包含によって埋め込まれたSVGのコンテンツモデルを次のように制限します:

[svg]のforeignObject 要素:
- [html]のフローコンテンツ、またはちょうど1つの[html]のbody要素のいずれかを含まなければMUSTなりません。
  
  注記
  
  包含によって埋め込まれたSVGの場合、 [html]で定義されるSVGに関する制限により、 body要素は許可されません。
- 7.1.2 XHTML 要件で定義されるXHTMLコンテンツ文書モデルに適合する有効な文書フラグメントを含まなければMUSTなりません。
[svg]の title 要素がマークアップ付きテキストを含む場合、そのマークアップは HTML名前空間 [infra]で宣言された要素のみを含まなければMUSTなりません。

注記

[svg]のtitle要素はマークアップ要素を許可していますが、この機能のサポートは限られています。最大限の相互運用性のため、テキストのみのタイトルの使用が推奨されます。
指定される場合、 epub:type 属性は、レンダリング可能要素 [svg]にのみ含められなければMUSTなりません。

注記

SVGコンテンツモデルは、作成者が名前空間付き属性を含めることを許可しているため、この仕様で epub:type 属性または語彙関連付けメカニズムを許可する必要はありません。

ただし、参照によって埋め込まれたSVGと包含によって埋め込まれたSVGの主な違いの1つは、包含によって埋め込まれたSVGは、そのルート svg 要素 [svg]にepub:prefix属性を持つことができない点です。詳細については、5.3.4 prefix属性を参照してください。

このセクションは非規範的です。

EPUB出版物は、印刷本やPDFファイルとは異なり、変化するように設計されています。コンテンツは、画面とユーザーのニーズに合わせて流れ、またはリフローします。Rendering and CSSで述べられているように、「コンテンツの提示は、ユーザーが特定の提示に適応しなければならないのではなく、ユーザーに適応します。」 [epub-overview-34]

しかし、この原則はすべての種類の文書に当てはまるわけではありません。コンテンツとデザインが非常に密接に結び付いていて、それらを分離できない場合があります。外観の変更は、意味を変えたり、すべての意味を失わせたりする危険があります。固定レイアウト文書は、リフロー可能レイアウトがコンテンツに適さない場合に、提示をより細かく制御できます。

固定レイアウト文書は、文書内のメタデータで指定された一定の幅と高さでリーディングシステムによりレンダリングされる点で、reflowableなEPUB コンテンツ文書とは異なります。これにより、文書のコンテンツをピクセル単位で正確に配置できます。任意の外部リソースも固定レイアウトを持つものとして指定できます（ただし、これらにはEPUBコンテンツ文書へのフォールバックが必要です）。例えば、特にロールレイアウトでは、画像の外部リソースが固定レイアウトでスパインに使用されることがよくあります。

EPUBコンテンツ文書または外部リソースが固定レイアウト文書を表すかどうかは、出版物のレイアウトに依存します。事前ページ分割済みおよびロールの固定レイアウトはどちらも、スパインから参照されるすべての項目が既定で固定レイアウト文書であることを期待します（ただし、この動作は事前ページ分割済みレイアウトの場合には上書きできます）。リフロー可能レイアウトを上書きして、事前ページ分割済みの固定レイアウト文書を追加することも可能です。

固定レイアウト文書のレイアウト寸法は、それぞれのEPUBコンテンツ文書から取得されます。文書がリーディングシステムでどのように提示されるかは、使用されるレイアウトに依存します — 事前ページ分割形式で表示される（ビューポートまたは合成スプレッドのスロットごとに1つ）か、連続ロールとして提示されます。

注記

EPUB 3は、固定レイアウトコンテンツを表現するための複数の形式をサポートします。固定レイアウトコンテンツが必要な場合、形式の選択は、望まれる精度、ファイルサイズ、アクセシビリティなど、多くの要因に依存します。この文書は、形式の選択を規定しようとするものではありません。

特に、スパインで画像を使用することは、配布とアクセシビリティの両面で問題があることが知られています。 EPUBコンテンツ文書のフォールバックが必要であるにもかかわらず、すべてのベンダーが画像をスパインに含む EPUB出版物を受け入れるわけではなく、リーディングシステムはユーザーがそれらのフォールバックに到達するオプションを常に提供するわけではありません。その使用は、ロールレイアウトをサポートするコミックやマンガなどの専門的なエコシステムでのみ推奨されます。

このセクションは、固定レイアウト文書の寸法プロパティの表現および解釈に関する規則を定義します。

固定レイアウト文書は、その形式に適用される方法で、初期包含ブロック [css2]を指定します:

XHTMLでの表現

XHTMLの固定レイアウト文書については、初期包含ブロック [css2]は、 viewport metaタグ内のREQUIREDなheightおよび width定義から取得されます。ここで:

height プロパティは、その値として正の数値 [css2] またはキーワード device-heightを持たなければMUSTなりません; そして
widthプロパティは、その値として正の数値 [css2] またはキーワード device-widthを持たなければMUSTなりません。

device-widthおよびdevice-height値は、それぞれリーディングシステムのビューポートの幅および高さの100%を指します。

heightおよびwidth定義は、文書順で[html]の head要素内の最初の viewport metaタグに指定されなければMUST なりません。リーディングシステムは後続のviewport metaタグを無視します。

EPUB作成者は、viewport metaタグ内で複数のheightまたは width 定義を指定してはMUST NOTなりません。

例 62: viewport metaタグで初期包含ブロックを指定する

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

SVGでの表現

SVGの固定レイアウト文書については、初期包含ブロック [css2]の寸法は、viewBox 属性 [svg]を使用して表現されなければMUST なりません。

例 63: viewBox属性で初期包含ブロックを指定する

この例では、viewBox属性がICBを幅844ピクセル、高さ1200ピクセルのアスペクト比に設定します。

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

画像の外部リソースでの表現

スパインから参照される画像外部リソースについては、初期包含ブロック [css2]は、画像の幅および高さのメタデータから取得されます。このメタデータがどのように保存されるかについては、画像形式の文書を参照してください。

注記

初期包含ブロックの定義は、それが定義されている文書にのみ影響します。同じ出版物内の他のコンテンツ文書における包含ブロックの寸法は異なる場合があります。

このセクションは、XHTML およびSVGコンテンツ文書の両方で使用可能な技術の要件を定義します。

このセクションは非規範的です。

CSSはOpen Web Platformの不可欠な部分です。読者、出版者、および文書作成者は、 HTMLが「そのまま動く」ことを期待するのと同様に、CSSも「そのまま動く」ことを期待します。

過去には、EPUBは特定のプロパティのサポートを義務付け、多数の他のプロパティに対して接頭辞付きバージョンを提供するCSSのプロファイルを定義していました。CSS Working Groupはもはや接頭辞付きプロパティの使用を推奨していませんが、この仕様は既存のコンテンツを壊さないようにいくつかの接頭辞付きプロパティを維持しています。しかし、このセクションで定義される軽微な例外を除き、 EPUBはCSSの定義をW3Cに委ね、リーディングシステムが主要ブラウザーのレベルでそれをサポートすることを期待します。

リーディングシステムはCSS snapshotで定義されるCSS [epub-rs-34]をサポートすることが期待されていますが、実際には、ほとんどのリーディングシステムは現在、CSSの望ましい機能すべてをサポートしているわけではなく、 EPUB出版物で定義された既定の提示をしばしば変更し、ユーザーが変更できるようにします。その結果、スタイリングはこれらの実情に適応する必要があります。詳細については、7.4.1.3 リーディングシステムのサポートに関する考慮事項を参照してください。

CSSスタイルシートは:

次の例外を除き、任意のCSSプロパティを含んでもMAYよいです:
- direction プロパティ [css-writing-modes-3]を含んではMUST NOTなりません。
- unicode-bidi プロパティ [css-writing-modes-3]を含んではMUST NOTなりません。
古い接頭辞付きプロパティを含んでもMAYよいです。
UTF-8または UTF-16 [unicode]で符号化されなければMUSTならず、 UTF-8がRECOMMENDEDされる符号化です。

注記

この仕様は、リーディングシステムがCSS処理を実装しない、または無効にする可能性があるため、directionおよび unicode-bidiプロパティの使用を制限します。レンダリングのこれらの側面を制御する必要がある場合、次の形式固有の方法を使用する必要があります:

インラインの基本方向性には、 dir 属性 [html]およびdirection 属性 [svg]。
双方向性には、 bdo 要素と dir 属性 [html]、および unicode-bidiに対するプレゼンテーション属性の代替 [svg]。

このセクションは非規範的です。

次のCSS機能のサポートは、EPUBリーディングシステムで特に問題があることが知られています:

リーディングシステムによるページ分割は、リーディングシステムが列を使用してページ分割する場合があるため、スタイルシートとうまく相互作用しないことがあります。これにより、ビューポートサイズに対して不正確な値が生じる可能性があります。固定配置および絶対配置は特に問題があります。
一部の種類の画面では、アニメーションおよびトランジションのレンダリングが不十分になることがあります（例えば、遅延が大きいもの）。

リーディングシステムは通常、EPUB出版物のスタイルの一部（例えば、アプリケーションに適した余白の設定）を設定し、既定の指示を上書きする可能性があります。競合および潜在的なレンダリング問題を軽減するため、リーディングシステムのユーザーエージェントスタイルシートが公開されている場合は、それらを参照し、最適な表示のためにスタイリングの選択を適応させることが推奨されます。

さらに、ユーザーが外観を変更できるリーディングシステム（例えば、フォント、テキスト揃え、または前景色と背景色の選択）も、EPUB出版物内の一部のCSSレンダリング指示を変更します。CSSの優先順位規則のため、 EPUBコンテンツ文書内で[html]の style 属性の使用を制限し、ユーザー体験に悪影響が生じないようにすることが望ましいです（すなわち、ユーザーのスタイル選択が普遍的に適用されない状況を避ける）。一部のリーディングシステムはインラインスタイルを上書きしますが、そのような動作は保証されません。

EPUBコンテンツ文書は、それぞれの基礎仕様（[html]および[svg]）で定義される機能を使用してスクリプティングを含んでもMAYよいです。EPUB コンテンツ文書がスクリプティングを含む場合、この仕様ではそれをスクリプト付きコンテンツ文書と呼びます。このラベルは、[html]の form 要素を含むXHTMLコンテンツ文書にも適用されます。

scriptedプロパティは、マニフェストの item要素において、EPUBコンテンツ文書がスクリプト付きコンテンツ文書であることを示すために使用されます。

[html]のscript要素がデータブロック [html]を含む場合、それはスクリプト付きコンテンツを表しません。

注記

[svg]は公開時点でデータブロックを定義していませんが、将来の更新でこの概念が追加された場合、同じ除外が適用されます。

リーディングシステムは、各EPUB出版物に一意なオリジン [html]が割り当てられているかのように振る舞う必要があることに注意してください。実際には、これはスクリプトがEPUB出版物間でデータを共有できないことを意味します。

スクリプトがどのコンテキストで使用されるかも、リーディングシステムがそれに課す権利および制約を決定します（詳細については、Scripting [epub-rs-34]を参照してください）。

注記

リーディングシステムは、他のEPUB機能を無効にし、および/または異なるレンダリングとユーザー体験を提供する方法で、スクリプト付きコンテンツ文書をレンダリングする場合があります（例えば、ページ分割を無効にすることによって）。

EPUB 3は、スクリプト実行のための2つのコンテキストを定義します:

コンテナー制約付き — スクリプトの実行が[html]の iframe 要素内で発生する場合; および
スパインレベル — スクリプトの実行がトップレベルコンテンツ文書内で直接発生する場合。

注記

スクリプトは他のコンテキストで実行できますが、これらのコンテキストに対するリーディングシステムのサポートは任意です。例えば、スクリプト付きSVG文書が[html]の object 要素から参照される場合があります。

詳細については、スクリプトの処理 [epub-rs-34]を参照してください。

コードがscript要素に直接埋め込まれているか、その要素のsrc属性を介して参照されているかは、その実行コンテキストに違いをもたらしません。

スクリプトに使用されるコンテキストは、スクリプトが実行できる操作と、リーディングシステムでのサポートの可能性の両方に影響します。これは以下のサブセクションで説明します。

注記

2つのコンテキストの違いの例については、A.2 スクリプティングコンテキストを参照してください。

コンテナー制約付きスクリプトとは、次のいずれかです:

[html]の script 要素のインスタンスで、[html]の iframe 要素を使用してXHTMLコンテンツ文書に埋め込まれたXHTMLコンテンツ文書に含まれるもの。
[svg]のscript 要素のインスタンスで、[html]の iframe 要素を使用してXHTMLコンテンツ文書に埋め込まれたSVGコンテンツ文書に含まれるもの。

コンテナー制約付きスクリプトは、それを埋め込む EPUBコンテンツ文書のDOMを変更する命令（すなわち、iframe要素を含む文書）を含んではMUST NOTなりません。また、その包含矩形のサイズを操作する命令を含んでもMUST NOTなりません。

リーディングシステムにおけるコンテナー制約付きスクリプティングのサポートは、リフロー可能文書でのみ推奨され [epub-rs-34]、固定レイアウト文書では任意であることに注意してください。

コンテナー制約付きスクリプトは、スクリプティングサポートのないリーディングシステムでも優雅に劣化するようにしてください（7.4.2.5 スクリプティングフォールバックを参照）。

注記

スクリプティングの使用をコンテナー制約付きモデルに制限することを選択すると、スクリプト付きコンテンツとスクリプトなしコンテンツの間でより一貫したユーザー体験を確保できます（例えば、一貫したページ分割動作）。

スパインレベルスクリプトとは、トップレベルコンテンツ文書に含まれる、[html]の script または[svg]のscript 要素のインスタンスです。

リーディングシステムにおけるスパインレベルスクリプティングのサポートは、固定レイアウト文書およびスクロールに設定されたリフロー可能文書 [epub-rs-34]でのみ推奨されることに注意してください。さらに、その他すべてのコンテキストにおけるリーディングシステムのサポートは任意です。

スパインレベルスクリプティングを含むトップレベルコンテンツ文書は、スクリプティングが無効または利用不可の場合でも、情報の損失またはその他の重大な劣化なしにユーザーが利用可能なままであるべきですSHOULD （例えば、プログレッシブエンハンスメント技法またはフォールバックを用いることによって）。トップレベルコンテンツ文書でスクリプトなし環境を考慮しないと、EPUB出版物が読めなくなる可能性があります。

このセクションは非規範的です。

リーディングシステム実装には幅広い可能性があるため、EPUB 出版物にスクリプティング機能を追加する際には考慮する必要があります（例えば、すべてのデバイスが物理キーボードを持つわけではなく、多くの場合、ソフトキーボードはテキスト入力要素でのみ有効になります）。したがって、キーボードイベントだけに依存せず、目的のアクションをトリガーする代替手段を常に提供してください。

スクリプティングを含むEPUBコンテンツ文書は、そのようなコンテンツに対するフォールバックを提供してもMAYよいです。これは、 [html]の object および canvas 要素で利用可能なものなどの固有のフォールバック機構を使用するか、固有のフォールバックが適用できない場合はマニフェストレベルのフォールバックを使用することによって行います。

スクリプトは、コアメディア型リソースまたはそのフラグメントのみを生成しなければMUSTなりません。

構造セマンティクスは、要素が果たす特定の構造的目的について追加の意味を加えます。 epub:type 属性は、EPUBコンテンツ文書内でドメイン固有のセマンティクスを表現するために使用され、それが保持する構造情報は基礎となる語彙を補完します。また、再生されるコンテンツの意味構造を反映するために、メディアオーバーレイ文書でも使用できます。

適用されるセマンティクスは、類似の role 属性 [html]を使用する場合のように、支援技術に対する性質を変えることなく、それらを含む要素の意味を精緻化します。言い換えれば、この属性はコンテンツのアクセシビリティを向上させるものではなく、目的についてのヒントを提供するだけです。

意味メタデータは、出版ワークフローおよび作成者定義の目的で使用するためにコンテンツを豊かにします。また、リーディングシステムが文書の構造と内容についてさらに知ることを可能にします（例えば、メディアオーバーレイでスキップ可能性およびエスケープ可能性を有効にするため）。

この仕様は、属性軸を使用して構造セマンティクスを追加する方法を定義します: 新しい要素を追加するのではなく、既存の要素にepub:type属性を追加して、望ましいセマンティクスを付与できます。

属性名:: epub:type
名前空間:: http://www.idpf.org/2007/ops
使用法:: XHTML、SVG、およびメディアオーバーレイの要件を参照してください。
値:: 空白区切り [xml]のコンパクトURLの一覧。 5.3 語彙関連付けメカニズムで定義される制限を伴います。

注意

epub:type属性は、 role 属性 [html]と性質が似ていますが、これらの属性は異なる目的を果たします。 epub:type属性の値は、スクリーンリーダーのような支援技術によるアクセスを向上させません。これは、それらがこれらの技術で使用されるアクセシビリティ APIにマッピングされないためです。つまり、[html]の div や span のような意味的に中立な要素にepub:type値を追加しても、それらが支援技術に対してよりアクセシブルになるわけではありません。支援技術がそのような要素をどのように理解するかに影響するのはARIAロールのみです。

したがって、epub:type属性は出版セマンティクスおよびリーディングシステム拡張のみを意図しています。リーディングシステムは、支援技術との相互作用が不可欠でない場合に、内蔵の読み上げやメディアオーバーレイ機能のようなアクセシビリティ拡張を提供するためにepub:type値を使用できます。

アクセシブルな出版ロールの詳細については、Digital Publishing WAI-ARIA Module [dpub-aria]を参照してください。

epub:type属性は、それが現れる要素にセマンティクスを付与します。その値は、文書インスタンスに関連付けられた外部語彙に由来する、1つ以上の空白区切りの用語です。

epub:type属性の既定語彙は、EPUB 3 Structural Semantics Vocabulary [epub-ssv-11]です。そのプロパティを参照するための接頭辞 URLはhttp://idpf.org/epub/vocab/structure/#です。

この語彙の一部ではない接頭辞なしの用語を使用してもMAYよいですが、カスタムセマンティクスを追加するための推奨される方法は、それらに接頭辞を使用することです。詳細については、5.3 語彙関連付けメカニズムを参照してください。

例 64: 前文の識別

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

例 65: 用語集の識別

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

例 66: 改ページセマンティクスの追加

<html
    …
    xmlns:epub="http://www.idpf.org/2007/ops">
   …
   <body>
      …
      <p>
         …
         <span
            epub:type="pagebreak"
            id="p234"
            role="doc-pagebreak"
            aria-label="234"/>
         …
      </p>
      …
   </body>
</html>

このセクションは非規範的です。

EPUBナビゲーション文書は、必須コンポーネントであり、EPUB 出版物の一部です。これは、人間および機械が読めるグローバルなナビゲーション層を含めることを可能にし、それによってユーザーにとってのユーザビリティとアクセシビリティを高めます。

EPUBナビゲーション文書は、リーディングシステム向けの目次を定義する、特殊な種類のXHTMLコンテンツ文書です。また、ページリストや主要なランドマークのリストなど、その他の特殊なナビゲーション要素を含めることもできます。これらのナビゲーション要素には、処理を容易にするため、そのコンテンツに追加の制限があります。

ただし、EPUBナビゲーション文書は機械処理専用ではありません。特殊なナビゲーション要素の外側では、 EPUBナビゲーション文書の構造またはコンテンツに制限はありません（すなわち、文書の残りの部分は他のXHTMLコンテンツ文書と同様にマークアップできます）。その結果、線形読書順序の一部にもでき、重複する目次の必要を避けられます。機械処理のみを目的とするナビゲーション要素（例えば、ページリスト）は、hidden 属性を使用して非表示にできます。

リーディングシステムは、EPUBナビゲーション文書に見つかる情報からナビゲーションインターフェイスを生成する際に、スクリプティング、スタイリング、およびHTML書式を取り除く可能性があり、その結果が読みにくくなる場合があることに注意してください。そのような書式設定および機能が必要な場合、EPUBナビゲーション文書をスパインに含めることもできます。ナビゲーション文書のスクリプティングおよびスタイリングにプログレッシブエンハンスメント技法を使用すると、非ブラウザーのコンテキストでレンダリングされた場合でも、コンテンツがその完全性を保つことを確保しやすくなります。

有効なEPUBナビゲーション文書は:

XHTMLコンテンツ文書について 7.1.2 XHTML 要件で定義されるコンテンツ適合制約に適合しなければMUSTなりません;
8.3 nav要素: 制限で定義されるnav要素の制約に適合しなければMUSTなりません;
toc nav 要素をちょうど1つ含まなければMUSTなりません。
page-list nav要素をちょうど1つ含んでもMAYよいです。
landmarks nav要素をちょうど1つ含んでもMAYよいです。
1つ以上の追加のnav要素を含んでもMAYよいです。

EPUBナビゲーション文書内で nav要素が epub:type 属性を持つ場合、この仕様は、その要素およびその子孫のコンテンツモデルを次のように制限します:

内容モデル:

nav

この順序で:

h1-h6 [0または1]
ol [ちょうど1つ]

ol

この順序で:

li [1つ以上]

li

この順序で:

(span または a) [ちょうど1つ]
ol [条件付き必須]

span および a

任意の順序で:

HTMLフレージングコンテンツ [1つ以上]

これらの要素で許可される属性には制限がないことに注意してください。

追加要件については、以下の定義を参照してください。

nav要素のコンテンツモデルに関する次の詳述は、各種要素の目的と制限を説明します:

nav要素のol子は、コンテンツナビゲーションの主要レベルを表します。
順序付きリストの各リスト項目は、見出し、構造、またはその他の注目項目を表します。子a要素はリンク先のターゲットを説明し、span要素はリストを個別のグループに分けるための見出しとして機能します。例えば、挿絵の大きなリストは、各章ごとに1つずつ、複数のリストに分割できます。
子aまたはspan要素は、すべての子コンテンツの連結および空白正規化規則の適用後に、長さが0でないテキストラベルを提供しなければMUSTなりません。この要件への適合を判断する際、連結されたラベルには、非テキストの子孫要素のtitleまたは alt属性に含まれるテキスト内容を含めなければMUSTなりません。
aまたはspan要素が、固有のテキスト代替を提供しないHTML埋め込みコンテンツ [html]のインスタンスを含む場合、その要素はリンクラベルの代替テキスト表現を持つtitle 属性も含まなければMUSTなりません。
a要素のhref属性で提供される URL [url]参照は:
- toc nav、landmarks nav、およびpage-list navの場合、トップレベルコンテンツ文書またはその中のフラグメントに解決されなければMUST なりません。
- その他すべての nav種別については、EPUBコンテナー外のコンテンツ（例えば、ウェブでホストされるリソース）を参照してもMAYよいです。
補助的なコンテンツレベル（例えば、あるセクションのすべてのサブセクション見出し）を表すol（順序付きリスト）要素は、a 要素の後に続いてもMAYよいです。
ol（順序付きリスト）要素は、 span要素の後に続かなければMUSTなりません（span要素は「葉」の li要素内に出現できません）。
aまたはspan要素のどちらが先行するかにかかわらず、すべてのサブリストは、このセクションで主要ナビゲーションリストの構築について定義されるコンテンツ要件に従わなければMUSTなりません。

例 67: ナビゲーション要素の基本パターン

<nav epub:type="…">
   <h1>…</h1>
   <ol>
      <li>
         <a href="chap1.xhtml">
            A basic leaf node
         </a>
      </li>
      <li>
         <a href="chap2.xhtml">
            A linked heading
         </a>
         <ol>
            …
         </ol>
      </li>
      <li>
         <span>An unlinked heading</span>
         <ol>
            …
         </ol>
      </li>
      <li>
         <a href="appendix.xhtml">
            <img src="app1.jpg" alt="An image-based heading"/>
         </a>
      </li>
   </ol>
</nav>

注意

nav要素内の見出しとリンクは、任意の[html]のフレージングコンテンツを許可しますが、アプリベースのリーディングシステムは多くの場合、単純なテキストラベルのみをサポートします。これらのアプリはHTMLレンダリングに基づかない独自のナビゲーションウィジェットを作成するため、埋め込み画像やマルチメディア、MathML、インラインスタイリング、その他の要素および属性ベースのレンダリング指示を保持できないことがよくあります。この種のコンテンツがないことでユーザビリティ上の問題につながる場合には、その使用を避けることが推奨されます。

このセクションは非規範的です。

EPUBナビゲーション文書で定義されるnav 要素は、それらの epub:type 属性の値によって意味的に区別されます。

この仕様は、3種類のナビゲーション支援を定義します:

toc: 目次を含むnav要素を識別します。 toc navは、EPUBナビゲーション文書に含める必要がある唯一のナビゲーション支援です。
page-list: 印刷物またはその他の静的にページ分割されたソースのページ一覧を含む nav要素を識別します。
landmarks: 注目点の一覧を含むnav要素を識別します。

EPUBナビゲーション文書は、これらの種別それぞれについて、最大で1つのナビゲーション支援を含むことができます。追加のナビゲーション種別を含めることもできます。詳細については、8.4.5 その他のnav要素を参照してください。

EPUB 出版物の主要なナビゲーション階層は、 nav 要素 [html]で定義され、その epub:type 属性は値「toc」[epub-ssv-11]に設定されます（すなわち、toc nav要素）。この要素は概念的には印刷物における目次に対応します — 出版物の主要な構造セクションへのナビゲーションを提供します。

toc nav要素内の参照は、次の両方を反映するように順序付けるべきですSHOULD:

参照されるEPUBコンテンツ文書のスパイン内での順序; および
それぞれのEPUBコンテンツ文書内における対象要素の順序。

例 68: 単純な目次

<nav epub:type="toc">
   <h2>Table of contents</h2>
   <ol>
      <li><a href="preface.html#p01">Preface</a></li>
      <li><a href="chapter01.html#h01">Chapter 1</a></li>
      <li><a href="chapter02.html#h02">Chapter 2</a></li>
      …
   </ol>
</nav>

例 69: 構造化された目次

<nav epub:type="toc">
   <h2>Table of contents</h2>
   <ol>
      <li>
         <a href="part01.html#p01">Part I</a>
         <ol>
            <li>
               <a href="section01.html#s01">Section 1</a>
               <ol>
                  <li><a href="section01.html#s01-01">Section 1.1</a></li>
                  <li><a href="section01.html#s01-02">Section 1.2</a></li>
                  …
               </ol>
            </li>
            …
         </ol>
      </li>
      …
   </ol>
</nav>

ページリストは、コンテンツ内の静的なページ境界へのナビゲーションを提供します。これらの境界は、印刷物などの静的にページ分割されたソースに対応するか、または EPUB出版物専用のものです。

ページリストは、 nav 要素 [html]で定義され、その epub:type 属性は値「page-list」[epub-ssv-11]に設定されます（すなわち、page-list nav要素）。

page-list nav要素は、単一の ol子孫のみを含むべきですSHOULD （すなわち、ネストされたサブリストを持たない）。

例 70: 目的地を持つページリスト

EPUBナビゲーション文書内のページリストマークアップ:

<nav epub:type="page-list">
   <h2>Page list</h2>
   <ol>
      <li><a href="chapter01.html#p001">1</a></li>
      …
   </ol>
</nav>

[html]の role 属性値doc-pagebreak [dpub-aria]および epub:type 値pagebreak [epub-ssv-11]によって識別される、 chapter01.html内の最初のページの目的地:

<html …>
   …
   <body>
      <div epub:type="pagebreak" role="doc-pagebreak">1</div>
      …
   </body>
</html>

これらの属性の使用に関する詳細については、epub:type属性構文を参照してください。

ランドマークは、コンテンツの基本的な構造コンポーネントを識別し、リーディングシステムがそれらへの効率的なアクセスをユーザーに提供できるようにします（例えば、ユーザーインターフェイス内の専用ボタンを通じて）。

ランドマークは、 nav 要素 [html]で定義され、その epub:type 属性は値「landmarks」[epub-ssv-11]に設定されます（すなわち、landmarks nav要素）。

landmarks nav要素は、単一の ol子孫のみを含むべきですSHOULD （すなわち、ネストされたサブリストを持たない）。

epub:type 属性は、landmarks nav要素の子孫であるa要素で REQUIREDです。landmarks nav要素内の各リンクターゲットの構造セマンティクスは、この属性の値によって決定されます。

例 71: 基本的なlandmarks nav

この例では、epub:type属性値は [epub-ssv-11]の構造セマンティクスから取得されています。

<nav epub:type="landmarks">
   <h2>Guide</h2>
   <ol>
       <li>
          <a epub:type="toc"
             href="#toc">
            Table of Contents
          </a>
       </li>
       <li>
          <a epub:type="loi"
             href="content.html#loi">
            List of Illustrations
          </a>
       </li>
       <li>
          <a epub:type="bodymatter"
             href="content.html#bodymatter">
            Start of Content
          </a>
       </li>
   </ol>
</nav>

landmarks navは、同じリソースまたはそのフラグメントを参照する、同じ epub:type値を持つ複数のエントリーを含んではMUST NOT なりません。

landmarks navで定義される項目数は、リーディングシステムがユーザーインターフェイスで使用する可能性が高い項目のみに制限することが推奨されます。この要素は目次を繰り返すためのものではありません。

利用可能な場合、次のランドマークを含めることが推奨されます:

bodymatter [epub-ssv-11] — リーディングシステムは、ユーザーが読み始めるときに前付けを自動的に飛ばすため、このランドマークをよく使用します。
toc [epub-ssv-11] — 目次がスパインで利用可能な場合、リーディングシステムはこのランドマークを使用して、ユーザーをそれを含む文書へ移動させることができます。

landmarks navに含めるその他の可能性として、索引や用語集などの重要な参照セクションがあります。

landmarks navはリーディングシステムでの使用を意図していますが、それでも landmarks navのラベルが人間に読めることを確保することが推奨されます。リーディングシステムがリンクをユーザーに直接公開する可能性があります。

リーディングシステムの処理のために、EPUBナビゲーション文書内で追加のnav要素が必要な場合、それらは:

epub:type 属性を指定しなければMUSTなりません;
8.3 nav 要素: 制限のコンテンツモデル制限に従わなければMUSTなりません。

この仕様は、追加のnav要素のセマンティクスに制限を課しません: それらは任意の情報ドメインに対するナビゲーションセマンティクスを表してもMAYよく、同種または異種のセマンティクスを持つリンクターゲットを含んでもMAY よいです。

例 72: カスタムナビゲーション要素の追加

この例では、lotセマンティクスは、nav要素が表の一覧を含むことを示します。

<nav
    epub:type="lot"
    aria-labelledby="lot">
   <h2 id="lot">List of tables</h2>
   <ol>
      <li>
         <span>Tables in Chapter 1</span>
         <ol>
            <li>
               <a href="chap1.xhtml#table-1.1">
                  Table 1.1
               </a>
            </li>
            <li>
               <a href="chap1.xhtml#table-1.2">
                  Table 1.2
               </a>
            </li>
         </ol>
      </li>
      …
   </ol>
</nav>

このセクションは非規範的です。

適合するXHTMLコンテンツ文書として、EPUBナビゲーション文書はスパインに含めることができます。

ナビゲーション文書をスパインに追加する場合、文書に対するリーディングシステム処理は適用されないことを考慮してください。特に、EPUBリーディングシステムは、 EPUBナビゲーション文書をスパイン外で提示する場合（リーディングシステムが提供する専用ナビゲーションユーザーインターフェイスなど）には、リスト項目の番号付けを抑制しなければならない [epub-rs-34]ものの、この要件はスパイン内での使用には適用されません。したがって、ナビゲーション文書をスパイン内で提示する際に HTMLの既定のリスト項目番号付けが望ましくない場合、CSSを使用して代替のリストスタイルを提供する必要があります。

同様に、EPUBナビゲーション文書がスパイン内で提示される場合、すべてのナビゲーション構造、またはその中の分岐が必要とは限らないことがよくあります。例えば、ページリストやランドマークナビゲーション要素を非表示にしたり、多くのサブセクション階層を持つ本では目次を切り詰めたりすることが好まれることがよくあります。

このような場合、コンテンツフローでのレンダリングから除外されるナビゲーションデータの部分（もしあれば）を示すために、[html]の hidden 属性を使用することが推奨されます。この属性は効果を持ちません [epub-rs-34]。これは、リーディングシステムがスパイン外でナビゲーション文書をどのようにレンダリングするかには影響しません。

注記

display プロパティ [css2]は、ビューポートを持つリーディングシステムで EPUBナビゲーション文書の視覚的レンダリングを制御しますが、ビューポートを持たないリーディングシステムはCSSをサポートしない可能性があります。 hidden属性は、displayプロパティと併用して、すべてのリーディングシステム間の相互運用性を最大化できます。

例 73: スパイン内でnav要素を非表示にする

この例では、nav要素にhidden属性が存在することにより、文書がスパイン内でレンダリングされる際に、ページリストがコンテンツフローでのレンダリングから除外されることを示します。

<nav
    epub:type="page-list"
    hidden="hidden">
   <h2>Pagebreaks of the print version, third edition</h2>
   <ol>
      <li>
         <a href="frontmatter.xhtml#pi">
            I
         </a>
      </li>
      …
   </ol>
</nav>

例 74: nav要素の分岐を非表示にする

この例では、スパイン内でのレンダリングに不要な分岐（ol要素）に hidden属性が付いています。レンダリング時、これにより目次は最上位2階層に制限されます。

<nav
    epub:type="toc"
    id="toc">
   <h1>Table of contents</h1>
   <ol>
      <li>
         <a href="chap1.xhtml">
            Chapter 1
         </a>
         <ol>
            <li>
               <a href="chap1.xhtml#sec-1.1">
                  Chapter 1.1
               </a>
               <ol hidden="">
                  <li>
                     <a href="chap1.xhtml#sec-1.1.1">
                        Section 1.1.1
                     </a>
                  </li>
                  …
               </ol>
            </li>
            …
         </ol>
      </li>
      …
   </ol>
</nav>

このセクションは非規範的です。

EPUB 3は主に視覚的な読書形式と考えられていますが、EPUB 出版物は、その音声レンダリングを可能にするように設計されています。これを実現する主な方法は2つあります:

EPUB出版物のテキストコンテンツのテキスト読み上げレンダリングを通じて; および
テキストと同期して再生される録音済み音声の提供を通じて。この仕様ではこれをメディアオーバーレイと呼びます。

テキスト読み上げレンダリングを介してEPUB出版物を読む体験は、組み込みの合成音声を使用するユーザーのリーディングシステムによって制御されます。この機能は一般に「読み上げ」機能と呼ばれますが、正確な名称はリーディングシステムごとに異なる場合があります。

EPUB 3リーディングシステムが提供する読み上げ機能は、音声支援を必要とする障害のあるユーザーのアクセシビリティを向上させますが、専用の支援技術（一般にスクリーンリーダーと呼ばれるもの）が提供するテキスト読み上げレンダリングとは同じではありません。読み上げ機能は、別個のアプリケーションとしてではなく、リーディングシステム内に存在するため、すべてのユーザーによる使用を目的として設計されています。例えば、移動中の人が乗り物酔いを避けるために、視覚的読書から聴覚的読書へ切り替える場合があります。どちらの種類のテキスト読み上げレンダリングもユーザーのシステム上に存在でき、どちらもEPUB出版物の読書に使用できますが、この仕様はリーディングシステムが提供する組み込み機能のみに焦点を当てています。

一方、メディアオーバーレイは、EPUB出版物の制作者が音声を提供し、それをテキストと同期させることに依存します。メディアオーバーレイにより、EPUB出版物はより伝統的なオーディオブックとしても機能できますが、音声が再生されている間、ユーザーがテキストを読みながら追えるという利点があります。

メディアオーバーレイは通常、プロによるナレーションを提供するために使用されますが、これは慣例にすぎません。コンテンツのテキスト読み上げ再生も録音してメディアオーバーレイで同期できますし、人間の音声と合成音声が混在することもよくあります（例えば、本文は人間によるナレーション、後付けは人間が読むには退屈で時間がかかるため合成ナレーションにするなど）。また、メディアオーバーレイを使用して、リーディングシステムが関連するテキストを読むためにそのテキスト読み上げ機能を使用するよう指定することも可能ですが、実際にはこの機能は十分にはサポートされていません。

メディアオーバーレイ再生とテキスト読み上げ再生は、相互に排他的な機能ではありません。メディアオーバーレイを介して録音済みナレーションを含むEPUB出版物であっても、ユーザーは自分のリーディングシステムの読み上げ機能を使用して読むことができます。

このセクションは非規範的です。

現在、テキスト読み上げ再生の品質を向上させるために広くサポートされている技術はありません。 EPUB 3の当初の設計では、3つの技術を利用することを意図していました:

SSML [ssml] — SSMLに基づく2つの属性が、インラインの単語発音に追加されました。
発音辞書 [pronunciation-lexicon] — 発音の辞書をEPUB出版物に含めることを可能にします。
CSS Speech [css-speech] — CSSクラスおよびスタイルシートを通じて音声再生制御を提供します。

これらの技術の将来は不確かですが、いずれもEPUB出版物で使用することは有効です。 EPUB SSML属性は、EPUB 3の現在の目標が可能な限りウェブでサポートされる技術を使用することであるため、サポートされるようになる可能性が最も低いものです。ウェブに適した方法でSSMLサポートを追加する作業が広く受け入れられれば、これらの属性の後継となる可能性があります。発音辞書は限定的かつ地域的なサポートしか得られていません。また、将来の作業によってCSS Speechがより限定的な形で復活する可能性もありますが、これも作業中です。

注記

これらの技術およびEPUB 3での使用方法の詳細については、 EPUB 3 Text-to-Speech Enhancements 1.0 [epub-tts-10]を参照してください。

このセクションは、これらまたは他の技術がEPUB出版物で広く利用可能になるたびに更新されます。

現時点で、リーディングシステムにおけるテキスト読み上げ再生を改善するための最善の助言は、 EPUB出版物が[epub-a11y-12]に従ってアクセシブルであることを確保することです。これにより、構造とセマンティクスが再生時にリーディングシステムを支援できるようになり、視覚的コンテンツを認識できないユーザーのためにテキスト代替が利用可能になります。

このセクションは非規範的です。

一般向け電子書籍、教育用ツール、および印刷物を読むことに困難のある人向けに整形された電子書籍は、同期された音声ナレーションを含む作品の例です。EPUB 3では、これらの種類の本は、録音済み音声ナレーションのタイミングと、それがEPUBコンテンツ文書のマークアップにどのように関連するかを記述するメディアオーバーレイ文書を使用して作成できます。この仕様は、メディアオーバーレイのファイル形式を、XMLで同期マルチメディア情報を表現するためのW3C勧告である[smil3]のサブセットとして定義します。

メディアオーバーレイによって可能になるテキストと音声の同期は、従来の本のテキストを追うことが難しいすべてのユーザーに対してアクセシビリティを高めます。メディアオーバーレイはまた、何らかの理由でテキストを読むことができない読者に対して、従来の音声埋め込み技法では提供できない連続した聴取体験を提供します。これは、従来アクセシビリティ上の関心事とはみなされていない目的（例えば語学学習）にも有用です。

メディアオーバーレイ機能は、この機能をサポートしないEPUB リーディングシステムに対して透過的です。EPUB 出版物にメディアオーバーレイを含めても、メディアオーバーレイを認識しないリーディングシステムが、メディアオーバーレイが存在しないかのようにEPUB出版物をレンダリングする能力には影響しません。

EPUBにおけるメディアオーバーレイはオーディオブックと同等ではありません。オーディオブックは主に音声ベースであり、テキストは代替形式として時折提供されるためです。W3Cの[audiobooks] 勧告は、音声出版物を構築するためのものです。

この仕様の将来のバージョンでは動画メディアのサポート（例えば、同期テキスト/手話本）を取り入れる可能性がありますが、このバージョンでは音声メディアとEPUBコンテンツ文書の同期のみをサポートします。

メディアオーバーレイ文書は:

F.3 メディアオーバーレイスキーマで定義されるメディアオーバーレイスキーマに対して有効であり、9.3.2.2 メディアオーバーレイ文書定義で表現されるすべてのコンテンツ適合制約に適合しなければMUSTなりません。
複数の EPUBコンテンツ文書を参照してもMAYよいですが、複数のメディアオーバーレイ文書が同じ EPUBコンテンツ文書を参照してはMUST NOTなりません。

このセクションで定義されるすべての要素 [xml]は、別途指定がない限り http://www.w3.org/ns/SMIL名前空間 [xml-names]にあります。

smil要素は、メディアオーバーレイ文書内のすべての情報を包含します。

要素名:

smil

使用法:

メディアオーバーレイ文書のREQUIREDなルート要素 [xml]。

属性:

version [必須]

メディアオーバーレイ文書が準拠する[smil3] 仕様のバージョン番号を指定します。

この属性は値「3.0」を持たなければMUSTなりません。

id [任意]

要素のID [xml]。文書スコープ内で一意でなければMUSTなりません。

epub:prefix [任意]

追加のメタデータ語彙接頭辞を宣言します。

詳細については、9.3.3.3 オーバーレイにおける構造セマンティクスを参照してください。

内容モデル:

この順序で:

head [0または1]
body [ちょうど1つ]

head要素は、メディアオーバーレイ文書内のメタデータのコンテナーです。

要素名:: head
使用法:: head要素は、 smil 要素のOPTIONALな最初の子です。
属性:: なし
内容モデル:: metadata [0または1]

この仕様は、メディアオーバーレイ文書内に現れなければならないメタデータプロパティを定義しないため、 head要素はOPTIONALです。

metadata要素は、メディアオーバーレイ文書のメタデータを表します。 metadata要素は、任意のメタ情報構造化言語からメタデータを含めることを可能にする拡張ポイントです。

要素名:: metadata
使用法:: head 要素の子として。
属性:: なし
内容モデル:: 任意の名前空間の要素[0個以上]

この仕様は、メディアオーバーレイ文書内のいかなるメタデータプロパティも要求しません。 metadata要素はカスタムメタデータ要件のために提供されます。

body要素は、メディアオーバーレイ文書に含まれるプレゼンテーションの開始点です。これは par および seq 要素の主シーケンスを含みます。

要素名:

body

使用法:

body要素は、 smil 要素のREQUIREDな子です。それは、 head 要素が存在する場合、その要素に続きます。

属性:

epub:type [任意]

対応するEPUB コンテンツ文書内の要素の構造セマンティクスの表現。

値は、空白区切りのコンパクトURLの一覧です。詳細については、9.3.3.3 オーバーレイにおける構造セマンティクスを参照してください。

id [任意]

要素のID [xml]。文書スコープ内で一意でなければMUSTなりません。

epub:textref [任意]

関連するEPUBコンテンツ文書を参照し、任意でその特定の部分を識別します。

値は、path-relative-scheme-less-URL stringでなければMUSTならず、任意で U+0023 (#)とURL-fragment stringが続きます。

内容モデル:

任意の順序で:

seq [0個以上]
par [0個以上]

少なくとも1つのparまたは seqを含まなければMUSTなりません。

seq要素は、メディアオブジェクトおよび/または子時間コンテナーのための順次時間コンテナーです。

要素名:

seq

使用法:

1つ以上のseq要素は、 body 要素および seq 要素の子として出現してもMAYよいです。

属性:

epub:type [任意]

対応するEPUB コンテンツ文書内の要素の構造セマンティクスの表現。

値は、空白区切りのコンパクトURLの一覧です。詳細については、9.3.3.3 オーバーレイにおける構造セマンティクスを参照してください。

id [任意]

要素のID [xml]。文書スコープ内で一意でなければMUSTなりません。

epub:textref [必須]

関連するEPUBコンテンツ文書を参照し、任意でその特定の部分を識別します。

値は、path-relative-scheme-less-URL stringでなければMUSTならず、任意で U+0023 (#)とURL-fragment stringが続きます。

詳細については、9.3.3.2.1 オーバーレイ構造を参照してください。

内容モデル:

任意の順序で:

seq [0個以上]
par [0個以上]

少なくとも1つのparまたは seqを含まなければMUSTなりません。

par要素は、メディアオブジェクトのための並列時間コンテナーです。

要素名:

par

使用法:

1つ以上のpar要素は、 body および seq 要素の子として出現してもMAYよいです。

属性:

epub:type [任意]

対応するEPUB コンテンツ文書内の要素の構造セマンティクスの表現。

値は、空白区切りのコンパクトURLの一覧です。詳細については、9.3.3.3 オーバーレイにおける構造セマンティクスを参照してください。

id [任意]

要素のID [xml]。文書スコープ内で一意でなければMUSTなりません。

内容モデル:

任意の順序で:

text [ちょうど1つ]
audio [0または1]

text要素は、EPUBコンテンツ文書内の要素を参照します。 text要素は通常、テキスト要素を参照しますが、他の EPUBコンテンツ文書メディア要素を参照することもできます。兄弟の audio 要素が存在しない場合、リーディングシステムは、この要素によって参照されるテキストコンテンツをテキスト読み上げによってレンダリングすることが期待されます。

要素名:

text

使用法:

par 要素のREQUIREDな子として。

属性:

src [必須]

関連するEPUBコンテンツ文書を参照し、任意でその特定の部分を識別します。

値は、path-relative-scheme-less-URL stringでなければMUSTならず、任意で U+0023 (#)とURL-fragment stringが続きます。

id [任意]

要素のID [xml]。文書スコープ内で一意でなければMUSTなりません。

内容モデル:

空

注記

この仕様は、text要素のsrc属性に制限を課しませんが、スタイル情報との関連付けを有効にするため、CSSでスタイル付け可能なコンテンツを参照することが推奨されます。XHTMLの場合、これは知覚可能コンテンツを参照することを意味します。 SVGの場合、これはパス、基本図形、またはテキスト要素を参照することを意味します。

注記

[epub-rs-34]は、時間指定メディアの再生（すなわち、参照されたメディアの自動開始）について、リーディングシステム向けのガイダンスをもはや提供していません。text要素のsrc属性は、埋め込まれた時間指定メディア（例えば、[html] video 要素を介したもの）を参照できますが、そのようなメディアの参照は予測できない結果をもたらす可能性があります。

audio要素は、音声メディアのクリップを表します。

要素名:

audio

使用法:

par 要素のOPTIONALな子。

属性:

id [任意]

要素のID [xml]。文書スコープ内で一意でなければMUSTなりません。

src [必須]

音声ファイルへのrelative-またはabsolute-URL string [url]参照。音声ファイルはコアメディア型リソース表に列挙されている音声形式のいずれかでなければMUSTなりません。

可変ビットレートでエンコードされたMP3（audio/mpeg）音声ファイル [mp3]は、シーク精度が一般に音声トラックの長さと反比例するため、正確なシークにはあまり適していません。したがって、可変ビットレートMP3音声はメディアオーバーレイに使用すべきではSHOULD NOT ありません。

clipBegin [任意]

音声クリップの開始点に対応する、物理メディア内のオフセットを指定するクロック値。

[smil3]のクロック値でなければMUSTなりません。

A.4 クロック値を参照してください。

clipEnd [任意]

音声クリップの終了点に対応する、物理メディア内のオフセットを指定するクロック値。

[smil3]のクロック値でなければMUSTなりません。

A.4 クロック値を参照してください。

終了位置の時間的オフセットは、clipBegin属性で指定された開始オフセットより後でなければMUSTなりません。

内容モデル:

空

このセクションは非規範的です。

出版物の録音済みナレーションは、一連の音声クリップとして表現できます。各クリップは EPUBコンテンツ文書の一部に対応します。例えば、単一の音声クリップは通常、単一の句または段落を表しますが、他のクリップや文書内のテキストに対する順序は推論しません。メディアオーバーレイは、[smil3] マークアップを使用して、構造化された音声ナレーションをEPUBコンテンツ文書内の対応するテキスト（または他のメディア）に結び付けることで、この同期の問題を解決します。実際、メディアオーバーレイは SMIL 3.0の簡略化されたサブセットであり、これらのクリップの再生シーケンスを定義します。

メディアオーバーレイの構造化に主に使用されるSMIL要素は、 body （主シーケンスに使用）、 seq （シーケンス）および par （並列）です。（これらおよび他のSMIL要素の詳細については、9.3.2.2 メディアオーバーレイ文書定義を参照してください。）

par要素はメディアオーバーレイの基本構成要素であり、EPUBコンテンツ文書内の句に対応します。この要素は、コンテンツを同期するための2つの重要な情報を提供します: 1) その句のナレーションを含む音声クリップ; および 2) 関連するEPUBコンテンツ文書フラグメントへのポインター。par要素は、この情報を表すために2つのメディア要素の子を使用します: audio 要素および text 要素です。par要素のメディアオブジェクトの子は並列に時間指定されるため、リーディングシステムは音声クリップとEPUBコンテンツ文書フラグメントを同時にレンダリングし、同期されたプレゼンテーションをもたらします。

text要素のsrc属性は、関連する句、文、またはEPUBコンテンツ文書のその他のセグメントをURL [url]参照によって参照します。 audio要素のsrc属性も同様に、対応する音声クリップの場所を参照し、クリップ内の特定のオフセットを示すためにclipBeginおよびclipEnd属性を追加します。

例 75: 単一の句または文に対するメディアオーバーレイマークアップ

<par>
   <text
       src="chapter1.xhtml#sentence1"/>
   <audio
       src="chapter1_audio.mp3"
       clipBegin="23s"
       clipEnd="30s"/>
</par>

par要素は、句や文の系列を形成するために順次まとめて配置されます。 EPUBコンテンツ文書のすべての要素がメディアオーバーレイ文書内に対応する par要素を持つわけではなく、音声ナレーションに関連するものだけが持ちます。

例 76: 句のシーケンスを含む基本的なメディアオーバーレイ文書

この例では、body要素が文書全体の主シーケンスとして機能します。

<smil
    xmlns="http://www.w3.org/ns/SMIL"
    version="3.0">
   <body>
      <par id="par1">
         <text
             src="chapter1.xhtml#sentence1"/>
         <audio
             src="chapter1_audio.mp3"
             clipBegin="0s"
             clipEnd="10s"/>
      </par>
      <par id="par2">
         <text
             src="chapter1.xhtml#sentence2"/>
         <audio
             src="chapter1_audio.mp3"
             clipBegin="10s"
             clipEnd="20s"/>
      </par>
      <par id="par3">
         <text
             src="chapter1.xhtml#sentence3"/>
         <audio
             src="chapter1_audio.mp3"
             clipBegin="20s"
             clipEnd="30s"/>
      </par>
   </body>
</smil>

par要素は、部や章など、より複雑な構造を定義するためにseq要素に追加することもできます（9.3.3.2.1 オーバーレイ構造を参照）。

注記

このセクションでは、EPUBコンテンツ文書は XHTMLコンテンツ文書であると仮定します。メディアオーバーレイはSVGコンテンツ文書とともに使用できますが、再生動作は一貫しない可能性があり、したがって相互運用性は保証されません。

リフロー可能および固定レイアウトのEPUBコンテンツ文書の両方について、リーディングシステムの再生サポートは保証されません。リーディングシステムのページ分割戦略の違いにより、一部のリーディングシステムは、いずれか一方のレイアウト形式でのみメディアオーバーレイをサポートする場合があります。

メディアオーバーレイ文書の body は、2つの要素で構成されます: par 要素および seq 要素です。これらの要素の順序は、再生中にリーディングシステムが対応する EPUBコンテンツ文書内のコンテンツをどのようにレンダリングするかを表します。

par要素は、単語、句、文、表のセル、リスト項目、画像、またはマークアップ内のその他の識別可能なコンテンツ片など、コンテンツのセグメントを表します。各要素は、再生中に表示するコンテンツ（ text 要素内）と、同期する音声（ audio 要素内）の両方を識別します。

seq要素はシーケンスを表します — コンテンツの論理コンポーネントをまとめて表す seqおよび/または par要素の集合です。この要素は、セクション、傍注、ヘッダー、表、リスト、脚注などのネストされたコンテナーを表すために使用されます。これにより、これらのコンテナーに固有の構造をメディアオーバーレイ文書内に保持できます。

seq要素はepub:textref属性を含まなければMUSTなりません。 seq要素は同期指示を提供しないため、この属性によりリーディングシステムはフラグメントをテキスト内の場所に対応付けることができます。

注記

セクション、図、表、脚注などの構造をseq要素でグループ化する理由は、リーディングシステムが再生中にそれらの開始位置と終了位置を識別できるようにするためです。その後、リーディングシステムは、長い図を飛ばす、改ページ告知のレンダリングをオフにする（9.3.4 スキップ可能性とエスケープ可能性を参照）、または表などの構造に適した読書モードをカスタマイズするなど、コンテンツのレイアウトに合わせた再生オプションを提供できます。

例 77: ネストされたseq要素を持つメディアオーバーレイ文書

この例は、セクション見出しと図の両方を持つ章を示します。

メディアオーバーレイ文書:

<smil
    xmlns="http://www.w3.org/ns/SMIL"
    xmlns:epub="http://www.idpf.org/2007/ops"
    version="3.0">
   <body>

      <!-- a chapter -->

      <seq
          id="id1"
          epub:textref="chapter1.xhtml#sectionstart"
          epub:type="chapter">

         <!-- the section title -->

         <par id="id2">
            <text
                src="chapter1.xhtml#section1_title"/>
            <audio
                src="chapter1_audio.mp3"
                clipBegin="0:23:23.84"
                clipEnd="0:23:34.221"/>
         </par>

         <!-- some sentences in the chapter -->

         <par id="id3">
            <text
                src="chapter1.xhtml#text1"/>
            <audio
                src="chapter1_audio.mp3"
                clipBegin="0:23:34.221"
                clipEnd="0:23:59.003"/>
         </par>
         <par id="id4">
            <text
                src="chapter1.xhtml#text2"/>
            <audio
                src="chapter1_audio.mp3"
                clipBegin="0:23:59.003"
                clipEnd="0:24:15.000"/>
         </par>

         <!-- a figure -->

         <seq
             id="id7"
             epub:textref="chapter1.xhtml#figure">
            <par id="id8">
               <text
                   src="chapter1.xhtml#photo"/>
               <audio
                   src="chapter1_audio.mp3"
                   clipBegin="0:24:18.123"
                   clipEnd="0:24:28.764"/>
            </par>
            <par id="id9">
               <text
                   src="chapter1.xhtml#caption"/>
               <audio
                   src="chapter1_audio.mp3"
                   clipBegin="0:24:28.764"
                   clipEnd="0:24:50.010"/>
            </par>
         </seq>

         <!-- more sentences in the chapter (outside the figure) -->

         <par id="id12">
            <text
                src="chapter1.xhtml#text3"/>
            <audio
                src="chapter1_audio.mp3"
                clipBegin="0:25:45.515"
                clipEnd="0:26:30.203"/>
         </par>
         <par id="id13">
            <text
                src="chapter1.xhtml#text4"/>
            <audio
                src="chapter1_audio.mp3"
                clipBegin="0:26:30.203"
                clipEnd="0:27:15.000"/>
         </par>
      </seq>
   </body>
</smil>

XHTMLコンテンツ文書:

<html …>
   <head>
      <title>
         Media Overlays Example of
         EPUB content document
      </title>
   </head>
   <body id="sec1">
      <section
          id="sectionstart"
          epub:type="chapter">

         <h1 id="section1_title">
            The Section Title
         </h1>

         <p id="text1">
            The first phrase of the main text body.
         </p>

         <p id="text2">
            The second phrase of the main text body.
         </p>

         <figure id="figure">
            <img id="photo"
                src="photo.png"
                alt="a photograph for which there is a caption" />

            <figcaption id="caption">
               The photo caption
            </figcaption>
         </figure>

         <p id="text3">
            The third phrase of the main text body.
         </p>

         <p id="text4">
            The fourth phrase of the main text body.
         </p>
      </section>
   </body>
</html>

epub:textref属性および text 要素のsrc 属性はどちらも、関連するEPUBコンテンツ文書の特定の部分（例えば、 IDによる要素）を参照するURL-fragment stringを含むことができます。

XHTMLおよびSVGコンテンツ文書については、URL-fragment stringは、それぞれIDによる特定の要素への参照、またはSVG Fragment Identifier [svg]であるべきですSHOULD。

他のフラグメント識別子スキームを使用してもMAYよいですが、リーディングシステムはそのような識別子をサポートしない可能性があります。

このセクションは非規範的です。

メディアオーバーレイの粒度レベルは、EPUBコンテンツ文書がどのようにマークアップされているか、および text 要素のsrc属性と seq 要素のepub:textref 属性で使用されるフラグメント識別子の種類に依存します。例えば、[html]要素を参照する場合、マークアップの最も細かいレベルが段落レベルであれば、それがメディアオーバーレイ同期の可能な最小レベルになります。同様に、句や文を表す[html] span 要素など、段落より細かいマークアップが利用可能であれば、メディアオーバーレイではより細かい粒度が可能です。より細かい粒度は、単語または句単位で移動するときやテキスト検索時に、同期再生のより正確な結果をユーザーに提供しますが、メディアオーバーレイ文書のファイルサイズを増加させます。要素の存在に依存しないフラグメント識別子スキームは、サポートされる場合、さらに細かい粒度を提供できる可能性があります。

この仕様は、録音済み音声クリップに加えて、テキスト読み上げ（TTS）— EPUB出版物のテキストコンテンツを合成音声を使用した人工的な人間の発話としてレンダリングすること — の使用を認めます。

メディアオーバーレイの par 要素がその audio 要素を省略する場合、その text 要素はリーディングシステムでTTSを介してレンダリングできます。テキストフラグメントがTTSレンダリングに適していない場合（例えば、テキスト要素ではない、かつ/またはテキストフォールバックがない場合）、予期しない結果を生じる可能性があります。

注記

EPUB出版物でTTS技術を使用する方法の詳細については、EPUB 3 Text-to-Speech Support [epub-tts-10]を参照してください。

メディアオーバーレイ文書で構造セマンティクスを表現するために、 epub:type 属性を par、 seq、および body 要素に指定してもMAYよいです。

epub:type属性は、示されたセマンティック種別に適したリーディングシステムの動作を促進します。これらの動作の例には、スキップ可能性とエスケープ可能性、および表読書モード [epub-rs-34]があります。

メディアオーバーレイ文書は、追加のセマンティクスを定義するために、epub:type属性に適用可能な語彙関連付けメカニズムを使用してもMAYよいです。

例 78: 図を含むメディアオーバーレイ文書のセマンティックマークアップ

<smil
    xmlns="http://www.w3.org/ns/SMIL"
    xmlns:epub="http://www.idpf.org/2007/ops"
    version="3.0">
   <body>
      <seq
          id="id1"
          epub:textref="chapter1.xhtml#figure"
          epub:type="figure">
         <par id="id2">
            <text
                src="chapter1.xhtml#figuretitle"/>
            <audio
                src="chapter1_audio.mp3"
                clipBegin="0:24:15.000"
                clipEnd="0:24:18.123"/>
         </par>
         <par id="id3">
            <text
                src="chapter1.xhtml#figurecaption"/>
            <audio
                src="chapter1_audio.mp3"
                clipBegin="0:24:18.123"
                clipEnd="0:24:38.530"/>
         </par>
         <par id="id4">
            <text
                src="chapter1.xhtml#figuretext1"/>
            <audio
                src="chapter1_audio.mp3"
                clipBegin="0:24:38.530"
                clipEnd="0:25:00.515"/>
         </par>
      </seq>
   </body>
</smil>

現在再生中のEPUBコンテンツ文書要素に対する視覚的レンダリング情報は、作成者定義クラスを使用してCSSスタイルシートで表現してもMAYよいです。

使用する場合、クラス名はパッケージ文書内で、 active-classおよびplayback-active-classプロパティを使用して宣言されなければMUSTなりません。

各プロパティで定義されるCSSクラス名はちょうど1つでなければMUSTなりません。各プロパティは、セレクターを含まない有効なCSSクラス名 [css2]を定義しなければMUSTなりません。この仕様は、これらのプロパティで使用する名前を 予約しません。

指定されたCSSクラスに対して任意のCSSプロパティを定義してもMAYよいです。関連付けられたメディアオーバーレイ文書を持つ各EPUBコンテンツ文書は、クラス定義を含むCSSスタイルシート（埋め込みまたはリンク）を含める必要があります。そのような定義が存在しない場合、リーディングシステムは独自のスタイルを提供するか、まったくスタイルを提供しない可能性があります。

active-classおよびplayback-active-classプロパティは、常にEPUB出版物全体に適用されるため、refines属性と併用してはMUST NOTなりません。

例 79: 現在再生中のEPUBコンテンツ文書へのスタイル情報の関連付け

作成者定義のCSSクラス名は、パッケージ文書内でメタデータプロパティactive-classおよびplayback-active-classを使用して宣言されます:

<package …>
   <metadata …>
      …
      <meta
          property="media:active-class">
         my-active-item
      </meta>
      <meta
          property="media:playback-active-class">
         my-document-playing
      </meta>
      …
   </metadata>
   …
</package>

作成者定義のクラス名を含むCSSスタイルシート:

/* emphasize the active element */
.my-active-item {
    background-color: yellow;
    color: black !important;
}

/* fade out the inactive text */
html.my-document-playing * {
    color: gray;
}

関連するEPUBコンテンツ文書の抜粋:

<html>
   …
   <body>
      …
      <span id="txt1">
         This is the first phrase.
      </span>
      <span id="txt2">
         This is the second phrase.
      </span>
      <span id="txt3">
         This is the third phrase.
      </span>
      …
   </body>
</html>

この例では、リーディングシステムは、EPUBコンテンツ文書内の各テキスト要素が再生中にアクティブになるにつれて、作成者定義のmy-active-itemクラスを適用します。逆に、要素がアクティブでなくなると、リーディングシステムはクラス名を削除します。ユーザーには、その要素の再生中、各EPUBコンテンツ文書要素が黄色の背景でスタイル付けされて見えます。

リーディングシステムはまた、メディアオーバーレイの再生が開始されると、作成者定義の my-document-playingクラスをEPUBコンテンツ文書の文書要素に適用します。再生が停止すると、リーディングシステムはそのクラス名を削除します。XHTMLコンテンツ文書の場合、リーディングシステムはクラス名を html 要素 [html]に適用します。SVGコンテンツ文書の場合、リーディングシステムはクラス名を svg 要素 [svg]に適用します。ユーザーには、メディアオーバーレイ再生中、非アクティブなすべてのテキスト要素が灰色になるのが見えます。再生が停止すると、要素の色は既定値に戻ります。

EPUBコンテンツ文書がメディアオーバーレイ文書によって全体または一部を参照される場合、そのマニフェスト item 要素は media-overlay属性を指定しなければMUSTなりません。この属性は、対応するメディアオーバーレイ文書のマニフェストitemの ID [xml]を参照しなければMUSTなりません。

media-overlay属性は、EPUBコンテンツ文書のマニフェスト item要素にのみ指定されなければMUSTなりません。

メディアオーバーレイ文書のマニフェスト項目は、メディア型 application/smil+xmlを持たなければMUSTなりません。

例 80: パッケージ文書マニフェスト内のEPUBコンテンツ文書およびその関連メディアオーバーレイ文書のエントリー

<package …>
   …
   <manifest>
      <item
          id="ch1"
          href="chapter1.xhtml"
          media-type="application/xhtml+xml"
          media-overlay="ch1_audio"/>

      <item
          id="ch1_audio"
          href="chapter1_audio.smil"
          media-type="application/smil+xml"/>
      …
   </manifest>
</package>

EPUB出版物全体の長さは、パッケージ文書内で、 durationプロパティを持つ meta 要素を使用して指定されなければMUSTなりません。

さらに、各メディアオーバーレイ文書の長さは、各duration宣言を対応するマニフェスト itemに関連付けるため、refines属性を使用して提供されなければMUSTなりません。

各メディアオーバーレイ文書の長さの合計は、総再生時間とプラスマイナス1秒以内で等しくなるべきですSHOULD。

注記

個別の長さの合計は、時刻を最も近い秒の小数部分に丸めるため、総再生時間と正確に一致しない場合がありますが、 1秒を超える差は、他の問題に起因する不一致を示します。

ナレーター情報も、narratorプロパティを使用してパッケージ文書に指定してもMAYよいです。現在再生中の EPUBコンテンツ文書要素に適用する作成者定義のCSSクラス名も指定できます。

注記

media:接頭辞は、これらのプロパティをパッケージメタデータに含めるために予約されています。

例 81: パッケージ文書内のメディアオーバーレイメタデータ

<package …>
   <metadata …>
      …
      <meta
          property="media:duration"
          refines="#ch1_audio">
         0:32:29
      </meta>

      <meta
          property="media:duration"
          refines="#ch2_audio">
         0:34:02
      </meta>

      <meta
          property="media:duration"
          refines="#ch3_audio">
         0:29:49
      </meta>

      <meta
          property="media:duration">
         1:36:20
      </meta>

      <meta
          property="media:narrator">
         Joe Speaker
      </meta>

      <meta
          property="media:active-class">
         my-active-item
      </meta>

      <meta
          property="media:playback-active-class">
         my-document-playing
      </meta>
      …
   </metadata>
</package>

読書中、ユーザーは脚注、ページ番号、またはその他の種類の二次コンテンツなど、コンテンツの特定の機能をオンまたはオフにしたい場合があります。この機能はスキップ可能性と呼ばれます。リーディングシステムは、メディアオーバーレイ要素のepub:type属性が提供するセマンティック情報を使用して、スキップ可能な機能のオプションをユーザーにいつ提示するかを判断します。

次のセマンティクスは、スキップ可能性を有効にするために使用してもMAYよいです:

ただし、この一覧は網羅的ではありません。これは、構造セマンティクス語彙 [epub-ssv-11]の用語のうち、リーディングシステムがスキップ可能性のオプションを提供する可能性が最も高いものを表しています。

例 82: 改ページを持つメディアオーバーレイ文書

この例では、リーディングシステムは、聞くのが煩雑になりがちな改ページ/ページ番号の告知をオンまたはオフにするオプションをユーザーに提供できます。

メディアオーバーレイ文書:

<smil
    xmlns="http://www.w3.org/ns/SMIL"
    xmlns:epub="http://www.idpf.org/2007/ops"
    version="3.0">
   <body>
      <!-- a paragraph -->
      <par id="id1">
         <text
             src="chapter1.xhtml#para1"/>
         <audio
             src="chapter1_audio.mp3"
             clipBegin="0:23:22.000"
             clipEnd="0:24:15.000"/>
      </par>

      <!-- a page number -->
      <par
          id="id2"
          epub:type="pagebreak">
         <text
             src="chapter1.xhtml#pgbreak1"/>
         <audio
             src="chapter1_audio.mp3"
             clipBegin="0:24:15.000"
             clipEnd="0:24:18.123"/>
      </par>

      <!-- another paragraph -->
      <par id="id3">
         <text
             src="chapter1.xhtml#para2"/>
         <audio
             src="chapter1_audio.mp3"
             clipBegin="0:24:18.123"
             clipEnd="0:25:28.530"/>
      </par>
   </body>
</smil>

EPUBコンテンツ文書:

<html … >
   …
   <body>
      <p id="para1">
         This is the paragraph before the page break …
      </p>

      <span
          id="pgbreak1"
          role="doc-pagebreak"
          aria-label="14"/>

      <p id="para2">
         This is the paragraph after the page break …
      </p>
   </body>
</html>

エスケープ可能項目とは、表やリストなど、ユーザーが飛ばして、ネストされた構造の直後の位置から読書を続けたいと思う可能性があるネストされた構造です。エスケープ可能性機能は、項目の種類全体を有効または無効にするのではなく、そこから抜け出す手段を提供する点で、スキップ可能性機能とは異なります（例えば、ユーザーは一部のコンテンツを聞いてからエスケープすることを選択できます）。

次のセマンティクスは、エスケープ可能性を有効にするために使用してもMAYよいです:

table [epub-ssv-11]
list [epub-ssv-11]
figure [epub-ssv-11]
aside [epub-ssv-11]

ただし、この一覧は網羅的ではありません。これは、構造セマンティクス語彙 [epub-ssv-11]の用語のうち、リーディングシステムがエスケープ可能性のオプションを提供する可能性が最も高いものを表しています。

注記

エスケープ可能な構造がエスケープ可能な構造を含む場合があります。例えば、表は多くの行とセルで構成されており、ユーザーはそれらから個別にエスケープしたい場合があります。そのような構造からエスケープするためのリーディングシステムのサポートは複雑であり、現時点では十分にサポートされていません。より良いサポートが利用可能になるまでは、ネストされたエスケープ可能構造を識別することは避けることが推奨されます。

例 83: エスケープ可能な構造

この例では、EPUBコンテンツ文書のメディアオーバーレイ文書が、段落、表、および別の段落を含んでいます。エスケープ可能性をサポートするリーディングシステムは、ユーザーに表の再生を中断して次の段落の再生を続けるオプションを提供できます。

<smil
    xmlns="http://www.w3.org/ns/SMIL"
    xmlns:epub="http://www.idpf.org/2007/ops"
    version="3.0">
   <body>
      <!-- a paragraph, part of the regular document text -->
      <par id="id1">
         <text
             src="c01.xhtml#para1"/>
         <audio
             src="chapter1_audio.mp3"
             clipBegin="0:23:22.000"
             clipEnd="0:24:15.000"/>
      </par>

      <!-- a table with two nested rows -->
      <seq
          id="id2"
          epub:textref="c01.xhtml#t1"
          epub:type="table">

         <seq
             id="id3"
             epub:textref="c01.xhtml#tr1"
             epub:type="table-row">

            <par
                id="id4"
                epub:type="table-cell">
               <text
                   src="c01.xhtml#td1"/>
               <audio
                   src="chapter1_audio.mp3"
                   clipBegin="0:24:15.000"
                   clipEnd="0:24:18.123"/>
            </par>

            <par
                id="id5"
                epub:type="table-cell">
               <text
                   src="c01.xhtml#td2"/>
               <audio
                   src="chapter1_audio.mp3"
                   clipBegin="0:24:18.123"
                   clipEnd="0:25:28.530"/>
            </par>

            <par
                id="id6"
                epub:type="table-cell">
               <text
                   src="c01.xhtml#td3"/>
               <audio
                   src="chapter1_audio.mp3"
                   clipBegin="0:25:28.530"
                   clipEnd="0:25:45.515"/>
            </par>
         </seq>

         <seq
             id="id7"
             epub:textref="c01.xhtml#tr2"
             epub:type="table-row">

            <par
                id="id8"
                epub:type="table-cell">
               <text
                   src="c01.xhtml#td4"/>
               <audio
                   src="chapter1_audio.mp3"
                   clipBegin="0:25:45.515"
                   clipEnd="0:26:45.700"/>
            </par>

            <par
                id="id9"
                epub:type="table-cell">
               <text
                   src="chapter1.xhtml#td5"/>
               <audio
                   src="chapter1_audio.mp3"
                   clipBegin="0:26:45.700"
                   clipEnd="0:28:02.033"/>
            </par>

            <par
                id="id10"
                epub:type="table-cell">
               <text
                   src="chapter1.xhtml#td6"/>
               <audio
                   src="chapter1_audio.mp3"
                   clipBegin="0:28:02.033"
                   clipEnd="0:28:52.207"/>
            </par>
         </seq>
      </seq>

      <!-- another paragraph -->
      <par id="id11">
         <text
             src="c01.xhtml#para2"/>
         <audio
             src="chapter1_audio.mp3"
             clipBegin="0:28:52.207"
             clipEnd="0:30:01.000"/>
      </par>
   </body>
</smil>

このセクションは非規範的です。

EPUBナビゲーション文書はXHTMLコンテンツ文書であるため、メディアオーバーレイ文書をそれに関連付けることができます。ただし、従来のXHTMLコンテンツ文書とは異なり、リーディングシステムは、EPUBナビゲーション文書がスパインに含まれていない場合でも、ユーザーに提示しなければなりません（ナビゲーション文書処理 [epub-rs-34]を参照）。その結果、関連付けられたメディアオーバーレイの動作方法は、コンテキストによって変わる可能性があります:

スパインに含まれている場合、EPUBナビゲーション文書のメディアオーバーレイ文書の再生は、他のXHTMLコンテンツ文書と同じ適合要件に従います。
ユーザーがリンクにアクセスして有効化できるプレゼンテーションコンテキストで公開される場合、リーディングシステムは、ユーザーがナビゲーションリンクにアクセスしたときに音声フィードバックを公開する追加のプレゼンテーション動作を実装できます。

注記

具体的な実装の詳細は、この仕様の範囲外です。DAISY Media Overlays Playback Requirements文書は、作成のベストプラクティスを説明し、リーディングシステム開発者への推奨事項を提供しています。

このセクションは非規範的です。

パッケージ文書とXHTMLコンテンツ文書の次の抜粋を考えてください:

<package …>
    <metadata …>
        …
        <link rel="record"
            href="meta/data.xml"
            media-type="application/marc"/>
        <link rel="record"
            href="https://www.example.org/meta/data2.xml"
            media-type="application/marc"/>
        …
    </metadata>
    <manifest>
        …
        <item id="page"
            href="page.xhtml"
            media-type="application/xhtml+xml"/>
        <item id="nav"
            href="nav.xhtml"
            media-type="application/xhtml+xml"
            properties="nav"/>
        <item id="style"
            href="style.css"
            media-type="text/css"/>
        <item id="font_otf"
            href="fonts/font-file.otf"
            media-type="font/otf"/>
        <item id="font_otf_remote"
            href="https://www.example.org/fonts/font-file2.otf"
            media-type="font/otf"/>
        <item id="font_cff"
            href="fonts/font-file.cff"
            media-type="font/sfnt"/>
        <item id="pls"
            href="speech/cmn.pls"
            media-type="application/pls+xml"/>
        <item id="image_1"
            href="media/image_1.png"
            media-type="image/png"/>
        <item id="image_2"
            href="media/image_2.png"
            media-type="image/png"
            fallback="image_desc"/>
        <item id="image_desc"
            href="image_desc.xhtml"
            media-type="application/xhtml+xml"/>
        <item id="image_3_heic"
            href="media/image_3.heic"
            media-type="image/heic"/>
        <item id="image_3_png"
            href="media/image_3.png"
            media-type="image/png"/>
        <item id="widget"
            href="widget.xhtml"
            media-type="application/xhtml+xml"/>
        …
    </manifest>
    <spine>
        …
        <itemref idref="page_001"/>
        <itemref idref="image_2"/>
        …
    </spine>
</package>

<html …>
    <head …>
        …
        <link rel="stylesheet" type="text/css" href="style.css"/>
        <link rel="pronunciation" type="application/pls+xml" href="speech/cmn.pls"/>
        …
    </head>
    <body>
        <img src="media/image1_png"/>
        …
        <a href="media/image_2.png">…</a>
        …
        <picture>
            <source srcset="media/image_3.heic" type="image/heic"/>
            <img src="media/image_3.png"/>
        </picture>
        …
        <iframe src="widget.xhtml"></iframe>
        …
        <a href="https://www.example.org/some_content">…</a>
    </body>
</html>

EPUB出版物内の各種リソースは、次のように分類できます。（これらのカテゴリの詳細については、3. 出版物リソースを参照してください。）

meta/data.xml: このリソースはメタデータレコードであり、EPUB コンテナーに保存されています。パッケージ文書メタデータ内の link 要素を介してリンクされています。したがって、これはマニフェストプレーン上のリンクされたリソースです（すなわち、マニフェストには列挙されません）。これは他のいずれのプレーンにも属しません。
https://www.example.org/meta/data2.xml: このリソースはメタデータレコードであり、リモートに保存されています。パッケージ文書メタデータ内の link 要素を介してリンクされています。したがって、これはマニフェストプレーン上のリンクされたリソースです（すなわち、マニフェストには列挙されません）。これは他のいずれのプレーンにも属しません。
page.xhtml: このリソースはXHTML文書です。これはスパインに列挙されています。これはマニフェストプレーン上の出版物リソースであり、コンテナーリソースであり、スパインプレーン上のEPUBコンテンツ文書であり、コンテンツプレーン上には存在しません。フォールバックは不要です。
nav.xhtml: このリソースはEPUBナビゲーション文書です。これはスパインには列挙されていません。これはマニフェストプレーン上の出版物リソースであり、コンテナーリソースであり、スパインプレーンにもコンテンツプレーンにも存在しません。フォールバックは不要です。
style.css: このリソースはCSSファイルです。これはスパインには列挙されていませんが、[html]の link要素から参照されています。これはマニフェストプレーン上の出版物リソースであり、コンテナーリソースであり、スパインプレーン上には存在せず、コンテンツプレーン上のコアメディア型リソースです。フォールバックは不要です。
font/font-file.otf: このリソースはTrueTypeフォントファイルです。これはスパインには列挙されていませんが、CSSファイルから参照されています。これはマニフェストプレーン上の出版物リソースであり、コンテナーリソースであり、スパインプレーン上には存在せず、コンテンツプレーン上のコアメディア型リソースです。フォールバックは不要です。
https://www.example.org/fonts/font-file2.otf: このリソースはTrueTypeフォントファイルです。これはスパインには列挙されていませんが、CSSファイルから参照されています。これはマニフェストプレーン上の出版物リソースであり、リモートリソースであり、スパインプレーン上には存在せず、コンテンツプレーン上のコアメディア型リソースです。フォールバックは不要です。
font/font-file.cff: このリソースはCompact Font Formatのフォントファイルです。これはスパインには列挙されていませんが、 CSSファイルから参照されています。そのメディア型はコアメディア型として列挙されていません。これはマニフェストプレーン上の出版物リソースであり、コンテナーリソースであり、スパインプレーン上には存在せず、コンテンツプレーン上の免除リソースです。フォールバックは不要です。
speech/cmn.pls: このリソースは発音辞書ファイルです。これはスパインには列挙されていませんが、[html]のlink要素から参照されています。これはマニフェストプレーン上の出版物リソースであり、コンテナーリソースであり、スパインプレーン上には存在せず、コンテンツプレーン上の免除リソースです。フォールバックは不要です。
image/image_1.png: このリソースはPNG画像ファイルです。これはスパインには列挙されていませんが、[html]の img 要素から参照されています。これはマニフェストプレーン上の出版物リソースであり、コンテナーリソースであり、スパインプレーン上には存在せず、コンテンツプレーン上のコアメディア型リソースです。フォールバックは不要です。
image/image_2.png: このリソースはPNG画像ファイルです。これは[html]の a 要素を介して参照されています。ハイパーリンクから参照されているため、スパインに列挙される 必要があります。これはマニフェストプレーン上の出版物リソースであり、コンテナーリソースであり、スパインプレーン上の外部コンテンツ文書であり、コンテンツプレーン上のコアメディア型リソースです。外部コンテンツ文書として、フォールバックは必須であり、マニフェストフォールバックを介して提供されます。
image_desc.xhtml: このリソースはXHTML文書です。これはマニフェストフォールバックの「ターゲット」であるため、スパインには明示的に列挙されていません（ただし、必要な場合には既存のスパイン項目を「置き換え」ます）。これはマニフェストプレーン上の出版物リソースであり、コンテナーリソースであり、スパインプレーン上の EPUBコンテンツ文書であり、別のEPUBコンテンツ文書のレンダリング時に「使用」されないため、コンテンツプレーン上には存在しません。フォールバックは不要です。
image/image_3.heic: このリソースはHigh Efficiency（HEIC）画像ファイルです。これはスパインには列挙されていませんが、 [html]の source 要素から参照されています。そのメディア型はコアメディア型として列挙されていません。これはマニフェストプレーン上の出版物リソースであり、コンテナーリソースであり、スパインプレーン上には存在せず、コンテンツプレーン上の外部リソースです。外部リソースとして、フォールバックは必須であり、[html]の picture 要素内の兄弟である[html]の img 要素を介して提供されます。
image/image_3.png: このリソースはPNG画像ファイルです。これはスパインには列挙されていませんが、 [html]の img 要素から参照されており、その要素は[html]の picture 要素の内在的フォールバックとして使用されます。これはマニフェストプレーン上の出版物リソースであり、コンテナーリソースであり、スパインプレーン上には存在せず、コンテンツプレーン上のコアメディア型リソースです。フォールバックは不要です。
widget.xhtml: このリソースはXHTML文書です。これはスパインには列挙されていませんが、[html]の iframe 要素から参照されています。これはマニフェストプレーン上の出版物リソースであり、コンテナーリソースであり、スパインプレーン上には存在せず、別のEPUBコンテンツ文書のレンダリング時に「使用」されるため、コンテンツプレーン上のコアメディア型リソースです。フォールバックは不要です。
https://www.example.org/some_content: このリソースは[html]の a 要素を介して参照されており、EPUBコンテナーには保存されません。リーディングシステムは通常、このリンクを別個のブラウザーインスタンスを介して開きます。これはこの仕様で定義されるいずれのプレーン上にもありません。

異なる種類のリソースの使用法に関する追加の例は、5.7.2.2 例にあります。

次のパッケージ文書の例を考えてください:

<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">
            const te = navigator.epubReadingSystem.hasFeature("touch-events");
            const te_message = te ? "passes" : "does not pass";
            alert(`The reading system ${te_message} touch events to the content.`);
        </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要素のコードは、その文書がスパインから参照されているため、スパインレベルスクリプトです; および
scripted02.xhtml内のscript要素のコードは、それが出現する XHTML文書がiframe要素を介してscripted01.xhtmlに含まれているため、コンテナー制約付きスクリプトです。

この例は、署名および暗号化されたEPUB出版物をOCF ZIPコンテナー内に含めるためのOCF形式の使用を示します。

OCF ZIPコンテナー内のファイルの順序付き一覧:

mimetype
META-INF/container.xml
META-INF/signatures.xml
META-INF/encryption.xml
EPUB/As_You_Like_It.opf
EPUB/book.html
EPUB/nav.html
EPUB/images/cover.png

mimetypeファイルの内容

application/epub+zip

META-INF/container.xmlファイルの内容

<?xml version="1.0"?>
<container
    version="1.0"
    xmlns="urn:oasis:names:tc:opendocument:xmlns:container">
   <rootfiles>
      <rootfile
          full-path="EPUB/As_You_Like_It.opf"
          media-type="application/oebps-package+xml"/>
   </rootfiles>
</container>

META-INF/signatures.xmlファイルの内容

<signatures
    xmlns="urn:oasis:names:tc:opendocument:xmlns:container">
   <Signature
       Id="AsYouLikeItSignature"
       xmlns="http://www.w3.org/2000/09/xmldsig#">

      <!--
           SignedInfo is the information that is actually signed.
           In this case, the SHA-1 algorithm is used to sign the
           canonical form of the XML documents enumerated in the
           Object element below.
      -->

      <SignedInfo>
         <CanonicalizationMethod
             Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
         <SignatureMethod
             Algorithm="http://www.w3.org/2000/09/xmldsig#dsa-sha1"/>
         <Reference
             URI="#AsYouLikeIt">
            <DigestMethod
                Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
            <DigestValue>
               …
            </DigestValue>
         </Reference>
      </SignedInfo>

      <!--
           The signed value of the digest above, using the DSA
           algorithm
      -->
      <SignatureValue>
         …
      </SignatureValue>

      <!--
           The key used to validate the signature
      -->
      <KeyInfo>
         <KeyValue>
            <DSAKeyValue>
               <P>…</P>
               <Q>…</Q>
               <G>…</G>
               <Y>…</Y>
            </DSAKeyValue>
         </KeyValue>
      </KeyInfo>

      <!--
           The list of resources to sign (note that the canonical
           form of XML documents is signed, while the binary form
           of all other resources is used)
      -->
      <Object>
         <Manifest
             Id="AsYouLikeIt">
            <Reference
                URI="EPUB/As_You_Like_It.opf">
               <Transforms>
                  <Transform
                      Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
               </Transforms>
               <DigestMethod
                   Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
               <DigestValue>
               </DigestValue>
            </Reference>

            <Reference URI="EPUB/book.html">
               <Transforms>
                  <Transform
                      Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
               </Transforms>
               <DigestMethod
                   Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
               <DigestValue>
               </DigestValue>
            </Reference>

            <Reference
                URI="EPUB/images/cover.png">
               <DigestMethod
                   Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
               <DigestValue>
               </DigestValue>
            </Reference>
         </Manifest>
      </Object>
   </Signature>
</signatures>

META-INF/encryption.xmlファイルの内容

<?xml version="1.0"?>
<encryption
    xmlns="urn:oasis:names:tc:opendocument:xmlns:container"
    xmlns:enc="http://www.w3.org/2001/04/xmlenc#"
    xmlns:ds="http://www.w3.org/2000/09/xmldsig#">

   <!--
        The RSA-encrypted AES-128 symmetric key used to encrypt
        data enumerated in EncryptedData blocks below
   -->
   <enc:EncryptedKey
       Id="EK">
      <enc:EncryptionMethod
          Algorithm="http://www.w3.org/2001/04/xmlenc#rsa-1_5"/>
      <ds:KeyInfo>
         <ds:KeyName>
            John Smith
         </ds:KeyName>
      </ds:KeyInfo>
      <enc:CipherData>
         <enc:CipherValue>
            xyzabc…
         </enc:CipherValue>
      </enc:CipherData>
   </enc:EncryptedKey>

   <!--
        Each EncryptedData block identifies a single resource
        that has been encrypted using the AES-128 algorithm.
        The data remains stored, in its encrypted form, in the
        original file within the container.
   -->
   <enc:EncryptedData Id="ED1">
      <enc:EncryptionMethod
          Algorithm="http://www.w3.org/2001/04/xmlenc#kw-aes128"/>
      <ds:KeyInfo>
         <ds:RetrievalMethod
             URI="#EK"
             Type="http://www.w3.org/2001/04/xmlenc#EncryptedKey"/>
      </ds:KeyInfo>
      <enc:CipherData>
         <enc:CipherReference
             URI="EPUB/book.html"/>
      </enc:CipherData>
   </enc:EncryptedData>

   <enc:EncryptedData Id="ED2">
      <enc:EncryptionMethod
          Algorithm="http://www.w3.org/2001/04/xmlenc#kw-aes128"/>
      <ds:KeyInfo>
         <ds:RetrievalMethod
             URI="#EK" Type="http://www.w3.org/2001/04/xmlenc#EncryptedKey"/>
      </ds:KeyInfo>
      <enc:CipherData>
         <enc:CipherReference
             URI="EPUB/images/cover.png"/>
      </enc:CipherData>
   </enc:EncryptedData>
</encryption>

EPUB/As_You_Like_It.opfファイルの内容

<?xml version="1.0"?>
<package
    version="3.0"
    xml:lang="en"
    xmlns="http://www.idpf.org/2007/opf"
    unique-identifier="pub-id">

   <metadata
       xmlns:dc="http://purl.org/dc/elements/1.1/">

      <dc:identifier
          id="pub-id">
         urn:uuid:B9B412F2-CAAD-4A44-B91F-A375068478A0
      </dc:identifier>

      <dc:language>
         en
      </dc:language>

      <dc:title>
         As You Like It
      </dc:title>

      <dc:creator
          id="creator">
         William Shakespeare
      </dc:creator>

      <meta
          property="dcterms:modified">
         2000-03-24T00:00:00Z
      </meta>

      <dc:publisher>
         Project Gutenberg
      </dc:publisher>

      <dc:date>
         2000-03-24
      </dc:date>

      <meta
          property="dcterms:dateCopyrighted">
         9999-01-01
      </meta>

      <dc:identifier
          id="isbn13">
         urn:isbn:9780741014559
      </dc:identifier>

      <dc:identifier
          id="isbn10">
         0-7410-1455-6
      </dc:identifier>

      <link
          rel="xml-signature"
          href="../META-INF/signatures.xml#AsYouLikeItSignature"/>
   </metadata>

   <manifest>
      <item id="r4915"
          href="book.html"
          media-type="application/xhtml+xml"/>
      <item id="r7184"
          href="images/cover.png"
          media-type="image/png"/>
      <item id="nav"
          href="nav.html"
          media-type="application/xhtml+xml"
          properties="nav"/>
   </manifest>

   <spine>
      <itemref
          idref="r4915"/>
   </spine>
</package>

許可されるクロック値の例を次に示します:

5:34:31.396 = 5時間、34分、31秒、396ミリ秒
124:59:36 = 124時間、59分、36秒
0:05:01.2 = 5分、1秒、200ミリ秒
0:00:04 = 4秒
09:58 = 9分58秒
00:56.78 = 56秒、780ミリ秒
76.2s = 76.2秒 = 76秒、200ミリ秒
7.75h = 7.75時間 = 7時間45分
13min = 13分
2345ms = 2345ミリ秒
12.345 = 12秒、345ミリ秒

メディア型	公開識別子	システム識別子
`application/mathml+xml` `application/mathml-presentation+xml` `application/mathml-content+xml`	`-//W3C//DTD MathML 3.0//EN`	`http://www.w3.org/Math/DTD/mathml3/mathml3.dtd`
`application/x-dtbncx+xml`	`-//NISO//DTD ncx 2005-1//EN`	`http://www.daisy.org/z3986/2005/ncx-2005-1.dtd`
`image/svg+xml`	`-//W3C//DTD SVG 1.1//EN`	`http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd`

（EBNF生成規則 ISO/IEC 14977）
すべての終端記号はUnicodeブロック「Basic Latin」（U+0000から U+007F）に含まれます。
viewport	=	property, { sep, property } ;
property	=	name, [ assign, value ] ;
name	=	? character data ? ;
value	=	? character data ? ;
sep	=	sep-char, { sep-char } ;
sep-char	=	( ";" \| "," \| space ) ;
assign	=	[ space ], "=", [ space ] ;
space	=	#x20 ;

この付録は、この仕様の属性が語彙の用語を参照できるようにする一般的なメカニズム一式を定義します。また、それらの属性で使用するためのEPUB固有の語彙も定義します。

語彙定義表のフィールドには、次の暗黙の要件があります:

許可値

[xmlschema-2]データ型を使用して、REQUIREDな値の型を指定します。データ型は xsd:接頭辞を使用して宣言されます。

適用対象

そのプロパティを指定してもMAYよい出版物リソース型を指定します。

このフィールドは、properties属性で使用されるプロパティに現れます。

カーディナリティ

そのプロパティを、グローバルに、または別の要素やプロパティに付加して指定してもMAYよい回数を指定します。

最小カーディナリティが1のプロパティは指定されなければMUSTなりません。

説明

プロパティの目的を説明し、従わなければならない追加の使用要件を指定します。

例

非規範的な使用例を提供します。

拡張対象

そのプロパティを関連付けてもMAYよいメタデータを識別します。

このフィールドは、主式および部分式と関係を定義するプロパティに現れます。

名前

メタデータ内に現れなければならないMUSTプロパティ名を指定します。

この語彙のプロパティは、 meta 要素のproperty属性で使用できます。

「Extends」フィールドで別途示されていない限り、このセクションで定義されるプロパティは部分式を定義するために使用されます。言い換えれば、このセクションで定義されるプロパティを持つ meta 要素は、拡張されるリソースまたは式を参照する refines属性を持たなければMUSTなりません。

これらのプロパティを参照するための接頭辞URLは、 http://idpf.org/epub/vocab/package/meta/#です。

名前:	`alternate-script`
説明:	`alternate-script`プロパティは、関連付けられたプロパティ値を別の言語および/または文字体系で表した代替表現を提供します。 alternate-scriptプロパティとそれに関連付けられたプロパティの言語タグ — それぞれのスコープ内のxml:lang属性で表されるもの — は同じであってはMUST NOTなりません。このプロパティは通常、国際化目的で`creator`および`title` プロパティに付加されます。
許可値:	`xsd:string`
カーディナリティ:	`zero or more`
拡張対象:	すべてのプロパティ。

例 84: 英語と日本語で表された著者名

<metadata …>
   …
   <dc:creator id="creator">
      Haruki Murakami
   </dc:creator>
   <meta
       refines="#creator"
       property="alternate-script"
       xml:lang="ja">
      村上春樹
   </meta>
   …
</metadata>

名前:	`authority`
説明:	`authority`プロパティは、参照される要素の値が由来するシステムまたはスキームを識別します。
許可値:	`xsd:string` 注記旧IDPF EPUB 3 Working Groupは、このプロパティで使用するための件名典拠のレジストリを維持していました。このWorking Groupは現在、そのレジストリを維持していません。
カーディナリティ:	`zero or one`
拡張対象:	`dc:subject`

例 85: BISAC件名標目の表現

<metadata …>
   …
   <dc:subject
      id="subject01">
     FICTION / Occult &amp; Supernatural
   </dc:subject>
   <meta
       refines="#subject01"
       property="authority">
      BISAC
   </meta>
   …
</metadata>

名前:	`belongs-to-collection`
説明:	`belongs-to-collection`プロパティは、EPUB出版物が属するコレクションの名前を識別します。EPUB出版物は、1つ以上のコレクションに属してもMAYよいです。 `refines`属性を使用してこれらのプロパティを連鎖させ、あるコレクション自体が別のコレクションのメンバーであることを示すこともできます。各コレクションのインスタンスには、`dcterms:identifier`プロパティを使用して一意の識別子を提供すべきですSHOULD。これにより、リーディングシステムがコレクションを整理し、名前の衝突を避けることができます（例えば、無関係なコレクションが似た名前を共有している場合や、同じコレクションの異なる版がリリースされる場合）。コレクションは、`collection-type`プロパティを付加することで、その性質をより正確に定義してもMAYよいです。コレクション内でのEPUB出版物の位置は、`group-position`プロパティを付加することで提供してもMAYよいです。
許可値:	`xsd:string`
カーディナリティ:	`zero or more`
拡張対象:	EPUB出版物に適用され、自身の他のインスタンスを精緻化できます。

例 86: 出版物がセットに属することを示す

この例では、出版物はHarry Potterの本のセットに属しています。

<metadata>
   …
   <meta
       property="belongs-to-collection"
       id="c02">
      Harry Potter
   </meta>
   <meta
       refines="#c02"
       property="collection-type">
      set
   </meta>
   …
</metadata>

名前:	`collection-type`
説明:	`collection-type`プロパティは、コレクションの形式または性質を示します。 `collection-type`値がコードリストまたはその他の正式な列挙から取得される場合、その出典を識別するために`scheme` 属性を付加すべきですSHOULD。この仕様は、スキームが指定されていない場合、次のコレクション型も定義します: `series` 正式にグループとして識別される関連作品の連続体であり、通常はオープンエンドで、作品が時間の経過とともに個別に発行されます。 `set` 全体として単一の知的単位を構成する有限の作品集合であり、通常はまとめて発行され、単位として販売できます。注記リーディングシステムがこれらの値をサポートする必要はありませんが、指定することで、関連する EPUB 出版物をより意味のある方法でグループ化する選択肢を提供します。
許可値:	`xsd:string`
カーディナリティ:	`zero or one`
拡張対象:	`belongs-to-collection`

例 87: 出版物がシリーズに属することを識別する

この例では、出版物はThe New French Cuisine Mastersシリーズに属しています。

<metadata …>
   …
   <meta
       property="belongs-to-collection"
       id="c01">
      The New French Cuisine Masters
   </meta>
   <meta
       refines="#c01"
       property="collection-type">
      series
   </meta>
   …
</metadata>

名前:	`display-seq`
説明:	`display-seq`プロパティは、同一のメタデータプロパティに対して現在のプロパティを表示する数値上の位置を示します。このプロパティは、優先順位規則がまだ定義されていない場合にのみ適用されます（例えば、creatorには文書順での出現に基づいて優先順位が与えられます）。
許可値:	`xsd:unsignedInt`
カーディナリティ:	`zero or one`
拡張対象:	すべてのプロパティ。

名前:	`file-as`
説明:	`file-as`プロパティは、並べ替えのために、関連付けられたプロパティの正規化された形式を提供します。
許可値:	`xsd:string`
カーディナリティ:	`zero or one`
拡張対象:	すべてのプロパティ。

例 88: 並べ替え用の著者名の表現

<metadata …>
   …
   <dc:creator
       id="creator01">
      Lewis Carroll
   </dc:creator>
   <meta
       refines="#creator01"
       property="file-as">
      Carroll, Lewis
   </meta>
   …
</metadata>

名前:	`group-position`
説明:	`group-position`プロパティは、EPUB出版物が、同じグループに属する他の作品（すべてがEPUB出版物であるかどうかを問わない）に対して順序付けられる数値上の位置を示します。 `group-position`プロパティは、グループを確立する任意のメタデータプロパティに付加できますが、通常は`belongs-to-collection` プロパティに関連付けられます。 EPUB出版物は複数のグループに属することができます。
許可値:	単一の`xsd:unsignedInt`または小数点区切りの数値列（例えば、 `1`または`2.2.1`）。
カーディナリティ:	`zero or one`
拡張対象:	すべてのプロパティ。

例 89: セット内での出版物の位置の識別

この例では、出版物はThe Lord of the Ringsの本のセットの2番目です。

<metadata …>
   …
   <meta property="belongs-to-collection" id="c01">
      The Lord of the Rings
   </meta>
   <meta
       refines="#c01"
       property="collection-type">
      set
   </meta>
   <meta
       refines="#c01"
       property="group-position">
      2
   </meta>
   …
</metadata>

例 90: 位置を表す小数点区切り値の表現

この例では、group-position属性の小数点区切り値は、この出版物が定期刊行物の第98巻第4号であることを示します。

<metadata …>
   …
   <meta
       property="belongs-to-collection"
       id="cygnus-x-1">
      Physical Review D
   </meta>
   <meta
       refines="#cygnus-x-1"
       property="collection-type">
      series
   </meta>
   <meta
       refines="#cygnus-x-1"
       property="group-position">
      98.4
   </meta>
   …
</metadata>

名前:	`identifier-type`
説明:	`identifier-type`プロパティは、`identifier`の形式または性質を示します。 `identifier-type`値がコードリストまたはその他の正式な列挙から取得される場合、その出典を識別するために`scheme` 属性を付加すべきですSHOULD。
許可値:	`xsd:string`
カーディナリティ:	`zero or one`
拡張対象:	`dc:identifier`, `dc:source`

例 91: 識別子がISBNであることを示す

この例では、ONIXコードリスト5スキームが数値15の意味を定義しています。

<metadata …>
   …
   <dc:identifier
       id="isbn-id">
      urn:isbn:9780101010101
   </dc:identifier>
   <meta
      refines="#isbn-id"
      property="identifier-type"
      scheme="onix:codelist5">
     15
   </meta>
   …
</metadata>

名前:	`pageBreakSource`
説明:	EPUB出版物内の改ページマーカーの出典に対する一意の識別子を提供します。識別子がISBNなどの認識されたスキームに適合する場合、値としてURNを使用することが推奨されます。出典に一意の識別子が存在しない場合、出典を可能な限り明確に識別するテキスト記述（例えば、ワープロ文書のタイトル）を使用することが推奨されます。改ページマーカーがEPUB出版物に固有である場合（例えば、デジタル専用版の場合）、値「`none`」を指定しなければMUSTなりません。
許可値:	`xsd:string`
カーディナリティ:	出版物がページリストおよび/または改ページマーカーを含む場合はちょうど1つ、それ以外の場合は 0。
拡張対象:	EPUB出版物に適用されます。他のプロパティは拡張しません。

注記

pageBreakSourceプロパティは、EPUB出版物の静的ページ分割の出典を識別するための source-of プロパティを置き換えます。

アクセシブルなページナビゲーションを提供する方法については、[epub-a11y-tech-11]を参照してください。

例 92: 一意の識別子を持つ出典からのページ分割

この例では、ページ分割はISBN番号を持つ印刷版に対応します。その番号が適合するスキームを識別するためにURNが使用されます。

<meta
property="pageBreakSource">
urn:isbn:9780010010001
</meta>

例 93: 出典のないページ分割

この例では、出版社がデジタル専用版に改ページマーカーとページリストを追加しています。値noneは、ページ分割が別の出典から取得されていないことを示します。

<meta
property="pageBreakSource">
none
</meta>

例 94: 一意の識別子を持たない出典からのページ分割

この例では、文書名とその形式がページ分割の出典を識別するために使用されます。

<meta
property="pageBreakSource">
Hobo eReader User Manual. PDF: https://example.org/manuals/hobo/
</meta>

名前:	`role`
説明:	`role`プロパティは、EPUB出版物の作成における`creator`、 `contributor`、または`publisher`の役割を説明します。 `role`値がコードリストまたはその他の正式な列挙から取得される場合、その出典を識別するために`scheme` 属性を付加すべきですSHOULD。個人または組織に複数の役割を割り当てる場合は、各役割を別個の`meta`要素で関連付け、要素の文書順が果たした役割の重要度を反映するようにしてください（すなわち、最初に出現する`meta`要素が最も重要な役割を含みます）。
許可値:	`xsd:string`
カーディナリティ:	`zero or more`
拡張対象:	`dc:contributor`, `dc:creator`, `dc:publisher`

例 95: creatorの役割の区別

この例では、MARC Relators語彙値が、作品の著者と挿絵画家を区別しています。

<metadata …>
   …
   <dc:creator
      id="creator01">
     Lewis Carroll
   </dc:creator>
   <meta
       refines="#creator01"
       property="role"
       scheme="marc:relators">
      aut
   </meta>

   <dc:creator
       id="creator02">
      John Tenniel
   </dc:creator>
   <meta
       refines="#creator02"
       property="role"
       scheme="marc:relators">
      ill
   </meta>
   …
</metadata>

例 96: 複数の役割を持つcreatorの識別

この例では、creatorは作品の著者であり挿絵画家でもあります。

<metadata …>
   …
   <dc:creator
       id="creator01">
      Maurice Sendak
   </dc:creator>
   <meta
       refines="#creator01"
       property="role"
       scheme="marc:relators">
      aut
   </meta>
   <meta
       refines="#creator01"
       property="role"
       scheme="marc:relators">
      ill
   </meta>
   …
</metadata>

EPUB出版物でsource-ofプロパティを使用することは、もはや推奨されません。 EPUB出版物のページ分割の出典を示すには、pageBreakSourceプロパティ定義を参照してください。

注記

source-ofプロパティは、それが使用されている既存のEPUB出版物基盤があるため、公式には非推奨とされませんが、非推奨であるかのように扱うことが推奨されます。その使用に関する情報については、[epub-33]のsource-ofプロパティ定義を参照してください。

名前:	`term`
説明:	`term`プロパティは件名コードを提供します。
許可値:	`xsd:string`
カーディナリティ:	`zero or one`
拡張対象:	`dc:subject`

例 97: 件名標目に対するBISACコードの表現

次の例は、件名標目に対するBISACコードを示します。

<metadata …>
   …
   <dc:subject
       id="subject01">
      FICTION / Occult &amp; Supernatural
   </dc:subject>
   <meta
       refines="#subject01"
       property="authority">
      BISAC
   </meta>
   <meta
       refines="#subject01"
       property="term">
      FIC024000
   </meta>
   …
</metadata>

名前:	`title-type`
説明:	`title-type`プロパティは、`title`の形式または性質を示します。 `title-type`値がコードリストまたはその他の正式な列挙から取得される場合、その出典を識別するために`scheme` 属性を付加すべきですSHOULD。スキームが指定されていない場合、リーディングシステムは、次のtitle type値を認識すべきですSHOULD: `main`, `subtitle`, `short`, `collection`, `edition` and `expanded`.
許可値:	`xsd:string`
カーディナリティ:	`zero or one`
拡張対象:	`dc:title`

例 98: 異なるタイトル型の表現

<metadata …>
   …
   <dc:title id="t1">
      A Dictionary of Modern English Usage
   </dc:title>
   <meta
       refines="#t1"
       property="title-type">
      main
   </meta>

   <dc:title id="t2">
      First Edition
   </dc:title>
   <meta
       refines="#t2"
       property="title-type">
      edition
   </meta>

   <dc:title id="t3">
      Fowler's
   </dc:title>
   <meta
       refines="#t3"
       property="title-type">
      short
   </meta>
   …
</metadata>

例 99: 複雑なタイトルの表現

この例は、タイトル「The Great Cookbooks of the World: Mon premier guide de cuisson, un Mémoire. The New French Cuisine Masters, Volume Two. Special Anniversary Edition」を分類する方法を示します。

<metadata …>
   …
   <dc:title
       id="t1"
       xml:lang="fr">
      Mon premier guide de cuisson, un Mémoire
   </dc:title>
   <meta
       refines="#t1"
       property="title-type">
      main
   </meta>
   <meta
       refines="#t1"
       property="display-seq">
      2
   </meta>

   <dc:title id="t2">
      The Great Cookbooks of the World
   </dc:title>
   <meta
       refines="#t2"
       property="title-type">
      collection
   </meta>
   <meta
       refines="#t2"
       property="display-seq">
      1
   </meta>

   <dc:title id="t3">
      The New French Cuisine Masters
   </dc:title>
   <meta
       refines="#t3"
       property="title-type">
      collection
   </meta>
   <meta
       refines="#t3"
       property="display-seq">
      3
   </meta>

   <dc:title id="t4">
      Special Anniversary Edition
   </dc:title>
   <meta
       refines="#t4"
       property="title-type">
      edition
   </meta>
   <meta
       refines="#t4"
       property="display-seq">
      4
   </meta>

   <dc:title id="t5">
      The Great Cookbooks of the World: 
      Mon premier guide de cuisson, un Mémoire. 
      The New French Cuisine Masters, Volume Two. 
      Special Anniversary Edition
   </dc:title>
   <meta
       refines="#t5"
       property="title-type">
      expanded
   </meta>
   …
</metadata>

例 100: EPUB出版物における典型的なrefinesメタデータ一式

<metadata …>

   <dc:identifier id="pub-id">
      urn:uuid:A1B0D67E-2E81-4DF5-9E67-A64CBE366809
   </dc:identifier>

   <dc:identifier id="isbn-id">
      urn:isbn:9780101010101
   </dc:identifier>
   <meta
       refines="#isbn-id"
       property="identifier-type"
       scheme="onix:codelist5">
      15
   </meta>

   <dc:source id="src-id">
      urn:isbn:9780375704024
   </dc:source>
   <meta
       refines="#src-id"
       property="identifier-type"
       scheme="onix:codelist5">
      15
   </meta>

   <dc:title id="title">
      Norwegian Wood
   </dc:title>
   <meta
       refines="#title"
       property="title-type">
      main
   </meta>

   <dc:language>
      en
   </dc:language>

   <dc:creator
       id="creator">
      Haruki Murakami
   </dc:creator>
   <meta
       refines="#creator"
       property="role"
       scheme="marc:relators"
       id="role">
      aut
   </meta>
   <meta
       refines="#creator"
       property="alternate-script"
       xml:lang="ja">
      村上 春樹
   </meta>
   <meta
       refines="#creator"
       property="file-as">
      Murakami, Haruki
   </meta>

   <meta
       property="dcterms:modified">
      2011-01-01T12:00:00Z
   </meta>

</metadata>

この語彙のプロパティは、メタデータ link 要素のrel属性およびproperties属性で使用できます。

これらのプロパティを参照するための接頭辞URLは、 http://idpf.org/epub/vocab/package/link/#です。

次の値は、link要素のrel属性で使用して、 href属性で参照されるリソースとの関係を確立できます。

名前:	`alternate`
説明:	`alternate`キーワードは、リンク用のHTML `alternate`キーワードのサブセットです。次の点で異なります: 他のキーワードと組み合わせてはMUST NOTなりません。 alternateリンクがパッケージ文書メタデータに含まれる場合、これは`media-type`属性で指定された形式のパッケージ文書の代替表現を識別します。 alternateリンクが `collection`要素のメタデータに含まれる場合、これは`media-type`属性で指定された形式の `collection`の代替表現を識別します。リーディングシステムは、alternateリンクのためにハイパーリンクを生成する必要はありません。
カーディナリティ:	`Zero or more`
拡張対象:	EPUB出版物またはコレクションにのみ適用されます。`refines` 属性が存在する場合は使用してはMUST NOTなりません。
例:	`<link rel="alternate" href="package.json" media-type="application/json-ld"/>`

名前:	`record`
説明:	参照されるリソースがメタデータレコードであることを示します。このキーワードが指定される場合、そのレコードのメディア型は`media-type`属性で識別されなければMUSTなりません。一般的にリンクされるメタデータレコード型の一覧については、EPUB Linked Metadata Guideを参照してください。レコードの型をメディア型から識別できない場合、識別子プロパティを `properties`属性で割り当てることができます。
カーディナリティ:	`Zero or more`
拡張対象:	EPUB出版物またはコレクションにのみ適用されます。`refines`属性が存在する場合は使用してはMUST NOTなりません。
例:	`<link rel="record" href="book/52.atom" media-type="application/atom+xml;type=entry;profile=opds-catalog"/>`

名前:	`voicing`
説明:	参照される音声ファイルが、refines属性で指定された式またはリソース（通常はタイトルまたはcreator）の聴覚的表現を提供することを示します。このキーワードが指定される場合、その音声ファイルのメディア型は `media-type`属性で識別されなければMUSTなりません。
カーディナリティ:	`Zero or more`
拡張対象:	すべてのプロパティ。この値が使用される場合、`refines`属性が存在しなければMUSTなりません。
例:	`<link refines="#title" rel="voicing" media-type="audio/mpeg" href="title.mp3" />`

次の値は、 link 要素の properties属性で使用して、参照されるリソースが表すレコードの種類を確立できます。これらの値は、メディア型によって一意に識別できないレコード形式のために提供されます。

名前:	`onix`
説明:	`onix`プロパティは、参照されるリソースがONIXレコード [onix]であることを示します。
例:	`<link rel="record" href="pub/meta/nor-wood-onix.xml" media-type="application/xml" properties="onix"/>`

これらのプロパティを参照するための接頭辞URLは、 http://www.idpf.org/vocab/rendition/#です。

「rendition:」接頭辞は、パッケージレンダリングプロパティとともに使用するために予約されており、パッケージ文書内で宣言する必要はありません。

名前: rendition:layout

説明:

名前:	`rendition:layout`
説明:	`rendition:layout`プロパティは、EPUB出版物がリフロー可能、事前ページ分割済み、またはロールであるかを指定します。リフロー可能および事前ページ分割済みの出版物では、グローバルレイアウトを個別の EPUBコンテンツ文書に対して上書きしてもMAYよいです。
許可値:	次の値のいずれかでなければMUSTなりません: reflowable コンテンツは事前ページ分割済みではありません（すなわち、リーディングシステムはレンダリング時に動的ページ分割を適用できます）。既定値。 pre-paginated コンテンツは事前ページ分割済みです（すなわち、リーディングシステムはレンダリング時にスパイン `itemref` ごとにちょうど1ページを生成します）。 roll コンテンツはロールです（すなわち、リーディングシステムは各スパイン `itemref` の幅をビューポートに合わせ、可視の隙間のない連続ロールとして表示します）。
カーディナリティ:	`zero or one`
拡張対象:	EPUB出版物にのみ適用されます。`refines`属性が存在する場合は使用してはMUST NOTなりません。

rendition:layoutプロパティは、EPUB出版物がリフロー可能、事前ページ分割済み、またはロールであるかを指定します。

リフロー可能および事前ページ分割済みの出版物では、グローバルレイアウトを個別の EPUBコンテンツ文書に対して上書きしてもMAYよいです。

許可値:

次の値のいずれかでなければMUSTなりません:

reflowable: コンテンツは事前ページ分割済みではありません（すなわち、リーディングシステムはレンダリング時に動的ページ分割を適用できます）。既定値。
pre-paginated: コンテンツは事前ページ分割済みです（すなわち、リーディングシステムはレンダリング時にスパイン itemref ごとにちょうど1ページを生成します）。
roll: コンテンツはロールです（すなわち、リーディングシステムは各スパイン itemref の幅をビューポートに合わせ、可視の隙間のない連続ロールとして表示します）。

カーディナリティ: zero or one

拡張対象: EPUB出版物にのみ適用されます。refines属性が存在する場合は使用してはMUST NOTなりません。

名前: rendition:layout-pre-paginated

説明:

名前:	`rendition:layout-pre-paginated`
説明:	`rendition:layout-pre-paginated`プロパティは、関連付けられた `item`要素内のリソースが事前ページ分割済みレイアウトでレンダリングされることを意図していることを示します。
適用:	スパイン `itemref` 要素に対してのみ指定してもMAYよいです。同じproperties属性内で別のレイアウト上書きプロパティと組み合わせてはMUST NOTなりません。 rollレイアウトとともに指定してはMUST NOTなりません。

rendition:layout-pre-paginatedプロパティは、関連付けられた item要素内のリソースが事前ページ分割済みレイアウトでレンダリングされることを意図していることを示します。

適用:

スパイン itemref 要素に対してのみ指定してもMAYよいです。

同じproperties属性内で別のレイアウト上書きプロパティと組み合わせてはMUST NOTなりません。

rollレイアウトとともに指定してはMUST NOTなりません。

名前: rendition:layout-reflowable

説明:

名前:	`rendition:layout-reflowable`
説明:	`rendition:layout-reflowable`プロパティは、関連付けられた `item`要素内のリソースがリフロー可能レイアウトでレンダリングされることを意図していることを示します。
適用:	スパイン `itemref` 要素に対してのみ指定してもMAYよいです。同じproperties属性内で別のレイアウト上書きプロパティと組み合わせてはMUST NOTなりません。 rollレイアウトとともに指定してはMUST NOTなりません。

rendition:layout-reflowableプロパティは、関連付けられた item要素内のリソースがリフロー可能レイアウトでレンダリングされることを意図していることを示します。

適用:

スパイン itemref 要素に対してのみ指定してもMAYよいです。

同じproperties属性内で別のレイアウト上書きプロパティと組み合わせてはMUST NOTなりません。

rollレイアウトとともに指定してはMUST NOTなりません。

名前: rendition:page-spread-center

説明:

名前:	`rendition:page-spread-center`
説明:	`rendition:page-spread-center`プロパティは、見開きを無効にし、スパイン項目を中央に配置するために使用されます。
適用:	スパイン `itemref` 要素に対してのみ指定してもMAYよいです。他の接頭辞付きまたは接頭辞なしの見開き配置プロパティと組み合わせてはMUST NOTなりません。

rendition:page-spread-centerプロパティは、見開きを無効にし、スパイン項目を中央に配置するために使用されます。

適用:

スパイン itemref 要素に対してのみ指定してもMAYよいです。

他の接頭辞付きまたは接頭辞なしの見開き配置プロパティと組み合わせてはMUST NOTなりません。

名前: rendition:page-spread-left

説明:

名前:	`rendition:page-spread-left`
説明:	`rendition:page-spread-left`プロパティは、スパイン項目を2ページ見開きの左側スロットに配置するための `page-spread-left`プロパティのエイリアスです。
適用:	スパイン `itemref` 要素に対してのみ指定してもMAYよいです。スパインプロパティ語彙の `page-spread-left`と組み合わせてもMAYよいですが、他の接頭辞付きまたは接頭辞なしの見開き配置プロパティと組み合わせてはMUST NOTなりません。

rendition:page-spread-leftプロパティは、スパイン項目を2ページ見開きの左側スロットに配置するための page-spread-leftプロパティのエイリアスです。

適用:

スパイン itemref 要素に対してのみ指定してもMAYよいです。

スパインプロパティ語彙の page-spread-leftと組み合わせてもMAYよいですが、他の接頭辞付きまたは接頭辞なしの見開き配置プロパティと組み合わせてはMUST NOTなりません。

名前: rendition:page-spread-right

説明:

名前:	`rendition:page-spread-right`
説明:	`rendition:page-spread-right`プロパティは、スパイン項目を2ページ見開きの右側スロットに配置するための `page-spread-right`プロパティのエイリアスです。
適用:	スパイン `itemref` 要素に対してのみ指定してもMAYよいです。スパインプロパティ語彙の `page-spread-right`と組み合わせてもMAYよいですが、他の接頭辞付きまたは接頭辞なしの見開き配置プロパティと組み合わせてはMUST NOTなりません。

rendition:page-spread-rightプロパティは、スパイン項目を2ページ見開きの右側スロットに配置するための page-spread-rightプロパティのエイリアスです。

適用:

スパイン itemref 要素に対してのみ指定してもMAYよいです。

スパインプロパティ語彙の page-spread-rightと組み合わせてもMAYよいですが、他の接頭辞付きまたは接頭辞なしの見開き配置プロパティと組み合わせてはMUST NOTなりません。

カスタムプロパティおよびスパイン上書きは、特定のリーディングシステムに固有のレンダリング上の問題に対処するために、そのリーディングシステムの開発者によって定義されるものとして、パッケージ文書に含めることができます。

唯一の制限は、そのようなプロパティをrendition:接頭辞で定義してはMUST NOTならず、かつパッケージレンダリング語彙のプロパティと動作上競合してはMUST NOTならないことです。

複数の独立したリーディングシステムで使用するための拡張が必要な場合、望ましい方法は、この標準の改訂を通じてパッケージレンダリング語彙を拡張することです。

この語彙のプロパティは、マニフェスト item 要素のproperties属性で使用できます。

これらのプロパティを参照するための接頭辞URLは、 http://idpf.org/epub/vocab/package/item/#です。

名前:	`cover-image`
説明:	`cover-image`プロパティは、記述対象の出版物リソースを、EPUB出版物の表紙画像として識別します。
適用対象:	すべてのラスターおよびベクター画像型
カーディナリティ:	`Zero or one`

名前:	`mathml`
説明:	`mathml`プロパティは、記述対象の出版物リソースが1つ以上のMathMLマークアップのインスタンスを含むことを示します。
適用対象:	EPUBコンテンツ文書
カーディナリティ:	`Zero or more`

名前: nav

説明: navプロパティは、記述対象の出版物リソースがEPUB出版物の EPUBナビゲーション文書を構成することを示します。

適用対象: EPUBナビゲーション文書

カーディナリティ: Exactly one

名前:	`nav`
説明:	`nav`プロパティは、記述対象の出版物リソースがEPUB出版物の EPUBナビゲーション文書を構成することを示します。
適用対象:	EPUBナビゲーション文書
カーディナリティ:	`Exactly one`

名前:	`remote-resources`
説明:	`remote-resources`プロパティは、記述対象の出版物リソースが、EPUBコンテナーの外部に位置する他の出版物リソースへの内部参照を1つ以上含むことを示します。詳細については、3.6 リソースの場所を参照してください。
適用対象:	内部参照の能力を持つすべての出版物リソース（例えば、XHTMLコンテンツ文書、SVGコンテンツ文書、 CSSスタイルシート、およびメディアオーバーレイ文書）。
カーディナリティ:	`Zero or more`

名前:	`scripted`
説明:	`scripted`プロパティは、記述対象の出版物リソースがスクリプト付きコンテンツ文書であること（すなわち、スクリプトおよび/または[html]の `form` 要素を含むこと）を示します。
適用対象:	EPUBコンテンツ文書
カーディナリティ:	`Zero or more`

名前:	`svg`
説明:	`svg`プロパティは、記述対象の出版物リソースが1つ以上のSVGマークアップのインスタンスを埋め込むことを示します。このプロパティは、SVGマークアップがリソース内に直接含まれる場合に設定されなければMUSTならず、SVGがリソースから参照される場合（例えば、[html]の `img`、`object`、または`iframe`要素から）にも設定しても MAYよいです。
適用対象:	XHTMLコンテンツ文書; SVGコンテンツ文書では値は暗黙です。
カーディナリティ:	`Zero or more`

名前:	`switch`
説明:	`switch`プロパティは、記述対象の出版物リソースが、非推奨の `epub:switch`要素のインスタンスを1つ以上含むことを示します。
適用対象:	XHTMLコンテンツ文書。
カーディナリティ:	`Zero or more`

この語彙のプロパティは、スパイン itemref 要素の properties属性で使用できます。

これらのプロパティを参照するための接頭辞URLは、 http://idpf.org/epub/vocab/package/itemref/#です。

名前: page-spread-left

説明:

名前:	`page-spread-left`
説明:	`page-spread-left`プロパティは、関連付けられた`item`要素の EPUBコンテンツ文書の最初のページが、 2ページ見開きの左側を表すことを示します。 `rendition:page-spread-left` プロパティは、このプロパティのエイリアスです。これらの使用に関する詳細については、 6.3.1.1 合成見開きを参照してください。

page-spread-leftプロパティは、関連付けられたitem要素の EPUBコンテンツ文書の最初のページが、 2ページ見開きの左側を表すことを示します。

rendition:page-spread-left プロパティは、このプロパティのエイリアスです。これらの使用に関する詳細については、 6.3.1.1 合成見開きを参照してください。

名前: page-spread-right

説明:

名前:	`page-spread-right`
説明:	`page-spread-right`プロパティは、関連付けられた`item`要素の EPUBコンテンツ文書の最初のページが、 2ページ見開きの右側を表すことを示します。 `rendition:page-spread-right` プロパティは、このプロパティのエイリアスです。これらの使用に関する詳細については、 6.3.1.1 合成見開きを参照してください。

page-spread-rightプロパティは、関連付けられたitem要素の EPUBコンテンツ文書の最初のページが、 2ページ見開きの右側を表すことを示します。

rendition:page-spread-right プロパティは、このプロパティのエイリアスです。これらの使用に関する詳細については、 6.3.1.1 合成見開きを参照してください。

例 101: スパイン内の2ページ見開きの識別

<spine>
<itemref
    idref="title"/>
<itemref
    idref="ps-1-l"
    properties="page-spread-left"/>
<itemref
    idref="ps-1-r"
    properties="page-spread-right"/>
<itemref
    idref="toc"/>
…
</spine>

この語彙のプロパティは、 meta 要素の property属性で使用できます。

これらのプロパティを参照するための接頭辞URLは、 http://idpf.org/epub/vocab/overlays/#です。

接頭辞「media:」は、この語彙のプロパティとともに使用するために予約されており、パッケージ文書内で宣言する必要はありません。

名前:	`active-class`
説明:	現在再生中のEPUBコンテンツ文書要素に適用するCSSクラス名。
許可値:	`xsd:string`
カーディナリティ:	`Zero or one`
例:	`<meta property="media:active-class">-epub-media-overlay-active</meta>`

名前:	`duration`
説明:	プレゼンテーション全体または特定のメディアオーバーレイ文書の長さ。指定された長さは作成時に既知の音声クリップを考慮し、したがって外部リソースからのライブストリーミングおよび音声合成は除外します。
許可値:	[smil3]のクロック値でなければMUSTなりません。
カーディナリティ:	EPUB出版物および各メディアオーバーレイ文書につきちょうど1つ。
例:	`<meta property="media:duration">1:36:20</meta>`

名前:	`narrator`
説明:	ナレーターの名前。
許可値:	`xsd:string`
カーディナリティ:	`Zero or more`
例:	`<meta property="media:narrator">Joe Speaker</meta>`

名前:	`playback-active-class`
説明:	再生がアクティブなときに、EPUBコンテンツ文書の文書要素に適用する、作成者定義のCSSクラス名。
許可値:	`xsd:string`
カーディナリティ:	`Zero or one`
例:	`<meta property="media:playback-active-class">-epub-media-overlay-playing</meta>`

EPUB 3.4

概要

この文書のステータス

1. 序論

1.1 概要

1.2 構成

1.3 他の 仕様との関係

1.3.1 HTMLとの関係

1.3.2 SVGとの関係

1.3.3 CSSとの関係

1.3.4 MathMLとの関係

1.3.5 SMILとの関係

1.3.6 URLとの関係

1.4 用語

1.5 適合性

1.6 作成用の省略記法

2. EPUB出版物の適合性

2.1 適合性検査

3. 出版リソース

3.1 序論

3.1.1 マニフェストプレーン

3.1.2 スパインプレーン

3.1.3 コンテンツプレーン

3.2 コアメディア型

3.3 外部リソース

3.4 免除リソース

3.5 リソースのフォールバック

3.5.1 マニフェストフォールバック

3.5.2 固有のフォールバック

3.5.2.1 HTML audioおよびvideoのフォールバック

3.5.2.2 HTML img のフォールバック

3.5.2.3 HTML script 要素

3.6 リソースの場所

3.7 Data URL

3.8 File URL

3.9 XML適合性

4. Open Container Format (OCF)

4.1 序論

4.2 OCF抽象コンテナー

4.2.1 序論

4.2.2 ファイルおよびディレクトリ 構造

4.2.3 ファイルパスおよびファイル名

4.2.4 ファイルパスの導出

4.2.5 OCF 抽象コンテナー内のURL

4.2.6 META-INFディレクトリ

4.2.6.1 OCF抽象 コンテナーへの包含

4.2.6.2 META-INFディレクトリ内のURLの構文解析

4.2.6.3 予約済みファイル

4.2.6.3.1 コンテナーファイル（container.xml）

4.2.6.3.1.1 container要素

4.2.6.3.1.2 rootfiles要素

4.2.6.3.1.3 rootfile要素

4.2.6.3.1.4 links要素

4.2.6.3.1.5 link要素

4.2.6.3.1.6 例

4.2.6.3.2 暗号化ファイル（encryption.xml）

4.2.6.3.2.1 encryption要素

4.2.6.3.2.2 圧縮と暗号化の順序

4.2.6.3.3 マニフェスト ファイル（manifest.xml）

4.2.6.3.4 メタデータ ファイル（metadata.xml）

4.2.6.3.5 権利管理ファイル（rights.xml）

4.2.6.3.6 デジタル署名ファイル（signatures.xml）

4.2.6.3.6.1 signatures要素

4.3 OCF ZIPコンテナー

4.3.1 序論

4.3.2 ZIPファイル要件

4.3.3 OCF ZIP コンテナーのメディア型識別

5. パッケージ文書

5.1 序論

5.2 パッケージ文書内の URLの構文解析

5.3 語彙関連付け メカニズム

5.3.1 序論

5.3.2 コンパクトURLデータ型

5.3.3 既定語彙

5.3.4 prefix 属性

5.3.5 予約済み接頭辞

5.4 共有属性

5.4.1 dir属性

5.4.2 href属性

5.4.3 id属性

1.3 他の仕様との関係

3.5.2.1 HTML `audio`および`video`のフォールバック

3.5.2.2 HTML `img` のフォールバック

3.5.2.3 HTML `script` 要素

4.2.2 ファイルおよびディレクトリ構造

4.2.6 `META-INF`ディレクトリ

4.2.6.1 OCF抽象コンテナーへの包含

4.2.6.2 `META-INF`ディレクトリ内のURLの構文解析

4.2.6.3.1 コンテナーファイル（`container.xml`）

4.2.6.3.1.1 `container`要素

4.2.6.3.1.2 `rootfiles`要素

4.2.6.3.1.3 `rootfile`要素

4.2.6.3.1.4 `links`要素

4.2.6.3.1.5 `link`要素

4.2.6.3.2 暗号化ファイル（`encryption.xml`）

4.2.6.3.2.1 `encryption`要素

4.2.6.3.3 マニフェストファイル（`manifest.xml`）

4.2.6.3.4 メタデータファイル（`metadata.xml`）

4.2.6.3.5 権利管理ファイル（`rights.xml`）

4.2.6.3.6 デジタル署名ファイル（`signatures.xml`）

4.2.6.3.6.1 `signatures`要素

5.3 語彙関連付けメカニズム

5.3.4 `prefix` 属性

5.4.1 `dir`属性

5.4.2 `href`属性

5.4.3 `id`属性

5.4.4 `media-type` 属性

5.4.5 `properties` 属性

5.4.6 `refines` 属性

5.4.7 `xml:lang` 属性

5.5 `package`要素

5.6.1 `metadata` 要素

5.6.3.1.1 `dc:identifier`要素

5.6.3.1.2 `dc:title`要素

5.6.3.1.3 `dc:language`要素

5.6.3.2.2 `dc:contributor`要素

5.6.3.2.3 `dc:creator`要素

5.6.3.2.4 `dc:date`要素

5.6.3.2.5 `dc:subject`要素

5.6.3.2.6 `dc:type`要素

5.6.4 `meta`要素

5.6.6 `link`要素

5.7.1 `manifest` 要素

5.7.2 `item`要素

5.8.1 `spine`要素

5.8.2 `itemref`要素

7.1.4 HTMLからの逸脱および制約

7.1.4.3.1 `base`要素

7.1.4.3.2 `rp` 要素

7.1.4.3.3 `embed`要素

7.3.2 固定レイアウト文書の寸法

7.4.1.3 リーディングシステムのサポートに関する考慮事項

7.4.2.2 スクリプティングコンテキスト