3.2.1 외부 웹 리소스

웹 리소스는 IRI로 식별되며, 리소스 콘텐츠의 포맷이나 언어 등 다양한 속성을 가질 수 있습니다. 이 정보는 주석의 일부로 기록될 수 있으며, 리소스의 표현을 웹에서 따로 가져와야 하더라도 가능합니다.

예시 활용 사례: Beatrice는 한 특허에 대한 긴 분석을 녹음하여 자신의 웹사이트에 mp3로 올리고, mp3를 본문으로, 특허의 PDF를 대상으로 하는 주석을 생성합니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno2",
  "type": "Annotation",
  "body": {
    "id": "http://example.org/analysis1.mp3",
    "format": "audio/mpeg",
    "language": "fr"
  },
  "target": {
    "id": "http://example.gov/patent1.pdf",
    "format": "application/pdf",
    "language": ["en", "ar"],
    "textDirection": "ltr",
    "processingLanguage": "en"
  }
}

3.2.2 클래스

클라이언트가 웹 리소스의 일반적인 타입을 미리 아는 것은 유용합니다. 클라이언트가 비디오를 렌더링할 수 없다면, 본문이 비디오임을 알면 불필요하게 큰 콘텐츠 스트림을 다운로드하지 않아도 됩니다. 많은 데이터 포맷처럼 명확한 미디어 타입이 없는 리소스의 경우에도, 포맷이 text/csv인 리소스는 미디어 타입의 앞부분과 상관없이 단순 텍스트로 렌더링하면 안 되고, application/pdf는 메인 타입이 'application'이더라도 사용자 에이전트가 렌더링할 수 있음을 클라이언트가 아는 것이 유용합니다.

예시 활용 사례: Corina는 웹사이트에 대한 자신의 의견을 동영상으로 찍어 휴대폰에 업로드합니다. 그녀는 이 동영상을 웹사이트와 Annotation을 통해 연결하고, 클라이언트는 타입 정보를 소비 시스템을 위한 힌트로 추가합니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno3",
  "type": "Annotation",
  "body": {
    "id": "http://example.org/video1",
    "type": "Video"
  },
  "target": {
    "id": "http://example.org/website1",
    "type": "Text"
  }
}

3.2.3 외부 리소스의 세그먼트

많은 주석은 외부 웹 리소스 전체가 아니라 그 일부분을 포함합니다. 웹 [webarch]에서, 리소스의 세그먼트는 fragment 컴포넌트를 가진 IRI를 사용해 식별됩니다. 이는 원하는 세그먼트 추출 방법을 명시하면서 추출된 콘텐츠도 식별합니다. 단순한 주석의 경우, fragment가 포함된 IRI를 본문 또는 대상 식별자로 사용하는 것이 가치 있습니다.

예시 활용 사례: Dawn은 이미지의 특정 영역을 설명하고 싶습니다. 그녀는 클라이언트에서 그 영역에 하이라이트를 하고 설명을 입력합니다. 클라이언트가 해당 fragment를 target으로 포함한 IRI를 만듭니다.

모델

fragment가 포함된 IRI를 사용할 때의 부작용 및 그것이 구현체에 미치는 제약을 인지하는 것이 중요합니다.

• fragment는 각 미디어 타입 별로 정의됩니다. 예를 들어 HTML은 fragment 부분에 대한 특정 의미론을 가집니다.
• 모든 미디어 타입이 fragment 사양을 가지는 것은 아닙니다. 예를 들어, 오피스 문서는 미디어 타입이 있을 수 있지만, fragment 의미론이 없을 수 있습니다.
• 미디어 타입에 fragment 정의가 있더라도, 흥미로운 세그먼트를 충분히 정확하게 표현할 수 없는 경우가 많습니다. 예를 들어 HTML fragment는 임의의 텍스트 범위를 정확하게 표현하지 못합니다.
• 어떤 것이 식별되는지 확실히 알려면 미디어 타입을 알아야 하며, 동일한 fragment 문자열이 다른 사양에서 사용될 수 있습니다. 예컨대 동일한 fragment 문자열이 이미지에서는 사각 영역, HTML에서는 이름이 특이한 섹션일 수도 있습니다.
• fragment를 가진 IRI는 리소스 세그먼트를 더 구체적으로 기술하는 다른 방법과 호환되지 않습니다. 올바른 표현을 가져오는 방법, 스타일 정보 추가, 리소스에 역할 연관 등은 이러한 IRI만으로는 불가능합니다. 이러한 요구를 해결하는 방법은 Fragment Selector와 Specific Resources 절에 서술되어 있습니다.
• IRI는 불투명한 문자열로 간주되므로, fragment가 없는 IRI로 검색하면 fragment가 포함된 주석을 찾을 수 없습니다. 예를 들어, http://example.com/image.jpg#xywh=1,1,1,1를 Target으로 가진 주석은 http://example.com/image.jpg 검색에서는 발견되지 않습니다.

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno4",
  "type": "Annotation",
  "body": "http://example.org/description1",
  "target": {
    "id": "http://example.com/image1#xywh=100,100,300,300",
    "type": "Image",
    "format": "image/jpeg"
  }
}

