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

　　**注意**：您正在查看 [Schema.org](https://schema.org/) 的开发版本。详情请参阅 [我们的工作方式](https://schema.org/docs/howwework.html)。 　　本页面提供了面向开发者的 Schema.org 基础信息，特别是提供了访问其模式（schemas）的机器可读表示形式的途径。 ## 机器可读术语定义 　　有多种方式可以访问 Schema.org 术语的机器可读定义。 * **源代码库**：底层源文件均可在我们的 [Github 仓库](http://github.com/schemaorg/schemaorg/) 中找到。编辑工作以 Turtle 格式进行，并使用一种 [基于 RDF Schema](https://en.wikipedia.org/wiki/RDF_Schema) 的方法进行定义。 * **定期发布**：定期发布的版本在 staging.schema.org 上暂存后，会发布到 Schema.org 主站。相应的数据文件链接如下，也可在 [Github](https://github.com/schemaorg/schemaorg/tree/main/data/releases) 上获取。 * **术语页内嵌 JSON-LD**：单个术语的机器可读定义也以 JSON-LD 格式嵌入在术语页面的 HTML 中。请注意，在许多情况下，将 schema.org 视为一个整体来考虑更为有用。 * **HTTP 与 HTTPS URI**：如 [FAQ](https://schema.org/docs/faq.html#19) 所述，Schema.org 的 URI 有时使用 'http'，有时使用 'https'。我们鼓励消费应用程序接受这两种表示形式，并且为了方便起见，我们现在生成两种“风味”的下载文件。在“磁盘上”的编辑工作中，我们使用 'https' 形式。然而，其他站点和应用程序，尤其是在 RDF 表示中，很可能仍在使用 'http'。尽管我们鼓励向 'https' 迁移，但需要特别注意：Schema.org 的 JSON-LD 上下文文件使用的是 'http'，并且由于对已部署系统的影响，我们不太可能在未经长期预警的情况下更改这一点。欢迎就此提供反馈，例如在此 [GitHub Issue](https://github.com/schemaorg/schemaorg/issues/2886) 中。 * **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](https://github.com/schemaorg/schemaorg) 的 `data/releases/` 目录下找到。 　　选择所需的文件和格式并点击下载。CSV 格式的下载文件分为两个文件：**Types** 包含类型和枚举值的定义，包括相关属性列表；**Properties** 包含属性定义。 * **schemaorg-current-https**：包含词汇表所有部分中所有术语的定义。 * **schemaorg-all-https**：包含词汇表所有部分中所有术语的定义，**外加**已从词汇表中移除的术语（详情参见 [attic 部分](https://schema.org/docs/attic.home.html)）。 　　对于偏好使用基于 http 的 Schema.org 术语定义的用户，可以在 **schemaorg-current-http** 和 **schemaorg-all-http** 文件中找到等效的定义。有关使用 https 或 http 术语的更多信息，请参阅 [FAQ](https://schema.org/docs/faq.html#19)。 ## 实验性功能 　　以下表示形式是**实验性**的，可能在未来的版本中更改或移除。 ### D3 RDFS in JSON-LD 　　这是一个简化的 Schema.org 类型层次结构，其中每个类型最多有一个超类，以一种结合了 JSON-LD、[RDFS](https://en.wikipedia.org/wiki/RDF_Schema) 和 [D3](https://d3js.org/) 的混合格式表示：[tree.jsonld](https://schema.org/docs/tree.jsonld)。 　　提供此文件是为了支持使用 [D3](https://d3js.org/) JavaScript 库进行基于数据的文档操作的开发者。它使用 JSON-LD 来声明 D3 默认的 "children" JSON 字段表示 "subClassOf" 关系，但以相反的方向表达（[使用示例](https://bl.ocks.org/danbri/1c121ea8bd2189cf411c)）。 ### OWL 　　作为一项实验性功能，我们提供了一个 [OWL](https://en.wikipedia.org/wiki/Web_Ontology_Language) 定义文件 [schemaorg.owl](https://schema.org/docs/schemaorg.owl)。它包含了核心词汇表及所有当前的扩展。 　　该文件的结构与上述词汇表定义文件不同，它将 `schema:domainIncludes` 和 `schema:rangeIncludes` 的值使用 `owl:unionOf` 转换为 `rdfs:domain` 和 `rdfs:range` 值，以捕获值的多重性。范围值中包含了词汇表内隐式的默认值，如 [Text](https://schema.org/Text)、[URL](https://schema.org/URL) 和 [Role](https://schema.org/Role)。 　　提供此文件是为了能在一些基于 OWL 的建模工具中表示该词汇表。映射到 OWL 是一种近似，不应被视为 Schema.org 术语的权威定义；详情请参阅 [数据模型页面](https://schema.org/docs/datamodel.html)。作为一项实验性功能，对于任何第三方工具如何解释它，我们没有设定预期。