JSON-LD 读写器技术文档

1. 安装指南

首先，确保您的环境中安装了Ruby。然后，使用以下命令安装JSON-LD gem：

gem install json-ld

2. 项目使用说明

本项目是一个用于解析和序列化JSON-LD的Ruby库，它可以将JSON-LD转换为RDF，并实现了扩展、紧凑和帧处理API接口。它还可以从HTML中提取JSON-LD。

扩展文档

input = JSON.parse '{
  "@context": {
    "name": "http://xmlns.com/foaf/0.1/name",
    "homepage": "http://xmlns.com/foaf/0.1/homepage",
    "avatar": "http://xmlns.com/foaf/0.1/avatar"
  },
  "name": "Manu Sporny",
  "homepage": "http://manu.sporny.org/",
  "avatar": "http://twitter.com/account/profile_image/manusporny"
}'

expanded = JSON::LD::API.expand(input)
puts expanded

紧凑文档

input = JSON.parse '[
  {
    "http://xmlns.com/foaf/0.1/name": ["Manu Sporny"],
    "http://xmlns.com/foaf/0.1/homepage": [{"@id": "https://manu.sporny.org/"}],
    "http://xmlns.com/foaf/0.1/avatar": [{"@id": "https://twitter.com/account/profile_image/manusporny"}]
  }
]'

context = JSON.parse('{
  "@context": {
    "name": "http://xmlns.com/foaf/0.1/name",
    "homepage": {"@id": "http://xmlns.com/foaf/0.1/homepage", "@type": "@id"},
    "avatar": {"@id": "http://xmlns.com/foaf/0.1/avatar", "@type": "@id"}
  }
}')['@context']

compact = JSON::LD::API.compact(input, context)
puts compact

帧处理文档

input = JSON.parse '{
  "@context": {
    "Book": "http://example.org/vocab#Book",
    "Chapter": "http://example.org/vocab#Chapter",
    "contains": {"@id": "http://example.org/vocab#contains", "@type": "@id"},
    "creator": "http://purl.org/dc/terms/creator",
    "description": "http://purl.org/dc/terms/description",
    "Library": "http://example.org/vocab#Library",
    "title": "http://purl.org/dc/terms/title"
  },
  "@graph": [
    {
      "@id": "http://example.com/library",
      "@type": "Library",
      "contains": "http://example.org/library/the-republic"
    },
    {
      "@id": "http://example.org/library/the-republic",
      "@type": "Book",
      "creator": "Plato",
      "title": "The Republic",
      "contains": "http://example.org/library/the-republic#introduction"
    },
    {
      "@id": "http://example.org/library/the-republic#introduction",
      "@type": "Chapter",
      "description": "An introductory chapter on The Republic.",
      "title": "The Introduction"
    }
  ]
}'

frame = JSON.parse '{
  "@context": {
    "Book": "http://example.org/vocab#Book",
    "Chapter": "http://example.org/vocab#Chapter",
    "contains": "http://example.org/vocab#contains",
    "creator": "http://purl.org/dc/terms/creator",
    "description": "http://purl.org/dc/terms/description",
    "Library": "http://example.org/vocab#Library",
    "title": "http://purl.org/dc/terms/title"
  },
  "@type": "Library",
  "contains": {
    "@type": "Book",
    "contains": {
      "@type": "Chapter"
    }
  }
}'

framed = JSON::LD::API.frame(input, frame)
puts framed

3. 项目API使用文档

JSON-LD::API.expand

将JSON-LD文档转换为展开的RDF表示形式。

JSON::LD::API.expand(input)

JSON-LD::API.compact

将JSON-LD文档转换为紧凑的RDF表示形式。

JSON::LD::API.compact(input, context)

JSON-LD::API.frame

使用帧来处理JSON-LD文档，以便以特定的结构输出数据。

JSON::LD::API.frame(input, frame)

4. 项目安装方式

请参考安装指南部分的内容，使用gem install json-ld命令安装项目。