EPUB 3.3

Manifest 回退是包 文档的一项特性，它为 出版物资源创建 manifest 回退链，允许 阅读系统 选择一种它们能够渲染的替代格式。

回退链通过 fallback 属性在 manifest item 元素上创建。该属性引用另一个 manifest item 的 ID [xml]，该 item 是当前 item 的 回退。从给定 item 的 fallback 属性开始，阅读系统能够到达的所有引用的有序列表 表示该 item 的完整回退链。该链也 表示 EPUB 创建者首选的回退 顺序。

Manifest 回退有两种情况：

Spine 回退

EPUB 创建者 MUST 为 外来内容 文档指定回退链，以确保 阅读系统始终能够渲染该 spine 项。在这种情况下， 该链 MUST 至少包含一个 EPUB 内容文档。

EPUB 创建者 MAY 为 EPUB 内容文档提供回退 （例如，为脚本化内容提供回退）。

当回退链包含多个 EPUB 内容文档时，EPUB 创建者可以使用 properties 属性来区分 每个文档的用途。

内容回退

注

内容回退的最初目的是为 [html] img 元素指定回退图像。由于 HTML 现在具有图像的内在回退机制， 强烈不建议使用内容回退。EPUB 创建者应始终 使用 [html] 和 [svg] 的内在回退能力来 提供回退 内容。

当引用外来资源的元素 没有内在回退能力时，EPUB 创建者 MUST 为其提供内容回退。在这种情况下， 回退链 MUST 至少包含一个 核心媒体类型 资源。

EPUB 创建者 MAY 也为核心媒体 类型资源提供 manifest 回退（例如，允许阅读系统从多种图像格式中选择）。

无论指定哪种类型的 manifest 回退，回退链都 MUST NOT 包含 对链中 item 元素的自引用或循环引用。

以下小节提供关于特定元素的内在回退 要求的补充说明。

OCF 抽象容器的虚拟文件系统 MUST 为容器的所有内容具有一个单一公共根 目录。

OCF 抽象容器 MUST 包括一个名为 META-INF 的配置文件目录，它是容器根目录的直接子目录。有关该 目录内容的要求，请参阅 4.2.6 META-INF 目录。

根目录中的文件名 mimetype 保留供 OCF ZIP 容器使用，如 4.3 OCF ZIP 容器中所说明。

META-INF 目录中的文件和 mimetype 文件不是 出版物资源，因此 MUST NOT 列在 manifest 中。

EPUB 创建者 MAY 将 OCF 抽象容器内的所有其他 文件放置在根目录的任何后代位置， 但不得位于 META-INF 目录中。EPUB 创建者 MUST NOT 从 EPUB 出版物中引用 META-INF 目录中的文件。

在 OCF 抽象容器的上下文中，文件路径和文件名是标量值字符串 [infra]（即 其值区分大小写）。

此外，以下限制旨在允许文件路径和文件名在大多数操作系统上 无需修改即可使用：

• 文件名 MUST NOT 超过 255 字节。

• OCF 抽象容器内任何目录或文件的文件路径 MUST NOT 超过 65535 字节。

• 文件名 MUST NOT 使用以下 [unicode] 字符，因为 常用操作系统可能无法一致支持这些字符：

  • 斜线：/ (U+002F)

  • 引号：" (U+0022)

  • 星号：* (U+002A)

  • 作为最后一个字符的句点：. (U+002E)

  • 冒号：: (U+003A)

  • 小于号：< (U+003C)

  • 大于号：> (U+003E)

  • 问号：? (U+003F)

  • 反斜线：\ (U+005C)

  • 竖线：| (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)

    • 基本多文种平面的最后两个码点 (U+FFFE 和 U+FFFF)

    • 辅助平面末尾的最后两个码点 (U+1FFFE, U+1FFFF … U+EFFFE, U+EFFFF)

  • 特殊字符 (U+FFF0 … U+FFFF)

  • 辅助私用区-A (U+F0000 … U+FFFFF)

  • 辅助私用区-B (U+100000 … U+10FFFF)

  注

  Unicode 字符数据库 [uax44] 还 包括一个已弃用字符列表。 也建议 EPUB 创建者避免使用这些字符， 因为预计 EPUB 一致性检查器会标记其 使用。

• 为了兼容较旧的阅读系统，文件名 SHOULD NOT 包含 SPACE (U+0020) 字符。

• 同一目录内的所有文件名 MUST 在经过 Unicode 规范等价归一化 [uax15] 然后进行完整大小写折叠 [unicode] 后保持唯一。（更多信息请参阅 Unicode 规范等价大小写折叠 归一化步骤 [charmod-norm]。）

要派生文件路径，给定 OCF 抽象容器中的一个文件或目录 file，应用以下步骤 （使用 [infra] 的术语表示）：

1. 令 path 为一个空列表。
2. 令 current 为 file。
3. 当 current 不是根 目录时：
   1. 将 current 的文件名前置到 path；
   2. 将 current 设置为 current 的父目录。
4. 返回使用 U+002F (/) 字符对 path 进行串联的结果。

容器根 URL是URL [url]，对应于 根目录。它是实现特定的，但 EPUB 创建者 MUST 假定它具有 以下属性：

• 以容器根 URL作为 base来解析“/”的结果是该 容器根 URL。
• 以容器根 URL作为 base来解析“..”的结果是该 容器根 URL。

