EPUB 3.4

清单回退是 包 文档的一项特性，它创建一个替代 资源的 manifest fallback chain， 阅读系统可用它代替 顶级内容 文档，从而在 书脊中的默认资源不受支持时选择一种可呈现的格式。

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

外来内容文档 MUST 指定一条回退链，该回退链 MUST 至少包含一个 EPUB 内容文档，以确保阅读 系统始终可以呈现 书脊项。

EPUB 内容文档 MAY 指定回退。例如，为 脚本化内容提供回退。

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

清单回退链 MUST NOT 包含自引用或对链中 item 元素的循环 引用。

以下各节对 [html] 中特定元素的内在回退要求 提供说明。

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

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

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

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

OCF 抽象容器内的所有其他文件 MAY 存储在 根目录后代中的任何 位置，前提是它们不在 META-INF 目录内。EPUB 出版物 MUST NOT 包含对 META-INF 目录中文件的引用。

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

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

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

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

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

  • 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）

    • 基本多文种平面的最后两个码位 （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 Character Database [uax44] 包含一个已弃用 字符 列表。也建议避免使用这些字符，因为预计 EPUB 符合性检查器会 标记其使用。

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

• 同一目录中的所有文件名在经过 Unicode 规范归一化 [uax15] 后再进行完整大小写折叠 [unicode]，MUST 保持唯一。（更多信息请参阅 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]，指向根目录。 尽管容器根 URL 是实现专用的，但它 MUST 具有 以下 属性：

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

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

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

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

   解释

   该算法的目标是检测 url 是否可能被视为 “泄漏”到容器之外。为此，标准的 URL 解析算法会与一个 人工根 URL 一起使用；对“泄漏”的检测 是通过比较解析结果与第一个测试路径 段（A）是否存在来完成的。（请注意，为了此算法的目的，人工容器根 URL 会有意 违反必需属性，方式是使用该第一个测试 路径段。）

2. 令 base 为用于解析 url 的base URL，其定义由 使用 url 的上下文（文档或环境）决定，并根据包文档的内容 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 元素）。

3. 令 testURLRecord 为将 URL parser 应用于 url 并使用 base 所得到的结果。
4. 令 testURLStringA 为将 URL Serializer 应用于 testURLRecord 所得到的结果。

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

   解释

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

6. 将 base 设置为用于解析 url 的base URL，其定义由 使用 url 的上下文（文档或环境）决定，并根据包文档的内容 URL 确定（见 5.2 解析 包文档中的 URL）。
7. 将 testURLRecord 设置为将 URL parser 应用于 url 并使用 base 所得到的结果。
8. 令 testURLStringB 为将 URL Serializer 应用于 testURLRecord 所得到的结果。

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

   解释

   如果任一结果不共享测试 URL 主机，意味着 url 或其 base 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 application note [zip] 中允许 ZIP 文件 跨多个存储介质扩展或 拆分为多个文件的功能。

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

• OCF ZIP 容器 MAY 使用 “Version 1” 中定义的 ZIP64 扩展，见 [zip] 的 第 4.3.14 节（“Zip64 end of central directory record”），并且在内容需要时 SHOULD 只使用这些扩展。

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

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

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

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

• 在本地文件头表中，compression method 字段 MUST 设置为 0 或 8。

mimetype 文件 MUST 是 OCF ZIP 容器中的第一个文件。此外：

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

紧凑 URL 数据类型是一种表达 URL [url] 的紧凑方式， 由一个 OPTIONAL 前缀组成，该前缀通过冒号与引用分隔。

本规范从 [rdfa-core] 中定义的 CURIE 数据类型派生出紧凑 URL 数据类型。紧凑 URL 表示 CURIE 的一个子集。

与 CURIE 有两个关键区别：

• 空的 reference 不表示有效的紧凑 URL，尽管按照 上述定义它是有效的（即，只由前缀和 冒号组成的紧凑 URL 是无效的）。

• 空字符串不表示有效的紧凑 URL，尽管按照 上述定义它是有效的。

当紧凑 URL 值省略前缀时，指定的术语取自该属性的默认词汇。

默认词汇是指当需要紧凑 URL时，其术语和 属性 MUST NOT 带有前缀的词汇。

MUST NOT 使用 prefix 属性为与这些词汇关联的 URL 分配前缀。

