0

我正在为 Golang 开发Hydra文档生成器。我一直以演示为例，我想知道一些 hydra 术语的歧义。

  • hydra:title和有什么区别rdfs:label？label用于vocab:User, 但hydra:title用于Resourceand Collection, 以及用于属性。
  • 说到Resourceand Collection，为什么在这个 ApiDocumentation 中重新描述了它们？它们不应该是 hydra/core 的一部分吗？
  • 在许多属性中，ahydra:title + hydra:description和label + descriptionthat 都包含相同的信息。这是为什么？我可以忽略一个并且很好吗？

如果我未能在规范中发现这一点，请提前道歉，但我最近才对超媒体 API 产生了兴趣，而且许多概念仍然有点模糊。

4

1 回答 1

1

• hydra:title 和 rdfs:label 有什么区别？

rdfs:label 用于词汇定义本身。hydra:title 用于覆盖 Hydra 客户端中的标签（例如使用它来呈现表单）。这是 Hydra 的进一步开发被转移到W3C 社区组时打开的第一个问题：Hydra ISSUE-1

• 说到资源和集合，为什么在本 ApiDocumentation 中重新描述它们？它们不应该是 hydra/core 的一部分吗？

它们是 Hydra 核心词汇的一部分。因此，没有必要重新描述它们。这是我采取的一种实施捷径。

• 在许多属性中，包含相同信息的 hydra:title + hydra:description 和 label + description。这是为什么？我可以忽略一个并且很好吗？

看第一个问题的答案。一般而言，您应该更喜欢 Hydra 特定工具中的 Hydra 版本，但回退到 rdfs 属性。

顺便提一句。Hydra 有一个专门的邮件列表。如果您有兴趣影响 Hydra 的未来发展，请加入 W3C 社区组。你也应该在那里宣布你的文档生成器。

于 2015-09-02T19:25:55.243 回答