OCF 抽象容器中文件或目录的 内容 URL，是以容器根 URL 作为 base解析该文件的文件路径所得的结果。

字符串 url 是一个valid-relative-ocf-URL-with-fragment string，如果 它是一个 path-relative-scheme-less-url string，可选地后跟 U+0023 (#) 和一个 url-fragment string，并且如果以下 步骤返回 true：

1. 将容器根 URL设置为 https://a.example.org/A/。

   说明

   该算法的目标是检测 url 是否可能被视为 “泄漏”到容器之外。为此，使用标准的 URL 解析算法和人工构造的根 URL； 对“泄漏”的检测通过比较解析结果与第一个测试路径 段（A）的存在情况来完成。（注意，为了此算法的目的， 人工容器根 URL 故意通过使用第一个测试 路径段而违反所要求的属性。）

2. 令 base 为必须用于解析 url 的 基准 URL，该基准由使用 url 的上下文（文档或环境）定义，并根据 包文档的内容 URL 确定 （参见 5.2 解析 包文档中的 URL）。

   说明

   如果 URL 位于包文档中，则 base 变量设置为 包文档的内容 URL。如果文档位于 META-INF 目录中，则 base 变量设置为 容器根 URL（参见 4.2.6.2 解析 META-INF 目录中的 URL）。如果 URL 位于 XHTML 内容 文档中，用于解析的基准 URL 由 HTML 标准定义。通常，它会是内容文档的 内容 URL（除非使用了不建议使用的 base 元素）。

3. 令 testURLRecord 为以 base 对 url 应用 URL parser 的结果。
4. 令 testURLStringA 为对 testURLRecord 应用 URL Serializer 的结果。

5. 将容器根 URL设置为 https://b.example.org/B/。

   说明

   之所以使用不同且人工构造的容器根 URL 设置重复相同步骤两次， 是为了避免在 url 字符串也包含 /A/ 时可能发生的冲突。例如，考虑 url 为 ../../A/doc.xhtml 的情况。

6. 将 base 设置为必须用于解析 url 的 基准 URL，该基准由使用 url 的上下文（文档或环境）定义，并根据包文档的内容 URL 确定（参见 5.2 解析 包文档中的 URL）。
7. 将 testURLRecord 设置为以 base 对 url 应用 URL parser 的结果。
8. 令 testURLStringB 为对 testURLRecord 应用 URL Serializer 的结果。

9. 如果 testURLStringA 不是以 https://a.example.org/ 开头，或 testURLStringB 不是以 https://b.example.org/ 开头， 则返回 true。

   说明

   如果任何结果都不共享测试 URL 主机，则意味着 url 或其基准 URL（例如在 HTML 中，如果用 base 元素显式设置）是绝对的，并指向 容器之外。这是可接受的。

10. 如果 testURLStringA 以 https://a.example.org/A/ 开头，且 testURLStringB 以 https://b.example.org/B/ 开头，则返回 true。

    说明

    第一个测试路径段（分别为 A 和 B）的存在表明 URL 没有泄漏到容器之外。

11. 返回 false。

在 OCF 抽象容器中，任何 URL 字符串 MUST 是一个 absolute-url-with-fragment string 或一个 valid-relative-ocf-URL-with-fragment string。

此外，所有 relative-URL-with-fragment strings [url] 在解析后，MUST 等于 OCF 抽象容器中某个现有文件的内容 URL。

OCF ZIP 容器使用 [zip] 指定的 ZIP 格式，但具有以下 约束和说明：

• OCF ZIP 容器的内容 MUST 是一个符合要求的 OCF 抽象容器。

• OCF ZIP 容器 MUST NOT 使用 ZIP 应用 注记 [zip] 中允许 ZIP 文件跨多个存储介质展开或 分拆为多个文件的特性。

• OCF ZIP 容器 MUST 在 ZIP 归档内仅包含存储 （未压缩）和 Deflate 压缩的 ZIP 条目。

• OCF ZIP 容器 MAY 使用应用注记 [zip] 第 V 节 G 小节中定义为 “Version 1”的 ZIP64 扩展，并且 SHOULD 仅在内容需要时使用这些 扩展。

• OCF ZIP 容器 MUST NOT 使用 ZIP 格式定义的加密 特性；相反，加密 MUST 使用 4.2.6.3.2 加密文件 (encryption.xml)中描述的特性完成。

• OCF ZIP 容器 MUST 使用 UTF-8 [unicode] 编码文件系统 名称。

以下约束适用于 OCF ZIP 容器归档中的特定字段：

• 在本地文件头表中，EPUB 创建者 MUST 将 version needed to extract 字段设置为值 10、 20 或 45，以匹配给定文件所需的最大版本级别 （例如，Deflate 为 20，ZIP64 为 45）。

• 在本地文件头表中，EPUB 创建者 MUST 将 compression 方法字段设置为值 0 或 8。

EPUB 创建者 MUST 将 mimetype 文件作为 OCF ZIP 容器中的第一个文件包含进去。此外：

• mimetype 文件的内容 MUST 是使用 US-ASCII [us-ascii] 编码的 MIME 媒体类型 [rfc2046] 字符串 application/epub+zip。
• mimetype 文件 MUST NOT 包含任何前导或尾随的 填充或空白。
• mimetype 文件 MUST NOT 以 Unicode 字节 顺序标记 U+FEFF 开始。
• EPUB 创建者 MUST NOT 压缩或加密 mimetype 文件。
• EPUB 创建者 MUST NOT 在其 ZIP 头中包含额外字段。

EPUB 创建者 MUST 从 唯一 标识符派生混淆算法中使用的密钥。

如 XML 1.0 规范第 2.3 节 [xml] 所定义， 所有空白字符都 MUST 从此标识符中移除——具体而言，是 Unicode 码点 U+0020、U+0009、U+000D 和 U+000A。

EPUB 创建者 MUST 按 Secure Hash Standard [fips-180-4] 的规定， 生成所得字符串 UTF-8 表示的 SHA-1 摘要。他们随后可以将 此摘要用作算法的密钥。

用于混淆字体的算法包括修改字体文件的前 1040 字节（约 1KB）。 （如果字体文件小于 1040 字节——这种情况不太可能——此过程 将修改整个文件。）

要混淆原始数据，将对原始字体文件的第一个字节和 混淆密钥的第一个字节执行逻辑异或 (XOR) 的结果， 存储为嵌入字体的第一个字节。

对源和密钥的下一个字节重复此过程，并继续处理密钥中的所有字节。 此时，该过程从密钥的第一个字节和源的第 21 个字节开始继续。 一旦以这种方式编码了 1040 字节（或到达源末尾）， 即将源中的任何剩余数据直接复制到目标。

EPUB 创建者 MUST 在压缩并添加到 OCF ZIP 容器之前混淆字体。注意，由于混淆不是加密，此要求并不违反 4.2.6.3.2 加密文件 (encryption.xml)中要求在 加密字体之前压缩字体的要求。

以下伪代码展示了混淆算法。

1. set ocf to OCF ZIP container file
2. set source to font file
3. set destination to obfuscated font file
4. set keyData to key for file
5. set outer to 0
6. while outer < 52 and not (source at EOF)
   1. set inner to 0
   2. while inner < 20 and not (source at EOF)
      1. read 1 byte from source (Assumes read advances file position)
      2. set sourceByte to result of read
      3. set keyByte to byte inner of keyData
      4. set obfuscatedByte to (sourceByte XOR keyByte)
      5. write obfuscatedByte to destination
      6. increment inner
      end while
   3. increment outer
   end while
7. if not (source at EOF) then
   1. read source to EOF
   2. write result of read to destination
   end if
8. Deflate destination
9. store destination as source in ocf

虽然从技术上说不是加密数据，但所有混淆字体 MUST 在 随 EPUB 出版物一起提供的 encryption.xml 文件中有一个条目（参见 4.2.6.3.2 加密文件 (encryption.xml)）。

EPUB 创建者 MUST 为每个混淆字体指定一个 EncryptedData 元素。 每个 EncryptedData 元素 MUST 包含一个子 EncryptionMethod 元素，其 Algorithm 属性的值为 http://www.idpf.org/2008/embedding。此属性的存在表示使用 本规范中描述的算法。

EPUB 创建者 MUST 在 CipherData 元素的子 CipherReference 中列出混淆字体的路径。由于混淆算法仅限于字体， CipherReference 元素的 URI 属性 MUST 引用一个字体核心媒体类型资源。

为防止将嵌入字体轻易复制到其他 EPUB 出版物中，EPUB 创建者 MUST NOT 在 encryption.xml 文件中提供混淆密钥。

指定承载元素及其后代的文本内容和 属性值的基方向 [bidi]。

允许的值为：

• ltr — 从左到右的基方向；
• rtl — 从右到左的基方向；以及
• auto — 基方向使用 Unicode Bidi Algorithm [bidi] 确定。

当 EPUB 创建者省略该属性或使用无效值时， 阅读系统会假定其值为 auto。

允许用于： collection、 Dublin Core 元素、 meta 和 package。

一个引用 资源的有效 URL 字符串 [url]。

该 URL 字符串 MUST NOT 通过包 文档中的元素引用资源（例如，通过 manifest item 或 spine itemref 声明）。

允许用于： item 和 link。

元素的 ID [xml]， 它 MUST 在文档 作用域内唯一。

允许用于： collection、 Dublin Core 元素、 item、 itemref、 link、 manifest、 meta、 package 和 spine。

一个媒体类型 [rfc2046]， 它指定所引用资源的类型和格式。

允许用于： item 和 link。

一个以空格分隔的属性值列表。

有关该属性的保留词汇表， 请参阅各元素的定义。

允许用于： item、 itemref 和 link。

在当前表达式与其值所标识的元素或资源之间建立关联。 EPUB 创建者 MUST 使用一个 path-relative-scheme-less-URL string 作为值，可选地后跟 U+0023 (#) 和一个 URL-fragment string，用于 引用其所描述的资源或元素。

refines 属性是否为 OPTIONAL 取决于所表达的 元数据类型。省略时，该元素定义一个主要表达式。

当创建有关出版物资源的表达式时，refines 属性 SHOULD 指定一个片段标识符，引用该资源 manifest 条目的 ID [xml]。

细化链 MUST NOT 包含循环引用或自引用。

允许用于： link 和 meta。

指定承载元素及其后代的文本内容和属性值的语言， 如 [xml] 的 2.12 Language Identification 一节中定义。每个 xml:lang 属性的值 MUST 是一个 格式良好的语言标签 [bcp47]。

允许用于： collection、 Dublin Core 元素、 meta 和 package。

metadata 元素封装元信息。

元素名称：

metadata

用法：

package 的 REQUIRED 第一个子元素。

属性：

无

内容模型：

任意顺序：

• dc:identifier [一个或多个]

• dc:title [一个或多个]

• dc:language [一个或多个]

• Dublin Core 可选元素 [0 个或多个]

• meta [一个或多个]

• OPF2 meta [0 个或多个] （旧版）

• link [0 个或多个]

包文档的 metadata 元素有两个 主要功能：

1. 提供一组最小的元信息，供阅读系统用于在内部 编目 EPUB 出版物，并使 其可供用户使用（例如，在 书架中呈现）。

2. 提供对控制内容布局和显示所需的所有渲染元数据的访问 （例如，固定布局属性）。

包文档不提供复杂的元数据编码能力。如果 EPUB 创建者需要提供更详细的信息， 他们可以使用 link 元素关联元数据记录（例如， 符合 [onix] 等国际标准的记录， 或为自定义目的创建的记录）。 这种方法允许阅读系统以元数据的原生形式处理它， 从而避免转换为最小包文档结构所可能带来的问题和信息丢失。

秉持这一理念，包文档只有以下 最小元数据要求：它 MUST 包含 [dcterms] dc:title、 dc:identifier 和 dc:language 元素，以及 [dcterms] dcterms:modified 属性。所有其他元数据均为 OPTIONAL。

meta 元素提供了一种通用机制，用于包含来自任何词汇表的元数据属性。 虽然 EPUB 创建者 MAY 将此机制用于任何元数据目的， 但他们通常会用它来包含 EPUB 规范中定义的渲染元数据。

Dublin Core 元素 [dcterms] 和 meta 元素具有强制的子文本内容 [dom]。在这些元素的描述中，本 规范将此内容称为 该元素的值。

这些元素在前导和尾随 ASCII 空白 [infra] 被去除后，MUST 具有非空值（即它们必须至少包含一个 非空白字符）。

这些元素值中的空白没有意义。在处理期间，一个或多个空白 字符序列会折叠为单个 空格 [infra]。

meta 元素提供了一种通用方式，用于包含包元数据。

元素名称：

meta

用法：

作为 metadata 元素的子元素。可重复。

属性：

• dir [可选]

• id [可选]

• property [必需]

• refines [可选]

• scheme [可选]

• xml:lang [可选]

内容模型：

文本

每个 meta 元素定义一个元数据表达式。 property 属性取一个定义该表达式所作陈述的 property 数据类型值，而元素的文本内容 表示断言。（更多 信息请参阅 D.1 词汇表关联机制。）

本规范定义了两种元数据表达式类型，EPUB 创建者可以使用 meta 元素定义它们：

• 主要表达式是指 meta 元素中定义的表达式确立了 EPUB 出版物某个方面的表达式。省略 refines 属性的 meta 元素定义一个主要 表达式。
• 子表达式是指 meta 元素中定义的表达式使用 refines 属性与另一个表达式或资源关联，以增强其含义。子表达式可以细化一个 媒体片段，例如，通过表示其持续时间；或细化一个创建者或贡献者 表达式，通过定义该人的角色。

EPUB 创建者 MAY 使用子表达式来细化其他 子表达式的含义，从而 创建信息链。

Meta Properties Vocabulary 是与 property 属性一起使用的默认词汇表。

EPUB 创建者 MAY 按 D.1 词汇表关联 机制中的定义，添加来自其他词汇表的术语。

scheme 属性标识 EPUB 创建者从中取得元素值的系统或方案。该属性的值 MUST 是一个 property 数据类型 值，并解析为定义该方案的 资源。scheme 属性没有默认词汇表（即所有值都需要一个 前缀）。

metadata 节 MUST 恰好包含一个 dcterms:modified 属性 [dcterms]， 其中包含最后修改日期。此属性的值 MUST 是 [iso8601-1] 中日期和一天中时间的完整表示，并匹配扩展格式： YYYY-MM-DDThh:mm:ssZ

EPUB 创建者 MUST 以协调世界时 (UTC) 表示 最后修改日期，并且 MUST 以“Z”（Zulu）时区指示符结束。

EPUB 创建者每当对 EPUB 出版物进行更改时，都应更新最后修改日期。

EPUB 创建者 MAY 在包文档元数据中指定附加的 modified 属性， 但它们 MUST 具有不同的主语（即它们需要一个 refines 属性，用于 引用某个元素或资源）。

link 元素将资源（例如元数据 记录）与 EPUB 出版物关联起来。

元素名称：

link

用法：

作为 metadata 的子元素。 可重复。

属性：

• href [必需]

• hreflang [可选]

• id [可选]

• media-type [有条件地必需]

• properties [可选]

• refines [可选]

• rel [必需]

内容模型：

空

metadata 元素 MAY 包含零个或多个 link 元素，每个元素 都在其 REQUIRED href 属性中标识一个出版物资源或一个链接资源的位置。

从 link 元素引用的资源，仅在以下情况下才是 出版物资源：

• 从 spine 引用；或

• 包含或嵌入在 EPUB 内容文档中（例如，序列化为 RDFa [rdfa-core] 或 JSON-LD [json-ld11] 并嵌入 [html] script 元素中的元数据记录）。

在所有其他情况下（例如，链接到独立的 [onix] 记录时），所引用的 资源不是出版物资源（即不受核心 媒体类型要求约束），并且 EPUB 创建者 MUST NOT 将它们列入 manifest。

EPUB 创建者 MAY 将链接资源放置在 EPUB 容器 内部或外部，但应考虑到 阅读系统不被要求检索 EPUB 容器之外的资源。

当链接资源位于 EPUB 容器之外时，media-type 属性是 OPTIONAL，因为 同一 URL [url] 可以提供多种媒体类型。EPUB 创建者 MUST 为 EPUB 容器内的所有链接资源指定 该属性。

OPTIONAL hreflang 属性 标识链接资源的语言。该值 MUST 是一个格式良好的语言 标签 [bcp47]。

REQUIRED rel 属性取一个 以空格分隔的属性值列表，用于确立链接 资源与 EPUB 出版物之间的关系。

media-type 属性的值并不总是足以标识链接资源的类型 （例如，许多基于 XML 的记录格式使用媒体类型 “application/xml”）。为帮助阅读系统标识此类 通用资源，EPUB 创建者 MAY 在 properties 属性中指定一个语义标识符。

Metadata Link Vocabulary 是用于 rel 和 properties 属性的默认词汇表。

EPUB 创建者 MAY 按 D.1 词汇表 关联机制中的定义，添加来自其他词汇表的关系和属性。

EPUB 创建者 MAY 提供一个或多个链接元数据记录。

除完整记录外，EPUB 创建者 MAY 还可以使用 link 元素来标识 以替代格式提供的单个元数据属性。

manifest 元素提供用于渲染内容的出版物资源的完整列表。

元素名称：

manifest

用法：

package 的 REQUIRED 第二个子元素，位于 metadata 之后。

属性：

id [可选]

内容模型：

item [一个或多个]

除包 文档外， manifest MUST 列出所有出版物资源，无论它们是 容器资源还是远程资源。

由于包文档已经由 container.xml 文件标识， manifest MUST NOT 为其指定 item 元素 （即，自引用没有任何作用）。

item 元素表示一个出版物资源。

元素名称：

item

用法：

作为 manifest 的子元素。 可重复。

属性：

• fallback [有条件地必需]

• href [必需]

• id [必需]

• media-overlay [可选]

• media-type [必需]

• properties [可选]

内容模型：

空

每个 item 元素通过其 href 属性中的 URL [url] 标识一个出版物资源。该值 MUST 是 absolute- 或 path-relative-scheme-less-URL string [url]。EPUB 创建者 MUST 确保每个 URL 在解析后在 manifest 作用域内唯一。

item 元素所标识的出版物资源 MUST 符合由 media-type 属性中提供的 MIME 媒体类型 [rfc2046] 推断出的适用规范。对于核心媒体类型资源，EPUB 创建者 MUST 使用 3.2 核心媒体类型中指定的媒体类型。

fallback 属性指定被引用出版物资源的回退。 fallback 属性的 IDREF [xml] 值 MUST 解析为 manifest 中的另一个 item。

一个 item 的回退 MAY 指定回退到另一个 item，依此类推，从而创建一条回退选项链。有关使用回退链的 附加要求，请参阅 3.5.1 Manifest 回退。

media-overlay 属性取一个 IDREF [xml]， 用于标识此 item 所描述资源的媒体叠加文档。 更多信息请参阅 9.3.5 媒体叠加打包。

bindings 元素定义一组用于本规范不支持的媒体类型的自定义处理器。

使用该元素已弃用。

更多信息请参阅 [epubpublications-301] 中的 bindings 元素定义。

spine 元素定义一个有序的manifest item 引用列表，用于表示默认阅读顺序。

元素名称：

spine

用法：

package 的 REQUIRED 第三个子元素，位于 manifest 之后。

属性：

• id [可选]

• page-progression-direction [可选]

• toc [可选] （旧版）

内容模型：

itemref [一个或多个]

spine MUST 指定至少一个 EPUB 内容文档或外来内容文档。

EPUB 创建者 MUST 在 spine 中列出从 spine 中的出版物资源超链接到的所有 EPUB 和 外来内容文档，其中超链接包括任何要求 用户离开当前资源进行导航的链接机制。常见的超链接机制包括 [html] a 和 area 元素的 href 属性，以及脚本化链接（例如，使用 DOM 事件和/或表单元素）。列出被超链接资源的要求会 递归适用（即 EPUB 创建者必须列出从被超链接文档超链接到的 所有 EPUB 和外来内容文档，依此类推）。

EPUB 创建者还 MUST 在 spine 中列出从 EPUB 导航文档超链接到的所有 EPUB 和外来 内容文档， 无论 EPUB 创建者是否 将 EPUB 导航文档包含在 spine 中。

page-progression-direction 属性设置内容流动的全局方向。允许的值为 ltr（从左到右）、rtl（从右到左）和 default。 当 EPUB 创建者指定 default 值时，表示他们没有偏好， 阅读系统可以选择渲染方向。

虽然 page-progression-direction 属性设置全局流动方向， 但单个 EPUB 内容文档以及 EPUB 内容文档的部分内容 MAY 覆盖此设置 （例如，通过 writing-mode CSS 属性）。阅读系统也可以提供 覆盖默认方向的机制（例如，允许应用 备用样式表的按钮或设置）。

旧版 toc 属性取一个 IDREF [xml]， 用于标识 表示 NCX 的 manifest item。

itemref 元素在默认阅读顺序中标识一个EPUB 内容文档或外来内容文档。

元素名称：

itemref

用法：

作为 spine 的子元素。 可重复。

属性：

• id [可选]

• idref [必需]

• linear [可选]

• properties [可选]

内容模型：

空

每个 itemref 元素 MUST 通过其 idref 属性中的 IDREF [xml]， 引用 manifest 中某个 item 的 ID [xml]。 item 元素 ID MUST NOT 被引用超过一次。

每个被引用的 manifest item MUST 是以下二者之一：a) 一个 EPUB 内容文档，或 b) 一个在其 manifest 回退链中包含 EPUB 内容 文档的外来内容文档。

