Posts Tagged ‘atom’

Extending Atom: Thoughts on OPDS #2

Thursday, May 28th, 2009

First of all, Roger Sperberg wrote an excellent comment about the current OPDS draft:

With blogging, the Atom feed entry ought to include either a content child — containing the full blog post or a link to it (and the link relationship identified as ‘alternate’) — or a summary child whose content is an extract, abstract or short summary of one of the three types above.

If OPDS is a catalog of books, then there’s a mismatch between the blog model and the catalog model. The content in the catalog is material about a book, and the feed therefore ought to have the full material in content or a summary of it. A link child of contentshould take the feed’s consumer to that “full material.”

So maybe the catalog copy shouldn’t be likened to blog posts.

Then content could contain a link to the epub, and the catalog description would go into summary. Of course, the full descriptions in the catalog might be too long to use as intended in this type of feed.

In that case, just create a new type of relationship link, as was done in the examples for cover image and thumbnail, that describes whether this longer content is a synopsis, review or just longer description.

I agree with most of this comment. It makes more sense to use content for the EPUB file and summary for the description. We should also extend Atom rather than describe everything in XHTML: using DublinCore to describe the language, copyright status, publication date and other metadata.

Partial entry/Full entry

The current draft is full of new rel values, a design choice that we should avoid as much as possible (most of the time, a type and a rel value registered at the IANA link registry would be enough).

To support entries with longer content, as recommended by Roger Sperberg, we don’t need a new relationship link. In AtomPub:

Clients MUST NOT assume that an Atom Entry returned in the Feed is a full representation of an Entry Resource and SHOULD perform a GET on the URI of the Member Entry before editing it.

In the same RFC5023 for AtomPub, the “type” parameter was defined:

This specification defines a new “type” parameter for use with the “application/atom+xml” media type. The “type” parameter has a value of “entry” or “feed”.
Neither the parameter name nor its value are case sensitive.
The value “entry” indicates that the media type identifies an Atom Entry Document. The root element of the document MUST be atom:entry.
The value “feed” indicates that the media type identifies an Atom Feed Document. The root element of the document MUST be atom:feed.
If not specified, the type is assumed to be unspecified, requiring Atom processors to examine the root element to determine the type of Atom document.

Thanks to this type parameter, it’s fairly easy to point from a partial entry to a full entry using a link@rel="alternate"

<link rel="alternate" type="application/atom+xml;type=entry" href="..." />

For sources with a RDF document available (such as O’Reilly, and Feedbooks in the upcoming weeks), the same link@rel="alternate" could be used with application/rdf+xml.

Controlled vocabularies

The publication metadata required and allowed in OPF, should have the same status in OPDS.

Once the goals for OPDS are clearly defined (oops), we might extend this.

Any provider should be allowed to use additional extensions in their full entries.

Relationship to AtomPub

To allow such things as comments/reviews, OPDS could also support AtomPub.  With both the Atom Threading Extension and the current work on Collection Discovery, it should be fairly simple to support.

Thoughts on OPDS

Tuesday, April 14th, 2009

For several months, we’ve been distributing books to Stanza through our Atom endpoints. While the idea of using a standard format (Atom) as a catalog format was a good one, Lexcycle quickly had to extend things through new rel values or additional markup to support things such as thumbnails, search or links to similar books. OPDS (Open Publication Distribution System) is an attempt to standardize these extensions and create a solution that any reading system or content provider could use.

But aside from using more standard rel values and mimetypes, we need to think beyond the current implementation in Stanza if we’d like to create a great browsing and shopping experience.
The AppStore on the iPhone is a good example of what we shouldn’t do: it’s almost impossible to discover new applications and strictly limited to search and a few lists with the most popular applications.
At first, the Atom catalogs in Stanza didn’t have a way to list similar books: as soon as this feature was introduced, the way users browsed through Feedbooks rapidly evolved. People don’t go through pages and pages of books: they use a few books as an entry point to a graph and then explore things, jumping from one book to another untile they’ve found what they’re looking for. Best sellers, customized recommendations or search are ways to find these first books, but what the AppStore currently lacks and OPDS should extend is the way we can sort/filter this content, and jump from one book to another. 

The current specs define a generic way to access sub-catalogs while viewing a book, through the <link> tag and the application/opds+atom+xml value for type, which works well for things such as “similar books” but is a bit too vague at this point. Is it a requirement for every OPDS-enabled reading system for example ? While browsing books, how do I filter or reorder things ? Constantly going up and down in the hierarchy of the catalog can be very cumbersome, and the ability to go back to the home catalog (rel=”home”) or to filter content without pressing “back” should be available.

The current specs seem to rely too much on a browser too. A dedicated reading system might lack such a browser and we should make sure that most things can be done without one. How do we support comments and reviews ? How can we integrate the act of buying a book into OPDS and OPDS-enabled reading systems ? The current draft doesn’t answer any of these questions. To display a price, you have to include text or images in the description of your entry.  To handle a transaction, most catalog providers redirect the user to their mobile website in a browser. To create an optimal experience, OPDS needs to go beyond listing books, and define standard ways to handle all these interactions required with a retailer.

More technical details about the draft after the jump…

(more…)