From 393994a7e986a65812a28c1b67bcc47046339e30 Mon Sep 17 00:00:00 2001 From: Anatoly Scherbakov Date: Sat, 10 May 2025 12:14:17 +0400 Subject: [PATCH 1/5] Add a page for `YAML-LD` --- learn/yaml-ld.md | 300 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 300 insertions(+) create mode 100644 learn/yaml-ld.md diff --git a/learn/yaml-ld.md b/learn/yaml-ld.md new file mode 100644 index 00000000..2c9804e6 --- /dev/null +++ b/learn/yaml-ld.md @@ -0,0 +1,300 @@ +--- +layout: default +title: YAML-LD +--- + +
+
+
+

YAML-LD

+
+
+ +
+
+
+

YAML

+

+ YAML + (Yet Another Markup Language) is a language designed for + minimalistic and concise data representation. It is widely used for + configuration files and metadata, and is optimized to be written + and read by humans. Hence its lack of braces and support of comments. +

+
+ + +
+

A Simple Example

+ 
+"@context": https://json-ld.org/contexts/person.jsonld
+"@id": http://dbpedia.org/resource/John_Lennon
+name: John Lennon
+born: 1940-10-09
+spouse: http://dbpedia.org/resource/Cynthia_Lennon
+
+ + +
+

+ YAML-LD +

+

+ YAML-LD relies upon APIs and algorithms of JSON-LD, but applies them + to YAML instead of JSON. Since YAML is a superset of JSON, this, in + most aspects, is straightforward. +

+
+ +
+
+ +
+

Specification

+
+
+

+ The Specification is at Candidate stage right now. This is a formal document + that describes how YAML-LD maps to JSON-LD and what's different between the two. +

+ + Open YAML-LD Candidate Spec + +
+
+ +
+ +
+
+

Developers

+
+
+

YAML-LD is available in + a number of popular programming environments. Each implementation of YAML-LD + listed below is fully conforming to the official YAML-LD specifications. +

+
+ +
+ + +
+
+ +
+
+ +
+
+ +
+
+ + + + + +
+ +
+
+ +
+
+ + +
+ +
+

+ Each YAML-LD document can be easily converted into a JSON-LD document; subsequently, the JSON-LD Test Suite (and Framing Test Suite) is useful for validating YAML-LD Processors. +

+

+ In addition, YAML-LD Specification defines the YAML-LD test suite which tests features + specific to YAML-LD. +

+ +
+
+
From 4da838071dfdb89477886b2d7ee04be3e0662721 Mon Sep 17 00:00:00 2001 From: Anatoly Scherbakov Date: Sat, 10 May 2025 12:16:09 +0400 Subject: [PATCH 2/5] Add `Spinoffs` section on the index page --- index.html | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) diff --git a/index.html b/index.html index 8a449803..b73c5ec2 100644 --- a/index.html +++ b/index.html @@ -331,6 +331,69 @@

D

+ +
+
+

Spinoffs

+
+ +
+

+ The data model and conventions JSON-LD introduces can also apply to + formats other than JSON. A number of interoperable JSON-LD + inspired formats exist. +

+
+ +
+
+
+
    +

  • + YAML-LD +

    • +
  • + Human readable and, most importantly, writeable Linked Data + on top of YAML (Yet Another Markup Language). +
    • +
+
+
+ +
+
+
    +
  • +

    + CBOR-LD +

    +
    • +
  • + Tightly compressed binary representation of Linked Data for + space constrained applications like QR and barcodes. +
    • +
+
+
+ +
+
+
    +

  • + More? +

    • +
  • + Many other data formats exist. Let's map them all to + Linked Data! Volunteers are welcome. +
    • +
+
+
+ + +
+
+

From 3bff1e077b1a8187c3a046ac345d369f66c56dd5 Mon Sep 17 00:00:00 2001 From: Anatoly Scherbakov Date: Sat, 10 May 2025 12:16:46 +0400 Subject: [PATCH 3/5] gitignore for JetBrains IDEs --- .gitignore | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.gitignore b/.gitignore index 0d576031..027ffced 100644 --- a/.gitignore +++ b/.gitignore @@ -7,3 +7,6 @@ node_modules/ playground/jsonld.js _site/ package-lock.json + +# JetBrains IDEs +.idea/ From 635e66d1806fd123a2351b71c25cb2d5cdb8ca6b Mon Sep 17 00:00:00 2001 From: Anatoly Scherbakov Date: Tue, 13 May 2025 15:19:11 +0400 Subject: [PATCH 4/5] =?UTF-8?q?Apply=20language=20corrections=20=C2=A9=20@?= =?UTF-8?q?TallTed?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Ted Thibodeau Jr --- index.html | 4 ++-- learn/yaml-ld.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/index.html b/index.html index b73c5ec2..ddf1b39f 100644 --- a/index.html +++ b/index.html @@ -339,7 +339,7 @@

- The data model and conventions JSON-LD introduces can also apply to + The data model and conventions introduced in JSON-LD can also apply to formats other than JSON. A number of interoperable JSON-LD inspired formats exist.

@@ -354,7 +354,7 @@

  • Human readable and, most importantly, writeable Linked Data - on top of YAML (Yet Another Markup Language). + using YAML (Yet Another Markup Language).
    • diff --git a/learn/yaml-ld.md b/learn/yaml-ld.md index 2c9804e6..3aa6ee1e 100644 --- a/learn/yaml-ld.md +++ b/learn/yaml-ld.md @@ -41,8 +41,8 @@ title: YAML-LD

    YAML-LD relies upon APIs and algorithms of JSON-LD, but applies them - to YAML instead of JSON. Since YAML is a superset of JSON, this, in - most aspects, is straightforward. + to YAML instead of JSON. Since YAML is a superset of JSON, and JSON-LD + is a subset of JSON, this, in most aspects, is straightforward.

    From b81e46fda7620c717fdec59bc105cf162c67686c Mon Sep 17 00:00:00 2001 From: Anatoly Scherbakov Date: Tue, 13 May 2025 21:01:17 +0400 Subject: [PATCH 5/5] =?UTF-8?q?Fixes=20to=20the=20YAML-LD=20page=20=C2=A9?= =?UTF-8?q?=20@BigBlueHat?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: BigBlueHat --- learn/yaml-ld.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/learn/yaml-ld.md b/learn/yaml-ld.md index 3aa6ee1e..0fed6ca8 100644 --- a/learn/yaml-ld.md +++ b/learn/yaml-ld.md @@ -3,12 +3,11 @@ layout: default title: YAML-LD --- -
    -
    -
    -

    YAML-LD

    -
    -
    +
    +

    YAML-LD

    +
    +

    YAML for Linked Data

    +