linear 属性表示所引用的 item 是否包含有助于主要阅读顺序并且 阅读系统必须按顺序读取的内容 （“yes”），或辅助内容， 这些内容增强或补充主要内容，阅读系统可在顺序之外访问 （“no”）。辅助内容的示例包括注释、描述和 答案 键。

linear 属性允许阅读系统区分用户 应作为默认阅读顺序的一部分访问的内容与补充内容，阅读 系统可以例如在弹出窗口中呈现这些补充内容，或在听觉渲染中省略它们。

指定内容为非线性并不要求阅读系统以 特定方式呈现它；不过，它只是对目的的提示。阅读系统可以在 非线性内容出现在 spine 中的位置呈现它，例如，也可以跳过它，直到用户到达 spine 末尾。

线性 itemref 元素是指其 linear 属性值显式设置为“yes”，或省略该 属性的元素 — 阅读系统会为没有该属性的 itemref 元素假定值“yes”。spine MUST 包含 至少一个 线性 itemref 元素。

EPUB 创建者 MUST 提供一种 访问所有非线性内容的方式（例如，内容中的超链接，或来自 EPUB 导航文档的超链接）。

Spine Properties Vocabulary 是 properties 属性的默认词汇表。

EPUB 创建者 MAY 按 D.1 词汇表关联 机制中的定义，添加来自其他词汇表的术语。