prefix 属性定义用于紧凑 URL的前缀映射。

prefix 属性的值是一个由空白分隔的列表，包含一个或多个 前缀到 URL 的映射，形式如下：

除保留前缀外，文档中使用的所有前缀 MUST 被声明。prefix 属性 MUST 仅指定在相应格式的 [xml] 根元素上。

当用于包 文档时，该属性没有命名空间。

当用于 EPUB 内容文档和媒体覆盖文档时，该属性 MUST 声明在命名空间 http://www.idpf.org/2007/ops 中。

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

请注意，对于通过包含方式嵌入的 SVG，前缀 MUST 声明在 [html] 根 html 元素上。

为避免冲突，prefix 属性 MUST NOT 用于 声明映射到默认词汇的前缀。

前缀 '_' MUST NOT 被声明，因为本规范保留此 前缀以便未来 与 RDFa [rdfa-core] 处理兼容。

为未来与包文档的替代序列化保持兼容，MUST NOT 为 Dublin Core /elements/1.1/ 命名空间 [dcterms] 声明前缀。只有 [dcterms] 元素允许出现在包文档 元数据中。

保留前缀 MAY 用于期望紧凑 URL的属性，而无需在 prefix 属性中声明它们。

保留前缀 SHOULD NOT 在 prefix 属性中被覆盖。

可以使用哪些保留前缀取决于上下文：

包文档

以下前缀 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/#	用于声明来自媒体覆盖 词汇的属性。
onix	http://www.editeur.org/ONIX/book/codelists/current.html#	用于 scheme 属性，以标识某个值 对应的 ONIX 代码列表。
rendition	http://www.idpf.org/vocab/rendition/#	用于声明来自包 呈现词汇的属性。
schema	http://schema.org/	用于声明来自 Schema.org 词汇的属性。

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

允许的值为：

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

当该属性不存在或值无效时，阅读系统将假定 值为 auto。

允许用于：collection、Dublin Core 元素、 meta， 以及 package。

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

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

允许用于： item 和 link。

该元素的 ID [xml]， 它 MUST 在文档 范围内唯一。

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

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

允许用于： item 和 link。

以空格分隔的紧凑 URL列表。

有关该属性的默认 词汇，请参阅各元素的定义。

允许用于： item、 itemref， 以及 link。

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

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

当创建关于出版资源的表达式时，refines 属性 SHOULD 指定一个片段标识符，引用该资源 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 [1 个或多个]

• dc:title [1 个或多个]

• dc:language [1 个或多个]

• Dublin Core Optional Elements [0 个或多个]

• meta [1 个或多个]

• OPF2 meta [0 个或多个] （过时）

• link [0 个或多个]

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

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

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

包文档不提供复杂的元数据编码能力。如果需要提供更详细的 信息，则可以将元数据记录（例如，符合 [onix] 等国际 标准，或为自定义目的创建）与 EPUB 出版物关联，方式是使用 link 元素。此方法允许阅读系统以其原生形式处理 元数据，避免因转换为使用最小包文档结构而导致的潜在问题和信息损失。

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

meta 元素提供了一种通用机制，用于包含来自任何词汇的元数据属性。 虽然此机制可用于任何 元数据目的，但它通常用于包含 EPUB 规范中定义的呈现和可访问性元数据。

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

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

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

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

元素名称：

meta

用法：

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

属性：

• dir [optional]

• id [optional]

• property [required]

• refines [optional]

• scheme [optional]

• xml:lang [optional]

内容模型：

文本

每个 meta 元素都定义一个元数据表达式。 property 属性接受一个紧凑 URL，用于定义 该表达式中 作出的陈述，而该元素的文本内容表示断言。（更多信息请参阅 5.3 词汇关联 机制。）

本规范定义了两类可以使用 meta 元素定义的 元数据表达式：

• 主表达式是这样一种表达式，其中 meta 元素中定义的表达式确立了 EPUB 出版物的某些方面。省略 refines 属性的 meta 元素定义主 表达式。
• 子表达式是这样一种表达式，其中 meta 元素中定义的表达式通过 refines 属性与另一个表达式或资源相关联，以增强其含义。 例如，子表达式可以通过表达媒体片段的时长来细化 媒体片段，也可以通过定义某人的角色来细化创作者或贡献者 表达式。

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

