【问题标题】:Some questions about Hydra's terms关于 Hydra 条款的一些问题
【发布时间】:2015-11-27 07:11:11
【问题描述】:
我正在为 Golang 开发 Hydra 文档生成器。我一直以demo 为例,我想知道一些 hydra 术语中的歧义。
-
hydra:title 和rdfs:label 有什么区别? label 用于vocab:User,但hydra:title 用于Resource 和Collection,以及在属性中。
- 说到
Resource 和Collection,为什么在这个ApiDocumentation 中重新描述了它们?它们不应该是 hydra/core 的一部分吗?
- 在许多属性中,
hydra:title + hydra:description 和 label + description 都包含相同的信息。这是为什么?我可以忽略一个并且没事吗?
如果我未能在规范中发现这一点,请提前道歉,但我最近才对超媒体 API 产生了兴趣,而且许多概念仍然有点模糊。
【问题讨论】:
标签:
json-ld
hypermedia
hydra-core
【解决方案1】:
• hydra:title 和 rdfs:label 有什么区别?
rdfs:label 用于词汇定义本身。 hydra:title 用于覆盖 Hydra 客户端中的标签(例如使用它来呈现表单)。这是 Hydra 的进一步开发转移到 W3C Community Group 时打开的第一个问题:Hydra ISSUE-1
• 说到资源和集合,为什么在本 ApiDocumentation 中重新描述它们?它们不应该是 hydra/core 的一部分吗?
它们是 Hydra 核心词汇的一部分。因此,没有必要重新描述它们。这是我采取的一种实现捷径。
• 在许多属性中,包含相同信息的 hydra:title + hydra:description 和 label + description。这是为什么?我可以忽略一个并且没事吗?
查看第一个问题的答案。一般来说,您应该更喜欢 Hydra 特定工具中的 Hydra 版本,但要回退到 rdfs 属性。
顺便说一句。 Hydra 有一个专门的邮件列表。 Join the W3C Community Group 如果您有兴趣影响 Hydra 的未来发展。您当然也应该在那里宣布您的文档生成器。