3.2.4 임베디드 텍스트 본문

많은 상황에서 주석의 본문은 텍스트 포맷이며, 별도 IRI 없이 주석과 동시에 생성됩니다. 이럴 때는 본문의 텍스트를 Annotation에 직접 포함할 수 있어 여러 시스템과의 불필요한 상호작용을 줄일 수 있습니다. 본문에는 외부 웹 리소스의 속성(특히 텍스트 언어 및 포맷 등)도 함께 포함할 수 있습니다.

예시 활용 사례: Emily는 사진 공유 사이트에서 이미지를 얼마나 좋아하는지에 대해 댓글을 썼습니다. 그녀의 클라이언트는 그 댓글을 주석 내에 임베디드하고, 해당 댓글이 프랑스어이며 HTML 형식임을 추가합니다.

모델

시스템은 TextualBody에 클래스에서 설명된 Text 클래스가 명시적으로 type에 포함되어 있지 않더라도 포함된 것으로 가정해야 합니다.

language와 format 등 외부 웹 리소스의 속성들도 임베디드 텍스트 본문 리소스에 적용됩니다.

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno5",
  "type": "Annotation",
  "body": {
    "type" : "TextualBody",
    "value" : "<p>j'adore !</p>",
    "format" : "text/html",
    "language" : "fr"
  },
  "target": "http://example.org/photo1"
}

3.2.5 문자열 본문

가장 단순한 본문 유형은 추가 정보나 속성 없이 plain text 문자열입니다. 이 유형의 본문은 오직 가장 단순한 Annotation에만 적합하며, 본문이 주석 외부에서 참조되어야 할 필요가 있는 경우에는 권장되지 않습니다.

예시 활용 사례 Franceska는 간단한 커맨드 라인 클라이언트에서 빠르게 주석을 생성하고자 합니다. 그녀는 텍스트 파일로 JSON 직렬화를 만들고, 이를 Annotation 서버로 전송하여 저장합니다.

모델

이 형식을 언제 사용하고 어떻게 해석할지는 몇 가지 제한이 있습니다.
문자열 본문:

• 반드시 하나의 xsd:string이어야 하며, 데이터 타입이 직렬화에 등장하면 안 됨.
• 언어 정보를 가질 수 없습니다.
• Textual Body의 value 속성과 같은 방식으로 해석되어야 합니다.
• Textual Body 리소스의 format 속성이 text/plain인 것과 같은 의미로 해석해야 합니다.
• Annotation 리소스에 있는 유사 속성으로부터, Textual Body의 다른 속성값을 추론하면 안 됩니다.

상기 해석 중 하나라도 충족되면, 반드시 TextualBody 방식을 사용해야 합니다.

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno6",
  "type": "Annotation",
  "bodyValue": "Comment text",
  "target": "http://example.org/target1"
}

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno7",
  "type": "Annotation",
  "body": {
    "type": "TextualBody",
    "value": "Comment text",
    "format": "text/plain"
  },
  "target": "http://example.org/target1"
}

3.2.6 본문과 대상의 수

어떤 주석은 본문이 전혀 없을 수도 있습니다. 예를 들어 별도의 텍스트 없이 단순히 하이라이트 표시하거나 북마크만 남기는 경우입니다. 또한, 한 개의 주석에 여러 개의 본문 또는/그리고 여러 개의 대상을 가질 수도 있습니다. 이 경우 각 본문은 모든 대상의 집합이 아닌 각각의 대상과 동일하게 관련이 있는 것으로 간주합니다.

예시 활용 사례: Gretchen은 전자책의 특정 부분을 초록색으로 하이라이트하고, 그 의미를 이미 알기 때문에 별도의 댓글은 달지 않습니다. 그녀의 클라이언트는 주석과 연관된 스타일시트를 추가하지만, 본문은 생성하지 않습니다.

예시 활용 사례: Hannah는 하나의 주석으로 태그와 설명을 두 장의 이미지에 함께 연결합니다.

모델

주석에 본문이 없을 경우 body 속성은 생략됩니다.