collection 元素定义一组相关资源。

元素名称：

collection

用法：

package 的 OPTIONAL 第六个元素。可重复。

属性：

• dir [可选]

• id [可选]

• role [必需]

• xml:lang [可选]

内容模型：

按以下顺序：metadata [0 或 1]，( collection [一个或多个] 或 ( collection [0 个或多个]，link [一个或多个] ))

collection 元素允许 EPUB 创建者 将资源组装成逻辑 组，以用于各种潜在用途：将拆分在多个 EPUB 内容文档中的内容 重新组装为有意义的内容单元（例如， 分布在多个文档中的索引）、标识用于专门目的的资源（例如，预览内容），或 收集呈现有关 EPUB 出版物的附加信息的资源。

EPUB 创建者 MUST 在每个 collection 元素的 role 属性中标识其角色，该属性的值 MUST 是一个或多个 NMTOKEN [xmlschema-2] 和/或 absolute-URL-with-fragment strings [url]。

编写专门集合的要求由其各自的规范定义。

创建新的 collection 元素角色现已弃用。

有关创建专门集合的更多 信息（包括其使用要求和 限制），请参阅 [epubpackages-32] 中的 collection 元素定义。

包文档的 legacy 特性仅从 EPUB 2 保留下来，以允许 EPUB 创建者创作能够在一定 程度上在阅读系统中运行的内容， 这些阅读系统仅支持 EPUB 2 出版物。

