Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Design microdata to annotate link to manifest for clients to follow #557

Closed
azaroth42 opened this issue Sep 24, 2015 · 11 comments
Closed

Design microdata to annotate link to manifest for clients to follow #557

azaroth42 opened this issue Sep 24, 2015 · 11 comments
Assignees
Labels
discovery Issue relates to the Change Discovery API

Comments

@azaroth42
Copy link
Member

To wrap around links to manifests, iiif logo with a property containing the link, and so forth, to allow clients to search for the microdata in HTML and follow to the Manifest (or Collection).

@azaroth42 azaroth42 added the discovery Issue relates to the Change Discovery API label Sep 24, 2015
@azaroth42 azaroth42 added this to the Other 2.1 milestone Sep 24, 2015
@acdha
Copy link
Contributor

acdha commented Sep 24, 2015

This is a great idea! As well as microdata for visible links, is there an official type which could be used for a <link> tag? I used rel=alternate with the generic application/ld+json on e.g. http://beta.wdl.org/en/item/1/ which is accurate but probably not specific enough.

@tomcrane
Copy link
Contributor

There is a discussion related to this on iiif-discuss, with an RDFa example:
https://groups.google.com/d/msg/iiif-discuss/JrmXLcfvWfk/6KfYrDiHJLAJ

<a property="iana:describedBy" 
                    resource="http://wellcomelibrary.org/iiif/b2039715x/manifest" 
                    href="http://wellcomelibrary.org/iiif/b2039715x/manifest" 
                    typeof="sc:manifest">IIIF Manifest</a>

At Wellcome we use wdrs:describedBy where @Prefix wdrs: http://www.w3.org/2007/05/powder-s#, which is the same as the iana:describedBy in that discussion.

@tomcrane
Copy link
Contributor

If we publish recipes for linking from elsewhere to IIIF we should also provide examples of the inverse - linking from IIIF resources to library catalogue pages, for example, via the "related" term.

Linked data question: what's the type or format of a resource that is open to content negotiation?

    {
      "@id": "http://local.wellcomelibrary.org/iiif/b11933859/manifest",
      "@type": "sc:Manifest",
      "label": "Actors fighting by moonlight. Colour woodcut by Kunikazu, early 1860s",
      "seeAlso": {
        "@id": "http://local.wellcomelibrary.org/resource/b11933859",
        "format": "(open to negotiation)" // ??
      },
      "related": {
        "@id": "http://local.wellcomelibrary.org/item/b11933859",
        "format": "text/html"
      }
    }

@jpstroop
Copy link
Member

Linked data question: what's the type or format of a resource that is
open to content negotiation?

In this case, could format be an array? That's not strictly a LD solution,
course, but it don't know one off the top of my head.

-Js

Sent via mobile. Please excuse typos, brevity, etc.
On Sep 28, 2015 7:04 AM, "Tom Crane" notifications@github.com wrote:

If we publish recipes for linking from elsewhere to IIIF we should also
provide examples of the inverse - linking from IIIF resources to library
catalogue pages, for example, via the "related" term.

Linked data question: what's the type or format of a resource that is open
to content negotiation?

{
  "@id": "http://local.wellcomelibrary.org/iiif/b11933859/manifest",
  "@type": "sc:Manifest",
  "label": "Actors fighting by moonlight. Colour woodcut by Kunikazu, early 1860s",
  "seeAlso": {
    "@id": "http://local.wellcomelibrary.org/resource/b11933859",
    "format": "(open to negotiation)" // ??
  },
  "related": {
    "@id": "http://local.wellcomelibrary.org/item/b11933859",
    "format": "text/html"
  }
}


Reply to this email directly or view it on GitHub
#557 (comment).

@jpstroop
Copy link
Member

Obviously, all of the representations should have a Link header listing all
of the other formats available with rel=alternate, but you'd have to get
one to figure that out.

-Js

Sent via mobile. Please excuse typos, brevity, etc.
On Sep 28, 2015 7:36 AM, "Jon Stroop" jpstroop@gmail.com wrote:

Linked data question: what's the type or format of a resource that is
open to content negotiation?

In this case, could format be an array? That's not strictly a LD solution,
course, but it don't know one off the top of my head.

-Js

Sent via mobile. Please excuse typos, brevity, etc.
On Sep 28, 2015 7:04 AM, "Tom Crane" notifications@github.com wrote:

If we publish recipes for linking from elsewhere to IIIF we should also
provide examples of the inverse - linking from IIIF resources to library
catalogue pages, for example, via the "related" term.

Linked data question: what's the type or format of a resource that is
open to content negotiation?

{
  "@id": "http://local.wellcomelibrary.org/iiif/b11933859/manifest",
  "@type": "sc:Manifest",
  "label": "Actors fighting by moonlight. Colour woodcut by Kunikazu, early 1860s",
  "seeAlso": {
    "@id": "http://local.wellcomelibrary.org/resource/b11933859",
    "format": "(open to negotiation)" // ??
  },
  "related": {
    "@id": "http://local.wellcomelibrary.org/item/b11933859",
    "format": "text/html"
  }
}


Reply to this email directly or view it on GitHub
#557 (comment).

@tomcrane
Copy link
Contributor

An array of the formats I know the resource will accept seems sensible but it feels wrong somehow! I want to say "there's RDF on the other end of this link, but you have options on format".

@azaroth42
Copy link
Member Author

@zimeon: Can you write up the drag and drop hack from Philly as a starting point? :)

@azaroth42
Copy link
Member Author

Regarding conneg, format could have an array of possible media types available. Or just omit it? Or put the expected to be most common format, and then use regular conneg to discover the media types available?

@zimeon
Copy link
Member

zimeon commented Nov 11, 2015

The drag and drop hack from Philly is at: http://zimeon.github.io/iiif-dragndrop/, we should think about how this becomes an implementation note or similar at some stage --> #602

My understanding is that for drag and drop we can't use a clean microdata approach because for cross platform support the only thing one can rely on is the URI being copied over. Thus everything has to be stuffed in the URI. (Within particular browsers one can do much more...). The pattern proposed is:

<a href="default_target?manifest=manifest_URI&canvas=canvas_URI">
  <img src="iiif-dragndrop-100px.png" alt="IIIF Drag-n-drop"/>
</a>

where the query params convey the manifest, canvas or image URIs.

@beaudet
Copy link

beaudet commented Dec 12, 2015

It looks like Google supports the indexing of custom meta-data and structures. If Mirador could execute a Google search, limiting results specifically to IIIF manifests, that might be a helpful feature that would increase the effectiveness of the Mirador as research / exploration tool use case. This might make it possible for IIIF publishers to interface with Google, rather than IIIF.io, to make their resources findable.

https://developers.google.com/custom-search/docs/structured_data?hl=en
https://developers.google.com/custom-search/docs/structured_search?hl=en#filter_by_attribute

@azaroth42
Copy link
Member Author

Eds: Move to discovery repo until there's something more to discuss. See IIIF/discovery#20

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
discovery Issue relates to the Change Discovery API
Projects
None yet
Development

No branches or pull requests

6 participants