주석의 body 및/또는 target 속성은 단일 객체 대신 배열이 될 수 있습니다. 값은 리소스의 IRI 문자열이거나 객체일 수 있습니다.

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno8",
  "type": "Annotation",
  "target": "http://example.org/ebook1"
}

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno9",
  "type": "Annotation",
  "body": [
    "http://example.org/description1",
    {
      "type": "TextualBody",
      "value": "tag1"
    }
  ],
  "target": [
    "http://example.org/image1",
    "http://example.org/image2"
  ]
}

3.2.7 본문 선택

Choice는 애플리케이션이 처리하거나 표시할 리소스를 하나만 선택해야 하는 순서가 있는 목록을 의미합니다. 순서는 주석 작성자나 발행자가 가장 우선적으로 보기 원하는 순서로 나열됩니다.

예시 활용 사례: Irina는 한 웹사이트에 대해 토론한 글을 프랑스어와 영어로 모두 작성합니다. 두 게시글이 완전히 동등하므로 둘 다 표시할 필요는 없으며, 프랑스어 사용자는 프랑스어 댓글을, 다른 이용자는 영어 댓글을 보길 원합니다. 그녀의 클라이언트는 영어를 먼저 나열하여 Choice를 만듭니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno10",
  "type": "Annotation",
  "body": {
    "type": "Choice",
    "items": [
      {
        "id": "http://example.org/note1",
        "language": "en"
      },
      {
        "id": "http://example.org/note2",
        "language": "fr"
      }
    ]
  },
  "target": "http://example.org/website1"
}

3.3.1 라이프사이클 정보

주석 또는 참조된 리소스에 책임이 있는 개인, 조직 또는 기계는 그 기여에 대해 인정받을 가치가 있으며, 해당 리소스가 생성된 시점은 표시 순서나 오래되어 관련성이 떨어지는 콘텐츠 필터링에 유용합니다. 주석의 작성자는 또한 주석의 신뢰성을 판단하는 데 유용합니다. 주석을 생성하고 직렬화하는 데 사용된 소프트웨어와 그 활동이 발생한 시점은 광고 및 디버깅 모두에 유용합니다.

예시 활용 사례: Jane은 온라인에서 식당에 대한 리뷰를 작성하고, 친구들이 그 리뷰가 본인이 작성한 것임을 알고 신뢰할 수 있도록 작성자 정보가 연결되길 원합니다. 그녀의 클라이언트는 그녀 계정의 정체성과 클라이언트 자체의 정체성, 그리고 해당 리소스들이 생성된 적절한 타임스탬프를 주석에 추가합니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno11",
  "type": "Annotation",
  "creator": "http://example.org/user1",
  "created": "2015-01-28T12:00:00Z",
  "modified": "2015-01-29T09:00:00Z",
  "generator": "http://example.org/client1",
  "generated": "2015-02-04T12:00:00Z",
  "body": {
    "id": "http://example.net/review1",
    "creator": "http://example.net/user2",
    "created": "2014-06-02T17:00:00Z"
  },
  "target": "http://example.com/restaurant1"
}

3.3.2 주체

주석 작성에 관여한 에이전트에 대한 추가 정보는 단순한 IRI 식별자 이상의 정보가 일반적으로 필요합니다. 여기에는 개인인지, 그룹인지, 소프트웨어인지 여부 및 실제 이름, 계정 닉네임, 이메일 주소와 같은 속성이 포함됩니다.

예시 활용 사례: Kelly는 자신의 신원을 관리하지 않는 시스템에 주석을 제출하려 하고, 표시될 때 가명(pseudonym)이 나오길 원합니다. 그녀의 클라이언트는 이 정보를 주석에 추가하여 서비스로 보냅니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno12",
  "type": "Annotation",
  "creator": {
    "id": "http://example.org/user1",
    "type": "Person",
    "name": "My Pseudonym",
    "nickname": "pseudo",
    "email_sha1": "58bad08927902ff9307b621c54716dcc5083e339"
  },
  "generator": {
    "id": "http://example.org/client1",
    "type": "Software",
    "name": "Code v2.1",
    "homepage": "http://example.org/client1/homepage1"
  },
  "body": "http://example.net/review1",
  "target": "http://example.com/restaurant1"
}

3.3.3 의도된 대상

주석 및 기타 리소스의 생성 및 관리와 관련된 에이전트 외에도, 리소스가 의도된 소비자나 에이전트의 클래스(청중)를 아는 것이 유용합니다. 이는 역할(예: 교사 대 학생)이나 대상 클래스의 속성(예: 권장 연령대) 등을 기록할 수 있게 합니다.