这些特性主要是为了解决 EPUB 3 阅读系统开发期间的重叠时期而添加的， 因为当时用户仍有很高概率会在 EPUB 2 阅读系统上打开 EPUB 3 出版物。

由于现在仅处理 EPUB 2 出版物的阅读系统已经很少见，EPUB 创建者在投入精力 添加这些旧版特性之前，应考虑其出版物仍会在这类较旧设备上 打开的可能性。

EPUB 创建者 MAY 为与 EPUB 2 阅读系统兼容 而包含本节中定义的旧版特性。

EPUB 3 阅读系统在向用户呈现出版物时不会使用这些特性。

meta 元素 [opf-201] 提供一种为 EPUB 2 阅读系统包含 通用元数据的方式。

更多 信息请参阅 [opf-201] 中的 meta 元素定义。

guide 元素 [opf-201] 为 EPUB 2 阅读系统中的关键结构提供机器可处理的 导航。

更多信息请参阅 [opf-201] 中的 guide 元素 定义。

NCX [opf-201] 为 EPUB 2 阅读系统提供目录。

更多信息请参阅 [opf-201] 中的 NCX 定义。

一个XHTML 内容文档：

• MUST 是一个符合 XML 语法的 [html] 文档。

• MUST 符合 [html] 为所有 文档构造定义的一致性 标准，除非在 6.1.4 HTML 偏离和约束中被明确覆盖。

