From DBWiki

Contents 1 hMedia v0.9 1.1 Draft Specification 1.1.1 Primary Authors/Editors 1.1.2 Contributors 1.1.3 Copyright 1.1.4 Patents 1.2 Introduction 1.3 Semantic XHTML Design Principles 1.4 Format 1.4.1 General 1.4.2 Schema 1.4.3 Field and Element Details 1.4.4 XMDP Profile 1.5 Examples 1.6 Real World Examples 1.6.1 Media Info v1.0 Examples 1.6.2 Pre Media Info Examples 1.7 Implementations 1.8 References 1.8.1 Normative References 1.9 Work in progress 1.9.1 Version 0.9 1.10 Discussions 1.10.1 Q&A 1.11 Examples 1.12 Real World Examples 1.12.1 Media Info v1.0 Examples 1.12.2 Pre Media Info Examples 1.13 Implementations 1.14 References 1.14.1 Normative References 1.15 Work in progress 1.15.1 Version 0.9 1.16 Discussions 1.16.1 Q&A

hMedia v0.9

hMedia is a microformat for content that is specific to multimedia, such as audio, video, models and pre-rendered documents. hMedia is based on a subset of the Bitmunk XML and WebAPI objects, which are used to describe any of the millions of pieces of digital content stored on Bitmunk's network.

Draft Specification

Primary Authors/Editors

• [Manu Sporny], Digital Bazaar, Inc.
• [Mike Johnson], Digital Bazaar, Inc.
• [Dave Longley], Digital Bazaar, Inc.

Contributors

• Songbird Engineers

Copyright

Template:MicroFormatCopyrightStatement2005

Patents

Template:MicroFormatPatentStatement

Introduction

hMedia is a microformat for identifying semantic information for content embedded in media-related websites and blogs. It is often desired to link or embed varying types of media into a web page and associate meta-data with the media. For example, when linking to a sample of an MP3 song on a website, it would be helpful to list the artist and title of the work as well as specifying if the link is a short sample of the work or a fully downloadable version of the work.

The hMedia microformat is targeted at any site that integrates music, video and pre-rendered documents into their web pages in sample or purchaseable form.

Semantic XHTML Design Principles

Template:Semantic-xhtml-design-principles

Format

General

The Bitmunk Media Info class provides the conceptual basis for this microformat. There is a great amount of information that has been culled to provide a format that will work with all of the media blogs and digital content stores online.

Schema

The schema follows the Bitmunk Media Info schema very closely. A full explanation of the schema can be found on the Bitmunk Media Info Schema website.

The Media Info schema consists of the following:

• hmedia (hmedia).
  • creator. required, using hCard
  • title. required. text.
  • preview-image. optional, embedded image or URL rel-preview.
  • sample. optional, URL rel-sample.
  • type. optional, one of (song, book, television series, album, television episode, film, short film, collection).
  • genre. optional, text.
  • acquire. optional, URL rel-acquire.
  • review. optional, using hReview.
  • license. optional, using rel-license.
  • published. optional. using datetime-design-pattern.
  • summary. optional. text.
  • description. optional. text.
  • contributor. optional, using hCard.
  • uid. optional. using uid design pattern.

Some required elements have defaults if missing, see below.

Field and Element Details

• creator - The creator of a hMedia is the entity that brought the concept into existence. This can be a writer, a graphic artist, a band, a painter, a composer, a machine, or any other creative entity.
• title - The title of the media is the formal title given the creation. This can be the name of a book, title of a movie, title of a painting, the name of a song or any other short descriptive title given to the creation by the creator.
• preview-image - A preview image is a small to medium-sized image or link to an image that can be used as a graphical representation for the hMedia object. For example, a small thumbnail of a photograph, a thumbnail of the cover of an audio album, the movie poster associated with a movie, or the title screen of a television show. The preview image may be an embedded image in the HTML document itself, or a link to the preview image using the rel-preview-image design pattern.
• sample - A sample is a short example of the hMedia object being described. In the case of an audio song, it can be a link to a 30 second clip of the audio song, or a low-quality version of the high-quality version of the song. In the case of video, it can be a summary such as a movie trailer or a short excerpt from the video. The sample can be an embedded image in the HTML document itself, or a link to the sample using the rel-sample design pattern.
• type - The type describes the specific form of media that is being described. This can be varied greatly, but includes 'audio song', 'book', 'album', 'television series' and several more.
• genre - The genre specifies in which category a particular digital creation best fits. For example, the Die Hard series of movies best fit in the "Action" genre. The "Friends" television series fits into the "Comedy" genre. Multiple genres can be specified for a particular hMedia object. Sub-genres can be specified by separating an alpha-numeric string with one or more symbolic characters (such as ':', '>', '-', '/', or ',').
• acquire - hMedia is often copyrighted and described on the web via previews and samples. If the reader is interested in acquiring the full version of a described hMedia, the acquire link can be used to specify a URL with which the acquisition can be performed. This is typically almost always a URL using the rel-acquire design pattern.
• review - The review mechanism is used to embed reviews about a particular hMedia within the description itself. The review tag should use the hReview microformat for all of the contents.
• license - The license specifies what license a particular hMedia is available through. There may be multiple licenses specified per hMedia. The rel-license design pattern should be used for all licenses
• published - All media has a created or published date. ISO-8601 should be used to describe the published date. The XHTML abbr tag may be used to make the date human-readable.
• summary - A summary is a short one sentence description about the hMedia object being summarized.
• description - The description can be a multi-paragraph textual summary of the hMedia object being described.
• contributor - A contributor is a person responsible in part or in whole for the creation of the hMedia object being described. A contributor can be a publisher, director, composer, instrumentalist, gaffer, propmaster, sound editor, producer, and many other types of creative influences for a particular hMedia object. There can be more than one entry for a contributor. A contributor entry must use the standard hCard format and MUST fill out the ROLE property or TITLE property of an hCard.
• uid - A universal ID for the hMedia. This may be a Universal Product Code (UPC), International Standard Recording Code (ISRC), International Standard Book Number (ISBN), or any other standardized or non-standardized universal identifier for the hMedia object being described.

