W3C home > Mailing lists > Public > public-annotation@w3.org > January 2016

Re: [web-annotation] Multiple Selectors

From: Rob Sanderson via GitHub <sysbot+gh@w3.org>
Date: Wed, 20 Jan 2016 23:23:55 +0000
To: public-annotation@w3.org
Message-ID: <issue_comment.created-173398909-1453332233-sysbot+gh@w3.org>
Discussed on 2016-01-20 call. Decision to add examples to get a good 
oversight of the space.

Use Case 1:  Select the broad segment (index.html#namedSection) and 
then further refine it with a second selector (characters 5-28 of that
 section).
```
{
  "type": "SpecificResource",
  "selector": {
    "type": "FragmentSelector",
    "value": "namedSection",
    "subSelector": {
      "type": "TextPositionSelector",
      "start": 5 // relative to index.html#namedSection
      "end": 28     
    }
  }
}
```

Use Case 2:  Two alternative selectors, one based on quotation, one 
based on offset.
```
{
  "type": "SpecificResource",
  "selector": [
    {
      "type": "TextPositionSelector",
      "start": 505 // relative to index.html
      "end": 528 
    },
    {
      "type": "TextQuoteSelector",
      "exact": "quote in namedSelection"
    }
  ]
}
```

Use Case 3:  Mixing the two
```
{
  "type": "SpecificResource",
  "selector": [
    {
      "type": "FragmentSelector",
      "value": "namedSection",
      "subSelector": {
        "type": "TextPositionSelector",
        "start": 5 // relative to target#namedSelection
        "end": 28
      }
    },
    {
      "type": "TextQuoteSelector",
      "exact": "quote in namedSelection"
    }
  ]
}
```

Use Case 1b:  Select within a container resource (e.g. a zip or epub 
or PWP) and then select the content.
```
{
  "type": "SpecificResource",
  "selector": {
    "type": "foo:MemberSelector",
    "value": "/resources/index.html",
    "subSelector": {
      "type": "TextPositionSelector",
      "start": 605 // relative to target.zip | /resources/index.html
      "end": 628     
    }
  }
}
```

Equivalent for UC1 currently:
```
{
  "type": "SpecificResource",
  "selector": {
    "type": "List",
    "members": [
      {
        "type": "FragmentSelector",
        "value": "namedSection"
      },
      {
        "type": "TextPositionSelector",
        "start": 5 // relative to index.html#namedSection
        "end": 28     
      }
    ]
  }
}
```

Equivalent for UC2 currently:
```
{
  "type": "SpecificResource",
  "selector": {
    "type": "Choice",
    "members": [
      {
        "type": "TextPositionSelector",
        "start": 505,
        "end": 528
      },
      {
        "type": "TextQuoteSelector",
        "exact": "quote in namedSelection"
      }
    ]
  }
}
```

And for UC3:

```
{
  "type": "SpecificResource",
  "selector": {
    "type": "Choice",
    "members": [
      {
        "type": "List":,
        "members": [
          {
            "type": "FragmentSelector",
            "value": "namedSection"
          },
          {
            "type": "TextPositionSelector",
            "start": 5 // relative to target#namedSelection
            "end": 28
          }
        ]
      },
      {
        "type": "TextQuoteSelector",
        "exact": "quote in namedSelection"
      }
    ]
  }
}
```
(Phew!)


-- 
GitHub Notification of comment by azaroth42
Please view or discuss this issue at 
https://github.com/w3c/web-annotation/issues/93#issuecomment-173398909
 using your GitHub account
Received on Wednesday, 20 January 2016 23:23:57 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 18:54:43 UTC