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は、あるウェブ・サイトに関するコメント動画を彼女の電話で撮影し、それをアップロードします。彼女はアノテーションで動画をウェブ・サイトに関連付け、彼女のクライアントは利用システムへのヒントとしてタイプを追加します。

モデル

例

{
  "@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]では、資源の断片は、フラグメント要素付きIRIを用いて識別され、それは、関心のある断片を資源から抽出する方法を記述すると同時に、抽出されたコンテンツを識別します。シンプルなアノテーションでは、本体またはターゲットの識別子としてこのフラグメント要素付きIRIを使用できれば有益です。

ユースケースの例: Dawnは、画像の特定領域について説明したいと考えています。彼女は彼女のクライアントでその領域をハイライト表示させ、説明を入力します。そして、彼女のクライアントは、適切なフラグメント要素付きIRIをターゲットとして作成します。

モデル

フラグメント要素付きIRIを用いたときの結果と、それを用いることで実装に課される制限について知っていることが重要です。

• フラグメントは個々のメディア・タイプに対して定義されます。例えば、HTMLは、IRIのフラグメント部分の意味に関して特定のセマンティクスを持っています。
• すべてのメディア・タイプにフラグメントの仕様があるわけではありません。例えば、オフィス・ドキュメントにはメディア・タイプがあり、ウェブで公開できますが、IRIのフラグメント部分にセマンティクスを関連付けることはできません。
• メディア・タイプにフラグメントの定義があっても、関心のある断片を十分に正確に記述できないことがよくあります。例えば、HTMLのフラグメントを用いて、テキストの任意の範囲を記述することはできません。
• 同じフラグメント文字列が異なる仕様で存在できるため、メディア・タイプを知らずに何が識別されているかを確実に判断することはできません。例えば、同じフラグメント文字列は、画像の矩形領域、またはHTMLドキュメントの変な名前の断片のどちらかを識別できます。
• フラグメント要素付きIRIは、断片をより明確に記述する他の方法と互換性がありません。例えば、そのようなIRIを用いて、正しい表現を検索する方法を記述したり、スタイル情報を追加したり、役割を資源に関連付けたりすることはできません。これらの要件を達成する方法は、特定資源の項のフラグメント・セレクタの部分で説明しています。
• IRIは、曖昧な文字列とみなされるため、アノテーション・システムは、フラグメントのないIRIで検索した場合は、フラグメント要素付きのアノテーションを発見できません。例えば、http://example.com/image.jpg#xywh=1,1,1,1というターゲットを持つアノテーションは、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のないアノテーションと同時に作成されます。この場合、複数のシステムとの相互作用を行う必要性を避けるために、本体のテキストをアノテーションの一部として含むことができます。本体は、特に、伝達されるテキストの言語や形式などの、外部ウェブ資源の特性を持つこともできます。

ユースケースの例: Emilyは、彼女が写真共有ウェブ・サイトの画像がいかに好きなのかに関するコメントを書きます。彼女のクライアントは、コメントが組み込まれたアノテーションを作成し、それが、フランス語であり、HTML形式で書かれていることを付け加えます。

モデル

システムは、たとえtypeプロパティーに明示的に含まれていなくても、テキスト形式の本体には、上記のクラスで説明したTextクラスがあると想定すべきです(SHOULD)。

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 文字列の本体

最もシンプルなタイプの本体は、追加の情報やプロパティーがないプレーン・テキストの文字列です。このタイプの本体は、最もシンプルなアノテーションにのみ有用であり、本体をアノテーションの外から参照する必要がある場合の使用には推奨されません(NOT RECOMMENDED)。

ユースケースの例: Franceskaは、シンプルなコマンド・ラインのクライアントから手っ取り早くアノテーションを作成したいと考えています。彼女は、テキスト・ファイルでJSONシリアル化を作成し、それを自体のアノテーション・サーバーに送信して維持します。

モデル

この形式を使用できる場合と、それを解釈する方法には、いくつかの制限があります。
文字列の本体は、

• 1つのxsd:stringでなければならず(MUST)、データ型をシリアル化で表現してはなりません(MUST NOT)。
• それに関連付けられた言語を持ってはなりません(MUST NOT)。
• テキスト形式の本体のvalueプロパティーの値であるかのように解釈しなければなりません(>MUST)。
• テキスト形式の本体資源がtext/plainという値のformatプロパティーを持っているかのように解釈しなければなりません(MUST)。
• アノテーション資源の同様のプロパティーから推測されるテキスト形式の本体の他のプロパティーの値を持ってはなりません(MUST NOT)

上記の解釈のいずれかが正しくない場合は、代わりにTextualBody構築子を用いなければなりません(MUST)。

例

{
  "@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は、1つのアノテーションを用いてタグと記述を、2つの画像に関連付けます。

モデル

アノテーションに本体が全くない場合は、body関係は省略されます。

アノテーションのbodyおよび/またはtarget関係は、1つのオブジェクトではなく配列でありえます。値は、資源の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 本体間の選択

選択には、アプリケーションが処理または表示を行うために1つだけ選択すべき資源の順序付きリストがあります。順序は、アノテーションの作成者または公開者が、最も望ましいものから、最も望ましくないものへの順で指定します。

ユースケースの例: Irinaは、特定のウェブ・サイトに関する彼女の意見をフランス語と英語の両方で書きます。2つの投稿は同等であるため、両方を表示する必要はなく、代わりに、彼女はフランス語の話者にフランス語のコメントを表示し、他の人には英語のバージョンを表示したいと考えます。彼女のクライアントは、英語のコメントを最初に掲載した選択として作成します。

モデル

例

{
  "@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は、オンラインでレストランのレビューを書き、彼女の友人が、それが彼女のレビューであり、信頼できるということを知らせるために、そのレビューに関連付けたいと考えています。彼女のクライアントは、アノテーションに彼女のアカウントのIDとそれ自体のIDを、また、資源の作成時の適切なタイム・スタンプを追加します。

モデル

例

{
  "@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は、彼女のIDを管理していないシステムにアノテーションを送信したいと考えており、ペンネームの表示を望んでいます。彼女のクライアントは、この情報をアノテーションに追加してサービスに送信します。

モデル

例

{
  "@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の対象者クラスのものを用います。そのプロパティーとクラスの名前には、他のプロパティーやクラスと一意に区別できるように、schema:というJSONの接頭辞を置かなければなりません(MUST)。

audienceの使用は、アノテーションが表示されないようにするアクセス制限を暗示または有効にするものではありません。システムは、ユーザーに関する知識に基づいてアノテーションの表示をフィルタリングするために情報を用いるべきであり(SHOULD)、アノテーションやその他の資源が認証や認可を要求することを想定すべきではありません。

例

{
  "@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は、製品のレビューを書き、そのレビューの著者であることを知られたいと考えますが、レビューと製品を関連付けているアノテーションがどのように用いられるかは気にしません。彼女は、これらの2つの別個の権利ステートメントをアノテーションと本体で個々に言明します。彼女は、ターゲット資源上で表明されている権利については知らないため、何も指定しません。

モデル

例

{
  "@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 その他のID

ウェブなどの大規模な分散型のシステムでは、情報はしばしばコピーされます。アノテーションやその他の関連する資源の来歴を追跡するために、資源を識別する追加のIRIを記録することができます。これは逆参照可能な「パーマリンク」、ウェブの知識なしにクライアントがオフラインで割り当てたID、または、単に現在の収集システムが資源を発見した場所でありえます。

ユースケースの例: Petraは、アノテーションを作成し、それを複数のシステムに送信して維持します(1つは私的、1つは公的)。彼女は、コピーを連携できるようにしたいと考え、UUIDを正規のIRIとして設定し、サービスがそれに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のフラグメント部分を用いることであるため、これをセレクタによる記述メカニズムとして可能にすると便利です。これにより、既存および将来のフラグメント仕様を整合性のある形で特定資源に利用できるようになります。どのフラグメント・タイプが用いられているかを明確にするために、セレクタは、それを定義している仕様を参照できます。

ユースケースの例: Sallyは、動画の一部を画像に関する記述として関連付けたいと考えます。彼女は動画内の時間範囲を選択し、それがターゲットを記述していることに気づきます。そして、彼女のクライアントは、FragmentSelectorを持つSpecificResourceとdescribing動機を用いてアノテーションを作成します。

モデル

フラグメント付きIRIを直接用いるのではなく、SpecificResourcesを記述する他の手段と互換性がある整合的なメソッドとしてFragmentSelectorを用いることを推奨します(RECOMMENDED)。利用アプリケーションは、両方を知っているべきです(SHOULD)。

以下のIRIは、フラグメントのセマンティクスを定義している仕様の一部であり、そのため、conformsTo関係で用いることができます。その他のIRIも使用できます(MAY)。

例

{
  "@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のドキュメント・オブジェクト・モデルの要素を選択するための最も一般的な方法の1つは、CSSセレクタ[CSS3-selectors]を用いることです。CSSセレクタによって、ウェブ・ページの要素へのパスを記述するための多種多様で十分にサポートされた方法が可能となり、したがって、ウェブ・アノテーションの基本的なユースケースの多くがカバーされます。CSSセレクタがドキュメント・オブジェクト・モデルに準拠していない表現に適用された場合の結果は定義していません。

アノテーション内の資源をスタイル指定するためにもCSSを使用できることに注意してください。このクラスは、特に、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セレクタ

XMLやHTMLのドキュメントなどのドキュメント・オブジェクト・モデル(DOM)をサポートする資源内の要素とコンテンツを選択する別の一般的な方法は、XPath選択[DOM-Level-3-XPath]を用いることです。XPathは、構造内の選択されたコンテンツへのパスの記述に、大きな柔軟性を認めています。DOMに準拠していない表現にXPathセレクタが適用された場合の結果は定義していません。

ユースケースの例: Ulrikaは、HTMLページの表の中の範囲を選択し、内容に関してメモを書きます。この要素を明示的に参照するために、彼女のクライアントは、XPathを慎重に構築し、それをアノテーションのターゲットとして識別します。

モデル

例

{
  "@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」であるとした場合、「abcd」という接頭辞、一致する「efg」、「hijk」という接尾辞により「efg」を選択できます。

ユースケースの例: Valeriaは、ウェブ・ページの誤植(「anotation」)を選択し、正しいスペル(「annotation」)に置き換えるべきであるというコメントを追加します。

モデル

テキストの選択は、コード単位(選択されたデータ型を用いて表現される数)ではなく、Unicodeコード・ポイント(「文字番号」)でなければなりません(MUST)。選択は、書記素クラスタの真ん中で開始または終了すべきではありません(SHOULD NOT)。選択は、特に、双方向テキストでは、テキストの表示上の順序ではなく、論理的な順序に基づいていなければなりません(MUST)。ウェブで用いられるテキストの文字モデルの詳細については、[charmod]を参照してください。

テキストは、アノテーションに記録する前に正規化をしなければなりません(MUST)。したがって、HTML/XMLのタグは削除すべきで(SHOULD)、文字エンティティーは、エンコードする文字に置き換えられるべきです(SHOULD)。これが、アノテーションを付与されているドキュメントのコンテンツの状態には影響を与えず、コンテンツがアノテーション・ドキュメントに記録される方法にのみ影響を与えることに注意してください。

接頭辞(prefix)、完全(exact)、接尾辞(suffix)を処理した後に、ユーザー・エージェントが一致するテキスト・シーケンスを複数発見した場合、選択は、すべてのマッチと一致したものとして扱われるべきです(SHOULD)。

例

{
  "@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という位置は2番目の文字の直前であるなどです。したがって、開始文字はリストに含まれますが、終了文字は含まれません。

例えば、ドキュメントが「abcdefghijklmnopqrstuvwxyz」であり、開始が4、終了が7であれば、選択範囲は「efg」でしょう。

ユースケースの例: Wendyは、コンテンツの抽出とコピーが許可されていない電子書籍のレビューを書きます。彼女のクライアントは、コンテンツ内の開始・終了位置を用いて選択範囲を記述します。

モデル

開始・終了位置を決定するためには、文字を数える前にテキスト引用セレクタと同じ方法でテキストを選択して正規化をしなければなりません(MUST)。

例

{
  "@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 データ位置セレクタ

テキスト位置セレクタと同様に、データ位置セレクタは、同じプロパティーを用いますが、テキスト・レベルの文字ではなくビット・ストリーム・レベルのバイト(byte)で機能します。

ユースケースの例: 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は、SVG(Scalable Vector Graphics)[SVG11]標準を用いて領域を定義します。これにより、ユーザーは、SVGで領域を記述することにより、円や多角形などの、矩形ではないコンテンツ領域を選択できるようになります。SVGは、アノテーション内に組み込むか、外部ウェブ資源として参照することができます。

資源の領域を選択するためにSvgSelectorがSVGを用いることに注意してください。SVG表現の断片は、セレクタを用いて選択することもでき、それにはFragmentSelectorやSvgSelectorが含まれます。

ユースケースの例: Yadiraは、歴史的な道路の対角線領域をオンラインで古い地図にタグ付けしています。彼女のクライアントは、SVGポリゴンを作成し、画像コンテンツと相対的に領域を記述します。

モデル

SVGの形またはキャンバスの大きさは、その形のサイズを画像のフル・サイズに拡大・縮小し、希望する領域が正しく表現されるようにして、情報源資源の大きさと相対的でなければなりません(MUST)。

例

{
  "@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 範囲セレクタ

ユーザーが行う選択は、広範囲である可能性および／または表現の内部境界を越える可能性があるため、正しいコンテンツを確実に記述する1つのセレクタを構築することは困難です。範囲セレクタを用いれば、他のセレクタを用いて、選択の最初と最後を識別することができます。この方法では、最も適切な選択メカニズムで2つの位置を正確に識別し、その後でリンクさせて選択範囲を形成することができます。選択は、開始セレクタの最初から終了セレクタの最初(しかし、これは含まない)までのすべてで構成されます。

ユースケースの例: Zaraは、ウェブ・ページの一部である表内の隣接する2つのセルに関してコメントしたいと考えます。彼女は2つのセルを選択し、彼女のクライアントは最初のセルと、2番目の直後のセルにXPathを構築します。そして、彼女のクライアントは、最初のXPathセレクタを開始として、2番目のXPathセレクタを終了として用いて範囲セレクタを作成します。

モデル

例

{
  "@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としてフレーズを記録します。

モデル

例

{
  "@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 時間状態

時間状態資源は、資源がアノテーションに適している時間を記録するもので、一般的には、アノテーションが作成された時間および／または現在のバージョンの永続的なコピーへのリンクです。資源のタイム・スタンプは、RFC7089[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 リクエスト・ヘッダー状態

1つのIRIで資源から配信できる表現は潜在的に多く存在しており、特定資源はそのうちの1つにしか適用できないため、正しい表現を検索するために送信する必要がある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 状態の精緻化

選択の精緻化と同様に、資源の適切な状態をアトミックな状態資源の階層として指定する方が、より簡単で、より信頼でき、より正確でありえます。これは、内部変換を反映した状態と外部リクエストを記述した状態の結果との組み合わせを表すのに特に適しています。この分解は、セレクタと同じ方法で状態を連鎖的につなげることで実現できます。

さらに、状態によって特定の表現が生じる可能性が高いことを考えると、その表現の断片を記述するのに適した特定のセレクタが存在する可能性があります。これに対応するために、状態をセレクタで精緻化することもできます。

ユースケースの例: Erinは、時間の経過とともに多くのバージョンがあり、様々な形式で利用できる旅行の電子書籍に関してコメントを書きます。彼女は、特定のバージョンと形式に関して特にコメントしているため、彼女のクライアントは、時間を捕捉する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"
        }
      }
    }
  }
}