• MAY 包含按 6.1.3 HTML 扩展中定义的 [html] 语法扩展，并且 MUST 符合其中定义的所有内容一致性约束。

除非另有规定，XHTML 内容文档继承 [html] 规范中关于语义、 结构和处理行为的所有定义。

本节定义 EPUB 3 XHTML 内容文档对底层 [html] 文档模型的扩展。

本节定义适用于 EPUB 3 XHTML 内容文档的底层 [html] 文档 模型的偏离和约束。

SVG 内容文档 MUST 是一个符合要求的 SVG 独立文件 [svg]，并符合 6.2.3 SVG 限制中表达的所有内容一致性约束。

本规范按如下方式限制SVG 内容文档和通过包含嵌入在 XHTML 内容文档中的 SVG的内容模型：

• [svg] foreignObject 元素：

  • MUST 包含 [html] 流式内容，或恰好一个 [html] body 元素。

    注

    对于通过包含嵌入的 SVG， 根据 [html] 中定义的 SVG 限制， 不允许使用 body 元素。

  • MUST 包含一个 有效的文档片段， 该片段符合 6.1.2 XHTML 要求中定义的 XHTML 内容文档模型。

• 如果 [svg] title 元素包含 带标记的文本，则该标记 MUST 仅包含在 HTML 命名空间 [infra] 中声明的元素。

  注

  虽然 [svg] title 元素允许标记 元素，但对此 特性的支持有限。建议 EPUB 创建者使用纯文本 标题，以获得 最大的互操作性。

