YAML-LD 1.0

폐쇄형 생태계에 속하지 않는 시스템 간에 교환되는 JSON 텍스트는 UTF-8을 사용하여 인코딩되어야 한다.

YAML-LD 스트림은 UTF-8로 인코딩되어야 한다. 그렇지 않으면 invalid-encoding 오류를 감지하고 처리를 중단해야 한다.

주석은 표현상의 세부사항이며 직렬화 트리나 표현 그래프에 어떠한 영향도 주어서는 안 된다.

YAML-LD 스트림의 주석은 공백으로 취급한다.

자세한 내용은 YAML과 JSON의 상호 운용성 고려사항을 참조한다.

YAML에서는 마커로 구분된 일련의 문서로서 여러 직렬화 트리를 동일한 YAML 표현 스트림에 포함할 수 있다.

YAML-LD 스트림은 아래와 같이 둘 이상의 YAML-LD 문서를 포함할 수 있다.

"@context":
  dbo: http://dbpedia.org/ontology/
  dbr: http://dbpedia.org/resource/
"@id": dbr:Proxima_Centauri
"@type": dbo:Star
---
"@context":
  dbo: http://dbpedia.org/ontology/
  dbr: http://dbpedia.org/resource/
"@id": dbr:Proxima_Centauri_b
"@type": dbo:Planet

앵커 이름은 직렬화의 세부사항이며 구성이 완료되면 폐기된다.

따라서 앵커 이름은 관련 정보를 전달하는 데 사용해서는 안 되며, 문서를 처리할 때 변경할 수 있고, YAML-LD 처리 중에 제거할 수 있다.

앵커는 @context 블록 내에서 특히 유용하다. 여러 용어가 동일한 용어 정의를 공유하는 경우(예: 모든 IRI 값을 갖는 속성) 공유 정의에 한 번 앵커를 지정하고 각 용어에서 별칭으로 참조하여 반복을 피할 수 있다. 다음 예제에서는 IRI 강제 변환 정의를 &iri로 앵커링하고 세 속성에서 재사용한다.

"@context":
  dbo: http://dbpedia.org/ontology/
  dbp: http://dbpedia.org/property/
  dbr: http://dbpedia.org/resource/

  dbp:star:            &iri
    "@type": "@id"
  dbp:discoveryMethod: *iri
  dbp:discoverySite:   *iri

"@id": dbr:Proxima_Centauri_b
dbp:star:            dbr:Proxima_Centauri
dbp:discoveryMethod: dbr:Doppler_spectroscopy
dbp:discoverySite:   dbr:European_Southern_Observatory

모든 앵커와 별칭이 확인되면 동등한 JSON-LD는 다음과 같다.

{
  "@context": {
    "dbo": "http://dbpedia.org/ontology/",
    "dbp": "http://dbpedia.org/property/",
    "dbr": "http://dbpedia.org/resource/",
    "dbp:star": {
      "@type": "@id"
    },
    "dbp:discoveryMethod": {
      "@type": "@id"
    },
    "dbp:discoverySite": {
      "@type": "@id"
    }
  },
  "@id": "dbr:Proxima_Centauri_b",
  "dbp:star": "dbr:Proxima_Centauri",
  "dbp:discoveryMethod": "dbr:Doppler_spectroscopy",
  "dbp:discoverySite": "dbr:European_Southern_Observatory"
}

완전한 표상 그래프를 구성할 때 YAML-LD는 스칼라 유형 해석에 YAML 코어 스키마를 사용한다. [JSON]으로 표현할 수 없는 부동 소수점 값, 구체적으로 무한대(.inf, -.inf, +.inf)와 숫자가 아님(.nan)은 JSON-LD 내부 표현을 구성할 때 loading-document-failed 오류가 발생하도록 해야 한다.

YAML 코어 스키마는 타임스탬프 유형을 정의하지 않는다. 2018-04-01과 같은 스칼라는 일반 문자열로 해석된다. 그러나 많은 YAML 라이브러리는 기본적으로 YAML 1.1 타임스탬프 해석을 구현하며 이러한 스칼라를 네이티브 날짜 또는 날짜·시간 객체로 자동 변환한다. YAML-LD 프로세서는 이러한 변환을 수행해서는 안 되며 이러한 값을 문자열로 취급해야 한다.

YAML-LD는 YAML 코어 스키마가 정의하는 스칼라 유형 해석을 넘어서 노드 태그에 추가적인 JSON-LD 의미를 부여하지 않는다.

[JSON-LD11-API]는 HTML 문서에서 JSON-LD 콘텐츠가 포함된 여러 <script> 태그를 구문 분석할 수 있게 하는 extractAllScripts 플래그를 정의한다.

적합한 YAML-LD 구현은 YAML-LD 스트림에서 JSON-LD 내부 표현을 구성할 때 이 플래그를 적용해야 한다.

• 플래그가 true이면 내부 표현은 스트림에 문서가 하나만 포함되어 있더라도 스트림에 있는 각 문서의 구성된 값을 포함하는 배열이어야 한다.
• 플래그가 false이면 스트림의 첫 번째 문서만 구성해야 한다.

객체 구조는 중괄호 쌍으로 표현되며, 그 안에는 0개 이상의 이름/값 쌍(또는 멤버)이 포함된다. 이름은 문자열이다.

따라서 YAML-LD의 모든 매핑 키는 반드시 string이어야 한다. 그렇지 않으면 다음 예와 같이 mapping-key-error 오류가 발생한다.

"@context":
  - https://json-ld.org/contexts/dollar-convenience.jsonld
  - dbo: http://dbpedia.org/ontology/
    dbp: http://dbpedia.org/property/
    dbr: http://dbpedia.org/resource/
    prov: http://www.w3.org/ns/prov#
    xsd: http://www.w3.org/2001/XMLSchema#
    dbp:discovered:
      "@type": xsd:date
    dbp:star: &iri
      "@type": "@id"
    prov:wasDerivedFrom: *iri

{ $id: dbr:Proxima_Centauri_b, $type: dbo:Planet, dbp:star: dbr:Proxima_Centauri }:
  dbp:discovered: 2016-08-24
  prov:wasDerivedFrom: https://dbpedia.org/page/Proxima_Centauri_b