embed-brainstorming

Synopsis

Embedding content across different publishers — such as showing YouTube videos in blog posts, Flickr photographs in Pownce, preview images next to bookmarked links.

Sites such as YouTube, Flickr, Vimeo and others publish ‘embed code’ to aid users in copy+pasting content into their own repostings. This is especially useful for embedding of complex content such as Shockwave Flash movies, where the HTML code is not intuitive. Sites like Flickr use copy+paste code examples to encourage and enforce link-back policies and publication of author, publisher and copyright information.

Goal

Produce a microformat to describe the embedding patterns for content and the author/publisher information connected to the content, such that a user or tool could extract the ‘embed’ from any supporting site in a common manner. That could be in the authoring stage of tools such as blogging platforms, or at the publication stage, such as Pownce showing embedded content for URLs that are posted to the service.

Use Cases

• Allow users to republish any embeddable piece of content by providing just a URL
• Allow content from a URL to be extracted and displayed alongside links in microblogging systems such as Pownce and Tumblr, without those services having to write unique extraction code for every website.
• Allow content to be shown alongside search results (e.g. via Yahoo SearchMonkey, or behind-the-scenes systems used for image previews)
• Where you type a URL into a message (e.g. on Facebook), a service looks up the URL and grabs the page title and a content snippet to display with the the message. A kind of ‘rich link’. This microformat would enable more relevant content to be parsed out of pages.
• Allow content to be marked up in such a way that the embed code can be taken from mark-up itself if appropriate, not just explicit chunks of code.

Existing Sytems

The creators of Pownce have created an XML standard called oEmbed. This is a standalone XML representation of embeddable content, similar to a feed entry, but including additional fields for the host site (the publisher), and the exact code needed to include the content object in pages.

oEmbed uses an XRDS endpoint, linked to from the content page, to provide the oEmbed representation of a resource.

Examples

Publishers

• YouTube
• Flickr
• Vimeo
• Last.FM
• Skitch
• Photobucket

Consumers

Consumption of embedable content is spread throughout a number of different use cases:

Microblogging

Pownce

Pownce is the original pioneer of the oembed standard. It takes a URL input for an external resource, and where supported embedable content is found, the embed is included with the link post.

Pownce notes are already marked up with hAtom, and include embedded content within a class of attachment.

In addition to the fields of hAtom, the embedded content includes:

• Linking back to the publishing source
• Attribution to the embedded content creator
• Count of the times the content has been downloaded from this publisher

<li id="note4390327" class="public-note hentry">
    <div class="note-contents"> 
        <a href="/ariel/"> 
            <img src="/profile_photos/a/r/i/ariel/304_medium.jpg" width="48" height="48" title="Ariel Waldman" class="user" /> 
        	<em class="pro-2">Pro!</em> 
        </a> 
    
        <p class="entry-content">
            <em class="note-type entry-title">
                <a href="/ariel/notes/4390327/" rel="bookmark">Public</a>
            </em> 
            My favorite Pownce post from !<a href="/leahculver/">leahculver</a>.
        </p> 
    
        <div class="attachment">                
            <div> 
                <a href="http://flickr.com/photos/arielwaldman/3078507970/in/photostream/"> 
                    <img src="http://farm4.static.flickr.com/3210/3078507970_5811e41585_m.jpg" alt="Pownce" /><br /> 
                </a> 
            </div> 
                    
            <div class="by-caption">
                <span>photo by</span>
                <a href="http://www.flickr.com/photos/arielwaldman/" >arielwaldman</a>
            </div> 
        
            <a href="http://flickr.com/photos/arielwaldman/3078507970/in/photostream/" class="note-url"> 
                flickr.com/photos/arielwaldman/30...
            </a> 
            <div class="note-count"> 
                <span id="click-count-4390327">(14 views)</span>     
            </div> 
        </div> 

        <div class="note-location fireeagle"> 
            <span class="locator"><a href="/settings/fireeagle/">Fire Eagle</a>:
            <span class="locality">San Francisco, CA</span> 
            <span class="country-name">US</span>
        </div> 
	
        <h4> 
            <abbr class="published" title="1 day ago">1 day ago</abbr> 
            <span class="vcard author"> 
                <a href="/ariel/" class="sender url"> 
                    <span class="fn"> 
                        Ariel Waldman					
                    </span> 
                 </a> 				
            </span> 
	   
            <a href="/ariel/notes/4390327/" class="reply">2  Replies </a> 
            <a href="/ariel/notes/4390327/forward/" class="forward">Forward</a> 
        </h4> 
    </div>
</li>

— Source of a full note, embedding a Flickr photograph, from http://pownce.com/benward

<div class="attachment">     
    <div> 
        <span>                     
            <object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000"
             codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=8,0,0,0"
             width="300" height="247" id="jxT0ELP7az0" align="middle"> 
            <param name="movie" value="http://www.youtube.com/v/jxT0ELP7az0" /> 
            <embed src="http://www.youtube.com/v/jxT0ELP7az0" quality="high"
             width="300" height="247" name="jxT0ELP7az0"
             align="middle" allowScriptAccess="sameDomain"
             type="application/x-shockwave-flash" pluginspage="http://www.adobe.com/go/getflashplayer" />
            </object> 
        </span> 
    </div> 

    <a href="http://www.youtube.com/watch?v=jxT0ELP7az0" class="note-url">
        www.youtube.com/watch?v=jxT0ELP7a...
    </a> 
    <div class="note-count"> 
        <span id="click-count-3949474">(4 views)</span> 
    </div> 
</div>

— Source snippet of a video note, showing the YouTube video attachment, from [1]

Tumblr

Tumblr is the defacto tumblelog application, encouraging users to post small snippet posts of text, as well as reposting images, audio, video, text quotes and URLs. The output of Tumblr varies depending on the theme the user uses, and can be customised. As such, the following documents the inputs used to publish content.

• Text
  • Title
  • Text Content
• Photo
  • Either the URL of a already hosted photograph, or an image binary upload
  • Text Caption
  • Click-through URL (e.g. linking a Flickr photo back to the source page)
• Quote
  • Quote Text
  • Source (text, also usable as a desciption)
• Link/URL
  • Name (title)
  • URL
  • Description
• Chat (conversations)
  • Title
  • Dialogue (free text field, expects My Name: This is my message format text)
• Audio
  • Audio binary, or URL to externally hosted audio
  • Text description
• Video
  • URL for YouTube or Vimeo service videos, or paste custom embed code from any site.
  • Text caption

All post types include adding tags, setting the publication date, visibility (public/private), and the permalink slug.

Tumblr provides a quite strictly structured input mechanism, but the video type is most relevant, as this accepts the code provided by any site. This microformat could allow it to accept any URL, beyond just YouTube and Vimeo for which it has implemented proprietary support.

More to Document

• Delicious
• Yahoo Search
• Google Search
• Facebook's ‘Compose New Message’ interface