XMDP Profile

<dl class="hmedia">
 <dt id='creator'>creator</dt>
  <dd>The creator of a hMedia is the entity that brought the concept into existence. This can be a
      writer, a graphic artist, a band, a painter, a composer, a machine, or any other creative 
      entity.</dd>
 <dt id='title'>title</dt>
  <dd>The title of the media is the formal title given the creation. This can be the name of a book, 
      title of a movie, title of a painting, the name of a song or any other short descriptive title
      given to the creation by the creator.</dd>
 <dt id='preview-image'>preview-image</dt>
  <dd>A preview image is a small to medium-sized image or link to an image that can be used as a 
      graphical representation for the hMedia object. For example, a small thumbnail of a 
      photograph, a thumbnail of the cover of an audio album, the movie poster associated with a 
      movie, or the title screen of a television show. The preview image may be an embedded image in
      the HTML document itself,  or a link to the preview image using the rel-preview-image design 
      pattern.</dd>
 <dt id='sample'>sample</dt>
  <dd>A sample is a short example of the hMedia object being described. In the case of an audio 
      song, it can be a link to a 30 second clip of the audio song, or a low-quality version of the 
      high-quality version of the song. In the case of video, it can be a summary such as a movie 
      trailer or a short excerpt from the video. The sample can be an embedded image in the HTML 
      document itself, or a link to the sample using the rel-sample design pattern.</dd>
 <dt id='type'>type</dt>
  <dd>The type describes the specific form of media that is being described. This can be varied 
      greatly, but includes 'audio song', 'book', 'album', 'television series' and several 
      more.</dd>
 <dt id='genre'>genre</dt>
  <dd>The genre specifies in which category a particular digital creation best fits. For example, the
      Die Hard series of movies best fit in the "Action" genre. The "Friends" television series fits 
      into the "Comedy" genre. Multiple genres can be specified for a particular hMedia object. 
      Sub-genres can be specified by separating an alpha-numeric string with one or more symbolic 
      characters (such as ':', '>', '-', '/', or ',').</dd>
 <dt id='acquire'>acquire</dt>
  <dd>hMedia is often copyrighted and described on the web via previews and samples. If the reader is 
      interested in acquiring the full version of a described hMedia, the acquire link can be used to
      specify a URL with which the acquisition can be performed. This is typically almost always a 
      URL using the rel-acquire design pattern.</dd>
 <dt id='review'>review</dt>
  <dd>The review mechanism is used to embed reviews about a particular hMedia within the description
      itself. The review tag should use the hReview microformat for all of the contents.</dd>
 <dt id='license'>license</dt>
  <dd>The license specifies what license a particular hMedia is available through. There may be 
      multiple licenses specified per hMedia. The rel-license design pattern should be used for all 
      licenses</dd>
 <dt id='published'>published</dt>
  <dd>All media has a created or published date. ISO-8601 should be used to describe the published 
      date. The XHTML abbr tag may be used to make the date human-readable.</dd>
 <dt id='summary'>summary</dt>
  <dd>A summary is a short one sentence description about the hMedia object being summarized.</dd>
 <dt id='description'>description</dt>
  <dd>The description can be a multi-paragraph textual summary of the hMedia object being 
      described.</dd>
 <dt id='contributor'>contributor</dt>
  <dd>A contributor is a person responsible in part or in whole for the creation of the hMedia object
      being described. A contributor can be a publisher, director, composer, instrumentalist, 
      gaffer, propmaster, sound editor, producer, and many other types of creative influences for a 
      particular hMedia object. There can be more than one entry for a contributor. A 
      contributor entry must use the standard hCard format and MUST fill out the ROLE property or
      TITLE property of an hCard. </dd>
 <dt id='uid'>uid</dt>
  <dd>A universal ID for the hMedia. This may be a Universal Product Code (UPC), International 
      Standard Recording Code (ISRC), International Standard Book Number (ISBN), or any other 
      standardized  or non-standardized universal identifier for the hMedia object being 
      described.</dd>
</dl>

Examples

See hMedia-examples.

Real World Examples

This section is informative.

Media Info v1.0 Examples

Pre Media Info Examples

Implementations

This section is informative.

References

Normative References

• XHTML 1.0 SE

Work in progress

This specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added. There is a separate document where we are keeping our brainstorms and other explorations relating to Media Info:

Version 0.9

Version 0.9 was released February 12th, 2007.

Discussions

Q&A

• If you have any questions about the hMedia Microformat, check the hMedia Microformat FAQ, and if you don't find answers, add your questions!

Examples

See hMedia-examples.

Real World Examples

This section is informative.

Media Info v1.0 Examples

Pre Media Info Examples

Implementations

This section is informative.

References

Normative References

• XHTML 1.0 SE

Work in progress

This specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added. There is a separate document where we are keeping our brainstorms and other explorations relating to Media Info:

Version 0.9

Version 0.9 was released January 24th, 2007.

Discussions

Q&A

• If you have any questions about the hMedia Microformat, check the hMedia Microformat FAQ, and if you don't find answers, add your questions!