• 指定时， epub:type 属性 MUST 只能包含在可渲染元素 [svg] 上。

  注

  SVG 内容模型允许作者包含 带命名空间的属性，因此本规范无需允许 epub:type 属性或词汇表关联 机制。

  不过，通过引用嵌入和通过包含嵌入的 SVG 之间的一个关键区别是： 通过包含嵌入的 SVG 不能在其根 svg 元素上具有 epub:prefix 属性 [svg]。更多信息请参阅 D.1.4 prefix 属性。

EPUB 出版物的主导航层级定义在一个 nav 元素中 [html]，其 epub:type 属性设置为值“toc” [epub-ssv-11]（即 toc nav 元素）。此元素 在概念上对应于印刷作品中的目录——它提供到出版物主要结构章节的 导航。

EPUB 创建者 SHOULD 对 toc nav 元素中的引用进行排序，使其 同时反映：

• 被引用的 EPUB 内容文档在 spine 中的顺序；以及

• 其各自EPUB 内容文档中目标元素的顺序。

页面列表提供到内容中静态页面边界的导航。这些边界可以 对应于打印等静态分页来源，也可以专门为 EPUB 出版物定义。

页面列表定义在一个 nav 元素 [html] 中，其 epub:type 属性设置为 值“page-list” [epub-ssv-11]（即 page-list nav 元素）。

page-list nav 元素在 EPUB 导航文档中是 OPTIONAL，且 MUST NOT 出现超过一次。

page-list nav 元素 SHOULD 只包含一个 ol 后代 （即，没有嵌套子列表）。

EPUB 创建者 MAY 使用 pagebreak 术语 [epub-ssv-11]， 在其各自的 EPUB 内容文档中标识 page-list 引用的目标。

Landmarks 标识内容的基本结构组件，使阅读系统 能够为用户提供对它们的高效访问（例如，通过用户 界面中的专用按钮）。

Landmarks 定义在一个 nav 元素 [html] 中，其 epub:type 属性设置为 值“landmarks” [epub-ssv-11]（即 landmarks nav 元素）。

landmarks nav 元素在 EPUB 导航文档中是 OPTIONAL，且 MUST NOT 出现超过一次。

landmarks nav 元素 SHOULD 只包含一个 ol 后代 （即，没有嵌套子列表）。

epub:type 属性在 landmarks nav 元素的 a 后代元素上是 REQUIRED。landmarks nav 元素内每个链接目标的结构语义由此属性的值确定。

landmarks nav MUST NOT 包含多个具有相同 epub:type 值且引用同一资源或其片段的条目。

EPUB 创建者应将他们在 landmarks nav 中定义的项目数量限制为阅读系统可能会在其用户界面中使用的项目。 该元素并不用于重复目录。

建议在可用时包含以下 landmarks：

• bodymatter [epub-ssv-11]——阅读 系统常使用此 landmark，在用户开始阅读时自动让用户跳过前置内容。
• toc [epub-ssv-11]——如果 目录在 spine 中可用，阅读系统可以使用此 landmark 将用户 带到包含目录的文档。

landmarks nav 中还可包含其他关键参考章节， 例如索引和词汇表。

虽然 landmarks nav 旨在供阅读系统使用，但 EPUB 创建者仍应 确保 landmarks nav 的标签可供人类阅读。阅读 系统可以直接向用户公开这些链接。

EPUB 导航文档 MAY 除前几节定义的 toc、page-list 和 landmarks nav 元素之外，还包含一个或多个 nav 元素。如果这些 nav 元素旨在供 阅读系统 处理，则它们 MUST 具有 epub:type 属性，并受 7.3 nav 元素：限制中定义的内容模型 限制约束。

本规范不对任何附加 nav 元素的语义施加限制：它们 MAY 表示任意信息 域的导航语义，并且它们 MAY 包含具有同质或异质语义的链接目标。

rendition:flow 属性指定 EPUB 创建者 对阅读系统应如何处理内容溢出的偏好。

