Schema.org 开发者指南：2024年机器可读术语定义详解

　　注意：您正在查看 Schema.org 的开发版本。详情请参阅 我们的工作方式。

　　本页面提供了面向开发者的 Schema.org 基础信息，特别是提供了访问其模式（schemas）的机器可读表示形式的途径。

机器可读术语定义

　　有多种方式可以访问 Schema.org 术语的机器可读定义。

• 源代码库：底层源文件均可在我们的 Github 仓库 中找到。编辑工作以 Turtle 格式进行，并使用一种 基于 RDF Schema 的方法进行定义。
• 定期发布：定期发布的版本在 staging.schema.org 上暂存后，会发布到 Schema.org 主站。相应的数据文件链接如下，也可在 Github 上获取。
• 术语页内嵌 JSON-LD：单个术语的机器可读定义也以 JSON-LD 格式嵌入在术语页面的 HTML 中。请注意，在许多情况下，将 schema.org 视为一个整体来考虑更为有用。
• HTTP 与 HTTPS URI：如 FAQ 所述，Schema.org 的 URI 有时使用 'http'，有时使用 'https'。我们鼓励消费应用程序接受这两种表示形式，并且为了方便起见，我们现在生成两种“风味”的下载文件。在“磁盘上”的编辑工作中，我们使用 'https' 形式。然而，其他站点和应用程序，尤其是在 RDF 表示中，很可能仍在使用 'http'。尽管我们鼓励向 'https' 迁移，但需要特别注意：Schema.org 的 JSON-LD 上下文文件使用的是 'http'，并且由于对已部署系统的影响，我们不太可能在未经长期预警的情况下更改这一点。欢迎就此提供反馈，例如在此 GitHub Issue 中。
• JSON-LD 上下文文件：JSON-LD 上下文文件可从 https://schema.org/docs/jsonldcontext.json 获取。Schema.org 通常以 JSON-LD 1.0 部署，但我们上下文文件的位置也通过 JSON-LD 1.1 约定，以 HTTP Link 头部的方式暴露（命令行工具 'curl' 可能有用，例如使用 -I -i 参数）。无论通过 http 还是 https 检索上下文，我们都提供相同的上下文描述。

词汇表定义文件

　　为方便开发者，包含当前版本 Schema.org 词汇表定义的文件，以常见的 RDF 格式提供下载。除了下面的链接，旧版本的发布文件可以在 GitHub 的 data/releases/ 目录下找到。

　　选择所需的文件和格式并点击下载。CSV 格式的下载文件分为两个文件：Types 包含类型和枚举值的定义，包括相关属性列表；Properties 包含属性定义。

• schemaorg-current-https：包含词汇表所有部分中所有术语的定义。
• schemaorg-all-https：包含词汇表所有部分中所有术语的定义，外加已从词汇表中移除的术语（详情参见 attic 部分）。

　　对于偏好使用基于 http 的 Schema.org 术语定义的用户，可以在 schemaorg-current-http 和 schemaorg-all-http 文件中找到等效的定义。有关使用 https 或 http 术语的更多信息，请参阅 FAQ。

实验性功能

　　以下表示形式是实验性的，可能在未来的版本中更改或移除。

D3 RDFS in JSON-LD

　　这是一个简化的 Schema.org 类型层次结构，其中每个类型最多有一个超类，以一种结合了 JSON-LD、RDFS 和 D3 的混合格式表示：tree.jsonld。

　　提供此文件是为了支持使用 D3 JavaScript 库进行基于数据的文档操作的开发者。它使用 JSON-LD 来声明 D3 默认的 "children" JSON 字段表示 "subClassOf" 关系，但以相反的方向表达（使用示例）。

OWL

　　作为一项实验性功能，我们提供了一个 OWL 定义文件 schemaorg.owl。它包含了核心词汇表及所有当前的扩展。

　　该文件的结构与上述词汇表定义文件不同，它将 schema:domainIncludes 和 schema:rangeIncludes 的值使用 owl:unionOf 转换为 rdfs:domain 和 rdfs:range 值，以捕获值的多重性。范围值中包含了词汇表内隐式的默认值，如 Text、URL 和 Role。

　　提供此文件是为了能在一些基于 OWL 的建模工具中表示该词汇表。映射到 OWL 是一种近似，不应被视为 Schema.org 术语的权威定义；详情请参阅 数据模型页面。作为一项实验性功能，对于任何第三方工具如何解释它，我们没有设定预期。