Design V2 - project-octopus/octopodes GitHub Wiki

Documents

Example

The following example is presented in YAML for the sake of readability. The example begins with two works that are both a Painting:

  • The Threatened Swan by Jan Asselijn
  • Muleteers beside an Italian Ruin by Jan Asselijn

The information in each record is to be gathered and edited by the users of Project Octopus to reflect our best understanding of the rights of this work. The record does not need a URL as it describes a Creative Work and not a particular realization of it.

Each painting has a few different "publications" (WebPage/Publication specializations of WebPage) or direct realizations/expressions of the work. The first is published by the Rijksmuseum. One of the paintings also has a publication on Wikimedia Commons. The data for each publication record should be an accurate recording of the statements about the work found on that web page, including rights information and any links to source material. Such statements may be known to be false (the best known information should be recorded at the abstract work level) or suboptimal (e.g, inadequate credit) so such properties are also specializations, e.g. license/stated. For publications the about property denotes the CreativeWork being published.

Each painting also an ImageObject record that is "part of" potentially multiple publications.

The artist's Wikipedia page is recorded as two separate publications, one for each painting appearing on the page.

Not yet specified: "use" information such as views and favorites would typically be associated with a publication record; adaptation/inclusion relationships between works. isBasedOnUrl specializations might be one way to handle noting type of adaptation, eg isBasedOnUrl/Crop, where the value is URL for another work.

---
  docs:
    -
      id: "work/1"
      type: "Painting"
      creator: "Jan Asselijn"
      dateCreated: "1650"
      license: "Public Domain"
      name: "The Threatened Swan"
    -
      id: "work/2"
      type: "Painting"
      creator: "Jan Asselijn"
      dateCreated: "1650"
      license: "Public Domain"
      name: "Muleteers beside an Italian Ruin"
    -
      id: "publication/1"
      type: "WebPage/Publication"
      about: "work/1"
      license/stated: "Public Domain"
      name/stated: "The Threatened Swan, Jan Asselijn, c. 1650",
      url: "https://www.rijksmuseum.nl/en/collection/SK-A-4"
      publisher: "Rijksmuseum"
    -
      id: "publication/2"
      type: "WebPage/Publication"
      about: "work/2"
      license/stated: "Public Domain"
      name/stated: "Muleteers beside an Italian Ruin, Jan Asselijn, c. 1650"
      url: "https://www.rijksmuseum.nl/en/collection/SK-C-89"
      publisher: "Rijksmuseum"
    -
      id: "publication/3"
      type: "WebPage/Publication"
      about: "work/1"
      hasPart: "object/1"
      publisher: "Wikipedia"
      url: "http://en.wikipedia.org/wiki/Jan_Asselijn"
       -
      id: "publication/4"
      type: "WebPage/Publication"
      about: "work/2"
      hasPart: "object/2"
      publisher: "Wikipedia"
      url: "http://en.wikipedia.org/wiki/Jan_Asselijn"
    -
      id: "object/1"
      type: "ImageObject"
      contentUrl: "http://upload.wiki...Swan.jpg"
      encodesCreativeWork: "work/1"
      isBasedOnUrl: "http://en.wikipedia.org/wiki/File:...Swan.jpg"
    -
      id: "object/2"
      type: "ImageObject"
      contentUrl: "http://upload.wiki...Aqueduct.jpg"
      encodesCreativeWork: "work/2"
      isBasedOnUrl: "http://commons.wikimedia.org/wiki/File:...Aqueduct.jpg"
    -
      id: "publication/5"
      type: "WebPage/Publication"
      about: "work/1"
      name/stated: "File:Jan Asselijn - The Threatened Swan.jpg"
      publisher: "Wikipedia"
      isBasedOnUrl: "publication/1"
      url: "http://en.wikipedia.org/wiki/File:Jan_Asselijn...Swan.jpg"

In summary, top-level works can be stored as a Painting, Photograph, or a generic CreativeWork. Publications of these works will be stored as a WebPage/Publication, referencing multiple (if any) known objects manifesting the work in that publication.