예시 활용 사례: Lynda는 특정 교재를 수업에서 사용하는 방법에 대해 메모를 작성합니다. 그녀는 이 주석의 의도된 대상이 교재를 사용하는 교사임을 추가하여, 학습용으로 사용하는 학생들을 대상으로 한 다른 주석들과 구분합니다.

모델

대상을 설명하는 추가 속성들은 schema.org의 Audience 클래스에서 사용됩니다. 이러한 속성명과 클래스명은 다른 속성이나 클래스와 혼동되지 않도록 JSON에서 schema: 접두사를 붙여야 합니다 MUST.

audience의 사용은 주석을 보지 못하게 하는 접근 제한을 암시하거나 가능하게 하지 않습니다. 시스템은 사용자의 정보에 기반해 주석 표시를 필터링하는 데 이 정보를 사용하는 것이 권장되며, 주석이나 다른 리소스가 인증 및 권한 부여를 필요로 한다고 가정해서는 안 됩니다.

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno13",
  "type": "Annotation",
  "audience": {
    "id": "http://example.edu/roles/teacher",
    "type": "schema:EducationalAudience",
    "schema:educationalRole": "teacher"
  },
  "body": "http://example.net/classnotes1",
  "target": "http://example.com/textbook1"
}

3.3.4 콘텐츠 접근성

정보에 대한 접근은 유엔이 인정하는 기본 인권으로 여겨집니다. 웹은 다양한 신체적 제약에도 불구하고 의사소통 및 상호작용의 장벽을 제거할 수 있습니다. 이는 사회적 포용을 지원하며 정보의 잠재적 청중을 늘립니다. 주석의 본문이나 대상으로 사용되는 리소스에 대해, 다양한 능력을 가진 사용자들이 더 쉽게 접근할 수 있도록 하는 리소스의 특징을 기록하는 것이 유용합니다.

예시 활용 사례: Megan은 청력이 매우 제한적이어서 동영상과 상호작용할 때 자막을 읽는 것을 선호합니다. 그녀는 그런 동영상에 대해 주석을 달며, 같은 상황의 다른 사용자를 돕기 위해 클라이언트는 그 동영상이 이 접근성 기능을 갖추고 있음을 포함합니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno14",
  "type": "Annotation",
  "motivation": "commenting",
  "body": "http://example.net/comment1",
  "target": {
    "id": "http://example.com/video1",
    "type": "Video",
    "accessibility": "captions"
  }
}

3.3.5 동기와 목적

많은 경우 주석이 생성된 이유나 텍스트 본문이 주석에 포함된 목적을 이해하는 것이 중요합니다. 즉 이전 절에서 설명한 '누가'와 '언제'뿐만 아니라 '왜'가 제공되어야 합니다. 이러한 이유는 주석 생성의 동기나 텍스트 본문이 주석에 포함된 목적을 선언함으로써 제공됩니다.

예시 활용 사례: Noelle은 나중에 참고하기 위해 리소스를 북마크하려는 의도로 주석을 달고, 다시 찾기 쉽도록 설명과 태그를 제공합니다. 그녀의 클라이언트는 이를 캡처하기 위해 주석과 텍스트 본문 리소스에 적절한 동기를 추가합니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno15",
  "type": "Annotation",
  "motivation": "bookmarking",
  "body": [
    {
      "type": "TextualBody",
      "value": "readme",
      "purpose": "tagging"
    },
    {
      "type": "TextualBody",
      "value": "A good description of the topic that bears further investigation",
      "purpose": "describing"
    }
  ],
  "target": "http://example.com/page1"
}

3.3.6 권리 정보

리소스의 사용 조건을 설명하기 위해 라이선스나 권리 성명을 리소스와 연관시키는 것은 일반적인 관행입니다. 이를 통해 사용자는 리소스를 적절히 사용할 수 있고 일부 자동화된 시스템은 사용이 허용되는지 확인할 수 있습니다. 주석, 본문 및 대상은 서로 다른 라이선스나 권리를 가질 수 있으므로 각각 별도로 기술할 수 있습니다. 주석 자체가 아닌 다른 리소스의 권리는 소비 클라이언트 애플리케이션에 대한 참고적 힌트로 간주됩니다.

예시 활용 사례: Ophelia는 제품에 대한 리뷰를 작성하고 자신을 리뷰의 저자로 명시하길 원하지만, 리뷰와 제품을 연결하는 주석이 어떻게 사용되는지는 개의치 않습니다. 그녀는 주석과 본문에 각각 별도의 권리 성명을 명시합니다. 대상 리소스에 대해 권리를 모르는 경우 아무것도 지정하지 않습니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno16",
  "type": "Annotation",
  "rights": "https://creativecommons.org/publicdomain/zero/1.0/",
  "body": {
    "id": "http://example.net/review1",
    "rights": "http://creativecommons.org/licenses/by-nc/4.0/"
  },
  "target": "http://example.com/product1"
}