Meta Properties Vocabulary 是用于 property 属性的默认词汇。

可以按 5.3 词汇关联 机制中定义的方式添加其他词汇中的术语 MAY。

scheme 属性标识元素值所获取自的系统或 scheme。 该属性的值 MUST 是一个紧凑 URL，该 URL 解析到定义该 scheme 的资源。scheme 属性没有 默认词汇（即所有值都需要前缀）。

metadata 节 MUST 正好包含 一个 dcterms:modified 属性 [dcterms]， 其中包含最后修改日期。此属性的值 MUST 是 [iso8601-1] 中符合扩展格式的完整日期和一天中时间表示：

YYYY-MM-DDThh:mm:ssZ

建议每当对 EPUB 出版物进行更改时更新最后修改日期。

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

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

元素名称：

link

用法：

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

属性：

• href [required]

• hreflang [optional]

• id [optional]

• media-type [conditionally required]

• properties [optional]

• refines [optional]

• rel [required]

内容模型：

空

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

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

• 从书脊引用；或

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

在所有其他情况下（例如，链接到独立的 [onix] 记录时），所引用的 资源 不是出版资源（即不受核心 媒体类型要求约束），且 MUST NOT 列在清单中。

虽然链接资源 MAY 位于 EPUB 容器之外， 阅读系统不必获取远程资源。建议在远程托管它们之前考虑 这可能对用户阅读体验产生的影响。

对于 EPUB 容器内的所有链接资源，media-type 属性 MUST 被指定。对于位于 EPUB 容器外部的链接资源，该属性为 OPTIONAL，因为同一个 URL 可能提供多个媒体类型 [url]。

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

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

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

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

可以按 5.3 词汇关联 机制中定义的方式添加其他词汇中的关系和属性 MAY。

可以提供一个或多个链接的 元数据记录 MAY。

除了完整记录之外，link 元素 MAY 用于 标识以替代格式提供的单个 元数据属性。

manifest 元素提供用于呈现内容的出版资源的完整列表。

元素名称：

manifest

用法：

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

属性：

id [optional]

内容模型：

item [1 个或多个]

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

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

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

元素名称：

item

用法：

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

属性：

• fallback [conditionally required]

• href [required]

• id [required]

• media-overlay [optional]

• media-type [required]

• properties [optional]

内容模型：

空

每个 item 元素通过其 href 属性中的 URL [url] 标识一个出版资源。其值 MUST 是 absolute- 或 path-relative-scheme-less-URL string [url]。每个 URL 在解析后 MUST 在 manifest 范围内唯一。

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

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

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

media-overlay 属性接受一个 IDREF [xml]， 标识此 item 所描述资源的媒体覆盖文档。 更多信息请参阅 9.3.3.5 媒体覆盖打包。

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

元素名称：

spine

用法：

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

属性：

• id [optional]

• page-progression-direction [optional]

• toc [optional] （过时）

内容模型：

itemref [1 个或多个]

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

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

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

page-progression-direction 属性设置内容流动的全局方向。允许的值为 ltr（从左到右）、rtl（从右到左）和 default。 指定 default 值时，表示未表达任何偏好，且 阅读系统可以选择呈现方向。

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

过时的 toc 属性接受一个 IDREF [xml]， 该 IDREF 标识表示 NCX 的清单项。

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

元素名称：

itemref

用法：

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

属性：

• id [optional]

• idref [required]

• linear [optional]

• properties [optional]

内容模型：

空

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

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

linear 属性指示被引用的 item 是否包含有助于主阅读顺序、并预期由 阅读系统按顺序阅读的内容 （“yes”），或增强或补充主要内容、阅读系统可不按顺序访问的辅助内容 （“no”）。辅助内容的示例包括注释、说明和答案 键。

linear 属性允许阅读系统区分用户需要作为默认阅读顺序的一部分 访问的内容，与阅读系统 可能例如在弹出窗口中呈现或从音频呈现中省略的补充内容。

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

线性 itemref 元素是其 linear 属性值显式设为 “yes” 或省略该 属性的元素 — 阅读系统会假定未带该属性的 itemref 元素的值为 “yes”。书脊 MUST 包含 至少一个 线性 itemref 元素。

