Jump to: navigation, search

Blog description format (brainstorming)


Discussion Participants




A microformat to describe the contents of a (we)blog. It provides a specific set of information to categorize a (we)blog. Enables easier search for humans and efficient collection of information by machines.

Here are some of examples for information that might be provided:

Theoretical examples

<div class="blogformat" xml:lang="en">
   <p><img class="logo" alt="" src="" />
   <a class="author" href="">My</a> 
   <a class="bookmark" href="" title="John Doe's Blog">blog</a>
   <span class="description">
   <a rel="tag" href="">Web standards</a>,
   <a rel="tag" href="">CSS</a>,
   <a rel="tag" href="">XHTML</a>
   and topics releated to web development.</span></p>
   <p>There are 
   <a rel="alternate" type="application/atom+xml" href="">Atom</a> and 
   <a rel="alternate" type="application/rss+xml" href="">RSS 2.0</a>
   feeds available.</p>

See here or there for a rendered version of this example.

Strawman proposal

Text in italics is used as reference to the comments below.

Blog information container

The blog information container element contains all other elements of the blog description.

It must have a class attribute which includes the value blogformat.


The blog information container element or an ancestor element (langanc) of it must include a language code using the xml:lang attribute to indicate the language used for the blog.

If the document type used by the author allows the usage of the lang attribute, it must be used to specify the language code. The value must be equal to the one used for xml:lang. (langequ)

Example 1:

<!-- A blog written in English as spoken in the US -->
<div class="blogformat" lang="en-US" xml:lang="en-US">
    <!-- child elements -->

Example 2:

<!-- A blog written in French -->
<div class="blogformat" lang="fr" xml:lang="fr">
    <!-- child elements -->

Blog URI

The blog URI element must be an <a> element and must contain a rel attribute which includes the value bookmark.

It must link to the blog's mainpage using an absolute URI (absuri).

This element should provide the name of the blog in its title attribute.

If no title attribute is provided agents (agents) must use the text value of the blog URI element (meta).

Blog description and topics

It contains the main categories covered by the blog.

The categories are marked up within anchors (cat) that (may) refer to technorati-tags.


<a rel="tag" href="">XHTML</a>

In addition authors can write up a short introduction.

Author information

Information about the author should be provided.

The author information element must have a class attribute which includes the value author. This element should provide the name of the author in its title attribute.


<span class="author" title="John Doe">John's</span> Blog.

If no title attribute is provided agents (agents) must use the text value of the author information element (meta).

The author information element may be an <a> element which links to the author's page using an absolute URI (absuri) or may be some other element containing an hcard.


<a class="author" title="John Doe"
   href="">John's</a> Blog.


To be done.

Perhaps using

<a rel="alternate" type="application/atom+xml" href="">Atom</a>   
<a rel="alternate" type="application/rss+xml" href="">RSS 2.0</a>

(Maybe the already used

<link rel="alternate" type="application/rss+xml" href="" title="RSS 2.0" />

is enough? --RobertBachmann )


To be done.



See also

blog-description-format-brainstorming was last modified: Tuesday, October 2nd, 2007