3.3.7 기타 식별자

웹과 같은 대규모 분산 시스템에서는 정보가 종종 복사됩니다. 주석 및 관련 리소스의 출처를 추적하기 위해, 리소스를 추가로 식별하는 IRI들을 기록할 수 있습니다. 이러한 IRI는 dereferencable한 "퍼머링크", 웹을 알지 못한 채 클라이언트가 오프라인에서 할당한 식별자, 또는 현재 수집 시스템이 리소스를 발견한 위치일 수 있습니다.

예시 활용 사례: Petra는 주석을 생성하여 개인용과 공개용 등 여러 시스템에 전송하여 보관합니다. 그녀는 복사본들을 정렬할 수 있도록 표준 IRI로 UUID를 설정하고, 서비스는 이를 위해 HTTP IRI를 할당합니다. 이후 시스템이 공개 복사본을 수집하여 표준 UUID를 유지한 뒤, 원래의 HTTP IRI를 via로 옮기고 자신이 제어하는 IRI로 바꿀 수 있습니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno17",
  "type": "Annotation",
  "canonical": "urn:uuid:dbfb1861-0ecf-41ad-be94-a584e5c4f1df",
  "via": "http://other.example.org/anno1",
  "body": {
    "id": "http://example.net/review1",
    "rights": "http://creativecommons.org/licenses/by/4.0/"
  },
  "target": "http://example.com/product1"
}

4.2.1 프래그먼트 셀렉터

세그먼트를 지정하는 가장 널리 알려진 메커니즘은 표현 미디어 타입에서 정의되는 IRI의 fragment 부분이므로, 이를 Selector를 통해 기술하는 방법을 허용하는 것은 유용합니다. 이를 통해 기존 및 향후 fragment 사양을 SpecificResource와 일관되게 사용할 수 있습니다. 어떤 fragment 타입이 사용되는지 명확히 하기 위해, Selector는 이를 정의한 사양을 참조할 수 있습니다.

예시 활용 사례: Sally는 비디오의 일부 구간을 이미지 설명으로 활용하고 싶습니다. 그녀는 비디오 내 시간 구간을 선택하고, 그것이 대상을 설명한다고 클릭합니다. 클라이언트는 FragmentSelector와 describing 동기를 가지는 SpecificResource로 Annotation을 생성합니다.

모델

FragmentSelector를 사용하는 것이 다른 특정리소스 기술 방법과 일관성을 가지므로, fragment가 포함된 IRI를 직접 사용하는 것보다는 이 방식을 권장합니다. 소비 애플리케이션은 두 가지 모두를 알아야 합니다 SHOULD.

아래 IRI들은 fragment의 의미를 정의하는 일부 사양들이며, conformsTo 관계에 사용할 수 있습니다. 그 외에도 다른 IRI가 사용될 수 있습니다.

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno20",
  "type": "Annotation",
  "body": {
    "source": "http://example.org/video1",
    "purpose": "describing",
    "selector": {
      "type": "FragmentSelector",
      "conformsTo": "http://www.w3.org/TR/media-frags/",
      "value": "t=30,60"
    }
  },
  "target": "http://example.org/image1"
}

4.2.2 CSS 선택자

HTML 문서 객체 모델에서 요소를 선택하는 가장 일반적인 방법 중 하나는 CSS 선택자 [CSS3-selectors]를 사용하는 것입니다. CSS 선택자는 웹 페이지 내 요소로 가는 경로를 다양한 방식으로 기술할 수 있게 하며, 이는 웹 주석의 많은 기본 사용 사례를 포괄할 수 있습니다. CSS 선택자가 Document Object Model을 따르지 않는 표현에 적용될 때의 결과는 정의되어 있지 않습니다.

CSS는 주석 내에서 리소스를 스타일링하는 데에도 사용될 수 있습니다. 이 클래스는 Document Object Model을 따르는 리소스의 세그먼트를 선택하기 위해 CSS 선택자 메커니즘을 재사용하는 데 집중되어 있습니다.

예시 활용 사례: Teynika는 웹 페이지의 단락을 선택하여 메모를 남기고자 합니다. 그녀의 클라이언트는 해당 요소를 정확히 식별하는 CSS 경로를 계산해 이를 주석에 추가합니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno21",
  "type": "Annotation",
  "body": "http://example.org/note1",
  "target": {
    "source": "http://example.org/page1.html",
    "selector": {
      "type": "CssSelector",
      "value": "#elemid > .elemclass + p"
    }
  }
}