当在 meta 元素上指定 rendition:flow 属性时，它表示 EPUB 创建者对 溢出内容处理的全局偏好（即，适用于所有 spine 项）。EPUB 创建者 MAY 表明对动态分页或滚动的偏好。对于滚动内容，还可以 指定连续的EPUB 内容文档是要渲染为一个 连续滚动视图，还是每个都单独渲染（即，每个之间有一个动态 分页符）。

EPUB 创建者 MUST 对 rendition:flow 属性使用以下值之一：

paginated

动态分页所有溢出内容。

scrolled-continuous

渲染所有 EPUB 内容文档，使溢出内容可滚动，并且 EPUB 出版物从一个 spine 项到另一个 spine 项呈现为一个连续 滚动（除非被局部覆盖）。

注意，EPUB 创建者 SHOULD NOT 创建其中不同资源具有 不同块流方向的出版物，因为 EPUB 阅读 系统中的连续滚动呈现会出现问题。

scrolled-doc

渲染所有 EPUB 内容文档，使溢出内容可滚动，并且每个 spine 项呈现为单独的可滚动文档。

auto

使用阅读系统默认方法或用户偏好渲染溢出内容， 以适用者为准。默认值。

注意，当两个可重排 EPUB 内容文档在 spine 中连续出现时，其 [html] body 元素的默认渲染与 page-break-before 属性 [csssnapshot] 被设置为 always 一致。除了使用 rendition:flow 属性外，如果 阅读系统支持此类覆盖，EPUB 创建者 MAY 通过适当的样式表 声明覆盖此行为。

EPUB 创建者 MUST NOT 声明 rendition:flow 属性超过 一次。

他们还 MUST NOT 使用 refines 属性声明该属性。有关为 单个 EPUB 内容文档设置该属性的信息，请参阅 8.3.1.1 Spine 覆盖。

rendition:align-x-center 属性指定给定的 spine 项应在视口或跨页中水平居中。

该属性 MUST NOT 被全局设置为适用于所有 EPUB 内容文档（即，在没有 refines 属性的 meta 元素中）。它只能通过 itemref 元素的 properties 属性，作为单个 EPUB 内容文档的 spine 覆盖使用。

一个媒体叠加文档：

• MUST 对 G.3 媒体叠加 模式中定义的媒体叠加 模式有效，并符合 9.2.2 媒体叠加文档定义中表达的所有内容一致性 约束。

• MAY 引用多个 EPUB 内容文档， 但多个媒体叠加文档 MUST NOT 引用同一个 EPUB 内容 文档。

除非另有规定，本节定义的所有元素 [xml] 都位于 https://www.w3.org/ns/SMIL 命名空间 [xml-names] 中。

为了在媒体叠加文档中表达结构语义，EPUB 创建者 MAY 在 epub:type 属性上指定 par、 seq 和 body 元素。

epub:type 属性有助于阅读系统执行适合所指示语义类型的行为。 这些行为的示例包括可跳过性和可退出性以及表格阅读模式 [epub-rs-33]。

媒体叠加文档 MAY 对 epub:type 属性使用适用的词汇表 关联机制来定义附加 语义。

EPUB 创建者 MAY 使用作者定义的类， 在 CSS 样式表中表达当前正在播放的 EPUB 内容文档元素的视觉 渲染信息。

使用时，EPUB 创建者 MUST 使用 包文档中的 active-class 和 playback-active-class 属性声明类名。

EPUB 创建者 MUST 在其定义的每个属性中恰好定义一个 CSS 类名。 每个属性 MUST 定义一个有效的 CSS 类 名，且不包括任何选择器 [css2]。 本规范不保留用于这些 属性的名称。

EPUB 创建者 MAY 为指定的 CSS 类定义任何 CSS 属性， 但必须确保 每个具有关联媒体叠加文档的 EPUB 内容文档都包含一个 CSS 样式表（嵌入或链接），其中包含这些类定义。在缺少此类 定义时，阅读系统可能提供自己的样式，或 完全不提供样式。

EPUB 创建者 MUST NOT 将 active-class 和 playback-active-class 属性与 refines 属性结合使用， 因为它们始终适用于整个 EPUB 出版物。

阅读时，用户可能希望打开或关闭内容的某些特性，例如 脚注、页码或其他类型的次要内容。此特性称为 可跳过性。阅读系统使用媒体叠加 元素的 epub:type 属性提供的语义 信息来决定何时向用户提供可跳过特性的选项。

EPUB 创建者 MAY 使用以下 语义来启用可跳过性：

• footnote [epub-ssv-11]

• endnote [epub-ssv-11]

• pagebreak [epub-ssv-11]

不过，此列表并非穷尽。它表示来自结构语义 词汇表 [epub-ssv-11] 的术语，阅读 系统最有可能为这些术语提供 可跳过性选项。

可退出项目是嵌套结构，例如表格和列表，用户可能希望跳过 它们，并从紧接该嵌套结构之后的位置继续阅读。可退出性 特性不同于可跳过性特性，因为它并不启用或禁用整类 项目，而是提供从其中退出的方式（例如，用户可以先听一部分内容，然后 选择退出）。

EPUB 创建者 MAY 使用以下 语义来启用可退出性：

• table [epub-ssv-11]

• list [epub-ssv-11]

• figure [epub-ssv-11]

• aside [epub-ssv-11]

不过，此列表并非穷尽。它表示来自结构语义 词汇表 [epub-ssv-11] 的术语，阅读系统最有可能为这些术语提供 可退出性选项。