The Well-Formed Web

Exploring the limits of XML and HTTP

RESTLog Archive Format

The RESTLog Archive Format is used to describe the archive of items in a web site. Here is a quick example:

<archives xmlns="http://www.purl.org/RESTLog/archives/1.0">
  <res href="/RESTLog.cgi/5">RESTLog Interface</res>
  <res href="/RESTLog.cgi/4">One step at a time</res>
  <res href="/RESTLog.cgi/3">What's the point?</res>
  <res href="/RESTLog.cgi/2">RESTLog Overview</res>
  <res href="/RESTLog.cgi/1">Welcome to the Well-Formed Web</res>
</archives>

Here is a more complicated example:

<archives xmlns="http://www.purl.org/RESTLog/archives/1.0">
   <group title="Last Ten Stories">
      <res href="/RESTLog.cgi/100">My Most Recent Post</res>
      <res href="/RESTLog.cgi/99">My Next Most Recent Pos</res>
      .
      .
      .
      <res href="/RESTLog.cgi/91">Some Post In The Recent Past</res>
   </group>
   <more href="/RESTLog.cgi/moreViews">All Items</more>
</archives>

N.B. The URLs given in the href attributes must be complete, not relative, URLs.

The 'group' elements are used to group 'res' items together. The 'group' elements can be nested to any depth. The 'more' element contains a link that when dereferenced will return another file in RESTLog Archive Format.

Extending the format

All the elements sit in the namespace http://www.purl.org/RESTLog/archives/1.0. Feel free to extend the format by placing new elements and attributes in their own namespace. The 'archives' element must remain the root element.

2002-12-14 00:31 Comments (0)