4.2.3 XPath 선택자

Document Object Model(DOM)을 지원하는 리소스(예: XML이나 HTML 문서)에서 요소 및 콘텐츠를 선택하는 또 다른 일반적인 방법은 XPath 선택 [DOM-Level-3-XPath]을 사용하는 것입니다. XPath는 선택된 콘텐츠로 향하는 구조적 경로를 매우 유연하게 기술할 수 있습니다. XPath 선택자가 DOM을 따르지 않는 표현에 적용될 때의 결과는 정의되어 있지 않습니다.

예시 활용 사례: Ulrika는 HTML 페이지의 표 안에서 span을 선택하여 그 내용을 주석으로 남깁니다. 이 요소를 명확히 지칭하기 위해, 그녀의 클라이언트는 정확히 지목하는 XPath를 조심스럽게 계산해 Annotation의 target으로 추가합니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno22",
  "type": "Annotation",
  "body": "http://example.org/note1",
  "target": {
    "source": "http://example.org/page1.html",
    "selector": {
      "type": "XPathSelector",
      "value": "/html/body/p[2]/table/tr[2]/td[3]/span"
    }
  }
}

4.2.4 텍스트 인용 선택자

이 선택자는 본문의 일부 텍스트 자체를 복사하고, 동일한 문자가 여러 번 등장하는 경우 식별을 위해 직전/직후 문맥(접두사/접미사)도 함께 포함하여 텍스트 범위를 설명합니다.

예를 들어, 문서가 "abcdefghijklmnopqrstuvwxyz"라면 "efg"를 선택하기 위해 접두사 "abcd", 매치 "efg", 접미사 "hijk"를 지정할 수 있습니다.

예시 활용 사례: Valeria는 웹 페이지에서 오타('anotation')를 선택하여, 올바른 철자('annotation')로 바꿔야 한다고 댓글을 남깁니다.

모델

텍스트 선택은 반드시 유니코드 코드 포인트(문자 번호) 기준이어야 하며, 코드 유닛 등 다른 타입으로 해석되지 않습니다. 선택은 글자 클러스터의 중간에서 시작하거나 끝나면 안 됩니다. 선택은 반드시 텍스트의 논리적 순서를 따릅니다. 자세한 문자 모델은 [charmod]를 참고하세요.

텍스트는 Annotation에 기록되기 전에 반드시 정규화되어야 합니다. 따라서 HTML/XML 태그는 제거하고, 문자 엔티티는 실제 문자로 변환하는 것이 좋습니다. 이 처리는 주석의 기록 방법만 바꿀 뿐, 실제 문서 내용은 영향을 받지 않습니다.

접두사, exact, 접미사 처리 후 사용자 에이전트가 일치하는 텍스트를 여러 개 발견했다면, 선택은 그 모두에 일치하는 것으로 간주하는 것이 권장됩니다.

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno23",
  "type": "Annotation",
  "body": "http://example.org/comment1",
  "target": {
    "source": "http://example.org/page1",
    "selector": {
      "type": "TextQuoteSelector",
      "exact": "anotation",
      "prefix": "this is an ",
      "suffix": " that has some"
    }
  }
}

4.2.5 텍스트 위치 선택자

이 선택자는 선택 영역의 시작 및 끝 위치를 기록하여 텍스트의 범위를 표현합니다. 위치 0은 첫 번째 문자 바로 앞, 위치 1은 두 번째 문자 바로 앞을 의미합니다. 시작 문자는 범위에 포함되고, 끝 문자는 포함되지 않습니다.

예를 들어 문서가 "abcdefghijklmnopqrstuvwxyz"이고, 시작이 4, 끝이 7이면 선택 영역은 "efg"가 됩니다.

예시 활용 사례: Wendy는 콘텐츠를 추출하거나 복사할 수 없는 전자책에 대한 리뷰를 씁니다. 그녀의 클라이언트는 선택 범위를 콘텐츠 내 시작/끝 위치로 기술합니다.

모델

텍스트는 시작 및 끝 위치를 판단하기 전에 Text Quote Selector에서와 동일하게 선택 및 정규화되어야 합니다.

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno24",
  "type": "Annotation",
  "body": "http://example.org/review1",
  "target": {
    "source": "http://example.org/ebook1",
    "selector": {
      "type": "TextPositionSelector",
      "start": 412,
      "end": 795
    }
  }
}