由于阅读系统在沿书脊推进时可能不 提供对非线性内容的访问，因此 MUST 提供访问所有非线性内容的辅助方式 （例如，通过内容中的超链接或 EPUB 导航文档）。

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

可以按 5.3 词汇关联 机制中定义的方式添加其他词汇中的术语 MAY。

在预分页固定布局中，由书脊 itemref 引用的每个固定布局文档都表示一页内容。阅读系统应将 文档缩放以适应视口或合成跨页。

要指示 EPUB 出版物使用预分页固定布局，需要在 meta 元素中声明 rendition:layout 属性， 并指定值 pre-paginated。

除了将整个 EPUB 出版物设置为具有预分页布局外，还可以 覆盖可重排布局，以指定某些书脊项为 预分页。为此，需要在每个预分页的书脊 itemref 上的 properties 属性中设置 rendition:layout-pre-paginated 书脊覆盖。

当属性为某个书脊项设置为 pre-paginated 时， itemref 元素 MUST 引用一个固定布局文档， 或者其清单回退链中 MUST 存在一个固定布局文档。

当在 meta 元素中声明 rendition:layout 属性并使用值 roll 时， 它表示内容为卷动形式（即阅读系统将每个书脊 itemref 的宽度适配到视口，并以无 可见间隙的连续卷动方式显示）。卷动布局样式全局适用（即适用于所有书脊项），且不能被 覆盖。

声明 roll 布局时，每个书脊项 MUST 引用一个 固定布局文档。每个 文档的尺寸 MUST 按 7.3.2 固定布局文档尺寸中的定义设置。

包呈现 词汇中的其他属性或书脊覆盖都不能用于控制卷动布局的呈现。

XHTML 内容文档：

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

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

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

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

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

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

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

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

• [svg] foreignObject 元素：

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

    注

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

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

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

  注

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

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

  注

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

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

本节定义 固定布局文档尺寸属性的表达和解释规则。

固定布局文档按适用于其格式的方式指定其初始包含 块 [css2]：

在 XHTML 中表达

对于 XHTML 固定布局文档， 初始 包含块 [css2] 从 viewport meta 标签中 REQUIRED 的 height 和 width 定义获得，其中：

• height 属性 MUST 以正 值作为其值，该值为一个正数字 [css2] 或关键字 device-height；并且
• width 属性 MUST 以一个正 数字 [css2] 或关键字 device-width 作为其值。

device-width 和 device-height 值分别指阅读系统 视口宽度和高度的 100%。

height 和 width 定义 MUST 指定在 [html] head 元素中文档顺序的第一个 viewport meta 标签中。阅读系统 会忽略后续的 viewport meta 标签。

EPUB 创建者 MUST NOT 在一个 viewport meta 标签中指定多个 height 或 width 定义。

在 SVG 中表达

对于 SVG 固定布局文档， 初始包含块 [css2] 尺寸 MUST 使用 viewBox 属性 [svg] 表达。

在图像外来资源中表达

对于从书脊引用的图像外来资源， 初始 包含块 [css2] 从图像的宽度和高度 元数据获得。有关此元数据如何存储的信息，请参阅该图像格式的 文档。

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

toc nav 元素中的引用 SHOULD 按照反映 以下两者的方式排序：

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

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

页列表提供到内容中静态页面边界的导航。这些边界 要么对应于印刷等静态分页来源，要么专用于 EPUB 出版物。

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

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

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

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

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

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

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

建议将 landmarks nav 中定义的项数量限制为阅读系统可能在其用户界面中使用的 项。该元素并非用于 重复目录。

建议在可用时包含以下地标：

• bodymatter [epub-ssv-11] — 阅读 系统通常使用此地标，在用户开始阅读时自动跳过前辅文。
• toc [epub-ssv-11] — 如果 目录 在书脊中可用，阅读系统可以使用此地标将用户带到 包含它的文档。

可包含在 landmarks nav 中的其他可能项包括索引和术语表等关键参考章节。

虽然 landmarks nav 旨在供阅读系统使用，但仍建议 确保 landmarks nav 的标签可供人阅读。阅读系统 可能会直接向用户公开这些链接。

如果 EPUB 导航文档中需要附加的 nav 元素以供阅读系统处理，它们：

• MUST 指定 epub:type 属性；
• MUST 遵守 8.3 nav 元素：限制中的内容模型限制。

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