CommonEndeavor

From Schema Bib Extend Community Group
Jump to: navigation, search

CommonEndeavor Proposal

Status: Draft
Initiated by: Karen Coyle

Overview

The term "commonEndeavor" represents a relationship between two entities whose content can be thought of as arising from the same creative act. The commonEndeavor is not further specified so it may be used as a relationship between any two bibliographic metadata entities, including Works and Expressions, two Works, two Manifestations, etc. It provides a way to create a graph without having to make decisions that model the bibliographic universe hierarchically.

commonEndeavor could connect two editions of a book, a book and a movie, a book and its translation, a hardcopy book and an ebook. It is a horizontal relationship that does not imply any precedence between the entities that are linked. It could be defined at the level of schema:creativeWork, and carried forward to sub-classes like Book or Movie. Any creativeWork can have a commonEndeavor relationship with any other creativeWork.

Proposal

The addition of one property to the CreativeWork Type

Property Expected Type Description
commonEndeavor schema.org/CreativeWork CreativeWork the content of which can be thought of as arising from the same creative act that created this CreativeWork.

Examples

2 books, linked to each other and to other sources like Freebase and Wikipedia, plus one movie, linked to the books and to Freebase and Wikipedia, using IMDB as the base URL.


Simple example showing HTML markup

Before
<div>
  The adventures of Tom Sawyer /
  by <a href="http://en.wikipedia.org/wiki/Mark_Twain">Mark Twain</a>

  Pages:          224 <br>
  Publisher:      Little, Brown, and Company <br>
  Date Published: 1991 <br>
  Language:       English <br>
  ISBN-10:        0316769487 <br>

  <div>
    Check shelf
  </div>

  <p>Other editions:</p>
  <p>
    <img src="bookIcon.jpg">
    <a href="http://example.com/4321">The adventures of Tom Sawyer</a>, 1998
  </p>
  <p>
    <img src="dvdIcon">
    <a href="http://www.imdb.com/title/tt0029844/">The adventures of Tom Sawyer</a>, 1938
  </p>

</div>

After
<div itemscope itemtype="http://schema.org/Book">
  <span itemprop="name">The adventures of Tom Sawyer</span> /
  by <a itemprop="author" href="http://en.wikipedia.org/wiki/Mark_Twain">Mark Twain</a>

  Pages:          <span itemprop="numberOfPages">224</span> <br>
  Publisher:      <span itemprop="publisher">Little, Brown, and Company</span> <br>
  Date Published: <meta itemprop="datePublished" content="1991-05-01">1991 <br>
  Language:       <span itemprop="inLanguage">English</span> <br>
  ISBN-10:        <span itemprop="isbn">0316769487</span> <br>

  <div itemprop="offers" itemscope itemtype="http://schema.org/Offer">
    <link itemprop="availability" href="http://schema.org/notCheckedOut">Check shelf
  </div>

  <p>Other editions:</p>
  <p>
    <img src="bookIcon.jpg">
    <a itemprop="commonEndeavor" 
      href="http://example.com/4321">The adventures of Tom Sawyer</a>, 1998
  </p>
  <p>
    <img src="dvdIcon">
    <a itemprop="commonEndeavor" href="http://www.imdb.com/title/tt0029844/">The adventures of Tom Sawyer</a>, 1938
  </p>

</div>

parsed Microdata from above example as JSON

From Live Microdata

{
  "items": [
    {
      "type": [
        "http://schema.org/Book"
      ],
      "properties": {
        "name": [
          "The adventures of Tom Sawyer"
        ],
        "author": [
          "http://en.wikipedia.org/wiki/Mark_Twain"
        ],
        "numberOfPages": [
          "224"
        ],
        "publisher": [
          "Little, Brown, and Company"
        ],
        "datePublished": [
          "1991-05-01"
        ],
        "inLanguage": [
          "English"
        ],
        "isbn": [
          "0316769487"
        ],
        "offers": [
          {
            "type": [
              "http://schema.org/Offer"
            ],
            "properties": {
              "availability": [
                "http://schema.org/notCheckedOut"
              ]
            }
          }
        ],
        "commonEndeavor": [
          "http://example.com/4321",
          "http://www.imdb.com/title/tt0029844/"
        ]
      }
    }
  ]
}

parsed Microdata translated into RDF in N3 syntax

RDF distiller

@prefix md: <http://www.w3.org/ns/md#> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfa: <http://www.w3.org/ns/rdfa#> .
@prefix schema: <http://schema.org/> .

<> md:item ([ a schema:Book;
       schema:author <http://en.wikipedia.org/wiki/Mark_Twain>;
       schema:commonEndeavor <http://example.com/4321>,
         <http://www.imdb.com/title/tt0029844/>;
       schema:datePublished "1991-05-01";
       schema:inLanguage "English";
       schema:isbn "0316769487";
       schema:name "The adventures of Tom Sawyer";
       schema:numberOfPages "224";
       schema:offers [ a schema:Offer;
         schema:availability schema:notCheckedOut];
       schema:publisher "Little, Brown, and Company"]);
   rdfa:usesVocabulary schema: .