4.2.6 데이터 위치 선택자

텍스트 위치 선택자와 유사하게, 데이터 위치 선택자는 동일한 속성을 사용하지만 텍스트 내 문자 단위가 아니라 비트스트림 내 바이트 단위에서 동작합니다.

예시 활용 사례: Xena는 포렌식 목적으로 온라인 디스크 이미지의 영역에 대해 코멘트를 작성하고 에뮬레이션 요구사항을 설명합니다. 그녀의 클라이언트는 사람이 보기 쉬운 화면이 아니라 이진 스트림에서 시작과 끝 위치를 추출합니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno25",
  "type": "Annotation",
  "body": "http://example.org/note1",
  "target": {
    "source": "http://example.org/diskimg1",
    "selector": {
      "type": "DataPositionSelector",
      "start": 4096,
      "end": 4104
    }
  }
}

4.2.7 SVG 선택자

SvgSelector는 Scalable Vector Graphics [SVG11] 표준을 사용하여 영역을 정의합니다. 사용자가 SVG를 이용해서 원, 다각형 등 비사각형 영역을 표현할 수 있으며, SVG는 Annotation 내에 임베디드되거나 외부 웹 리소스로 참조될 수 있습니다.

SvgSelector는 리소스 영역 선택에 SVG를 사용합니다. SVG 표현의 세그먼트는 FragmentSelector 또는 SvgSelector 같은 선택자를 통해 추가로 선택될 수 있습니다.

예시 활용 사례: Yadira는 온라인 고지도에서 옛 도로의 대각선 영역을 태깅합니다. 그녀의 클라이언트는 이미지 콘텐츠를 기준으로 해당 영역을 설명하는 SVG 다각형을 생성합니다.

모델

SVG 도형/캔버스의 크기는 소스 리소스의 크기를 기준으로 반드시 상대적으로 지정되어야 하며, 도형을 이미지 전체 크기로 스케일링하면 원하는 영역을 올바르게 나타낼 수 있어야 합니다.

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno26",
  "type": "Annotation",
  "body": "http://example.org/road1",
  "target": {
    "source": "http://example.org/map1",
    "selector": {
      "id": "http://example.org/svg1",
      "type": "SvgSelector"
    }
  }
}

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno27",
  "type": "Annotation",
  "body": "http://example.org/road1",
  "target": {
    "source": "http://example.org/map1",
    "selector": {
      "type": "SvgSelector",
      "value": "<svg:svg> ... </svg:svg>"
    }
  }
}

4.2.8 범위 선택자

사용자가 범위를 선택하면, 표현 내 내부 경계를 넘거나 광범위하게 선택하는 경우 단일 선택자로 정확한 콘텐츠를 견고하게 설명하기 어렵습니다. 범위 선택자(Range Selector)는 다른 선택자들을 활용하여 선택의 시작점과 끝점을 식별할 수 있습니다. 이렇게 하면 가장 적합한 선택 메커니즘으로 두 지점을 정확하게 지정하고, 이를 연결해 범위를 구성할 수 있습니다. 선택 영역은 시작 선택자의 시작부터 끝 선택자의 시작 전까지 모든 내용을 포함합니다.

예시 활용 사례: Zara는 웹 페이지의 표 내 두 인접 셀에 의견을 달고자 합니다. 그녀는 두 셀을 선택하고, 클라이언트는 첫 번째 셀과 두 번째 셀 다음 셀의 XPath를 각각 계산합니다. 클라이언트는 첫 번째 XPath 선택자를 start로, 두 번째를 end로 하여 범위 선택자를 생성합니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno28",
  "type": "Annotation",
  "body": "http://example.org/comment1",
  "target": {
    "source": "http://example.org/page1.html",
    "selector": {
      "type": "RangeSelector",
      "startSelector": {
        "type": "XPathSelector",
        "value": "//table[1]/tr[1]/td[2]"
      },
      "endSelector": {
        "type": "XPathSelector",
        "value": "//table[1]/tr[1]/td[4]"
      }
    }
  }
}

4.2.9 선택 정밀화

관심 영역을 전체 리소스가 아닌 선택의 선택으로 기술하는 것이 더 쉽거나, 신뢰성이 높거나, 더 정확할 수 있습니다. 특히 다른 리소스를 포함하는 다양한 패키징 포맷 등에서는 컴포넌트에 고유 식별자가 없을 때 선택 메커니즘을 분해하는 데 이 방식이 유용합니다. 이는 선택자들이 체인 형태로 연결되어 각각 이전 결과를 더욱 세분화하여 표현하는 방식으로 이루어집니다.

예시 활용 사례: Alexandra는 텍스트의 한 단락을, 그리고 그 안에서 짧은 구절을 선택해서 의견을 답니다. 그녀의 클라이언트는 그 구절을 텍스트 인용 선택자로 기록하고, 그 부모 단락 식별에는 FragmentSelector를 사용하여, TextQuoteSelector가 FragmentSelector를 한 번 더 정밀화하는 구조로 만듭니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno29",
  "type": "Annotation",
  "body": "http://example.org/comment1",
  "target": {
    "source": "http://example.org/page1",
    "selector": {
      "type": "FragmentSelector",
      "value": "para5",
      "refinedBy": {
        "type": "TextQuoteSelector",
        "exact": "Selected Text",
        "prefix": "text before the ",
        "suffix": " and text after it"
      }
    }
  }
}

4.3.1 시간 상태

Time State 리소스는 해당 리소스가 주석에 적합한 시점을 기록합니다. 보통 주석이 작성된 시간이나 현재 버전의 영구 링크 등이 여기에 해당합니다. 리소스의 타임스탬프는 RFC 7089 [rfc7089]에서 설명하는 Memento 프로토콜로도 확인할 수 있습니다.

예시 활용 사례: Carla는 뉴스 웹사이트의 메인화면 현재 상태에 대해 메모를 남기며 이 페이지가 자주 변경될 수 있다고 표시합니다. 그녀의 클라이언트는 페이지 버전을 설명하기 위해 현재 시간을 포함하는 상태를 추가합니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno31",
  "type": "Annotation",
  "body": "http://example.org/note1",
  "target": {
    "source": "http://example.org/page1",
    "state": {
      "type": "TimeState",
      "cached": "http://archive.example.org/copy1",
      "sourceDate": "2015-07-20T13:30:00Z"
    }
  }
}

4.3.2 요청 헤더 상태

리소스 하나의 IRI로도 다양한 표현을 제공할 수 있어, SpecificResource는 그 중 하나에만 적용될 수도 있습니다. 올바른 표현을 가져오기 위해 어떤 HTTP 요청 헤더가 필요했는지 기록할 수 있는 것이 중요합니다. HttpRequestState 리소스는 표현을 얻을 때 재생할 요청 헤더의 복사본을 저장합니다.

예시 활용 사례: Devina는 HTML, PDF, 평문 텍스트 등 다양한 표현을 제공하는 웹 리소스에서 PDF 표현을 받아 그에 대한 설명을 작성합니다. 그녀는 자신의 설명이 PDF에만 해당된다고 명시하며, 클라이언트는 대상을 얻는 방법을 설명하는 상태를 추가합니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno32",
  "type": "Annotation",
  "body": "http://example.org/description1",
  "target": {
    "source": "http://example.org/resource1",
    "state": {
      "type": "HttpRequestState",
      "value": "Accept: application/pdf"
    }
  }
}

4.3.3 상태 정밀화

선택 정밀화와 마찬가지로, 리소스의 적합한 상태를 원자적 상태 리소스 계층구조로 지정하는 것이 더 쉽거나, 신뢰성이 높거나, 더 정확할 수 있습니다. 내부 변환과 외부 요청 결과가 조합된 상태 표현 등에 특히 적합합니다. 이런 분해는 여러 상태가 Selector처럼 체인 형태로 연결되는 방식으로 달성됩니다.

또한 상태 적용 결과 특정 표현이 된다면, 그 표현의 특정 세그먼트를 기술하기 위해 적합한 Selector가 존재할 수 있습니다. 이를 위해 States는 Selector로 정밀화될 수도 있습니다.

예시 활용 사례: Erin은 시간이 흐름에 따라 여러 버전과 다양한 포맷이 제공되는 여행 e-book에 대해, 특정 버전·포맷에 관한 의견을 남기고자 합니다. 그녀의 클라이언트는 시간 정보를 캡처하는 TimeState, 포맷 정보를 캡처하는 HttpRequestState, 그 포맷에 해당하는 FragmentSelector 모두를 추가합니다.

모델

예시

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "http://example.org/anno33",
  "type": "Annotation",
  "body": "http://example.org/comment1",
  "target": {
    "source": "http://example.org/ebook1",
    "state": {
      "type": "TimeState",
      "sourceDate": "2016-02-01T12:05:23Z",
      "refinedBy": {
        "type": "HttpRequestState",
        "value": "Accept: application/pdf",
        "refinedBy": {
          "type": "FragmentSelector",
          "value": "page=10",
          "conformsTo": "http://tools.ietf.org/rfc/rfc3778"
        }
      }
    }
  }
}